EasyPost - Rastrear Envio

Descripcion

Este modulo obtiene el estado de rastreo de un envio en EasyPost. Soporta dos modos de consulta: por tracker ID (trk_…) realizando un GET al endpoint /trackers/{tracker_id}, o por tracking code del transportista realizando un POST a /trackers para crear un tracker. Procesa la respuesta para extraer el estado, transportista, fecha estimada de entrega, firmante, URL publica de rastreo y el historial detallado de eventos con estado, mensaje, fecha, ciudad, estado y pais.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial EasyPost (provider: easypost)
tracker_id	text	No	ID del tracker de EasyPost (trk_…)
tracking_code	text	No	Numero de seguimiento del transportista
carrier	text	No	Nombre del transportista (requerido si se usa tracking_code)

Credenciales

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

api_key: API Key de EasyPost

Salida

{
  "success": true,
  "tracker_id": "trk_abc123",
  "tracking_code": "9400111899223456789012",
  "carrier": "USPS",
  "status": "in_transit",
  "est_delivery_date": "2026-03-25T18:00:00Z",
  "signed_by": null,
  "tracking_details": [
    {
      "status": "in_transit",
      "message": "In transit to next facility",
      "datetime": "2026-03-23T10:30:00Z",
      "city": "San Francisco",
      "state": "CA",
      "country": "US"
    }
  ],
  "public_url": "https://track.easypost.com/...",
  "message": "Estado: in_transit - 9400111899223456789012"
}

Ejemplo de Uso

Caso basico

{
  "credentials_id": "mi_credencial_easypost",
  "tracker_id": "trk_abc123"
}

API Utilizada

Endpoint: GET /trackers/{tracker_id} o POST /trackers
Base: EasyPost API (via helper _easypostHelper)
Documentacion: https://www.easypost.com/docs/api

Notas

Se requiere al menos uno de tracker_id o tracking_code
Si se usa tracking_code, se recomienda incluir el carrier para mayor precision
El public_url proporciona una pagina de rastreo publica que se puede compartir con el cliente
El campo signed_by se llena cuando el paquete es entregado y firmado