Configuração de boleto

• Teclas de atalho:

  • F8 - Para selecionar e/ou consultar registros já cadastrados no sistema.

  • F12 - Salvar.

Para que seja impresso o QRCode para pagamento via PIX, o beneficiário deve possuir o produto PIX contratado e habilitado no convênio para utilizar a modalidade API cobrança online e configurar o campo BENEFICIÁRIO UTILIZA PIX = “S”.

Para configurar boleto/remessa é necessário cadastrar a conta bancária em “Financeiro/Cadastros/Contas caixa/contas bancárias/bancos/operações com títulos/ taxa de juros/multa/moedas”.
Informar o tipo de cadastro (boleto (API), boleto ou remessa), descrição para posterior identificação através da consulta F8 e selecionar a conta bancária.
Após selecionar a conta bancária, o sistema mostra quais layouts de boleto/remessa são permitidos através da consulta F8 no campo “Modelo”.
Para configuração de boleto informe o layout de impressão, pode ser alterado a qualquer momento.
O tipo de emissão define quando o boleto/remessa estiver em processo de homologação ou produção, quando estiver em homologação aparecerá somente nas consultas F8 para o usuário “TÉCNICO” e quando estiver em produção aparecerá para todos os usuários do sistema.
Ao salvar esse cadastro inicial, o sistema carrega as configurações específicas para cada banco. Preencher todos os campos solicitados na coluna “conteúdo” conforme orientação na ajuda de campo que aparece quando o campo entra em edição.

Solicitar junto ao gerente do banco as credenciais em “produção” “client id (usuário)” e “client secret (senha)”.

• Negativação: A negativação pode ocorrer na geração inicial do boleto, que seria a negativação automática, que o título irá entrar em negativação após x dias posterior ao vencimento, conforme configurado.
  Outra forma de negativar seria após a geração do título, por meio da operação "Negativar".
  Vale ressaltar que, para negativação automática ou pela operação “Negativar”, o campo de “DIAS DE LIMITE PARA O RECEBIMENTO” em “Utilitários” / “Configurações” / “Config. boleto” deve estar preenchido.
  Adicionalmente, é possível ainda remover a negativação dos títulos utilizando a operação “Cancelar/excluir negativação”. Essa ação cancelará a solicitação de negativação caso ainda não tenha sido efetivada e excluirá a negativação caso já estiver ativa.
  Suporte: Fone: (61) 3104-9500 e/ou e-mail: suporte.openbannking@bb.com.br

Solicitar junto ao gerente do banco as credenciais em “produção” "client id (usuário)" ou criar uma conta no portal do desenvolvedor https://developers.sicoob.com.br/portal/ em seguida Meus aplicativos, criar novo aplicativo.
Configurar o certificado digital com extensão .PFX no cadastro da conta bancária em “Menu” / “Financeiro” / “Cadastros” / “Contas bancárias”. Acessar a aba “Gerar certificado - Sicoob”, selecionar o arquivo *.PFX, informar a senha do certificado e clicar em gerar, automaticamente o sistema irá gerar o certificado com chave pública e privada, utilizado para comunicação com a API.

• Negativação: A negativação pode ocorrer na geração inicial do boleto, que seria a negativação automática, que o título irá entrar em negativação após x dias posterior ao vencimento, conforme configurado.
  Outra forma de negativar seria após a geração do título, por meio da operação “Negativar”.
  Vale ressaltar que, para negativação automática ou pela operação “Negativar”, o campo de “DIAS DE LIMITE PARA O RECEBIMENTO” em “Utilitários” / “Configurações” / “Config. boleto” deve estar preenchido.
  Adicionalmente, é possível ainda remover a negativação dos títulos utilizando a operação “Cancelar/excluir negativação”. Essa ação cancelará a solicitação de negativação caso ainda não tenha sido efetivada e excluirá a negativação caso já estiver ativa.

Necessário cadastrar em “produção” o “código de acesso (senha)” e o “token de autenticação (X-API-KEY)”.
Para cadastrar o “código de acesso (senha)”, a empresa ou pessoa associada deve acessar o Internet Banking, pela conta vinculada ao seu convênio de Cobrança, e selecionar a opção de menu no:
Cobrança » Código de Acesso » Gerar - Esse menu é apresentado exclusivamente para os beneficiários que possuem a modalidade API (Cobrança Online) habilitada no convênio.
Para cadastrar o “token de autenticação (X-API-KEY)”, criar uma conta no portal do desenvolvedor » https://developer.sicredi.com.br/api-portal/pt-br em seguida acessar “Minhas Apps”, selecionar o App criado e clicar em detalhes, será exibido o token de acesso.

