Update Order Item

Update an existing order item.

HTTP Request

PATCH/api/orders/:id/items/:item_id

Authorization

Authorization

• Required: Yes
• Permission: Staff or Admin
• Authentication: Token-based (Authorization: Token <your_api_key>)

Path Parameters

Parameter	Type	Required	Description
id	Integer	Yes	Unique ID of the order to update
item_id	Integer	Yes	Unique ID of the order item to update

Request Body

Field	Type	Required	Description
product	Integer	Yes	Product ID
unit_price	Number	Yes	Price per unit
unit_discount	Number	No	Discount per unit
quantity	Integer	No	Quantity of items (default: 1)
notes	String	No	Item-specific notes

Example Requests

🐍 Python

1import requests
2
3response = requests.patch('http://www.example.com/api/orders/123/items/789', 
4  json={
5      'quantity': 3,
6      'unit_discount': 5.00
7  },
8  headers={'Authorization': 'Token <your_api_key>'}
9)
10print(response.json())

🌐 Curl

1curl -X PATCH "http://www.example.com/api/orders/123/items/789" -H "Authorization: Token <your_api_key>" -H "Content-Type: application/json" -d '{
2  "quantity": 3,
3  "unit_discount": 5.00
4}'

Status Codes

Code	Description
200	Order Item updated successfully
400	Bad request — invalid input
401	Unauthorized — authentication required
403	Forbidden — insufficient permissions
404	Not found — order item does not exist
500	Internal server error

Response Fields

Field	Type	Description
id	Integer	Unique ID of the order
key	String	Unique key of the order (read-only)
status	String	Current status of the order
customer_data	Object	Customer information (read-only)
payment_method_data	Object	Payment method information (read-only)
shipping_method_data	Object	Shipping method information (read-only)
shipping_cost	Number	Cost of shipping
notes	String	Order notes
extra	Object	Additional order data
created_at	String (ISO 8601)	Timestamp when order was created
updated_at	String (ISO 8601)	Timestamp when order was last updated
billing_country_data	Object	Billing country information (read-only)
billing_state_data	Object	Billing state information (read-only)
billing_city_data	Object	Billing city information (read-only)
billing_address	String	Billing address
billing_postal_code	String	Billing postal code
billing_national_code	String	Billing national code
billing_mobile_number	String	Billing mobile number
billing_first_name	String	Billing first name
billing_last_name	String	Billing last name
count	Integer	Number of items in order (computed field)
quantity	Integer	Total quantity of items (computed field)
items_subtotal	Number	Subtotal of all items (computed field)
items_discount	Number	Total discount on items (computed field)
subtotal	Number	Order subtotal (computed field)
total_discount	Number	Total discount amount (computed field)
total	Number	Order total amount (computed field)
amount_paid	Number	Amount already paid (computed field)
amount_outstanding	Number	Outstanding amount (computed field)
is_paid	Boolean	Whether order is fully paid (computed field)
items	Array	List of order items (read-only)
payments	Array	List of order payments (read-only)

Order Items Structure

Each item in the items array contains:

Field	Type	Description
id	Integer	Unique ID of the order item
product	Integer	Unique ID of the product
product_name	String	Current Product Name
product_data	Object	Snapshot of product data at time of order
unit_price	Integer	Price per unit (in smallest currency unit)
unit_discount	Integer	Discount per unit (in smallest currency unit)
quantity	Integer	Quantity ordered
notes	String	Item-specific notes
subtotal	Integer	Calculated subtotal (computed field)
discount	Integer	Total discount for this item (computed field)
total	Integer	Final total for this item (computed field)
created_at	String (ISO 8601)	Item creation timestamp
updated_at	String (ISO 8601)	Item last update timestamp

Payment Method Structure

The payment_method object contains:

Field	Type	Description
id	Integer	Payment method ID
name	String	Payment method name
image	Object	Payment method image data

Customer Structure

The customer object contains:

Field	Type	Description
id	Integer	Customer ID
username	String	Customer username
full_name	String	Customer full name (computed)

Geographic Data Structures

Country, state, and city objects contain:

Country/State:

Field	Type	Description
id	Integer	Location ID
active	Boolean	Whether location is active
name	String	Location name
code	String	Location code

City:

Field	Type	Description
id	Integer	City ID
active	Boolean	Whether city is active
name	String	City name