# ReturnLine

object type

One Return line — the request-time identity copy of ONE order line's returned quantity (whole units) + the RECEIVE-time stamps (disposition cover · the telescoping refund money over the order line's captured figures · the restocking fee). Stamps are server-written, never caller data.

## Fields

| Field | Type | Notes |
| --- | --- | --- |
| `lineNo` | [Int](/types/#scalars) `Int!` | 1-based position within this return. |
| `orderLineNo` | [Int](/types/#scalars) `Int!` | The returned order line's frozen lineNo — the (orderId, orderLineNo) cross-document coordinate. |
| `variantId` | [ID](/types/#scalars) | The sold variant (copied — XOR openItemDescription). |
| `openItemDescription` | [String](/types/#scalars) | The open-item description (copied — stockless: no disposition, no movement; refund-only). |
| `taxCategory` | [TaxCategory](/types/TaxCategory/) `TaxCategory!` | The order line's resolved tax category (copied — the remittance-reversal coordinate). |
| `quantity` | [String](/types/#scalars) `String!` | The returned quantity (positive decimal string; bindingly bounded at receive: quantity − returnedQty). |
| `reason` | [String](/types/#scalars) | The request-time reason (why the customer returns). |
| `dispositions` | [ReturnLineDisposition](/types/ReturnLineDisposition/) `[ReturnLineDisposition!]` | The receive-time disposition cover (absent until received; ALWAYS absent on stockless lines). |
| `paidShareMinor` | [Int](/types/#scalars) | RECEIVE-stamped: this return's telescoping share of the order line's lineTotalMinor (the paid value — tax inside, both regimes). |
| `restockingFeeMinor` | [Int](/types/#scalars) | RECEIVE-stamped: halfAway(paidShare × the order line's captured restockingFeePpm / 1e6); absent when the line captured no fee flag. |
| `refundMinor` | [Int](/types/#scalars) | RECEIVE-stamped: paidShare − restockingFee, floored at 0 — this line's refund. |
| `tax` | [OrderLineTax](/types/OrderLineTax/) | RECEIVE-stamped: the order line's tax slot with each component's taxMinor telescoping-prorated (rates/refs verbatim) — the remittance-reversal report source. |