API Docs Início Documentação Referência de API Copiar para LLM
amortizationTypePriceCCB
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

CampoTipoObrigatórioDescriçãoValoresExemplo
idstring (uuid)opcional"3fa85f64-5717-4562-b3fc-2c963f66afa6"
amortizationTypestringopcionalIndica o tipo de tabela de amortização utilizada"texto"
startDatestring (date-time)opcionalData de início"2025-08-11T13:45:00Z"
includePaymentFixedCostsbooleanopcionalIncluir valor da parcela fixa na simulaçãotrue
validationErrorsarray de objetoopcionalobjeto — ver detalhe abaixo[ … ]
agentCommissionsarray de objetoopcionalComissões devidas ao CORBAN/Parceiro originador da operação. Utilizado para compor o Custo de Emissão (TAC), observados os limites estabelecidos no produtoobjeto — ver detalhe abaixo[ … ]
agentCommissionobjetoopcionalobjeto — ver detalhe abaixo{ … }

Valor, IOF e indexador

CampoTipoObrigatórioDescriçãoValoresExemplo
requestedAmountinteger (int64)opcionalValor solicitado0
financeTaxExemptedbooleanopcionalIsenção de IOFtrue
fiduciaryGuaranteenumber (double)opcionalPercentual de Garantia fiduciária1000
indexerstringopcionalIndexador Pós-Fixado que deve ser aplicado à cada parcela"texto"
indexerValuenumber (double)opcionalPercentual Indexador Pós-fixado que deve ser aplicado à cada parcela1000

Forma de cálculo do valor

CampoTipoObrigatórioDescriçãoValoresExemplo
calculateByValueTypestringopcionalGross, Liquid, Payment"Gross"

Cronograma por data da primeira parcela exclusivo deste tipo

CampoTipoObrigatórioDescriçãoValoresExemplo
firstPaymentDatestring (date-time)obrigatórioData de início"2025-08-11T13:45:00Z"
numberOfPaymentsintegerobrigatórioNúmero de parcelas0
numberOfInterestPaymentsintegeropcionalParcelas de pagamento de juros0
aprnumber (double)opcionalTaxa de Juros em base mensal1.99
calculationTypestringobrigatórioV252DiasUteis, V252MesesX21, V360DiasCorridos, V360Meses, V365DiasCorridos, V365Meses, Irregular"V252DiasUteis"
dueDateOnBusinessDaysbooleanopcionalDatas de vencimento são ajustadas para o próximo dia útiltrue
paymentPeriodicityobjetoobrigatórioobjeto — 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.

calculateByValueType

ValorSignificado
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

calculationType

ValorSignificado
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

CampoTipoObrigatórioDescriçãoValoresExemplo
warrantyTypestringopcionalWarranty, Vehicle, HomeEquity, JudiciaryProcess, Factoring, PublicPayroll, InvoiceFactoring, Consortium, DataprevEmployee, Load, DataprevEmployeeRefinance, CarEquity, DataprevInss, BenefitCardRegistration"Warranty"

Vínculo e valor da margem

CampoTipoObrigatórioDescriçãoValoresExemplo
employeeCodestringopcional"texto"
admissionDatestring (date-time)opcional"2025-08-11T13:45:00Z"

Vínculo empregatício e margem consignável

CampoTipoObrigatórioDescriçãoValoresExemplo
dataprev_EmployeeCodestringobrigatórioMatrícula do trabalhador"texto"
dataprev_EmployerRegistrationCodeintegerobrigatórioCódigo de inscrição do empregador0
dataprev_EmployerNamestringobrigatórioNome do empregador"Fulano de Tal"
dataprev_EmployerRegistrationNumberstringobrigatórioNúmero inscrição do Empregador"texto"
dataprev_DiscountStartPeriodstringobrigatórioCompetência início de desconto"texto"
dataprev_OriginalMarginnumber (double)opcionalValor original da margem consignável1000
dataprev_EmployeePositionCBOCodeintegeropcionalCBO - Classificação Brasileira de Ocupações0
dataprev_EmployeeAdmissionDatestring (date-time)obrigatórioData de admissão do trabalhador"2025-08-11T13:45:00Z"
dataprev_HasWarrantybooleanopcionalIndica se o contrato utiliza garantias do FGTS (Solução de Garantias - Manual 003). Campo temGarantias.true
dataprev_WarrantyFgtsBalanceInCentsinteger (int64)opcionalSaldo FGTS oferecido como garantia, em centavos. Campo valorSaldoDisponivelGarantiaFgts vem em reais (NÚMERO 10,2) e é convertido para centavos na escrita.0
dataprev_WarrantyFgtsRescissionPenaltyInCentsinteger (int64)opcionalMulta rescisória FGTS oferecida como garantia, em centavos. Campo valorMultaRescisoriaGarantiaFgts vem em reais (NÚMERO 10,2) e é convertido para centavos na escrita.0
dataprev_WarrantyRescissionBenefitPercentagenumber (double)opcionalPercentual da verba rescisória para garantia, até 35%. Campo percVerbaRescisoriaGarantia (NÚMERO 3,2).1.99
dataprev_CtpsDigitalAuthorizationNumberstringopcionalNúmero da autorização da CTPS Digital. Campo numeroAutorizacaoCtpsDigital."texto"
dataprev_ProposalNumberstringopcionalNúmero da proposta do leilão (proposalNumber). Nulo em operações internas."texto"
totalValuenumber (double)obrigatórioValor da margem1000

