Cotizaciones

Crea una cotización

   POST /api/v1/quotations

El endpoint crea una solicitud de cotización y la pone en cola para su procesamiento. La respuesta inicial contiene el identificador único de la cotización (quotation_id), pero no incluye los resultados de las tarifas.

Para obtenerlos, consulta el siguiente endpoint GET /api/v1/quotations/{id} hasta que el estado (status) sea is_completed.

Campo opcional: order_id (string) — ID de una orden existente para asociar la cotización. Si se omite, la cotización se crea sin orden vinculada.

post/api/v1/quotations

Request

  • Base URL: https://api-pro.skydropx.com
  • URL: https://api-pro.skydropx.com/api/v1/quotations
  • Auth: HTTP bearer

Request body

OR

Example request

{
  "quotation": {
    "address_from": {
      "address_template_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "country_code": "MX",
      "postal_code": "64000",
      "area_level1": "Nuevo León",
      "area_level2": "Monterrey",
      "area_level3": "Monterrey Centro",
      "tax_id_number": "XAXX010101000"
    },
    "address_to": {
      "address_template_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "country_code": "MX",
      "postal_code": "64000",
      "area_level1": "Nuevo León",
      "area_level2": "Monterrey",
      "area_level3": "Monterrey Centro",
      "tax_id_number": "XAXX010101000"
    },
    "parcels": [
      {
        "length": 10,
        "width": 10,
        "height": 10,
        "weight": 2,
        "package_protected": true,
        "declared_value": 100
      }
    ]
  }
}

Response

Retorna una respuesta completa de cotización

idstring required

ID de la cotización.

is_completedboolean required

Estado de finalización del procesamiento de la cotización. Si es false, aún está en proceso y las tarifas todavía no están disponibles. Si es true, el procesamiento terminó y las tarifas ya están disponibles.

address_template_from_idstring uuid nullable

ID de la plantilla de dirección de origen usada en la cotización (si aplica).

address_template_to_idstring uuid nullable

ID de la plantilla de dirección de destino usada en la cotización (si aplica).

requires_origin_verificationboolean

Indica si alguna de las tarifas de la cotización requiere verificación de la dirección de origen.

overweightboolean

Indicador de sobrepeso del paquete.

Example response

{
  "id": "0ac5adcc-a13d-427d-81dd-9ddd70b2f660",
  "is_completed": true,
  "quotation_scope": {
    "carriers_scoped_to": "ALL_AVAILABLE"
  },
  "rates": [
    {
      "id": "0ac5adcc-a13d-427d-81dd-9ddd70b2f660",
      "success": true,
      "country_code": "mx",
      "provider_name": "fedex",
      "provider_display_name": "FedEx",
      "provider_service_name": "Standard Overnight",
      "provider_service_code": "standard_overnight",
      "status": "pending",
      "currency_code": "MXN",
      "service_fee": 15,
      "weight": 5,
      "days": 2,
      "insurable": true,
      "protection_value_total": 100,
      "total_value_with_protection": 100,
      "pickup": true,
      "pickup_package_min": 1,
      "pickup_ocurre": true,
      "pickup_via_support": true,
      "shipment_creation_type": "single",
      "customs_payment_payer": [
        "sender",
        "recipient"
      ]
    }
  ],
  "address_template_from_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "address_template_to_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "packages": [
    {
      "package_number": 1,
      "weight": "2.0",
      "length": "10.0",
      "width": "10.0",
      "height": "10.0",
      "package_protected": true,
      "declared_value": 100,
      "protection_value": 100
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.