---
title: "Partial Pack line items within a sale"
method: POST
path: "/fulfillments/{fulfillment_id}/pack"
tags: ["Fulfillments"]
---

# Partial Pack line items within a sale

`POST /fulfillments/{fulfillment_id}/pack`

Sets pack quantity for line items for a given sale. This is an idempotent action.

Each line item may optionally include a `source_breakdown`, which specifies how a packing quantity should be sourced.
When provided, both fields are required and must sum to the parent quantity.
Source breakdown is not allowed when the quantity is negative (unpacking).

🔒 Requires: `sales:write` scope

## Path parameters

- `fulfillment_id` string, required

## Request body

- PackLineItemsRequest
  - `line_items` PackLineItemRequest[], required — The line items to be packed
    - `quantity` number, double, required — The quantity to be packed
    - `sale_line_item_id` string, uuid, required — The unique identifier of the sale line item to be packed.
    - `source_breakdown` PackLineItemSourceBreakdown — Specifies how a packing quantity should be sourced. When provided, both fields are required and must sum to the parent quantity. Source breakdown is not allowed when the parent quantity is negative (unpacking).
      - `quantity_from_not_started` number, double, required — Quantity to source from the not-started state.
      - `quantity_from_picked` number, double, required — Quantity to source from the picked state.
  - `version` integer, required — The current version number of the fulfillment.

## Response `200`

Sale line item packed successfully.

- PackLineItemsResponse
  - `data` object
    - `id` string — The unique identifier of the fulfillment.
    - `version` integer — The new version number of the fulfillment after the update.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `409` — Conflict

---

[API](https://skmtc.net/lightspeedhq/apis/api-2026-07.md) · [All operations](https://skmtc.net/lightspeedhq/apis/api-2026-07/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightspeedhq/api-2026-07/revisions/72d4ceb46dbb/schema)