Roteiro de Operação - Fulfillment

1. Objetivo e Escopo do Manual

1.1 Objetivo

Fornecer o roteiro operacional para executar, monitorar e conferir a integração Fulfillment no TOTVS Protheus, permitindo que a equipe de operação conduza o processo diário com autonomia e identifique corretamente as situações que exigem acionamento do suporte técnico.

1.2 Escopo

O manual cobre as seguintes atividades:

• Download dos XMLs disponibilizados pelo marketplace;
• Importação dos XMLs e geração das notas fiscais no Protheus;
• Monitoramento do resultado da integração pela rotina Status Int. Pedidos;
• Conferência dos documentos gerados;
• Identificação, tratamento e reprocessamento dos erros mais frequentes;
• Manutenção do De/Para de produtos, quando o código recebido no XML não é localizado.

Não fazem parte do escopo deste manual:

• Instalação de patches e execução de compatibilizadores;
• Publicação e atualização do menu do módulo Faturamento;
• Cadastros de configuração da solução (Políticas Comerciais, CFOP × TES, Intermediador);
• Parâmetros do sistema;
• Pontos de entrada e customizações.

1.3 Público-alvo

Equipe de operação responsável pelo faturamento e pelo acompanhamento das vendas em marketplace no modelo Full. Pressupõe-se conhecimento prévio de navegação no TOTVS Protheus e das rotinas do módulo Faturamento.

1.4 Convenções adotadas neste documento

2. Visão Geral do Processo

No modelo Full, o estoque é mantido no centro de distribuição do marketplace, que emite as notas fiscais em nome da empresa. A integração recupera esses documentos e os reproduz no Protheus, mantendo estoque, faturamento e fiscal alinhados à operação do marketplace.

O ciclo operacional é composto por três rotinas, executadas na ordem abaixo:

2.1 Rotina diária recomendada

1. Executar o Download XML para o período desejado;
2. Executar o Import. XML MLFULL para o mesmo período, informando o intervalo de numeração das notas fiscais;
3. Abrir a rotina Status Int. Pedidos e verificar a coluna Status Pedido;
4. Tratar os registros com legenda vermelha, conforme o capítulo de conferência e diagnóstico;
5. Reprocessar os registros corrigidos e executar novamente o Import. XML MLFULL;
6. Confirmar que todos os registros do período estão integrados.

3. Execução das Rotinas de Integração

3.1 Download XML

Caminho: Faturamento → Atualizações → Fulfillment → Download XML.

Figura 1 — Caminho de acesso à rotina Download XML

Figura 2 — Tela inicial da rotina Download XML

Acione e informe o período desejado. Períodos maiores podem ser utilizados, se necessário.

Em seguida, acione .

Figura 3 — Tela de informações da rotina Download XML

Acione .

Figura 4 — Mensagem exibida para dias sem XML disponível

Acione e deixe o sistema prosseguir.

Figura 5 — Continuidade do processamento da rotina Download XML

3.1.1 Estrutura de pastas gerada no servidor

Os XMLs baixados ficam gravados no servidor, em estrutura de pastas organizada por data. Esta seção é informativa — a conferência do download pela rotina Status Int. Pedidos é suficiente para a operação. A hierarquia criada é a seguinte:

Figura 6 — Pastas por dia criadas dentro da pasta NFE

Figura 7 — Pastas criadas conforme a movimentação recebida do Fulfillment

Figura 8 — Pasta XML criada dentro de emitidas_mercado_livre

Figura 9 — XMLs disponíveis para importação no Protheus

3.2 Import. XML MLFULL

Esta rotina lê os XMLs baixados pela rotina anterior e gera as notas fiscais de saída e de entrada no Protheus, de acordo com o CFOP do XML.

Acione e preencha o período de importação e o intervalo de números das notas fiscais.

Figura 10 — Perguntas da rotina Import. XML MLFULL — período

Figura 11 — Perguntas da rotina Import. XML MLFULL — intervalo de notas fiscais

Acione .

Figura 12 — Tela de informações da rotina Import. XML MLFULL

