Inclusão de Juros
Criado por Igor Ribeiro em 08 de outubro de 2026
Atualizado por Igor Ribeiro em 08 de outubro de 2026
CobrancaInclusaoDeJuros
Esta rotina do módulo Financeiro permite lançar juros sobre um ou mais títulos a receber já cadastrados (dentro do contexto de Cobrança), gerando a movimentação financeira e o respectivo lançamento contábil de juros para esses títulos.
Visão Geral
Esta rotina do módulo Financeiro permite lançar juros sobre um ou mais títulos a receber já cadastrados (dentro do contexto de Cobrança), gerando a movimentação financeira e o respectivo lançamento contábil de juros para esses títulos. É a operação usada quando o usuário precisa registrar cobrança de juros (atraso, negociação, etc.) sobre título(s) já existente(s), sem alterar os demais valores do título.
Endpoints
[POST] /CobrancaInclusaoDeJuros/Salvar
Recebe a lista de títulos a receber selecionados, com o valor de juros informado para cada um, e processa a inclusão desses juros: gera a movimentação financeira (lançamento de juros) e a integração contábil correspondente para cada título informado.
Permissão: “EditViewDeTitulosParaAlteracaoTRECIJ” (ID 1571) — subitem da tela de Cobrança “Cobrança” (ID 1562)
Parâmetros:
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| dto | DTOCabecalhoDeOperacoes (corpo da requisição) | Sim | Cabeçalho da operação; apenas o campo abaixo é utilizado por esta ação |
| dto.TitulosAProcessar | Lista de DTODeTituloAProcessar | Sim (não pode ser vazia) | Lista de títulos a receber sobre os quais o juros será lançado |
| dto.TitulosAProcessar[].ID | Texto | Sim | Identificador do título a receber |
| dto.TitulosAProcessar[].Juros | Número decimal | Condicional | Valor do juros a lançar, na moeda corrente do título. Usado quando “JurosMoeda” não for informado (ou for igual a zero) |
| dto.TitulosAProcessar[].JurosMoeda | Número decimal | Condicional | Valor do juros a lançar, em moeda estrangeira. Quando informado (maior que zero), o sistema converte esse valor para a moeda corrente do título usando a cotação do próprio título |
“` POST /CobrancaInclusaoDeJuros/Salvar { “TitulosAProcessar”: [ { “ID”: “123456”, “Juros”: 15.90, “JurosMoeda”: 0 } ] } “`
“`json { “success”: true, “aviso”: null, “listaDeOperacoesFinanceiras”: [], “listaDeOperacoesContabeis”: [] } “`
[POST] /CobrancaInclusaoDeJuros/Imprimir
Prepara o arquivo padrão do comprovante de operação (“Comprovante.rpt”) para a filial/instalação corrente, copiando-o de um diretório padrão para o diretório de comprovantes específico do cliente, caso ainda não exista. É um passo de apoio à impressão do comprovante da operação de juros (não gera nem retorna o PDF/relatório em si — apenas garante que o modelo de relatório esteja disponível no servidor).
Permissão: coberta pela mesma permissão de acesso “EditViewDeTitulosParaAlteracaoTRECIJ” (ID 1571) — não possui permissão granular própria
Parâmetros: nenhum
“` POST /CobrancaInclusaoDeJuros/Imprimir “`
“`json { “success”: true } “`
Modelos de Dados
DTOCabecalhoDeOperacoes (campos usados por esta rotina)
| Campo | Tipo | Descrição |
|---|---|---|
| TitulosAProcessar | Lista de DTODeTituloAProcessar | Lista dos títulos a receber selecionados para lançamento de juros |
DTODeTituloAProcessar (campos usados por esta rotina)
| Campo | Tipo | Descrição |
|---|---|---|
| ID | Texto | Identificador do título a receber a ser alterado |
| Juros | Número decimal | Valor do juros lançado sobre o título, na moeda corrente do título |
| JurosMoeda | Número decimal | Valor do juros lançado sobre o título, em moeda estrangeira (quando o título for negociado em moeda estrangeira) |
Regras de Negócio
Regra 1 — Cálculo do valor de juros quando informado em moeda estrangeira. Se o valor de “JurosMoeda” informado para o título for maior que zero, o sistema calcula o valor de juros na moeda corrente multiplicando “JurosMoeda” pela cotação do título (“ValorDaCotacao”) e arredondando para 2 casas decimais; o valor em moeda estrangeira lançado é o próprio “JurosMoeda” informado. Caso contrário, tanto o valor em moeda corrente quanto o valor em moeda estrangeira do lançamento recebem o valor informado em “Juros”.
Regra 2 — Determinação da variação do fato contábil por tipo de participante/filial. O sistema identifica automaticamente qual “fato contábil” (regra de lançamento contábil) usar para o juros, com base em três critérios do título: (a) se a filial do título é uma cooperativa; (b) se o participante (cliente) do título é cooperado; e (c) se o tipo de documento do título é um adiantamento (código do tipo de documento iniciado por “AD”). A combinação desses três critérios define a variação contábil aplicada (por exemplo: adiantamento de cooperado, sem variação de não cooperado, adiantamento comum, etc.), o que determina como o juros será refletido na contabilidade.
Regra 3 — Nenhum título informado impede o salvamento. Se a lista de títulos a processar estiver vazia ou não for informada, a operação não é executada.
Regra 4 — Falha ao atualizar dados do boleto híbrido (API) pode interromper ou apenas avisar. Após lançar o juros e integrar contabilmente, o sistema tenta atualizar os dados do boleto híbrido via API para os títulos afetados. Se ocorrer falha nessa atualização, o sistema verifica — de acordo com a rotina de origem da operação — se deve interromper toda a operação (desfazendo o lançamento de juros) ou apenas seguir adiante emitindo um aviso ao usuário informando o(s) título(s) com falha (e, se for o caso, título(s) que já haviam sido baixados anteriormente).
Regra 5 — Erro inesperado durante o processamento é reportado com o detalhe da falha. Qualquer erro não previsto durante o processamento (cálculo, integração contábil ou atualização de boleto) desfaz o lançamento (rollback da transação) e é reportado ao usuário com o detalhe técnico da falha.
Permissões
Acesso à ação: “EditViewDeTitulosParaAlteracaoTRECIJ” (ID 1571) — item do grupo de alteração de títulos a receber, dentro da tela “Cobrança” (ID 1562)
| Ação | Permissão | ID |
|---|---|---|
| Salvar | “EditViewDeTitulosParaAlteracaoTRECIJ” | 1571 |
| Imprimir | coberta por “EditViewDeTitulosParaAlteracaoTRECIJ” | 1571 |
