Update an order

Requires write_orders access scope.
For more info, refer to:
access permission.
PUT https://{handle}.myshopline.com/admin/openapi/v20260301/orders/:id.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 .
Update information for a specified order. If the field is passed with an empty value, or not passed at all, it means the information of this field will not be updated.
Path Parameters
  • id string required
    The order ID.
Request Headers
  • Content-Type string required
    The field must be set to the fixed value application/json; charset=utf-8.
  • Authorization string required
    The access token for the API resource. Refer to App authorization to obtain the access token, and then pass the obtained token in the Bearer format.
    Example:
    Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw
Request Body
  • orderobject
    Order details.
  • area_code string
    The international dialing code for the buyer's phone number.
  • customer_id string
    Buyer's ID.
  • email string
    The email of the buyer.
  • id string
    Order ID.
  • line_itemsobject[]
    Products that require label updates.
  • id string
    The ID of the line item snapshot table, generated by the system. Combined with the order ID, it uniquely identifies a line item.
  • tags string
    Product tags, with multiple tags separated by English commas. This input will overwrite any existing tags.
  • note_attributesobject[]
    A list of merchant note logs.
  • name string
    Merchant ID, indicating the note source.
  • value string
    Note content.
  • phone string
    The phone number of the buyer.
  • shipping_addressobject
    The address used for receiving packages.
  • address1 string
    The first line of the address. This typically includes information such as the street address or a post office box number.
  • address2 string
    The second line of the address. This typically includes information such as apartment, suite, or unit number.
  • area string
    The district in the address.
  • area_code string
    The district code in the address.
  • city string
    The city in the address.
  • city_code string
    The city code in the address.
  • company string
    The company name of the recipient. Maximum length:64
  • country string
    The country or region in the address. Maximum length:64
  • country_code string
    A two-letter country or region code that follows the ISO 3166-1 standard, used to identify a specific country or region in the address.
    Example: US
  • email string
    The email of the recipient.
  • first_name string
    The first name of the recipient.
  • last_name string
    The last name of the recipient. Maximum length:64
  • latitude string
    The latitude where the address is located.
  • longitude string
    The longitude where the address is located.
  • phone string
    The phone number of the recipient.
  • province string
    The province in the address.
  • province_code string
    The code for the province or region in the address, automatically generated by the system.
  • zip string
    The postal code information of the address.
  • tags string
    Product tags, with multiple tags separated by English commas. This input will overwrite any existing tags.
Status Codes
For the complete list of codes and messages, see Http status code.
Response Headers
  • traceId
    A globally unique identifier for the request. It is used to track the request flow throughout the system, allowing for easy location and debugging when issues arise.
