Calcular oferta
curl --request POST \
--url https://api.example.com/offers-calculation \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"action": "<string>",
"idRequest": 123,
"hasGuarantee": true,
"firstDueDate": "<string>",
"creator": "<string>",
"issueDate": "<string>",
"offerNoGuarantee": {
"offerNoGuarantee.installmentsNumber": 123,
"offerNoGuarantee.installmentValue": 123,
"offerNoGuarantee.maxInstallmentValue": 123,
"offerNoGuarantee.minInstallmentValue": 123,
"offerNoGuarantee.maxLoanValue": 123,
"offerNoGuarantee.minLoanValue": 123,
"offerNoGuarantee.monthlyRate": 123,
"offerNoGuarantee.creatorContacts": [
{}
]
},
"creatorContext": [
{}
]
}
'import requests
url = "https://api.example.com/offers-calculation"
payload = {
"action": "<string>",
"idRequest": 123,
"hasGuarantee": True,
"firstDueDate": "<string>",
"creator": "<string>",
"issueDate": "<string>",
"offerNoGuarantee": {
"offerNoGuarantee.installmentsNumber": 123,
"offerNoGuarantee.installmentValue": 123,
"offerNoGuarantee.maxInstallmentValue": 123,
"offerNoGuarantee.minInstallmentValue": 123,
"offerNoGuarantee.maxLoanValue": 123,
"offerNoGuarantee.minLoanValue": 123,
"offerNoGuarantee.monthlyRate": 123,
"offerNoGuarantee.creatorContacts": [{}]
},
"creatorContext": [{}]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
action: '<string>',
idRequest: 123,
hasGuarantee: true,
firstDueDate: '<string>',
creator: '<string>',
issueDate: '<string>',
offerNoGuarantee: {
'offerNoGuarantee.installmentsNumber': 123,
'offerNoGuarantee.installmentValue': 123,
'offerNoGuarantee.maxInstallmentValue': 123,
'offerNoGuarantee.minInstallmentValue': 123,
'offerNoGuarantee.maxLoanValue': 123,
'offerNoGuarantee.minLoanValue': 123,
'offerNoGuarantee.monthlyRate': 123,
'offerNoGuarantee.creatorContacts': [{}]
},
creatorContext: [{}]
})
};
fetch('https://api.example.com/offers-calculation', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Ofertas
Calcular oferta
Calcula e valida uma oferta em faixa (mín/máx) antes de confirmá-la
POST
/
offers-calculation
Calcular oferta
curl --request POST \
--url https://api.example.com/offers-calculation \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"action": "<string>",
"idRequest": 123,
"hasGuarantee": true,
"firstDueDate": "<string>",
"creator": "<string>",
"issueDate": "<string>",
"offerNoGuarantee": {
"offerNoGuarantee.installmentsNumber": 123,
"offerNoGuarantee.installmentValue": 123,
"offerNoGuarantee.maxInstallmentValue": 123,
"offerNoGuarantee.minInstallmentValue": 123,
"offerNoGuarantee.maxLoanValue": 123,
"offerNoGuarantee.minLoanValue": 123,
"offerNoGuarantee.monthlyRate": 123,
"offerNoGuarantee.creatorContacts": [
{}
]
},
"creatorContext": [
{}
]
}
'import requests
url = "https://api.example.com/offers-calculation"
payload = {
"action": "<string>",
"idRequest": 123,
"hasGuarantee": True,
"firstDueDate": "<string>",
"creator": "<string>",
"issueDate": "<string>",
"offerNoGuarantee": {
"offerNoGuarantee.installmentsNumber": 123,
"offerNoGuarantee.installmentValue": 123,
"offerNoGuarantee.maxInstallmentValue": 123,
"offerNoGuarantee.minInstallmentValue": 123,
"offerNoGuarantee.maxLoanValue": 123,
"offerNoGuarantee.minLoanValue": 123,
"offerNoGuarantee.monthlyRate": 123,
"offerNoGuarantee.creatorContacts": [{}]
},
"creatorContext": [{}]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
action: '<string>',
idRequest: 123,
hasGuarantee: true,
firstDueDate: '<string>',
creator: '<string>',
issueDate: '<string>',
offerNoGuarantee: {
'offerNoGuarantee.installmentsNumber': 123,
'offerNoGuarantee.installmentValue': 123,
'offerNoGuarantee.maxInstallmentValue': 123,
'offerNoGuarantee.minInstallmentValue': 123,
'offerNoGuarantee.maxLoanValue': 123,
'offerNoGuarantee.minLoanValue': 123,
'offerNoGuarantee.monthlyRate': 123,
'offerNoGuarantee.creatorContacts': [{}]
},
creatorContext: [{}]
})
};
fetch('https://api.example.com/offers-calculation', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Calcula/valida uma oferta em faixa (mín/máx) antes de confirmá-la — útil para simular condições sem
criar a oferta definitiva. O motor interno calcula IOF e CET a partir dos limites e taxas informados.
Todos os endpoints requerem autenticação via Bearer token no header
Authorization.
Consulte o guia de autenticação para obter suas credenciais e gerar um token.Parâmetros
string
required
APROVADA ativa todas as regras de negócio abaixo; qualquer outro valor pula essas validaçõesinteger
required
boolean
required
string
required
string
required
CNPJ — exatamente 14 caracteres
string
required
object
required
object
Obrigatório quando
hasGuarantee = true e action = APROVADA. Mesmos campos de offerNoGuarantee, mais
os três campos de garantia FGTS (ao menos um obrigatório) — mesmas regras de
Criar oferta.array
required
Array de
{key, value}Exemplo
curl -X POST https://hml.zipdin.com.br/zipconsig-marketplace/offers-calculation \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"action": "APROVADA",
"idRequest": 123,
"hasGuarantee": false,
"firstDueDate": "2026-07-20",
"creator": "12345678000190",
"issueDate": "2026-05-20",
"offerNoGuarantee": {
"installmentsNumber": 36,
"installmentValue": 398.50,
"maxInstallmentValue": 420.00,
"minInstallmentValue": 380.00,
"maxLoanValue": 12000.00,
"minLoanValue": 8000.00,
"monthlyRate": 2.49
},
"creatorContext": [{ "key": "origem", "value": "app" }]
}'