# TransferSurplusInput

input type

One DECLARED-surplus landing.

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `lineNo` | [Int](/types/#scalars) `Int!` | yes | The line whose surplus arrived (1-based, as stored). |
| `quantity` | [String](/types/#scalars) `String!` | yes | The surplus quantity landing NOW — strictly positive; NEVER counts toward receivedQty (stamps unplannedQty). |
| `toBucket` | [StockBucket](/types/StockBucket/) | no | The landing bucket — on_hand \| held ONLY (DEFAULTED to on_hand when omitted; the receipts matrix verbatim). |
| `heldReason` | [String](/types/#scalars) | no | The canned held reason — required iff toBucket is held. |