Skydropx - Get Rates

Description

This module gets shipping quotes from multiple carriers through Skydropx. It receives the origin and destination addresses in JSON format, packages as a JSON array, and optionally a specific carrier to filter by. It makes a POST request to the /quotations endpoint extracting zip codes from the addresses and dimensions from the first package. It processes the response to extract rate ID, carrier, service, price, currency, estimated days, and expiration date. It automatically identifies the cheapest rate.

Configuration

Parameter	Type	Required	Description
credentials_id	credentials	Yes	Skydropx credential (provider: skydropx)
origin	textarea	Yes	Origin address in JSON (must include zip_code or zip_from)
destination	textarea	Yes	Destination address in JSON (must include zip_code or zip_to)
packages	textarea	Yes	Array of packages in JSON with weight, height, width, length
carrier	text	No	Filter by specific carrier (optional)

Credentials

A skydropx type credential is required with the following fields:

• api_token: Skydropx API Token

Output

{
  "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"
}

Usage Example

Basic case

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

API Used

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

Notes

• The quote is based on origin and destination zip codes (zip_from/zip_to or zip_code)
• Dimensions are taken from the first package in the array
• The default currency is MXN (Mexican pesos)
• Quotes have an expiration date; it is recommended to generate the label before they expire
• If a carrier is specified, only rates from that carrier are returned

Related Nodes

• Skydropx - Create Shipment / Label (skydropxCreateShipment)
• Skydropx - Track Shipment (skydropxGetTracking)
• Skydropx - Cancel Shipment (skydropxCancelShipment)
• Skydropx - Get Carriers (skydropxGetCarriers)