Pular para conteúdo

Cobrança bancária (convênios e boletos)

Configura o convênio bancário (parâmetros CNAB 240 e PIX) e emite boletos a partir de títulos a receber.

Filtro de obra

Convênios, boletos, remessas e retornos seguem o filtro Obra (Organização, uma obra ou Todas): o dono é o do convênio, que é o mesmo da conta bancária. A coluna Escopo mostra o dono de cada linha.

Pré-requisitos

  • Permissões bank_agreement:* e bank_slip:*.
  • Conta bancária cadastrada para vincular ao convênio.

Convênios bancários

  1. Menu Financeiro → Convênios Bancários → Novo Convênio.
  2. Informe código, nome, conta bancária, convênio, carteira, espécie do título, o documento e nome do beneficiário e o controle do nosso número (inicial e tamanho).
  3. Para cobrança via PIX, ative PIX habilitado e informe o tipo e a chave.
  4. Criar.

O convênio guarda os parâmetros usados na geração de boletos e no arquivo de remessa CNAB 240.

Emitir boletos

  1. Menu Financeiro → Boletos → Emitir Boleto.
  2. Selecione o convênio e o título a receber de origem. Criar.
  3. O boleto é emitido com nosso número, linha digitável/código de barras e, se o convênio tiver PIX, o QR / copia-e-cola correspondente.

No convênio com provedor API CredCrea, a emissão registra o boleto direto na Ailos (BolePIX). A multa e os juros saem dos percentuais do convênio. Esse boleto já nasce registrado e não entra em remessa. O PDF da ficha de compensação (código de barras e QR PIX) fica anexado à cobrança, com nome boleto_, e o cotista baixa pela segunda via. O cooperado precisa ter endereço completo. As chaves da API ficam no ambiente do servidor, não no cadastro.

Consultar pagamentos

Em Financeiro → Boletos, o botão Consultar pagamentos pergunta à Ailos o retorno dos boletos que ainda estão registrados. Os que constam como pagos são baixados na cobrança. Com um convênio selecionado no filtro, a consulta fica só nele; em Todos os convênios, percorre os convênios CredCrea.

A mesma consulta roda todo dia às 06:00 (horário de Brasília), sem precisar abrir a tela.

Enviar boleto e extrato

Em Financeiro → Boletos, filtre pela obra e pelo mês/ano de vencimento, marque os boletos e clique Enviar boletos. Cada cotista recebe um e-mail com o PDF do boleto e o extrato atualizado da cota. O primeiro envio daquele cotista usa um texto; os seguintes usam outro.

Os dois textos ficam em Textos da interface, nas chaves bank_slip.email.first e bank_slip.email.next. O primeiro é a mensagem de boas-vindas; os seguintes são o aviso curto da integralização do mês. Dá para reescrevê-los. O tratamento muda sozinho: uma pessoa fica no singular (Prezado/Prezada, auxiliá-lo/auxiliá-la); mais de uma pessoa fica no plural, e o masculino vale quando há ao menos um homem (Prezados, auxiliá-los). Só mulheres ficam no feminino (Prezadas, auxiliá-las). Essas palavras também podem ser editadas, nas chaves bank_slip.email.form. Quem está na mesma cota e marcado para receber e-mail entra no mesmo envio. O cotista precisa ter e-mail.

Cancelamento

Só é possível cancelar boletos ainda não enviados em remessa.

Remessa CNAB

A remessa agrupa boletos emitidos num arquivo CNAB 240 para envio ao banco.

  1. Menu Financeiro → Remessas CNAB → Nova Remessa.
  2. Selecione o convênio; a janela lista os boletos emitidos ainda sem remessa.
  3. Marque os boletos desejados e clique Criar remessa (o lote nasce em DRAFT).
  4. Na listagem, clique Gerar para produzir o arquivo .rem — os boletos passam a registrados — e depois Baixar para salvar o arquivo e enviá-lo ao banco.

Requer cnab_remittance:create, cnab_remittance:generate e cnab_remittance:download.

Retorno CNAB

O retorno importa o arquivo enviado pelo banco e liquida os boletos por ocorrência.

  1. Menu Financeiro → Retornos CNAB → Importar Retorno.
  2. Selecione o convênio e o arquivo .ret recebido do banco. Importar.
  3. A importação é idempotente por hash — reenviar o mesmo arquivo não duplica baixas.
  4. A listagem mostra processados e falhas por lote.

Requer cnab_return:import.

Consultar sem permissão de edição

Quem tem só permissão de consulta nesta tela vê o ícone de olho (Visualizar) na linha, no lugar do lápis. Ele abre o cadastro completo com os campos bloqueados e apenas o botão Fechar. Veja Consultar sem editar.

Relacionado