Integrações
Integração por API com o ERP do fornecedor: o que avaliar
Antes de ligar uma integração por API com o ERP do fornecedor, avalie API oficial, códigos, duplicidade, erro por item, segurança e registros. Use o checklist.
Equipe Ravion · 13 de novembro de 2026 · 8 min de leitura
Integrar o seu sistema com o do fornecedor parece um projeto técnico, mas quem sente o resultado é a operação. Uma integração mal feita duplica pedido, perde venda sem avisar e entrega mensagens de erro que só o programador entende. Uma boa integração some do dia a dia: o saldo chega, o pedido sai e, quando algo falha, a tela diz o que fazer.
Este artigo é um roteiro para avaliar uma integração por API com o ERP do fornecedor antes de assinar ou de ligar. Serve para qualquer fornecedor e qualquer sistema. Ao longo do texto, usamos como exemplo a ligação do Ravion com o WinThor, feita pelo parceiro de integração Automati-Hub.
Em resumo: para avaliar uma integração por API com o ERP do fornecedor, confira se ela usa a API oficial, como liga os códigos de produto, se evita pedido duplicado, se mostra o erro de cada item com o que fazer, como trata demora e queda, se tem teste sem efeito, como protege a chave e os dados e se registra cada envio.
Por que integrar por API, e não por planilha
Planilha e e-mail funcionam até certo volume. O problema é que cada passo manual é uma chance de erro: código trocado, quantidade digitada errada, saldo de ontem. Uma API é a porta que um sistema oferece para outro conversar com ele de forma estruturada, sem ninguém copiar e colar.
Mas "ter API" não basta. O que separa uma integração confiável de uma dor de cabeça está nos pontos a seguir, agrupados pelo tipo de risco que cada um evita.
Por onde a integração entra e como os produtos se encontram
Ela usa a API oficial do sistema?
A primeira pergunta é por onde a integração entra no ERP do fornecedor. Gravar dados direto no banco de dados de outro sistema pula as regras dele e pode quebrar numa atualização. A API oficial respeita as validações do fabricante.
No exemplo do WinThor, os pedidos são criados pela API oficial da TOTVS. O teste de conexão confere, só lendo, o banco do WinThor, a API oficial e o Ravion, sem enviar nada.
Como o seu produto encontra o código do fornecedor?
O seu SKU raramente é igual ao código do fornecedor. A integração precisa de um vínculo claro entre os dois e de uma regra para unidades diferentes. Pergunte onde fica esse vínculo, como é tratada a diferença entre caixa e unidade e o que acontece com um código que chega sem produto ligado.
No Ravion, o vínculo fica no cadastro do produto ("código no fornecedor"), com o fator de conversão. Códigos sem vínculo são listados para você completar, e o envio pode trazer o SKU do Ravion para criar o vínculo na hora.
Duplicidade, erro por item e queda: onde a integração mais falha
Ela evita pedido duplicado?
Esse é o ponto que mais dói quando falha. Redes caem, telas travam, alguém clica duas vezes. Se cada clique cria um pedido novo, você recebe mercadoria em dobro.
A integração precisa reconhecer o que já foi enviado. No exemplo, o hub nunca envia a mesma venda duas vezes: reenviar uma compra manda só as vendas que ainda não estão no WinThor.
O erro vem por item, com o que fazer?
Uma compra com vinte vendas pode ter uma com problema. A integração não deveria aceitar tudo às cegas, nem recusar tudo por causa de um item. Avalie se o resultado vem item a item, se o motivo é o real, vindo do sistema do fornecedor, se a mensagem diz o que a operação deve fazer e se o documento só muda de situação quando tudo entrou.
No exemplo, a compra só passa a "enviada" quando todas as vendas entram. Senão, continua em rascunho, e a tela mostra, venda a venda, o motivo e um bloco "O que fazer".
Como ela lida com demora e queda?
Toda integração vai enfrentar um sistema fora do ar ou lento. O importante é o comportamento nessas horas. Uma boa integração diferencia "nada foi enviado" de "talvez tenha sido enviado".
No exemplo, se o hub está fora do ar, o Ravion avisa que nada foi enviado. Se o hub demora a responder, a orientação é não reenviar na hora e clicar de novo em um minuto para ver o resultado, sem risco de duplicar.
Dá para testar antes de valer?
Ligar uma integração em produção sem teste é pedir para descobrir os problemas com pedido real. Procure dois recursos:
- Teste de conexão que só lê os sistemas e mostra o que está certo e o que não está.
- Modo de simulação, em que o envio é conferido, mas nada é gravado no sistema do fornecedor.
No exemplo, existem os dois. Na simulação, as vendas aparecem como prontas para enviar, sem criar nada no WinThor e sem mudar a compra no Ravion.
Segurança: chave, acessos e dados que saem da empresa
Como a chave e os acessos são protegidos?
A chave que autentica a integração dá acesso a dados e a pedidos. Ela precisa ser tratada como senha. Verifique se ela fica guardada cifrada, se volta para a tela depois de salva, se o caminho de volta, do fornecedor para você, também exige a chave, e quem pode configurar a integração e enviar pedidos.
No Ravion, a chave fica cifrada e não volta para a tela. O hub usa a mesma chave para mandar o saldo ao Ravion, e envio sem ela é recusado. A configuração é do administrador, e o envio das compras, dos papéis de gestão e de operação.
Quais dados saem da sua empresa?
Integração boa leva só o necessário. Isso reduz risco e ajuda a cumprir a Lei Geral de Proteção de Dados (LGPD), que tem entre os seus princípios a limitação do tratamento de dados pessoais ao mínimo necessário para a finalidade.
No exemplo, o hub não acessa o banco do Ravion: tudo de que ele precisa vai no envio. São dados da compra e de cada venda, como produto, quantidade, código no fornecedor, custo e o CNPJ da filial compradora. Nome e endereço do comprador não fazem parte do envio, porque a mercadoria vem para o seu CD. As observações internas da venda também não saem do Ravion.
Registro e responsabilidades
Tudo fica registrado?
Quando algo dá errado, a primeira pergunta é "o que aconteceu?". Sem registro, ninguém sabe.
No exemplo, o hub registra cada tentativa de envio, e o Ravion mostra os últimos envios com a compra, a venda, o resultado e o número do pedido no WinThor. Além disso, cada tentativa vai para a auditoria do Ravion, com quem fez. Para entender o papel do hub nesse registro, veja como o Automati-Hub conecta o WinThor ao Ravion.
Quem resolve o quê?
Uma integração envolve pelo menos três partes: o seu sistema, o do fornecedor e quem faz a ponte. Antes de ligar, combine quem atende cada tipo de problema: cadastro, regra comercial do fornecedor, falha de comunicação. A mensagem de erro clara ajuda a mandar o problema para a pessoa certa.
Checklist rápido
- API oficial do sistema do fornecedor.
- Vínculo de códigos e fator de conversão no cadastro.
- Nenhum pedido duplicado em reenvio.
- Resultado item a item, com motivo e o que fazer.
- Comportamento claro em queda e demora.
- Teste de conexão e simulação.
- Chave cifrada e permissões por papel.
- Dados mínimos no envio.
- Registro de cada tentativa e auditoria.
Como o Ravion ajuda
O Ravion foi construído com esses pontos em mente. O dropshipping e Estoque Drop recebe o saldo do fornecedor por planilha, pelo cadastro ou por integração com o ERP dele, e monta a compra a partir das vendas. A segurança e os acessos garantem permissões por área e por filial, verificação em duas etapas, auditoria de cada alteração e certificados digitais guardados num cofre cifrado.
Na integração com o WinThor via Automati-Hub, disponível no plano Enterprise, tudo isso aparece na prática: API oficial da TOTVS, um pedido por venda, reenvio sem duplicidade, motivo de cada recusa e registro de cada tentativa. Se você está avaliando sistemas de forma mais ampla, veja como escolher um ERP para e-commerce e entenda a diferença entre hub de integração e ERP completo.
Para entender os avisos em tempo real entre sistemas, leia o que é webhook e quando usar e conheça a API e os webhooks do Ravion.
Perguntas frequentes
Toda integração por API é segura?
Não automaticamente. A segurança depende de como a chave é guardada, de quem pode usar a integração, de quais dados trafegam e de haver registro de cada operação. Avalie esses pontos antes de ligar.
O que é idempotência numa integração?
É a garantia de que repetir a mesma operação não gera efeito duplicado. Na prática, reenviar uma compra não cria o mesmo pedido duas vezes no sistema do fornecedor.
Preciso de um programador para manter a integração?
Para configurar e acompanhar, não deveria. Uma boa integração tem tela de configuração, teste de conexão e mensagens de erro que a operação entende. O suporte técnico entra quando há falha de comunicação.
Integração direta ou por um hub?
Depende dos sistemas. Um hub faz sentido quando ele conhece bem o sistema do fornecedor e cuida das regras, das tentativas e dos registros, deixando cada ERP com as suas responsabilidades.
O fornecedor precisa autorizar a integração?
Sim. A integração cria pedidos e lê dados no sistema do fornecedor, então depende do acordo dele e do acesso que ele liberar.
Conclusão
Avaliar uma integração por API com o ERP do fornecedor é olhar além do "tem API": códigos, duplicidade, erros por item, queda, teste, segurança, dados e registros. Use o checklist antes de ligar e cobre cada ponto de quem vai fazer a ponte. Para conhecer a integração do Ravion com distribuidores, fale com a equipe.
Quer ver isso funcionando na sua operação?
Teste o Ravion por 14 dias ou fale com a gente.