Docs

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

Guia prático4 min de leitura

Contas bancárias e caixa

Conta, agência e perfis de cobrança (convênio, carteira, beneficiário).

No processo todo, esta tela é o “onde o dinheiro mora” — banco, agência, conta e os perfis de cobrança. Credenciais e canal ficam em Conexões bancárias. Visão completa: Cobrança bancária no Pulse.

Conta bancária ou caixa

Cadastre cada conta (corrente, poupança, caixa) com:

  • Nome amigável
  • País e banco / instituição
  • Agência, conta e dígitos
  • Saldo inicial (bloqueado após a primeira movimentação)

Depois da primeira movimentação:

  • Nome, tipo e ativo/inativo podem ser alterados normalmente
  • Saldo inicial e moeda ficam bloqueados
  • Trocar banco, agência ou número da conta exige confirmação (pode afetar conciliação e cobrança)

A conta sozinha não emite boleto: falta o perfil (e a conexão, quando for API ou remessa).

Perfil de cobrança

Na aba Cobrança da conta, o perfil guarda como você cobra neste banco:

  • Convênio / código do beneficiário
  • Carteira (banco) — código do produto (ex.: Santander 101, BB 17) para boleto PDF e API
  • Carteira CNAB (FEBRABAN) — 1 dígito no arquivo (1 = cobrança simples). Não use 101 aqui
  • Variação da carteira, quando o banco exigir
  • Dados do beneficiário impressos no boleto
  • Encargos (juros, multa, protesto) quando o banco exigir
  • Tipo (normal ou recuperação) e se é o perfil padrão da conta

No Santander, 101 / 102 / 201 são carteiras de produto; no CNAB 240 o Pulse grava 1 (simples), salvo se você escolher outro código FEBRABAN.

Juros do perfil entram no arquivo conforme o banco (ex.: Cresol não usa “isento 3”; Itaú CNAB 240 usa valor ao dia). Multa em arquivo (segmento R) ainda não é emitida — só instruções no PDF de exemplo.

Pode haver mais de um?

Sim. Exemplos comuns:

  • Um perfil “Boleto normal” e outro “Recuperação”
  • Carteiras diferentes no mesmo convênio
  • Homologação vs produção (quando o banco exige códigos distintos)

Marque um como padrão. Na parcela / emissão, o Pulse usa o padrão se você não escolher outro.

Onde o perfil é usado?

Por que precisamos disso?

O banco identifica a empresa pelo convênio/carteira, não só pela agência/conta. Sem perfil, o Pulse não sabe qual layout/CNAB ou registro API usar. A conexão só diz como falar com o banco; o perfil diz com qual contrato.

Sem perfil

O Cockpit mostra a conta incompleta. Remessa e emissão ficam bloqueadas ou falham com mensagem acionável (“configure o perfil de cobrança”).

Mais de um perfil

Funciona. Escolha o perfil na parcela ou use o padrão. Se nenhum estiver marcado como padrão e houver vários, o operador precisa selecionar um — evite deixar a conta sem padrão.

Como testar a emissão de um boleto com o perfil

  1. Cadastre a conta com banco COMPE correto (ex.: Cresol 133, BB 001).
  2. Na aba Cobrança, crie um perfil com convênio, carteira e beneficiário. Use prévia PDF e/ou prévia CNAB para conferir o layout — isso não registra no banco.
  3. Em Conexões, crie a conexão (arquivo ou API) em Homologação, vinculada a esta conta.
  4. Confira o Cockpit — conta, perfil e conexão devem estar ok.
  5. Lance um título em Contas a receber (ou use um existente) e associe o perfil na parcela.
  6. API: em Boletos, emita o boleto e confira linha digitável / PDF.
  7. Arquivo: em Comunicação bancária, gere a remessa, envie ao banco (homologação) e importe o retorno.

Se algo faltar, o cockpit e as telas de operação indicam o próximo passo — não invente convênio “só para testar” em produção.

Relacionado