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