API Docs Início Documentação Referência de API Copiar para LLM
amortizationTypeSACCCB
Tipo de operação · SAC

SAC — Payload e campos

Quais campos envio em cada objeto.

Campos do cálculo

São 21 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"
paymentPeriodicityobjetoobrigatórioobjeto — ver detalhe abaixo{ … }
dueDateOnBusinessDaysbooleanopcionalDatas de vencimento são ajustadas para o próximo dia útiltrue
discountModebooleanopcionalCalcula o juros baseado no valor de amortização em relação à data de início. Caso contrário, calcula o juros baseasdo no saldo devedor em relação à ultima parcela.true

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",
  "paymentPeriodicity": {
    "every": 0,
    "periodicity": "Monthly"
  },
  "dueDateOnBusinessDays": true,
  "discountMode": true
}

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.

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
}

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

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

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