Conectando o TOTVS Protheus

A conexão com o TOTVS Protheus é feita por credenciais: o endereço do REST do servidor Protheus da sua empresa e um usuário do Protheus dedicado à integração. Como o servidor é da própria empresa, parte da preparação é da sua equipe de TI.

Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação.

Antes de começar

• Peça à TI o endereço do REST do Protheus, publicado na internet e com https — o REST do Protheus nasce desligado e em http, então em geral é preciso ativá-lo e publicá-lo com SSL.
• Crie um usuário do Protheus dedicado à integração, com permissão de leitura nos módulos que serão consultados.
• Quem está no TOTVS Cloud obtém o endereço abrindo um chamado com a TOTVS.

Passo a passo

1. Acesse Configurações → Integrações na Toca.
2. Localize o card TOTVS Protheus e clique no botão de conexão.
3. Preencha os três campos:
   • Endereço do servidor — o REST do Protheus, com https (ex.: https://erp.suaempresa.com.br:8181/rest).
   • Usuário — o usuário de integração criado no Protheus.
   • Senha — a senha desse usuário.
4. Salve. O card fica marcado como conectado e a Toca já consegue consultar o ERP.

O que a Toca acessa

Com a conexão ativa, a Toca lê pedidos de venda, notas fiscais de saída, títulos a receber e a pagar, produtos, estoque e clientes do Protheus. O acesso é somente de leitura: a Toca não altera dados no seu ERP. Conectar o TOTVS Protheus não desativa a integração da sua loja virtual ou marketplace — as conexões convivem, e a Toca cruza os dados do ERP com os da loja.

Manutenção da conexão

Como o servidor é da sua empresa, a conexão depende de o REST do Protheus continuar publicado e no ar. Se a senha do usuário de integração mudar no Protheus, atualize-a na Toca pelo mesmo card em Configurações → Integrações.

Problemas comuns

• Endereço recusado ao salvar — o campo exige o endereço com https. Endereço em http não é aceito; peça à TI a publicação com SSL.
• Erro de conexão — na maioria dos casos o REST está fora do ar, sem SSL ou não publicado na internet. Confirme com a TI antes de revisar as credenciais.
• Consultas retornam erro de licença (503) — o REST consome licença TOTVS da sua empresa e responde 503 quando não há licença disponível. A Toca faz uma chamada por vez para não disputar licença com os usuários do ERP.
• Campos que parecem vazios — campos protegidos somem da resposta quando o usuário de integração não tem permissão de vê-los. Revise as permissões do usuário no Protheus.