TOTVS Protheus
8 min
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 documentação oficial da api totvs https //tdn totvs com/ 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