Loan

The Loan entity is recovered from institutions that support this product. It represents a loan contracted by the user, including data like contract number, taxes, interest rates, warranties, installments, etc.

View as Markdown

The Loan entity is recovered from institutions that support this product. It represents a loan contracted by the user, including data like contract number, taxes, interest rates, warranties, installments, etc.

json
{
  "id": "658f07f1-8349-44cc-9590-e10fe9337060",
  "itemId": "a9e42ebd-bddc-4d59-8895-140d8a809799",
  "contractNumber": "000000721792794",
  "ipocCode": "92792126019929279212650822221989319252576",
  "productName": "Credito Pessoal Consignado",
  "type": "CREDITO_PESSOAL_COM_CONSIGNACAO",
  "kind": "LOAN",
  "date": "2023-07-20T00:00:00.000Z",
  "contractDate": "2022-08-01T00:00:00.000Z",
  "disbursementDates": ["2018-01-15T00:00:00.000Z"],
  "settlementDate": "2018-01-15T00:00:00.000Z",
  "contractAmount": 50000,
  "currencyCode": "BRL",
  "dueDate": "2028-01-15T00:00:00.000Z",
  "installmentPeriodicity": "MONTHLY",
  "installmentPeriodicityAdditionalInfo": "",
  "firstInstallmentDueDate": "2018-02-15T00:00:00.000Z",
  "CET": 0.29,
  "amortizationScheduled": "SAC",
  "amortizationScheduledAdditionalInfo": "",
  "cnpjConsignee": "60.500.998/0001-35",
  "interestRates": [
    {
      "taxType": "EFFECTIVE",
      "interestRateType": "SIMPLE",
      "taxPeriodicity": "YEARLY",
      "calculation": "21/252",
      "referentialRateIndexerType": "PRE_FIXADO",
      "referentialRateIndexerSubType": "TJLP",
      "referentialRateIndexerAdditionalInfo": "",
      "preFixedRate": 0.6,
      "postFixedRate": 0.55,
      "additionalInfo": ""
    }
  ],
  "contractedFees": [
    {
      "name": "Administracao de Operacoes",
      "code": "ADM_OP",
      "chargeType": "UNIQUE",
      "charge": "MINIMUM",
      "amount": 5,
      "rate": 0
    }
  ],
  "contractedFinanceCharges": [
    {
      "type": "IOF_POR_ATRASO",
      "additionalInfo": "",
      "rate": 0.03
    }
  ],
  "warranties": [
    {
      "currencyCode": "BRL",
      "type": "SEM_TIPO_GARANTIA",
      "subtype": "ALIENACAO_FIDUCIARIA",
      "amount": 500
    }
  ],
  "installments": {
    "typeNumberOfInstallments": "MONTH",
    "totalNumberOfInstallments": 120,
    "typeContractRemaining": "MONTH",
    "contractRemainingNumber": 55,
    "paidInstallments": 65,
    "dueInstallments": 55,
    "pastDueInstallments": 0,
    "balloonPayments": []
  },
  "payments": {
    "contractOutstandingBalance": 25000,
    "releases": [
      {
        "isOverParcelPayment": false,
        "installmentId": "b1f0a5b4-1234-5678-9abc-def012345678",
        "paidDate": "2023-07-15T00:00:00.000Z",
        "currencyCode": "BRL",
        "paidAmount": 680.5,
        "overParcel": {
          "fees": [],
          "charges": []
        }
      }
    ]
  }
}
PropertyTypeOptionalDescription
idstringNoPrimary identifier
itemIdstringNoIdentifier of the item linked to the loan
contractNumberstringYesContract number given by the contracting institution
ipocCodestringYesStandard contract number - IPOC (Identificação Padronizada da Operação de Crédito)
productNamestringNoDenomination/Identification of the name of the credit operation disclosed to the customer
typestringYesLoan type (Open Finance definition)
kindstringNoCredit-operation family this contract belongs to. One of LOAN, FINANCING, INVOICE_FINANCING, UNARRANGED_ACCOUNT_OVERDRAFT.
datestringNoDate when the loan data was collected
contractDatestringYesDate when the loan was contracted
disbursementDatesstring[]YesDisbursement date of the contracted amount
settlementDatestringYesLoan settlement date
contractAmountnumberYesLoan contracted value
currencyCodestringNoCode referencing the currency of the loan
dueDatestringYesLoan due date
installmentPeriodicitystringYesInstallments regular frequency. One of the installment periodicity values.
installmentPeriodicityAdditionalInfostringYesMandatory field to complement the information regarding the regular payment frequency when installmentPeriodicity has value 'OTHERS'
firstInstallmentDueDatestringYesFirst installment due date
CETnumberYesCET - Custo Efetivo Total must be expressed as an annual percentage rate and incorporates all charges and expenses incurred in credit operations (interest rate, but also tariffs, taxes, insurance and other expenses charged)
amortizationScheduledstringYesAmortization system (Open Finance definition). One of the amortization system values.
amortizationScheduledAdditionalInfostringYesMandatory field to complement the information regarding the scheduled amortization when it has value 'OTHERS'
cnpjConsigneestringYesConsignor CNPJ
interestRatesarray of LoanInterestRateYesInterest rates applied to the contract.
contractedFeesarray of LoanContractedFeeYesList that brings the information of the tariffs agreed in the contract.
contractedFinanceChargesarray of LoanContractedFinanceChargeYesList that brings the charges agreed in the contract
warrantiesarray of LoanWarrantyYesWarranties that guarantee the credit operation.
installmentsLoanInstallmentsYesRemaining term and installments of the operation.
paymentsLoanPaymentsYesLoan contract payment data