• Negativação: A negativação é possível somente durante a geração do boleto, que seria a negativação automática, que o título irá entrar em negativação após x dias posterior ao vencimento, conforme configurado, desde que o campo “DIAS DE LIMITE PARA O RECEBIMENTO” em “Utilitários” / “Configurações” / “Config. boleto” esteja preenchido.

Acessar o Internet Banking, navegar até Conta digital » Aplicações » Nova aplicação. Definir um nome, descrição e o escopo (funcionalidades) que deseja para sua aplicação (cobrança) e clicar em criar.
Uma vez criada aplicação, será gerado as credenciais Client ID, Client Secret e os certificados.
Faça o download do certificado digital (.crt) e a respectiva chave privada (.key).
No cadastro da conta bancária em “Menu” / “Financeiro” / “Cadastros” / “Contas bancárias” aba Certificados API - (PIX QR Code / Boleto), no campo Certificado (chave pública), selecione o arquivo .crt e no campo Certificado (chave privada), selecione o arquivo .key.

Entrar em contato junto ao banco através do e-mail homologacaocobranca@ailos.coop.br para solicitar os dados de acesso em homologação.
Configurar o boleto em “Utilitários” / “Configurações” / “Config. boleto”: Configurar o tipo de emissão como homologação e preencher os dados. Ao salvar, irá abrir a tela de autenticação da Ailos onde devem preencher com a cooperativa, número da conta e senha (número da conta e senha em homologação será repassada pelo banco no e-mail), após o preenchimento correto das informações é estabelecido a autenticação junto ao banco, podendo assim realizar a emissão dos boletos.
Após 3 boletos emitidos com sucesso, enviá-los em formato PDF através do e-mail homologacaocobranca@ailos.coop.br.
Após análise e aprovação dos boletos, o banco retornará no e-mail os dados em produção.
Posteriormente, acessar em “Utilitários” / “Configurações” / “Config. boleto”, configurar o tipo de emissão para produção e inserir os dados recebidos.

Acessar em “Utilitários” / “Configurações” / “Config. boleto”, configurar e preencher o usuário/senha da plataforma de cobrança para uso da API para autenticação e emissão de títulos.

Solicitar junto ao gerente do banco as credenciais em “produção” "client id (usuário)" ou criar uma conta no portal do desenvolvedor https://developer.santander.com.br/ em seguida Aplicações, Produção.
No cadastro da conta bancária em “Menu” / “Financeiro” / “Cadastros” / “Contas bancárias”. aba Certificados API - (PIX QR Code / Boleto), no campo Certificado (chave pública), selecione o arquivo .crt e no campo Certificado (chave privada), selecione o arquivo .key.

Solicitar junto ao gerente do banco as credenciais em “produção” “client id (usuário)”, “client secret (senha)”, IdBeneficiario, Agencia, Conta, Variação Carteira e Cooperativa. Criar uma conta no site https://developer.unicred.com.br/api-portal/ em “Dev Tools” » “Minhas Apps” » “Cadastrar Nova App” cadastrar aplicação, após ser aprovado o app pelo banco basta ir em “detalhes” do “Acess Token”, lá vai ter seus “Access Tokens Associados” que será usado para preencher o campo APIKEY do config. boleto, conforme explicado no help do campo no CHERP.

• Negativação: A negativação é possível somente durante a geração do boleto, que seria a negativação automática, que o título irá entrar em negativação após x dias posterior ao vencimento, conforme configurado, desde que o campo “DIAS DE LIMITE PARA O RECEBIMENTO” em “Utilitários” / “Configurações” / “Config. boleto” esteja preenchido.

• Sustar: Unicred não disponibiliza método para sustar boletos via API.
  Acesse o internet banking para sustar o boleto, e em seguida utilize o recurso “sustar” no CHERP para sincronizar com o banco. Em caso de dúvidas, verifique com o gerente/responsável de sua conta.

• Prorrogar/Renegociar vencimento: Operação indisponível para o banco Unicred via API. Verifique com o gerente/responsável de sua conta.

Solicitar junto ao gerente do banco as credenciais de “produção”. Após receber o “Token” de autenticação para emissão do boleto via API, acessar em “Utilitários” / “Configurações” / “Config. boleto” e configurar as informações gerais para emissão do boleto.

• O preenchimento do campo “Token” é obrigatório para uso e autenticação do usuário na API.

Realizar o acesso ou cadastro na plataforma do banco Asaas em https://www.asaas.com/, com a conta criada e os documentos validados.
Para configurar, clique no ícone do seu perfil (canto superior direito) e clique em “Integrações”. Na segunda aba, chamada “Chaves de API”, você deve clicar em “Gerar chave de API”, informar o nome da chave, a data de expiração (máximo de 1 ano) e a hora de expiração, que será a validade da sua chave de API, sendo necessário criar uma nova após o encerramento desta validade.
Após informar o nome e a data/hora, você irá receber uma confirmação via SMS e, após confirmar o código recebido, a sua chave de API será criada com sucesso.

