---
title: "Submit Order Substitution"
method: POST
path: "/merchant/{merchantReference}/order/{orderReference}/substitution"
tags: ["Orders"]
---

# Submit Order Substitution

`POST /merchant/{merchantReference}/order/{orderReference}/substitution`

Propose item substitutions for an order when one or more items are unavailable. Specify replacement items for the customer to approve.

## Path parameters

- `merchantReference` string, required
- `orderReference` string, required

## Request body

- object
  - `substitutions` object[], required
    - `item_reference` string — Reference of the item
    - `pack_id` string, required
    - `order_item_type` string, required
    - `quantity_unavailable` string
    - `replacements` object[]
      - `reference` string
      - `quantity` string

## Response `200`

- object
  - `status` string, required
  - `message` string

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/chowdeck/apis/chowdeck-api.md) · [All operations](https://skmtc.net/chowdeck/apis/chowdeck-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chowdeck/chowdeck-api/versions/5830cc8467d8/schema)