Criar Proposta

Cria uma nova proposta de empréstimo com base em uma simulação previamente realizada. A proposta consolida todos os dados financeiros que serão utilizados na formalização do contrato.

Dados necessários

Campo	Tipo	Obrigatório	Descrição
simulationId	integer	Não	ID da simulação de referência
employmentRelationshipId	integer	Não	ID do vínculo empregatício
loanAmount	decimal	Sim	Valor do empréstimo em reais
financedAmount	decimal	Sim	Valor financiado em reais (principal + juros + encargos)
totalInterestAmount	decimal	Sim	Valor total de juros em reais
monthlyInterestRate	decimal	Sim	Taxa de juros mensal (%)
monthlyEffectiveCost	decimal	Sim	CET mensal (%)
annualEffectiveCost	decimal	Sim	CET anual (%)
disbursementAmount	decimal	Sim	Valor líquido a receber pelo trabalhador
insuranceAmount	decimal	Sim	Valor do seguro prestamista
iofAmount	decimal	Sim	Valor total de IOF
tacAmount	decimal	Sim	TAC (Taxa de Abertura de Crédito)
installmentCount	integer	Sim	Número de parcelas
dueDate	string	Sim	Data de vencimento da primeira parcela

Os valores financeiros devem ser consistentes com a simulação de referência. Divergências significativas podem resultar em rejeição da proposta.

Próximo passo

Com a proposta criada, prossiga para Criar Contrato utilizando o proposalId retornado.

Criar Proposta

post

https://consignado.staging.giro.techhttps://consignado.giro.tech

/api/v1/originator/employees/{publicId}/proposals

Cria uma nova proposta de empréstimo

Autorizações

BearerAuth

AuthorizationstringObrigatório

JWT token fornecido pelo administrador

Parâmetros de rota

publicIdstringObrigatório

Public ID do employee

Corpo

application/json

simulationIdinteger · int64Opcional

employmentRelationshipIdinteger · int64Opcional

loanAmountnumber · decimal · mín: 0.01Obrigatório

Valor do empréstimo em reais (decimal com 2 casas decimais).

financedAmountnumber · decimal · mín: 0.01Obrigatório

Valor financiado em reais (decimal com 2 casas decimais).

totalInterestAmountnumber · decimalObrigatório

Juros totais em reais (decimal com 2 casas decimais).

monthlyInterestRatenumber · decimalObrigatório

Taxa de juros mensal em percentual (decimal com 4 casas decimais).

monthlyEffectiveCostnumber · decimalObrigatório

CET mensal em percentual (decimal com 4 casas decimais).

annualEffectiveCostnumber · decimalObrigatório

CET anual em percentual (decimal com 4 casas decimais).

disbursementAmountnumber · decimalObrigatório

Valor a desembolsar em reais (decimal com 2 casas decimais).

insuranceAmountnumber · decimalObrigatório

Valor do seguro em reais (decimal com 2 casas decimais).

iofAmountnumber · decimalObrigatório

IOF em reais (decimal com 2 casas decimais).

tacAmountnumber · decimalObrigatório

TAC em reais (decimal com 2 casas decimais).

installmentCountinteger · mín: 1Obrigatório

dueDatestring · dateObrigatório

Respostas

201

Proposta criada com sucesso

application/json

400

Dados inválidos

401

Não autenticado

403

Permissão insuficiente

post

/api/v1/originator/employees/{publicId}/proposals

HTTPcURLJavaScriptPython

POST /api/v1/originator/employees/{publicId}/proposals HTTP/1.1
Host: consignado.staging.giro.tech
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 307

{
  "simulationId": 1,
  "loanAmount": 5750,
  "financedAmount": 7125.36,
  "totalInterestAmount": 1189.72,
  "monthlyInterestRate": 1.97,
  "monthlyEffectiveCost": 2.43,
  "annualEffectiveCost": 33.18,
  "disbursementAmount": 5627.78,
  "insuranceAmount": 87.3,
  "iofAmount": 63.42,
  "tacAmount": 34.92,
  "installmentCount": 12,
  "dueDate": "2024-04-25"
}

{
  "id": 23,
  "publicId": "Kj8mP2xQ9nR4sT6v",
  "employeeId": 15,
  "simulationId": 42,
  "loanAmount": 5750,
  "financedAmount": 5935.64,
  "totalInterestAmount": 1189.72,
  "monthlyInterestRate": 1.97,
  "monthlyEffectiveCost": 2.43,
  "annualEffectiveCost": 33.18,
  "disbursementAmount": 5627.78,
  "insuranceAmount": 87.3,
  "iofAmount": 63.42,
  "tacAmount": 34.92,
  "outstandingBalance": 7125.36,
  "installmentCount": 12,
  "dueDate": "2024-04-25",
  "status": "PENDING",
  "expiresAt": "2024-02-08T10:00:00Z",
  "installments": [
    {
      "number": 1,
      "amount": 593.78,
      "dueDate": "2024-04-25"
    }
  ],
  "createdDate": "2024-02-01T10:00:00Z"
}

Central de Atendimento | Giro.TechGiro.Tech