Quando um pedido da loja virtual não aparece no ERP, a causa quase sempre está em um de seis pontos da integração: produto da loja sem vínculo com o código do ERP, cliente com dados que o ERP recusa, status de pagamento que a integração não reconhece, forma de pagamento ou de entrega sem correspondência no sistema, credencial de acesso expirada ou uma fila de erros que ninguém acompanha. O caminho para resolver é sempre o mesmo: abrir o registro de erros da integração, achar a mensagem do pedido e corrigir o cadastro ou o mapeamento que a gerou, e não digitar o pedido à mão no ERP.

O sintoma no depósito

O cliente comprou e pagou, a loja virtual mostra o pedido como aprovado, mas ele não aparece na lista de separação. Às vezes o problema só é percebido quando o cliente reclama do atraso. Em outros casos, entram alguns pedidos e outros não, sem padrão aparente.

A reação mais comum é digitar o pedido no ERP para não atrasar a entrega. Resolve o cliente da vez, mas cria um segundo problema: quando a integração volta a funcionar, ela pode importar o mesmo pedido, e ele sai duas vezes. Antes de digitar qualquer coisa, abra o registro de integração.

A maioria das integrações, seja um conector pronto, seja um serviço intermediário, guarda um registro com cada pedido recebido e o resultado: importado, rejeitado ou pendente, com a mensagem de erro. É ali que começa o diagnóstico.

Causa 1: produto da loja sem vínculo com o código do ERP

É a causa mais comum. O pedido traz o código do produto como cadastrado na loja, o chamado SKU, e o ERP procura um item com esse código. Um produto novo cadastrado só na loja, uma variação de cor ou tamanho criada às pressas ou um código alterado de um lado só fazem o pedido inteiro ser rejeitado.

Como resolver: cadastre ou vincule o item no ERP e reprocesse o pedido pela própria integração. Para evitar a repetição, defina que o produto nasce no ERP e é enviado para a loja, e não o contrário. Assim, todo item à venda na loja já existe no sistema.

Causa 2: cliente com dados que o ERP recusa

O ERP costuma criar o cliente automaticamente a partir do pedido. Se o CPF ou CNPJ vier inválido, se o endereço não tiver o código do município ou se o CEP não existir na base do sistema, o cadastro não é criado e o pedido para junto.

Como resolver: corrija o cadastro e reprocesse. Se o erro se repete, ajuste a loja para validar CPF e CEP no checkout. Outra situação comum é o cliente que já existe no ERP com outro e-mail ou com o documento formatado de outro jeito, o que pode gerar cadastro duplicado em vez de erro; confira a regra que a integração usa para reconhecer um cliente existente.

Causa 3: status de pagamento que a integração não reconhece

A integração normalmente só envia ao ERP os pedidos num status específico, como "pago" ou "aprovado". Se a loja ganhou um status novo, se o meio de pagamento passou a usar outro nome para o mesmo estado ou se o pedido ficou parado em análise antifraude, ele simplesmente não é enviado. Neste caso, não há erro no registro: o pedido nem chegou.

Como resolver: compare o status do pedido na loja com a lista de status que a integração está configurada para buscar. Ajuste o mapeamento, e não o status do pedido. Um exemplo hipotético: a loja passou a usar "pagamento confirmado" no lugar de "pago" depois de uma atualização, e por dois dias todos os pedidos por boleto ficaram de fora, enquanto os de cartão, com outro status, continuaram entrando.

Causa 4: forma de pagamento, frete ou operação sem correspondência

O ERP precisa traduzir o que vem da loja para os próprios cadastros: a forma de pagamento vira uma condição e um tipo de título; o frete vira uma transportadora e um valor; a venda vira um tipo de operação com regra fiscal. Essa tradução é o chamado de-para. Quando a loja oferece uma forma nova, como um parcelamento diferente ou uma modalidade de entrega recém-contratada, e ninguém cria a correspondência no ERP, o pedido é rejeitado.

Como resolver: crie a correspondência e reprocesse. Mantenha uma lista do de-para com quem é responsável por cada parte: o financeiro pelas formas de pagamento, a logística pelas entregas, o fiscal pelas operações. Toda novidade na loja passa por essa lista antes de ser ativada.

Causa 5: credencial expirada ou limite de chamadas

Quando nenhum pedido entra desde uma certa hora, a causa costuma ser de conexão: a chave de acesso foi revogada ou expirou, a senha do usuário de integração foi trocada ou a loja passou a limitar o número de consultas por minuto. O registro mostra erro de autenticação ou de excesso de requisições, ou não mostra nada porque a rotina parou.

Como resolver: renove a credencial e confira se a rotina de busca voltou a rodar. Use um usuário exclusivo para a integração, que ninguém altere ao trocar a própria senha, e registre quem é o responsável técnico e onde a credencial está guardada.

Causa 6: fila de erros que ninguém acompanha

Muitas vezes a integração funciona e registra o erro direito, mas ninguém olha o registro. Os pedidos rejeitados se acumulam até virar reclamação.

Como resolver: nomeie um responsável pela fila, com uma conferência no início e outra no meio do dia, e ative alertas por e-mail quando a ferramenta oferecer. A fila de rejeitados deve terminar o dia vazia.

Como evitar que os pedidos voltem a travar

Três rotinas cobrem a maior parte dos casos:

  • Conferência diária de contagem: número de pedidos aprovados na loja no dia anterior contra número de pedidos importados no ERP. Se não bater, a diferença está na fila ou num status não mapeado.
  • Checklist para novidades na loja: produto novo, forma de pagamento, frete ou status só entram no ar depois de existir o correspondente no ERP.
  • Regra contra digitação manual: pedido da loja só entra pelo reprocessamento da integração. Se for indispensável digitar, marque o pedido na loja para que a integração não o importe de novo.

Vale lembrar que o estoque costuma fazer o caminho inverso, do ERP para a loja. Se o pedido não entra, a reserva também não acontece, e o saldo publicado na loja fica maior do que o real, o que gera venda sem estoque. Mais um motivo para tratar a fila no mesmo dia. Para o lado técnico das conexões entre sistemas, veja a comparação entre integração do ERP por API, arquivo ou digitação.