# CreateRtvInput

input type

Create-input for createRtv.

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `caption` | [String](/types/#scalars) | no | Optional: when omitted the per-type default applies — 'return to vendor <N> line(s)'; when supplied it must be non-blank. |
| `orgVendorId` | [ID](/types/#scalars) `ID!` | yes | The OrgVendor enablement receiving the return (rides the HEADER parentId — lean 2) — tenant-scoped + ACTIVE server-side (an inactive enablement refuses NEW returns while in-flight docs keep transitioning). |
| `purchaseOrderId` | [ID](/types/#scalars) | no | The OPTIONAL originating PurchaseOrder — must belong to the SAME OrgVendor and be past-issue (a draft/pending/cancelled order shipped nothing to return). |
| `shipFromLogicalFacilityId` | [ID](/types/#scalars) `ID!` | yes | The LF the return ships FROM — tenant-scoped + ACTIVE + the buying org's (SL-b set-time; re-checked at ship). |
| `expectedCredit` | [MoneyEntryInput](/types/MoneyEntryInput/) | no | Optional expected vendor credit (in the vendor purchasingCurrency — VALIDATION/INVALID naming both else); omitted ⇒ ship stamps the Σ quantity × CURRENT WMA default. |
| `lines` | [RtvLineInput](/types/RtvLineInput/) `[RtvLineInput!]!` | yes | The lines (1..24 — the NAMED ceiling, -m; distinct variant × sourceBucket × bin keys; junctions resolved + stamped server-side). |

## Used by

- [createRtv](/reference/purchasing/createRtv/)