> 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/banco-do-brasil-adiantamento-pedidos-via-pix.md).

# Banco do Brasil (Adiantamento Pedidos via Pix)

#### Visão geral <a href="#almodesistemadepdv-visaogeral" id="almodesistemadepdv-visaogeral"></a>

Esta integração viabiliza a geração do link de pagamento via Pix Copia e Cola ou QR Code no Banco do Brasil para adiantamento de pedidos de venda. Essa automação acelera a confirmação do pagamento pelo cliente, agiliza a liberação da produção ou o envio de mercadorias e melhora o fluxo de caixa organizacional ao mitigar processos manuais de conciliação.

#### Requisitos

<table><thead><tr><th width="474">Consistem ERP</th><th>Banco do Brasil ou Portal Developers</th></tr></thead><tbody><tr><td><p><strong>Compatibilidade:</strong> 7.5 ou superiores do Consistem ERP.</p><p><strong>Módulos:</strong> Comercial e Financeiro devidamente implantados.</p><p><strong>Licença:</strong> <a href="https://movidesk.consistem.com.br/form/5801/">Aquisição de licença</a> <strong>PIXADT</strong> ativa junto à Consistem.<br></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://apoio.developers.bb.com.br/">Saiba mais</a></td></tr><tr><td><strong>Pedido de Venda:</strong> Cadastrado previamente no <a href="/spaces/migA2ohuxrj84wih1tu1/pages/y65e6M8OVw4CODf3U5tM">Cadastro de Pedido de Venda (CCPV005)</a>.</td><td><strong>Conta Corrente:</strong> Conta jurídica ativa e vinculada ao CNPJ da empresa no Banco do Brasil.</td></tr><tr><td><strong>Configuração de E-mail:</strong> Campo <strong>Endereço de Remetente</strong> preenchido na <a href="/spaces/0E9n0hpwK2TzblZSHb8i/pages/Y2dYE5ZKdxM0Ign0nFBj">Aba E-mail</a>.</td><td><strong>Acesso ao Portal:</strong> Cadastro e login no <a href="https://acesso.bb.com.br/v2/login">Portal Developers</a> realizados inicialmente por CPF para homologação, devendo ser feito por CNPJ em produção.</td></tr><tr><td><strong>Portador Bancário:</strong> Cadastrado o <em>Banco do Brasil</em> no <a href="/spaces/JAFv73zIUkocB6ArsYjv/pages/SfhnTXkjUOFBpQGkRuJV">Cadastro de Portador (CCAPL025)</a>.</td><td><strong>Homologação:</strong> Geração de credenciais (<em>Client ID</em>, <em>Client Secret</em> e <em>Developer Application Key</em>) de testes/produção e retirada de pendências no portal.</td></tr><tr><td><strong>Dados Cadastrais do Cliente:</strong> CEP válido no <a href="/spaces/JAFv73zIUkocB6ArsYjv/pages/l7KstfLMJhWlRTzCuZlM">Cadastro de Cliente (CCCDB005)</a> e número de telefone cadastrado nas <a href="/spaces/JAFv73zIUkocB6ArsYjv/pages/cl0aDk8uG06IT4mlQf21">Informações Complementares (CCCDB006)</a>.</td><td><strong>Chave Pix:</strong> Cadastro prévio da chave Pix diretamente na conta jurídica do Banco do Brasil.</td></tr><tr><td><strong>Dados de Cobrança:</strong> Cadastro de e-mail atualizado para o envio do link e QR Code nos <a href="/spaces/JAFv73zIUkocB6ArsYjv/pages/dbTgjXBTwkD6DgFI05rb">Dados de Cobrança (CCCDB015)</a>.</td><td></td></tr></tbody></table>

#### Configuração da integração

**No Banco do Brasil**