warrantyType

ValorSignificado
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.

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

CampoTipoObrigatórioDescriçãoValoresExemplo
warrantyTypestringopcionalWarranty, Vehicle, HomeEquity, JudiciaryProcess, Factoring, PublicPayroll, InvoiceFactoring, Consortium, DataprevEmployee, Load, DataprevEmployeeRefinance, CarEquity, DataprevInss, BenefitCardRegistration"Warranty"

Vínculo e valor da margem

CampoTipoObrigatórioDescriçãoValoresExemplo
employeeCodestringopcional"texto"
admissionDatestring (date-time)opcional"2025-08-11T13:45:00Z"

Vínculo empregatício e margem consignável

CampoTipoObrigatórioDescriçãoValoresExemplo
dataprev_EmployeeCodestringobrigatórioMatrícula do trabalhador"texto"
dataprev_EmployerRegistrationCodeintegerobrigatórioCódigo de inscrição do empregador0
dataprev_EmployerNamestringobrigatórioNome do empregador"Fulano de Tal"
dataprev_EmployerRegistrationNumberstringobrigatórioNúmero inscrição do Empregador"texto"
dataprev_DiscountStartPeriodstringobrigatórioCompetência início de desconto"texto"
dataprev_OriginalMarginnumber (double)opcionalValor original da margem consignável1000
dataprev_EmployeePositionCBOCodeintegeropcionalCBO - Classificação Brasileira de Ocupações0
dataprev_EmployeeAdmissionDatestring (date-time)obrigatórioData de admissão do trabalhador"2025-08-11T13:45:00Z"
dataprev_HasWarrantybooleanopcionalIndica se o contrato utiliza garantias do FGTS (Solução de Garantias - Manual 003). Campo temGarantias.true
dataprev_WarrantyFgtsBalanceInCentsinteger (int64)opcionalSaldo FGTS oferecido como garantia, em centavos. Campo valorSaldoDisponivelGarantiaFgts vem em reais (NÚMERO 10,2) e é convertido para centavos na escrita.0
dataprev_WarrantyFgtsRescissionPenaltyInCentsinteger (int64)opcionalMulta rescisória FGTS oferecida como garantia, em centavos. Campo valorMultaRescisoriaGarantiaFgts vem em reais (NÚMERO 10,2) e é convertido para centavos na escrita.0
dataprev_WarrantyRescissionBenefitPercentagenumber (double)opcionalPercentual da verba rescisória para garantia, até 35%. Campo percVerbaRescisoriaGarantia (NÚMERO 3,2).1.99
dataprev_CtpsDigitalAuthorizationNumberstringopcionalNúmero da autorização da CTPS Digital. Campo numeroAutorizacaoCtpsDigital."texto"
dataprev_ProposalNumberstringopcionalNúmero da proposta do leilão (proposalNumber). Nulo em operações internas."texto"
totalValuenumber (double)obrigatórioValor da margem1000

warrantyType

ValorSignificado
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.

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

CampoTipoObrigatórioDescriçãoValoresExemplo
warrantyTypestringopcionalWarranty, Vehicle, HomeEquity, JudiciaryProcess, Factoring, PublicPayroll, InvoiceFactoring, Consortium, DataprevEmployee, Load, DataprevEmployeeRefinance, CarEquity, DataprevInss, BenefitCardRegistration"Warranty"

Vínculo e valor da margem

CampoTipoObrigatórioDescriçãoValoresExemplo
employeeCodestringopcional"texto"
admissionDatestring (date-time)opcional"2025-08-11T13:45:00Z"
totalValuenumber (double)opcionalValor total1000

Benefício INSS e margem

