SevenSenders - Create Shipment

Description

This module creates a shipment in SevenSenders. It receives the carrier code, recipient and shipper data in JSON format, packages as a JSON array with dimensions and weight, and an optional reference. It makes a POST request to the /shipments endpoint and returns the shipment ID, tracking number, carrier, status, and label URL. SevenSenders is a European shipping management platform that connects with multiple carriers.

Configuration

Parameter	Type	Required	Description
credentials_id	credentials	Yes	SevenSenders credential (provider: sevensenders)
carrier	text	Yes	Carrier code
recipient	textarea	Yes	Recipient data in JSON format
shipper	textarea	Yes	Shipper data in JSON format
parcels	textarea	Yes	Array of packages in JSON with dimensions and weight
reference	text	No	Internal shipment reference

Credentials

A sevensenders type credential is required with the following fields:

• api_key: SevenSenders API Key

Credentials are obtained from the SevenSenders dashboard (https://app.sevensenders.com/).

Output

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

Usage Example

Basic case

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

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

Notes

• Packages are always sent as an array; if an individual object is passed, it is automatically converted
• The carrier code is obtained with the Get Carriers node
• SevenSenders operates primarily in the European market
• The reference is optional but recommended for correlating with internal orders

Related Nodes

• SevenSenders - Get Carriers (sevensendersGetCarriers)
• SevenSenders - Track Shipment (sevensendersGetTracking)
• SevenSenders - Cancel Shipment (sevensendersCancelShipment)
• SevenSenders - Get Labels (sevensendersGetLabels)