SevenSenders - Crear Envio

Descripcion

Este modulo crea un envio en SevenSenders. Recibe el codigo del transportista, los datos del destinatario y remitente en formato JSON, los paquetes como array JSON con dimensiones y peso, y una referencia opcional. Realiza una peticion POST al endpoint /shipments y retorna el ID del envio, numero de seguimiento, transportista, estado y URL de la etiqueta. SevenSenders es una plataforma europea de gestion de envios que conecta con multiples transportistas.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Credencial SevenSenders (provider: sevensenders)
carrier	text	Si	Codigo del transportista
recipient	textarea	Si	Datos del destinatario en formato JSON
shipper	textarea	Si	Datos del remitente en formato JSON
parcels	textarea	Si	Array de paquetes en JSON con dimensiones y peso
reference	text	No	Referencia interna del envio

Credenciales

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

• api_key: API Key de SevenSenders

Las credenciales se obtienen desde el panel de SevenSenders (https://app.sevensenders.com/).

Salida

{
  "success": true,
  "shipment_id": "ss-12345",
  "tracking_number": "DE123456789",
  "carrier": "dhl_de",
  "status": "created",
  "label_url": "https://api.sevensenders.com/labels/ss-12345.pdf",
  "message": "Envio creado - ID: ss-12345"
}

Ejemplo de Uso

Caso basico

{
  "credentials_id": "mi_credencial_sevensenders",
  "carrier": "dhl_de",
  "recipient": "{\"name\":\"Kunde\",\"street\":\"Berliner Str. 10\",\"city\":\"Berlin\",\"postal_code\":\"10115\",\"country\":\"DE\"}",
  "shipper": "{\"name\":\"Mi Empresa\",\"street\":\"Calle Gran Via 1\",\"city\":\"Madrid\",\"postal_code\":\"28001\",\"country\":\"ES\"}",
  "parcels": "[{\"weight\":2.5,\"length\":25,\"width\":15,\"height\":10}]",
  "reference": "ORD-001"
}

API Utilizada

• Endpoint: POST /shipments
• Base: SevenSenders API (via helper _sevensendersHelper)
• Documentacion: https://docs.sevensenders.com/

Notas

• Los paquetes se envian siempre como array; si se pasa un objeto individual, se convierte automaticamente
• El codigo del transportista se obtiene con el nodo Obtener Transportistas
• SevenSenders opera principalmente en el mercado europeo
• La referencia es opcional pero recomendada para correlacionar con pedidos internos

Nodos Relacionados

• SevenSenders - Obtener Transportistas (sevensendersGetCarriers)
• SevenSenders - Rastrear Envio (sevensendersGetTracking)
• SevenSenders - Cancelar Envio (sevensendersCancelShipment)
• SevenSenders - Obtener Etiquetas (sevensendersGetLabels)