> 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

Integração | Financeiro

### Visão Geral

A Belluno é uma plataforma WEB que oferece Antecipação de Recebíveis e Meios de Pagamento para empresas de qualquer porte.

O objetivo principal desta integração é facilitar o envio de links de pagamento gerados a partir do Consistem ERP diretamente ao cliente. Com isso, busca-se otimizar e agilizar os processos vinculados aos pedidos de venda, permitindo que as rotinas de conciliação e baixas financeiras sejam integradas e automatizadas.

A integração permite negociar a forma de pagamento (Cartão de Crédito ou Pix) no momento do pedido de venda, garantindo que o faturamento ocorra apenas após a confirmação do 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.6 ou superiores do Consistem ERP.</p><p><strong>Módulos:</strong> Comercial e Financeiro ativos.</p><p><strong>Licença:</strong> <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="https://ajuda.consistem.com.br/modulos/comercial/manuais-de-telas/comercial-carteira-de-pedidos/pedidos/cadastro-de-pedido-de-venda.md">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="https://ajuda.consistem.com.br/modulos/componentes/manuais-de-telas/configuracao-dos-componentes/configuracao-geral-do-sistema/aba-e-mail.md">Aba E-mail</a> do programa <a href="https://ajuda.consistem.com.br/modulos/componentes/manuais-de-telas/configuracao-dos-componentes/configuracao-geral-do-sistema.md">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="https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-contas-a-receber/configuracao-de-pagamento-do-contas-a-receber/cadastro-de-operadora-de-cartao-de-credito.md">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="https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-contas-a-receber/configuracao-de-pagamento-do-contas-a-receber/cadastro-de-operadora-de-cartao-de-credito-taxas-administrativas.md">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="https://ajuda.consistem.com.br/modulos/cadastros-gerais/manuais-de-telas/clientes/cadastro-de-cliente.md">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="https://ajuda.consistem.com.br/modulos/cadastros-gerais/manuais-de-telas/clientes/informacoes-complementares.md">Informações Complementares (CCCDB006)</a> para confirmar se o <strong>Celular</strong> está cadastrado.</td><td></td></tr></tbody></table>

### Configuração da Integração

#### Na integração Belluno:

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="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2Fgit-blob-6639cfb9f4256fb7cb95f898c6530c007c4a0bb4%2Fimage%20(47).png?alt=media" 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="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2Fgit-blob-3184122e1cc2ba7749b79883b468e2b604a87056%2Fimage%20(48).png?alt=media" alt=""><figcaption></figcaption></figure>

#### No Consistem ERP:

