---
title: "AddOrderItem"
method: POST
path: "/api/Orders/AddOrderItem"
tags: ["Orders"]
---

# AddOrderItem

`POST /api/Orders/AddOrderItem`

Add an item to a specific order.
Line pricing is optional with the default values being
- PricePerUnit: Stock item retail price
- DiscountPercentage: 0
- TaxRatePercentage: Stock item tax rate.
- TaxInclusive: true
<b>Rate limit: </b><span style="background-color:#0272d9;color:white;padding:4px 8px;text-align:center;border-radius:5px; font-size: small;"><b>250</b></span> / minute

## Request body

- OrdersAddOrderItemRequest
  - `orderId` string, uuid — Order id
  - `itemId` string, uuid — Item id to be added
  - `channelSKU` string — Channel SKU of the item
  - `fulfilmentCenter` string, uuid — Current fulfilment center
  - `quantity` integer — Item quantity
  - `linePricing` LinePricingRequest
    - `PricePerUnit` number, double — Price per unit (default from stock item)
    - `DiscountPercentage` number, double — Discount percentage (default 0)
    - `TaxRatePercentage` number, double — Tax rate percentage
    - `TaxInclusive` boolean — Tax inclusive (default true)
  - `createdDate` string, date-time — The datetime that the item was added to the order

## Response `200`

OK

- UpdateOrderItemResult
  - `TotalsInfo` OrderTotalsInfo — OrderTotalsInfo
    - `Subtotal` number, double — Order subtotal
    - `PostageCost` number, double — Order postage cost
    - `PostageCostExTax` number, double — Order postage cost ex. tax
    - `Tax` number, double — Tax
    - `TotalCharge` number, double — Total charge
    - `PaymentMethod` string, nullable — Payment method
    - `PaymentMethodId` string, uuid — Payment method ID
    - `TotalDiscount` number, double — Total discount applied to the order
    - `Currency` string, nullable — Order currency
    - `CountryTaxRate` number, double — Country tax rate
    - `ConversionRate` number, double — Currency conversion rate. Set at point of save by the currency
  - `Item` OrderItem — OrderItemBasic
    - `RowId` string, uuid — Record row ID
    - `StockItemId` string, uuid — Stock Item ID
    - `IsService` boolean — Is the item a service?
    - `IsUnlinked` boolean — Is the item unlinked?
    - `Quantity` integer — Quantity
  - `ItemWeight` number, double — Order item weight
  - `TotalWeight` number, double — Order total weight

---

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