Criar oferta
curl --request POST \
--url https://api.example.com/offers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"idRequest": 123,
"creator": "<string>",
"offerNoGuarantee": {
"offerNoGuarantee.installmentsNumber": 123,
"offerNoGuarantee.installmentValue": 123,
"offerNoGuarantee.monthlyRate": 123,
"offerNoGuarantee.yearlyRate": 123,
"offerNoGuarantee.iofValue": 123,
"offerNoGuarantee.monthlyCet": 123,
"offerNoGuarantee.yearlyCet": 123,
"offerNoGuarantee.fundedValue": 123,
"offerNoGuarantee.loanValue": 123,
"offerNoGuarantee.creatorContacts": [
{}
]
}
}
'import requests
url = "https://api.example.com/offers"
payload = {
"idRequest": 123,
"creator": "<string>",
"offerNoGuarantee": {
"offerNoGuarantee.installmentsNumber": 123,
"offerNoGuarantee.installmentValue": 123,
"offerNoGuarantee.monthlyRate": 123,
"offerNoGuarantee.yearlyRate": 123,
"offerNoGuarantee.iofValue": 123,
"offerNoGuarantee.monthlyCet": 123,
"offerNoGuarantee.yearlyCet": 123,
"offerNoGuarantee.fundedValue": 123,
"offerNoGuarantee.loanValue": 123,
"offerNoGuarantee.creatorContacts": [{}]
}
}
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({
idRequest: 123,
creator: '<string>',
offerNoGuarantee: {
'offerNoGuarantee.installmentsNumber': 123,
'offerNoGuarantee.installmentValue': 123,
'offerNoGuarantee.monthlyRate': 123,
'offerNoGuarantee.yearlyRate': 123,
'offerNoGuarantee.iofValue': 123,
'offerNoGuarantee.monthlyCet': 123,
'offerNoGuarantee.yearlyCet': 123,
'offerNoGuarantee.fundedValue': 123,
'offerNoGuarantee.loanValue': 123,
'offerNoGuarantee.creatorContacts': [{}]
}
})
};
fetch('https://api.example.com/offers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"_embedded": { "id": 4521 },
"_links": { "self": { "href": "/zipconsig-marketplace/offers/4521" } },
"message": "Oferta criada com sucesso!"
}
Ofertas
Criar oferta
Envia uma oferta de condições para competir no leilão de uma solicitação
POST
/
offers
Criar oferta
curl --request POST \
--url https://api.example.com/offers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"idRequest": 123,
"creator": "<string>",
"offerNoGuarantee": {
"offerNoGuarantee.installmentsNumber": 123,
"offerNoGuarantee.installmentValue": 123,
"offerNoGuarantee.monthlyRate": 123,
"offerNoGuarantee.yearlyRate": 123,
"offerNoGuarantee.iofValue": 123,
"offerNoGuarantee.monthlyCet": 123,
"offerNoGuarantee.yearlyCet": 123,
"offerNoGuarantee.fundedValue": 123,
"offerNoGuarantee.loanValue": 123,
"offerNoGuarantee.creatorContacts": [
{}
]
}
}
'import requests
url = "https://api.example.com/offers"
payload = {
"idRequest": 123,
"creator": "<string>",
"offerNoGuarantee": {
"offerNoGuarantee.installmentsNumber": 123,
"offerNoGuarantee.installmentValue": 123,
"offerNoGuarantee.monthlyRate": 123,
"offerNoGuarantee.yearlyRate": 123,
"offerNoGuarantee.iofValue": 123,
"offerNoGuarantee.monthlyCet": 123,
"offerNoGuarantee.yearlyCet": 123,
"offerNoGuarantee.fundedValue": 123,
"offerNoGuarantee.loanValue": 123,
"offerNoGuarantee.creatorContacts": [{}]
}
}
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({
idRequest: 123,
creator: '<string>',
offerNoGuarantee: {
'offerNoGuarantee.installmentsNumber': 123,
'offerNoGuarantee.installmentValue': 123,
'offerNoGuarantee.monthlyRate': 123,
'offerNoGuarantee.yearlyRate': 123,
'offerNoGuarantee.iofValue': 123,
'offerNoGuarantee.monthlyCet': 123,
'offerNoGuarantee.yearlyCet': 123,
'offerNoGuarantee.fundedValue': 123,
'offerNoGuarantee.loanValue': 123,
'offerNoGuarantee.creatorContacts': [{}]
}
})
};
fetch('https://api.example.com/offers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"_embedded": { "id": 4521 },
"_links": { "self": { "href": "/zipconsig-marketplace/offers/4521" } },
"message": "Oferta criada com sucesso!"
}
Envia a oferta de condições do parceiro para uma solicitação — é ela que compete no leilão. Use este fluxo
direto quando você já tem os valores calculados (parcela, CET, IOF). Para simular condições antes, veja
Calcular oferta.
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
integer
required
ID da solicitação sendo respondida
string
required
CNPJ do parceiro criador da oferta — exatamente 14 caracteres
object
required
Condições da oferta sem garantia
Show child attributes
Show child attributes
integer
required
Número de parcelas (inteiro positivo)
number
required
Valor da parcela (≥ 0)
number
required
Taxa mensal (≥ 0)
number
required
Taxa anual
number
required
Valor do IOF
number
required
CET mensal
number
required
CET anual
number
required
Valor financiado (> 0)
number
required
Valor do empréstimo (> 0)
array
Opcional — array de
{tipo, contato}, onde tipo é 0 (URL), 1 (WhatsApp), 2 (Telefone), 3
(Email) ou 4 (Outro)object
array
Opcional — array de
{key, value} com contexto adicional do criadorRegras de negócio validadas no envio: quando
offerGuarantee é informado, pelo menos um dos campos de
garantia FGTS é obrigatório, e a monthlyRate da oferta com garantia deve ser menor que a da oferta
sem garantia.Exemplo
curl -X POST https://hml.zipdin.com.br/zipconsig-marketplace/offers \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"idRequest": 123,
"creator": "12345678000190",
"offerNoGuarantee": {
"installmentsNumber": 36,
"installmentValue": 398.50,
"monthlyRate": 2.49,
"yearlyRate": 34.82,
"iofValue": 120.00,
"monthlyCet": 2.70,
"yearlyCet": 37.90,
"fundedValue": 9250.00,
"loanValue": 10000.00,
"creatorContacts": [{ "tipo": 1, "contato": "5511999999999" }]
},
"creatorContext": [{ "key": "origem", "value": "app" }]
}'
{
"_embedded": { "id": 4521 },
"_links": { "self": { "href": "/zipconsig-marketplace/offers/4521" } },
"message": "Oferta criada com sucesso!"
}