Implementação do QR CODE do Pix no boleto do Santander NT 0435/2026

Resumo da Nota Técnica

A partir desta versão, foi implementado o QR Code do PIX no boleto do banco
Santander (boleto híbrido).

Detalhes da Nota Técnica

--------------------------------------------------------------------------------
1. PARÂMETRO 4.18.793
--------------------------------------------------------------------------------

Foi criado o parâmetro 4.18.793 – MODELO DE IMPRESSÃO BOLETO SANTANDER, com as
opções:

- Padrão (default)
Impressão pelo modelo antigo (RLBoleto) — sem QR Code PIX.

- FastReport
Impressão via ACBr + FastReport (BoletoSantanderPIX.fr3) — com suporte
ao QR Code PIX.

IMPORTANTE:
O QR Code do PIX só é impresso no boleto quando o parâmetro 4.18.793 estiver
como FastReport.

--------------------------------------------------------------------------------
2. COMO HABILITAR O QR CODE PIX
--------------------------------------------------------------------------------

Na Cobrança Bancária — módulo Santander — no cadastro da conta:

1) Em "Habilitar PIX", escolher "Sim".
2) Informar a Chave PIX (obrigatória, até 77 caracteres) — a mesma chave
cadastrada no Santander.
3) Usar carteira 5 — Rápida com Registro (impressão pelo cliente).
O sistema bloqueia a remessa híbrida se a carteira for diferente de 5.
4) Gerar a remessa normalmente (ocorrência de entrada 01). Com o PIX
habilitado, o arquivo inclui o registro tipo 8 com a chave PIX.

Campos relevantes:

- Habilitar PIX ................. Sim
- Chave PIX ..................... obrigatória se PIX = Sim (máx. 77)
- Carteira ...................... 5 (obrigatória para boleto PIX)
- Código de transmissão /
agência / conta ...............
conforme cadastro da conta no banco
- Demais dados da remessa ....... cedente, instruções, etc., como já utilizado

A chave PIX também precisa estar habilitada/cadastrada na conta junto ao
Santander, e o banco deve devolver o registro de retorno com a URL/TXID do QR
(quando contratado).

--------------------------------------------------------------------------------
3. QUANDO O QR CODE APARECE NO BOLETO
--------------------------------------------------------------------------------

O QR Code NÃO é gerado na remessa.

Para aparecer na impressão:

1) Enviar a remessa com PIX habilitado (carteira 5 + chave).
2) Importar o arquivo de retorno do Santander.
3) O retorno traz a URL/TXID do PIX; o sistema monta o EMV e grava em
DUP_QRCODEPIX.
4) No Integrado, com o parâmetro 4.18.793 = FastReport, imprimir/reimprimir
o boleto.

ATENÇÃO:
Sem a importação do retorno (com os dados do PIX) OU com o parâmetro em
Padrão, o boleto sai sem QR Code.

Questões:

1) Qual configuração é obrigatória para que o QR Code do PIX seja impresso no boleto Santander?

A) Configurar o parâmetro 4.18.793 como FastReport.
B) Configurar o parâmetro 4.18.793 como Padrão.
C) Utilizar qualquer modelo de impressão, pois o QR Code é gerado automaticamente.
D) Habilitar apenas a chave PIX, independentemente do modelo de impressão.

2) Qual combinação de configurações é obrigatória para gerar uma remessa de boleto PIX do Santander?

A) Habilitar PIX = Sim, informar a Chave PIX cadastrada no Santander e utilizar a carteira 5 – Rápida com Registro.
B) Habilitar PIX = Não e utilizar qualquer carteira.
C) Informar apenas a Chave PIX, sem necessidade de definir a carteira.
D) Utilizar a carteira 1 e importar o retorno antes da remessa.

3) Em que momento o QR Code do PIX passa a ser exibido no boleto Santander?

A) Imediatamente após a geração da remessa.
B) Após a importação do arquivo de retorno do Santander e impressão/reimpressão do boleto com o parâmetro 4.18.793 configurado como FastReport.
C) Somente após o pagamento do boleto pelo cliente.
D) Assim que a chave PIX é cadastrada no sistema, sem necessidade de retorno bancário.

Parâmetros Envolvidos

4.18.793 – MODELO DE IMPRESSÃO BOLETO SANTANDER = 'FastReport'

» Nota Técnica