Envia.com - Rastrear Envio

Descripcion

Este modulo rastrea un envio en Envia.com utilizando el nombre del transportista y el numero de seguimiento. Realiza una peticion POST al endpoint /ship/tracking/ con el carrier y tracking number. Retorna el estado del envio, historial de eventos, fecha estimada de entrega y un mensaje con el estado actual.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial Envia.com (provider: envia)
carrier	text	Si	Nombre del transportista (ej: fedex, dhl, estafeta)
tracking_number	text	Si	Numero de seguimiento del envio

Credenciales

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

• api_key: API Key de Envia.com

Salida

{
  "success": true,
  "tracking_number": "794644790138",
  "carrier": "fedex",
  "status": "in_transit",
  "events": [
    {
      "status": "in_transit",
      "description": "En camino a la siguiente instalacion",
      "date": "2026-03-23T10:30:00",
      "location": "Ciudad de Mexico, MX"
    }
  ],
  "estimated_delivery": "2026-03-25",
  "message": "Estado: in_transit"
}

Ejemplo de Uso

Caso basico

{
  "credentials_id": "mi_credencial_envia",
  "carrier": "fedex",
  "tracking_number": "794644790138"
}

API Utilizada

• Endpoint: POST /ship/tracking/
• Base: Envia.com API (via helper _enviaHelper)
• Documentacion: https://docs.envia.com/

Notas

• El nombre del transportista es obligatorio para el rastreo en Envia.com
• Los eventos pueden venir en el campo events o tracking_details segun el transportista
• Si el estado no esta disponible, se muestra “Desconocido”

Nodos Relacionados

• Envia.com - Crear Envio / Etiqueta (enviaCreateShipment)
• Envia.com - Obtener Tarifas (enviaGetRates)
• Envia.com - Cancelar Envio (enviaCancelShipment)
• Envia.com - Listar Transportistas (enviaGetCarriers)