Sendcloud - Crear Paquete / Etiqueta

Descripción

Este modulo crea un paquete en Sendcloud con todos los datos del destinatario y opcionalmente genera la etiqueta de envío. Recibe los campos individuales del destinatario (nombre, empresa, dirección, número de casa, ciudad, código postal, pais, telefono, email), el ID del método de envío, peso, número de pedido, valor asegurado, valor total y si se debe generar la etiqueta inmediatamente. Realiza una petición POST al endpoint /parcels y retorna el ID del paquete, número de seguimiento, URL de rastreo, URL de la etiqueta, transportista y estado.

Configuración

Parámetro	Tipo	Requerido	Descripción
credentials_id	credentials	Si	Credencial Sendcloud (provider: sendcloud)
name	text	Si	Nombre del destinatario
company_name	text	No	Nombre de la empresa
address	text	Si	Nombre de la calle/via
house_number	text	Si	Número de la casa (obligatorio en Europa)
address_2	text	No	Dirección línea 2
city	text	Si	Ciudad
postal_code	text	Si	Código postal
country	text	Si	Código ISO 2 letras del pais (por defecto: ES)
telephone	text	No	Número de telefono
email	text	No	Dirección de email
shipment_id	text	Si	ID del método de envío (obtenido del nodo Métodos de Envío)
weight	text	Si	Peso del paquete en kg (ej: 1.500)
order_number	text	No	Número de pedido interno como referencia
insured_value	text	No	Valor asegurado del paquete en centimos
total_order_value	text	No	Valor total del pedido
request_label	boolean	No	Generar etiqueta inmediatamente (por defecto: true)

Credenciales

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

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

Las credenciales se obtienen desde el panel de Sendcloud (https://app.sendcloud.com/v2/settings/integrations).

Salida

{
  "success": true,
  "parcel_id": 12345,
  "tracking_number": "3STEST123456789",
  "tracking_url": "https://tracking.sendcloud.sc/...",
  "label_url": "https://panel.sendcloud.sc/api/v2/labels/...",
  "carrier": "correos_express",
  "status": "Ready to send",
  "order_number": "ORD-001",
  "message": "Paquete creado - Tracking: 3STEST123456789"
}

Ejemplo de Uso

Caso básico

{
  "credentials_id": "mi_credencial_sendcloud",
  "name": "Juan Garcia",
  "address": "Calle Mayor",
  "house_number": "10",
  "city": "Madrid",
  "postal_code": "28001",
  "country": "ES",
  "shipment_id": "8",
  "weight": "1.500",
  "request_label": true
}

API Utilizada

Endpoint: POST /parcels
Base: Sendcloud API (via helper _sendcloudHelper)
Documentación: https://docs.sendcloud.sc/api/v2/

Notas

El número de casa (house_number) es obligatorio en direcciones europeas
El shipment_id es el ID del método de envío, no el ID del paquete; se obtiene con el nodo Métodos de Envío
El peso se expresa en kilogramos con 3 decimales (ej: 1.500)
El valor asegurado se expresa en centimos (ej: 5000 = 50.00 EUR)
La autenticación usa Basic Auth con public_key y secret_key
Si request_label es false, el paquete se crea sin etiqueta y se puede generar después