FedEx - Crear Envio / Etiqueta

Descripcion

Este modulo crea un envio en FedEx a traves de la API Ship v1. Recibe los datos del remitente y destinatario en formato JSON, tipo de servicio, peso del paquete, dimensiones opcionales, formato de etiqueta y referencia. Construye el payload completo con la configuracion de cuenta, especificacion de etiqueta y lineas de paquete. Realiza una peticion POST al endpoint /ship/v1/shipments y retorna el numero de seguimiento, ID del envio, URL de la etiqueta, tipo de servicio y estado.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial FedEx (provider: fedex)
shipper	textarea	Si	Datos del remitente en JSON con personName, phoneNumber y address
recipient	textarea	Si	Datos del destinatario en JSON
service_type	select	Si	Tipo de servicio: FEDEX_INTERNATIONAL_PRIORITY, FEDEX_INTERNATIONAL_ECONOMY, FEDEX_GROUND, FEDEX_EXPRESS_SAVER, STANDARD_OVERNIGHT
package_weight	text	Si	Peso del paquete en kilogramos
package_dimensions	textarea	No	Dimensiones del paquete en JSON (length, width, height)
label_type	select	No	Formato de etiqueta: PDF (por defecto), PNG, ZPLII
reference	text	No	Referencia interna del envio

Credenciales

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

client_id: Client ID de la API de FedEx
client_secret: Client Secret de la API de FedEx
account_number: Numero de cuenta de FedEx

Las credenciales se obtienen desde FedEx Developer Portal (https://developer.fedex.com/).

Salida

{
  "success": true,
  "tracking_number": "794644790138",
  "shipment_id": "SHIP-001",
  "label_url": "https://fedex.com/labels/...",
  "service_type": "FEDEX_INTERNATIONAL_PRIORITY",
  "status": "CREATED",
  "message": "Envio FedEx creado - Tracking: 794644790138"
}

Ejemplo de Uso

Caso basico

{
  "credentials_id": "mi_credencial_fedex",
  "shipper": "{\"personName\":\"Mi Empresa\",\"phoneNumber\":\"+34600000000\",\"address\":{\"streetLines\":[\"Calle Gran Via 1\"],\"city\":\"Madrid\",\"stateOrProvinceCode\":\"MD\",\"postalCode\":\"28001\",\"countryCode\":\"ES\"}}",
  "recipient": "{\"personName\":\"Cliente\",\"phoneNumber\":\"+34600000001\",\"address\":{\"streetLines\":[\"Av Diagonal 100\"],\"city\":\"Barcelona\",\"stateOrProvinceCode\":\"CT\",\"postalCode\":\"08001\",\"countryCode\":\"ES\"}}",
  "service_type": "FEDEX_INTERNATIONAL_PRIORITY",
  "package_weight": "3.0",
  "label_type": "PDF"
}

API Utilizada

Endpoint: POST /ship/v1/shipments
Base: FedEx API (via helper _fedexHelper)
Documentacion: https://developer.fedex.com/api/en-us/catalog.html

Notas

La autenticacion usa OAuth2 con client_id y client_secret
El tipo de empaque se configura como YOUR_PACKAGING por defecto
El tipo de recogida se configura como DROPOFF_AT_FEDEX_LOCATION
El tamano de etiqueta es PAPER_4X6
Si se incluye referencia, se agrega como CUSTOMER_REFERENCE en el paquete
Las dimensiones son opcionales y se expresan en centimetros