> For the complete documentation index, see [llms.txt](https://usefin.gitbook.io/guia-fin/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://usefin.gitbook.io/guia-fin/automacoes/configuracao-avancada-de-agentes-de-contas-a-pagar.md).

# Configuração Avançada de Agentes de Contas a Pagar

{% hint style="info" %}
**Criação rápida:** Para criar um agente com configurações padrão, acesse a [Fin Store](https://usefin.com.br/agents/marketplace) e escolha um template pronto. Este guia detalha cada opção caso queira personalizar.
{% endhint %}

***

### Sumário

#### Módulos de Entrada

<table><thead><tr><th data-type="content-ref">Módulo</th><th>Descrição</th></tr></thead><tbody><tr><td><a href="/pages/Ze8Xw4O6GrDgPnTT0fmo#modulo-de-entrada-whatsapp">/pages/Ze8Xw4O6GrDgPnTT0fmo#modulo-de-entrada-whatsapp</a></td><td>Receba documentos financeiros via WhatsApp</td></tr><tr><td><a href="/pages/Ze8Xw4O6GrDgPnTT0fmo#modulo-de-entrada-gmail">/pages/Ze8Xw4O6GrDgPnTT0fmo#modulo-de-entrada-gmail</a></td><td>Monitore sua caixa de entrada do Gmail</td></tr><tr><td><a href="/pages/Ze8Xw4O6GrDgPnTT0fmo#modulo-de-entrada-sharepoint">/pages/Ze8Xw4O6GrDgPnTT0fmo#modulo-de-entrada-sharepoint</a></td><td>Monitore uma pasta do SharePoint</td></tr></tbody></table>

#### Processamento

<table><thead><tr><th data-type="content-ref">Módulo</th><th>Descrição</th></tr></thead><tbody><tr><td><a href="/pages/Ze8Xw4O6GrDgPnTT0fmo#modulo-de-processamento">/pages/Ze8Xw4O6GrDgPnTT0fmo#modulo-de-processamento</a></td><td>Configure matching, aprovação automática e exceções</td></tr></tbody></table>

#### Módulos de Saída

<table data-full-width="false"><thead><tr><th data-type="content-ref">Módulo</th><th>Descrição</th></tr></thead><tbody><tr><td><a href="/pages/Ze8Xw4O6GrDgPnTT0fmo#modulo-de-saida-sharepoint">/pages/Ze8Xw4O6GrDgPnTT0fmo#modulo-de-saida-sharepoint</a></td><td>Organize documentos no SharePoint</td></tr><tr><td><a href="/pages/Ze8Xw4O6GrDgPnTT0fmo#modulo-de-saida-google-drive">/pages/Ze8Xw4O6GrDgPnTT0fmo#modulo-de-saida-google-drive</a></td><td>Arquive documentos no Google Drive</td></tr></tbody></table>

***

### Como acessar a edição

**1.** Acesse a página de **Agentes** no menu lateral.

<figure><img src="/files/IcbXQax0NWuUw2boOIiy" alt=""><figcaption></figcaption></figure>

**2.** Clique no agente que deseja editar.

**3.** Na página de detalhes, clique no botão **Editar** no canto superior direito.

<figure><img src="/files/Q3zHYT7mreNBpcegQUN9" alt=""><figcaption></figcaption></figure>

**4.** O wizard de edição possui 5 steps. Navegue por eles para encontrar o módulo desejado.

<figure><img src="/files/vtRBvuvT6fq3IWDvdoBe" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Você também pode adicionar novos módulos a um agente existente pela Fin Store — basta selecionar um template que inclua o módulo desejado.
{% endhint %}

***

No Step 2 (Entrada), você verá os módulos de entrada já configurados (caso já possua um agente) e pode adicionar novos:

<figure><img src="/files/i75Nk60wcpeVURMl3mye" alt=""><figcaption></figcaption></figure>

Clique em **Adicionar Módulo** para ver os provedores disponíveis:

<figure><img src="/files/QrwsqhH5hj3fMwhuvN81" alt=""><figcaption></figcaption></figure>

***

### Módulo de Entrada: WhatsApp

Configura como o agente recebe documentos financeiros via WhatsApp.

<figure><img src="/files/R62PepQjU8ZVzB87NuhX" alt=""><figcaption></figcaption></figure>

#### Comportamento de Recebimento

**Processar todos os arquivos do grupo**

* **Ativado (padrão):** O agente processa todos os documentos enviados no grupo, sem necessidade de menção
* **Desativado:** O agente só processa documentos quando for mencionado (@)

{% hint style="info" %}
Em grupos com muitos participantes, considere desativar esta opção para evitar processar documentos que não são contas a pagar.
{% endhint %}

**Responder aos documentos sem menção**

* **Ativado:** O Fin responde automaticamente a todos os documentos recebidos
* **Desativado (padrão):** O Fin processa silenciosamente, sem enviar resposta no grupo

{% hint style="warning" %}
Ativar respostas automáticas pode gerar muito ruído no grupo. Recomendamos manter desativado.
{% endhint %}

#### \[Desabilitado] Controle de Acesso (Em breve)

**Filtrar por número de telefone**

Quando ativado, apenas números autorizados poderão enviar documentos para processamento.

* Adicione números no formato **E.164** (com DDD, apenas dígitos): `5511999999999`
* Mínimo de 10, máximo de 13 dígitos
* Números duplicados são rejeitados automaticamente

***

### Módulo de Entrada: Gmail

Configura como o agente monitora sua caixa de entrada do Gmail.

<figure><img src="/files/d3e4q6xgHAW0xWCLiMjh" alt=""><figcaption></figcaption></figure>

#### Filtros de Entrada

**Filtrar por Remetente**

* **Ativado (padrão):** Processa apenas emails de remetentes autorizados
* **Desativado:** Processa emails de qualquer remetente

Ao adicionar remetentes, você pode:

* **Email exato:** `financeiro@fornecedor.com.br` — aceita apenas deste email
* **Domínio inteiro:** marque **"Aceitar todos os emails desta empresa"** — aceita qualquer email de `@fornecedor.com.br`

{% hint style="info" %}
Você pode importar vários remetentes de uma vez clicando em **Importar Lista** e colando os emails separados por vírgula ou linha.
{% endhint %}

**Filtrar por Assunto**

Quando ativado, processa apenas emails cujo assunto contenha ao menos uma das palavras-chave configuradas.

Exemplos de palavras-chave úteis:

* `Nota Fiscal`, `NF-e`, `Fatura`
* `Boleto`, `Cobrança`, `Pagamento`
* `Invoice`, `Payment`

{% hint style="info" %}
A busca é feita com lógica **OU** — basta uma palavra-chave casar para o email ser processado.
{% endhint %}

**Filtrar por Marcador/Etiqueta**

Quando ativado, processa apenas emails que possuam marcadores (labels) específicos do Gmail.

Exemplos: `Financeiro`, `Contas a Pagar`, `Fornecedores`

{% hint style="info" %}
Você pode criar regras de filtro no Gmail para aplicar marcadores automaticamente em emails de determinados remetentes, e o Fin processará apenas esses.
{% endhint %}

**Exigir Anexo**

* **Ativado (padrão):** Processa apenas emails com arquivos anexados (PDF, imagem, etc.)
* **Desativado:** Processa qualquer email, mesmo sem anexo

#### Ações Pós-Processamento

<figure><img src="/files/q0e2qU3g9W8a02hGHmG4" alt=""><figcaption></figcaption></figure>

**Adicionar Marcador após Processar**

Quando ativado, o Fin adiciona automaticamente um marcador no Gmail para identificar emails já processados. Os marcadores seguem o padrão:

| Status     | Marcador                            |
| ---------- | ----------------------------------- |
| Em análise | `[Analisando] FIN - Contas a Pagar` |
| Processado | `[Processado] FIN - Contas a Pagar` |
| Ignorado   | `[Ignorado] FIN - Contas a Pagar`   |
| Erro       | `[Erro] FIN - Contas a Pagar`       |
| Arquivado  | `[Arquivado] FIN - Contas a Pagar`  |

**Arquivar Email após Sucesso**

Quando ativado, o email é removido da caixa de entrada após processamento com sucesso (ainda acessível no Gmail via busca ou marcadores).

***

### Módulo de Entrada: SharePoint

Configura o monitoramento de uma pasta do SharePoint para receber documentos.

#### Pasta de Monitoramento

Informe o **link completo** da pasta do SharePoint que o agente deve monitorar.

Formato: `https://suaconta.sharepoint.com/sites/Financeiro/Documentos/Entrada`

{% hint style="warning" %}
Certifique-se de que a conta conectada ao SharePoint tem **permissão de leitura** na pasta informada.
{% endhint %}

#### Tipos de Arquivo

Por padrão, o agente processa apenas arquivos **PDF**. Documentos em outros formatos são ignorados.

***

### Módulo de Processamento

Configura como o Fin analisa e classifica os documentos recebidos. Este é o "cérebro" do agente.

#### Modo de Operação

| Modo                 | Descrição                                                                          |
| -------------------- | ---------------------------------------------------------------------------------- |
| **Processar com IA** | O Fin extrai dados, faz matching com provisionamentos e classifica automaticamente |
| **Apenas Arquivar**  | O Fin apenas salva o documento sem processamento inteligente                       |

#### Empresas Habilitadas (Roteamento por CNPJ)

Selecione quais empresas o agente deve processar. O Fin usa o CNPJ para rotear documentos — se o CNPJ do destinatário não estiver na lista, o documento é ignorado.

{% hint style="info" %}
Se você gerencia múltiplas empresas, pode habilitar todas no mesmo agente. O Fin encaminhará cada documento para o ERP da empresa correta.
{% endhint %}

\### Regras de Matching

Configure como o Fin compara documentos recebidos com lançamentos provisionados no ERP.

**Tolerância de Data**

* **Ativado:** Aceita documentos com vencimento diferente do provisionado (dentro da tolerância)
* **Desativado (padrão):** Exige data de vencimento exata
* **Tolerância máxima:** 0 a 30 dias (padrão: 3 dias)

**Busca sem Vencimento**

* **Ativado (padrão):** Quando o documento não tem data de vencimento, busca provisionamentos próximos à data de emissão
* **Desativado:** Documentos sem vencimento não são comparados
* **Janela de busca:** 1 a 90 dias (padrão: 30 dias)

**Tolerância de Valor**

* **Ativado:** Aceita documentos com valor diferente do provisionado (dentro da tolerância percentual)
* **Desativado (padrão):** Exige valor exato
* **Tolerância máxima:** 0% a 50% (padrão: 5%)

#### Aprovação Automática

Controla quando o Fin envia lançamentos automaticamente ao ERP sem revisão manual.

{% hint style="warning" %}
Quando a aprovação automática está **desabilitada**, todos os lançamentos vão para revisão manual na página de Contas a Pagar.
{% endhint %}

**Cenários de Aprovação**

| Cenário                                       | Descrição                                                                               | Padrão     |
| --------------------------------------------- | --------------------------------------------------------------------------------------- | ---------- |
| **Documento casa com provisionamento**        | O Fin encontrou um lançamento provisionado no ERP que corresponde ao documento          | Ativado    |
| **Fornecedor conhecido, sem provisionamento** | O fornecedor existe no ERP com histórico, mas não há provisionamento                    | Ativado    |
| **Fornecedor desconhecido**                   | CNPJ não encontrado no ERP — cadastrar fornecedor automaticamente                       | Desativado |
| **Categorizar com IA**                        | Usar IA para sugerir a categoria do lançamento (apenas para fornecedores desconhecidos) | Desativado |

**Conta Bancária Padrão**

Selecione a conta bancária padrão para novos lançamentos. As contas disponíveis são carregadas do seu ERP.

#### Exceções por Fornecedor

Para fornecedores específicos, você pode definir regras diferentes das globais:

* **Tolerância de data personalizada** — ex: para o fornecedor X, aceitar até 10 dias de diferença
* **Tolerância de valor personalizada** — ex: para o fornecedor Y, aceitar até 15% de variação

Clique em **Adicionar exceção** e selecione o fornecedor pelo nome ou CNPJ.

***

No Step 4 (Saída), você pode adicionar múltiplos destinos:

Clique em **Adicionar Módulo** para ver os destinos disponíveis:

***

### Módulo de Saída: SharePoint

Configura onde e como os documentos processados são arquivados no SharePoint.

#### Pasta de Destino

Informe o **link completo** da pasta no SharePoint onde os documentos devem ser salvos.

Formato: `https://suaconta.sharepoint.com/sites/Financeiro/Documentos/Processados`

#### Organização em Subpastas

**Criar subpastas de organização**

* **Ativado (padrão):** O Fin cria automaticamente subpastas por **Ano/Mês/Dia**
* **Desativado:** Todos os arquivos são salvos diretamente na pasta raiz

**Criar pasta com CNPJ**

* **Ativado (padrão):** Organiza arquivos em pastas separadas por CNPJ da empresa
* **Desativado:** Não separa por empresa

#### Exemplo de Estrutura

Com ambas opções ativadas, a estrutura fica:

```
📁 Pasta de Destino/
  └── 📁 usefin/
      └── 📁 12345678000199/     ← CNPJ
          └── 📁 2025/
              └── 📁 12/
                  └── 📁 11/
                      └── 📄 143000-nota-fiscal.pdf
```

***

### Módulo de Saída: Google Drive

Configura o arquivamento de documentos processados no Google Drive.

#### Pasta de Destino

Os documentos são salvos na **raiz do Google Drive** da conta conectada, dentro de uma pasta organizada automaticamente pelo Fin.

#### Estrutura de Arquivos

O Fin organiza os arquivos seguindo o mesmo padrão do SharePoint:

```
📁 Meu Drive/
  └── 📁 usefin/
      └── 📁 12345678000199/     ← CNPJ
          └── 📁 2025/
              └── 📁 12/
                  └── 📁 11/
                      └── 📄 143000-nota-fiscal.pdf
```

{% hint style="info" %}
A pasta de destino é fixa na raiz do Drive. Para alterar, entre em contato com o suporte.
{% endhint %}

***

### Dicas Gerais

* **Combine módulos de entrada:** Você pode ter WhatsApp + Gmail no mesmo agente, recebendo documentos de ambas as fontes
* **Combine módulos de saída:** Envie ao ERP e simultaneamente arquive no SharePoint ou Drive
* **Teste antes de ativar a aprovação automática:** Comece com aprovação manual para validar a qualidade do processamento
* **Use exceções por fornecedor** para fornecedores com padrões de pagamento atípicos

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://usefin.gitbook.io/guia-fin/automacoes/configuracao-avancada-de-agentes-de-contas-a-pagar.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.