See LoanAPI in our API reference for more information.

Loan installment periodicity#

Installments regular frequency

  • WITHOUT_REGULAR_PERIODICITY
  • WEEKLY
  • FORTNIGHTLY
  • MONTHLY
  • BIMONTHLY
  • QUARTERLY
  • SEMESTERLY
  • YEARLY
  • OTHERS

Loan amortization system#

Amortization system (Open Finance definition)

  • SAC
  • PRICE
  • SAM
  • WITHOUT_AMORTIZATION_SYSTEM
  • OTHERS

Loan interest rate#

PropertyTypeOptionalDescription
taxTypestringYesTax type. One of the tax type values.
interestRateTypestringYesInterest rate type. One of the interest rate type values.
taxPeriodicitystringYesTax periodicity. One of the tax periodicity values.
calculationstringYesCalculation basis
referentialRateIndexerTypestringYesTypes of benchmark rates or indexers (Open Finance definition)
referentialRateIndexerSubTypestringYesSubtypes of benchmark rates or indexers (Open Finance definition)
referentialRateIndexerAdditionalInfostringYesFree field to complement the information regarding the Type of reference rate or indexer
preFixedRatenumberYesPre-fixed rate applied under the credit modality contract. 1 = 100%
postFixedRatenumberYesPost-fixed rate applied under the credit modality contract. 1 = 100%
additionalInfostringYesText with additional information on the composition of agreed interest rates

Loan tax type#

  • NOMINAL
  • EFFECTIVE

Loan interest rate type#

  • SIMPLE
  • COMPOUND

Loan tax periodicity#

  • MONTHLY
  • YEARLY

Loan contracted fee#

PropertyTypeOptionalDescription
namestringYesAgreed rate denomination
codestringYesAcronym identifying the agreed rate
chargeTypestringYesCharge type for the rate agreed in the contract. One of the charge type values.
chargestringYesBilling method related to the tariff agreed in the contract. One of the charge values.
amountnumberYesMonetary value of the tariff agreed in the contract
ratenumberYesRate value in percentage agreed in the contract

Contracted fee charge type#

Charge type for the rate agreed in the contract

  • UNIQUE
  • BY_INSTALLMENT

