Cada pedido é empurrado para o ERP conectado e fica um registro de cada tentativa, com o pedido enviado, a resposta recebida e um botão para tentar de novo quando algo falha.
Passo a passo
Ver por que a sincronização de um pedido falhou
- No menu lateral, vá em Vendas → Pedidos. A coluna ERP mostra de relance como saiu a última tentativa de cada pedido.
- Abra um pedido com ERROR.
- Desça até o cartão de logs do ERP.
- Clique na linha do log para expandi-la. Você verá o REQUEST que foi enviado e o RESPONSE que o ERP devolveu.
- Leia a mensagem do response: quase sempre ela diz exatamente o que falta corrigir.
- Corrija o dado no ERP e toque em Reintentar naquela linha.
Ver se a sua integração está viva
- No menu lateral, vá em Configuração → ERP.
- Desça até o painel Atividade da integração.
- Em cima você verá Último push recebido e Última comunicação enviada, com quanto tempo faz de cada um.
- Embaixo há uma linha do tempo de eventos, filtrável com os chips Tudo, Recebidos, Enviados e Erros.
- Clique num evento para ver o detalhe dele.
Este painel é a resposta direta a "meu ERP continua conectado?". Se o seu ERP empurra dados para a loja e nunca o fez, aparece um aviso vermelho dizendo isso.
ERPs disponíveis
O seletor de Configuração → ERP oferece estas integrações:
- Contabilium
- Dragonfish — via Dragonfish Bridge, um aplicativo de desktop que conecta o ERP local com a plataforma.
- DUX
- Virtual Seller
- Ninox
- Acqua
- SAAS
- Bling — só para lojas do Brasil.
Além da lista de ERPs, o seletor oferece Dragonfish Bridge e API Token para integrações próprias.
NonSistemas continua funcionando nas contas que já o tinham configurado, mas não aparece no seletor para contas novas.
Cada ERP tem o próprio artigo de configuração com seus campos e seu comportamento.
Os estados de sincronização
Na coluna ERP da listagem é mostrado o resultado do último log de cada pedido:
- OK (verde) — a operação foi concluída e o ERP a confirmou.
- ERROR (vermelho) — a operação falhou. No detalhe do pedido, aquele log tem o botão Reintentar.
- ... (âmbar) — existe um registro da chamada mas a resposta nunca chegou. Não é uma espera normal: significa que a operação foi cortada no meio do caminho. Trate como um caso a revisar, não como algo que vai se resolver sozinho.
A listagem não reordena os pedidos com erro. A ordem padrão é por número de pedido, do mais novo para o mais antigo. Para encontrá-los, percorra a coluna ERP ou filtre pelo que precisar.
O cartão de logs do pedido
Cada linha mostra:
- O estado com sua cor: Exitoso, Error ou Pendiente.
- O nome do ERP.
- A operação que foi executada.
- O ERP id que o ERP atribuiu ao recurso, se ele o devolveu.
- A data de envio e a duração em milissegundos. Acima de 5000 ms fica marcada em vermelho.
Ao expandir a linha aparecem o REQUEST e o RESPONSE completos, formatados.
Atenção a um detalhe que confunde: request e response são guardados em formato EDN, não JSON. Leem-se igualmente bem, mas se você comparar caractere por caractere contra a documentação JSON do seu ERP vai ver diferenças de sintaxe que não são um problema.
O que Reintentar faz exatamente
Reintentar roda de novo a sincronização completa daquele pedido, não importa em qual linha de log você clicou. Ele não relança apenas a operação pontual que falhou.
Depois de tocar nele, recarregue a tela para ver o log novo: hoje o cartão não se atualiza sozinho e dá a sensação de que nada aconteceu.
Enviar um pedido ao ERP sob demanda
No rodapé do detalhe do pedido, algumas contas têm o botão Enviar para ERP, que empurra o pedido na hora. Não é a mesma coisa que Reintentar: este serve mesmo que o pedido não tenha nenhum log de erro. Ele é habilitado por conta, então não aparece em qualquer loja com ERP configurado.
Não dá para parar uma sincronização em curso
Não existe um botão para parar uma sincronização que já começou. O que dá para fazer é desligar funções específicas antes de elas rodarem: na configuração de cada ERP há chaves por função, por exemplo desativar a atualização de estoque no DUX, ou a sincronização de produtos e de fotos no Bling. O corte total é remover as credenciais do ERP.
Erros mais comuns
- Produto não encontrado no ERP — confira se o código ou SKU coincide.
- Comprador não cadastrado — crie o cliente no ERP ou sincronize-o primeiro.
- Credenciais vencidas — renove o token em Configuração → ERP.
- Campos fiscais faltando no comprador — identificação fiscal ou condição fiscal sem preencher.
Se algo não aparece
- Você não vê Configuração → ERP. É preciso ser administrador, ou gerente com a permissão ERP.
- Você não vê os logs nem o botão Reintentar. É preciso a permissão de Pedidos.
- Você não vê a coluna ERP na listagem. Ela só aparece se você tiver um ERP conectado.
- Você não vê o botão Enviar para ERP. Ele é habilitado por conta.
- Você não vê Bling no seletor. Ele só está disponível para lojas do Brasil.
- O painel de atividade diz que nunca se recebeu um push. Confira se o webhook do ERP está configurado com os dados que a própria tela de configuração mostra.