Export Packing Layout

The packing_layout field is available on the wholesale_order and wholesale_orders queries as well as the Shipment ASN webhook. It returns the full packing structure of a wholesale order once it has been packed. If the order is not yet packed, the field returns null.

For query examples, see Querying Wholesale Orders.

The layout is returned as a JSON object containing timestamps and a containers array with the full container hierarchy.

Response structure

The packing_layout object contains:

Field	Type	Description
`created_at`	string	Timestamp when the packing configuration was created
`updated_at`	string	Timestamp when the packing configuration was last updated
`containers`	array	Top-level containers (the root of the packing hierarchy)

Common field definitions

Details

Every container includes a details object with physical attributes:

Field	Type	Description
`height`	float	Height in inches
`length`	float	Length in inches
`width`	float	Width in inches
`weight_in_oz`	float	Weight in ounces
`sscc_barcode`	string or null	SSCC barcode identifier. This is the preferred barcode field
`barcode`	string or null	Legacy barcode field. Use `sscc_barcode` instead — this field will be removed in a future version
`shipping_box_id`	string or null	Reference to a predefined shipping box type
`container_number`	int	Sequential number for this container

Line items

Line items represent individual product units packed directly inside a container:

Field	Type	Description
`order_line_item_id`	int	The order line item ID being packed
`partner_line_item_id`	string	Partner-provided line item identifier
`sku`	string	Product SKU
`name`	string	Product name
`quantity`	int	Number of units packed
`lot`	object or null	Lot details (see below)

Lot details

Present when lot tracking is enabled for the product:

Field	Type	Description
`id`	int	Lot ID
`name`	string	Lot name
`expiration_date`	string or null	Lot expiration date (ISO format)

Shipping details

Present on top-level containers in courier orders when a shipping label has been created. Always null on nested containers, freight containers, and when the order is packed but not yet shipped.

Field	Type	Description
`carrier`	string	Carrier name
`shipping_method`	string	Shipping method
`scac`	string or null	Standard Carrier Alpha Code
`tracking_number`	string or null	Tracking number

Both top-level Packages and top-level CasePacks can have shipping details in courier orders.

Container types

Pallet

A regular pallet containing packages, case packs, and/or loose line items. Only appears in freight orders.

Field	Type	Description
`type`	string	Always `"Pallet"`
`details`	object	See Details
`line_items`	array	Loose items packed directly on the pallet
`containers`	array	Nested Boxes and/or CasePacks

Package (Box)

A box or carton. In the response, nested packages appear with type: "Box" to distinguish them from top-level packages which use type: "Package".

Field	Type	Description
`type`	string	`"Package"` for top-level, `"Box"` for nested
`details`	object	See Details
`shipping_details`	object or null	See Shipping details. Only populated on top-level packages in courier orders
`line_items`	array	Items packed inside this box
`containers`	array	Nested Boxes and/or CasePacks

CasePack

A sealed product case. Can appear at the top level (courier orders) or nested inside a pallet or package. CasePacks are always leaf nodes — they have no children.

Field	Type	Description
`type`	string	`"CasePack"`
`details`	object	See Details
`shipping_details`	object or null	See Shipping details. Only populated on top-level casepacks in courier orders
`order_line_item_id`	int	The order line item this case pack fulfills
`partner_line_item_id`	string	Partner-provided line item identifier
`case_sku`	string	SKU of the product case definition
`quantity`	int	Number of cases
`child_sku`	string	SKU of the direct content of this case (may be another case or eaches)
`child_sku_quantity`	int	Units of `child_sku` contained per case
`each_sku`	string	SKU of the ultimate each-level product
`each_quantity`	int	Total eaches contained per case
`lot`	object or null	See Lot details

Note: For simple cases (case contains eaches directly), child_sku equals each_sku and child_sku_quantity equals each_quantity. For nested UOMs (e.g., a master case containing inner cases of eaches), these will differ.

UOM Pallet

A pallet that represents a single unit-of-measure product case. Only appears in freight orders. Uses the same fields as CasePack but with type: "UOM Pallet". UOM Pallets do not contain child containers or line items — all product information is derived from the linked product case.

UOM Pallets do not support shipping labels. The shipping_details field is always null.

Freight example

A freight order with a regular pallet (containing a box with line items and a casepack) and a UOM pallet:

