TOTVS Protheus
Objetivo
Este conector permite integrar a plataforma Fluid com o ERP TOTVS Protheus, viabilizando operações de cadastro, consulta e atualização de dados em módulos como Clientes, Finanças, Produtos e Pedidos.
Criando um fluxo
Para criar um fluxo com o conector TOTVS Protheus:
- Acesse a aba Fluxos na plataforma Fluid
- Clique em Criar fluxo
- Selecione o conector TOTVS Protheus como origem ou destino da ação
Criando conexão
A conexão exige a escolha do tipo de autenticação — como a Fluid vai se autenticar no Protheus. As duas opções usam usuário e senha; o que muda é a forma de envio. Em caso de dúvida, confirme com quem publicou o serviço REST.
Opção 1 - Token de acesso (padrão)
O conector troca usuário e senha por um token no endpoint de token do Protheus e usa esse token nas requisições. É o comportamento padrão da REST API do Protheus.
Campos obrigatórios:
- Usuário (username): usuário do Protheus com permissão de acesso à REST API
- Senha (password): senha do usuário informado acima
- URL do token (url_token): endpoint que emite o token de acesso. Informe apenas o endereço, sem parâmetros — usuário, senha e tipo de concessão são acrescentados automaticamente
Opção 2 - Basic
O conector envia usuário e senha em cada requisição, no cabeçalho de autenticação básica. Use quando o serviço REST está publicado sem endpoint de token.
Campos obrigatórios:
- Usuário (username): usuário usado na autenticação básica do serviço REST
- Senha (password): senha do usuário informado acima
Configurando fluxo
Após selecionar o conector e criar a conexão, defina o recurso e operação desejados. Cada operação pode requerer uma URL de destino e um corpo de requisição (body).
Recursos e Operações
Recurso: Clientes
Operação: Cadastrar
Realiza o cadastro de novos clientes no Protheus.
Campos obrigatórios:
- URL: endpoint para cadastro de clientes
- Corpo da requisição (body): selecione entre modelo "De/Para" ou "Template"
Recurso: Finanças
Operação: Contas a Pagar
Cria uma conta a pagar no módulo financeiro.
Campos obrigatórios:
- URL: endpoint de contas a pagar
- Corpo da requisição (body): selecione entre modelo "De/Para" ou "Template"
Operação: Contas a Receber
Cria uma conta a receber no módulo financeiro.
Campos obrigatórios:
- URL: endpoint de contas a receber
- Corpo da requisição (body): selecione entre modelo "De/Para" ou "Template"
Recurso: Produtos
Operação: Listar Produtos
Consulta produtos cadastrados no Protheus.
Campos obrigatórios:
- URL: endpoint de listagem de produtos
Operação: Confirmar Cadastro/Alteração
Confirma o cadastro ou atualização de produtos.
Campos obrigatórios:
- URL: endpoint de atualização
- Corpo da requisição (body): selecione entre modelo "De/Para" ou "Template"
Recurso: Pedidos
Operação: Cadastrar
Realiza o cadastro de novos pedidos de venda.
Campos obrigatórios:
- URL: endpoint de pedidos
- Corpo da requisição (body): selecione entre modelo "De/Para" ou "Template"
Operação: Atualizar Status
Atualiza o status do pedido, como liberação de crédito.
Campos obrigatórios:
- URL: endpoint de atualização de status
- Corpo da requisição (body): selecione entre modelo "De/Para" ou "Template"
Observações adicionais
- O conector exige endpoints ativos e devidamente expostos via API pelo ambiente Protheus
- A estrutura dos dados no corpo da requisição depende da customização do ambiente TOTVS
Conclusão
O conector TOTVS Protheus amplia a integração da plataforma Fluid com sistemas de gestão empresarial, permitindo operações críticas de forma automatizada e segura.