> 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/consistem-integracoes/areas-de-negocio/financeiro/belluno.md).

# Belluno

## Visão Geral

A Belluno é uma plataforma WEB que oferece Antecipação de Recebíveis e Meios de Pagamento para empresas de todo porte.\
O objetivo desta integração é a facilidade no envio do link de pagamento do Consistem ERP ao cliente com o intuito de otimizar e agilizar os processos vinculados ao pedido de venda. Possibilitando também que a conciliação e baixas sejam integradas.\
Dessa forma, será possível negociar através de um pedido de venda a respectiva forma de pagamento, seja via Cartão de Crédito ou Pix, e garantir que o pedido seja faturado apenas se houver confirmação de pagamento junto à Belluno.

## Requisitos

<table><thead><tr><th width="397">Consistem ERP</th><th width="292">Belluno</th></tr></thead><tbody><tr><td><p><strong>Compatibilidade:</strong> 7.5 ou superiores do Consistem ERP.</p><p>Módulos: Comercial e Financeiro ativos.</p><p><a href="https://movidesk.consistem.com.br/form/5801/">Aquisição de licença</a> <strong>IBELL</strong> ativa junto à Consistem.</p><p>Orientamos o acompanhamento da nossa equipe de consultores.</p></td><td>Aquisição de licença e implantação deve ser verificada com a empresa fornecedora.<br><a href="https://belluno.digital/">Saiba mais</a></td></tr><tr><td><strong>Obrigatoriedade do Token:</strong> Necessário informar no ERP o token encaminhado pela Belluno após a abertura da conta (sem esta credencial, o Consistem não consegue autenticar as requisições de geração de link).</td><td><strong>Conta Digital:</strong> Criação de uma conta no <a href="https://belluno.tawk.help/article/como-abrir-sua-conta-digital-belluno">banco digital Belluno</a> (aberta por CNPJ).</td></tr><tr><td>Pedido de venda cadastrado no programa <a href="/spaces/migA2ohuxrj84wih1tu1/pages/y65e6M8OVw4CODf3U5tM">Cadastro de Pedido de Venda (CCPV005)</a>.</td><td><strong>Geração da Credencial:</strong> Obtenção do Token de API no painel da Belluno após a abertura da conta.</td></tr><tr><td>O campo <strong>Endereço de Remetente</strong> deverá estar preenchido na <a href="/spaces/0E9n0hpwK2TzblZSHb8i/pages/Y2dYE5ZKdxM0Ign0nFBj">Aba E-mail</a> do programa <a href="/spaces/0E9n0hpwK2TzblZSHb8i/pages/NKJqQJACPeVO6brkRQt3">Configuração Geral do Sistema (CSMEN080)</a>. Caso não esteja, realize o cadastro e salve as informações.</td><td></td></tr><tr><td>Realize o <a href="/spaces/XAGEHGEHsMtieeZPXhEm/pages/SXhYuExpdKFLbLc49zit">Cadastro de Operadora de Cartão de Crédito (CCCCP005)</a> com as devidas taxas. O botão <strong>Taxas Administração</strong> executa o <a href="/spaces/XAGEHGEHsMtieeZPXhEm/pages/QJBIFmmHIqr8piqydDTx">Cadastro de Operadora de Cartão de Crédito - Taxas Administrativas (CCCCP006)</a> para realizar o cadastro das taxas da operadora por prazo/parcela.</td><td></td></tr><tr><td>No <a href="/spaces/JAFv73zIUkocB6ArsYjv/pages/l7KstfLMJhWlRTzCuZlM">Cadastro de Cliente (CCCDB005)</a> revisar se o <strong>CEP</strong> do cliente é válido e se o <strong>Telefone</strong> está cadastrado.<br>Através do botão <strong>Manutenção</strong> - Opção <em>Informações Complementares</em> é possível acessar o programa <a href="/spaces/JAFv73zIUkocB6ArsYjv/pages/cl0aDk8uG06IT4mlQf21">Informações Complementares (CCCDB006)</a> para confirmar se o <strong>Celular</strong> está cadastrado.</td><td></td></tr></tbody></table>

## Parametrizações <a href="#cadastropositivoboavista-parametrizacoes" id="cadastropositivoboavista-parametrizacoes"></a>