Exemplo do formato de uma chave de API do Asaas: “$aact_YTU1YTMzM2M...” (exemplo fictício).
O preenchimento do campo “Token” é obrigatório para uso e autenticação do usuário na API.
Após receber o “Token” de autenticação para emissão do boleto via API, acessar em “Utilitários” / “Configurações” / “Config. boleto” e configurar as informações gerais para emissão do boleto, nas quais deve informar o “Token” recebido no campo “APIKEY”.

Solicitar junto ao gerente do banco as credenciais de “produção”.

Após receber o "Client ID (usuário)" e o token temporário (válido por 5 minutos), utilizar para gerar o certificado e o "client secret (senha)”.

• Para gerar o certificado e o client secret acesse no cadastro da conta bancária em “Menu” / “Financeiro” / “Cadastros” / “Contas bancárias”. Acessar a aba “Gerar certificado - Itaú (PIX QR Code / Boleto)”, inserir o “token temporário” e o “Client ID (usuário)”, clicar em gerar chave privada - “PASSO 1”, o sistema irá gerar a chave privada automaticamente, em seguida clicar no “PASSO 2” Solicitar certificado, e será gerado o "Client secret (senha)”em "Credenciais - PIX (QR Code) / Boleto".

• Após, deve-se copiar ambos os campos “Client ID” e “Client Secret” para serem inseridos em “Utilitários” / “Configurações” / “Config. boleto”, preencher as informações de “Client ID (usuário)” e “client secret (senha)”.

Acesse a sua conta e siga este passo a passo para gerar sua credencial pela Cora Web: Vá em menu “Conta” » “Integrações Via APIs” » “Integração Direta" » "Ambiente de Produção" » “Dados da sua credencial e client-id”. Na tela de “Credencial de ambiente de produção”, basta clicar no botão “Gerar uma nova credencial”, após o clique é feito automaticamente o download da credencial para o seu computador.

Após o download você vai ver os dados da sua credencial, por exemplo, a data da emissão e vencimento… e o status deve constar como “Ativa”.

• No passo anterior vai ser criado dois arquivos, o “certificate.pem” e o “private-key.key”.
  Devem associar esses arquivos no cadastro da conta bancária em “Menu” / “Financeiro” / “Cadastros” / “Contas bancárias”. Aba “Certificado API - (PIX QR Code / Boleto)”, no campo Certificado (chave pública), selecione o arquivo .pem e no campo Certificado (chave privada), selecione o arquivo .key.

• Associar o “Client ID” em “Utilitários” / “Configurações” / “Config. boleto”, preencher as informações de “client id (usuário)”.

Criar conta no portal Developers do banco Bradesco através do link a seguir: https://developers.bradesco.com.br/
Após criação da conta, acessar a aba “Aplicativos” e depois “Criar Aplicativo”, caso ainda não possua.
Após realizado o processo, acessar a aba “Produtos”, selecionar “Cobrança com QR Code” » “Inscrever-se” » Preencher os dados solicitados » “Enviar solicitação”.
Posteriormente, voltar a aba “Produtos” e executar o mesmo processo para o produto “Cobrança”.
Será necessário aguardar a aprovação das assinaturas após concluir o processo acima. O estado da aprovação pode ser verificado no menu “Assinaturas”.
Após aprovação das assinaturas, acessar novamente a aba “Produtos” » “Cobrança com QR Code” » Recursos » “Cobrança com QRCode - Registro de boleto com QRCode” (produção) » Registrar aplicação » Preencher com a assinatura, aplicação criada e clicar em “Registrar Aplicação”.
Voltar a aba “Produtos” e efetuar o mesmo processo descrito acima, agora com os recursos “Cobrança - Solicitação de baixa de boleto” e “Cobrança - Consulta de boleto especifico e emissão de 2ª via”.
Por fim, acessar a aba “Aplicativos”, acessar o aplicativo criado, clicar em “Solicitar Credencial”, preencher os dados solicitados e aguardar a liberação das credenciais de produção.

• O certificado da empresa deve ser associado no cadastro da conta bancária em “Menu” / “Financeiro” / “Cadastros” / “Contas bancárias”. Aba “Certificado API - (PIX QR Code / Boleto)”, no campo selecione certificado (.pfx), selecione o arquivo .pfx e no campo "Informe senha certificado", digite a senha para acesso do arquivo.

• Após aprovação das credenciais no portal, associar o “Client Key” gerado em “Utilitários” / “Configurações” / “Config. boleto”, preencher as informações de “client id (usuário)”.

Configurar o boleto em “CHERP” / “Utilitários” / “Configurações” / “Config. boleto”, mas não é necessário preencher os campos “Client ID (usuário)” e “Client Secret (senha)”.

• Coletar junto ao banco o código do cedente, espécie e carteira e informar nas configurações do boleto.