{
  "created_at": "2026-01-15T10:30:00",
  "updated_at": "2026-01-15T10:30:00",
  "containers": [
    {
      "type": "Pallet",
      "details": {
        "height": 48.0,
        "length": 40.0,
        "width": 48.0,
        "weight_in_oz": 1600.0,
        "barcode": "PLT001",
        "sscc_barcode": "PLT001",
        "shipping_box_id": "pallet-type-1",
        "container_number": 1
      },
      "line_items": [],
      "containers": [
        {
          "type": "CasePack",
          "details": {
            "height": 12.0,
            "length": 10.0,
            "width": 8.0,
            "weight_in_oz": 160.0,
            "barcode": "CASE001",
            "sscc_barcode": "CASE001",
            "shipping_box_id": null,
            "container_number": 1
          },
          "shipping_details": null,
          "order_line_item_id": 1001,
          "partner_line_item_id": "PO-LINE-001",
          "case_sku": "MASTER-CASE-A",
          "quantity": 2,
          "child_sku": "INNER-CASE-A",
          "child_sku_quantity": 4,
          "each_sku": "SKU-WIDGET",
          "each_quantity": 24,
          "lot": null
        },
        {
          "type": "Box",
          "details": {
            "height": 16.0,
            "length": 12.0,
            "width": 10.0,
            "weight_in_oz": 320.0,
            "barcode": "PKG001",
            "sscc_barcode": "PKG001",
            "shipping_box_id": null,
            "container_number": 1
          },
          "line_items": [
            {
              "order_line_item_id": 1002,
              "partner_line_item_id": "PO-LINE-002",
              "sku": "SKU-GADGET",
              "name": "Gadget",
              "quantity": 10
            }
          ],
          "containers": []
        }
      ]
    },
    {
      "type": "UOM Pallet",
      "details": {
        "height": 60.0,
        "length": 48.0,
        "width": 40.0,
        "weight_in_oz": 2400.0,
        "barcode": "UOMPLT001",
        "sscc_barcode": "UOMPLT001",
        "shipping_box_id": null,
        "container_number": 2
      },
      "shipping_details": null,
      "order_line_item_id": 1003,
      "partner_line_item_id": "PO-LINE-003",
      "case_sku": "PALLET-SKU-B",
      "quantity": 1,
      "child_sku": "SKU-EACH-B",
      "child_sku_quantity": 100,
      "each_sku": "SKU-EACH-B",
      "each_quantity": 100,
      "lot": {
        "id": 42,
        "name": "LOT-2026-001",
        "expiration_date": "2027-06-15"
      }
    }
  ]
}

Key points:

Top-level containers are Pallets and UOM Pallets. Packages and CasePacks are nested inside.
UOM Pallets have no containers or line_items — all product info comes from the product case fields. They never have shipping details.
CasePacks inside a pallet always have "shipping_details": null.
The nested CasePack shows a multi-level UOM: child_sku (“INNER-CASE-A”) differs from each_sku (“SKU-WIDGET”) because the master case contains inner cases, which in turn contain eaches.

Courier example

A courier order with a top-level casepack (shipped on its own) and a top-level package:

{
  "created_at": "2026-01-20T14:00:00",
  "updated_at": "2026-01-20T14:00:00",
  "containers": [
    {
      "type": "CasePack",
      "details": {
        "height": 12.0,
        "length": 10.0,
        "width": 8.0,
        "weight_in_oz": 160.0,
        "barcode": "CASE001",
        "sscc_barcode": "CASE001",
        "shipping_box_id": null,
        "container_number": 1
      },
      "shipping_details": {
        "carrier": "UPS",
        "shipping_method": "Ground",
        "scac": "UPSN",
        "tracking_number": "1Z999AA10123456784"
      },
      "order_line_item_id": 2001,
      "partner_line_item_id": "PO-LINE-010",
      "case_sku": "CASE-SKU-X",
      "quantity": 1,
      "child_sku": "SKU-EACH-X",
      "child_sku_quantity": 12,
      "each_sku": "SKU-EACH-X",
      "each_quantity": 12,
      "lot": null
    },
    {
      "type": "Package",
      "details": {
        "height": 16.0,
        "length": 12.0,
        "width": 10.0,
        "weight_in_oz": 320.0,
        "barcode": "PKG001",
        "sscc_barcode": "PKG001",
        "shipping_box_id": null,
        "container_number": 1
      },
      "shipping_details": {
        "carrier": "UPS",
        "shipping_method": "Ground",
        "scac": "UPSN",
        "tracking_number": "1Z999AA10123456785"
      },
      "line_items": [
        {
          "order_line_item_id": 2002,
          "partner_line_item_id": "PO-LINE-011",
          "sku": "SKU-LOOSE-ITEM",
          "name": "Loose Item",
          "quantity": 5
        }
      ],
      "containers": []
    }
  ]
}

Key points:

Top-level containers are CasePacks and Packages. Pallets are not used in courier orders.
CasePacks appear before Packages in the response.
Both top-level CasePacks and Packages can have shipping_details when a label exists.
shipping_details is null if the order is packed but not yet shipped.
In this example child_sku equals each_sku because it is a single-level case (the case contains eaches directly).

Cycle Counts Staging Locations