# PosReturnInput

input type

One-shot input for posReturn: the NewReturn essentials + the receive disposition cover + the refund routing, walked requested→approved→received→refunded in ONE call.

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `caption` | [String](/types/#scalars) | no | Optional. |
| `orderId` | [ID](/types/#scalars) `ID!` | yes | The Order being returned against — same-group; placed or completed. |
| `invoiceId` | [ID](/types/#scalars) | no | Optional Invoice ref — must belong to orderId (the receipted-return audit edge). |
| `logicalFacilityId` | [ID](/types/#scalars) `ID!` | yes | The processing/receiving LF — becomes the parent. |
| `lines` | [ReturnLineInput](/types/ReturnLineInput/) `[ReturnLineInput!]!` | yes | The returned lines (1..45, distinct orderLineNos — the ReturnLineInput shape verbatim). |
| `dispositions` | [ReturnDispositionEntryInput](/types/ReturnDispositionEntryInput/) `[ReturnDispositionEntryInput!]!` | yes | The receive cover. |
| `refund` | [PosReturnRefundInput](/types/PosReturnRefundInput/) `PosReturnRefundInput!` | yes | No further notes. |

## Used by

- [posReturn](/reference/register-approvals/posReturn/)