CNAB Febraban 240 posições

Pagamentos

Versão suportada: 10.9 (link)

Segmentos suportados

Atualmente, dentre os segmentos existentes na especificação, nosso sistema oferece suporte conforme disposto na tabela a seguir:

1. Operações via DOC hoje não são mais suportadas.

Formas de Lançamento Suportadas

Antecipação de Pagamentos a Fornecedores

Para mais detalhes, veja: Antecipação de Pagamentos a Fornecedores

A partir da liberação da funcionalidade, as operações que fizerem uso da funcionalidade terão os dados retornados em seus arquivos de retorno de acordo com o resultado de cada operação, conforme os cenários dispostos abaixo:

Cenário 1: Sucesso na Antecipação

Será retornado o pagamento (segmento A e B) com o campo "Tipo de Movimento" preenchido com o valor 0, o campo "Código da Instrução para movimento" com o valor 00 e um código de ocorrência "ZK". Esses pagamentos não terão nenhuma outra atualização em novos arquivos de retorno.

Cenário 2: Falha na Antecipação

Serão retornadas três operações (três pares de Segmento A e B) no arquivo de retorno, indicando que o pagamento foi antecipado, a antecipação falhou e o pagamento voltou para o status Agendado. A ordem das operações é a seguinte:

Particularidades

Segmento J52-PIX

Para configuração do Segmento J52-PIX, utilizamos os campos e posições abaixo:

1. Campos TXID e Chave de Pagamento

Para efetuar o pagamento de um PIX via QR-Code, é essencial preencher corretamente os campos Chave de Pagamento e TXID. A Chave de Pagamento pode ser uma chave de endereçamento ou uma URL, dependendo se o QR-Code é dinâmico ou estático. O campo TXID, que identifica a transação, pode ser opcionalmente incluído no arquivo CNAB.

Esses dois campos devem vir preenchidos no layout da esquerda para direita, e as colunas restantes devem ser preenchidas com espaços em brancos (“ “). Porém, para conseguir obter esses valores, é necessário realizar a extração utilizando do PIX copia-e-cola (conteúdo do QR-Code).

• PIX Dinâmico

PIX Dinâmico é um tipo de PIX usado apenas 1 vez para cada transação, não sendo possível ser reutilizado como no caso do PIX Estático. Normalmente utilizado em boletos ou transações direto no PDVs.

Exemplo de QR-Code dinâmico

00020101021226700014br.gov.bcb.pix2548pix.example.com/8b3da2f39a4140d1a91abd93113bd44115204000053039865802BR5913Fulano de Tal6008BRASILIA62070503***630464E4

• Chave de Endereçamento e URL

O código conteúdo segue um padrão específico de formatação que facilita a extração de informações, a ser utilizado tanto para PIX Dinâmico como PIX estático. Considerer os passos abaixo, através do exemplo acima:

1. Encontrar início do campo da URL/Chave de endereçamento, localizado após a sequência de caracteres BR.GOV.BCB.PIX
2. Extrair valor do campo, identificando qual o tamanho da URL/Chave de endereçamento com o valor descrito na coluna 3 e 4 da sequência de caracteres
3. Obter valor desejado, extraindo o conteúdo presente no intervalo obtido, começando do quinto caractere, contando a quantidade de caracteres informada no passo anterior
4. Resultado: pix.example.com/8b3da2f39a4140d1a91abd93113bd441

• PIX Estático

PIX Estático é um tipo de PIX que pode ser reutilizado em várias transações, podendo ter um valor pré-determinado ou não.

Exemplo de QR-Code estático

00020126580014br.gov.bcb.pix0136123e4567-e12b-12d1-a456-4266554400005204000053039865802BR5913Fulano de Tal6008BRASILIA62070503***63041D3D

• Chave de Endereçamento e URL

Assim como no PIX Dinâmico, existem regras para obtenção dos dados também no PIX estático, conforme disposto a seguir.

1. Encontrar início do campo da URL/Chave de endereçamento, localizado após a sequência de caracteres BR.GOV.BCB.PIX
2. Extrair valor do campo, identificando qual o tamanho da URL/Chave de endereçamento com o valor descrito na coluna 3 e 4 da sequência de caracteres
3. Obter valor desejado, extraindo o conteúdo presente no intervalo obtido, começando do quinto caractere, contando a quantidade de caracteres informada no passo anterior
4. Resultado: 123e4567-e12b-12d1-a456-426655440000

Cobranças

Versão suportada: 10.9

Segmentos suportados

Atualmente, dentre os segmentos existentes na especificação, nosso sistema oferece suporte conforme disposto na tabela a seguir:

1. Utilizado para adição de multa (veja Particularidades - Segmento R)
2. Ao fazer uso do segmento S, enviar conforme Tipo de Impressão 3 (veja Particularidades - Segmento S)
3. Utilizado apenas no retorno de emissões de Bolepix (veja Particularidades - Segmento Y-04)

Operações suportadas

A tabela abaixo contém todas as operações suportadas, conforme o código passado no campo 07.3P Código de Movimento Remessa (tabela domínio C004):

Particularidades

Segmento R

O segmento R pode ser utilizado para adicionar instruções e mensagens no boleto, bem como para informativo de dados de multa a serem adicionados às cobranças emitidas, ou então em caso de alteração de dados de multa.

Para mensagens, utilize os campos 18.3R - Informação 3 e 19.3R - Informação 4. Para adicionar mais linhas de instruções, utilizar o Segmento S.

Outros campos relacionados a descontos adicionais que podem ser concedidos, bem como dados para débito, atualmente não são suportados.

Segmento S

O segmento S possui 2 estruturas em seu layout, porém o modelo hoje aceito é apenas o Tipo de Impressão 3, visto que não é possível realizar estilizações na máscara gerada pelo banco BTG Pactual.

Para mensagens, utilize os campos 09.3S até o 13.3S.

Caso o cliente desejar incluir estilizações, como ícones, em seus boletos é necessário o uso de uma máscara customizada.

Para uso de máscaras customizadas, veja Máscara customizada de cobranças.

Segmento Y-04

O segmento Y-04 é utilizado apenas no retorno de emissões de Bolepix, sendo ignorado caso enviado em arquivos de remessa.

Para mais detalhes relacionados a Bolepix, veja Emissão de Bolepix.

Extrato

Versão suportada: 10.9 (link)

Segmentos suportados

Na área de extrato existe apenas um único segmento, o segmento E.

Particularidades

Categoria do Lançamento

O segmento E contém o campo 25.3E Categoria do Lançamento que representa o tipo de operação realizada. As operações são segmentadas entre operações de crédito e débito.

📘

O BTG Pactual permite, caso necessário, a customização destes códigos, para que determinados tipos de movimentação sejam registrados em outra categoria.