Cotización
El callback que implementa tu Carrier para cotizar por API. Zipnova lo llama cada vez que un seller cotiza.
Zipnova llama a la URL de cotización del carrier cada vez que un seller cotiza y aplica un tarifario con rate_source=api.
- Timeout total: 500 ms. Si no responde a tiempo, o responde 4xx/5xx o una respuesta inválida, se cotiza con el tarifario fijo del carrier si tiene zonas publicadas; si no, el carrier queda fuera de esa cotización.
- Circuit breaker: si la tasa de errores 4xx/5xx es alta, Zipnova suspende el callback y avisa por mail. Se reactiva desde el Carrier Hub.
- No se siguen redirecciones. Zipnova no guarda el contenido de las cotizaciones, solo el resultado HTTP.
Timestamp Unix del envío
1790000000v1=hex(HMAC-SHA256(hmac_secret, "{timestamp}.{body}")). Ver el security scheme zipnovaSignature.
v1=5d41402abc4b2a76b9719d911017c592…Una llamada por tarifario del carrier que aplica a la cotización.
ID del tarifario del carrier que se está cotizando
9120Código del tipo de servicio del tarifario que se está cotizando
standard_deliveryValores posibles: Valores key-value configurados en el tarifario (según el settings_schema del carrier)
{"client_code":"ACME"}ID de la cuenta de Zipnova que cotiza
1234Valor declarado del envío, en la moneda del país
25000Cotización
Si el carrier no cubre el envío, responder 204 o {"available": false}: no se cotiza ni se usa el tarifario fijo. Una respuesta fuera de estas cotas (o de más de 16 KB) se descarta, cuenta como error para la suspensión automática del callback y se cotiza con el tarifario fijo.
Precio del envío en la moneda del país. Tiene que ser mayor a 0.
4350.5Plazo mínimo de entrega en días (por defecto 1)
2Plazo máximo de entrega en días, mayor o igual al mínimo (por defecto delivery_time_min o 3)
4Datos propios del carrier (máximo 2 KB en JSON). Se guardan con el envío si se crea con esta cotización y se devuelven en GET /shipments/{shipment_id}.
{"service_code":"EXP","quote_ref":"Q-8841"}false si el carrier no cubre el envío
trueEl carrier no cubre el envío
Error del pedido: se usa el tarifario fijo y cuenta para el circuit breaker
Error del carrier: se usa el tarifario fijo y cuenta para el circuit breaker
Payload
{
"tariff_id": 9120,
"service_type": "standard_delivery",
"settings": {
"client_code": "ACME"
},
"account_id": 1234,
"declared_value": 25000,
"origin": {
"zipcode": "1736",
"city": {
"id": 1875,
"name": "Trujui",
"state": {
"code": "B",
"name": "Buenos Aires"
},
"country": "AR"
}
},
"destination": {
"zipcode": "1425",
"city": {
"id": 23,
"name": "Palermo",
"state": {
"code": "C",
"name": "Ciudad Autónoma de Buenos Aires"
},
"country": "AR"
}
},
"totals": {
"weight": 3000,
"volume": 48000,
"packages_count": 2
},
"packages": [
{
"weight": 1500,
"height": 20,
"width": 30,
"length": 40
},
{
"weight": 1500,
"height": 20,
"width": 30,
"length": 40
}
]
}Última actualización