Dizer que o Protheus tem REST não significa que a operação necessária está pronta como endpoint. Uma release antiga, módulo específico ou customização pode deixar justamente o lançamento desejado fora da API publicada. Ainda assim, automação de tela não precisa ser a primeira resposta.
A decisão deve preservar a regra de negócio do ERP. O objetivo é encontrar o ponto suportado mais próximo da operação, com autenticação, log e uma forma clara de recuperar falhas.
Ordem prática de preferência
Primeiro verificamos API padrão e serviços do módulo. Depois avaliamos encapsular uma rotina oficial, como ExecAuto, em um serviço ADVPL controlado. Mensagem Única e adapters EAI podem ser adequados quando existe um fluxo de integração previsto pela TOTVS. Arquivo estruturado entra quando a rotina já possui importador confiável.
Consulta de banco pode servir para leitura, de preferência por réplica e usuário restrito. Escrita direta em tabela só parece simples porque omite validações e efeitos colaterais; não é o caminho normal para movimentações. RPA fica para telas sem ponto de integração utilizável.
Serviço customizado com contrato pequeno
Um endpoint ADVPL não deve expor tabelas inteiras. Ele recebe um contrato de negócio — por exemplo, cliente, itens e referência externa — valida a entrada, chama a rotina suportada e responde com identificador e erros. Isso reduz acoplamento com campos internos.
O serviço também precisa autenticar o consumidor, limitar operações, registrar correlação e ser idempotente. Se o integrador repetir a chamada após um timeout, a referência externa permite devolver o resultado anterior sem duplicar movimento.
Quando EAI ou arquivo faz mais sentido
A documentação TOTVS mostra adapters EAI e mensagens como Item, CustomerVendor, InputDocument e SalesOrder em integrações oficiais. Se o ecossistema já utiliza Mensagem Única, seguir esse padrão pode ser mais sustentável do que criar outro canal paralelo.
Arquivos CSV, XML ou layouts proprietários funcionam para lotes e janelas definidas. O fluxo deve guardar arquivo recebido, versão do layout, número de linhas aceitas e rejeitadas e comprovante de importação.
RPA como último quilômetro
Quando só existe a tela, o robô opera com usuário próprio e permissões mínimas. Seletores, mensagens de validação, pop-ups e versão do SmartClient entram no teste. A execução precisa capturar evidência e parar diante de resposta inesperada.
RPA não remove a necessidade de integração. Ainda é preciso uma fila, regras de duplicidade, monitoramento e reconciliação. Sem isso, o robô apenas digita mais rápido e erra em escala.
Diagnóstico do ambiente
Precisamos da release, LIB, AppServer, módulos, rotina-alvo, pontos de entrada existentes e políticas do fornecedor que mantém o ERP. Um teste em homologação revela quais validações e customizações são acionadas.
A entrega começa pequena: uma operação, contrato versionado e retorno auditável. Se houver troca futura da API ou da rotina, o sistema externo continua falando com o mesmo contrato e apenas o adaptador muda.