CampoTipoObrigatórioDescriçãoValoresExemplo
inss_RegistrationNumberstringopcionalCPF do beneficiário (11 dígitos)."texto"
inss_BenefitNumberstringopcionalNúmero do benefício (NB)."texto"
inss_NamestringopcionalNome do beneficiário."Fulano de Tal"
inss_BenefitTypestringopcionalEspécie do benefício."texto"
inss_BenefitTypeDescriptionstringopcionalDescrição da espécie do benefício."texto"
inss_PaymentAccountTypestringopcionalTipo da conta bancária."texto"
inss_PaymentAccountTypeDescriptionstringopcionalDescrição do tipo da conta bancária."texto"
inss_PaymentBankCodestringopcionalCódigo do banco pagador."texto"
inss_PaymentBankAgencystringopcionalAgência bancária."texto"
inss_PaymentBankAccountNumberstringopcionalNúmero da conta bancária."texto"
inss_AvailableMarginnumber (double)opcionalMargem consignável disponível.1000
inss_OriginalMarginnumber (double)opcionalMargem consignável original.1000
inss_MarginValuenumber (double)opcionalMargem consignável utilizada na averbação.1000
inss_MaximumInstallmentsintegeropcionalPrazo máximo permitido.0
inss_IsIneligiblebooleanopcionalIndica se o beneficiário é inelegível (resultado do crivo, vindo da consulta de margem).true
inss_IneligibilityReasonstringopcionalMotivo da inelegibilidade do beneficiário."texto"

warrantyType

ValorSignificado
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.

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

CampoTipoObrigatórioDescriçãoValoresExemplo
warrantyTypestringopcionalWarranty, Vehicle, HomeEquity, JudiciaryProcess, Factoring, PublicPayroll, InvoiceFactoring, Consortium, DataprevEmployee, Load, DataprevEmployeeRefinance, CarEquity, DataprevInss, BenefitCardRegistration"Warranty"

Averbação no órgão público

CampoTipoObrigatórioDescriçãoValoresExemplo
employeeCodestringopcionalCódigo da Matrícula"texto"
agreementCodestringopcionalCódigo do Convênio"texto"
governmentDepartmentCodestringopcionalCódigo do Orgão"texto"
employeerInstCodestringopcionalÓrgão + Matrícula do Instituidor"texto"
warrantyCodestringopcionalCódigo de averbação"texto"
paymentTransferDayintegeropcionalDia do repasse0
paymentAmountInCentsinteger (int64)opcionalValor da Margem0
employmentStatusCodestringopcionalCódigo do tipo da situação funcional do vínculo funcional"texto"
employmentStatusDescriptionstringopcionalDescrição do tipo da situação funcional do vínculo funcional"texto"
previousAdeNumberstringopcionalNúmero ADE anterior"texto"
warrantyDeadlinestring (date-time)opcionalData limite de averbação"2025-08-11T13:45:00Z"
warrantyOptionstringopcionalNone, FreeMargin, Portability, Peculio"None"
simulationRegistrationNumberstringopcional"texto"
termInMonthsintegeropcionalPrazo0
adeIdentifierstringopcionalAde identificador da operação na zetra"texto"
governmentDepartmentWarrantyStatusstringopcionalWaitingPurchase, WaitingBalance, WaitingPayment, WaitingLiquidation, Finished, Error, Deleted, Unified, WaitingForApproval, WaitingForPortedContractClosure, ConsentRefused, Canceled, PaymentRejection"WaitingPurchase"
governmentDepartmentWarrantyStatusDisplaystringopcionalDescrição da situação"texto"
payingSourceRegistrationNumberstringopcional"texto"
payingSourceNamestringopcionalNome da Fonte Pagadora"Fulano de Tal"

governmentDepartmentWarrantyStatus

ValorSignificado
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

warrantyOption

ValorSignificado
NoneNenhum
FreeMarginMargem Livre
PortabilityPortabilidade
PeculioPecúlio

warrantyType

ValorSignificado
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

CampoTipoObrigatórioDescriçãoValoresExemplo
warrantyTypestringopcionalWarranty, Vehicle, HomeEquity, JudiciaryProcess, Factoring, PublicPayroll, InvoiceFactoring, Consortium, DataprevEmployee, Load, DataprevEmployeeRefinance, CarEquity, DataprevInss, BenefitCardRegistration"Warranty"

Cartão de benefício

