---
title: "Add Order Item"
method: POST
path: "/orders/{order_id}/items"
---

# Add Order Item

`POST /orders/{order_id}/items`

Add a new item to the order.

## Path parameters

- `order_id` integer, required

## Request body

- object
  - `entity_id` integer, required — Product or Service ID
  - `assignee_id` integer, required — Assigned Employee ID
  - `quantity` number, float, required — Quantity
  - `price` number, float, required — Price per unit
  - `cost` number, float, required — Unit cost
  - `discount` object, required — Item discount object
    - `type` 'percentage' | 'value', required — Discount type. "percentage" — percent, "value" — absolute value.
    - `percentage` number, float, required — Percentage value
    - `amount` number, float, required
    - `sponsor` 'staff' | 'company', required — "staff" — Employee wages calculation is based on the amount after discount. This way the company discount decreases the piecework employee wages. "company" — Employee commissions will be calculated from amount before discount. This way the company discount won't affect the employee commissions.
  - `warranty` object, required — Item warranty object
    - `period` string, required — Warranty period
    - `periodUnits` 'days' | 'months', required — Warranty unit of measure
  - `tax_ids` integer[] — Array of Tax ID
  - `comment` string — Comment text
  - `comment_visibility` 'private' | 'public' — Comment visibility

## Response `200`

200

- object

## Other responses

- `400` — 400

---

[API](https://skmtc.net/roapp/apis/ro-app-public-api-v2.md) · [All operations](https://skmtc.net/roapp/apis/ro-app-public-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/roapp/ro-app-public-api-v2/versions/85de4353ed28/schema)