Início / Documentação / Referência técnica / Catálogo de operações / Price / Payload e campos
amortizationType PriceCCB
Tipo de operação · Price
Price — Payload e campos Quais campos envio em cada objeto.
Campos do cálculo São 20 campos no total, 4 obrigatório(s), organizados da base comum até o que é exclusivo deste tipo. Só o que se aplica a ele aparece aqui.
Identificação, início e taxa Campo Tipo Obrigatório Descrição Valores Exemplo idstring (uuid)opcional — — "3fa85f64-5717-4562-b3fc-2c963f66afa6"amortizationTypestringopcional Indica o tipo de tabela de amortização utilizada — "texto"startDatestring (date-time)opcional Data de início — "2025-08-11T13:45:00Z"includePaymentFixedCostsbooleanopcional Incluir valor da parcela fixa na simulação — truevalidationErrorsarray de objetoopcional — objeto — ver detalhe abaixo [ … ]agentCommissionsarray de objetoopcional Comissões devidas ao CORBAN/Parceiro originador da operação. Utilizado para compor o Custo de Emissão (TAC), observados os limites estabelecidos no produto objeto — ver detalhe abaixo [ … ]agentCommissionobjetoopcional — objeto — ver detalhe abaixo { … }
Valor, IOF e indexador Campo Tipo Obrigatório Descrição Valores Exemplo requestedAmountinteger (int64)opcional Valor solicitado — 0financeTaxExemptedbooleanopcional Isenção de IOF — truefiduciaryGuaranteenumber (double)opcional Percentual de Garantia fiduciária — 1000indexerstringopcional Indexador Pós-Fixado que deve ser aplicado à cada parcela — "texto"indexerValuenumber (double)opcional Percentual Indexador Pós-fixado que deve ser aplicado à cada parcela — 1000
Forma de cálculo do valor Campo Tipo Obrigatório Descrição Valores Exemplo calculateByValueTypestringopcional — Gross, Liquid, Payment"Gross"
Cronograma por data da primeira parcela exclusivo deste tipo Campo Tipo Obrigatório Descrição Valores Exemplo firstPaymentDatestring (date-time)obrigatório Data de início — "2025-08-11T13:45:00Z"numberOfPaymentsintegerobrigatório Número de parcelas — 0numberOfInterestPaymentsintegeropcional Parcelas de pagamento de juros — 0aprnumber (double)opcional Taxa de Juros em base mensal — 1.99calculationTypestringobrigatório — V252DiasUteis, V252MesesX21, V360DiasCorridos, V360Meses, V365DiasCorridos, V365Meses, Irregular"V252DiasUteis"dueDateOnBusinessDaysbooleanopcional Datas de vencimento são ajustadas para o próximo dia útil — truepaymentPeriodicityobjetoobrigatório — objeto — ver detalhe abaixo { … }
Regras e valores aceitos Os campos abaixo aceitam um conjunto fechado de valores. A lista é a do contrato para este tipo — outros tipos podem aceitar conjuntos diferentes.
calculateByValueTypeValor Significado GrossValor bruto - O valor de principal informado será considerado o valor de face da dívida emitida, sem realizar o financiamento das tarifas (TACs e IOF). O valor líquido final será menor que o valor do principal. LiquidValor líquido - O valor de principal informado será considerado o valor líquido final desejado pelo tomador. Para tanto, será realizado o financiamento das tarifas (TACs e IOF), majorando o valor de face da dívida emitida. PaymentValor da parcela - o valor da parcela que será pago pelo cliente em cada vencimento. Só é válido para cálculos do tipo PRICE
calculationTypeValor Significado V252DiasUteisV252 Dias Uteis V252MesesX21V252 Meses X21 V360DiasCorridosV360 Dias Corridos V360MesesV360 Meses V365DiasCorridosV365 Dias Corridos V365MesesV365 Meses IrregularIrregular
Exemplo de objeto de cálculo Gerado do contrato. Valores são amostras: troque pelos dados reais da operação.
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"amortizationType": "texto",
"startDate": "2025-08-11T13:45:00Z",
"apr": 1.99,
"includePaymentFixedCosts": true,
"validationErrors": [
{
"memberNames": [
"Fulano de Tal"
],
"errorMessage": "texto"
}
],
"agentCommissions": [
{
"name": "Fulano de Tal",
"amount": 1000,
"type": "Absolute",
"baseValue": "InitialValue",
"chargeCommissionFrom": "All",
"financeCost": true
}
],
"agentCommission": {
"name": "Fulano de Tal",
"amount": 1000,
"type": "Absolute",
"baseValue": "InitialValue",
"chargeCommissionFrom": "All",
"financeCost": true,
"totalValue": 0
},
"requestedAmount": 0,
"financeTaxExempted": true,
"fiduciaryGuarantee": 1000,
"indexer": "texto",
"indexerValue": 1000,
"calculateByValueType": "Gross",
"firstPaymentDate": "2025-08-11T13:45:00Z",
"numberOfPayments": 0,
"numberOfInterestPayments": 0,
"calculationType": "V252DiasUteis",
"dueDateOnBusinessDays": true,
"paymentPeriodicity": {
"every": 0,
"periodicity": "Monthly"
}
}Campos da garantia A garantia vai na lista warranty do mesmo corpo de criação, ao lado do objeto de cálculo. Cada item leva o discriminador warrantyType, e uma operação pode ter mais de uma garantia.
Crédito do Trabalhador — DataprevEmployee Consignado privado (crédito do trabalhador): margem consignável do vínculo empregatício, com dados do empregador, competência de início de desconto e autorização da CTPS digital. Pode incluir saldo e multa rescisória do FGTS como reforço de garantia.
Averbação: DataPrevCreditoTrabalhador. A operação passa pela etapa de garantia aguardando o retorno do órgão averbador antes de seguir na esteira.
Tipo de garantia Campo Tipo Obrigatório Descrição Valores Exemplo warrantyTypestringopcional — Warranty, Vehicle, HomeEquity, JudiciaryProcess, Factoring, PublicPayroll, InvoiceFactoring, Consortium, DataprevEmployee, Load, DataprevEmployeeRefinance, CarEquity, DataprevInss, BenefitCardRegistration"Warranty"
Vínculo e valor da margem Campo Tipo Obrigatório Descrição Valores Exemplo employeeCodestringopcional — — "texto"admissionDatestring (date-time)opcional — — "2025-08-11T13:45:00Z"
Vínculo empregatício e margem consignável Campo Tipo Obrigatório Descrição Valores Exemplo dataprev_EmployeeCodestringobrigatório Matrícula do trabalhador — "texto"dataprev_EmployerRegistrationCodeintegerobrigatório Código de inscrição do empregador — 0dataprev_EmployerNamestringobrigatório Nome do empregador — "Fulano de Tal"dataprev_EmployerRegistrationNumberstringobrigatório Número inscrição do Empregador — "texto"dataprev_DiscountStartPeriodstringobrigatório Competência início de desconto — "texto"dataprev_OriginalMarginnumber (double)opcional Valor original da margem consignável — 1000dataprev_EmployeePositionCBOCodeintegeropcional CBO - Classificação Brasileira de Ocupações — 0dataprev_EmployeeAdmissionDatestring (date-time)obrigatório Data de admissão do trabalhador — "2025-08-11T13:45:00Z"dataprev_HasWarrantybooleanopcional Indica se o contrato utiliza garantias do FGTS (Solução de Garantias - Manual 003). Campo temGarantias. — truedataprev_WarrantyFgtsBalanceInCentsinteger (int64)opcional Saldo FGTS oferecido como garantia, em centavos. Campo valorSaldoDisponivelGarantiaFgts
vem em reais (NÚMERO 10,2) e é convertido para centavos na escrita. — 0dataprev_WarrantyFgtsRescissionPenaltyInCentsinteger (int64)opcional Multa rescisória FGTS oferecida como garantia, em centavos. Campo valorMultaRescisoriaGarantiaFgts
vem em reais (NÚMERO 10,2) e é convertido para centavos na escrita. — 0dataprev_WarrantyRescissionBenefitPercentagenumber (double)opcional Percentual da verba rescisória para garantia, até 35%. Campo percVerbaRescisoriaGarantia (NÚMERO 3,2). — 1.99dataprev_CtpsDigitalAuthorizationNumberstringopcional Número da autorização da CTPS Digital. Campo numeroAutorizacaoCtpsDigital. — "texto"dataprev_ProposalNumberstringopcional Número da proposta do leilão (proposalNumber). Nulo em operações internas. — "texto"totalValuenumber (double)obrigatório Valor da margem — 1000
warrantyTypeValor Significado WarrantyGarantia VehicleVeículo HomeEquityImóvel JudiciaryProcessProcesso Judicial FactoringAntecipação de recebíveis PublicPayrollConsignado Público InvoiceFactoringDesconto de duplicatas ConsortiumConsórcio DataprevEmployeeCrédito do Trabalhador LoadCarga DataprevEmployeeRefinanceCrédito Trabalhador Refinanciamento CarEquityCar Equity DataprevInssConsignado INSS BenefitCardRegistrationRegistro de Cartão de Benefício
Consultas e ofertas próprias deste lastro Use antes de criar a operação, para obter margem, ficha do bem ou ofertas elegíveis.
POST /v{version}/Amortization/DataprevEmployeeOffersCria um novo registro de Amortization. Exemplo do objeto de garantia {
"warrantyType": "Warranty",
"employeeCode": "texto",
"admissionDate": "2025-08-11T13:45:00Z",
"totalValue": 1000,
"dataprev_EmployeeCode": "texto",
"dataprev_EmployerRegistrationCode": 0,
"dataprev_EmployerName": "Fulano de Tal",
"dataprev_EmployerRegistrationNumber": "texto",
"dataprev_DiscountStartPeriod": "texto",
"dataprev_OriginalMargin": 1000,
"dataprev_EmployeePositionCBOCode": 0,
"dataprev_EmployeeAdmissionDate": "2025-08-11T13:45:00Z",
"dataprev_HasWarranty": true,
"dataprev_WarrantyFgtsBalanceInCents": 0,
"dataprev_WarrantyFgtsRescissionPenaltyInCents": 0,
"dataprev_WarrantyRescissionBenefitPercentage": 1.99,
"dataprev_CtpsDigitalAuthorizationNumber": "texto",
"dataprev_ProposalNumber": "texto"
}Abrir o guia deste produto
Crédito Trabalhador Refinanciamento — DataprevEmployeeRefinance Refinanciamento do Consignado privado: mesma estrutura de margem e vínculo do contrato original, aplicada à substituição de contrato vigente.
Averbação: DataPrevCreditoTrabalhador. A operação passa pela etapa de garantia aguardando o retorno do órgão averbador antes de seguir na esteira.
Tipo de garantia Campo Tipo Obrigatório Descrição Valores Exemplo warrantyTypestringopcional — Warranty, Vehicle, HomeEquity, JudiciaryProcess, Factoring, PublicPayroll, InvoiceFactoring, Consortium, DataprevEmployee, Load, DataprevEmployeeRefinance, CarEquity, DataprevInss, BenefitCardRegistration"Warranty"
Vínculo e valor da margem Campo Tipo Obrigatório Descrição Valores Exemplo employeeCodestringopcional — — "texto"admissionDatestring (date-time)opcional — — "2025-08-11T13:45:00Z"
Vínculo empregatício e margem consignável Campo Tipo Obrigatório Descrição Valores Exemplo dataprev_EmployeeCodestringobrigatório Matrícula do trabalhador — "texto"dataprev_EmployerRegistrationCodeintegerobrigatório Código de inscrição do empregador — 0dataprev_EmployerNamestringobrigatório Nome do empregador — "Fulano de Tal"dataprev_EmployerRegistrationNumberstringobrigatório Número inscrição do Empregador — "texto"dataprev_DiscountStartPeriodstringobrigatório Competência início de desconto — "texto"dataprev_OriginalMarginnumber (double)opcional Valor original da margem consignável — 1000dataprev_EmployeePositionCBOCodeintegeropcional CBO - Classificação Brasileira de Ocupações — 0dataprev_EmployeeAdmissionDatestring (date-time)obrigatório Data de admissão do trabalhador — "2025-08-11T13:45:00Z"dataprev_HasWarrantybooleanopcional Indica se o contrato utiliza garantias do FGTS (Solução de Garantias - Manual 003). Campo temGarantias. — truedataprev_WarrantyFgtsBalanceInCentsinteger (int64)opcional Saldo FGTS oferecido como garantia, em centavos. Campo valorSaldoDisponivelGarantiaFgts
vem em reais (NÚMERO 10,2) e é convertido para centavos na escrita. — 0dataprev_WarrantyFgtsRescissionPenaltyInCentsinteger (int64)opcional Multa rescisória FGTS oferecida como garantia, em centavos. Campo valorMultaRescisoriaGarantiaFgts
vem em reais (NÚMERO 10,2) e é convertido para centavos na escrita. — 0dataprev_WarrantyRescissionBenefitPercentagenumber (double)opcional Percentual da verba rescisória para garantia, até 35%. Campo percVerbaRescisoriaGarantia (NÚMERO 3,2). — 1.99dataprev_CtpsDigitalAuthorizationNumberstringopcional Número da autorização da CTPS Digital. Campo numeroAutorizacaoCtpsDigital. — "texto"dataprev_ProposalNumberstringopcional Número da proposta do leilão (proposalNumber). Nulo em operações internas. — "texto"totalValuenumber (double)obrigatório Valor da margem — 1000
warrantyTypeValor Significado WarrantyGarantia VehicleVeículo HomeEquityImóvel JudiciaryProcessProcesso Judicial FactoringAntecipação de recebíveis PublicPayrollConsignado Público InvoiceFactoringDesconto de duplicatas ConsortiumConsórcio DataprevEmployeeCrédito do Trabalhador LoadCarga DataprevEmployeeRefinanceCrédito Trabalhador Refinanciamento CarEquityCar Equity DataprevInssConsignado INSS BenefitCardRegistrationRegistro de Cartão de Benefício
Consultas e ofertas próprias deste lastro Use antes de criar a operação, para obter margem, ficha do bem ou ofertas elegíveis.
POST /v{version}/Amortization/DataprevEmployeeOffersCria um novo registro de Amortization. Exemplo do objeto de garantia {
"warrantyType": "Warranty",
"employeeCode": "texto",
"admissionDate": "2025-08-11T13:45:00Z",
"totalValue": 1000,
"dataprev_EmployeeCode": "texto",
"dataprev_EmployerRegistrationCode": 0,
"dataprev_EmployerName": "Fulano de Tal",
"dataprev_EmployerRegistrationNumber": "texto",
"dataprev_DiscountStartPeriod": "texto",
"dataprev_OriginalMargin": 1000,
"dataprev_EmployeePositionCBOCode": 0,
"dataprev_EmployeeAdmissionDate": "2025-08-11T13:45:00Z",
"dataprev_HasWarranty": true,
"dataprev_WarrantyFgtsBalanceInCents": 0,
"dataprev_WarrantyFgtsRescissionPenaltyInCents": 0,
"dataprev_WarrantyRescissionBenefitPercentage": 1.99,
"dataprev_CtpsDigitalAuthorizationNumber": "texto",
"dataprev_ProposalNumber": "texto"
}Abrir o guia deste produto
Consignado INSS — DataprevInss INSS: margem consignável do benefício previdenciário. Traz número e espécie do benefício, conta de pagamento, margem disponível, prazo máximo e o resultado do crivo de elegibilidade.
Averbação: SemearInss. A operação passa pela etapa de garantia aguardando o retorno do órgão averbador antes de seguir na esteira.
Tipo de garantia Campo Tipo Obrigatório Descrição Valores Exemplo warrantyTypestringopcional — Warranty, Vehicle, HomeEquity, JudiciaryProcess, Factoring, PublicPayroll, InvoiceFactoring, Consortium, DataprevEmployee, Load, DataprevEmployeeRefinance, CarEquity, DataprevInss, BenefitCardRegistration"Warranty"
Vínculo e valor da margem Campo Tipo Obrigatório Descrição Valores Exemplo employeeCodestringopcional — — "texto"admissionDatestring (date-time)opcional — — "2025-08-11T13:45:00Z"totalValuenumber (double)opcional Valor total — 1000
Benefício INSS e margem Campo Tipo Obrigatório Descrição Valores Exemplo inss_RegistrationNumberstringopcional CPF do beneficiário (11 dígitos). — "texto"inss_BenefitNumberstringopcional Número do benefício (NB). — "texto"inss_Namestringopcional Nome do beneficiário. — "Fulano de Tal"inss_BenefitTypestringopcional Espécie do benefício. — "texto"inss_BenefitTypeDescriptionstringopcional Descrição da espécie do benefício. — "texto"inss_PaymentAccountTypestringopcional Tipo da conta bancária. — "texto"inss_PaymentAccountTypeDescriptionstringopcional Descrição do tipo da conta bancária. — "texto"inss_PaymentBankCodestringopcional Código do banco pagador. — "texto"inss_PaymentBankAgencystringopcional Agência bancária. — "texto"inss_PaymentBankAccountNumberstringopcional Número da conta bancária. — "texto"inss_AvailableMarginnumber (double)opcional Margem consignável disponível. — 1000inss_OriginalMarginnumber (double)opcional Margem consignável original. — 1000inss_MarginValuenumber (double)opcional Margem consignável utilizada na averbação. — 1000inss_MaximumInstallmentsintegeropcional Prazo máximo permitido. — 0inss_IsIneligiblebooleanopcional Indica se o beneficiário é inelegível (resultado do crivo, vindo da consulta de margem). — trueinss_IneligibilityReasonstringopcional Motivo da inelegibilidade do beneficiário. — "texto"
warrantyTypeValor Significado WarrantyGarantia VehicleVeículo HomeEquityImóvel JudiciaryProcessProcesso Judicial FactoringAntecipação de recebíveis PublicPayrollConsignado Público InvoiceFactoringDesconto de duplicatas ConsortiumConsórcio DataprevEmployeeCrédito do Trabalhador LoadCarga DataprevEmployeeRefinanceCrédito Trabalhador Refinanciamento CarEquityCar Equity DataprevInssConsignado INSS BenefitCardRegistrationRegistro de Cartão de Benefício
Consultas e ofertas próprias deste lastro Use antes de criar a operação, para obter margem, ficha do bem ou ofertas elegíveis.
POST /v{version}/Amortization/InssOffersCria um novo registro de Amortization. Exemplo do objeto de garantia {
"warrantyType": "Warranty",
"employeeCode": "texto",
"admissionDate": "2025-08-11T13:45:00Z",
"totalValue": 1000,
"inss_RegistrationNumber": "texto",
"inss_BenefitNumber": "texto",
"inss_Name": "Fulano de Tal",
"inss_BenefitType": "texto",
"inss_BenefitTypeDescription": "texto",
"inss_PaymentAccountType": "texto",
"inss_PaymentAccountTypeDescription": "texto",
"inss_PaymentBankCode": "texto",
"inss_PaymentBankAgency": "texto",
"inss_PaymentBankAccountNumber": "texto",
"inss_AvailableMargin": 1000,
"inss_OriginalMargin": 1000,
"inss_MarginValue": 1000,
"inss_MaximumInstallments": 0,
"inss_IsIneligible": true,
"inss_IneligibilityReason": "texto"
}Consignado Público — PublicPayroll Consignado público: averbação da margem do servidor no órgão empregador. Traz matrícula, código do órgão, código de averbação, dia do repasse, situação funcional e prazo limite de averbação.
Averbação: Siape. A operação passa pela etapa de garantia aguardando o retorno do órgão averbador antes de seguir na esteira.
Tipo de garantia Campo Tipo Obrigatório Descrição Valores Exemplo warrantyTypestringopcional — Warranty, Vehicle, HomeEquity, JudiciaryProcess, Factoring, PublicPayroll, InvoiceFactoring, Consortium, DataprevEmployee, Load, DataprevEmployeeRefinance, CarEquity, DataprevInss, BenefitCardRegistration"Warranty"
Averbação no órgão público Campo Tipo Obrigatório Descrição Valores Exemplo employeeCodestringopcional Código da Matrícula — "texto"agreementCodestringopcional Código do Convênio — "texto"governmentDepartmentCodestringopcional Código do Orgão — "texto"employeerInstCodestringopcional Órgão + Matrícula do Instituidor — "texto"warrantyCodestringopcional Código de averbação — "texto"paymentTransferDayintegeropcional Dia do repasse — 0paymentAmountInCentsinteger (int64)opcional Valor da Margem — 0employmentStatusCodestringopcional Código do tipo da situação funcional do vínculo funcional — "texto"employmentStatusDescriptionstringopcional Descrição do tipo da situação funcional do vínculo funcional — "texto"previousAdeNumberstringopcional Número ADE anterior — "texto"warrantyDeadlinestring (date-time)opcional Data limite de averbação — "2025-08-11T13:45:00Z"warrantyOptionstringopcional — None, FreeMargin, Portability, Peculio"None"simulationRegistrationNumberstringopcional — — "texto"termInMonthsintegeropcional Prazo — 0adeIdentifierstringopcional Ade identificador da operação na zetra — "texto"governmentDepartmentWarrantyStatusstringopcional — WaitingPurchase, WaitingBalance, WaitingPayment, WaitingLiquidation, Finished, Error, Deleted, Unified, WaitingForApproval, WaitingForPortedContractClosure, ConsentRefused, Canceled, PaymentRejection"WaitingPurchase"governmentDepartmentWarrantyStatusDisplaystringopcional Descrição da situação — "texto"payingSourceRegistrationNumberstringopcional — — "texto"payingSourceNamestringopcional Nome da Fonte Pagadora — "Fulano de Tal"
governmentDepartmentWarrantyStatusValor Significado WaitingPurchaseAguardando Compra do Contrato WaitingBalanceAguardando Informação Saldo Devedor WaitingPaymentAguardando Pagamento Saldo Devedor WaitingLiquidationAguardando Liberação da Margem FinishedAverbado ErrorErro DeletedExcluído UnifiedContrato unificado WaitingForApprovalAguardando Anuência WaitingForPortedContractClosureAguardando Encerramento do Contrato Portado ConsentRefusedAnuência Recusada CanceledCancelado PaymentRejectionRejeição de Pagamento do Saldo Devedor
warrantyOptionValor Significado NoneNenhum FreeMarginMargem Livre PortabilityPortabilidade PeculioPecúlio
warrantyTypeValor Significado WarrantyGarantia VehicleVeículo HomeEquityImóvel JudiciaryProcessProcesso Judicial FactoringAntecipação de recebíveis PublicPayrollConsignado Público InvoiceFactoringDesconto de duplicatas ConsortiumConsórcio DataprevEmployeeCrédito do Trabalhador LoadCarga DataprevEmployeeRefinanceCrédito Trabalhador Refinanciamento CarEquityCar Equity DataprevInssConsignado INSS BenefitCardRegistrationRegistro de Cartão de Benefício
Exemplo do objeto de garantia {
"warrantyType": "Warranty",
"employeeCode": "texto",
"agreementCode": "texto",
"governmentDepartmentCode": "texto",
"employeerInstCode": "texto",
"warrantyCode": "texto",
"paymentTransferDay": 0,
"paymentAmountInCents": 0,
"employmentStatusCode": "texto",
"employmentStatusDescription": "texto",
"previousAdeNumber": "texto",
"warrantyDeadline": "2025-08-11T13:45:00Z",
"warrantyOption": "None",
"simulationRegistrationNumber": "texto",
"termInMonths": 0,
"adeIdentifier": "texto",
"governmentDepartmentWarrantyStatus": "WaitingPurchase",
"governmentDepartmentWarrantyStatusDisplay": "texto",
"payingSourceRegistrationNumber": "texto",
"payingSourceName": "Fulano de Tal"
}Registro de Cartão de Benefício — BenefitCardRegistration Cartão consig. saque: margem consignada no cartão, com código de averbação, valor da parcela e vigência da garantia.
Tipo de garantia Campo Tipo Obrigatório Descrição Valores Exemplo warrantyTypestringopcional — Warranty, Vehicle, HomeEquity, JudiciaryProcess, Factoring, PublicPayroll, InvoiceFactoring, Consortium, DataprevEmployee, Load, DataprevEmployeeRefinance, CarEquity, DataprevInss, BenefitCardRegistration"Warranty"
Cartão de benefício Campo Tipo Obrigatório Descrição Valores Exemplo benefitCardMarginAmountInCentsinteger (int64)opcional Valor da margem disponível para consignação em centavos — 0benefitCardEmployeeCodestringopcional Código do colaborador/beneficiário do cartão de benefício — "texto"benefitCardStartDatestring (date-time)opcional Data de início da vigência da garantia do cartão de benefício — "2025-08-11T13:45:00Z"benefitCardWarrantyCodestringopcional Código de averbação da garantia (endorsment_code do payload BYX) — "texto"benefitCardCcbNumberstringopcional Número do contrato/CCB informado pela esteira BYX (ccb_number do payload) — "texto"benefitCardInstallmentValueInCentsinteger (int64)opcional Valor da parcela em centavos (installment_value do payload BYX) — 0
warrantyTypeValor Significado WarrantyGarantia VehicleVeículo HomeEquityImóvel JudiciaryProcessProcesso Judicial FactoringAntecipação de recebíveis PublicPayrollConsignado Público InvoiceFactoringDesconto de duplicatas ConsortiumConsórcio DataprevEmployeeCrédito do Trabalhador LoadCarga DataprevEmployeeRefinanceCrédito Trabalhador Refinanciamento CarEquityCar Equity DataprevInssConsignado INSS BenefitCardRegistrationRegistro de Cartão de Benefício
Exemplo do objeto de garantia {
"warrantyType": "Warranty",
"benefitCardMarginAmountInCents": 0,
"benefitCardEmployeeCode": "texto",
"benefitCardStartDate": "2025-08-11T13:45:00Z",
"benefitCardWarrantyCode": "texto",
"benefitCardCcbNumber": "texto",
"benefitCardInstallmentValueInCents": 0
}Veículo — Vehicle Veículos (financiamento): o bem financiado é a garantia. Traz a ficha completa do veículo, o fornecedor/revenda, o valor de entrada e as UFs de emplacamento e de registro do gravame.
Tipo de garantia Campo Tipo Obrigatório Descrição Valores Exemplo warrantyTypestringopcional — Warranty, Vehicle, HomeEquity, JudiciaryProcess, Factoring, PublicPayroll, InvoiceFactoring, Consortium, DataprevEmployee, Load, DataprevEmployeeRefinance, CarEquity, DataprevInss, BenefitCardRegistration"Warranty"
Dados do veículo financiado Campo Tipo Obrigatório Descrição Valores Exemplo renavamstringopcional RENAVAM do Veículo — "texto"typeOfVehiclestringopcional Tipo do Veículo — "texto"chassisstringopcional Chassi do Veículo — "texto"boardstringopcional Placa do Veículo — "texto"supplierstringopcional Fornecedor do Veículo — "texto"taxNumberOfSupplierstringopcional CNPJ do Fornecedor — "texto"brandstringopcional Marca do Veículo — "texto"colorstringopcional Cor do Veículo — "texto"modelstringopcional Modelo do Veículo — "texto"yearOfManufactureintegeropcional Ano de Fabricação do Veículo — 0yearOfModelintegeropcional Ano de Modelo do Veículo — 0typeOfFuelstringopcional Tipo de Combustível do Veículo — "texto"downPaymentinteger (int64)opcional Valor de entrada — 0sellerCompanyNamestringopcional Revenda — "Fulano de Tal"sellerRegistrationNumberstringopcional CNPJ de quem efetuou a venda — "texto"valueInCashinteger (int64)opcional Valor veículo à vista — 0subtotalAmountinteger (int64)opcional Subtotal (Veículo + acessórios + outras despesas incluídas na operação a pedido do consumidor) — 0totalAmountFinancedTaxFreeinteger (int64)opcional Valor total a ser financiado sem impostos — 0plateStatestringopcional UF de emplacamento do veículo (sigla, ex.: "MG"). Origem do siglaEstadoPlaca no registro do gravame. — "texto"operationStatestringopcional UF da operação / Detran de registro do gravame (sigla, ex.: "MG"). Origem do siglaEstadoOperacao. — "texto"
warrantyTypeValor Significado WarrantyGarantia VehicleVeículo HomeEquityImóvel JudiciaryProcessProcesso Judicial FactoringAntecipação de recebíveis PublicPayrollConsignado Público InvoiceFactoringDesconto de duplicatas ConsortiumConsórcio DataprevEmployeeCrédito do Trabalhador LoadCarga DataprevEmployeeRefinanceCrédito Trabalhador Refinanciamento CarEquityCar Equity DataprevInssConsignado INSS BenefitCardRegistrationRegistro de Cartão de Benefício
Consultas e ofertas próprias deste lastro Use antes de criar a operação, para obter margem, ficha do bem ou ofertas elegíveis.
POST /v{version}/Amortization/VehicleOffersCria um novo registro de Amortization. POST /v{version}/Amortization/VehicleOffersWithoutLTVCria um novo registro de Amortization. GET /v{version}/Amortization/VehicleBrandsLista e filtra registros de Amortization. GET /v{version}/Amortization/VehicleModelsLista e filtra registros de Amortization. GET /v{version}/Amortization/VehicleByPlate/{plate}Consulta Amortization pelo identificador informado na rota. Exemplo do objeto de garantia {
"warrantyType": "Warranty",
"renavam": "texto",
"typeOfVehicle": "texto",
"chassis": "texto",
"board": "texto",
"supplier": "texto",
"taxNumberOfSupplier": "texto",
"brand": "texto",
"color": "texto",
"model": "texto",
"yearOfManufacture": 0,
"yearOfModel": 0,
"typeOfFuel": "texto",
"downPayment": 0,
"sellerCompanyName": "Fulano de Tal",
"sellerRegistrationNumber": "texto",
"valueInCash": 0,
"subtotalAmount": 0,
"totalAmountFinancedTaxFree": 0,
"plateState": "texto",
"operationState": "texto"
}Car Equity — CarEquity Veículos (crédito com garantia do veículo): o veículo do tomador lastreia crédito novo. Exige ficha do veículo completa e acompanha o status da vistoria veicular; o registro do gravame roda dentro da etapa de garantia.
Averbação: CarEquity. A operação passa pela etapa de garantia aguardando o retorno do órgão averbador antes de seguir na esteira.
Tipo de garantia Campo Tipo Obrigatório Descrição Valores Exemplo warrantyTypestringopcional — Warranty, Vehicle, HomeEquity, JudiciaryProcess, Factoring, PublicPayroll, InvoiceFactoring, Consortium, DataprevEmployee, Load, DataprevEmployeeRefinance, CarEquity, DataprevInss, BenefitCardRegistration"Warranty"
Dados do veículo e da vistoria Campo Tipo Obrigatório Descrição Valores Exemplo renavamstringobrigatório RENAVAM do Veículo — "texto"typeOfVehiclestringobrigatório Tipo do Veículo — "texto"chassisstringobrigatório Chassi do Veículo — "texto"boardstringobrigatório Placa do Veículo — "texto"brandstringobrigatório Marca do Veículo — "texto"colorstringobrigatório Cor do Veículo — "texto"modelstringobrigatório Modelo do Veículo — "texto"yearOfManufactureintegerobrigatório Ano de Fabricação do Veículo — 0yearOfModelintegerobrigatório Ano de Modelo do Veículo — 0typeOfFuelstringobrigatório Tipo de Combustível do Veículo — "texto"inspectionIdstringopcional Id da Vistoria Veicular — "3fa85f64-5717-4562-b3fc-2c963f66afa6"inspectionStatusstringopcional — WAITING_SOLICITATIONS, WAITING_FOR_ANALYSIS_OF_INITIAL_INFORMATION, WAITING_FOR_INITIAL_API_QUERIES, WAITING_FOR_SCHEDULE, WAITING_FOR_ANALYSIS_OF_RECEIVED_INFORMATION, WAITING_FOR_ADDITIONAL_SOLICITATIONS, WAITING_FOR_RISK_ANALYSIS_API_QUERIES, WAITING_FOR_PROCESSING, PARTIALLY_RECEIVED, WAITING_FOR_RESCHEDULE, WAITING_FOR_RISK_ANALYSIS, WAITING_FOR_AUTOMATIC_ANALYSIS, APPROVED, DISAPPROVED +8 "WAITING_SOLICITATIONS"inspectionUpdatedAtstring (date-time)opcional Data Última Atualização da Vistoria Veicular — "2025-08-11T13:45:00Z"plateStatestringopcional UF de emplacamento do veículo (sigla, ex.: "MG"). Origem do siglaEstadoPlaca no registro do gravame. — "texto"operationStatestringopcional UF da operação / Detran de registro do gravame (sigla, ex.: "MG"). Origem do siglaEstadoOperacao. — "texto"
inspectionStatusValor Significado WAITING_SOLICITATIONSWAITING_SOLICITATIONS WAITING_FOR_ANALYSIS_OF_INITIAL_INFORMATIONWAITING_FOR_ANALYSIS_OF_INITIAL_INFORMATION WAITING_FOR_INITIAL_API_QUERIESWAITING_FOR_INITIAL_API_QUERIES WAITING_FOR_SCHEDULEWAITING_FOR_SCHEDULE WAITING_FOR_ANALYSIS_OF_RECEIVED_INFORMATIONWAITING_FOR_ANALYSIS_OF_RECEIVED_INFORMATION WAITING_FOR_ADDITIONAL_SOLICITATIONSWAITING_FOR_ADDITIONAL_SOLICITATIONS WAITING_FOR_RISK_ANALYSIS_API_QUERIESWAITING_FOR_RISK_ANALYSIS_API_QUERIES WAITING_FOR_PROCESSINGWAITING_FOR_PROCESSING PARTIALLY_RECEIVEDPARTIALLY_RECEIVED WAITING_FOR_RESCHEDULEWAITING_FOR_RESCHEDULE WAITING_FOR_RISK_ANALYSISWAITING_FOR_RISK_ANALYSIS WAITING_FOR_AUTOMATIC_ANALYSISWAITING_FOR_AUTOMATIC_ANALYSIS APPROVEDAPPROVED DISAPPROVEDDISAPPROVED SUBJECT_TO_ANALYSISSUBJECT_TO_ANALYSIS CANCELEDCANCELED OUT_OF_VALIDITY_DATEOUT_OF_VALIDITY_DATE WAITING_STATUSWAITING_STATUS UNDER_ANALYSISUNDER_ANALYSIS OUT_OF_VALIDITY_DATE_WITHOUT_ANALYSISOUT_OF_VALIDITY_DATE_WITHOUT_ANALYSIS PARTIALLY_RECEIVED_ADDITIONAL_SOLICITATIONSPARTIALLY_RECEIVED_ADDITIONAL_SOLICITATIONS WAITING_FOR_PROCESSING_ADDITIONAL_SOLICITATIONSWAITING_FOR_PROCESSING_ADDITIONAL_SOLICITATIONS
warrantyTypeValor Significado WarrantyGarantia VehicleVeículo HomeEquityImóvel JudiciaryProcessProcesso Judicial FactoringAntecipação de recebíveis PublicPayrollConsignado Público InvoiceFactoringDesconto de duplicatas ConsortiumConsórcio DataprevEmployeeCrédito do Trabalhador LoadCarga DataprevEmployeeRefinanceCrédito Trabalhador Refinanciamento CarEquityCar Equity DataprevInssConsignado INSS BenefitCardRegistrationRegistro de Cartão de Benefício
Consultas e ofertas próprias deste lastro Use antes de criar a operação, para obter margem, ficha do bem ou ofertas elegíveis.
POST /v{version}/Amortization/VehicleOffersCria um novo registro de Amortization. GET /v{version}/Amortization/VehicleByPlate/{plate}Consulta Amortization pelo identificador informado na rota. Exemplo do objeto de garantia {
"warrantyType": "Warranty",
"renavam": "texto",
"typeOfVehicle": "texto",
"chassis": "texto",
"board": "texto",
"brand": "texto",
"color": "texto",
"model": "texto",
"yearOfManufacture": 0,
"yearOfModel": 0,
"typeOfFuel": "texto",
"inspectionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"inspectionStatus": "WAITING_SOLICITATIONS",
"inspectionUpdatedAt": "2025-08-11T13:45:00Z",
"plateState": "texto",
"operationState": "texto"
}Imóvel — HomeEquity Imóvel em garantia (Home Equity): matrícula, cartório de registro, endereço, dimensões e valor do imóvel.
Tipo de garantia Campo Tipo Obrigatório Descrição Valores Exemplo warrantyTypestringopcional — Warranty, Vehicle, HomeEquity, JudiciaryProcess, Factoring, PublicPayroll, InvoiceFactoring, Consortium, DataprevEmployee, Load, DataprevEmployeeRefinance, CarEquity, DataprevInss, BenefitCardRegistration"Warranty"
Dados do imóvel e da matrícula Campo Tipo Obrigatório Descrição Valores Exemplo registryOfficestringopcional Cartório de Registro do Imóvel — "texto"registrationNumberstringopcional Número de Matrícula do Imóvel — "12345678909"widthnumber (double)opcional Largura do Imóvel — 1000lengthnumber (double)opcional Comprimento do Imóvel — 1000addressNamestringopcional Endereço do Imóvel — "Fulano de Tal"zipCodeAddressstringopcional Código Postal do Imóvel — "01310930"citystringopcional Cidade do Imóvel — "texto"ufstringopcional — NaoSelecionado, AC, AL, AP, AM, BA, CE, DF, ES, GO, MA, MT, MS, MG +14 "NaoSelecionado"districtstringopcional Distrito do Imóvel — "texto"addressNumberstringopcional Número do Imóvel — "texto"complementAddressstringopcional Complemento do Imóvel — "texto"propertyFeaturesstringopcional Características do Imóvel — "texto"propertyValueinteger (int64)opcional Valor do imóvel — 0
ufValor Significado NaoSelecionadoNao Selecionado ACAC ALAL APAP AMAM BABA CECE DFDF ESES GOGO MAMA MTMT MSMS MGMG PAPA PBPB PRPR PEPE PIPI RJRJ RNRN RSRS RORO RRRR SCSC SPSP SESE TOTO
warrantyTypeValor Significado WarrantyGarantia VehicleVeículo HomeEquityImóvel JudiciaryProcessProcesso Judicial FactoringAntecipação de recebíveis PublicPayrollConsignado Público InvoiceFactoringDesconto de duplicatas ConsortiumConsórcio DataprevEmployeeCrédito do Trabalhador LoadCarga DataprevEmployeeRefinanceCrédito Trabalhador Refinanciamento CarEquityCar Equity DataprevInssConsignado INSS BenefitCardRegistrationRegistro de Cartão de Benefício
Exemplo do objeto de garantia {
"warrantyType": "Warranty",
"registryOffice": "texto",
"registrationNumber": "12345678909",
"width": 1000,
"length": 1000,
"addressName": "Fulano de Tal",
"zipCodeAddress": "01310930",
"city": "texto",
"uf": "NaoSelecionado",
"district": "texto",
"addressNumber": "texto",
"complementAddress": "texto",
"propertyFeatures": "texto",
"propertyValue": 0
}Consórcio — Consortium Cota de consórcio em garantia: administradora, grupo e cota.
Tipo de garantia Campo Tipo Obrigatório Descrição Valores Exemplo warrantyTypestringopcional — Warranty, Vehicle, HomeEquity, JudiciaryProcess, Factoring, PublicPayroll, InvoiceFactoring, Consortium, DataprevEmployee, Load, DataprevEmployeeRefinance, CarEquity, DataprevInss, BenefitCardRegistration"Warranty"
Dados da cota de consórcio Campo Tipo Obrigatório Descrição Valores Exemplo administratorNamestringopcional Nome do administrador — "Fulano de Tal"administratorRegistrationNumberstringopcional CPF/CNPJ do adminstrador — "texto"quotastringopcional Cota — "texto"groupstringopcional Grupo — "texto"
warrantyTypeValor Significado WarrantyGarantia VehicleVeículo HomeEquityImóvel JudiciaryProcessProcesso Judicial FactoringAntecipação de recebíveis PublicPayrollConsignado Público InvoiceFactoringDesconto de duplicatas ConsortiumConsórcio DataprevEmployeeCrédito do Trabalhador LoadCarga DataprevEmployeeRefinanceCrédito Trabalhador Refinanciamento CarEquityCar Equity DataprevInssConsignado INSS BenefitCardRegistrationRegistro de Cartão de Benefício
Exemplo do objeto de garantia {
"warrantyType": "Warranty",
"administratorName": "Fulano de Tal",
"administratorRegistrationNumber": "texto",
"quota": "texto",
"group": "texto"
}Processo Judicial — JudiciaryProcess Processo judicial em garantia: número, vara, tipo, valor da causa e as partes.
Tipo de garantia Campo Tipo Obrigatório Descrição Valores Exemplo warrantyTypestringopcional — Warranty, Vehicle, HomeEquity, JudiciaryProcess, Factoring, PublicPayroll, InvoiceFactoring, Consortium, DataprevEmployee, Load, DataprevEmployeeRefinance, CarEquity, DataprevInss, BenefitCardRegistration"Warranty"
Dados do processo Campo Tipo Obrigatório Descrição Valores Exemplo numberstringopcional Número do Processo — "texto"courtstringopcional Vara do Processo — "texto"valueOfCauseinteger (int64)opcional Valor da Causa do Processo — 0claimantstringopcional Reclamante do Processo — "texto"claimedstringopcional Reclamado do Processo — "texto"typeOfProcessstringopcional Tipo do Processo — "texto"
warrantyTypeValor Significado WarrantyGarantia VehicleVeículo HomeEquityImóvel JudiciaryProcessProcesso Judicial FactoringAntecipação de recebíveis PublicPayrollConsignado Público InvoiceFactoringDesconto de duplicatas ConsortiumConsórcio DataprevEmployeeCrédito do Trabalhador LoadCarga DataprevEmployeeRefinanceCrédito Trabalhador Refinanciamento CarEquityCar Equity DataprevInssConsignado INSS BenefitCardRegistrationRegistro de Cartão de Benefício
Exemplo do objeto de garantia {
"warrantyType": "Warranty",
"number": "texto",
"court": "texto",
"valueOfCause": 0,
"claimant": "texto",
"claimed": "texto",
"typeOfProcess": "texto"
}Carga — Load Carga em garantia: mercadoria com NCM, conhecimento de embarque, fatura, valor em reais e apólice de seguro.
Tipo de garantia Campo Tipo Obrigatório Descrição Valores Exemplo warrantyTypestringopcional — Warranty, Vehicle, HomeEquity, JudiciaryProcess, Factoring, PublicPayroll, InvoiceFactoring, Consortium, DataprevEmployee, Load, DataprevEmployeeRefinance, CarEquity, DataprevInss, BenefitCardRegistration"Warranty"
Dados da carga e do seguro Campo Tipo Obrigatório Descrição Valores Exemplo ncmstringopcional Nomenclatura comum do mercosul (NCM) — "texto"blNumberstringopcional Bill of lading - contrato de transporte (importação/exportação)
de produtos entre embarcador e transportador — "texto"idInvoicestringopcional Id da fatura — "texto"valueBRLinteger (int64)opcional Valor do produto BRL (em código ISO 4217 do real brasileiro) — 0policyNumberstringopcional Numero Da Apolice — "texto"insuranceCompanyNamestringopcional Nome da Seguradora — "Fulano de Tal"insuranceCompanyCNPJstringopcional CNPJ da seguradora — "12345678000199"
warrantyTypeValor Significado WarrantyGarantia VehicleVeículo HomeEquityImóvel JudiciaryProcessProcesso Judicial FactoringAntecipação de recebíveis PublicPayrollConsignado Público InvoiceFactoringDesconto de duplicatas ConsortiumConsórcio DataprevEmployeeCrédito do Trabalhador LoadCarga DataprevEmployeeRefinanceCrédito Trabalhador Refinanciamento CarEquityCar Equity DataprevInssConsignado INSS BenefitCardRegistrationRegistro de Cartão de Benefício
Exemplo do objeto de garantia {
"warrantyType": "Warranty",
"ncm": "texto",
"blNumber": "texto",
"idInvoice": "texto",
"valueBRL": 0,
"policyNumber": "texto",
"insuranceCompanyName": "Fulano de Tal",
"insuranceCompanyCNPJ": "12345678000199"
}Garantia — Warranty Garantia genérica: registra apenas o tipo, sem campos específicos de bem ou margem. É o que se usa quando o lastro é descrito em texto livre no campo de garantia da operação.
Tipo de garantia Campo Tipo Obrigatório Descrição Valores Exemplo warrantyTypestringopcional — Warranty, Vehicle, HomeEquity, JudiciaryProcess, Factoring, PublicPayroll, InvoiceFactoring, Consortium, DataprevEmployee, Load, DataprevEmployeeRefinance, CarEquity, DataprevInss, BenefitCardRegistration"Warranty"
warrantyTypeValor Significado WarrantyGarantia VehicleVeículo HomeEquityImóvel JudiciaryProcessProcesso Judicial FactoringAntecipação de recebíveis PublicPayrollConsignado Público InvoiceFactoringDesconto de duplicatas ConsortiumConsórcio DataprevEmployeeCrédito do Trabalhador LoadCarga DataprevEmployeeRefinanceCrédito Trabalhador Refinanciamento CarEquityCar Equity DataprevInssConsignado INSS BenefitCardRegistrationRegistro de Cartão de Benefício
Exemplo do objeto de garantia {
"warrantyType": "Warranty"
}