Add a custom product

Requires write_orders access scope.

For more info , refer to:

[]

access permission

POST https://{handle}.myshopline.com/admin/openapi/v20250601/orders/order_edit_add_customized_item.json

[]

handle : The store's unique identifier, which is the prefix of the store's domain name. For example, if a store's domain name is open001.myshopline.com , the store handle is open001 .

Request Headers

Content-Type required
[]
The value of this field is fixed to application/json; charset=utf-8
Authorization string required
[]
The access token for the API. Please refer to App authorization to obtain the access token, and then put the obtained access token into the API request header in Bearer Token.
Example:
[]
Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw

Request Body

requestobject
[]
Request information
id string required
[]
Edit order draft order id ( can be obtained from call order editing-start interface return parameters )
[]
Example: 2106072100189862661619862135965454
location_id string
[]
Product storage position id , if not transferred , then take the default locationId
[]
Example: 6072083990000965196
priceobject required
[]
Custom price of goods
amount string
[]
Amount information , two precision double type strings
[]
Example: 1.15
currency_code string
[]
Currency
[]
Example: USD
quantity integer required
[]
Customize Product quantity
[]
Example: 1
title string
[]
Product title
[]
Example: merge-cst-test-001

Response

[]

For more information about status codes, see Http status code.

Response Headers

traceId
[]
traceId

Response Body

calculated_line_itemobject
[]
This editor will add a custom listing
added_discount_staged_changeobject
[]
Product line custom discount information
description string
[]
Discount description
[]
Example: customized discount
fixed_valueobject
[]
The Discount value of the fixed amount supports two decimal points . the discount is the fixed amount type , which is worthwhile
amount string
[]
Amount , two precision double type strings
[]
Example: 1.0
currency_code string
[]
Currency
[]
Example: USD
id string
[]
Discount id
[]
Example: 6068787948765604961
percent_value string
[]
Percentage Discount value , two decimal points between 0-1 , such as 0.2=20%off as the discount is the percentage type , this item is worth it
[]
Example: 0
id string
[]
Order editing Product line id in draft order
[]
Example: 6068787943765994592
original_unit_price_setobject
[]
Original price , no application favorable price
presentment_moneyobject
[]
Currency amount for the market
amount string
[]
Value of the amount , two precision double type strings
[]
Example: 10.0
currency_code string
[]
Currency
[]
Example: USD
shop_moneyobject
[]
Store currency amount information
amount string
[]
Value of the amount , two precision double type strings
[]
Example: 10.0
currency_code string
[]
Currency
[]
Example: USD
quantity string
[]
Quantity
[]
Example: 1
required_shipping boolean
[]
Shipping or not
[]
Example: true
taxable boolean
[]
Tax or not required
[]
Example: true
title string
[]
Product title
[]
Example: customized item
variant_id string
[]
Product sku
[]
Example: 18057243001210740422372124
calculated_orderobject
[]
Edit order draft order information
committed boolean
[]
Have submitted save to order or not
[]
Example: true
id string
[]
Order editing draft order id
[]
Example: 2106068787725276328168095160459272
user_errorsobject[]
[]
Error prompt information of this editor , if there is an error in the execution , it will be return in this field , and the call can be tried again according to the error code ( note : try again and need to start the interface from the order_edit.json order editing to start the whole set of
code string
[]
The wrong code , if the implementation result is wrong , it will be return the wrong code through this field , and the call can be tried again according to the wrong code ( note : try again and need to start the interface from the order_edit.json order editing to start the whole set of editing order
[]
Example: PARAM_ILLEGAL
field array
[]
The path to the input field that caused the error. leads to the path of incorrect input fields
[]
Example: ["id"]
message string
[]
Error message
[]
Example: param is null

API Explorer

Debugger

Base URL

https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601

ParamOptions

Authorization — header required

Body

Body required

{
  "request": {
    "id": "2106072100189862661619862135965454",
    "location_id": "6072083990000965196",
    "price": {
      "amount": "1.15",
      "currency_code": "USD"
    },
    "quantity": 1,
    "title": "merge-cst-test-001"
  }
}

Language

curl --request POST \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601/orders/order_edit_add_customized_item.json \
     --header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --header 'accept: application/json' \
     --data '
{
  "request": {
    "id": "2106072100189862661619862135965454",
    "location_id": "6072083990000965196",
    "price": {
      "amount": "1.15",
      "currency_code": "USD"
    },
    "quantity": 1,
    "title": "merge-cst-test-001"
  }
}
'

Was this article helpful to you?

SHOPLINE

Legal

Error loading component.