Sendcloud - Track Parcel

Description

This module gets the tracking status of a parcel in Sendcloud using its parcel ID. It makes a GET request to the /parcels/{parcel_id} endpoint and returns the parcel ID, tracking number, tracking URL, carrier, status, status ID, label URL, weight, order number, and creation and update dates.

Configuration

Parameter	Type	Required	Description
credentials_id	credentials	Yes	Sendcloud credential (provider: sendcloud)
parcel_id	text	Yes	Parcel ID obtained when creating it in Sendcloud

Credentials

A sendcloud type credential is required with the following fields:

public_key: Sendcloud Public Key
secret_key: Sendcloud Secret Key

Output

{
  "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"
}

Usage Example

Basic case

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

API Used

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

Notes

The parcel_id (Sendcloud internal ID) is used, not the carrier tracking number
The status_id corresponds to Sendcloud standardized statuses (1=Announced, 3=In transit, 11=Delivered, etc.)
Includes the label URL for reprinting if needed