# OrderLine

object type

One embedded Order line — lineNo frozen at placed; money audit server-stamped per write.

## Fields

| Field | Type | Notes |
| --- | --- | --- |
| `lineNo` | [Int](/types/#scalars) `Int!` | 1-based input position — the cross-document addressing key once placed. |
| `variantId` | [ID](/types/#scalars) | The sold variant (the 3-way entry-mode XOR with openItem / storedValue). |
| `inventoryItemId` | [ID](/types/#scalars) | The resolved (variant × LF) InventoryItem — present ⟺ variantId (price capture + reserve junction). |
| `salePriceId` | [ID](/types/#scalars) | The SalePrice record whose window governed the capture — present ⟺ variantId (audit provenance). |
| `openItem` | [OrderOpenItem](/types/OrderOpenItem/) | No further notes. |
| `storedValue` | [OrderStoredValue](/types/OrderStoredValue/) | The stored-value payload. |
| `taxCategory` | [TaxCategory](/types/TaxCategory/) `TaxCategory!` | The resolved tax category — the variant→product→style walk answer, or the open-item/stored-value explicit one. |
| `quantity` | [String](/types/#scalars) `String!` | Positive decimal-string quantity (the stock-UoM grammar; open items unit-counted). |
| `capturedUnitPriceMinor` | [Int](/types/#scalars) `Int!` | The captured unit sale price in minor units. |
| `discounts` | [OrderDiscount](/types/OrderDiscount/) `[OrderDiscount!]!` | No further notes. |
| `fulfillmentMethod` | [OrderFulfillmentMethod](/types/OrderFulfillmentMethod/) `OrderFulfillmentMethod!` | No further notes. |
| `nonReturnable` | [Boolean](/types/#scalars) | No further notes. |
| `finalSale` | [Boolean](/types/#scalars) | No further notes. |
| `restockingFeePpm` | [Int](/types/#scalars) | No further notes. |
| `requiresApprovalToSell` | [Boolean](/types/#scalars) | No further notes. |
| `commissionAgents` | [OrderCommissionAgent](/types/OrderCommissionAgent/) `[OrderCommissionAgent!]` | No further notes. |
| `referralCode` | [String](/types/#scalars) | No further notes. |
| `reservedQty` | [String](/types/#scalars) | The LIVE reservation claim stamped by the ecom place — the release entries + the terminal status are the history. |
| `invoicedQty` | [String](/types/#scalars) | The cumulative INVOICED quantity: stamped by issueInvoice / un-stamped by voidInvoice under this doc's OCC; the un-invoiced remainder = quantity − invoicedQty (absent = 0). |
| `returnedQty` | [String](/types/#scalars) | The cumulative RETURNED quantity: stamped by receiveReturn under this doc's OCC; the returnable remainder = quantity − returnedQty (absent = 0). |
| `fulfillmentClaimedQty` | [String](/types/#scalars) | The cumulative FULFILLMENT-CLAIMED quantity: Σ open + delivered Fulfillment claims, stamped by createFulfillment / un-stamped by cancelFulfillment under this doc's OCC; the unclaimed remainder = quantity − fulfillmentClaimedQty (absent = 0). Carryout lines claim at the paid-completion delivery. |
| `fulfilledQty` | [String](/types/#scalars) | The cumulative DELIVERED quantity: stamped by the delivery lanes (ship/handover/the carryout paid-completion) under this doc's OCC; both delivery vectors aggregate it (absent = 0). |
| `relievedQty` | [String](/types/#scalars) | The cumulative RELIEVED quantity: stamped by the sell-relief lane in ITS transaction (absent = 0). |
| `warrantyIds` | [ID](/types/#scalars) `[ID!]` | The Warranties born on this line at the sale's completion: engine-stamped in the birth transaction under this doc's OCC (the idempotency mark — a re-run births nothing twice); ABSENT until the birth; never caller-typed. Ref-only — THE ORDER-SIDE LINK; each warranty's parentId is this order and its orderLineNo this line. |
| `sourcingType` | [OrderLineSourcingType](/types/OrderLineSourcingType/) | The sourcing path this special_order line rides. |
| `sourcingDocId` | [ID](/types/#scalars) | The linked sourcing document (transfer → the TransferRequest; backorder → the PurchaseOrder) — re-stamped only when the linked doc is DEAD (the re-link retry lane). |
| `sourcingDocLineNo` | [Int](/types/#scalars) | The 1-based line on THAT doc (the TR-b per-line shape mirrored). |
| `arrivedQty` | [String](/types/#scalars) | The cumulative ARRIVED quantity: stamped by the arrival follow-ups (receiveTransfer / the Receipt post) in their per-order transactions; on_hand landings ONLY; the line is arrived when arrivedQty ≥ quantity (absent = 0). |
| `cogsUnitCost` | [MoneyEntry](/types/MoneyEntry/) | The per-unit COGS snapshot at relief. |
| `baseMinor` | [Int](/types/#scalars) `Int!` | Step-1 base = round(quantity × capturedUnitPriceMinor), half away from zero. |
| `lineDiscountMinor` | [Int](/types/#scalars) `Int!` | Σ applied line discounts (step 2). |
| `orderDiscountShareMinor` | [Int](/types/#scalars) `Int!` | This line largest-remainder share of the order-level discounts (exact — no lost minor units). |
| `taxableBaseMinor` | [Int](/types/#scalars) `Int!` | base − line discounts − order share (floored at zero) — the taxable base. |
| `lineTotalMinor` | [Int](/types/#scalars) `Int!` | taxableBase + exclusive-regime tax; pre-place = taxableBase. |
| `tax` | [OrderLineTax](/types/OrderLineTax/) | The tax slot — pipeline-written at place; absent while the cart is open/held. |