A API é o melhor caminho para integrar o Protheus quando outro sistema precisa de dados atualizados ou envia informações ao longo do dia, como portais, CRMs e gateways. Para cargas grandes e periódicas ou relatórios, outros formatos costumam atender melhor. Em qualquer caso, valide autenticação, regras do ERP, tratamento de erro e registro de cada chamada antes da produção.
O que é integrar o Protheus via API
Uma API é uma porta de entrada para outro sistema conversar com o Protheus de forma controlada: consultar um cadastro, criar um pedido ou atualizar um status. O Protheus permite publicar serviços REST no servidor de aplicação, conforme a documentação da TOTVS.
Na prática, isso substitui a planilha, a exportação e a digitação dupla por uma troca automática, com regra e registro.
Quando a API é o melhor caminho
| Situação | Formato indicado | Por quê |
|---|---|---|
| Portal ou aplicativo que consulta dados do ERP | API | O usuário precisa da informação atualizada no momento |
| CRM, e-commerce ou gateway enviando pedidos e pagamentos | API | Cada evento precisa chegar ao ERP assim que acontece |
| Carga grande e periódica, como tabelas inteiras | Lote (arquivos ou rotina agendada) | Processar tudo de uma vez é mais simples e pesa menos |
| Relatórios e BI | Leitura para consulta | Não altera o ERP e não depende de chamadas a cada consulta |
Muitas empresas combinam os formatos: API para o que precisa ser imediato e lote para o resto.
O que validar antes da produção
- Autenticação e usuário de integração: cada sistema usa um acesso próprio, só com as permissões que precisa. Nas versões mais recentes do Protheus, a TOTVS passou a exigir autenticação nos serviços REST.
- Regras e validações do ERP: o dado deve entrar pelas rotinas do Protheus, que aplicam as regras de negócio. Gravar direto na tabela pode pular essas validações.
- Tratamento de erro: quando o Protheus recusa uma chamada, o sistema de origem precisa saber o motivo e poder reenviar depois de corrigir.
- Repetição sem duplicar: se a mesma chamada for enviada duas vezes, por falha de rede, por exemplo, o pedido não pode ser criado em dobro.
- Volume e desempenho: a API precisa aguentar o pico de uso sem deixar o ERP lento para quem trabalha nele.
- Registro de cada chamada: o que foi enviado, quando e com qual resposta. Sem isso, achar a origem de uma falha vira adivinhação.
Sinais de que a integração atual precisa de revisão
- Dados divergentes: o pedido, o cliente ou o status no Protheus não bate com o do outro sistema.
- Reprocessamento manual: alguém precisa reenviar ou corrigir dados que a integração deixou pelo caminho.
- Falha descoberta pelo cliente: o erro só aparece quando um cliente ou outra área reclama.
- Medo de mexer: qualquer ajuste na integração parece arriscado, e a empresa adia novas automações.
Esses sinais indicam que falta tratamento de erro, registro ou uma definição clara da fonte de cada dado.
Passo a passo
- Escolha as rotinas prioritárias: comece pelas trocas que mais geram retrabalho ou atraso.
- Defina a fonte de cada dado: cada informação tem um sistema dono, para não ser alterada em dois lugares.
- Mapeie campos, regras e exceções: o que é enviado, em que formato e o que fazer quando o dado está incompleto.
- Teste em ambiente separado: inclua os casos de erro: dado inválido, sistema fora do ar, chamada repetida.
- Coloque em produção com acompanhamento: monitore as primeiras semanas e trate as falhas de sincronização assim que aparecerem. Monitoramento e alertas ajudam nessa fase.
Erros comuns
- Tratar a API como "só ligar um sistema no outro": sem validação, tratamento de erro e registro, a integração falha em silêncio.
- Usar o mesmo usuário para tudo: fica impossível saber qual sistema fez cada alteração.
- Ignorar as atualizações do Protheus: depois de cada atualização do ERP, a integração precisa ser testada de novo.
- Não prever reenvio: uma chamada perdida vira um pedido ou pagamento que ninguém vê.
Como a RTX ajuda
A RTX conecta o Protheus a portais, CRMs, gateways, BI e sistemas internos com validação e logs, testa cada rotina antes da produção e acompanha a integração depois. Também revisa integrações antigas para entender onde o fluxo falha. Veja como funciona a integração com Protheus.