Saltar al contenido
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Cotización

El callback que implementa tu Carrier para cotizar por API. Zipnova lo llama cada vez que un seller cotiza.

Callback de cotización (lo implementa el carrier)

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.
Parámetros de encabezado
X-Zipnova-TimestampstringRequerido

Timestamp Unix del envío

Example: 1790000000
X-Zipnova-SignaturestringRequerido

v1=hex(HMAC-SHA256(hmac_secret, "{timestamp}.{body}")). Ver el security scheme zipnovaSignature.

Example: v1=5d41402abc4b2a76b9719d911017c592…
Carga útil

Una llamada por tarifario del carrier que aplica a la cotización.

tariff_idintegerRequerido

ID del tarifario del carrier que se está cotizando

Example: 9120
service_typestring · enumRequerido

Código del tipo de servicio del tarifario que se está cotizando

Example: standard_deliveryValores posibles:
settingsobjectRequerido

Valores key-value configurados en el tarifario (según el settings_schema del carrier)

Example: {"client_code":"ACME"}
account_idinteger · nullableOpcional

ID de la cuenta de Zipnova que cotiza

Example: 1234
declared_valuenumberRequerido

Valor declarado del envío, en la moneda del país

Example: 25000
Respuestas
200

Cotización

application/json

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.

pricenumber · máx: 100000000Requerido

Precio del envío en la moneda del país. Tiene que ser mayor a 0.

Example: 4350.5
delivery_time_mininteger · máx: 365Opcional

Plazo mínimo de entrega en días (por defecto 1)

Example: 2
delivery_time_maxinteger · máx: 365Opcional

Plazo máximo de entrega en días, mayor o igual al mínimo (por defecto delivery_time_min o 3)

Example: 4
custom_dataobject · nullableOpcional

Datos 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}.

Example: {"service_code":"EXP","quote_ref":"Q-8841"}
availablebooleanOpcional

false si el carrier no cubre el envío

Example: true

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