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 boleto: Deve 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.





