FedEx - Rastrear Envio

Descripcion

Este modulo consulta el estado de rastreo de un envio en FedEx utilizando el numero de seguimiento. Realiza una peticion POST al endpoint /track/v1/trackingnumbers con escaneos detallados habilitados. Procesa la respuesta para extraer el estado actual, codigo de estado, fecha estimada de entrega, tipo de servicio y el historial completo de eventos con fecha, descripcion, ciudad, estado y pais.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial FedEx (provider: fedex)
tracking_number	text	Si	Numero de seguimiento del envio FedEx

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

Salida

{
  "success": true,
  "tracking_number": "794644790138",
  "status": "In Transit",
  "status_code": "IT",
  "estimated_delivery": "2026-03-25T18:00:00",
  "service_type": "FEDEX_INTERNATIONAL_PRIORITY",
  "events": [
    {
      "date": "2026-03-23T10:30:00",
      "event": "Picked up",
      "city": "Madrid",
      "state": "MD",
      "country": "ES"
    }
  ],
  "message": "Estado: In Transit"
}

Ejemplo de Uso

Caso basico

{
  "credentials_id": "mi_credencial_fedex",
  "tracking_number": "794644790138"
}

API Utilizada

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

Notas

Se incluyen escaneos detallados (includeDetailedScans: true) para obtener el historial completo
La API de tracking de FedEx usa POST en lugar de GET
Los eventos incluyen informacion de ubicacion desglosada (ciudad, estado, pais)