Sendcloud - Rastrear Paquete

Descripcion

Este modulo obtiene el estado de rastreo de un paquete en Sendcloud utilizando su ID de paquete. Realiza una peticion GET al endpoint /parcels/{parcel_id} y retorna el ID del paquete, numero de seguimiento, URL de rastreo, transportista, estado, ID de estado, URL de etiqueta, peso, numero de pedido y fechas de creacion y actualizacion.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial Sendcloud (provider: sendcloud)
parcel_id	text	Si	ID del paquete obtenido al crearlo en Sendcloud

Credenciales

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

public_key: Public Key de Sendcloud
secret_key: Secret Key de Sendcloud

Salida

{
  "success": true,
  "parcel_id": 12345,
  "tracking_number": "3STEST123456789",
  "tracking_url": "https://tracking.sendcloud.sc/...",
  "carrier": "correos_express",
  "status": "En camino",
  "status_id": 3,
  "label_url": "https://panel.sendcloud.sc/api/v2/labels/...",
  "weight": "1.500",
  "order_number": "ORD-001",
  "date_created": "2026-03-23T08:00:00Z",
  "date_updated": "2026-03-23T10:30:00Z",
  "message": "Estado: En camino - Tracking: 3STEST123456789"
}

Ejemplo de Uso

Caso basico

{
  "credentials_id": "mi_credencial_sendcloud",
  "parcel_id": "12345"
}

API Utilizada

Endpoint: GET /parcels/{parcel_id}
Base: Sendcloud API (via helper _sendcloudHelper)
Documentacion: https://docs.sendcloud.sc/api/v2/

Notas

Se usa el parcel_id (ID interno de Sendcloud), no el numero de seguimiento del transportista
El status_id corresponde a los estados estandarizados de Sendcloud (1=Announced, 3=En camino, 11=Entregado, etc.)
Incluye la URL de la etiqueta para reimprimir si es necesario