Docs

Guias do produto, rotinas operacionais e integrações da Plataforma

Guia prático3 min de leitura

Cobrança bancária no Pulse

Conta, perfil, conexão e o fluxo feliz de arquivo ou API.

A cobrança bancária no Pulse usa três papéis e um cockpit de orientação. Cada tela resolve uma pergunta — não misture convênio com senha da API.

O que você precisa

  1. Conta bancária — banco (COMPE), agência e conta (onde o dinheiro mora).
  2. Perfil de cobrança — convênio, carteira, beneficiário e encargos (como você cobra).
  3. Conexão — canal, credenciais e ambiente (como você fala com o banco).

Sem os três, o Cockpit bancário mostra o que falta.

Dois jeitos de falar com o banco

Canal Quando usar Onde operar
Arquivo (CNAB 240) O banco trabalha com remessa/retorno Comunicação bancária
API (online) O banco registra e liquida por serviço Emitir em Boletos; sync/eventos na Comunicação

No piloto, a Cresol entra só por API. BB, Santander e Safra usam arquivo (padrão FEBRABAN) enquanto a homologação avançada não fecha. Veja a matriz de bancos.

Mapa rápido

Passo Tela
Diagnóstico Cockpit bancário
Conta + perfil Contas bancárias e caixa → aba Cobrança
Canal e senhas Conexões bancárias
Remessa / retorno / sync Comunicação bancária
Operar títulos Boletos

Fluxo feliz — arquivo

  1. Cadastre a conta com banco, agência e conta.
  2. Crie o perfil de cobrança (convênio + carteira + beneficiário).
  3. Crie a conexão “Arquivo CNAB”, em Homologação, vinculada à conta.
  4. Lance o título em Contas a receber com o perfil na parcela.
  5. Em Comunicação bancária: baixe a remessa → envie ao banco → importe o retorno.
  6. Confira o relatório do retorno (liquidados agora, já liquidados, não encontrados, erros).

Fluxo feliz — API

  1. Conta + perfil como acima.
  2. Conexão da instituição (BB ou Cresol) com credenciais no cofre, em Homologação.
  3. Emita o boleto em Boletos (ou na parcela).
  4. Acompanhe sync e eventos em Comunicação bancária (aba Online).

Homologação e produção

Produção só libera quando o canal do banco está validado no Pulse. Enquanto estiver “em validação” ou “padrão FEBRABAN”, use o ambiente de Homologação. O cockpit e a Comunicação mostram o status.

FAQ curto

  • Posso reenviar o mesmo título na remessa? Não enquanto houver cobrança aberta/registrada para a parcela.
  • O retorno diz “já liquidado” — o título já tinha sido baixado; não é erro silencioso.
  • Onde fica o arquivo? Só em Comunicação bancária; Boletos e Contas a receber apenas linkam.

Relacionado