Acione .

Figura 13 — Processamento da rotina Import. XML MLFULL

3.3 Status Int. Pedidos — monitoramento

Para verificar se a integração gerou corretamente as notas fiscais, utilize a rotina Status Int. Pedidos.

Caminho: Faturamento → Atualizações → Fulfillment → Status Int. Pedidos.

Figura 14 — Browse da rotina Status Int. Pedidos

Observe a legenda e a coluna Status Pedido.

Figura 15 — Coluna Status Pedido e legenda de cores

3.3.1 Legenda de status

Figura 16 — Legenda completa da rotina Status de Integração de Pedidos

3.4 Tratamento de erros e reprocessamento

Registros com legenda vermelha indicam erro na integração e exigem análise.

1. Posicione o cursor sobre o registro com erro;
2. Acione Visualizar;
3. Consulte o campo Ocorrência, que contém a descrição do erro;
4. Corrija a causa do erro;
5. Posicione novamente sobre o registro e acione Reprocessar Registro, para que ele entre na fila de reprocessamento;
6. Execute novamente a rotina Import. XML MLFULL.

Figura 17 — Registro com erro posicionado no browse

Acione .

Figura 18 — Tela de visualização do registro

Figura 19 — Campo Ocorrência com a descrição do erro

Além da consulta pela rotina Status Int. Pedidos, o erro também pode ser exibido em janela durante a execução da rotina Import. XML MLFULL.

Figura 20 — Erro exibido durante a execução da rotina Import. XML MLFULL

4. Conferência e Diagnóstico

4.1 Conferência pela rotina Status Int. Pedidos

A primeira forma de conferência é a própria rotina Status Int. Pedidos, em Faturamento → Atualizações → Fulfillment → Status Int. Pedidos.

Figura 21 — Browse da rotina Status Int. Pedidos com registros integrados e com erro

Registros com legenda vermelha indicam que o XML não foi integrado. Posicione o cursor sobre o registro, acione Visualizar e consulte o campo Ocorrência.

Figura 22 — Registro selecionado para visualização

Figura 23 — Campo Ocorrência com o detalhamento do erro

As causas mais frequentes para esse tipo de erro são:

• Produto sem saldo em estoque para faturamento;
• Cliente bloqueado por crédito;
• Demais erros da rotina de documento de saída;
• Erro retornado pela rotina padrão de geração do documento (identificado na ocorrência como MSExecAuto);
• Mensagem de erro do módulo Atos Data durante o processo de integração.

Corrigida a causa do erro, posicione o cursor sobre o registro e acione Reprocessar Registro — ou Reprocessar Todos, para enviar todos os pedidos à fila de reprocessamento. Confirme e execute novamente a rotina Import. XML MLFULL.

4.2 Conferência pelo XML de origem

A segunda forma de conferência consiste em comparar o XML de origem com o que foi gravado no Protheus.

1. Acesse Faturamento → Atualizações → Fulfillment → Status Int. Pedidos;
2. Selecione o registro do XML a ser conferido;
3. Acione Outras ações → Visualizar XML;
4. Copie o conteúdo exibido e cole em um editor de texto;
5. Compare o conteúdo do XML com os dados gravados no Protheus.

Figura 24 — Opção Visualizar XML no menu Outras ações

Figura 25 — Conteúdo do XML exibido pela rotina

4.3 Problemas de saldo em estoque

Falhas de faturamento por ausência de saldo podem decorrer das situações abaixo. As causas relacionadas a TES e a tipos de operação são de configuração e devem ser encaminhadas ao suporte técnico.

4.4 Problema na busca do código do produto

A rotina lê o código do produto informado no XML e tenta localizá-lo no cadastro de produtos do Protheus. Caso não o encontre, tenta nova localização pelo EAN informado no XML. Se ambas as buscas retornarem negativas, o sistema apresenta erro na geração do pedido de venda para o código informado no XML.

Para esse cenário, utilize a rotina Cad. De/Para de Produtos, que relaciona o código recebido no XML ao código cadastrado no Protheus.