Update Order Item - Salla Merchants APIs

This endpoint allows you to update a specific Order item by passing the item_id as a path parameter.

Scopes

orders.read_write - Orders Read & Write

Request

Authorization

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Path Params

item_id

integer

required

Unique identification number assigned to an Order Item. List of Order Item IDs can be found here.

Example:

3155923424

Body Params application/json

quantity

integer

optional

branch_id

integer

optional

price

integer

optional

weight

number

optional

weight_type

string

optional

options

array [object {2}]

optional

integer

optional

value

array[string]

optional

Example

{
  "quantity": 2,
  "branch_id": 12342,
  "price": 100,
  "weight": 0.2,
  "weight_type": "kg",
  "options": [
    {
      "id": 789012,
      "value": [
        "value1"
      ]
    }
  ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

status

integer

optional

Response status code, a numeric or alphanumeric identifier used to convey the outcome or status of a request, operation, or transaction in various systems and applications, typically indicating whether the action was successful, encountered an error, or resulted in a specific condition.

success

boolean

optional

Response flag, boolean indicator used to signal a particular condition or state in the response of a system or application, often representing the presence or absence of certain conditions or outcomes.

data

array[object (OrderItem) {15}]

optional

number

required

A unique identifier, typically numerical or alphanumeric, assigned to an individual item or product within an order.

name

string

required

The name or description of an individual item or product within an order.

sku

string

required

Stock Keeping Unit, and it is a unique code or identifier used to track and manage individual products or items in inventory, facilitating inventory management, sales tracking, and product identification.

quantity

integer

required

The numerical count of a specific item or product included in an order, indicating how many of that particular item have been purchased or are part of the order.

currency

string

required

The specific currency in which the price or value of an individual item within an order is expressed, indicating the monetary unit used for pricing that particular item.

weight

number

required

The numerical measurement representing the weight of an individual item or product within an order.

weight_label

string

required

A textual label or description associated with the weight of an individual item within an order, typically used to indicate the unit of measurement (e.g., kg, lb) and provide clarity regarding how the item's weight is expressed.

amounts

object

required

notes

string

required

Order items notes

options

array [object {5}]

required

images

array [object {3}]

required

codes

array [object {2}]

required

files

array [object {3}]

required

reservations

array [object {4}]

required

branches_quantity

array[integer]

required

Example

{
  "status": 200,
  "success": true,
  "data": [
    {
      "id": 365435777,
      "name": "SSD",
      "sku": "sam-ssd-256g",
      "quantity": 2,
      "currency": "SAR",
      "weight": 0.2,
      "weight_label": "٠.٢ كجم",
      "amounts": {
        "price_without_tax": {
          "amount": 100,
          "currency": "SAR"
        },
        "total_discount": {
          "amount": 0,
          "currency": "SAR"
        },
        "tax": {
          "percent": "15.00",
          "amount": {
            "amount": 15,
            "currency": "SAR"
          }
        },
        "total": {
          "amount": 115,
          "currency": "SAR"
        }
      },
      "notes": "",
      "options": [],
      "images": [],
      "codes": [],
      "files": [],
      "reservations": [],
      "branches_quantity": []
    }
  ]
}

🟠404Not Found

🟠401Unauthorized

🟠422Error Validation