Sendcloud - Crear Paquete / Etiqueta

Descripcion

Este modulo crea un paquete en Sendcloud con todos los datos del destinatario y opcionalmente genera la etiqueta de envio. Recibe los campos individuales del destinatario (nombre, empresa, direccion, numero de casa, ciudad, codigo postal, pais, telefono, email), el ID del metodo de envio, peso, numero de pedido, valor asegurado, valor total y si se debe generar la etiqueta inmediatamente. Realiza una peticion POST al endpoint /parcels y retorna el ID del paquete, numero de seguimiento, URL de rastreo, URL de la etiqueta, transportista y estado.

Configuracion

Parametro	Tipo	Requerido	Descripcion
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	Numero de la casa (obligatorio en Europa)
address_2	text	No	Direccion linea 2
city	text	Si	Ciudad
postal_code	text	Si	Codigo postal
country	text	Si	Codigo ISO 2 letras del pais (por defecto: ES)
telephone	text	No	Numero de telefono
email	text	No	Direccion de email
shipment_id	text	Si	ID del metodo de envio (obtenido del nodo Metodos de Envio)
weight	text	Si	Peso del paquete en kg (ej: 1.500)
order_number	text	No	Numero 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 basico

{
  "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)
Documentacion: https://docs.sendcloud.sc/api/v2/

Notas

El numero de casa (house_number) es obligatorio en direcciones europeas
El shipment_id es el ID del metodo de envio, no el ID del paquete; se obtiene con el nodo Metodos de Envio
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 autenticacion usa Basic Auth con public_key y secret_key
Si request_label es false, el paquete se crea sin etiqueta y se puede generar despues