Skydropx - Crear Envío / Etiqueta

Descripción

Este modulo crea un envío en Skydropx y genera la etiqueta de envío correspondiente. Recibe las direcciones de origen y destino en formato JSON, los paquetes como array JSON con dimensiones y peso, el nombre del transportista y el nivel de servicio. Realiza una petición POST al endpoint /labels y retorna el ID de la etiqueta, número de seguimiento, URL de rastreo, URL de la etiqueta, transportista, servicio y estado. Skydropx es un agregador de envíos enfocado en Mexico y Latinoamerica.

Configuración

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credencial Skydropx (provider: skydropx)
origin	textarea	Si	Dirección de origen en JSON
destination	textarea	Si	Dirección de destino en JSON
parcels	textarea	Si	Array de paquetes en JSON con dimensiones y peso
carrier	text	Si	Nombre del transportista
service	text	Si	Nivel de servicio del transportista

Credenciales

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

• api_token: API Token de Skydropx

Las credenciales se obtienen desde el panel de Skydropx (https://app.skydropx.com/).

Salida

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

Ejemplo de Uso

Caso básico

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

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

Notas

• Los paquetes se envian siempre como array; si se pasa un objeto individual, se convierte automáticamente
• Los nombres de carrier y service deben coincidir con los disponibles (usa el nodo Obtener Transportistas)
• Skydropx soporta transportistas mexicanos como Estafeta, Redpack, J&T, además de internacionales
• El peso se expresa en kilogramos y las dimensiones en centimetros

Nodos Relacionados

• Skydropx - Cotizar Envío (skydropxGetRates)
• Skydropx - Rastrear Envío (skydropxGetTracking)
• Skydropx - Cancelar Envío (skydropxCancelShipment)
• Skydropx - Obtener Transportistas (skydropxGetCarriers)