Histórico da Página
Serviço Responsável por calcular uma operação de crédito a partir dos parâmetros de entrada do fluxo normal, ou seja, parcelas e vencimentos calculados conforme método e critério de cálculo. Para fluxo irregular, ou seja, valor das parcelas e vencimentos diferenciados, chamar a API Alterar Operação.
Endpoint:
POST> /tfs-credito-service/rest/calculo/calcularoperacao
Exemplo Body (postman Collection):
{
"valorFinanciado": 100000,
"dataEmissao": "2022-06-28",
"taxaOperacao": 2,
"metodoCalculo": {"name": "PRICE"},
"tipoTaxa": "CAPITALIZADA",
"baseTaxa": "MENSAL",
"tipoPrazo": "CORRIDO",
"formaRenda": "PRE",
"incorporaJuros": false,
"informaIocParcelas": false,
"tributos": [{
"tipo": {"name": "IOC"},
"aliquota": 0.0082,
"aliquotaMaxima": 3,
"aliquotaAdicional": 0.38,
"financia": true,
"periodicidade": "DIARIO",
"base": "PRINCIPAL",
"valorMinimo": 0,
"arredondamento": "BAIXO",
"dataCalculoTributo": "EFETIVA"
}],
"dataPrimeiraAmortizacao": "2022-07-28",
"numeroAmortizacoes": 3,
"tipoPeriodicidade": "MENSAL",
"periodicidadeJuros": 1,
"periodicidadeAmortizacao": 1,
"periodicidadeCarencia": 0,
"periodicidadeCarenciaMinima": 0,
"feriado": "NORMAL",
"inicioCarencia": "EMISSAO",
"tipoAniversario": "CIVIL"
}
Campos identificados no Body de Exemplo:
Campo | Tipo | Tamanho | Obrigatório | Observação |
valorFinanciado | NUMERICO | 10 | SIM | Valor financiado recebido pelo APP |
dataEmissao | DATA | 8 | SIM | Data do sistema ou data do módulo de crédito |
taxaOperacao | NUMERICO | 14,7 | SIM | Taxa de Juros da operação. *Pode buscar a cadastrada de um Plano conforme item (i) abaixo ou informar taxa definida pelo negócio |
metodoCalculo | CHAR | 15 | SIM | Método de Cálculo da operação. *Pode consultar a Modalidade conforme item (ii) ou método definido pelo negócio |
tipoTaxa | CHAR | array | SIM | Tipo de Taxa retornado no Critério de Cálculo item (iii), exemplo CAPITALIZADA *Será definido pelo negócio. |
baseTaxa | CHAR | array | SIM | Base da taxa de juros. *Informar ANUAL |
tipoPrazo | CHAR | array | SIM | Tipo de Taxa retornado no Critério de Cálculo. Exemplo CORRIDO *Será definido pelo negócio. |
formaRenda | CHAR | array | SIM | Forma de Renda retornado no Critério de Cálculo. Exemplo PRE *Será definido pelo negócio. |
incorporaJuros | BOOLEAN | true/false | SIM | Se incorpora juros na primeira parcela *Informar false |
informaIocParcelas | BOOLEAN | true/false | SIM | Se informa o valor tributo nas parcelas *Informar false |
tributos | ||||
tipo | CHAR | 10 | SIM | Tipo de Tributo. Pode consultar um tributo, conforme item (iv) *Informar IOC |
aliquota | NUMERICO | 14,7 | SIM | Alíquota retornada na consulta tributo *Informar 0.0082 |
aliquotaMaxima | NUMERICO | 14,7 | SIM | Alíquota máxima retornada na consulta tributo *Informar 3 |
aliquotaAdicional | NUMERICO | 14,7 | SIM | Alíquota adicional retornada na consulta tributo *Informar 0.38 |
financia | BOOLEAN | true/false | SIM | Marcar se financia ou não, caso financiado, o valor será somado ao valor financiado. *Informar conforme regra de negócio se financia ou não |
periodicidade | CHAR | array | SIM | Peridicidade do cálculo do tributo, retorna na consulta do tributo *Informar DIARIO |
base | CHAR | array | SIM | Base de cálculo do tributo, retorna na consulta do tributo *Informar PRINCIPAL |
valorMinimo | NUMERICO | 18,2 | SIM | Valor mínimo da base de cálculo *Informar 0 |
arredondamento | CHAR | array | SIM | Tipo de arrendamento decimal *Informar BAIXO |
dataCalculoTributo | CHAR | array | SIM | Tipo data base para cálculo, retorna na consulta do tributo *Informar EFETIVA |
dataPrimeiraAmortizacao | DATE | 8 | SIM | Informar a data do vencimento da primeira parcela recebida do APP |
numeroAmortizacoes | NUMERICO | 8 | SIM | Informar o número de parcelas recebida do APP |
tipoPeriodicidade | CHAR | array | SIM | Periodicidade das parcelas. Valores aceitos: MENSAL, DIARIO *Informar MENSAL |
periodicidadeJuros | NUMERICO | 8 | SIM | Periodicidade dos juros, 1=mensal, 2, bimestral, 3=trimestral, 6=semestral *Informar 1 |
periodicidadeAmortizacao | NUMERICO | 8 | SIM | Periodicidade das parcelas, 1=mensal, 2, bimestral, 3=trimestral, 6=semestral *Informar 1 |
periodicidadeCarencia | NUMERICO | 8 | SIM | Periodicidade da carência se houver, 1=mensal, 2, bimestral, 3=trimestral, 6=semestral *Informar 0 |
periodicidadeCarenciaMinima | NUMERICO | 8 | SIM | Periodicidade da carência se houver, mínima, 1=mensal, 2, bimestral, 3=trimestral, 6=semestral *Informar 0 |
feriado | CHAR | SIM | Campo se considera dias não úteis *Informar NORMAL | |
inicioCarencia | CHAR | array | SIM | Período de início da carência *Informar EMISSAO |
tipoAniversario | CHAR | array | SIM | Tipo de ano Base. *Informar CIVIL |
Itens Consulta Domínios e Parâmetros
- Taxa de Juros do Plano
GET> /tfs-credito-service/rest/backoffice/plano/{siglaPlano}
Exemplo:
GET> /tfs-credito-service/rest/backoffice/plano/EMPPFPL001
{
"siglaPlano": "EMPPFPL001",
"descricaoPlano": "PLANO TESTE 001",
"siglaModulo": "EM",
"quantidadePrazoMinimo": 1,
"quantidadePrazoMaximo": 90,
"valorMinimo": 500.00,
"valorMaximo": 260000.00,
"prazoMinimoCarencia": 29,
"prazoMaximoCarencia": 50,
"mesMaisUm": false,
"taxaOperacaoMinima": 1.0000000,
"taxaOperacaoMaxima": 7.0000000,
"taxaOperacaoNormal": 2.0000000,
"numeroPrestacaoMinimo": 1,
"numeroPrestacaoMaximo": 24,
"tipoPessoa": {
"value": "F",
"description": "Física",
"name": "FISICA"
....
- Modalidade
GET> /tfs-credito-service/rest/backoffice/buscarmodalidade/{siglaModalidade}
Exemplo:
GET> /tfs-credito-service/rest/backoffice/buscarmodalidade/EMPDIGI
{
"siglaModalidade": "EMPDIGI",
"descricaoModalidade": "EMPRESTIMO DIGITAL PF",
"contratoEmitido": true,
"naturezaContabil": {
"value": "A",
"description": "Ativo",
"name": "ATIVO"
},
"tipoPessoa": {
"value": "F",
"description": "Física",
"name": "FISICA"
},
"criterioCalculo": {
"siglaModulo": "EM",
"siglaCriterioCalculo": "CAPMESPRE",
"dataInicioValidade": "2001-01-01",
"contratoEfetivado": true
},
"linhaOperacao": {
"codigoUsuarioAtualizador": "SISTEMA ",
"siglaLinhaOperacao": "EMP",
"descricaoLinhaOperacao": "Empréstimo "
},
"produto": {
"siglaProduto": "EMP",
"siglaModulo": "EM",
"descricaoProduto": "EMPRESTIMO",
"linhaOperacao": {
"codigoUsuarioAtualizador": "SISTEMA ",
"siglaLinhaOperacao": "EMP",
"descricaoLinhaOperacao": "Empréstimo "
}
},
"bloqueioCoberturaCobranca": false,
"bloqueioCoberturaFidejussorias": false,
"bloqueioCoberturaFixas": false,
"bloqueioCoberturaOutras": false,
"identificadorCriterioMora": false,
"produtoGerencial": 52511,
"descricaoFinalidade": "",
"descricaoProdutoMercado": "",
"indicador3290": false,
"adlibConsolidado": false,
"indicadorSegundaCurva": false,
"agendamentoLiberacao": false,
"agrupamentoContaCorrente": false,
"alteraEncargo": false,
"alteraLiquidacao": false,
"alteraTarifa": false,
"cessaoAdquirida": false,
"cessaoPassiva": false,
"criticaCic": false,
"calculoMora": "REFAZ",
"validaCotacaoFechamento": false,
"destinacaoAutomatica": false,
"duplaAutorizacao": false,
"liberacaoConta": "LIQUIDO",
"taxaLimite": false,
"exclusiva": false,
"extraLimtie": false,
"tipoFeriado": "POSTECIPA",
"apropriaRetencao": false,
"apropriaTac": "N",
"negociadoMoeda": false,
"tipoAniversario": "CIVIL",
"financiaIoc": true,
"financiaTac": true,
"incorporaJuros": false,
"iofAVista": false,
"incluirIrf": false,
"gestaoCobranca": "N",
"limiteOperacional": {
"codigoUsuarioAtualizador": "FONSECA ",
"siglaLimiteOperacional": "LIMITE "
},
"siglaLinhaGerencial": "EMP",
"siglaMeioLiberacao": "DINHEIRO",
"metodoCalculo": {
"value": "PRICE",
"description": "Price",
"name": "PRICE"
},
"siglaCrediscore": "",
"siglaProdutoFinalidade": "",
"tipoInicioCarencia": "EMISSAO",
"periodicidadeAmortizacao": 1,
"periodicidadeCarencia": 0,
"periodicidadeCarenciaMinima": 1,
"periodicidadeJuros": 1,
"prazoMinimoCarencia": 1,
"prazoMaximoCarencia": 60,
"prazoMinimo": 1,
"prazoMaximo": 70,
"projeto": false,
"valorMinimo": 1.00,
"valorMaximo": 10000000.00,
"identificadorNpc": false,
"encargo": {
"siglaEncargo": "MORA ",
"descricaoEncargo": "PERMANENCIA SOBRE ATRASO 7% "
},
"tributos": [
"tipoTributo": {
"value": "IOC",
"description": "Imposto Operação Financeira",
"name": "IOC"
},
"siglaCriterioTributo": "IOC",
"alteracaoTributo": false
}
],
"legais": [
"codigoEmpresa": 1,
"centralRisco": false,
"ignorarConcessArquivo3050": false,
"ignorarTaxaArquivo3050": false,
"idTaxaProducao": false,
"id3490": false,
"idTaxaRegular": false,
"idEnvioCadastroPositivo": false
}
],
"seguroDfi": false,
"seguroMip": false,
"gestaoRisco": false
}
- Critério de Cálculo
GET> /tfs-credito-service/rest/backoffice/buscarcriteriocalculo/{linhaOperacao}/{modalidade}
Exemplo:
/tfs-credito-service/rest/backoffice/buscarcriteriocalculo/EM/CAPMESPRE
{
"siglaModulo": "EM",
"siglaCriterioCalculo": "CAPMESPRE",
"dataInicioValidade": "2001-01-01",
"contratoEfetivado": true,
"condicaoAniversario": "EMISSAO",
"formaRenda": "PRE",
"formaApropriacao": "CORRIDO",
"tipoPrazo": "CORRIDO",
"tipoTaxa": "CAPITALIZADA",
"proRataMensal": false,
"prazo366AnoBissexto": false
}
- Tributo
/tfs-credito-service/rest/backoffice/tributo/{siglaModalidade}/{dataOperacao}/{unidade}/{fatoGerador}
Exemplo:
GET> /tfs-credito-service/rest/backoffice/tributo/EMPPF/2022-06-28/1/CONTRATACAO
[
{
"tipo": {
"value": "IOC",
"description": "Imposto Operação Financeira",
"name": "IOC"
},
"aliquota": 0.0082000,
"aliquotaMaxima": 8.0000000,
"aliquotaAdicional": 0.3800000,
"periodicidade": "DIARIO",
"base": "PRINCIPAL",
"valorMinimo": 3.00,
"dataCalculoTributo": "EFETIVA",
"alteracaoTributo": true
}
]