Skydropx - Cotizar Envio

Descripcion

Este modulo obtiene cotizaciones de envio de multiples transportistas a traves de Skydropx. Recibe las direcciones de origen y destino en formato JSON, los paquetes como array JSON y opcionalmente un transportista especifico para filtrar. Realiza una peticion POST al endpoint /quotations extrayendo los codigos postales de las direcciones y las dimensiones del primer paquete. Procesa la respuesta para extraer ID de tarifa, transportista, servicio, precio, moneda, dias estimados y fecha de expiracion. Identifica automaticamente la tarifa mas economica.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial Skydropx (provider: skydropx)
origin	textarea	Si	Direccion de origen en JSON (debe incluir zip_code o zip_from)
destination	textarea	Si	Direccion de destino en JSON (debe incluir zip_code o zip_to)
packages	textarea	Si	Array de paquetes en JSON con weight, height, width, length
carrier	text	No	Filtrar por transportista especifico (opcional)

Credenciales

Se requiere una credencial de tipo skydropx con los siguientes campos:

• api_token: API Token de Skydropx

Salida

{
  "success": true,
  "rates": [
    {
      "rate_id": "qt-12345",
      "carrier": "fedex",
      "service": "FedEx Express",
      "price": "250.00",
      "currency": "MXN",
      "estimated_days": 2,
      "expires_at": "2026-03-24T23:59:00Z"
    }
  ],
  "rates_count": 8,
  "cheapest": {
    "rate_id": "qt-67890",
    "carrier": "estafeta",
    "service": "Estafeta Terrestre",
    "price": "120.00",
    "currency": "MXN"
  },
  "message": "8 tarifas obtenidas"
}

Ejemplo de Uso

Caso basico

{
  "credentials_id": "mi_credencial_skydropx",
  "origin": "{\"zip_code\":\"06600\"}",
  "destination": "{\"zip_code\":\"44100\"}",
  "packages": "[{\"weight\":2.5,\"length\":25,\"width\":15,\"height\":10}]"
}

API Utilizada

• Endpoint: POST /quotations
• Base: Skydropx API (via helper _skydropxHelper)
• Documentacion: https://docs.skydropx.com/

Notas

• La cotizacion se basa en codigos postales de origen y destino (zip_from/zip_to o zip_code)
• Las dimensiones se toman del primer paquete del array
• La moneda por defecto es MXN (pesos mexicanos)
• Las cotizaciones tienen fecha de expiracion; se recomienda generar la etiqueta antes de que expiren
• Si se especifica carrier, solo se devuelven tarifas de ese transportista

Nodos Relacionados

• Skydropx - Crear Envio / Etiqueta (skydropxCreateShipment)
• Skydropx - Rastrear Envio (skydropxGetTracking)
• Skydropx - Cancelar Envio (skydropxCancelShipment)
• Skydropx - Obtener Transportistas (skydropxGetCarriers)