• Para emissão do boleto, acessar “CHERP” / “Financeiro” / “Boletos” ou utilizar o botão de atalho “Boletos”. Apenas emitindo e enviando o boleto via WhatsApp ou e-mail, a API já registra no banco.

Configurar o boleto em “CHERP” / “Utilitários” / “Configurações” / “Config. boleto”, solicitar ao gerente “Client ID (usuário)” e “Client Secret (senha)”.

• Coletar junto ao banco o código do cedente, espécie e carteira e informar nas configurações do boleto.

• Homologação: Você deve enviar cinco requisições e retornos de sucesso e os respectivos boletos em formato PDF para o email gestao_sistemas_cobranca_operacional@banrisul.com.br para conferência.

Boleto (API)/Boleto/Remessa são utilizados para cobrança de contas a receber.

A homologação garante que os dados informados estão corretos e evita transtornos futuros em caso de inconsistência nos dados informados.
Cada banco possui uma forma e um tempo para homologar o boleto/remessa, é interessante entrar em contato com o gerente da conta que o mesmo irá informar os passos para homologação.

Quando o banco confirmar que o boleto/remessa está homologado, altere a opção tipo emissão para produção.
No menu “Financeiro/Boletos” selecione os títulos e gere boleto/remessa. Não há ordem sequencial específica para gerar boleto ou remessa.
Para registrar os títulos no banco envie a remessa através do site/app bancário em seguida envie os boletos ao cliente.

Os boletos seguem o padrão nacional Febraban, podem ser customizados de acordo com a necessidade do cliente.
Para customizar no menu Business/Gerador BI/CHReport conforme os arquivos:

• CHCOB001001.fr3 : 1 por folha (doc.).

• CHCOB001002.fr3 : 2 por folha.

• CHCOB001003.fr3 : 2 por folha (rec. de entrega).

• CHCOB001004.fr3 : 3 por folha (carnê).

• CHCOB001005.fr3 : 40 colunas.

Há 3 tipos de remessa atualmente:

• CNAB 150: Remessa específica para débito em conta, esse tipo de remessa não gera nosso número e não tem impressão de boleto. No cadastro de pessoas na aba demais dados, é necessário informar o banco, agência e conta que será debitado no cliente, em seguida gerar remessa para cadastro. Neste momento deve-se aguardar o cliente autorizar o débito, utilize o gerenciador financeiro para identificar se a autorização foi feita pelo cliente.
  O próximo passo é gerar remessas de cobrança na tela Financeiro/Boletos e nos dias seguintes efetuar o processo de retorno na tela “Financeiro” / “Contas a receber” / “Retornos (bol)”, quando o cliente possui saldo na conta o débito é feito automaticamente e caso não tenha saldo receberá um retorno com tal ocorrência.
  Na configuração desta remessa há opção de agrupar títulos do mesmo cliente, se estiver marcada, ao selecionar vários títulos do mesmo cliente eles serão agrupados gerando apenas 1 taxa de cobrança.

• CNAB 240: Remessa para cobrança de títulos, alguns bancos optam por trabalhar com esse modelo porque possui um número maior de informações segmentadas em 4 blocos de 240 caracteres.

• CNAB 400: Remessa para cobrança de títulos, contém apenas 1 segmento com 400 posições por título.

CONFIG. AVANÇADA - Configuração avançada para remessa, esta tela apresenta todos os campos da remessa. A princípio não há necessidade de alterar esses campos, apenas em casos específicos quando houver divergências na homologação.
MÓDULO 11 - Deve ser usado quando for solicitado o dígito verificador calculado através do módulo 11 com aproveitamento. Informando o número que será calculado para obter o DV necessário para completar o cadastro do boleto/remessa, disponível para os bancos Sicoob e Caixa Econômica Federal.

TIPO – Tipo de configuração boleto/remessa.
CONTA BANCÁRIA – Conta bancária referente ao boleto/remessa.
DESCRIÇÂO - Descrição do cadastro para posterior identificação através da consulta F8 na emissão de boleto/remessa.
MODELO - Modelo de boleto/remessa, para alguns bancos há mais que um modelo.
LAYOUT BOLETO - Layout de impressão do boleto.

• Layout 40 colunas: Opção válida apenas para CHERP e CHPDV.

• CHMob(SD): Selecionar o layout em Configuração / “Impressão (pedido/orç. nota fiscal, boleto e comp. PIX)”.
  Se for selecionado A4, serão usadas as opções configuradas no campo Layout boleto.

TIPO EMISSÃO - Define o tipo de emissão (homologação/produção), para evitar que usuário gere boleto/remessa enquanto estiver em homologação.
DEMAIS CAMPOS - Os campos que aparecem na lista variam de acordo com os bancos e devem ser preenchidos conforme orientação em cada campo.