Response Body
  • orderobject
    Order details.
  • app_id string
    App ID.
  • billing_addressobject
    The address for sending billing invoices.
  • address1 string
    The first line of the address. This typically includes information such as the street address or a post office box number.
  • address2 string
    The second line of the address. This typically includes information such as apartment, suite, or unit number.
  • city string
    The city in the address.
  • company string
    The company name of the billing recipient.
  • country string
    The country or region in the address.
  • country_code string
    A two-letter country or region code that follows the ISO 3166-1 standard, used to identify a specific country or region in the address.
    Example: US
  • first_name string
    The first name of the billing recipient.
  • last_name string
    The last name of the billing recipient.
  • name string
    The full name of the billing recipient.
  • phone string
    The phone number of the billing recipient.
  • province string
    The province in the address.
  • province_code string
    The code for the province or region in the address, automatically generated by the system.
  • standard_province_code string
    The code for the province or region in an address, represented by the last two or three characters of the ISO 3166-2 standard, such as RI or ENG.
  • zip string
    The postal code information of the address.
  • browser_ip string
    The IP address of the customer's browser used during order placement.
  • cancel_reason string
    Merchant's reason for cancellation.
  • cancelled_at string
    The date and time when the order was canceled. Format: ISO 8601.
    Example: 2024-08-31T02:20:26+08:00
  • cart_token string
    The unique identifier for shopping cart data.
  • checkout_id string
    Abandoned checkout ID.
  • checkout_token string
    The unique identifier for abandoned checkout data. After a customer initiates the checkout process, an abandoned checkout is generated.
  • client_detailsobject
    Client details.
  • browser_ip string
    The IP address of the customer's browser used during order placement.
  • session_hash string
    Member session encrypted information.
  • user_agent string
    User agent.
  • companyobject
    The buyer's company information as presented at the time the order was placed.
  • id string
    Company ID.
  • location_id string
    Location ID.
  • tax_registration_id string
    Tax registration ID.
  • created_at string
    The date and time when the order was created. Format: ISO 8601.
    Example: 2024-08-31T02:20:26+08:00
  • credit_limitobject
    Credit payment information.
  • credit_limit_currency string
    The currency of the credit payment, same as the store currency. The value of this parameter is a three-letter currency code that follows the ISO 4217 standard.
  • is_credit_limit boolean
    Indicates whether the order used credit payment.
    • true: used
    • false: not used
  • outstanding_credit_limit string
    The current occupied credit amount, initially equal to total_credit_limit. This value decreases with actions like repayments.
  • total_credit_limit string
    The total credit amount used to pay for this order.
  • currency string
    The transaction currency. The value of this parameter is a three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • current_subtotal_price string
    The total amount of products, calculated by multiplying the unit price by the quantity and displayed in the store currency.
  • current_subtotal_price_setobject
    The total amount of products, calculated by multiplying the unit price by the quantity and displayed in both the buyer currency and the store currency.
  • presentment_moneyobject
    The order price information presented to the buyer.
  • amount string
    The order amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The order price information recorded by the merchant.
  • amount string
    The order amount. The value is rounded to two decimal places. For example, 88.98.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • current_total_discounts string
    The total discount amount in the store currency. It is calculated by adding marketing discounts and custom discounts, with the resulting amount rounded to two decimal places.
  • current_total_discounts_setobject
    The total discount amount displayed in both the buyer currency and the store currency. It is calculated by adding marketing discounts and custom discounts, with the resulting amount rounded to two decimal places.
  • presentment_moneyobject
    The total discount amount information presented to the buyer.
  • amount string
    The total discount amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The total discount amount information recorded by the merchant.
  • amount string
    The total discount amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • current_total_duties_setobject
    The total customs duties for the products, displayed in both the buyer currency and the store currency.
  • presentment_moneyobject
    The total customs duties information for the products presented to the buyer.
  • amount string
    The duty amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The total customs duties information for the products recorded by the merchant.
  • amount string
    The duty amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • current_total_price string
    The total order amount, displayed in the store currency.
  • current_total_price_setobject
    The total order amount, displayed in both the buyer currency and the store currency.
  • presentment_moneyobject
    The total order amount presented to the buyer.
  • amount string
    The total order amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The total order amount recorded by the merchant.
  • amount string
    The total order amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • current_total_tax string
    The total tax amount, displayed in the store currency.
  • current_total_tax_setobject
    The total tax amount, displayed in both the buyer currency and the store currency.
  • presentment_moneyobject
    The tax information presented to the buyer.
  • amount string
    The tax amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The tax information recorded by the merchant.
  • amount string
    The tax amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • customerobject
    Buyer information.
  • addressesobject
    Buyer address information.
  • address1 string
    The first line of the address. This typically includes information such as the street address or a post office box number.
  • address2 string
    The second line of the address. This typically includes information such as apartment, suite, or unit number.
  • city string
    The city in the address.
  • country string
    The country or region in the address.
  • country_code string
    A two-letter country or region code that follows the ISO 3166-1 standard, used to identify a specific country or region in the address.
    Example: US
  • first_name string
    The first name of the buyer.
  • last_name string
    The last name of the buyer.
  • name string
    The full name of the buyer.
  • phone string
    The phone number of the buyer.
  • province string
    The province in the address.
  • province_code string
    The code for the province or region in the address, automatically generated by the system.
  • zip string
    The postal code information of the address.
  • area_code string
    The international dialing code for the buyer's phone number.
  • created_at string
    The date and time when the buyer information was created. Format: ISO 8601.
    Example: 2024-08-31T02:20:26+08:00
  • currency string
    A three-letter currency code that follows the ISO 4217 standard.
  • email string
    The email of the buyer.
  • first_name string
    The first name of the buyer.
  • id string
    Buyer's ID.
  • last_name string
    The last name of the buyer.
  • phone string
    The phone number of the buyer.
  • updated_at string
    The date and time when the buyer information was updated. Format：ISO 8601.
    Example: 2024-08-31T02:20:26+08:00
  • customer_locale string
    Formed by combining a language code (ISO 639) with a country or region code (ISO 3166-1), for example,enUS.
    Only the country or region code is returned if language information is unavailable, for example, US.
  • deduct_member_point_amount string
    The amount deducted from the order using member points, displayed in the store currency and rounded to two decimal places.
  • deduct_member_point_amount_setobject
    The amount deducted from the order using member points, displayed in both the buyer currency and the store currency.
  • presentment_moneyobject
    The currency amount information presented to the buyer.
  • amount string
    The deduction amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The deduction amount information recorded by the merchant.
  • amount string
    The deduction amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • discount_applicationsobject[]
    Discount information.
  • allocation_method string
    The discount scope. Valid values are:
    • across: The discount is applied to the total product amount.
    • each: The discount is applied to each product individually.
    For example, for a purchase of three identical products with a discount amount value of 10 dollars. If the allocation_method is across, the total amount of the three products is reduced by 10 dollars. If the allocation_method is each, the amount of each product is individually reduced by 10 dollars.
  • code string
    Discount code.
  • description string
    Custom discount description.
  • target_selection string
    Discount allocation method for line items. Valid values are:
    • explicit: The discount is allocated only to the explicitly specified line items.
    • all: The discount is allocated to all line items.
    • entitled: The discount is allocated only to the line items that are entitled to use the discount.
  • target_type string
    Discount target type. Valid values are:
    • line_item: discount applied to the product
    • shipping_line: discount applied to the shipping fee
  • title string
    Automatic discount title.
  • type string
    Discount type. Valid values are:
    • manual: manual discount
    • automatic: automatic discount
    • discount_code: discount applied through a discount code
  • value string
    The specific value of the discount, in the store currency.
    • When value_type is fix_amount, this field value represents a specific discount amount. For example, if the value is 10 and the store currency is USD, it means a discount of 10 dollars.
    • When value_type is percentage, the value of this field represents a specific discount percentage. For example, 10 means 10% off of the order amount.
  • value_type string
    The type of discount value. Valid values are:
    • fix_amount: Fixed amount discount. For example, if value is 10 in USD, it means a discount of 10 dollars.
    • percentage: Percentage-based discount. For example, if value is 10, it means 10% off of the order amount.
  • discount_codesobject[]
    A list of promo code information.
  • amount string
    Discount amount in the store currency. The value is rounded to two decimal places.
  • amount_setobject
    The discount amount, displayed in both the buyer currency and the store currency.
  • presentment_moneyobject
    The discount amount information presented to the buyer.
  • amount string
    The discount amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The discount amount information recorded by the merchant.
  • amount string
    The discount amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • code string
    Promo code.
  • type string
    Type of discount. Valid values are:
    • 减金额: amount reduction
    • 打折: offer a discount
    • 免运费: free shipping
    • 加价品: add-on purchase deal
    • 任意N件优惠价: discount for purchasing any N items
    • A+B组合优惠价: discount for purchasing the product A and B combo
    • 赠品: free gift
    • 固定售价: fixed price
    • 最低价商品免费: lowest-priced product free
    • 打包价: package price
    • 第N件打折: discount on the Nth item
    • 买x送y: buy x and get y free
    • 自定义: custom discount
    DEPRECATED: The returned enum values are in Chinese. This parameter is deprecated from API version v20250601.
  • email string
    Buyer's email.
  • financial_status string
    Order payment status. Valid values are:
    • unpaid: order not paid
    • authorized: order payment has been authorized
    • pending: order payment in progress
    • partially_paid: order partially paid
    • paid: order paid
    • partially_refunded: order partially refunded
    • refunded: order refunded
  • fulfillment_status string
    Shipping status. Valid values are:
    • fulfilled: order shipped
    • partial: order partially shipped
    • null: order not shipped
  • fulfillmentsobject[]
    A list of fulfillment information.
  • created_at string
    The date and time when the fulfillment was created. Format: ISO 8601.
    Example: 2024-08-31T02:20:26+08:00
  • id string
    Fulfillment ID.
  • line_itemsobject[]
    Product list.
  • attribute string
    The option information of the product variant, composed of the variant name and the option value.
    Example: color - red
  • fulfillable_quantity integer
    The remaining quantity of the product that can be shipped.
  • fulfillment_service string
    Logistics company name.
  • fulfillment_status string
    Shipping status. Valid values are:
    • fulfilled: order shipped
    • partial: order partially shipped
    • null: order not shipped
  • grams double
    The weight of the product in grams(g).
  • id string
    The ID of the line item snapshot table, generated by the system. Combined with the order ID, it uniquely identifies a line item.
  • name string
    SKU title, same as title.
  • price string
    The product price in the store currency. The value is rounded to two decimal places.
  • price_setobject
    The product price, displayed in both the store currency and the buyer currency.
  • presentment_moneyobject
    The product price information presented to the buyer.
  • amount string
    The product price. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The product price information recorded by the merchant.
  • amount string
    The product price. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • product_id string
    The unique identifier for the product corresponding to the variant.
  • quantity integer
    Quantity of products in the order.
  • requires_shipping boolean
    Indicates whether the product is subject to shipping.
    • true：Shipping is required.
    • false：Shipping is not required.
  • sku string
    The product SKU.
  • tax_linesobject[]
    Tax information.
  • price string
    The title for the tax description, for display only.
  • price_setobject
    The tax amount, displayed in both the buyer currency and the store currency.
  • presentment_moneyobject
    The tax amount information presented to the buyer.
  • amount string
    The tax amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The tax amount information recorded by the merchant.
  • amount string
    The tax amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • rate double
    The tax rate as a decimal value, rounded to four decimal places. For example, a 2% tax rate is represented as 0.0200. This field value is for display only.
  • title string
    Tax name.
  • taxable boolean
    Whether the product is subject to tax.
    • true: Tax is required.
    • false: No tax is required.
  • title string
    Product title.
  • variant_id string
    The unique identifier for the variant.
  • variant_title string
    Product variant value. Multiple values are separated by /.
  • vendor string
    Supplier.
  • name string
    Fulfillment code.
  • order_id string
    Order number.
  • shipment_status string
    Fulfillment shipping status. Valid values are:
    • out_for_delivery: out for delivery
    • delivered: delivered
    • faliure: delivery failed
    • picked_up: picked up
  • status string
    Fulfillment status. Valid values are:
    • success: shipment dispatched
    • cancelled: shipment has been canceled
  • tracking_company string
    Logistics service provider.
    DEPRECATED： This parameter is deprecated from API version v20250601. Refer to tracking_info_list.
  • tracking_info_listobject[]
    A list of tracking information.
  • tracking_company string
    Logistics service provider.
  • tracking_number string
    The tracking number provided by the logistics service provider.
  • tracking_url string
    The domain name of the logistics company.
  • tracking_number string
    The delivery tracking number provided by the logistics service provider.
    DEPRECATED：This parameter is deprecated from API version v20250601. Refer to tracking_info_list.
  • tracking_url string
    The domain name of the logistics company.
    DEPRECATED: This parameter is deprecated from API version v20250601. Refer to tracking_info_list.
  • updated_at string
    The date and time when the fulfillment was updated. Format: ISO 8601.
    Example: 2024-08-31T02:20:26+08:00
  • id string
    Order ID, system-defined number.
  • line_itemsobject[]
    A list of order product snapshots.
  • attribute string
    The option information of the product variant, composed of the variant name and the option value.
    Example: color - red
  • country_code_of_origin string
    Country or region code indicating the place of origin or shipping origin. Format: ISO 3166-1.
  • discount_allocationsobject[]
    The discount amount, displayed in both the buyer currency and the store currency.
  • amount string
    The discount amount. The value is rounded to two decimal places.
  • amount_setobject
    Discount details in multiple currencies.
  • presentment_moneyobject
    The discount amount information presented to the buyer.
  • amount string
    The discount amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The discount amount information recorded by the merchant.
  • amount string
    The discount amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • discount_application_index integer
    The position of the discount applied to the product within the orders.discount_applications list.
  • dutiesobject[]
    A list of duty information.
  • country_code_of_origin string
    Country or region code indicating the place of origin or shipping origin. Format: ISO 3166-1.
    Example: US
  • harmonized_system_code string
    Harmonized system code, used to categorize a product in international trade.
  • id string
    Tariff number.
  • priceobject
    The duty amount, displayed in both the buyer currency and the store currency.
  • presentment_moneyobject
    The duty amount information presented to the buyer.
  • amount string
    The duty amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The duty amount information recorded by the merchant.
  • amount string
    The duty amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • tax_linesobject[]
    A list of tax information.
  • price_setobject
    The tax amount, displayed in both the buyer currency and the store currency.
  • presentment_moneyobject
    The tax amount information presented to the buyer.
  • amount string
    The tax amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The tax amount information recorded by the merchant.
  • amount string
    The tax amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • rate double
    The tax rate as a decimal value, rounded to four decimal places. For example, a 2% tax rate is represented as 0.0200. This field value is for display only.
  • rate_percentage double
    The tax rate as a percentage numerical value, rounded to two decimal places. For example, a 2% tax rate is represented as 2.00. This field value is for display only.
  • title string
    The title for the tax description, for display only.
  • fulfillable_quantity integer
    The remaining quantity of the product that can be shipped.
  • fulfillment_service string
    Logistics company name.
  • fulfillment_status string
    Shipping status. Valid values are:
    • fulfilled: order shipped
    • partial: order partially shipped
    • null: order not shipped
  • grams double
    The weight of the product in grams(g).
  • harmonized_system_code string
    Harmonized system code, used to categorize a product in international trade.
  • id string
    The ID of the line item snapshot table, generated by the system. Combined with the order ID, it uniquely identifies a line item.
  • location_id string
    Local delivery location number or standard delivery location number.
  • name string
    SKU title, same as title.
  • price string
    The product price in the store currency. The value is rounded to two decimal places.
  • price_setobject
    The product price, displayed in both the store currency and the buyer currency.
  • presentment_moneyobject
    The product price information presented to the buyer.
  • amount string
    The product price. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
  • shop_moneyobject
    The product price information recorded by the merchant.
  • amount string
    The product price. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • product_id string
    The unique identifier for the product corresponding to the variant.
  • propertiesobject[]
    A list of product customization information.
  • additional string
    Additional custom fields for products. For example, if name is text, additional can include attributes such as font size, font style, and color.
  • name string
    Custom attribute name.
  • type string
    Custom information type. Valid values are:
    • text: text type
    • picture: picture type
    • link: hyperlink type
  • urls array
    URL list.
    If type is picture, thumbnails are retrieved via the urls values.
    If type is link, the hyperlink is the first URL in the urls values.
  • value string
    Custom attribute value.
  • quantity integer
    Quantity of products in the order.
  • requires_shipping boolean
    Indicates whether the product is subject to shipping.
    • true：Shipping is required.
    • false：Shipping is not required.
  • sku string
    The product SKU.
  • tags string
    Product tags. Multiple tags are separated by commas.
  • tax_linesobject[]
    Tax details list.
  • price string
    Tax in the store currency. The value is rounded to two decimal places.
  • price_setobject
    The tax amount, displayed in both the buyer currency and the store currency.
  • presentment_moneyobject
    The tax amount information presented to the buyer.
  • amount string
    The tax amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The tax information recorded by the merchant.
  • amount string
    The tax amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • rate double
    The tax rate as a decimal value, rounded to four decimal places. For example, a 2% tax rate is represented as 0.0200. This field value is for display only.
  • title string
    The title for the tax description, for display only.
  • type string
    Tax type. Valid values are:
    • product_tax: product tax
    • shipping_tax: shipping tax
  • taxable boolean
    Whether the product is subject to tax.
    • true: Tax is required.
    • false: No tax is required.
  • title string
    Product title.
  • variant_id string
    The unique identifier for the variant.
  • variant_title string
    Product variant value. Multiple values are separated by /.
  • vendor string
    Supplier.
  • locationsobject[]
    A list of product pickup location addresses.
  • location_id string
    Unique code of the pickup location.
  • name string
    Pickup location name.
  • type string
    Location type. Valid values are:
    • posLocation: The store location where this order was created through the POS channel. It is recommended to use pos_location_id, as this field will be deprecated.
    • pickupLocation: When the order's fulfillment method is self-pickup, this indicates the store location for pickup.
    • productLocation: The inventory location of the items in the order. It is recommended to use the location_id information in the line items, as this field will be deprecated.
  • name string
    Store custom order number, starting from 1001. You can set a prefix for this value, such as test1001.
  • note string
    Merchant notes.
  • note_attributesobject[]
    A list of merchant note logs.
  • create_time string
    Note creation time. Format: ISO 8601.
    Example: 2024-08-31T02:20:26+08:00
  • name string
    Merchant ID, indicating the note source.
  • value string
    Notes.
  • order_source string
    The order source channel handle. The handle is a semantic identifier.
  • order_status_url string
    Order status page URL.
  • payment_detailsobject[]
    A list of order payment information.
  • create_time string
    The date and time when the payment was created. Format: ISO 8601.
    Example: 2024-08-31T02:20:26+08:00
  • order_seq string
    The order ID.
  • pay_amount double
    Payment amount in the store currency. The value is rounded to two decimal places.
  • pay_channel_deal_id string
    Payment serial number from the external channel.
  • pay_seq string
    Payment order number.
  • pay_status string
    Payment status. Valid values are:
    • unpaid: unpaid
    • pending: payment in process
    • risking: under risk control
    • paid：paid
    • paid_overtime: payment timeout
    • paid_failed: payment failed
  • processed_at string
    Actual payment time. Format: ISO 8601.
    Example: 2024-08-31T02:20:26+08:00
  • status_code string
    Payment gateway standard status code.
  • status_msg string
    The description of status_code.
  • payment_gateway_names array
    Payment method list. Valid values are:
    • SLpayments
    • Paypal
    • Oceanpay
    • TwoCheckout
    • AsiaBill
    • Stripe
    • Pacypay
    • WorldPay
    • COD
    • CUSTOM
    • adjustPay
    • Xendit
    • XenditOther
  • phone string
    Buyer's mobile phone number.
  • po_number string
    Purchase order number for a B2B order.
  • pos_location_id string
    POS trading location ID.
  • presentment_currency string
    Buyer currency, the same as the store currency. A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • processed_at string
    Order completion time. Format: ISO 8601.
    Example: 2024-08-31T02:20:26+08:00
  • processed_user_id string
    The ID of the order creator.
  • refundsobject[]
    Refund list.
  • created_at string
    The date and time when the refund was created. Format: ISO 8601.
    Example: 2024-08-31T02:20:26+08:00
  • id string
    Refund ID.
  • note string
    Merchant's refund notes.
  • order_id string
    Order number.
  • processed_at string
    Refund initiation time. Format: ISO 8601.
    Example: 2024-08-31T02:20:26+08:00
  • refund_line_itemsobject[]
    A list of refund details for each item line.
  • id string
    Refund order number.
  • line_itemobject
    The product line information in the fulfillment.
  • attribute string
    The option information of the product variant, composed of the variant name and the option value.
    Example: color - red
  • fulfillable_quantity integer
    The remaining quantity of the product that can be shipped.
  • fulfillment_service string
    Logistics company name.
  • fulfillment_status string
    Shipping status. Valid values are:
    • fulfilled: order shipped
    • partial: order partially shipped
    • null: order not shipped
  • grams double
    The weight of the product in grams(g).
  • id string
    The ID of the line item snapshot table, generated by the system. Combined with the order ID, it uniquely identifies a line item.
  • name string
    SKU title, same as title.
  • price string
    The product price in the store currency. The value is rounded to two decimal places.
  • price_setobject
    The product price, displayed in both the store currency and the buyer currency.
  • presentment_moneyobject
    The product price information presented to the buyer.
  • amount string
    The product price. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The product price information recorded by the merchant.
  • amount string
    The product price. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • product_id string
    The unique identifier for the product corresponding to the variant.
  • quantity integer
    Quantity of items in the order.
  • requires_shipping boolean
    Indicates whether the product is subject to shipping.
    • true：Shipping is required.
    • false：Shipping is not required.
  • sku string
    The product SKU.
  • tax_linesobject[]
    A list of tax information.
  • price string
    Tax in the store currency. The value is rounded to two decimal places.
  • price_setobject
    The tax amount, displayed in both the buyer currency and the store currency.
  • presentment_moneyobject
    The tax amount information presented to the buyer.
  • amount string
    The tax amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The tax amount information recorded by the merchant.
  • amount string
    The tax amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • rate double
    The tax rate as a decimal value, rounded to four decimal places. For example, a 2% tax rate is represented as 0.0200. This field value is for display only.
  • title string
    The title for the tax description, for display only.
  • taxable boolean
    Whether the product is subject to tax.
    • true: Tax is required.
    • false: No tax is required.
  • title string
    Product title.
  • variant_id string
    The unique identifier for the variant.
  • variant_title string
    Product variant value. Multiple values are separated by /.
  • vendor string
    Supplier.
  • line_item_id string
    The ID of the line item snapshot table, generated by the system. Combined with the order ID, it uniquely identifies a line item.
  • quantity integer
    The quantity of refunded products.
  • restock_type string
    Inventory return type. Valid values are:
    • no_restock: not returned
    • cancel: canceled
    • return: returned
  • subtotal double
    The total amount of the refund in the store currency. It is calculated as the product of the unit price and quantity.
  • subtotal_setobject
    The total amount of the refund displayed in both the buyer currency and the store currency. It is calculated as the product of the unit price and quantity.
  • presentment_moneyobject
    The refund amount information presented to the buyer.
  • amount string
    The refund amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The refund amount information recorded by the merchant.
  • amount string
    The refund amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • total_tax double
    The tax amount of the refunded products, displayed in the store currency. The value is rounded to two decimal places.
  • total_tax_setobject
    The total tax amount, displayed in both the buyer currency and the store currency.
  • presentment_moneyobject
    The tax amount information presented to the buyer.
  • amount string
    The tax amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The tax amount information recorded by the merchant.
  • amount string
    The tax amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • transactionsobject[]
    A list of refund transaction information.
  • amount string
    The refund amount. The value is rounded to two decimal places.
  • created_at string
    The date and time when the refund transaction was created. Format: ISO 8601.
    Example: 2024-08-31T02:20:26+08:00
  • currency string
    Three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • id string
    Refund ID.
  • kind string
    Transaction type. The value is fixed to refund.
  • order_id string
    Order number.
  • processed_at string
    Refund order update time. Format: ISO 8601.
    Example: 2024-08-31T02:20:26+08:00
  • status string
    Refund status. Valid values are:
    • pending: refund in progress
    • failure: refund failed
    • success: refund successful
    • error: refund error
  • user_id string
    Buyer ID.
  • user_id string
    Buyer ID.
  • shipping_addressobject
    Shipping address.
  • address1 string
    The first line of the address. This typically includes information such as the street address or a post office box number.
  • address2 string
    The second line of the address. This typically includes information such as apartment, suite, or unit number.
  • city string
    The city in the address.
  • company string
    The company name of the recipient.
  • country string
    The country or region in the address.
  • country_code string
    A two-letter country or region code that follows the ISO 3166-1 standard, used to identify a specific country or region in the address.
  • first_name string
    The first name of the recipient.
  • last_name string
    The last name of the recipient.
  • latitude string
    The latitude where the address is located.
  • longitude string
    The longitude where the address is located.
  • name string
    The full name of the recipient.
  • phone string
    The phone number of the recipient.
  • province string
    The province in the shipping address.
  • province_code string
    The code for the province or region in the address, automatically generated by the system.
  • standard_province_code string
    The code for the province or region in an address, represented by the last two or three characters of the ISO 3166-2 standard, such as RI or ENG.
  • zip string
    The postal code information of the address.
  • shipping_linesobject[]
    A list of shipping fees.
  • code string
    Only local delivery shipping methods will return a value, displayed as Local delivery .
  • discount_allocationsobject[]
    A list of discount details.
  • amount string
    The discount amount in the store currency. The value is rounded to two decimal places.
  • amount_setobject
    The discount amount, displayed in both the buyer currency and the store currency.
  • presentment_moneyobject
    The discount amount information presented to the buyer.
  • amount string
    The discount amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The discount amount information recorded by the merchant.
  • amount string
    The discount amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • discount_application_index integer
    The position of the discount applied to the product within the orders.discount_applications list.
  • discounted_price string
    Discount amount. The value is rounded to two decimal places and displayed in the store currency.
  • discounted_price_setobject
    The discount amount, displayed in both the buyer currency and the store currency.
  • presentment_moneyobject
    The discount amount information presented to the buyer.
  • amount string
    The discount amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The discount amount information recorded by the merchant.
  • amount string
    The discount amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • phone string
    The phone number of the buyer.
  • price string
    The shipping fee amount in the store currency. The value is rounded to two decimal places.
  • price_setobject
    The shipping fee amount, displayed in both the buyer currency and the store currency.
  • presentment_moneyobject
    The shipping fee information presented to the buyer.
  • amount string
    The shipping fee. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The shipping fee information recorded by the merchant.
  • amount string
    The shipping fee. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • requested_fulfillment_service_id string
    Transportation service code.
  • shipping_price string
    The original shipping fee in the store currency, excluding any discounts. The value is rounded to two decimal places.
  • shipping_price_setobject
    The original shipping fee, excluding any discounts, displayed in both the buyer currency and the store currency.
  • presentment_moneyobject
    The shipping fee information presented to the buyer.
  • amount string
    The shipping fee. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The shipping fee information recorded by the merchant.
  • amount string
    The shipping fee. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • source string
    Logistics carrier type. Valid values are:
    • Shipper: Shipper logistics
    • Oneship: Oneship logistics
    • Api: logistics carriers added via open API capabilities
    • null: system logistics or custom logistics
  • tax_linesobject[]
    A list of tax information.
  • price string
    Tax in the store currency. The value is rounded to two decimal places.
  • price_setobject
    The tax amount, displayed in both the buyer currency and the store currency.
  • presentment_moneyobject
    The tax amount information presented to the buyer.
  • amount string
    The tax amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The tax amount information recorded by the merchant.
  • amount string
    The tax amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • rate double
    The tax rate as a decimal value, rounded to four decimal places. For example, a 2% tax rate is represented as 0.0200. This field value is for display only.
  • title string
    Tax name.
  • title string
    Logistics company name.
  • store_id string
    Store ID.
  • subtotal_price string
    The final price after discounts, calculated as the total product price minus any marketing discounts and custom discounts. The amount is displayed in the store currency.
  • subtotal_price_setobject
    The final price after discounts, calculated as the total product price minus any marketing discounts and custom discounts. This field contains amounts displayed in both the buyer and store currencies.
  • presentment_moneyobject
    The final price information presented to the buyer.
  • amount string
    The final price. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The discount amount information recorded by the merchant.
  • amount string
    The final price. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • tags string
    Order tags.
  • tax_linesobject[]
    A list of tax information.
  • price string
    Tax in the store currency. The value is rounded to two decimal places.
  • price_setobject
    The tax amount, displayed in both the buyer currency and the store currency.
  • presentment_moneyobject
    The tax amount information presented to the buyer.
  • amount string
    The tax amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The tax amount information recorded by the merchant.
  • amount string
    The tax amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • rate double
    The tax rate as a decimal value, rounded to four decimal places. For example, a 2% tax rate is represented as 0.0200. This field value is for display only.
  • title string
    The title for the tax description, for display only.
  • tax_number string
    Tax ID.
  • tax_type string
    The type of tax applicable to the order. Valid values are:
    • product_tax: product tax
    • shipping_tax: shipping tax
  • taxes_included boolean
    Indicates whether this order includes taxes.
    • true: including taxes
    • false: excluding taxes
  • total_discounts string
    The total order discount, calculated as the sum of marketing discounts and custom discounts. The amount is rounded to two decimal places and displayed in the store currency.
    DEPRECATED：This parameter is deprecated from API version v20210901.
    Example: 3.25
  • total_discounts_setobject
    The total order discount, calculated as the sum of marketing discounts and custom discounts. This field contains amounts displayed in both the buyer and store currencies.
    DEPRECATED：This parameter is deprecated from API version v20210901.
  • presentment_moneyobject
    The discount amount information presented to the buyer.
  • amount string
    The discount amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The discount amount information recorded by the merchant.
  • amount string
    The discount amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • total_line_items_price string
    The total original price of the products, rounded to two decimal places and displayed in the store currency.
  • total_line_items_price_setobject
    The total original price of the products, displayed in both the buyer currency and the store currency.
  • presentment_moneyobject
    The original price information presented to the buyer.
  • amount string
    The original price. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The original price information recorded by the merchant.
  • amount string
    The original price. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • total_outstanding string
    The total unpaid amount in the store currency. The value is rounded to two decimal places.
  • total_outstanding_setobject
    Unpaid amount, displayed in both the buyer currency and the store currency.
  • presentment_moneyobject
    The unpaid amount presented to the buyer.
  • amount string
    Unpaid amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The unpaid amount recorded by the merchant.
  • amount string
    Unpaid amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • total_shipping_price_setobject
    The total shipping fee for the order, displayed in both the buyer currency and the store currency.
  • presentment_moneyobject
    The shipping fee information presented to the buyer.
  • amount string
    The shipping fee. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The shipping fee information recorded by the merchant.
  • amount string
    The shipping fee. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • total_tax string
    The total tax amount in the store currency. The value is rounded to two decimal places.
  • total_tax_setobject
    The total tax amount, displayed in both the buyer currency and the store currency.
  • presentment_moneyobject
    The tax amount information presented to the buyer.
  • amount string
    Tax amount. The value is rounded to two decimal places. For example, 88.98.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The tax amount information recorded by the merchant.
  • amount string
    The tax amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • total_tip_received string
    The tip amount in the store currency. The value is rounded to two decimal places.
  • total_tip_received_setobject
    The tip amount, displayed in both the store currency and the buyer currency.
  • presentment_moneyobject
    The tip amount information presented to the buyer.
  • amount string
    The tip amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • shop_moneyobject
    The tip amount information recorded by the merchant.
  • amount string
    The tip amount. The value is rounded to two decimal places.
  • currency_code string
    A three-letter currency code that follows the ISO 4217 standard.
    Example: USD
  • total_weight double
    The total weight of products in grams(g).
  • updated_at string
    The date and time when the order was updated. Format：ISO 8601.
    Example: 2024-08-31T02:20:26+08:00
  • user_id string
    Buyer ID.
