Integração Hubsoft com Safra

Sobre o Banco Safra

O Banco Safra é um banco brasileiro de controle privado, conhecido pela gestão personalizada e pelos investimentos. Atende pessoas e empresas com conta, crédito e serviços financeiros. Para o provedor com conta no Safra, a carteira de cobrança pode ser usada no Hubsoft.

O que a integração faz

• Registro pela API: o Hubsoft transmite o boleto ao Safra sem arquivo de remessa. O registro acontece em até 5 minutos depois da emissão.
• Remessa CNAB 240 e 400: para registro por troca de arquivos.
• Retorno CNAB 240 e 400: o Hubsoft processa o arquivo de retorno e dá baixa nas faturas pagas.
• Envio da cobrança: e-mail, SMS e mensageiros, notificação no Aplicativo do Cliente e ligação.

O que você precisa

• Conta no Safra com convênio de cobrança, com os dados informados pelo gerente.
• Para a API: a liberação da modalidade Registro On-line de Boletos de Cobrança Safra e as credenciais entregues pelo banco.
• Módulo Financeiro do Hubsoft, incluso na licença.

Como ativar

1. Em Configuração > Financeiro > Forma de Cobrança, clique em Adicionar e escolha o Banco Safra.
2. Preencha a aba Configuração com os dados do convênio.
3. Homologue: gere três boletos de teste, envie a remessa, pague e processe o retorno.
4. Peça ao gerente a liberação do Registro On-line e as credenciais.
5. Na aba API da forma de cobrança, ative a integração e adicione as credenciais em Parâmetros Extras.
6. Gere um boleto de teste e confira se ele foi registrado em até 5 minutos.

O passo a passo com as telas está na página do Safra na wiki da Hubsoft.

Limitações

• A API do Safra faz só o registro do boleto. Baixas e liquidação seguem pelos arquivos de remessa e retorno.
• Se o campo de dias antes do vencimento ficar vazio, o Hubsoft transmite pela API todos os boletos pendentes.

Perguntas frequentes

Quais funções a API do Safra tem no Hubsoft?

Só o registro do boleto. A liquidação vem pelo arquivo de retorno.

Por que o boleto não registrou pela API?

Os erros costumam ser específicos de algum dado do cliente ou da comunicação com o banco. O suporte da Hubsoft analisa o caso.

Posso editar a forma de cobrança que já uso?

A wiki recomenda criar uma forma de cobrança nova a cada homologação.

Revisado em 10/10/2026.