O que é essa funcionalidade
O sistema passou a se comunicar diretamente com o banco Santander para trabalhar com boletos. Isso significa que, quando essa integração está ativa, o próprio sistema:
- Registra o boleto direto no banco no momento da emissão;
- Permite consultar e reemitir o mesmo boleto;
- Recebe automaticamente a baixa (cancelamento ou pagamento) quando o cliente paga ou quando o boleto é cancelado;
- Também aceita pagamento via PIX (QR Code), com baixa automática assim que o pagamento é confirmado.
Parametrização da integração (pré-requisitos)
Essa etapa normalmente é feita uma única vez pela equipe técnica/implantação, mas é importante o usuário saber onde consultar caso precise confirmar a configuração.
Cadastro da integração Santander
Caminho: Módulo Interno > Parâmetros > guia Integrações
Nessa tela é cadastrado o registro do tipo “Santander”, com as informações fornecidas pelo próprio banco (URL, credenciais e certificado).
Cadastro dos endpoints
Depois de salvo o cadastro acima, são registrados os endpoints usados pela integração (obtenção de token e inserção/registro).
Definindo o Santander como integração de boletos
Caminho: Módulo Interno > Parâmetros > guia Financeiro
Aqui se define que o Santander é o banco usado para registrar boletos.
Habilitando o PIX no boleto
Ainda nessa tela, para o boleto sair com QR Code PIX, é preciso que estejam preenchidos: o tipo de chave PIX do conselho e a chave PIX do conselho.
Webhook de confirmação de pagamento
Pré-requisito: a notificação enviada pelo Santander não é recebida diretamente pelo BRConselhos. Quem recebe é a API de webhook do BRConselhos, uma aplicação instalada separadamente do sistema, que registra a notificação e a encaminha ao BRConselhos para a baixa — assim as confirmações continuam sendo recebidas mesmo que o sistema esteja momentaneamente indisponível, e processadas em seguida. A instalação dessa API é feita pela equipe técnica e é o endereço dela, acompanhado do token do cliente, que deve ser informado como URL de retorno no cadastro do webhook.
O webhook é o mecanismo pelo qual o Santander avisa o BRConselhos de que um pagamento foi concluído.
Carteira de cobrança
Caminho: Módulo Financeiro > coleção Informações Bancárias > guia Carteiras de cobrança
Na carteira usada pelo convênio, deve constar o convênio correto e a integração Santander selecionada. Um identificador de “Workspace” aparece nessa tela, mas é preenchido automaticamente pelo sistema na primeira emissão — não precisa ser preenchido manualmente.
Emitindo um boleto com a integração ativa
- Gere o título normalmente, como já é feito hoje.
- Emita o boleto normalmente — o sistema envia o registro para o Santander automaticamente, sem nenhuma tela ou botão extra.
Baixa (cancelamento ou recebimento) do boleto
Quando o título é cancelado ou recebido, o sistema comunica a baixa ao Santander automaticamente. Não existe uma tela específica para isso, a baixa acontece como consequência da ação normal (cancelar ou receber o título).
Pagamento via PIX (QR Code) — recebimento automático
Além do boleto tradicional, o sistema também permite pagamento via PIX, com QR Code gerado junto ao boleto.
Gerando o boleto com opção de PIX
Ao emitir o boleto normalmente, o QR Code do PIX já vem junto, não é preciso nenhuma configuração extra por emissão.
Pagamento pelo cliente
O cliente paga normalmente escaneando o QR Code no aplicativo do banco dele.
Conferindo se o pagamento foi processado
Depois do pagamento, o sistema cria automaticamente um registro dentro de:
Caminho: Interno > Integração auditoria
- Se já existir uma integração bancária na data atual para aquele convênio, o novo item entra dentro dela;
- Se não existir, o sistema cria uma nova integração bancária para o dia.
Agendamento automático da baixa
Junto com o registro da integração, o sistema também cria automaticamente um agendamento para processar a baixa do título.
Caminho para conferir: Interno > Agendamentos
Confirmando a baixa concluída
Depois que o agendamento é processado, o título passa a constar como pago dentro do sistema.
Onde consultar o histórico
Todas as requisições enviadas ao Santander e as respostas recebidas ficam registradas na auditoria do sistema.
