---
title: TOTVS Protheus
slug: totvs-protheus
docTags: 
createdAt: 2025-07-03T19:36:48.957Z
---

## 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:

1. Acesse a aba **Fluxos** na plataforma Fluid
2. Clique em **Criar fluxo**
3. 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.