SEUR - Create Shipment

Description

This module creates a shipment in SEUR. It receives the sender and recipient data in JSON format, the product type (standard, express, 48h, 72h), weight, number of packages, reference, and description. It makes a POST request to the /shipments endpoint and returns the shipment ID, tracking number, tracking URL, label URL, selected product, and status. SEUR is one of the main carriers in Spain and Portugal.

Configuration

Parameter	Type	Required	Description
credentials_id	credentials	Yes	SEUR credential (provider: seur)
sender	textarea	Yes	Sender data in JSON (name, address, city, postal_code, country, phone)
receiver	textarea	Yes	Recipient data in JSON
product	select	Yes	Product type: standard, express, 48h, 72h
weight	text	Yes	Package weight in kg (e.g.: 1.500)
packages_count	text	No	Number of packages (default: 1)
reference	text	No	Internal shipment reference
description	text	No	Content description

Credentials

A seur type credential is required with the following fields:

• api_token: SEUR API Token

Credentials are obtained from the SEUR customer portal.

Output

{
  "success": true,
  "shipment_id": "SEUR-12345",
  "tracking_number": "5012345678901",
  "tracking_url": "https://www.seur.com/livetracking/...",
  "label_url": "https://api.seur.com/labels/SEUR-12345.pdf",
  "product": "express",
  "reference": "ORD-001",
  "status": "CREATED",
  "message": "Envio SEUR creado - Tracking: 5012345678901"
}

Usage Example

Basic case

{
  "credentials_id": "mi_credencial_seur",
  "sender": "{\"name\":\"Mi Empresa\",\"address\":\"Calle Gran Via 1\",\"city\":\"Madrid\",\"postal_code\":\"28001\",\"country\":\"ES\",\"phone\":\"+34600000000\"}",
  "receiver": "{\"name\":\"Cliente\",\"address\":\"Av Diagonal 100\",\"city\":\"Barcelona\",\"postal_code\":\"08001\",\"country\":\"ES\",\"phone\":\"+34600000001\"}",
  "product": "express",
  "weight": "2.500"
}

API Used

• Endpoint: POST /shipments
• Base: SEUR API (via helper _seurHelper)
• Documentation: https://www.seur.com/

Notes

• The default number of packages is 1
• Weight is expressed in kilograms
• SEUR operates primarily in Spain and Portugal
• Available products are: standard, express, 48h, and 72h

Related Nodes

• SEUR - Get Rates (seurGetRates)
• SEUR - Track Shipment (seurGetTracking)
• SEUR - Cancel Shipment (seurCancelShipment)
• SEUR - Get Label (seurGetLabel)