1. Acesse o site do [Portal Developers do Banco do Brasil](https://acesso.bb.com.br/v2/login), preencha o CPF e faça o login.
2. Crie uma nova aplicação dedicada ao escopo de transações Pix.
3. Entre na seção Credenciais e copie integralmente o *Client ID*, *Client Secret* e a *Developer Application Key* para utilizá-los na tela de cadastro do ERP.

**No Consistem ERP**

1. Acesse o programa [Integração (CSINTEGRACAO010)](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/integracao.md), localize o código **PIXADT** no grid e clique em **Editar**.<br>

   <figure><img src="/files/5bhHNjuSAcyivRCidovs" alt=""><figcaption></figcaption></figure>
2. Na [Aba Dados Gerais](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-integracao/aba-dados-gerais.md), mude a situação para *Ativo*, defina os usuários responsáveis e configure os campos **Host** e **Host Homologação** com as URLs de comunicação oficiais fornecidas pela instituição bancária.

   <figure><img src="/files/VZWFN3uwtBihoatsFwQ2" alt=""><figcaption></figcaption></figure>
3. Associe as empresas corporativas que utilizarão o recurso. No grid inferior da tela, preencha a coluna **Valor** de cada linha de parâmetro inserindo as chaves copiadas do portal do banco (*Client ID*, *Client Secret* e a *Developer Application Key*).<br>

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>O <em>Certificado</em> presente no grid pode ser desconsiderado para essa integração específica.</p></div>
4. Na [Aba Endpoints](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/cadastro-de-integracao/aba-endpoints.md), certifique-se de que os métodos **GET** (Consultar Cobrança Pix), **PATCH** (Cancelar Cobrança Pix) e **POST** (Criar Cobrança Pix) estão parametrizados e ativos. Salve as alterações.<br>

   <figure><img src="/files/PGrQZaHtqejAaNFv2UDG" alt=""><figcaption></figcaption></figure>
5. Acesse o programa [Configuração de Dados de Pagamento (CCCCP000)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/configuracao-de-pagamento-do-contas-a-receber/configuracao-de-dados-de-pagamento.md) e clique no botão **Operação Pix** para executar a [Configuração de Dados de Pagamento - Operações PIX (CCCCP002)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/configuracao-de-pagamento-do-contas-a-receber/configuracao-de-dados-de-pagamento-operacoes-pix.md).

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

   1. Vincule o portador Banco do Brasil, selecione quais usuários internos do ERP devem receber alertas sistêmicos e insira a **Chave Pix** corporativa cadastrada no banco. Salve os registros em ambas as telas.
6. Acesse o programa [Agendamento de Tarefas (CSTASK015)](/componentes/manuais-de-telas/agendamento-de-tarefas-e-processo-em-segundo-plano/agendamento-de-tarefas.md) para configurar a verificação automática de quitação. Clique em **Novo** para abrir o [Cadastro de Agendamento de Tarefas (CSTASK010)](/componentes/manuais-de-telas/agendamento-de-tarefas-e-processo-em-segundo-plano/cadastro-de-agendamento-de-tarefas.md).
   1. Na [aba Dados Gerais](/componentes/manuais-de-telas/agendamento-de-tarefas-e-processo-em-segundo-plano/cadastro-de-agendamento-de-tarefas/aba-dados-gerais.md), defina a frequência do agendamento.<br>

      <figure><img src="/files/MLBTKgcVH2dK0jIAkzbe" alt=""><figcaption></figcaption></figure>
   2. Na [aba Parâmetros Padrões](/componentes/manuais-de-telas/agendamento-de-tarefas-e-processo-em-segundo-plano/cadastro-de-agendamento-de-tarefas/aba-parametros-padroes.md), selecione o módulo *Financeiro - Contas a Receber* e a tarefa *Atualizar Dados de Pagamento de Pedidos via Pix*, vinculando as empresas participantes. Salve os dados.

### Como a integração funciona

A comunicação técnica entre o Consistem ERP e as instituições bancárias baseia-se na arquitetura de APIs RESTful, enviando e recebendo dados através de payloads estruturados e criptografados de ponta a ponta. O tráfego de informações ocorre por rotinas automáticas de requisição baseadas em três ações centrais do protocolo HTTP:

* **Envio/Geração (POST):** O ERP envia as informações do adiantamento (valor, vencimento e dados do cliente) e envia para o endpoint do Banco do Brasil. O banco valida as credenciais (*Client ID*, *Client Secret* e *Developer Application Key*), registra a intenção e devolve em tempo real a linha digitável Pix Copia e Cola e a imagem do QR Code correspondente.
* **Consulta/Status (GET):** O programa [Agendamento de Tarefas (CSTASK015)](/componentes/manuais-de-telas/agendamento-de-tarefas-e-processo-em-segundo-plano/agendamento-de-tarefas.md) executa em segundo plano a tarefa *Atualizar Dados de Pagamento de Pedidos via Pix*. Ela realiza chamadas cíclicas para monitorar o banco; assim que a liquidação é identificada, o status muda para *Pago* e o ERP gera um crédito a identificar exclusivo para aquele pedido.
* **Cancelamento (PATCH):** Se o pedido for alterado ou cancelado antes do pagamento, o ERP envia uma instrução que invalida e anula permanentemente a cobrança direto na instituição bancária.

{% hint style="info" %}
**Conciliação Interna**\
Com a confirmação do pagamento, o ERP provisiona o crédito. No momento do faturamento e emissão da nota fiscal, o sistema reconhece esse valor e realiza a conciliação e a baixa contábil de forma automática, eliminando a intervenção humana na tesouraria.
{% endhint %}

### Fluxo do processo

1. **Abertura do Pedido:** O fluxo se inicia com o registro normal do pedido de venda através do programa [Cadastro de Pedido de Venda (CCPV005)](/comercial/manuais-de-telas/comercial-carteira-de-pedidos/pedidos/cadastro-de-pedido-de-venda.md).
2. **Requisição de Pagamento:** Para emitir a cobrança, acesse 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) e, 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. Clique em **Incluir** para executar a tela [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).
3. **Seleção da Forma de Pagamento:** O usuário escolhe o tipo de pagamento *Pix*, o que habilita a [Aba Pix](/financeiro/manuais-de-telas/financeiro-contas-a-receber/dados-de-pagamento-do-contas-a-receber/geracao-de-dados-de-pagamento-sequencia-de-pagamento/aba-pix.md) (desde que as configurações no programa [Configuração de Dados de Pagamento - Operações PIX (CCCCP002)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/configuracao-de-pagamento-do-contas-a-receber/configuracao-de-dados-de-pagamento-operacoes-pix.md) estejam válidas). Define o Banco do Brasil como portador, valida o valor do adiantamento e confirma o e-mail cadastrado.
4. **Emissão e Envio do Link:** Acione os botões **Salvar** e, logo em seguida, **Gerar PIX**. O ERP comunica-se com a API do Banco do Brasil, gerando o link *Pix Copia e Cola* e o respectivo *QR Code* com prazo de validade de 24 horas. O cliente receberá automaticamente um e-mail estruturado.
5. **Bloqueio de Segurança:** Assim que o link do Pix é gerado com sucesso, o Consistem ERP bloqueia sumariamente qualquer alteração ou edição nos itens, valores ou cadastros do pedido através dos 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) para evitar divergências com o título bancário em aberto.
6. **Conciliação Automatizada:** O cliente efetua o pagamento na instituição bancária. O monitoramento do status de pagamento é executado em segundo plano pelo [Agendamento de Tarefas (CSTASK015)](/componentes/manuais-de-telas/agendamento-de-tarefas-e-processo-em-segundo-plano/agendamento-de-tarefas.md). Esta tela programada faz consultas periódicas ao Banco do Brasil e, detectando o recebimento, altera o status do adiantamento para *Pago* e notifica os usuários cadastrados.
   1. Caso o operador queira antecipar a checagem na hora, basta clicar no botão **Consultar Pix**.
