Skydropx - Create Shipment / Label

Description

This module creates a shipment in Skydropx and generates the corresponding shipping label. It receives the origin and destination addresses in JSON format, packages as a JSON array with dimensions and weight, the carrier name, and the service level. It makes a POST request to the /labels endpoint and returns the label ID, tracking number, tracking URL, label URL, carrier, service, and status. Skydropx is a shipping aggregator focused on Mexico and Latin America.

Configuration

Parameter	Type	Required	Description
credentials_id	credentials	Yes	Skydropx credential (provider: skydropx)
origin	textarea	Yes	Origin address in JSON
destination	textarea	Yes	Destination address in JSON
parcels	textarea	Yes	Array of packages in JSON with dimensions and weight
carrier	text	Yes	Carrier name
service	text	Yes	Carrier service level

Credentials

A skydropx type credential is required with the following fields:

• api_token: Skydropx API Token

Credentials are obtained from the Skydropx dashboard (https://app.skydropx.com/).

Output

{
  "success": true,
  "label_id": "lbl-12345",
  "tracking_number": "MEX123456789",
  "tracking_url": "https://tracking.skydropx.com/MEX123456789",
  "label_url": "https://api.skydropx.com/labels/lbl-12345.pdf",
  "carrier": "fedex",
  "service": "express",
  "status": "created",
  "message": "Etiqueta generada - Tracking: MEX123456789"
}

Usage Example

Basic case

{
  "credentials_id": "mi_credencial_skydropx",
  "origin": "{\"name\":\"Mi Empresa\",\"street\":\"Reforma 222\",\"city\":\"Ciudad de Mexico\",\"state\":\"CDMX\",\"zip_code\":\"06600\",\"country\":\"MX\",\"phone\":\"+525512345678\"}",
  "destination": "{\"name\":\"Cliente\",\"street\":\"Av Juarez 100\",\"city\":\"Guadalajara\",\"state\":\"JAL\",\"zip_code\":\"44100\",\"country\":\"MX\",\"phone\":\"+525512345679\"}",
  "parcels": "[{\"weight\":2.5,\"length\":25,\"width\":15,\"height\":10}]",
  "carrier": "fedex",
  "service": "express"
}

API Used

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

Notes

• Packages are always sent as an array; if an individual object is passed, it is automatically converted
• Carrier and service names must match those available (use the Get Carriers node)
• Skydropx supports Mexican carriers like Estafeta, Redpack, J&T, in addition to international ones
• Weight is expressed in kilograms and dimensions in centimeters

Related Nodes

• Skydropx - Get Rates (skydropxGetRates)
• Skydropx - Track Shipment (skydropxGetTracking)
• Skydropx - Cancel Shipment (skydropxCancelShipment)
• Skydropx - Get Carriers (skydropxGetCarriers)