> ## Documentation Index
> Fetch the complete documentation index at: https://developer.jtl-software.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SplitReturnLineItem

> Splits an existing return line item into two positions by reducing the original quantity and creating a new position with the split-off quantity.

If a request with this mutation's Idempotency-Key was already completed, the response's `extensions` contains an `idempotency.{responseName}` entry with `wasReplayed: true`.



**mutation** `SplitReturnLineItem(request: SplitReturnLineItemCommandRequestInput!): SplitReturnLineItem!`

## Arguments

**`request`**: `SplitReturnLineItemCommandRequestInput!` (required)

## Returns

`SplitReturnLineItem!`

**`originalLineItemId`**: `ID!`

The ID of the original line item (quantity reduced).

---

**`originalQuantity`**: `Decimal!`

The remaining quantity on the original position.

---

**`newLineItemId`**: `ID!`

The ID of the newly created line item (with split-off quantity).

---

**`newQuantity`**: `Decimal!`

The quantity on the new position.

## Examples

```graphql Mutation
mutation SplitReturnLineItem($request: SplitReturnLineItemCommandRequestInput!) {
  SplitReturnLineItem(request: $request) {
    originalLineItemId
    originalQuantity
    newLineItemId
    newQuantity
  }
}
```

```json Variables
{
  "request": {
    "returnId": "id",
    "lineItemId": "id",
    "quantity": "value"
  }
}
```

```json Response
{
  "data": {
    "SplitReturnLineItem": {
      "originalLineItemId": "id",
      "originalQuantity": "value",
      "newLineItemId": "id",
      "newQuantity": "value"
    }
  }
}
```