7. **Liberação Comercial:** Para emitir a nota fiscal, o usuário acessa diretamente 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 informa o número do pedido. O sistema apresentará a tela [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 checar a quitação:
   1. Se o status for *Pago*, o operador clica em **Confirmar** e o pedido é liberado para faturamento.
   2. Se o pagamento tiver sido parcial, o faturamento é retido. O operador deve clicar em **Incluir** para chamar a tela [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) e definir como será pago o saldo restante (gerando outra sequência para Boleto ou Carteira, por exemplo).
8. **Emissão da Nota Fiscal e Baixa Automática:** Com o pedido liberado, processe a emissão do documento no programa [Geração e Emissão de Nota Fiscal (CCFT010)](/comercial/manuais-de-telas/comercial-faturamento/faturamento/geracao-e-emissao-de-nota-fiscal.md), preenchendo os filtros do pedido e acionando o botão **Lista Esta**. Ao concluir a gravação da nota, o sistema realiza a baixa do título financeiro no Contas a Receber de forma 100% automática, utilizando os parâmetros de baixa em dinheiro definidos previamente na tela [Configuração de Dados de Pagamento (CCCCP000)](/financeiro/manuais-de-telas/financeiro-contas-a-receber/configuracao-de-pagamento-do-contas-a-receber/configuracao-de-dados-de-pagamento.md).

{% hint style="info" %}
**Auditoria e Resolução de Problemas**

* **Análise de Inconsistências (Logs):** Para auditar falhas de comunicação ou pagamento, acesse o programa [Consulta Logs de Integração (CSINTEGRACAO100)](/componentes/manuais-de-telas/consulta-de-componentes/consulta-logs-de-integracao.md). Filtre pelo período, selecione a *Integração API PIXADT* e os *endpoints*, marque *Ambos* no campo **Sucesso** e clique em **Consultar** para exibir os detalhes da transmissão no grid.
* **Auditoria de Títulos:** Para checar a forma como as baixas ocorreram, o setor financeiro pode utilizar o programa [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). Se o número do título apresentar a letra "U" ao final (ex: 123456U), indica que a baixa financeira ocorreu de forma única e integral via Pix. Letras como "A" ou "B" no final indicam liquidações parciais ou desmembramentos.
* **Estorno de Valores:** O acionamento do botão **Estornar Pagamento** realiza o cancelamento e estorno do adiantamento apenas no escopo de dados do Consistem ERP. A devolução real do dinheiro (Pix reverso) ou a geração de créditos comerciais futuros devem ser tratadas e executadas manualmente pelos operadores diretamente nos canais bancários do Banco do Brasil, conforme acordado com o cliente.
  {% 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, and the optional `goal` query parameter:

```
GET https://ajuda.consistem.com.br/consistem-integracoes/areas-de-negocio/financeiro/banco-do-brasil-adiantamento-pedidos-via-pix.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.