📦 Order Creation & Bundling Workflow

There are two ways to create multiple orders and group them into a single delivery bundle using the orderBundle system:

✅ Preferred Method: Explicit Bundling via orderBundleId

1. Create the first order without an orderBundleId. The response will include an orderBundle object:

"orderBundle": {
    "id": 2829,
    "bundleId": "VNN1UY7TMSY81P8Q4A2C7"
}

1. Use the returned bundleId to create additional orders and connect them to the same delivery bundle:

{
    "orderRef": "O-TEST-2",
    "orderBundleId": "VNN1UY7TMSY81P8Q4A2C7",
    ...
}

This method is most versatile, as it allows different orderRefs, dimensions, weight and other customizations per order.

⚡ Alternative Method: Implicit Bundling via load

You can create multiple bundled orders in one request by setting the load value to the desired number:

{
    "orderRef": "O-TEST",
    "load": 2,
    ...
}

1. The API will generate load number of orders, all bundled under the same orderBundle.
2. Only one of the created orders is returned in the response.
3. All orders will have identical specs (dimensions, address, etc.).

Use this for quick bulk creation, but note that it’s less flexible than the explicit bundling method.

📦 Dimension Convention

When specifying package dimensions, we follow a standardized order to avoid confusion:

📦

Length ≥ Width ≥ Height

• Length: the longest side of the package
• Width: the middle-sized side
• Height: the shortest side (typically vertical when the package is upright)

This ordering ensures consistent validation across systems and carriers.
Please make sure to sort dimensions accordingly before sending them in the request.

If dimensions are not ordered correctly, your package may be incorrectly rejected.