Create Son package

Creates a Son package for a single order. Each order requires its own Son package.

POST /api/v2/packages

Create Son package

cURL

curl --request POST \
  --url https://live.nocnocstore.com/api/v2/packages \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <x-api-key>' \
  --data '
{
  "order_reference_id": "<string>",
  "labels": [
    {}
  ],
  "items": [
    {}
  ]
}
'

201

{
  "package_id": "PK111"
}

Requests go to the live environment — all actions are real.

nocnoc manages two types of packages: Son and Father. Create a Son package per order, then group multiple Son packages into a Father package for consolidated first-mile shipping.

Authorization

X-Api-Key · string · required

Your seller API key. Provided by your nocnoc account manager.

Body parameters

order_reference_id · string · required

The reference ID of the order included in this package.

labels · array · required

Array of label objects. Minimum 1, maximum 10. Each object contains:

• tracking_code (string) — tracking code of the package
• carrier (string) — first-mile carrier (e.g. "FedEx", "UPS"). Use "nocnoc" for a nocnoc label
• url (string) — URL to track the order

items · array · required

Array of item objects inside the package. Minimum 1, maximum 10. Each object contains:

• sku (string) — item SKU, between 1 and 45 characters
• quantity (integer) — quantity of the item, between 0 and 9999

Returns

The created Son package object with its package ID, which you’ll need to create a Father package.

Example request

curl -X POST https://live.nocnocstore.com/api/v2/packages \
  -H "X-Api-Key: YOUR_SELLER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "order_reference_id": "NC0000",
    "labels": [
      {
        "tracking_code": "1234",
        "carrier": "nocnoc",
        "url": "https://tracking.example.com/1234"
      }
    ],
    "items": [
      {
        "sku": "SKU00000000",
        "quantity": 1
      }
    ]
  }'

201

{
  "package_id": "PK111"
}