API Explorer
https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301

ParamOptions

— path required
— header required

Body

required
{
  "order": {
    "area_code": null,
    "customer_id": null,
    "email": null,
    "id": null,
    "line_items": [
      {
        "id": null,
        "tags": null
      }
    ],
    "note_attributes": [
      {
        "name": null,
        "value": null
      }
    ],
    "phone": null,
    "shipping_address": {
      "address1": null,
      "address2": null,
      "area": null,
      "area_code": null,
      "city": null,
      "city_code": null,
      "company": null,
      "country": null,
      "country_code": "US",
      "email": null,
      "first_name": null,
      "last_name": null,
      "latitude": null,
      "longitude": null,
      "phone": null,
      "province": null,
      "province_code": null,
      "zip": null
    },
    "tags": null
  }
}

Language

curl --request PUT \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301/orders/id.json \
     --header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --header 'accept: application/json'
Examples
Update an order
Request
{
  "order": {
    "area_code": "86",
    "customer_id": "*********4101",
    "email": "www.example.com",
    "id": "1001",
    "line_items": [
      {
        "id": "*******639",
        "tags": "tag1,tag2"
      }
    ],
    "note_attributes": [
      {
        "name": "Note source",
        "value": "Notes"
      }
    ],
    "phone": "139****1234",
    "shipping_address": {
      "address1": "Address 1",
      "address2": "Address 2",
      "area": "Area",
      "area_code": "210002",
      "city": "New York",
      "city_code": "210003",
      "company": "google",
      "country": "united states",
      "country_code": "US",
      "email": "www.example.com",
      "first_name": "Lebron",
      "last_name": "James",
      "latitude": "33.111232",
      "longitude": "11.22323",
      "phone": "139****1234",
      "province": "California",
      "province_code": "212221",
      "zip": "123551"
    },
    "tags": "xternal, Inbound, Outbound"
  }
}
Response
{
  "order": {
    "adjust_price": "8.00",
    "adjust_price_set": {
      "presentment_money": {
        "amount": "8.00",
        "currency_code": "USD"
      },
      "shop_money": {
        "amount": "8.00",
        "currency_code": "USD"
      }
    },
    "app_id": "SL201",
    "billing_address": {
      "address1": "Address1",
      "address2": "Address2",
      "city": "New York",
      "city_code": "NY",
      "company": "Example",
      "country": "United States",
      "country_code": "US",
      "first_name": "T**",
      "last_name": "S****",
      "name": "T** S****",
      "phone": "139****1234",
      "province": "California",
      "province_code": "212221",
      "standard_province_code": "US",
      "zip": "123551"
    },
    "browser_ip": "157.119.232.35",
    "buyer_note": "Notes",
    "cancel_reason": "ABC",
    "cancelled_at": "2024-08-31T02:20:26+08:00",
    "cart_token": "*****************2969577",
    "checkout_id": "***************972864",
    "checkout_token": "********************2969577",
    "client_details": {
      "browser_ip": "157.119.232.35",
      "session_hash": "***********22sf4",
      "user_agent": "ABC"
    },
    "company": {
      "id": "***************247856",
      "location_id": "******************47856",
      "tax_registration_id": "*****13"
    },
    "created_at": "2024-08-31T02:20:26+08:00",
    "credit_limit": {
      "credit_limit_currency": "USD",
      "is_credit_limit": "true",
      "outstanding_credit_limit": "1.00",
      "total_credit_limit": "1.00"
    },
    "currency": "USD",
    "current_extra_total_discounts": "799.00",
    "current_extra_total_discounts_set": {
      "presentment_money": {
        "amount": "799.00",
        "currency_code": "USD"
      },
      "shop_money": {
        "amount": "799.00",
        "currency_code": "USD"
      }
    },
    "current_on_line_total_discounts": "0.00",
    "current_on_line_total_discounts_set": {
      "presentment_money": {
        "amount": "1.00",
        "currency_code": "USD"
      },
      "shop_money": {
        "amount": "1.00",
        "currency_code": "USD"
      }
    },
    "current_subtotal_price": "1598.00",
    "current_subtotal_price_set": {
      "presentment_money": {
        "amount": "1598.00",
        "currency_code": "USD"
      },
      "shop_money": {
        "amount": "1598.00",
        "currency_code": "USD"
      }
    },
    "current_total_discounts": "799.00",
    "current_total_discounts_set": {
      "presentment_money": {
        "amount": "799.00",
        "currency_code": "USD"
      },
      "shop_money": {
        "amount": "799.00",
        "currency_code": "USD"
      }
    },
    "current_total_duties_set": {
      "presentment_money": {
        "amount": "8.88",
        "currency_code": "USD"
      },
      "shop_money": {
        "amount": "8.88",
        "currency_code": "USD"
      }
    },
    "current_total_price": "799.00",
    "current_total_price_set": {
      "presentment_money": {
        "amount": "799.00",
        "currency_code": "USD"
      },
      "shop_money": {
        "amount": "799.00",
        "currency_code": "USD"
      }
    },
    "current_total_tax": "0.00",
    "current_total_tax_set": {
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "customer": {
      "addresses": {
        "address1": "Address1",
        "address2": "Address2",
        "city": "New York",
        "country": "United States",
        "country_code": "US",
        "first_name": "T**",
        "last_name": "S****",
        "name": "T** S****",
        "phone": "139****1234",
        "province": "California",
        "province_code": "212221",
        "zip": "123551"
      },
      "area_code": "886",
      "created_at": "2024-08-31T02:20:26+08:00",
      "currency": "USD",
      "email": null,
      "first_name": "L***",
      "id": "*********83235",
      "last_name": "S****",
      "phone": "139****1234",
      "subscription": "ABC",
      "updated_at": "2024-08-31T02:20:26+08:00"
    },
    "customer_locale": "US",
    "deduct_member_point_amount": "8.00",
    "deduct_member_point_amount_set": {
      "presentment_money": {
        "amount": "8.88",
        "currency_code": "USD"
      },
      "shop_money": {
        "amount": "8.88",
        "currency_code": "USD"
      }
    },
    "discount_applications": {
      "allocation_method": "across",
      "code": "**********RBP5",
      "description": "ABC",
      "target_selection": "all",
      "target_type": "line_item",
      "title": "ABC",
      "type": "manual",
      "value": "20",
      "value_type": "ABC"
    },
    "discount_codes": [
      {
        "amount": "799.00",
        "amount_set": {
          "presentment_money": {
            "amount": "799.00",
            "currency_code": "USD"
          },
          "shop_money": {
            "amount": "799.00",
            "currency_code": "USD"
          }
        },
        "code": "ABC",
        "type": "custom discount"
      }
    ],
    "email": "*********@example.com",
    "financial_status": "unpaid",
    "fulfillment_status": "fulfilled",
    "fulfillments": {
      "created_at": "2022-11-04T10:18:46+00:00",
      "id": "****************214336",
      "line_items": {
        "attribute": "big",
        "bundle_parent_variant_id": "*****************34011",
        "fulfillable_quantity": "1",
        "fulfillment_service": "Sf international",
        "fulfillment_status": "fulfilled",
        "grams": "100",
        "id": "***2",
        "image_url": "www.example.com",
        "is_bundle": "true",
        "is_bundle_component": "true",
        "location_id": "*************9997",
        "name": "ABC",
        "price": "8.00",
        "price_set": {
          "presentment_money": {
            "amount": "8.00",
            "currency_code": "USD"
          },
          "shop_money": {
            "amount": "8.00",
            "currency_code": "USD"
          }
        },
        "product_id": "*******************934011",
        "quantity": "3",
        "requires_shipping": "true",
        "sku": "*****************644011",
        "tax_lines": {
          "price": "8.00",
          "price_set": {
            "presentment_money": {
              "amount": "8.00",
              "currency_code": "USD"
            },
            "shop_money": {
              "amount": "8.00",
              "currency_code": "USD"
            }
          },
          "rate": "1",
          "title": "Tax"
        },
        "taxable": "true",
        "title": "ABC",
        "variant_id": "******************44011",
        "variant_title": "big",
        "vendor": "Supplier"
      },
      "name": "ABC",
      "order_id": "*******************53153",
      "shipment_status": "fulfilled",
      "status": "success",
      "tracking_company": "Sf international",
      "tracking_info_list": {
        "tracking_company": "ABC",
        "tracking_number": "123",
        "tracking_url": "www.example.com"
      },
      "tracking_number": "*******001",
      "tracking_url": "www.example.com",
      "updated_at": "2022-11-04T10:18:46+00:00"
    },
    "hidden_order": "true",
    "id": "******************7930792",
    "line_items": {
      "attribute": "red",
      "discount_allocations": {
        "amount": "8.00",
        "amount_set": {
          "presentment_money": {
            "amount": "8.00",
            "currency_code": "USD"
          },
          "shop_money": {
            "amount": "8.00",
            "currency_code": "USD"
          }
        },
        "discount_application_index": "1"
      },
      "duties": {
        "country_code_of_origin": "US",
        "harmonized_system_code": "ABC",
        "id": "**2",
        "price": {
          "presentment_money": {
            "amount": "8.88",
            "currency_code": "USD"
          },
          "shop_money": {
            "amount": "8.88",
            "currency_code": "USD"
          }
        },
        "tax_lines": {
          "price_set": {
            "presentment_money": {
              "amount": "8.88",
              "currency_code": "USD"
            },
            "shop_money": {
              "amount": "8.88",
              "currency_code": "USD"
            }
          },
          "rate": null,
          "rate_percentage": null,
          "title": "ABC"
        }
      },
      "fulfillable_quantity": "1",
      "fulfillment_service": "Sf international",
      "fulfillment_status": "yun0001",
      "gift_card": "false",
      "grams": "100",
      "id": "**3",
      "image_url": "www.example.com",
      "location_id": "***************8524",
      "name": "ABC",
      "price": "8.00",
      "price_set": {
        "presentment_money": {
          "amount": "8.00",
          "currency_code": "USD"
        },
        "shop_money": {
          "amount": "8.00",
          "currency_code": "USD"
        }
      },
      "product_id": "***************934011",
      "properties": {
        "additional": "3",
        "name": "ABC",
        "type": "text",
        "urls": [
          "https://www.url.com"
        ],
        "value": "ABC"
      },
      "quantity": "1",
      "requires_shipping": "true",
      "sku": "***************7644011",
      "tags": "watch",
      "tax_lines": {
        "price": "8.00",
        "price_set": {
          "presentment_money": {
            "amount": "8.00",
            "currency_code": "USD"
          },
          "shop_money": {
            "amount": "8.00",
            "currency_code": "USD"
          }
        },
        "rate": "1",
        "title": "Tax",
        "type": "shipping_tax"
      },
      "taxable": "true",
      "title": "ABC",
      "variant_id": "*************44011",
      "variant_title": "big",
      "vendor": "Supplier"
    },
    "locations": {
      "location_id": "*************8524",
      "name": "ABC",
      "type": "posLocation"
    },
    "name": "SHO25246",
    "note": "ABC",
    "note_attributes": {
      "create_time": "2022-11-04T10:18:46+00:00",
      "name": "ABC",
      "value": "Content"
    },
    "order_at": "2021-08-16T08:27:57+00:00",
    "order_source": "pos",
    "order_status_url": "www.example.com",
    "payment_details": {
      "create_time": "2021-08-16T08:27:57+00:00",
      "pay_amount": "8.00",
      "pay_channel_deal_id": "*****************f48hX",
      "pay_seq": "****************676128",
      "pay_status": "unpaid",
      "processed_at": "2023-04-12T22:59:52+08:00",
      "status_code": "**********NG",
      "status_msg": "PENDING_REVIEW"
    },
    "payment_gateway_names": [
      "codPay"
    ],
    "payment_terms": {
      "created_at": "2025-08-13T16:31:59.715+0800",
      "due_in_days": "2",
      "id": "***************31747",
      "overdue": "true",
      "payment_schedules": {
        "completed_at": "2025-08-13T16:31:59.715+0800",
        "due_at": "2025-08-13T16:31:59.715+0800",
        "issued_at": "2025-08-13T16:31:59.715+0800"
      },
      "payment_terms_name": "ABC",
      "payment_terms_type": "RECEIPT",
      "updated_at": "2025-08-13T16:31:59.715+0800"
    },
    "phone": "139****1234",
    "po_number": "139****1234",
    "pos_location_id": "****************08779",
    "presentment_currency": "USD",
    "processed_at": "2023-04-12T22:59:52+08:00",
    "processed_user_id": "*********495",
    "refunds": {
      "created_at": "2021-08-16T08:27:57+00:00",
      "id": "*************77634",
      "note": "ABC",
      "order_id": "*****************253153",
      "processed_at": "2021-08-16T08:27:57+00:00",
      "refund_line_items": {
        "id": "*************877634",
        "line_item_id": "**1",
        "quantity": "1",
        "restock_type": "no_restock",
        "subtotal": "1.00",
        "subtotal_set": {
          "presentment_money": {
            "amount": "1.00",
            "currency_code": "USD"
          },
          "shop_money": {
            "amount": "1.00",
            "currency_code": "USD"
          }
        },
        "total_tax_set": {
          "presentment_money": {
            "amount": "1.00",
            "currency_code": "USD"
          },
          "shop_money": {
            "amount": "1.00",
            "currency_code": "USD"
          }
        }
      },
      "user_id": "**********495"
    },
    "shipping_address": {
      "address1": "Address 1",
      "address2": "Address 2",
      "city": "New York",
      "company": "ABC",
      "country": "USA",
      "country_code": "US",
      "delivery_store_code": "***1",
      "delivery_store_name": "ABC",
      "district": "ABC",
      "district_code": "*****300",
      "first_name": "T**",
      "last_name": "W****",
      "latitude": "23.35773",
      "longitude": "116.4151",
      "name": "T** W****",
      "phone": "139****1234",
      "province": "California",
      "province_code": "4200006",
      "standard_province_code": "US",
      "zip": "****00"
    },
    "shipping_lines": {
      "code": "SF***********776",
      "discount_allocations": {
        "amount": "8.00",
        "amount_set": {
          "presentment_money": {
            "amount": "8.00",
            "currency_code": "USD"
          },
          "shop_money": {
            "amount": "8.00",
            "currency_code": "USD"
          }
        },
        "discount_application_index": "1"
      },
      "discounted_price": "8.00",
      "discounted_price_set": {
        "presentment_money": {
          "amount": "8.00",
          "currency_code": "USD"
        },
        "shop_money": {
          "amount": "8.00",
          "currency_code": "USD"
        }
      },
      "phone": "139****1234",
      "price": "8.00",
      "price_set": {
        "presentment_money": {
          "amount": "8.00",
          "currency_code": "USD"
        },
        "shop_money": {
          "amount": "8.00",
          "currency_code": "USD"
        }
      },
      "shipping_price": "8.00",
      "source": "ABC",
      "tax_lines": {
        "price": "8.00",
        "price_set": {
          "presentment_money": {
            "amount": "8.00",
            "currency_code": "USD"
          },
          "shop_money": {
            "amount": "8.00",
            "currency_code": "USD"
          }
        },
        "rate": "1",
        "title": "Tax"
      },
      "title": "ABC"
    },
    "status": "open",
    "store_id": "1728640662479",
    "subtotal_price": "8.00",
    "subtotal_price_set": {
      "presentment_money": {
        "amount": "8.00",
        "currency_code": "USD"
      },
      "shop_money": {
        "amount": "8.00",
        "currency_code": "USD"
      }
    },
    "tags": "watch",
    "tax_lines": {
      "price": "8.00",
      "price_set": {
        "presentment_money": {
          "amount": "8.00",
          "currency_code": "USD"
        },
        "shop_money": {
          "amount": "8.00",
          "currency_code": "USD"
        }
      },
      "rate": "1",
      "title": "Tax"
    },
    "tax_number": "****11",
    "tax_type": "Type",
    "taxes_included": "true",
    "total_discounts": "8.00",
    "total_discounts_set": {
      "presentment_money": {
        "amount": "8.00",
        "currency_code": "USD"
      },
      "shop_money": {
        "amount": "8.00",
        "currency_code": "USD"
      }
    },
    "total_line_items_price": "8.00",
    "total_line_items_price_set": {
      "presentment_money": {
        "amount": "8.00",
        "currency_code": "USD"
      },
      "shop_money": {
        "amount": "8.00",
        "currency_code": "USD"
      }
    },
    "total_outstanding": "8.00",
    "total_outstanding_set": {
      "presentment_money": {
        "amount": "8.88",
        "currency_code": "USD"
      },
      "shop_money": {
        "amount": "8.88",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "presentment_money": {
        "amount": "8.00",
        "currency_code": "USD"
      },
      "shop_money": {
        "amount": "8.00",
        "currency_code": "USD"
      }
    },
    "total_tax": "8.00",
    "total_tax_set": {
      "presentment_money": {
        "amount": "8.00",
        "currency_code": "USD"
      },
      "shop_money": {
        "amount": "8.00",
        "currency_code": "USD"
      }
    },
    "total_tip_received": "8.00",
    "total_tip_received_set": {
      "presentment_money": {
        "amount": "8.88",
        "currency_code": "USD"
      },
      "shop_money": {
        "amount": "8.88",
        "currency_code": "USD"
      }
    },
    "total_weight": "USD",
    "updated_at": "2021-08-16T08:27:57+00:00",
    "user_id": "*********7495"
  }
}
Was this article helpful to you?
SHOPLINE
SHOPLINE
SHOPLINE Enterprise
Legal
Privacy
Terms
Developer Agreement
LinkedInEmail
LinkedInEmail
© Copyright 2013-2025 SHOPLINE Limited.