Contracted fee charge#

Billing method related to the tariff agreed in the contract

  • MINIMUM
  • MAXIMUM
  • FIXED
  • PERCENTAGE

Loan contracted finance charge#

PropertyTypeOptionalDescription
typestringYesCharge type agreed in the contract (Open Finance definition)
additionalInfostringYesField for additional information
ratenumberYesCharge value in percentage agreed in the contract

Loan warranty#

PropertyTypeOptionalDescription
currencyCodestringYesCode referencing the currency of the warranty
typestringYesDenomination / Identification of the type of warranty that guarantees the Type of Credit Operation contracted (Open Finance definition)
subtypestringYesDenomination / Identification of the subtype of warranty that guarantees the Type of Credit Operation contracted (Open Finance definition)
amountnumberYesWarranty original value

Loan installments#

PropertyTypeOptionalDescription
typeNumberOfInstallmentsstringYesType of total term of the contract referring to the type of credit informed. One of the number of installments values.
totalNumberOfInstallmentsnumberYesTotal term according to the type referring to the type of credit informed
typeContractRemainingstringYesType of remaining term of the contract referring to the type of credit informed. One of the type contract remaining values.
contractRemainingNumbernumberYesRemaining term according to the type referring to the credit type informed
paidInstallmentsnumberYesNumber of paid installments
dueInstallmentsnumberYesNumber of due installments
pastDueInstallmentsnumberYesNumber of overdue installments
balloonPaymentsarray of LoanInstallmentBalloonPaymentYesList that brings the due dates and value of the non-regular installments of the contract of the type of credit consulted

Number of installments#

Type of total term of the contract referring to the type of credit informed

  • DAY
  • WEEK
  • MONTH
  • YEAR
  • WITHOUT_TOTAL_PERIOD

Type contract remaining#

Type of remaining term of the contract referring to the type of credit informed

  • DAY
  • WEEK
  • MONTH
  • YEAR
  • WITHOUT_TOTAL_PERIOD
  • WITHOUT_REMAINING_PERIOD

Loan balloon payment#

PropertyTypeOptionalDescription
dueDatestringYesExpiration date of the non-regular installment to expire from the contract of the consulted credit modality
amountLoanInstallmentBalloonPaymentAmountYes

Balloon payment amount#

PropertyTypeOptionalDescription
valuenumberYesMonetary value of the non-regular installment due
currencyCodestringYesCode referencing the currency of the installment

Loan payments#

PropertyTypeOptionalDescription
contractOutstandingBalancenumberYesAmount required for the customer to settle the debt
releasesarray of LoanPaymentReleaseYesList of payments made in the period

Loan payment release#

PropertyTypeOptionalDescription
isOverParcelPaymentbooleanYesIdentifies whether it is an agreed payment (false) or a one-time payment (true)
installmentIdstringYesInstallment identifier, responsibility of each transmitting Institution
paidDatestringYesEffective date of payment referring to the contract of the credit modality consulted
currencyCodestringYesCode referencing the currency of the payment
paidAmountnumberYesPayment amount referring to the contract of the credit modality consulted
overParcelLoanPaymentReleaseOverParcelYes

Loan payment over parcel#

PropertyTypeOptionalDescription
feesarray of LoanPaymentReleaseOverParcelFeeYesList of fees that were paid outside the installment, only for single payment
chargesarray of LoanPaymentReleaseOverParcelChargeYesList of charges that were paid out of installment

Over parcel fee#

PropertyTypeOptionalDescription
namestringYesDenomination of the agreed rate
codestringYesAcronym identifying the agreed rate
amountnumberYesMonetary value of the tariff agreed in the contract

Over parcel charge#

PropertyTypeOptionalDescription
typestringYesCharge type agreed in the contract (Open Finance definition)
additionalInfostringYesFree field to fill in additional information regarding the charge
amountnumberYesPayment amount of the charge paid outside the installment
Was this page helpful?