TOTVS Protheus
Conectar TOTVS Protheus à operação da sua empresa. Confira os campos necessários, a obtenção das credenciais e o funcionamento na Zild.
Conectar TOTVS Protheus à operação da sua empresa.
Onde configurar
Abra Zild Admin → Integrações → Conectores, localize o provedor e use Configurar ou Editar. Informe os dados deste guia, habilite o conector para o fluxo e salve.
Credenciais da sua empresa
O cliente deve obter e configurar suas próprias chaves de API ou a forma de autenticação exigida por este conector. A assinatura Zild é definida pelo tamanho da empresa; o consumo dos serviços externos é cobrado pelo respectivo provedor, separado da assinatura. Não é necessário configurar conectores que sua operação não utiliza.
Campos necessários
Os requisitos abaixo são os dados necessários ao fluxo que utiliza o conector. O cadastro genérico pode aceitar campos vazios que serão exigidos somente ao executar uma operação. O botão Salvar não confirma que a credencial funciona no provedor.
| Campo | Requisito para o fluxo |
|---|---|
Url | URL HTTPS da API da sua instância, com o prefixo da versão exigida. |
ApiKey | Token de acesso emitido pelo provedor. |
CredentialsJson | Alternativa Basic: Username e Password. |
CustomProperties | Configure Path.ListCustomers, Path.ListProducts, Path.ListOrders, Path.GetOrder e Path.CreateOrder. |
Como obter as credenciais
- Solicite ao administrador TOTVS um usuário de integração e a URL REST HTTPS publicada no ambiente.
- Peça um token Bearer para ApiKey ou configure Username e Password no JSON seguro, conforme a autenticação habilitada.
- Confirme as rotas e permissões da versão instalada com o administrador; não existe uma chave pública universal.
Como funciona na Zild
As rotas variam por instalação e devem ser configuradas antes do uso.
Como conferir a configuração
Depois de salvar, use o fluxo correspondente (consulta, agente, chamada ou processamento) para verificar o acesso. Se houver erro, confira credencial, permissões e recurso escolhido no provedor. Para tipos limitados ou legados, confirme a disponibilidade com a administração antes de tentar usar.
Na edição, a Zild mostra credenciais protegidas como asteriscos. Preserve o valor mascarado para manter a credencial atual ou cole uma nova credencial para substituí-la.