CampoTipoObrigatórioDescriçãoValoresExemplo
benefitCardMarginAmountInCentsinteger (int64)opcionalValor da margem disponível para consignação em centavos0
benefitCardEmployeeCodestringopcionalCódigo do colaborador/beneficiário do cartão de benefício"texto"
benefitCardStartDatestring (date-time)opcionalData de início da vigência da garantia do cartão de benefício"2025-08-11T13:45:00Z"
benefitCardWarrantyCodestringopcionalCódigo de averbação da garantia (endorsment_code do payload BYX)"texto"
benefitCardCcbNumberstringopcionalNúmero do contrato/CCB informado pela esteira BYX (ccb_number do payload)"texto"
benefitCardInstallmentValueInCentsinteger (int64)opcionalValor da parcela em centavos (installment_value do payload BYX)0

warrantyType

ValorSignificado
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

CampoTipoObrigatórioDescriçãoValoresExemplo
warrantyTypestringopcionalWarranty, Vehicle, HomeEquity, JudiciaryProcess, Factoring, PublicPayroll, InvoiceFactoring, Consortium, DataprevEmployee, Load, DataprevEmployeeRefinance, CarEquity, DataprevInss, BenefitCardRegistration"Warranty"

Dados do veículo financiado

CampoTipoObrigatórioDescriçãoValoresExemplo
renavamstringopcionalRENAVAM do Veículo"texto"
typeOfVehiclestringopcionalTipo do Veículo"texto"
chassisstringopcionalChassi do Veículo"texto"
boardstringopcionalPlaca do Veículo"texto"
supplierstringopcionalFornecedor do Veículo"texto"
taxNumberOfSupplierstringopcionalCNPJ do Fornecedor"texto"
brandstringopcionalMarca do Veículo"texto"
colorstringopcionalCor do Veículo"texto"
modelstringopcionalModelo do Veículo"texto"
yearOfManufactureintegeropcionalAno de Fabricação do Veículo0
yearOfModelintegeropcionalAno de Modelo do Veículo0
typeOfFuelstringopcionalTipo de Combustível do Veículo"texto"
downPaymentinteger (int64)opcionalValor de entrada0
sellerCompanyNamestringopcionalRevenda"Fulano de Tal"
sellerRegistrationNumberstringopcionalCNPJ de quem efetuou a venda"texto"
valueInCashinteger (int64)opcionalValor veículo à vista0
subtotalAmountinteger (int64)opcionalSubtotal (Veículo + acessórios + outras despesas incluídas na operação a pedido do consumidor)0
totalAmountFinancedTaxFreeinteger (int64)opcionalValor total a ser financiado sem impostos0
plateStatestringopcionalUF de emplacamento do veículo (sigla, ex.: "MG"). Origem do siglaEstadoPlaca no registro do gravame."texto"
operationStatestringopcionalUF da operação / Detran de registro do gravame (sigla, ex.: "MG"). Origem do siglaEstadoOperacao."texto"

warrantyType

ValorSignificado
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.

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

CampoTipoObrigatórioDescriçãoValoresExemplo
warrantyTypestringopcionalWarranty, Vehicle, HomeEquity, JudiciaryProcess, Factoring, PublicPayroll, InvoiceFactoring, Consortium, DataprevEmployee, Load, DataprevEmployeeRefinance, CarEquity, DataprevInss, BenefitCardRegistration"Warranty"

Dados do veículo e da vistoria

CampoTipoObrigatórioDescriçãoValoresExemplo
renavamstringobrigatórioRENAVAM do Veículo"texto"
typeOfVehiclestringobrigatórioTipo do Veículo"texto"
chassisstringobrigatórioChassi do Veículo"texto"
boardstringobrigatórioPlaca do Veículo"texto"
brandstringobrigatórioMarca do Veículo"texto"
colorstringobrigatórioCor do Veículo"texto"
modelstringobrigatórioModelo do Veículo"texto"
yearOfManufactureintegerobrigatórioAno de Fabricação do Veículo0
yearOfModelintegerobrigatórioAno de Modelo do Veículo0
typeOfFuelstringobrigatórioTipo de Combustível do Veículo"texto"
inspectionIdstringopcionalId da Vistoria Veicular"3fa85f64-5717-4562-b3fc-2c963f66afa6"
inspectionStatusstringopcionalWAITING_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)opcionalData Última Atualização da Vistoria Veicular"2025-08-11T13:45:00Z"
plateStatestringopcionalUF de emplacamento do veículo (sigla, ex.: "MG"). Origem do siglaEstadoPlaca no registro do gravame."texto"
operationStatestringopcionalUF da operação / Detran de registro do gravame (sigla, ex.: "MG"). Origem do siglaEstadoOperacao."texto"

inspectionStatus

ValorSignificado
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

warrantyType

ValorSignificado
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.

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

