> For the complete documentation index, see [llms.txt](https://ajuda.consistem.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-contas-a-receber/dados-de-pagamento-do-contas-a-receber/consulta-de-titulos-por-api-belluno.md).

# Consulta de Títulos por API (Belluno)

{% hint style="success" %}
*Esta documentação é válida para todas as versões do Consistem ERP.*
{% endhint %}

### Pré-Requisitos

***

Não há.

### Acesso

***

Módulo: Financeiro - Contas a Receber\
Grupo: Dados de Pagamento do Contas a Receber

### Visão Geral

***

O objetivo deste programa é consultar e monitorar o status de todos os títulos a receber que foram gerados via integração com a Belluno (seja por Pix ou cartão de crédito).\
Serão exibidos na consulta somente os títulos cuja nota fiscal foi gerada através do programa [Geração e Emissão de Nota Fiscal (CCFT010)](/comercial/manuais-de-telas/comercial-faturamento/faturamento/geracao-e-emissao-de-nota-fiscal.md).\
A baixa efetiva dos títulos pagos com cartão de crédito, que antes era realizada manualmente, agora ocorre de forma automática através de tarefas agendadas. O sistema se comunica automaticamente com a Belluno para identificar e registrar a baixa total da parcela quando o pagamento pela bandeira do cartão for confirmado.

{% hint style="warning" %} <mark style="color:orange;">**Importante**</mark>

**Configuração e atualização de dados**\
A atualização dos títulos consultados neste programa agora é realizada de forma automática via task (tarefa agendada). Para que o processo funcione corretamente, é obrigatório configurar duas tarefas distintas no programa [Agendamento de Tarefas (CSTASK015)](/componentes/manuais-de-telas/agendamento-de-tarefas-e-processo-em-segundo-plano/agendamento-de-tarefas.md): uma agendada para as 09:00h e outra para as 17:00h. Ambas devem utilizar os parâmetros: **Módulo** Financeiro - Contas a Receber, **Tarefa** Atualizar Pagamentos Via Cartão Belluno, e deve-se configurar no grid de parâmetros o código da empresa desejada. A atualização automática ocorrerá somente nesses horários.\
Para consultar e atualizar dados mais recentes fora dos horários agendados ou realizar uma atualização manual pontual, utilize o botão **Consultar Link** presente na [Aba Link Pagamento Belluno (CCCCP100BTAB4)](/modulos/financeiro/manuais-de-telas/financeiro-contas-a-receber/dados-de-pagamento-do-contas-a-receber/geracao-de-dados-de-pagamento-sequencia-de-pagamento/aba-link-pagamento-belluno.md).
{% endhint %}

### Campos

***

*Campos assinalados com* <mark style="color:red;">**|**</mark> *são de preenchimento obrigatório.*

#### Vencimento Início | Vencimento Fim<mark style="color:red;">**|**</mark>

Informar as datas de início e fim do vencimento do título para consulta por API na Belluno.

#### Cliente<mark style="color:red;">**|**</mark>

Informar um ou mais códigos de clientes para consulta dos títulos da Belluno, ou teclar *Enter* no campo em branco para considerar todos.

#### Situação

Determinar a situação do título para consulta. As opções são:\
\- *Aberta*\
\- *Baixada Parcial*\
\- *Baixada*

#### Forma de Pagamento

Determinar a forma de pagamento do título para consulta. As opções são:\
\- *Cartão de Crédito*\
\- *Pix*\
\- *Pix e Cartão de Crédito*

### Colunas do Grid

***

#### Título

Exibe o número do título de acordo com os filtros informados.

#### Cliente | Descrição

Exibem o código e a descrição do cliente vinculado na nota fiscal.

#### Portador

Exibe o portador vinculado no título.

#### Vencimento

Exibe a data de vencimento do título.

#### Valor Título

Exibe o valor original do título.

#### Valor Total

Exibe o valor total do título.

#### Situação

Exibe a situação atual do título.

#### Pagamento

Exibe a data de pagamento do título.

#### Erro

Exibe a descrição detalhada do erro ocorrido durante o processamento do título, caso tenha havido falha na integração via API com a Belluno (por exemplo, erros de comunicação, validação ou retorno de dados). Se o campo estiver em branco, indica que o título foi processado ou está pendente sem erro reportado na última tentativa.

### Botões

***

#### Consultar

Exibe os dados da consulta conforme filtros informados.

#### Limpar

Limpa os dados da tela para nova consulta.

#### Detalha

Apresenta o programa [Título (CCCC711)](/comercial/manuais-de-telas/comercial-comissao-sobre-vendas/manutencoes-de-comissoes-de-representantes/titulo.md) para consulta do detalhamento do título.

***

{% hint style="danger" %} <mark style="color:red;">**Atenção**</mark>

As descrições das principais funcionalidades do sistema estão disponíveis na documentação de [Componentes](/tecnologia/erp/componentes.md).\
A utilização incorreta deste programa pode ocasionar problemas no funcionamento do sistema e nas integrações entre módulos.
{% endhint %}

<p align="center">Esse conteúdo foi útil?</p>

<p align="center"><a href="https://movidesk.consistem.com.br/form/10395/" class="button primary" data-icon="thumbs-up">Sim</a> <a href="https://movidesk.consistem.com.br/form/10395/" class="button primary" data-icon="thumbs-down">Não</a></p>


---

# 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://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-contas-a-receber/dados-de-pagamento-do-contas-a-receber/consulta-de-titulos-por-api-belluno.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.