1. Acesse o [site do banco](https://belluno.digital/) da Belluno e informe o [**Usuário** e **Senha**](https://app.belluno.digital/pagess/index_belluno.php).

   <figure><img src="/files/ZWDoVMOoSUIHXVfVQqhX" alt=""><figcaption></figcaption></figure>
2. No lado esquerdo da tela acione o menu **Configurações** e selecione a opção *Documentação de API*.
   1. Em **API Token** acione o botão **Gerar Token** e copie o link do token gerado.

      <figure><img src="/files/nJlWMM6H2n2pc6ciU0A2" alt=""><figcaption></figcaption></figure>
3. Acesse no programa [Configuração de Integrações (CSWMEN180)](/componentes/manuais-de-telas/configuracao-dos-componentes/configuracoes-de-integracoes.md) a [Aba Integração Belluno](/componentes/manuais-de-telas/configuracao-dos-componentes/configuracoes-de-integracoes/aba-integracao-belluno.md) para informar as URLs e o token de integração com a Belluno.

   1. Inicialmente configure as quatro URLs fixas de comunicação que a Belluno disponibiliza sendo elas:

      <https://belluno.readme.io/reference/createpaymentlink/> (criação de pagamento)\
      <https://belluno.readme.io/reference/get_transaction-transaction-id> (transação para encontrar um ID)\
      [https://api.belluno.digital/v2/transaction/%7btransaction\_id%7d/inactivate](https://api.belluno.digital/v2/transaction/%7Btransaction_id%7D/inactivate) (inativação de um link de pagamento)\
      [https://api.belluno.digital/v2/transaction/payables/paid/{date}](https://api.belluno.digital/v2/transaction/payables/paid/%7Bdate%7D) (verificação de pagamento em alguma data específica)
   2. Acione o botão **Incluir** para informar o código da empresa, o token que foi gerado no site do banco e o Host. Salve as informações.

   <figure><img src="/files/M8VwwZjjvGgD39ntSYiT" alt=""><figcaption></figcaption></figure>
4. Acesse o programa [Integração (CSINTEGRACAO010)](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/integracao.md) e localize no grid o código **IBELL** para configuração e ativação da integração. Lembrando que essa integração será apresentada após aquisição e liberação por Produto e Comercial da Consistem.

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

   1. Selecione a linha no grid e acione o botão **Editar** para executar o programa [Cadastro de Integração (CSINTEGRACAO010A)](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-integracao.md).

      <figure><img src="/files/eUeKPFtZiqXR0stsDzib" alt=""><figcaption></figcaption></figure>
   2. Na [Aba Dados Gerais](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-integracao/aba-dados-gerais.md) realize as devidas configurações informando os usuários responsáveis pela integração, o **Host** com o endereço da base oficial para qual serão feitas as requisições via API em base oficial e o **Host Homologação** com o endereço da base testes do sistema de integração para qual serão feitas as requisições via API em base de homologação.
      1. O campo **Situação** deve ser alterado para a opção *Ativo*.
      2. Informe o código de uma ou mais empresas que serão vinculadas na integração.
      3. No grid realize o preenchimento do token gerado, lá da página da Belluno, basta clicar no campo da coluna Valor e colar no local indicado.
   3. Na [Aba Endpoints](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-integracao/aba-endpoints.md) são exibidos os endpoints disponíveis para esta integração. Opções:\
      \- *GET - Obter link de pagamento por data*\
      \- *GET - Obter transação por transaction id*\
      \- *POST - Criar link de pagamento*\
      \- *POST - Inativar link de pagamento*

      <figure><img src="/files/Sj21E17aFx6lqVaifsMf" alt=""><figcaption></figcaption></figure>
   4. Não tem necessidade de passar pelas Abas [Integração Manual](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-integracao/aba-integracao-manual.md) e [Carga Dados](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-integracao/aba-carga-dados.md), pois não afetam à esta integração.
   5. Retorne para a [Aba Dados Gerais](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-integracao/aba-dados-gerais.md) e acione o botão **Salvar**.
5. Acesse no programa [Dados de Pagamento (CCCCP100)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/dados-de-pagamento-do-contas-a-receber/dados-de-pagamento.md) o botão **Novo** para executar o programa [Geração de Dados de Pagamento (CCCCP100A)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/dados-de-pagamento-do-contas-a-receber/geracao-de-dados-de-pagamento.md).

   <figure><img src="/files/0bGYxzWh90MIb5z20sUN" alt=""><figcaption></figcaption></figure>
6. Na [Aba Pedido](/financeiro/manuais-de-telas/financeiro-contas-a-receber/dados-de-pagamento-do-contas-a-receber/geracao-de-dados-de-pagamento/aba-pedido.md) informe o número do pedido ou consulte através do botão **(F7)** localizado ao lado do campo **Pedido**.
   1. Acione o botão **Incluir** para executar o programa [Geração de Dados de Pagamento - Sequência de Pagamento (CCCCP100B)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/dados-de-pagamento-do-contas-a-receber/geracao-de-dados-de-pagamento-sequencia-de-pagamento.md) permitindo a inclusão dos dados de pagamento para o pedido selecionado.

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

      1. Selecione o tipo de pagamento *Link de Pagamento - Belluno* para habilitar a [Aba Link Pagamento Belluno](/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).
         1. No campo **Forma de Pagamento** o usuário define a forma de envio ao cliente, podendo ser: *Cartão de Crédito*, *Pix* e *Pix e Cartão de Crédito*.
         2. O sistema irá exibir o valor para pagamento, mas é possível alterar caso seja necessário.
         3. Caso a opção selecionada seja *Cartão de Crédito*, serão habilitados os campos **Bandeira da Operadora** e **Número de Parcelas** (limitado a 18) para preenchimento.
         4. O campo **E-mail do Cliente** virá preenchido conforme informado no [Cadastro de Cliente (CCCDB005)](/cadastros-gerais/manuais-de-telas/clientes/cadastro-de-cliente.md), mas é possível alterar por outro e-mail em que o cliente receberá o link de pagamento.
         5. Acione os botões **Salvar** e, na sequência, **Gerar Link** para geração e envio do e-mail com o link de pagamento.

            **Importante:** caso o link de pagamento da Belluno seja gerado para o pedido, não serão permitidas alterações no pedido nos programas [Cadastro de Pedido de Venda (CCPV005)](/comercial/manuais-de-telas/comercial-carteira-de-pedidos/pedidos/cadastro-de-pedido-de-venda.md) e [Alteração de Pedidos (CCPV028)](/comercial/manuais-de-telas/comercial-carteira-de-pedidos/pedidos/alteracao-de-pedidos.md).
         6. No botão **Atualizar** é possível verificar o andamento do envio do link ao cliente e o campo **Situação Pagamento** é atualizado com a descrição *Aberto*.
            1. O cliente receberá um e-mail com o link de pagamento. Basta acessar, preencher os campos obrigatórios e efetuar o pagamento acionando o botão **Confirmar**.

               <figure><img src="/files/Swqy7bQhDGOlEaoYfLug" alt=""><figcaption></figcaption></figure>
         7. Ainda [nesta aba](/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), é possível acionar os botões **Consultar Link** e na sequência **Atualizar** para analisar se o pagamento já foi realizado. Em caso positivo, será atualizado o campo **Situação Pagamento** para *Pago*. As opções exibidas podem ser *Aberto*, *Pago*, *Cancelado* ou *Em Processamento*.

            <figure><img src="/files/nsd2FogqAoKoWa3BeJsm" alt=""><figcaption></figcaption></figure>
7. Para análise do log da integração, caso ocorra alguma inconsistência no pagamento, acesse o programa [Consulta Logs de Integração (CSINTEGRACAO100)](/componentes/manuais-de-telas/consulta-de-componentes/consulta-logs-de-integracao.md), informe o período, selecione a *Integração API IBELL*, os endpoints, no campo **Sucesso** selecione *Ambos* e acione o botão **Consultar**.
   1. Serão exibidos os dados filtrados no grid da tela.

      <figure><img src="/files/DByzEGu2YGzmUrKl7GUL" alt=""><figcaption></figcaption></figure>
8. Para realizar o faturamento, acesse o programa [Seleção de Pedido para Faturamento (CCPV030)](/comercial/manuais-de-telas/comercial-carteira-de-pedidos/selecao-para-faturamento/selecao-de-pedido-para-faturamento-v75.md) e informe o número do pedido no campo **Pedido**. Após o preenchimento dos dados e repasse pelas rotinas auxiliares, será apresentado o programa [Geração de Dados de Pagamento (CCCCP100A)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/dados-de-pagamento-do-contas-a-receber/geracao-de-dados-de-pagamento.md) para análise do status do pagamento, acione o botão **Confirmar** para que o faturamento seja realizado.

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

   1. Caso não esteja pago, **não será permitido** dar andamento no faturamento.
9. Após finalizar o faturamento, acesse o programa [Geração e Emissão de Nota Fiscal (CCFT010)](/comercial/manuais-de-telas/comercial-faturamento/faturamento/geracao-e-emissao-de-nota-fiscal.md), informe os filtros do pedido e acione o botão **Lista Esta** para gerar a nota fiscal.

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

   1. Caso o pedido seja pago via Pix com a Belluno, a baixa do título ocorrerá de forma automática no momento da geração da nota.
   2. Caso o pedido tenha sido pago via Cartão de Crédito com a Belluno, o sistema irá realizar a baixa parcial referente a taxa de cartão, desde que a mesma esteja cadastrada para a bandeira no programa [Cadastro de Operadora de Cartão de Crédito (CCCCP005)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/configuracao-de-pagamento-do-contas-a-receber/cadastro-de-operadora-de-cartao-de-credito.md).
10. É possível consultar as notas já geradas através do programa [Consulta de Notas Fiscais por Período (CCFT725)](/comercial/manuais-de-telas/comercial-faturamento/faturamento/consulta-de-notas-fiscais-por-periodo.md), informando o período e acionando o botão **Consultar**.

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

    1. No grid selecione a linha desejada e clique em **Detalha** para executar a [Consulta de Nota Fiscal Detalhada (CCFT605)](/comercial/manuais-de-telas/comercial-faturamento/faturamento/consulta-de-nota-fiscal-detalhada.md).

       <figure><img src="/files/5i9ACH2FePufjfq9pdba" alt=""><figcaption></figcaption></figure>

       1. Acione o botão **Títulos** para executar a [Consulta de Títulos por Nota Fiscal (CCCC745)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/titulos-do-contas-a-receber/consulta-de-titulos-por-nota-fiscal.md).
          1. No grid é possível verificar o número do título, as baixas, e demais detalhamentos.
             1. Caso no final do número do título conste a letra **U** significa que a baixa foi feita unicamente, ou seja, via Pix.<br>

                <figure><img src="/files/meaE0cHgwq8WYHoL0kGI" alt=""><figcaption></figcaption></figure>
             2. Caso na frente do número do título conste a letra **A** significa que a baixa foi feita parcialmente, ou seja, via Cartão de Crédito.

                <figure><img src="/files/k0smHzQoSrvsvw0NruAC" alt=""><figcaption></figcaption></figure>
11. No programa [Consulta de Títulos por API (Belluno) (CCCCP600)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/dados-de-pagamento-do-contas-a-receber/consulta-de-titulos-por-api-belluno.md) é possível consultar a situação atual dos links de pagamentos gerados, seja via Pix ou Cartão de Crédito.

    <figure><img src="/files/1nbOQ439FX1hkLx6KaZS" alt=""><figcaption></figcaption></figure>

    1. Para os casos de pagamento via Cartão de Crédito, deverá ser acionado o botão **Atualizar Cartão** para que seja identificado na conta da Belluno se o mesmo já foi pago pela bandeira do cartão. Caso tenha sido realizado, o sistema efetua a baixa total da parcela.

## Fluxo do Processo

1. **Configuração Inicial:** A empresa abre a conta por CNPJ no banco Belluno e recebe o token de integração. Esse token é inserido no Consistem ERP para ativar a comunicação.
2. **Origem dos Dados:** Ocorre o cadastro do pedido de venda no Consistem ERP (programa [Cadastro de Pedido de Venda (CCPV005)](/comercial/manuais-de-telas/comercial-carteira-de-pedidos/pedidos/cadastro-de-pedido-de-venda.md)).
3. **Geração do Link:** Com a integração ativa via token, os dados de pagamento são gerados no programa [Dados de Pagamento (CCCCP100)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/dados-de-pagamento-do-contas-a-receber/dados-de-pagamento.md). O sistema dispara a requisição para a API da Belluno, gerando e enviando o link por e-mail ao cliente.
4. **Ação do Cliente:** O cliente acessa o link, preenche os dados e efetua o pagamento na página da Belluno.
5. **Resultado Final e Baixa:** O Consistem ERP valida o recebimento e o faturamento é liberado.
   1. Se o pagamento foi via Pix, a baixa do título no financeiro ocorre de forma automática no momento da geração da nota.
   2. Se o pagamento foi via Cartão de Crédito, o sistema realiza uma baixa parcial referente às taxas. Para consultar a situação atual dos links e efetivar a baixa total da parcela, é possível acessar o programa [Consulta de Títulos por API (Belluno) (CCCCP600)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/dados-de-pagamento-do-contas-a-receber/consulta-de-titulos-por-api-belluno.md) e acionar o botão **Atualizar Cartão**.

<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, and the optional `goal` query parameter:

```
GET https://ajuda.consistem.com.br/consistem-integracoes/areas-de-negocio/financeiro/belluno.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.