Conteúdo:

      1. Registro online

Esta implementação tem como objetivo preparar o TOTVS Gestão Financeira para utilizar o serviço de registro online da carteira de cobrança registrada da Caixa Econômica Federal.

      2. Procedimento para configuração

Através do cadastro do Convênio, localizado no menu 'Movimentações Bancárias', é necessário habilitar a opção "Permite registro de boleto online" e definir os parâmetros de acordo com os dados fornecidos pela Caixa Econômica Federal.


    • Permite registro de boleto online: Define se o convênio permite utilizar o registro de boleto online.
    • URL do serviço de registro do boletoDeve ser informada a URL do serviço de registro do boleto disponibilizada pelo banco.


      Conforme detalhado no item 3 deste documento, é possível customizar o dado a ser enviado no registro online. Abaixo, seguem alguns exemplos de cadastro de campo no layout do registro online:

    Campos da seção "HEADER":

    • HEADER.IDPROCESSO 
    • HEADER.USUARIO


    Campos da seção "TITULO":

    • TITULO.NUMERO_DOCUMENTO
    • TITULO.JUROS_MORA.VALOR
    • TITULO.POS_VENCIMENTO.ACAO
    • TITULO.POS_VENCIMENTO.NUMERO_DIAS
    • TITULO.PAGADOR.NOME
    • TITULO.PAGADOR.ENDERECO.LOGRADOURO
    • TITULO.SACADOR_AVALISTA.CNPJ
    • TITULO.MULTA.VALOR
    • TITULO.PAGAMENTO.TIPO
    • TITULO.DESCONTOS.DESCONTO1.VALOR
    • TITULO.FICHA_COMPENSACAO.MENSAGEM1
    • TITULO.RECIBO_PAGADOR.MENSAGEM1
    • TITULO.JUROS_MORA.DATA

    Importante

    • De acordo com o manual da Caixa Econômica Federal, podem ocorrer 3 vezes o desconto, por isso devem ser cadastrados como DESCONTO1, DESCONTO2 e DESCONTO3. O mesmo acontece para as mensagens da ficha de compensação que devem ser cadastradas como MENSAGEM1 e MENSAGEM2, e do recibo do pagador que devem ser cadastradas como MENSAGEM1, MENSAGEM2, MENSAGEM3 e MENSAGEM4. Para os campos de valores ou percentual deve seguir o formato de acordo com o manual disponibilizado pelo banco. Ao definir um valor fixo ou formula deve ser retornado um string com o separador decimal '.' (ponto). Exemplo

      2.49 (para valores, com duas casas decimais )
      1.00035 (para percentuais, com cinco casas decimais)

    • De acordo com o manual da Caixa Econômica Federal é obrigatório a instrução para Protesto/Devolução, portanto devem ser criados os campos TITULO.POS_VENCIMENTO.ACAO e TITULO.POS_VENCIMENTO.NUMERO_DIAS no layout do registro online (anexo do cadastro do banco) e associado um valor fixo e/ou fórmula. Os valores para o campo TITULO.POS_VENCIMENTO.ACAO devem ser PROTESTAR ou DEVOLVER.

    • O campo Data da Multa será calculado a partir da Data de Vencimento do boleto acrescido do parâmetro "Dias de Atraso" configurado na etapa Valor Líquido do lançamento financeiro.
    • Ao utilizar o layout do registro online para customizar o envio dos dados ao banco, ressaltamos a importância de seguir o padrão estabelecido no manual bancário. Ao utilizar algum campo de data, como o campo "TITULO.JUROS_MORA.DATA" para customizar a data dos juros de mora, ao passar uma data diferente do padrão do banco, como "31/07/2025", será retornada uma mensagem por parte do serviço do banco detalhando tecnicamente o motivo pelo qual o boleto não foi registrado online. Exemplo: "The value "31/07/2025" is not a valid value for the "date" datatype.". Para solucionar esta ocorrência, utilize o formato de data 'AAAA-MM-DD'.

          3. Customização de dados no registro online

    Pode ser utilizado o Cadastro de Layout do Registro Online, para enviar dados de forma flexível para o registro online dos boletos para o banco. Para isso deve ser feito o Cadastro de associação de fórmulas e campos do registro online no cadastro do convênio.

    O cadastro do layout do registro online da Caixa Econômica Federal deve ser realizado de acordo com o manual de cobrança online do banco. Demonstramos alguns exemplos de campos no item 2.

    • Sem rótulos