Shippo - Rastrear Envio

Descripcion

Este modulo obtiene el estado de rastreo de un envio en Shippo utilizando el codigo del transportista y el numero de seguimiento. Realiza una peticion GET al endpoint /tracks/{carrier}/{tracking_number} y procesa la respuesta para extraer el estado actual, detalles del estado, fecha, ETA, direcciones de origen y destino, y el historial completo de rastreo con estado, detalles, fecha y ubicacion.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial Shippo (provider: shippo)
carrier	select	Si	Codigo del transportista: usps, fedex, ups, dhl_express, dhl_ecommerce, canada_post, royal_mail, correos, deutsche_post, gls_de, dpd_de, hermes_de, mondialrelay, seur
tracking_number	text	Si	Numero de rastreo del envio

Credenciales

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

api_token: API Token de Shippo

Salida

{
  "success": true,
  "tracking_number": "9400111899223456789012",
  "carrier": "usps",
  "status": "TRANSIT",
  "status_details": "Your shipment has departed the origin.",
  "status_date": "2026-03-23T10:30:00Z",
  "eta": "2026-03-25T18:00:00Z",
  "address_from": {"city": "San Francisco", "state": "CA", "country": "US"},
  "address_to": {"city": "Los Angeles", "state": "CA", "country": "US"},
  "tracking_history": [
    {
      "status": "TRANSIT",
      "status_details": "Your shipment has departed the origin.",
      "status_date": "2026-03-23T10:30:00Z",
      "location": {"city": "San Francisco", "state": "CA"}
    }
  ],
  "message": "Estado: TRANSIT - Your shipment has departed the origin."
}

Ejemplo de Uso

Caso basico

{
  "credentials_id": "mi_credencial_shippo",
  "carrier": "usps",
  "tracking_number": "9400111899223456789012"
}

API Utilizada

Endpoint: GET /tracks/{carrier}/{tracking_number}
Base: Shippo API (via helper _shippoHelper)
Documentacion: https://goshippo.com/docs/

Notas

El codigo del transportista debe coincidir con los codigos de Shippo (ej: usps, fedex, ups)
Shippo soporta rastreo de mas de 60 transportistas internacionales
El historial de rastreo incluye ubicaciones detalladas para cada evento
Los estados posibles incluyen: UNKNOWN, PRE_TRANSIT, TRANSIT, DELIVERED, RETURNED, FAILURE