1. Acesse no programa [Configuração de Integrações (CSWMEN180)](https://ajuda.consistem.com.br/modulos/componentes/manuais-de-telas/configuracao-dos-componentes/configuracoes-de-integracoes.md) a [Aba Integração Belluno](https://ajuda.consistem.com.br/modulos/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="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2Fgit-blob-fbc3b8adbec28c2d7ca41700a4f1bb49ed5208f0%2Fimage%20(49).png?alt=media" alt=""><figcaption></figcaption></figure>
2. Acesse o programa [Integração (CSINTEGRACAO010)](https://ajuda.consistem.com.br/modulos/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="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2Fgit-blob-a09b47936cb5f6f88401aef3d48c209ff26b90bb%2Fimage%20(50).png?alt=media" 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)](https://ajuda.consistem.com.br/modulos/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-integracao.md).

      <figure><img src="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2Fgit-blob-66e3e1509bb6e421814cc5a7675a85237cdeeabb%2Fimage%20(53).png?alt=media" alt=""><figcaption></figcaption></figure>
   2. Na [Aba Dados Gerais](https://ajuda.consistem.com.br/modulos/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](https://ajuda.consistem.com.br/modulos/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="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2Fgit-blob-e8c41267ae19c8f7e2eec6d41d201691bea3d6df%2Fimage%20(54).png?alt=media" alt=""><figcaption></figcaption></figure>
   4. Não tem necessidade de passar pelas Abas [Integração Manual](https://ajuda.consistem.com.br/modulos/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-integracao/aba-integracao-manual.md) e [Carga Dados](https://ajuda.consistem.com.br/modulos/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](https://ajuda.consistem.com.br/modulos/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-integracao/aba-dados-gerais.md) e acione o botão **Salvar**.
3. Acesse no programa [Dados de Pagamento (CCCCP100)](https://ajuda.consistem.com.br/modulos/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)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-contas-a-receber/dados-de-pagamento-do-contas-a-receber/geracao-de-dados-de-pagamento.md).

   <figure><img src="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2Fgit-blob-394bc218ad687a1a949ef20a27139a74baabf5c1%2Fimage%20(55).png?alt=media" alt=""><figcaption></figcaption></figure>
4. Na [Aba Pedido](https://ajuda.consistem.com.br/modulos/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)](https://ajuda.consistem.com.br/modulos/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="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2Fgit-blob-097ead8c168fb2aee290527d16666921b95c48df%2Fimage%20(57).png?alt=media" alt=""><figcaption></figcaption></figure>

      1. Selecione o tipo de pagamento *Link de Pagamento - Belluno* para habilitar a [Aba Link Pagamento Belluno](https://ajuda.consistem.com.br/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).
         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)](https://ajuda.consistem.com.br/modulos/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)](https://ajuda.consistem.com.br/modulos/comercial/manuais-de-telas/comercial-carteira-de-pedidos/pedidos/cadastro-de-pedido-de-venda.md) e [Alteração de Pedidos (CCPV028)](https://ajuda.consistem.com.br/modulos/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="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2Fgit-blob-60bd09626fc0ef5d1b2ccd5f1f42ed4d907a35d2%2Fimage%20(58).png?alt=media" alt=""><figcaption></figcaption></figure>
         7. Ainda [nesta aba](https://ajuda.consistem.com.br/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), é 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="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2Fgit-blob-fee8b38869daf4118ed179629025b3554d20ac66%2Fimage%20(60).png?alt=media" alt=""><figcaption></figcaption></figure>
5. Para análise do log da integração, caso ocorra alguma inconsistência no pagamento, acesse o programa [Consulta Logs de Integração (CSINTEGRACAO100)](https://ajuda.consistem.com.br/modulos/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="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2Fgit-blob-33b66d3212136f150b025808f873ce3372b7698a%2Fimage%20(59).png?alt=media" alt=""><figcaption></figcaption></figure>
6. Para realizar o faturamento, acesse o programa [Seleção de Pedido para Faturamento (CCPV030)](https://ajuda.consistem.com.br/modulos/comercial/manuais-de-telas/comercial-carteira-de-pedidos/selecao-para-faturamento/selecao-de-pedido-para-faturamento-v.7.5.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)](https://ajuda.consistem.com.br/modulos/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="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2Fgit-blob-87c74e14d7c2ec866e92368d6a038035931b4f74%2Fimage%20(61).png?alt=media" alt=""><figcaption></figcaption></figure>

   1. Caso não esteja pago, **não será permitido** dar andamento no faturamento.
7. Após finalizar o faturamento, acesse o programa [Geração e Emissão de Nota Fiscal (CCFT010)](https://ajuda.consistem.com.br/modulos/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="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2Fgit-blob-e380121151211ef253224da1006ee1f1f9a7c3e7%2Fimage%20(21).png?alt=media" 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)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-contas-a-receber/configuracao-de-pagamento-do-contas-a-receber/cadastro-de-operadora-de-cartao-de-credito.md).
8. É possível consultar as notas já geradas através do programa [Consulta de Notas Fiscais por Período (CCFT725)](https://ajuda.consistem.com.br/modulos/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="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2Fgit-blob-695a458fa7d5dfec37eeaa5e16fba22b8d5e7862%2Fimage%20(22).png?alt=media" alt=""><figcaption></figcaption></figure>

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

      <figure><img src="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2Fgit-blob-ea60946de1a71b10b9812b17d5a233fd0aa7e1fa%2Fimage%20(23).png?alt=media" alt=""><figcaption></figcaption></figure>

      1. Acione o botão **Títulos** para executar a [Consulta de Títulos por Nota Fiscal (CCCC745)](https://ajuda.consistem.com.br/modulos/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="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2Fgit-blob-b15b034b09d643b835a0f33fb3cc9272c0bea5c6%2Fimage%20(28).png?alt=media" 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="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2Fgit-blob-fb26c4f6254fb2676d51c6a21a51364023b59393%2Fimage%20(27).png?alt=media" alt=""><figcaption></figcaption></figure>
9. No programa [Consulta de Títulos por API (Belluno) (CCCCP600)](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) é possível consultar a situação atual dos links de pagamentos gerados, seja via Pix ou Cartão de Crédito.

   <figure><img src="https://3798442413-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhlUlmj2KD330s7T7Q6vh%2Fuploads%2Fgit-blob-2514301ecbd3d63deecc89feb7bc2ed7e22585f2%2Fimage%20(25).png?alt=media" 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.

### Como a Integração Funciona

A comunicação entre o Consistem ERP e a Belluno ocorre via API Restful utilizando chamadas HTTP em formato JSON.

**Endpoints da API utilizados:**

* POST - Criar link de pagamento (*/v2/transaction/create*): Envia os dados do pedido (valor, itens, e-mail do cliente, forma de pagamento, parcelas) para que a Belluno gere o link de pagamento.
* POST - Inativar link de pagamento (*/v2/transaction/{transaction\_id}/inactivate*): Inativa um link previamente gerado caso o pedido seja alterado ou cancelado.
* GET - Obter transação por Transaction ID (*/v2/transaction/{transaction\_id}*): Consulta o status individual de uma transação específica.
* GET - Obter link de pagamento por data (*/v2/transaction/payables/paid/{date}*): Realiza a varredura e conciliação dos pagamentos confirmados em uma determinada data.

### Fluxo do Processo

O fluxo de trabalho da integração abrange desde o cadastro do pedido até a conciliação e baixa no financeiro, utilizando o leiaute padrão da Consistem:

1. **Configuração Inicial:** A conta digital da empresa é aberta no banco Belluno para geração do Token da API. Esse Token é configurado nos leiautes e programas de integração do Consistem ERP.
2. **Origem dos Dados (Pedido de Venda):** O pedido é cadastrado no Consistem ERP pelo programa [Cadastro de Pedido de Venda (CCPV005)](https://ajuda.consistem.com.br/modulos/comercial/manuais-de-telas/comercial-carteira-de-pedidos/pedidos/cadastro-de-pedido-de-venda.md).
3. **Geração e Envio do Link:**
   1. No programa [Dados de Pagamento (CCCCP100)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-contas-a-receber/dados-de-pagamento-do-contas-a-receber/dados-de-pagamento.md), insira o número do pedido.
   2. Em [Geração de Dados de Pagamento - Sequência de Pagamento (CCCCP100B)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-contas-a-receber/dados-de-pagamento-do-contas-a-receber/geracao-de-dados-de-pagamento-sequencia-de-pagamento.md), selecione a opção *Link de Pagamento - Belluno*.
   3. Defina a Forma de Pagamento (*Cartão de Crédito*, *Pix* ou *Pix e Cartão de Crédito*), valor, parcelas e e-mail do cliente.
   4. Ao clicar em **Salvar** e **Gerar Link**, o ERP envia as informações via requisição API no leiaute da Consistem. A Belluno gera o link e o dispara por e-mail para o cliente.\
      **Importante:** Após a geração do link, o ERP bloqueia edições no pedido através dos programas [Cadastro de Pedido de Venda (CCPV005)](https://ajuda.consistem.com.br/modulos/comercial/manuais-de-telas/comercial-carteira-de-pedidos/pedidos/cadastro-de-pedido-de-venda.md) e [Alteração de Pedidos (CCPV028)](https://ajuda.consistem.com.br/modulos/comercial/manuais-de-telas/comercial-carteira-de-pedidos/pedidos/alteracao-de-pedidos.md).
4. **Pagamento pelo Cliente:** O cliente acessa o e-mail, abre o link seguro da Belluno e realiza o pagamento via QR Code Pix ou inserindo os dados do Cartão de Crédito.
5. **Consulta de Status:** No ERP, através dos botões **Consultar Link** e **Atualizar**, a situação da transação é atualizada no sistema (alternando entre *Aberto*, *Em Processamento*, *Pago* ou *Cancelado*).
6. **Faturamento:**
   1. Na [Seleção de Pedido para Faturamento (CCPV030)](https://ajuda.consistem.com.br/modulos/comercial/manuais-de-telas/comercial-carteira-de-pedidos/selecao-para-faturamento/selecao-de-pedido-para-faturamento-v.7.5.md), o ERP valida o status. Caso o pedido esteja com status *Pago*, a liberação é efetuada. Caso contrário, o faturamento é bloqueado.
   2. A emissão ocorre via [Geração e Emissão de Nota Fiscal (CCFT010)](https://ajuda.consistem.com.br/modulos/comercial/manuais-de-telas/comercial-faturamento/faturamento/geracao-e-emissao-de-nota-fiscal.md).
7. **Resultado Final e Baixas Financeiras:**
   1. **Pagamentos via Pix:** Ao gerar a nota fiscal no programa [Geração e Emissão de Nota Fiscal (CCFT010)](https://ajuda.consistem.com.br/modulos/comercial/manuais-de-telas/comercial-faturamento/faturamento/geracao-e-emissao-de-nota-fiscal.md), a baixa do título no financeiro ocorre de forma automática. O título faturado receberá o sufixo `U` (baixa única).
   2. **Pagamentos via Cartão de Crédito:** Na emissão da nota, o sistema realiza uma baixa parcial correspondente à taxa da operadora de cartão (desde que cadastrada no [Cadastro de Operadora de Cartão de Crédito (CCCCP005)](https://ajuda.consistem.com.br/modulos/financeiro/manuais-de-telas/financeiro-contas-a-receber/configuracao-de-pagamento-do-contas-a-receber/cadastro-de-operadora-de-cartao-de-credito.md)). O título receberá o prefixo/sufixo `A`.
   3. **Baixa Total do Cartão:** A conciliação e liquidação total do cartão de crédito é finalizada através do programa [Consulta de Títulos por API (Belluno) (CCCCP600)](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) ao 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
