Pack Shipment
curl --request POST \
--url https://{base_url_domain}/api/global/v1/shipping/shipments/{id}/pack \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"packages": [
{
"actual_weight": {
"value": 20
},
"dimensions": {
"length": 8,
"width": 6,
"height": 4
},
"customs_value": {
"amount": 99,
"currency": "USD"
},
"declared_value": {
"amount": 99,
"currency": "USD"
},
"tracking_number": "<string>",
"tracking_description": "<string>",
"tracking_url": "<string>",
"tracking_ref": "<string>",
"alt_tracking_number": "<string>",
"alt_tracking_description": "<string>",
"sscc": "<string>",
"manifest_code": "<string>",
"items": [
{
"sku": "<string>",
"name": "<string>",
"quantity": 123,
"weight": {
"value": 20
},
"hazmat_unit_weight": {
"value": 20
},
"customs_value": {
"amount": 99,
"currency": "USD"
},
"order_item_id": 123,
"order_item_sku": "<string>",
"order_item_quantity": 123
}
],
"collected_data": {
"label": "<string>",
"value": "<string>"
}
}
],
"complete_packing": true,
"return_label": false,
"print_label": false,
"printers": {
"small_label": "small-printer-01",
"label": "label-printer-01",
"laser": "laser-printer-01"
},
"post_automation_url": "https://automation.example.com/shipment/packed",
"solution_override": {
"solution_id": 12345,
"reason": "Container size adjustment required",
"comment": "Customer requested specific packaging",
"mark_solution_invalid": false
},
"mark_solution_invalid": false,
"initial_solution_id": 54321,
"ship_offline": false,
"confirmed_instructions": {
"123": 2,
"456": 1
}
}
'import requests
url = "https://{base_url_domain}/api/global/v1/shipping/shipments/{id}/pack"
payload = {
"packages": [
{
"actual_weight": { "value": 20 },
"dimensions": {
"length": 8,
"width": 6,
"height": 4
},
"customs_value": {
"amount": 99,
"currency": "USD"
},
"declared_value": {
"amount": 99,
"currency": "USD"
},
"tracking_number": "<string>",
"tracking_description": "<string>",
"tracking_url": "<string>",
"tracking_ref": "<string>",
"alt_tracking_number": "<string>",
"alt_tracking_description": "<string>",
"sscc": "<string>",
"manifest_code": "<string>",
"items": [
{
"sku": "<string>",
"name": "<string>",
"quantity": 123,
"weight": { "value": 20 },
"hazmat_unit_weight": { "value": 20 },
"customs_value": {
"amount": 99,
"currency": "USD"
},
"order_item_id": 123,
"order_item_sku": "<string>",
"order_item_quantity": 123
}
],
"collected_data": {
"label": "<string>",
"value": "<string>"
}
}
],
"complete_packing": True,
"return_label": False,
"print_label": False,
"printers": {
"small_label": "small-printer-01",
"label": "label-printer-01",
"laser": "laser-printer-01"
},
"post_automation_url": "https://automation.example.com/shipment/packed",
"solution_override": {
"solution_id": 12345,
"reason": "Container size adjustment required",
"comment": "Customer requested specific packaging",
"mark_solution_invalid": False
},
"mark_solution_invalid": False,
"initial_solution_id": 54321,
"ship_offline": False,
"confirmed_instructions": {
"123": 2,
"456": 1
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
packages: [
{
actual_weight: {value: 20},
dimensions: {length: 8, width: 6, height: 4},
customs_value: {amount: 99, currency: 'USD'},
declared_value: {amount: 99, currency: 'USD'},
tracking_number: '<string>',
tracking_description: '<string>',
tracking_url: '<string>',
tracking_ref: '<string>',
alt_tracking_number: '<string>',
alt_tracking_description: '<string>',
sscc: '<string>',
manifest_code: '<string>',
items: [
{
sku: '<string>',
name: '<string>',
quantity: 123,
weight: {value: 20},
hazmat_unit_weight: {value: 20},
customs_value: {amount: 99, currency: 'USD'},
order_item_id: 123,
order_item_sku: '<string>',
order_item_quantity: 123
}
],
collected_data: {label: '<string>', value: '<string>'}
}
],
complete_packing: true,
return_label: false,
print_label: false,
printers: {
small_label: 'small-printer-01',
label: 'label-printer-01',
laser: 'laser-printer-01'
},
post_automation_url: 'https://automation.example.com/shipment/packed',
solution_override: {
solution_id: 12345,
reason: 'Container size adjustment required',
comment: 'Customer requested specific packaging',
mark_solution_invalid: false
},
mark_solution_invalid: false,
initial_solution_id: 54321,
ship_offline: false,
confirmed_instructions: {'123': 2, '456': 1}
})
};
fetch('https://{base_url_domain}/api/global/v1/shipping/shipments/{id}/pack', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{base_url_domain}/api/global/v1/shipping/shipments/{id}/pack",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'packages' => [
[
'actual_weight' => [
'value' => 20
],
'dimensions' => [
'length' => 8,
'width' => 6,
'height' => 4
],
'customs_value' => [
'amount' => 99,
'currency' => 'USD'
],
'declared_value' => [
'amount' => 99,
'currency' => 'USD'
],
'tracking_number' => '<string>',
'tracking_description' => '<string>',
'tracking_url' => '<string>',
'tracking_ref' => '<string>',
'alt_tracking_number' => '<string>',
'alt_tracking_description' => '<string>',
'sscc' => '<string>',
'manifest_code' => '<string>',
'items' => [
[
'sku' => '<string>',
'name' => '<string>',
'quantity' => 123,
'weight' => [
'value' => 20
],
'hazmat_unit_weight' => [
'value' => 20
],
'customs_value' => [
'amount' => 99,
'currency' => 'USD'
],
'order_item_id' => 123,
'order_item_sku' => '<string>',
'order_item_quantity' => 123
]
],
'collected_data' => [
'label' => '<string>',
'value' => '<string>'
]
]
],
'complete_packing' => true,
'return_label' => false,
'print_label' => false,
'printers' => [
'small_label' => 'small-printer-01',
'label' => 'label-printer-01',
'laser' => 'laser-printer-01'
],
'post_automation_url' => 'https://automation.example.com/shipment/packed',
'solution_override' => [
'solution_id' => 12345,
'reason' => 'Container size adjustment required',
'comment' => 'Customer requested specific packaging',
'mark_solution_invalid' => false
],
'mark_solution_invalid' => false,
'initial_solution_id' => 54321,
'ship_offline' => false,
'confirmed_instructions' => [
'123' => 2,
'456' => 1
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{base_url_domain}/api/global/v1/shipping/shipments/{id}/pack"
payload := strings.NewReader("{\n \"packages\": [\n {\n \"actual_weight\": {\n \"value\": 20\n },\n \"dimensions\": {\n \"length\": 8,\n \"width\": 6,\n \"height\": 4\n },\n \"customs_value\": {\n \"amount\": 99,\n \"currency\": \"USD\"\n },\n \"declared_value\": {\n \"amount\": 99,\n \"currency\": \"USD\"\n },\n \"tracking_number\": \"<string>\",\n \"tracking_description\": \"<string>\",\n \"tracking_url\": \"<string>\",\n \"tracking_ref\": \"<string>\",\n \"alt_tracking_number\": \"<string>\",\n \"alt_tracking_description\": \"<string>\",\n \"sscc\": \"<string>\",\n \"manifest_code\": \"<string>\",\n \"items\": [\n {\n \"sku\": \"<string>\",\n \"name\": \"<string>\",\n \"quantity\": 123,\n \"weight\": {\n \"value\": 20\n },\n \"hazmat_unit_weight\": {\n \"value\": 20\n },\n \"customs_value\": {\n \"amount\": 99,\n \"currency\": \"USD\"\n },\n \"order_item_id\": 123,\n \"order_item_sku\": \"<string>\",\n \"order_item_quantity\": 123\n }\n ],\n \"collected_data\": {\n \"label\": \"<string>\",\n \"value\": \"<string>\"\n }\n }\n ],\n \"complete_packing\": true,\n \"return_label\": false,\n \"print_label\": false,\n \"printers\": {\n \"small_label\": \"small-printer-01\",\n \"label\": \"label-printer-01\",\n \"laser\": \"laser-printer-01\"\n },\n \"post_automation_url\": \"https://automation.example.com/shipment/packed\",\n \"solution_override\": {\n \"solution_id\": 12345,\n \"reason\": \"Container size adjustment required\",\n \"comment\": \"Customer requested specific packaging\",\n \"mark_solution_invalid\": false\n },\n \"mark_solution_invalid\": false,\n \"initial_solution_id\": 54321,\n \"ship_offline\": false,\n \"confirmed_instructions\": {\n \"123\": 2,\n \"456\": 1\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://{base_url_domain}/api/global/v1/shipping/shipments/{id}/pack")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"packages\": [\n {\n \"actual_weight\": {\n \"value\": 20\n },\n \"dimensions\": {\n \"length\": 8,\n \"width\": 6,\n \"height\": 4\n },\n \"customs_value\": {\n \"amount\": 99,\n \"currency\": \"USD\"\n },\n \"declared_value\": {\n \"amount\": 99,\n \"currency\": \"USD\"\n },\n \"tracking_number\": \"<string>\",\n \"tracking_description\": \"<string>\",\n \"tracking_url\": \"<string>\",\n \"tracking_ref\": \"<string>\",\n \"alt_tracking_number\": \"<string>\",\n \"alt_tracking_description\": \"<string>\",\n \"sscc\": \"<string>\",\n \"manifest_code\": \"<string>\",\n \"items\": [\n {\n \"sku\": \"<string>\",\n \"name\": \"<string>\",\n \"quantity\": 123,\n \"weight\": {\n \"value\": 20\n },\n \"hazmat_unit_weight\": {\n \"value\": 20\n },\n \"customs_value\": {\n \"amount\": 99,\n \"currency\": \"USD\"\n },\n \"order_item_id\": 123,\n \"order_item_sku\": \"<string>\",\n \"order_item_quantity\": 123\n }\n ],\n \"collected_data\": {\n \"label\": \"<string>\",\n \"value\": \"<string>\"\n }\n }\n ],\n \"complete_packing\": true,\n \"return_label\": false,\n \"print_label\": false,\n \"printers\": {\n \"small_label\": \"small-printer-01\",\n \"label\": \"label-printer-01\",\n \"laser\": \"laser-printer-01\"\n },\n \"post_automation_url\": \"https://automation.example.com/shipment/packed\",\n \"solution_override\": {\n \"solution_id\": 12345,\n \"reason\": \"Container size adjustment required\",\n \"comment\": \"Customer requested specific packaging\",\n \"mark_solution_invalid\": false\n },\n \"mark_solution_invalid\": false,\n \"initial_solution_id\": 54321,\n \"ship_offline\": false,\n \"confirmed_instructions\": {\n \"123\": 2,\n \"456\": 1\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{base_url_domain}/api/global/v1/shipping/shipments/{id}/pack")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"packages\": [\n {\n \"actual_weight\": {\n \"value\": 20\n },\n \"dimensions\": {\n \"length\": 8,\n \"width\": 6,\n \"height\": 4\n },\n \"customs_value\": {\n \"amount\": 99,\n \"currency\": \"USD\"\n },\n \"declared_value\": {\n \"amount\": 99,\n \"currency\": \"USD\"\n },\n \"tracking_number\": \"<string>\",\n \"tracking_description\": \"<string>\",\n \"tracking_url\": \"<string>\",\n \"tracking_ref\": \"<string>\",\n \"alt_tracking_number\": \"<string>\",\n \"alt_tracking_description\": \"<string>\",\n \"sscc\": \"<string>\",\n \"manifest_code\": \"<string>\",\n \"items\": [\n {\n \"sku\": \"<string>\",\n \"name\": \"<string>\",\n \"quantity\": 123,\n \"weight\": {\n \"value\": 20\n },\n \"hazmat_unit_weight\": {\n \"value\": 20\n },\n \"customs_value\": {\n \"amount\": 99,\n \"currency\": \"USD\"\n },\n \"order_item_id\": 123,\n \"order_item_sku\": \"<string>\",\n \"order_item_quantity\": 123\n }\n ],\n \"collected_data\": {\n \"label\": \"<string>\",\n \"value\": \"<string>\"\n }\n }\n ],\n \"complete_packing\": true,\n \"return_label\": false,\n \"print_label\": false,\n \"printers\": {\n \"small_label\": \"small-printer-01\",\n \"label\": \"label-printer-01\",\n \"laser\": \"laser-printer-01\"\n },\n \"post_automation_url\": \"https://automation.example.com/shipment/packed\",\n \"solution_override\": {\n \"solution_id\": 12345,\n \"reason\": \"Container size adjustment required\",\n \"comment\": \"Customer requested specific packaging\",\n \"mark_solution_invalid\": false\n },\n \"mark_solution_invalid\": false,\n \"initial_solution_id\": 54321,\n \"ship_offline\": false,\n \"confirmed_instructions\": {\n \"123\": 2,\n \"456\": 1\n }\n}"
response = http.request(request)
puts response.read_body{
"warnings": [
"Address validation warning"
],
"labels": {
"shipping_label": "aSDinaTvuI8gbWludGxpZnk=",
"customs_documents": "aSDinaTvuI8gbWludGxpZnk=",
"bill_of_lading": "aSDinaTvuI8gbWludGxpZnk=",
"hazmat_shipping_papers": "aSDinaTvuI8gbWludGxpZnk=",
"hazmat_shippers_declaration": "aSDinaTvuI8gbWludGxpZnk=",
"sscc_pack_label": "aSDinaTvuI8gbWludGxpZnk="
},
"messages": [
"Labels have been sent to the label printer (label-printer-01).",
"Customs Documents have been sent to the laser printer (laser-printer-01)."
]
}{
"errors": [
{
"type": "parameters",
"message": "The supplied parameters are invalid."
}
]
}{
"errors": [
{
"type": "not_found",
"message": "The server could not find the requested resource."
}
]
}{
"errors": [
{
"type": "unable_to_process",
"message": "There was an error processing the request."
}
]
}Shipments
Pack Shipment
This endpoint can be used in multiple modes of operation and in all cases operates on a Shipment specified by its id path parameter.
The available modes are:
- Pack and Label: Create packages for a shipment and complete packing (create label if supported) in one step.
- Pack Only: Create packages for a shipment without completing packing.
- Complete Packing: Complete the packing of a shipment (creates a label if supported) in the “packing” status which was previously packed with the second mode.
Additionally, many of the parameters are optional, in which case the system will attempt to intelligently determine the best course of action based on the current state of the shipment and its contents. For example, if the Shipment has a Packing Solution and no package details are provided, the system will assume the containers specified by the Packing Solution were used and thus create the packages accordingly.
POST
/
v1
/
shipping
/
shipments
/
{id}
/
pack
Pack Shipment
curl --request POST \
--url https://{base_url_domain}/api/global/v1/shipping/shipments/{id}/pack \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"packages": [
{
"actual_weight": {
"value": 20
},
"dimensions": {
"length": 8,
"width": 6,
"height": 4
},
"customs_value": {
"amount": 99,
"currency": "USD"
},
"declared_value": {
"amount": 99,
"currency": "USD"
},
"tracking_number": "<string>",
"tracking_description": "<string>",
"tracking_url": "<string>",
"tracking_ref": "<string>",
"alt_tracking_number": "<string>",
"alt_tracking_description": "<string>",
"sscc": "<string>",
"manifest_code": "<string>",
"items": [
{
"sku": "<string>",
"name": "<string>",
"quantity": 123,
"weight": {
"value": 20
},
"hazmat_unit_weight": {
"value": 20
},
"customs_value": {
"amount": 99,
"currency": "USD"
},
"order_item_id": 123,
"order_item_sku": "<string>",
"order_item_quantity": 123
}
],
"collected_data": {
"label": "<string>",
"value": "<string>"
}
}
],
"complete_packing": true,
"return_label": false,
"print_label": false,
"printers": {
"small_label": "small-printer-01",
"label": "label-printer-01",
"laser": "laser-printer-01"
},
"post_automation_url": "https://automation.example.com/shipment/packed",
"solution_override": {
"solution_id": 12345,
"reason": "Container size adjustment required",
"comment": "Customer requested specific packaging",
"mark_solution_invalid": false
},
"mark_solution_invalid": false,
"initial_solution_id": 54321,
"ship_offline": false,
"confirmed_instructions": {
"123": 2,
"456": 1
}
}
'import requests
url = "https://{base_url_domain}/api/global/v1/shipping/shipments/{id}/pack"
payload = {
"packages": [
{
"actual_weight": { "value": 20 },
"dimensions": {
"length": 8,
"width": 6,
"height": 4
},
"customs_value": {
"amount": 99,
"currency": "USD"
},
"declared_value": {
"amount": 99,
"currency": "USD"
},
"tracking_number": "<string>",
"tracking_description": "<string>",
"tracking_url": "<string>",
"tracking_ref": "<string>",
"alt_tracking_number": "<string>",
"alt_tracking_description": "<string>",
"sscc": "<string>",
"manifest_code": "<string>",
"items": [
{
"sku": "<string>",
"name": "<string>",
"quantity": 123,
"weight": { "value": 20 },
"hazmat_unit_weight": { "value": 20 },
"customs_value": {
"amount": 99,
"currency": "USD"
},
"order_item_id": 123,
"order_item_sku": "<string>",
"order_item_quantity": 123
}
],
"collected_data": {
"label": "<string>",
"value": "<string>"
}
}
],
"complete_packing": True,
"return_label": False,
"print_label": False,
"printers": {
"small_label": "small-printer-01",
"label": "label-printer-01",
"laser": "laser-printer-01"
},
"post_automation_url": "https://automation.example.com/shipment/packed",
"solution_override": {
"solution_id": 12345,
"reason": "Container size adjustment required",
"comment": "Customer requested specific packaging",
"mark_solution_invalid": False
},
"mark_solution_invalid": False,
"initial_solution_id": 54321,
"ship_offline": False,
"confirmed_instructions": {
"123": 2,
"456": 1
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
packages: [
{
actual_weight: {value: 20},
dimensions: {length: 8, width: 6, height: 4},
customs_value: {amount: 99, currency: 'USD'},
declared_value: {amount: 99, currency: 'USD'},
tracking_number: '<string>',
tracking_description: '<string>',
tracking_url: '<string>',
tracking_ref: '<string>',
alt_tracking_number: '<string>',
alt_tracking_description: '<string>',
sscc: '<string>',
manifest_code: '<string>',
items: [
{
sku: '<string>',
name: '<string>',
quantity: 123,
weight: {value: 20},
hazmat_unit_weight: {value: 20},
customs_value: {amount: 99, currency: 'USD'},
order_item_id: 123,
order_item_sku: '<string>',
order_item_quantity: 123
}
],
collected_data: {label: '<string>', value: '<string>'}
}
],
complete_packing: true,
return_label: false,
print_label: false,
printers: {
small_label: 'small-printer-01',
label: 'label-printer-01',
laser: 'laser-printer-01'
},
post_automation_url: 'https://automation.example.com/shipment/packed',
solution_override: {
solution_id: 12345,
reason: 'Container size adjustment required',
comment: 'Customer requested specific packaging',
mark_solution_invalid: false
},
mark_solution_invalid: false,
initial_solution_id: 54321,
ship_offline: false,
confirmed_instructions: {'123': 2, '456': 1}
})
};
fetch('https://{base_url_domain}/api/global/v1/shipping/shipments/{id}/pack', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{base_url_domain}/api/global/v1/shipping/shipments/{id}/pack",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'packages' => [
[
'actual_weight' => [
'value' => 20
],
'dimensions' => [
'length' => 8,
'width' => 6,
'height' => 4
],
'customs_value' => [
'amount' => 99,
'currency' => 'USD'
],
'declared_value' => [
'amount' => 99,
'currency' => 'USD'
],
'tracking_number' => '<string>',
'tracking_description' => '<string>',
'tracking_url' => '<string>',
'tracking_ref' => '<string>',
'alt_tracking_number' => '<string>',
'alt_tracking_description' => '<string>',
'sscc' => '<string>',
'manifest_code' => '<string>',
'items' => [
[
'sku' => '<string>',
'name' => '<string>',
'quantity' => 123,
'weight' => [
'value' => 20
],
'hazmat_unit_weight' => [
'value' => 20
],
'customs_value' => [
'amount' => 99,
'currency' => 'USD'
],
'order_item_id' => 123,
'order_item_sku' => '<string>',
'order_item_quantity' => 123
]
],
'collected_data' => [
'label' => '<string>',
'value' => '<string>'
]
]
],
'complete_packing' => true,
'return_label' => false,
'print_label' => false,
'printers' => [
'small_label' => 'small-printer-01',
'label' => 'label-printer-01',
'laser' => 'laser-printer-01'
],
'post_automation_url' => 'https://automation.example.com/shipment/packed',
'solution_override' => [
'solution_id' => 12345,
'reason' => 'Container size adjustment required',
'comment' => 'Customer requested specific packaging',
'mark_solution_invalid' => false
],
'mark_solution_invalid' => false,
'initial_solution_id' => 54321,
'ship_offline' => false,
'confirmed_instructions' => [
'123' => 2,
'456' => 1
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{base_url_domain}/api/global/v1/shipping/shipments/{id}/pack"
payload := strings.NewReader("{\n \"packages\": [\n {\n \"actual_weight\": {\n \"value\": 20\n },\n \"dimensions\": {\n \"length\": 8,\n \"width\": 6,\n \"height\": 4\n },\n \"customs_value\": {\n \"amount\": 99,\n \"currency\": \"USD\"\n },\n \"declared_value\": {\n \"amount\": 99,\n \"currency\": \"USD\"\n },\n \"tracking_number\": \"<string>\",\n \"tracking_description\": \"<string>\",\n \"tracking_url\": \"<string>\",\n \"tracking_ref\": \"<string>\",\n \"alt_tracking_number\": \"<string>\",\n \"alt_tracking_description\": \"<string>\",\n \"sscc\": \"<string>\",\n \"manifest_code\": \"<string>\",\n \"items\": [\n {\n \"sku\": \"<string>\",\n \"name\": \"<string>\",\n \"quantity\": 123,\n \"weight\": {\n \"value\": 20\n },\n \"hazmat_unit_weight\": {\n \"value\": 20\n },\n \"customs_value\": {\n \"amount\": 99,\n \"currency\": \"USD\"\n },\n \"order_item_id\": 123,\n \"order_item_sku\": \"<string>\",\n \"order_item_quantity\": 123\n }\n ],\n \"collected_data\": {\n \"label\": \"<string>\",\n \"value\": \"<string>\"\n }\n }\n ],\n \"complete_packing\": true,\n \"return_label\": false,\n \"print_label\": false,\n \"printers\": {\n \"small_label\": \"small-printer-01\",\n \"label\": \"label-printer-01\",\n \"laser\": \"laser-printer-01\"\n },\n \"post_automation_url\": \"https://automation.example.com/shipment/packed\",\n \"solution_override\": {\n \"solution_id\": 12345,\n \"reason\": \"Container size adjustment required\",\n \"comment\": \"Customer requested specific packaging\",\n \"mark_solution_invalid\": false\n },\n \"mark_solution_invalid\": false,\n \"initial_solution_id\": 54321,\n \"ship_offline\": false,\n \"confirmed_instructions\": {\n \"123\": 2,\n \"456\": 1\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://{base_url_domain}/api/global/v1/shipping/shipments/{id}/pack")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"packages\": [\n {\n \"actual_weight\": {\n \"value\": 20\n },\n \"dimensions\": {\n \"length\": 8,\n \"width\": 6,\n \"height\": 4\n },\n \"customs_value\": {\n \"amount\": 99,\n \"currency\": \"USD\"\n },\n \"declared_value\": {\n \"amount\": 99,\n \"currency\": \"USD\"\n },\n \"tracking_number\": \"<string>\",\n \"tracking_description\": \"<string>\",\n \"tracking_url\": \"<string>\",\n \"tracking_ref\": \"<string>\",\n \"alt_tracking_number\": \"<string>\",\n \"alt_tracking_description\": \"<string>\",\n \"sscc\": \"<string>\",\n \"manifest_code\": \"<string>\",\n \"items\": [\n {\n \"sku\": \"<string>\",\n \"name\": \"<string>\",\n \"quantity\": 123,\n \"weight\": {\n \"value\": 20\n },\n \"hazmat_unit_weight\": {\n \"value\": 20\n },\n \"customs_value\": {\n \"amount\": 99,\n \"currency\": \"USD\"\n },\n \"order_item_id\": 123,\n \"order_item_sku\": \"<string>\",\n \"order_item_quantity\": 123\n }\n ],\n \"collected_data\": {\n \"label\": \"<string>\",\n \"value\": \"<string>\"\n }\n }\n ],\n \"complete_packing\": true,\n \"return_label\": false,\n \"print_label\": false,\n \"printers\": {\n \"small_label\": \"small-printer-01\",\n \"label\": \"label-printer-01\",\n \"laser\": \"laser-printer-01\"\n },\n \"post_automation_url\": \"https://automation.example.com/shipment/packed\",\n \"solution_override\": {\n \"solution_id\": 12345,\n \"reason\": \"Container size adjustment required\",\n \"comment\": \"Customer requested specific packaging\",\n \"mark_solution_invalid\": false\n },\n \"mark_solution_invalid\": false,\n \"initial_solution_id\": 54321,\n \"ship_offline\": false,\n \"confirmed_instructions\": {\n \"123\": 2,\n \"456\": 1\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{base_url_domain}/api/global/v1/shipping/shipments/{id}/pack")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"packages\": [\n {\n \"actual_weight\": {\n \"value\": 20\n },\n \"dimensions\": {\n \"length\": 8,\n \"width\": 6,\n \"height\": 4\n },\n \"customs_value\": {\n \"amount\": 99,\n \"currency\": \"USD\"\n },\n \"declared_value\": {\n \"amount\": 99,\n \"currency\": \"USD\"\n },\n \"tracking_number\": \"<string>\",\n \"tracking_description\": \"<string>\",\n \"tracking_url\": \"<string>\",\n \"tracking_ref\": \"<string>\",\n \"alt_tracking_number\": \"<string>\",\n \"alt_tracking_description\": \"<string>\",\n \"sscc\": \"<string>\",\n \"manifest_code\": \"<string>\",\n \"items\": [\n {\n \"sku\": \"<string>\",\n \"name\": \"<string>\",\n \"quantity\": 123,\n \"weight\": {\n \"value\": 20\n },\n \"hazmat_unit_weight\": {\n \"value\": 20\n },\n \"customs_value\": {\n \"amount\": 99,\n \"currency\": \"USD\"\n },\n \"order_item_id\": 123,\n \"order_item_sku\": \"<string>\",\n \"order_item_quantity\": 123\n }\n ],\n \"collected_data\": {\n \"label\": \"<string>\",\n \"value\": \"<string>\"\n }\n }\n ],\n \"complete_packing\": true,\n \"return_label\": false,\n \"print_label\": false,\n \"printers\": {\n \"small_label\": \"small-printer-01\",\n \"label\": \"label-printer-01\",\n \"laser\": \"laser-printer-01\"\n },\n \"post_automation_url\": \"https://automation.example.com/shipment/packed\",\n \"solution_override\": {\n \"solution_id\": 12345,\n \"reason\": \"Container size adjustment required\",\n \"comment\": \"Customer requested specific packaging\",\n \"mark_solution_invalid\": false\n },\n \"mark_solution_invalid\": false,\n \"initial_solution_id\": 54321,\n \"ship_offline\": false,\n \"confirmed_instructions\": {\n \"123\": 2,\n \"456\": 1\n }\n}"
response = http.request(request)
puts response.read_body{
"warnings": [
"Address validation warning"
],
"labels": {
"shipping_label": "aSDinaTvuI8gbWludGxpZnk=",
"customs_documents": "aSDinaTvuI8gbWludGxpZnk=",
"bill_of_lading": "aSDinaTvuI8gbWludGxpZnk=",
"hazmat_shipping_papers": "aSDinaTvuI8gbWludGxpZnk=",
"hazmat_shippers_declaration": "aSDinaTvuI8gbWludGxpZnk=",
"sscc_pack_label": "aSDinaTvuI8gbWludGxpZnk="
},
"messages": [
"Labels have been sent to the label printer (label-printer-01).",
"Customs Documents have been sent to the laser printer (laser-printer-01)."
]
}{
"errors": [
{
"type": "parameters",
"message": "The supplied parameters are invalid."
}
]
}{
"errors": [
{
"type": "not_found",
"message": "The server could not find the requested resource."
}
]
}{
"errors": [
{
"type": "unable_to_process",
"message": "There was an error processing the request."
}
]
}Authorizations
Generate a JWT access token through a Custom Global Integration and provide it with each request in the Authorization header prefixed with "Bearer" and then a single space.
Path Parameters
The id of the referenced Shipment.
Required range:
x >= 1Body
application/json
Optional request parameters for packing, labeling, and printing operations.
Describes each package and its contents. If not provided, and the Shipment has a Packing Solution, the Packing Solution containers will be used to create the packages. If neither are provided, the system will attempt to create a single package containing all items in the shipment.
Show child attributes
Show child attributes
If true, the packing process will be completed and the shipment status will advance to 'Packed'. Otherwise, the packages will be saved and the shipment status will advance only to 'Packing'. A second request without the packages property and with complete_packing set to true is then required to complete the packing process using the package data from the first request (two-step).
Required to be true if return_label or print_label is true and no existing label exists.
Example:
true
Whether to return the generated shipping labels in the response as base64-encoded PDF data.
Requires complete_packing to be true or an existing shipping label to be present.
Labels are returned in the response under the labels key.
Example:
false
Whether to send the generated labels to the specified printers.
Requires complete_packing to be true or an existing shipping label to be present.
Must specify the appropriate printer parameters based on shipment type and documents returned by the carrier API.
Example:
false
Specifies the printers to be used. The required printers depend on the shipment contents and type when print_label is true.
small_labelis required for printing SSCC labels when the print target is configured for small labels.labelis required for parcel shipping labels or for SSCC labels when the print target is configured for standard labels.laseris required for freight shipments, hazmat shipments, or other documents like customs forms and bills of lading.
Show child attributes
Show child attributes
URL to send shipment data to after successful packing operation. Must be a valid HTTP or HTTPS URL. Shipment data including ID, tracking info, and package data will be transmitted to this URL via an HTTP POST request synchronously. Any 200 response will be considered a success. Any non-200 response will be considered an error, and the request body will be truncated to 255 characters and displayed to the user and added as a history comment to the order.
The JSON-encoded payload contains the following keys: shipment_id, external_id, order_unique_id, order_ref, carrier_code, shipping_method, batch_tag, automation_data, website_code, store_code, shipment_weight, shipment_weight_unit, order_weight, order_weight_unit, is_international, is_documents_required, and stock_id.
Example:
"https://automation.example.com/shipment/packed"
Packing solution override parameters for manual or automatic solution adjustment. Used to specify alternative packing solutions or create new ones.
Show child attributes
Show child attributes
Whether to mark the current packing solution as invalid/disabled.
When true, disables the current solution after packing is complete.
Cannot be used in combination with other solution override parameters.
Example:
false
ID of the initial packing solution to set on the shipment before processing. Used to establish a baseline solution before applying any overrides.
Example:
54321
Whether to pack the shipment in offline mode without carrier API integration.
When true, skips carrier API calls and address validation.
Useful for situations where carrier services are unavailable.
Example:
false
Object mapping instruction IDs to quantities for order instructions that have been confirmed. Keys are instruction IDs (as strings), values are the quantities confirmed. Used to record fulfillment of special order instructions during packing.
Show child attributes
Show child attributes
Example:
{ "123": 2, "456": 1 }
Response
Shipment packed successfully
Any warnings generated during the packing process
Example:
["Address validation warning"]
Base64-encoded PDF labels (returned only when return_label is true).
Available keys depend on shipment type and requirements.
Show child attributes
Show child attributes
Status messages about printing operations (returned only when print_label is true)
Example:
[
"Labels have been sent to the label printer (label-printer-01).",
"Customs Documents have been sent to the laser printer (laser-printer-01)."
]
Was this page helpful?