CampoTipoObrigatórioDescriçãoValoresExemplo
warrantyTypestringopcionalWarranty, Vehicle, HomeEquity, JudiciaryProcess, Factoring, PublicPayroll, InvoiceFactoring, Consortium, DataprevEmployee, Load, DataprevEmployeeRefinance, CarEquity, DataprevInss, BenefitCardRegistration"Warranty"

Dados do imóvel e da matrícula

CampoTipoObrigatórioDescriçãoValoresExemplo
registryOfficestringopcionalCartório de Registro do Imóvel"texto"
registrationNumberstringopcionalNúmero de Matrícula do Imóvel"12345678909"
widthnumber (double)opcionalLargura do Imóvel1000
lengthnumber (double)opcionalComprimento do Imóvel1000
addressNamestringopcionalEndereço do Imóvel"Fulano de Tal"
zipCodeAddressstringopcionalCódigo Postal do Imóvel"01310930"
citystringopcionalCidade do Imóvel"texto"
ufstringopcionalNaoSelecionado, AC, AL, AP, AM, BA, CE, DF, ES, GO, MA, MT, MS, MG +14"NaoSelecionado"
districtstringopcionalDistrito do Imóvel"texto"
addressNumberstringopcionalNúmero do Imóvel"texto"
complementAddressstringopcionalComplemento do Imóvel"texto"
propertyFeaturesstringopcionalCaracterísticas do Imóvel"texto"
propertyValueinteger (int64)opcionalValor do imóvel0

uf

ValorSignificado
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

warrantyType

ValorSignificado
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

CampoTipoObrigatórioDescriçãoValoresExemplo
warrantyTypestringopcionalWarranty, Vehicle, HomeEquity, JudiciaryProcess, Factoring, PublicPayroll, InvoiceFactoring, Consortium, DataprevEmployee, Load, DataprevEmployeeRefinance, CarEquity, DataprevInss, BenefitCardRegistration"Warranty"

Dados da cota de consórcio

CampoTipoObrigatórioDescriçãoValoresExemplo
administratorNamestringopcionalNome do administrador"Fulano de Tal"
administratorRegistrationNumberstringopcionalCPF/CNPJ do adminstrador"texto"
quotastringopcionalCota"texto"
groupstringopcionalGrupo"texto"

warrantyType

ValorSignificado
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

CampoTipoObrigatórioDescriçãoValoresExemplo
warrantyTypestringopcionalWarranty, Vehicle, HomeEquity, JudiciaryProcess, Factoring, PublicPayroll, InvoiceFactoring, Consortium, DataprevEmployee, Load, DataprevEmployeeRefinance, CarEquity, DataprevInss, BenefitCardRegistration"Warranty"

Dados do processo

CampoTipoObrigatórioDescriçãoValoresExemplo
numberstringopcionalNúmero do Processo"texto"
courtstringopcionalVara do Processo"texto"
valueOfCauseinteger (int64)opcionalValor da Causa do Processo0
claimantstringopcionalReclamante do Processo"texto"
claimedstringopcionalReclamado do Processo"texto"
typeOfProcessstringopcionalTipo do Processo"texto"

warrantyType

ValorSignificado
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

CampoTipoObrigatórioDescriçãoValoresExemplo
warrantyTypestringopcionalWarranty, Vehicle, HomeEquity, JudiciaryProcess, Factoring, PublicPayroll, InvoiceFactoring, Consortium, DataprevEmployee, Load, DataprevEmployeeRefinance, CarEquity, DataprevInss, BenefitCardRegistration"Warranty"

Dados da carga e do seguro

CampoTipoObrigatórioDescriçãoValoresExemplo
ncmstringopcionalNomenclatura comum do mercosul (NCM)"texto"
blNumberstringopcionalBill of lading - contrato de transporte (importação/exportação) de produtos entre embarcador e transportador"texto"
idInvoicestringopcionalId da fatura"texto"
valueBRLinteger (int64)opcionalValor do produto BRL (em código ISO 4217 do real brasileiro)0
policyNumberstringopcionalNumero Da Apolice"texto"
insuranceCompanyNamestringopcionalNome da Seguradora"Fulano de Tal"
insuranceCompanyCNPJstringopcionalCNPJ da seguradora"12345678000199"

warrantyType

ValorSignificado
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

CampoTipoObrigatórioDescriçãoValoresExemplo
warrantyTypestringopcionalWarranty, Vehicle, HomeEquity, JudiciaryProcess, Factoring, PublicPayroll, InvoiceFactoring, Consortium, DataprevEmployee, Load, DataprevEmployeeRefinance, CarEquity, DataprevInss, BenefitCardRegistration"Warranty"

warrantyType

ValorSignificado
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"
}