O VendasxAtacado sincroniza cada pedido com o ERP do negócio atacadista para que a operação fique refletida automaticamente no sistema de gestão: estoque, preços, comprovantes, conta corrente. A integração roda por API e mantém um log detalhado de cada tentativa, com possibilidade de reexecutar manualmente quando algo falha.
ERPs suportados
A plataforma tem integração nativa com oito ERPs, cada um com seu próprio doc de configuração:
- Contabilium — sync API direta.
- Dragonfish — via Dragonfish Bridge (aplicação desktop que conecta o ERP local à plataforma).
- DUX Software — sync API direta.
- Salesforce / Virtual Seller — sync API direta.
- Ninox — sync API direta.
- NonSistemas — sync API direta.
- Acqua — sync API direta.
- SaaS UE — sync API direta.
A escolha do ERP é configurada no menu lateral, em Configuração → ERP, e os detalhes de cada um (campos, o que se sincroniza, comportamento) estão em suas seções específicas.
Estados de sincronização
A cada vez que a plataforma tenta enviar ou receber informação do ERP, fica um registro (um "ERP log") com um estado:
- OK (✅ verde) — a operação foi concluída com sucesso e o ERP confirmou. No código corresponde a
:success. - ERROR (❌ vermelho) — a operação falhou. A plataforma mostra o erro no log e habilita o botão "Reexecutar".
- PENDENTE (🟡 amarelo) — a operação foi enviada, mas ainda não chegou a resposta do ERP. Resolve para OK ou ERROR quando chega a confirmação.
Na listagem de pedidos, a coluna ERP mostra o estado do último log de cada pedido. Os pedidos com erro costumam subir ao topo com um indicador visual vermelho para a equipe priorizar.
Tela de logs do ERP no pedido
A partir do detalhe de um pedido acessa-se Logs ERP, que lista cada tentativa de sincronização com:
- Estado (Sucesso / Erro / Pendente) com a cor correspondente.
- Tipo de ERP (Contabilium, DUX, etc.).
- Operação executada (por exemplo: criar pedido, atualizar estoque).
- ID no ERP — o identificador que o ERP atribuiu ao recurso, quando disponível.
- Data de envio e duração (em milissegundos; acima de 5000 ms é marcado em vermelho).
- Request — o payload JSON que a plataforma enviou ao ERP, expansível e formatado.
- Response — a resposta retornada pelo ERP, expansível e formatada. Em erros aparece em vermelho.
Cada log tem um toggle para expandir/recolher o detalhe. Os logs com estado Erro mostram um botão Reexecutar que dispara novamente a operação; útil depois de corrigir um dado no ERP (um código de produto faltante, um cliente não cadastrado, uma credencial vencida).
Ações disponíveis
- Ver logs ERP do pedido: lista cronológica de cada tentativa de sync com request/response detalhado.
- Expandir/recolher log: mostra o JSON completo do request e da resposta do ERP.
- Reexecutar sincronização: relança a operação que falhou a partir de um log com erro, sem precisar editar o pedido.
- Ver estado na listagem: a coluna ERP exibe OK / ERROR / PENDENTE para identificar rapidamente quais pedidos precisam de atenção.
Dicas
- Revise a lista de pedidos com estado ERROR ao menos uma vez por dia — em operações atacadistas com alto volume, erros acumulados geram diferenças de estoque e problemas de cobrança com o ERP.
- Os erros mais comuns são: produto não encontrado no ERP (revisar SKU/código), comprador não cadastrado (sincronizar ou cadastrar primeiro no ERP), credenciais vencidas (renovar token na integração) e campos faltantes no comprador (CUIT/CNPJ, regime tributário).
- Antes de reexecutar, abra o log e revise o response do ERP — a mensagem geralmente indica exatamente o que corrigir.
- Se uma sync demora mais de 5 segundos de forma consistente, pode ser um problema de rede ou um ERP saturado. Coordene horários de sincronização em massa para evitar choques com outros processos do ERP.
- Para integrações que não têm API direta (quando um cliente usa um ERP não suportado), o Dragonfish Bridge é o caminho habitual: instala-se em um PC do negócio e conecta o ERP local à plataforma.
- As exportações manuais de pedidos para Excel/CSV (que vivem na listagem de pedidos) são distintas da integração ERP — servem quando não há sync automática ou como backup. Algumas exportações sob medida (formatos customizados como Jesus Fernandez, Decimo Arte, Karina, etc.) ficam habilitadas apenas para negócios específicos por configuração admin da plataforma.