JAVA - Como configurar Boletos no Resulth Web (JAVA)

    Criado por Camillo Ernesto em 22/02/2023 16:36  ·  Atualizado em 22/02/2023 18:22  ·  Leitura: 10 min
    Como configurar Boletos no Resulth Web (JAVA)

    1. Para cadastrar modalidades:

    • Entre na rotina "Financeiro -> Cobrança eletrônica -> Parâmetros de cobrança";
    • Clique em "Adicionar Parâmetros de cobrança bancária";
    • Aba "Dados Gerais":

    1.png

    Se atente aos seguintes itens:
    • Tipo de cobrança: seleciona um dos tipos de cobrança suportados pelo "ACBr";
    • Nem todos os campos são necessários (ou suportados) para todos os bancos;
    • Local de pagamento: texto livre onde é informado o local de pagamento para aparecer no boleto; cada banco requer um texto diferente;
    • Tipo de carteira: pode ser "Simples", "Registrada", ou "Eletrônica";
    • Tipo de documento: pode ser "Tradicional" ou "Escritural";
    • Código de transmissão: código de transmissão, conforme informado pelo banco (se existir);
    • Modalidade: código de modalidade, conforme informado pelo banco (se existir);
    • Responsável pela emissão do boleto: pode ser "Cliente Emite", "Banco Emite", "Banco Reemite" ou "Banco não Reemite";
    • Layout do boleto: escolhe um dos tipo de layout de impressão de boleto suportados pelo "ACBr"; pode ser: "Padrão", "Carnê", "Fatura", "Padrão Entrega", "Recibo Topo", "Padrão Entrega 2", "Fatura Detalhe", "Térmica 80mm", "Padrão PIX" ou "Presta Serviços";
    • Nº versão lote arquivo remessa: conforme informado pelo banco (se existir);
    • Nº versão layout arquivo remessa: conforme informado pelo banco (se existir);
    • Nome do beneficiário: o nome do beneficiário;
    • Código espécie do título: conforme informado pelo banco (se existir);
    • Característica de cobrança do título: conforme informado pelo banco; pode ser: "Cobrança Simples", "Cobrança Vinculada", "Cobrança Caucionada", "Cobrança Descontada", "Cobrança Venda", "Cobrança Simples (Rápida com Registro)" ou "Cobrança Caucionada (Rápida com Registro)".

    2. Como emitir boletos:

    • Vá em "Financeiro -> Cobrança eletrônica -> Emissão de boletos";

    2.png


    • Banco/Modalidade: selecionar qual das modalidades cadastradas em "Parâmetros de cobrança" vai ser utilizada;
    • Layout do arquivo: permite dizer se vai usar o layout "CNAB400" ou "CNAB240" ao gerar o arquivo de remessa;
    • Exibir documentos já remetidos: se desmarcado, vai listar apenas os documentos que não geraram remessa; se marcado, vai listar apenas os documentos que já geraram remessa;
    • Os demais filtros vão servir para determinar quais documentos a pagar vão aparecer na lista;
    • Uma vez informados os filtros, pode-se clicar em "Consultar" para listar os documentos a receber correspondentes;
    • No lado esquerdo da tabela, vão aparecer checkboxes para determinar quais documentos devem aparecer no arquivo de remessa;
    • Após selecionar os checkboxes, pode-se clicar em "Gerar Remessa" para gerar o arquivo de remessa correspondente.

    3. Processar arquivo de retorno:
    • Vá em "Financeiro -> Cobrança Eletrônica -> Processar arquivo de retorno":

    3.png


    • Banco: o banco ao qual o arquivo de retorno pertence;
    • Arquivo a processar: o arquivo de retorno que vai ser processado;
    • Após informar o banco e o arquivo de retorno, pode-se clicar em "Processar".

    4. Algumas informações gerais e úteis sobre o processo:

    Regras CNAB400 BB
    • Cabeçalho do arquivo:
      • Foi criado parâmetro para poder informar um nome de beneficiário específico; se for deixado em branco, vai continuar usando a razão social da filial;
    • Detalhe do arquivo:
      • Para o "Seu Número", o sistema está, hoje, utilizando o código do título da cobrança bancária, essa é a regra que já era usada para Cobre Bem;
      • Coluna 83 (prefixo do título): a DLL do ACBr sempre joga brancos nessa posição; não há parâmetros para fazer diferente;
      • Foi implementada validação para recusar datas de vencimento posteriores a 2099, pois o campo de data do arquivo só possui dois dígitos para ano;
      • Coluna 159: No caso dos campos de instrução codificada, é questão de preencher corretamente os códigos nos campos de instrução 1 e 2 dos parâmetros de cobrança; no entanto, a DLL da ACBr utiliza, internamente, algumas regras especiais para estes dois campos:
        • Se instrução 1 ou instrução 2 for 88, as duas vão para o arquivo do jeito que estiverem;
        • Caso contrário:
          • Se data de protesto estiver preenchida e for maior que a de vencimento:
            • Se a data de protesto for de 3 a 5 dias e a instrução 1 estiver vazia, ele joga os dias de protesto na instrução 1;
            • Para qualquer outra quantidade de dias, se a instrução 1 estiver vazia, coloca '06' na instrução 1 e atualiza "DiasProtesto" com a diferença em dias.
          • Caso contrário, a informação '07' será lançada na instrução 1 (não protestar).
      • Quanto ao nome do pagador, não se conseguiu reproduzir o problema reportado: o ACBr está sempre colocando ele na posição 235, quer se utilize CPF ou CNPJ no campo anterior;
      • Quanto ao campo do bairro, na versão mais nova do layout, CBR643, esse campo ficaria na coluna 315, que é o que a DLL do ACBr está gerando;
      • Coluna 352: código modificado para não jogar nada na coluna se o valor da observação for nulo.

    • Regras sobre espécie do título:


    • Espécies usadas pela DLL da ACBr referente ao banco Santander:

     

    • Regra referente a instrução 1 e instrução 2 para BB: 

      • Se instrução 1 ou instrução 2 for 88, as duas vão para o arquivo do jeito que estiverem;
      • Caso contrário:
        • Se data de protesto estiver preenchida e for maior que a de vencimento:
        • Se a data de protesto for de 3 a 5 dias e a instrução 1 estiver vazia, ele joga os dias de protesto na instrução 1;
        • Para qualquer outra quantidade de dias, se a instrução 1 estiver vazia, coloca '06' na instrução 1 e atualiza "DiasProtesto" com a diferença em dias.
      • Caso contrário, a informação '07' será lançada na instrução 1 (não protestar).

    • Regras de preenchimento da coluna 224 a partir da instrução 2 do CNAB240 do Santander:
     
     
    • Sobre convênio e nosso número BB:

      • Para que o boleto tenha o mesmo nosso número e a mesma linha digitável do boleto correspondente do BB, tem que ser informado, no campo contrato do ACBr convênio que veio no nosso número e, no nosso número, tem que remover, do nosso número, a parte referente a contrato e DV, e indentar com uma quantidade de zeros à direita igual ao tamanho do contrato;
      • É provável que, para cada banco e para cada tamanho diferente do convênio tenha que ser criada uma lógica para pré-formatar o nosso número na hora de gerar o boleto;
      • Para o Banco do Brasil, se a API detectar que o nosso número tem um número de convênio incluso, o convênio informado no campo de convênio vai ser ignorado e vai ser utilizado o convênio do nosso número;
      • Similarmente, se for detectado que o nosso número tem o convênio incluso, vai ser desconsiderada a parte correspondente ao nosso número, e vão ser adicionados zeros à direita o suficiente para que a geração de boleto do ACBr monte o nosso número correto.
    • Documentação do Santander referente a protesto:
      • Nota 25: código para protesto: Código de identificação de tipo de prazo a ser considerado para protesto:

      • Nota 26: Código para Baixa/Devolução: Código de identificação do tipo de procedimento a ser adotado com o título:



     
    Publicados