Used to combine sets of shipments

POST

/shipment/batch/connectSet

Maintainer:Not configured

This method is used for merging shipments into a batch.

To be able to merge shipments into a batch, you must, when creating a shipment that you want to merge later, include in the POST shipment/batch request body the flag "additionallyAdded": true and in the external numbers provide the external number ESPN. A shipment created in this way can then be merged into a batch with other shipments created in the same way using this method.

Conditions for merging

only shipments of the same productType can be merged

shipments with COD cannot be merged

shipments can only be merged until they are physically weighed at the depot

Smart2Box shipments cannot be merged

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json-patch+json

Example

{
    "externalSetNumber": "string",
    "shipmentNumbers": [
        "string"
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/shipment/batch/connectSet' \
--header 'Accept-Language;' \
--header 'X-Correlation-ID;' \
--header 'X-LogLevel;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json-patch+json' \
--data-raw '{
    "externalSetNumber": "string",
    "shipmentNumbers": [
        "string"
    ]
}'

Responses

🟢200OK

application/json

Success

Headers

Body

Example

{
    "masterShipmentNumber": "string",
    "shipmentNumbers": [
        "string"
    ]
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠409409

🔴500Server Error

🔴503Service Unavailable

Modified at 2025-09-09 11:07:25

Shipment creation

Used to modify the output format of the label.