Baixar o PDF de um boleto registrado no banco

O Kryia One pode entregar o PDF do boleto exatamente como o próprio banco o emite, sem você precisar abrir o aplicativo do banco. O PDF já traz impressas a multa e os juros definidos no Tipo de Negociação. Esta função está disponível para contas Santander.

O procedimento de uso é o mesmo de antes: você não precisa configurar nada para que o download funcione. O que mudou foi o resultado. Antes, o banco chegou a recusar o download com HTTP 403 (host cft.santander.com.br), porque a proteção dele não aceitava a identificação padrão da biblioteca HTTP que o sistema usava. Agora o One se identifica ao banco com um nome próprio (KryiaOne/<versão>) e o banco entrega o PDF. O One não se passa por navegador, e o problema não era de credencial.

Onde encontrar o boleto

A tela Acompanhamento de Boletos fica em Financeiro › Rotinas e lista os títulos com cobrança integrada. Veja acompanhar boletos e Pix. O PDF é pedido a partir do título que aparece nessa lista.

Quando o PDF existe

Só há PDF para título com boleto registrado no banco, ou seja, com tipo de cobrança BOLETO, situação REGISTRADO e nosso número preenchido. Sem isso o sistema responde “Este título não tem boleto registrado no banco.”

O cliente do título também precisa ter CPF ou CNPJ válido no cadastro. Sem isso, o sistema informa: “O cliente do título precisa ter CPF/CNPJ válido cadastrado para obter o PDF do boleto.”

O PDF sai com o nome boleto-<nosso número>.pdf.

Permissões necessárias

Para obter o PDF você precisa de duas permissões:

• alterar o título (TBLFIN);
• consultar o parceiro (TBLPAR).

O motivo é que o PDF traz nome, documento e endereço do pagador.

Na grade da tela Acompanhamento de Boletos, a permissão de consultar títulos é obrigatória. O nome e a razão social do parceiro só aparecem para quem pode consultar parceiros; sem essa permissão ficam em branco e a grade continua funcionando.

Prazo de resposta do banco

O sistema espera até 5 segundos pela resposta do banco. Se o banco demorar mais, o sistema desiste e informa: “O banco não respondeu a tempo ao baixar o PDF do boleto.” Tente de novo mais tarde.

Como o sistema baixa o arquivo do banco

O banco devolve um link para o PDF, e o sistema só o baixa se estas condições forem atendidas:

• o link é https;
• o endereço é santander.com.br ou um subdomínio dele;
• o arquivo tem no máximo 5 MB;
• o endereço não manda o sistema para outro lugar (o sistema não segue redirecionamento);
• o arquivo é um PDF.

Se o banco devolver um arquivo que não é um PDF, o sistema informa: “O arquivo devolvido pelo banco não é um PDF.”

O link no gateway da API do banco é baixado com o token e o certificado (mTLS) da conta. Já o link de outro endereço do banco, como cft.santander.com.br, é baixado sem credencial. O link assinado do banco nunca aparece nas mensagens.

Quando o PDF vai por e-mail

No e-mail da nota com o anexo do tipo BOLETO, o sistema junta um PDF do banco por título com boleto registrado. O e-mail não sai sem esse PDF:

• Se o título ainda não foi registrado ou o PDF está indisponível, a falha é transitória. O envio é reagendado com a mensagem “O PDF do boleto não veio do banco; nova tentativa agendada.” Se as tentativas se esgotarem, o e-mail vai a ERRO.
• Se o banco recusou o boleto, ou o banco da conta não oferece o PDF, o problema é de configuração e o e-mail vai direto a ERRO.

O passo a passo está em enviar o boleto em PDF no e-mail do documento.

Problemas comuns

“Este título não tem boleto registrado no banco.” O título não está com boleto registrado. Confira o tipo de cobrança, a situação e o nosso número.

“Conta bancária do registro não encontrada.” O sistema não achou a conta bancária em que o boleto foi registrado.

“O banco desta conta não oferece o PDF do boleto.” Só o Santander oferece essa função. Para outro banco o PDF não é emitido pelo sistema.

“O cliente do título precisa ter CPF/CNPJ válido cadastrado para obter o PDF do boleto.” Corrija o CPF ou CNPJ no cadastro do cliente e tente de novo.

“Não foi possível baixar o PDF do boleto no banco (HTTP <código>, host ).” O banco recusou o download. A mensagem mostra o código HTTP e o endereço do banco que respondeu, por exemplo “HTTP 403, host cft.santander.com.br”. Quando o banco não responde, no lugar do HTTP aparece “sem resposta”. Tente de novo mais tarde; se persistir, informe ao suporte o código e o host que a mensagem mostra.

“O banco não respondeu a tempo ao baixar o PDF do boleto.” O banco passou do prazo de 5 segundos. Tente de novo mais tarde.

“O arquivo devolvido pelo banco não é um PDF.” O banco devolveu um arquivo que não é PDF. Tente de novo mais tarde; se persistir, avise o suporte.