Order archive
PUT https://{handle}.myshopline.com/admin/openapi/v20260301/orders/:id/hide_mark.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 .Closes an open order.
Path Parameters
- id string requiredOrder numberExample:
21050342939778451436179579
Request Headers
- Content-Type string requiredThe field must be set to the fixed value
application/json; charset=utf-8. - Authorization string requiredThe 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
Status Codes
- 200
- 401
- 429
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
For order information, field descriptions and examples, please refer to the response result of the order listuser_id stringBuyer IDExample:4201057495payment_gateway_names arrayList of payment methods, list of payment methods used for this order, SLpayments, Paypal (PayPal payment), Oceanpay (Oceanpayment), TwoCheckout, AsiaBill, Stripe, Pacypay, WorldPay, COD (cash on delivery), CUSTOM (custom), adjustPay (funding adjustment), Xendit (xendit credit card), XenditOtherExample:["PayPal"]total_discounts_setobject
Multi-currency information of discount totalpresentment_moneyobject
Buyer side amount informationamount stringAmount, Precision 2Example:3.25currency_code stringCurrencyExample:USDshop_moneyobject
Sell side amount informationamount stringAmount, Precision 2Example:3.25currency_code stringCurrencyExample:USDcurrent_total_discounts_setobject
presentment_moneyobject
Currency informationamount stringAmountExample:3.25currency_code stringCurrency informationExample:USDshop_moneyobject
Sell side amountamount stringAmountExample:3.25currency_code stringCurrencyExample:USDapp_id stringApp IDExample:222222customer_locale stringBuyer country, language code + country name abbreviationExample:enCNcurrent_total_price stringTotal tax, product tax + shipping taxExample:8.00discount_codesobject[]
Promo code informationamount stringDiscount amount, precision 2Example:3.25code stringPromo codeExample:KIN4GNAB2FRHtype stringType of discount, reduced amount; discount; free shipping; fixed price; the lowest price item is free; package price; the Nth item is discounted;Example:deduction amounttotal_tax_setobject
Tax summation, multi-currency informationpresentment_moneyobject
Buyer side amount informationamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDshop_moneyobject
Sell side amount informationamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDorder_status_url stringOrder status page URLExample:https://shoptest.myshoplinestg.com/trade/thank_you?mainOrderMark=xxx&mainOrderSeq=200565776406008509current_total_price_setobject
Multi-currency information of the sum of taxes, the currency and amount of buyers and sellers are the samepresentment_moneyobject
Buy side currencyamount stringAmountExample:8.00currency_code stringCurrencyExample:USDshop_moneyobject
Sell side currencyamount stringAmountExample:8.00currency_code stringCurrencyExample:USDphone stringBuyer contact information, there must be one of the twoExample:12903001000total_outstanding stringSum of unpaid amount, precision 2Example:8.00currency stringTransaction currencyExample:USDtotal_discounts stringTotal discount, marketing discount + artificial discountExample:3.25store_id stringstore IDExample:1644828244663subtotal_price_setobject
Multi-currency information of total product price after discountshop_moneyobject
Sell side amount informationamount stringAmount, Precision 2Example:3.25currency_code stringCurrencyExample:USDpresentment_moneyobject
Buyer side amount informationamount stringAmount, Precision 2Example:3.25currency_code stringCurrencyExample:USDtax_type stringTypes of tax IDExample:typename stringCustom order numberExample:test1001created_at stringOrder creation time (see IOS8601 for the format)Example:2012-05-01T14:22:25-04:00current_total_discounts stringSum of discounts, precision 2, marketing offers + artificial discountsExample:3.25client_detailsobject
Client Detailsbrowser_ip stringClient ip addressExample:157.119.232.35session_hash stringMember session encryption informationExample:c2c4a58186b9d96395d7e6b5c2969577user_agent stringClient ProxyExample:Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/106.0.0.0 Sacurrent_subtotal_price_setobject
Multi-currency information of the current commodity sum, the buyer's and seller's currency and the amount are the samepresentment_moneyobject
Buy side currencyamount stringAmountExample:78.08currency_code stringCurrencyExample:USDshop_moneyobject
Sell side amountamount stringAmount, Precision 2Example:78.08currency_code stringCurrency codeExample:USDshipping_addressobject
Shipping addressprovince stringProvinceExample:Californiaprovince_code stringProvince codeExample:4200006name stringFull nameExample:Tom Washingtonlongitude stringLongitudeExample:41address2 stringDetailed address 2, optionalExample:Address 2phone stringPhoneExample:1320987655company stringCompany nameExample:New company namecountry_code stringCountry codeExample:USfirst_name stringLast nameExample:Tomcountry stringCountryExample:Usalast_name stringFirst nameExample:Washingtonzip stringPostal codeExample:92503address1 stringAddress 1Example:Address 1city stringCityExample:New Yorklatitude stringLatitudeExample:15presentment_currency stringBuy side currency, same as sell side currencyExample:USDbilling_addressobject
billing addressphone stringBill consignee name mobile phone numberExample:13890312312province stringBilling consignee name provinceExample:Californiaaddress2 stringBill consignee additional to detailed address ( up to 255 characters )Example:Address 2company stringCompany nameExample:new companyzip stringBilling consignee name zipExample:521000address1 stringBilling consignee detailed address ( up to 255 characters )Example:Address 1last_name stringBill consignee last nameExample:Washingtonprovince_code stringBilling consignee name province encodingExample:4300006country stringBilling consignee country ( up to 64 characters )Example:Usafirst_name stringBilling consignee nameExample:Tomcity stringBilling consignee city ( up to 64 characters )Example:New Yorkcountry_code stringBilling consignee national encodingExample:USname stringBilling nameExample:Tom Washingtontotal_tax stringSum of taxes, precision 2, commodity tax + shipping taxExample:8.00total_shipping_price_setobject
Order shipping sum, multi-currency informationshop_moneyobject
Sell side amount informationamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDpresentment_moneyobject
Buyer side amount informationamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDfinancial_status stringPayment status , un pad , authorized , pending , partially_paid , pad , partially_refunded , refundedExample:unpaidcancel_reason stringSeller's reason for cancellationExample:" don ' t want to buy "shipping_linesobject[]
Logistics informationcode stringLogistics numberExample:SFtitle stringLogistics nameExample:SF Internationaldiscount_allocationsobject[]
Discount Detailsdiscount_application_index integerDiscount index information : marked in the position of the discount detailsExample:1amount stringDiscount amount, precision 2Example:8.00amount_setobject
Discount Multi-Currency Amountpresentment_moneyobject
Buyer side amount informationamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDshop_moneyobject
Amount information on the store sideamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDdiscounted_price stringDiscount amount, precision 2Example:8.00discounted_price_setobject
Discount Multi-Currency Amountpresentment_moneyobject
Buyer side amount informationamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDshop_moneyobject
Amount information on the store sideamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDshipping_price stringThe value of the original shipping fee (not the amount after the discount)Example:8.00tax_linesobject[]
Logistics tax listrate doubleTax rateExample:1title stringTax nameExample:taxprice stringtaxExample:8.00price_setobject
Multi-currency information of taxpresentment_moneyobject
Buyer side amount informationamount stringAmountExample:8.00currency_code stringCurrencyExample:USDshop_moneyobject
Sell side amount informationamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDprice_setobject
Logistics freight multi-resource informationpresentment_moneyobject
Buyer side amount informationcurrency_code stringCurrencyExample:USDamount stringAmount, Precision 2Example:8.00shop_moneyobject
Amount information on the store sidecurrency_code stringCurrencyExample:USDamount stringAmount, Precision 2Example:8.00requested_fulfillment_service_id stringTransportation service codeExample:LX88888source stringShipping sourceExample:sourcephone stringPhoneExample:13243214565price stringLogistics freight, precision 2Example:8.00taxes_included booleanDoes the total include tax?tax_linesobject[]
Tax informationprice stringTax amountExample:3.25price_setobject
Multi-currency information of taxpresentment_moneyobject
Buyer side amount informationcurrency_code stringCurrencyamount stringAmount, Precision 2Example:USDshop_moneyobject
Sell side amount informationamount stringAmount, Precision 2Example:3.25currency_code stringCurrencyExample:USDrate doubleTax rateExample:1title stringTax nameExample:taxcurrent_subtotal_price stringSum of current products, total price of products * quantityExample:78.08subtotal_price stringTotal product price after discount, total product price - marketing discount - artificial discountExample:3.25checkout_id stringDiscard idExample:2404785166526352972864refundsobject[]
Refund listid stringRefund IDExample:2605659027312156877634note stringRefund NotesExample:Refund Notesorder_id stringOrder numberExample:21056577640603870897253153processed_at stringUpdate time (see IOS8601 for the format)Example:2012-05-02T14:22:25-04:00refund_line_itemsobject[]
Refund Detailsid stringOrder number for this adjustment of the single linkExample:2605659027312156877634subtotal doubleTotal refund amount, precision 2Example:3.25restock_type stringInventory return type, no_restock-not returned, cancel-cancelled, return-returned only not returnedExample:no_restocktotal_tax doubleTax amount of refunded goods, precision 2line_itemobject
Refund Product linerequires_shipping booleanShipping or notExample:truevendor stringSupplierExample:Supplierfulfillment_service stringLogistics company nameExample:Sfvariant_title stringCommodity attribute value, multiple divided by " / ", such as: "155 / red / large"Example:bigproduct_id stringSPU serial numberExample:16056761559984840457934011sku stringProduct code, barCodeExample:18056761559987524812644011title stringProduct titleExample:Beautiful skirtfulfillable_quantity integerAvailable quantityExample:2fulfillment_status stringThe shipping status of the product, shipping status, fulfilled-shipped; partial-partially shipped; null-unshipped;Example:fulfilledquantity integerQuantity of items in the orderExample:2price stringCommodity price, precision 2Example:3.25taxable booleanTax or not?Example:trueid stringThe ID of the product snapshot table, generated by the system, uniquely confirms a product with the order numberExample:312grams doubleWeight ( grams )Example:100tax_linesobject[]
Tax informationtitle stringTax titleExample:taxprice stringTax, precision 2Example:3.25price_setobject
Multi-currency information of taxpresentment_moneyobject
Buy side currencycurrency_code stringCurrencyExample:USDamount stringAmount, Precision 2Example:3.25shop_moneyobject
Sell side amount informationamount stringAmountExample:3.25currency_code stringCurrencyExample:USDrate doubleTax rateExample:1variant_id stringProduct SKU serial numberExample:18056761559987524812644011attribute stringProduct attributes : name-attribute value multiple comma " , " division like : color-red , size-xExample:redname stringSKU title, same as titleExample:test-002quantity integerQuantity, quantity of goodsExample:2line_item_id stringThe ID of the product snapshot table, generated by the system, uniquely confirms a product with the order numberExample:302subtotal_setobject
Total refund amount, multi-currency information, same on seller and buyer sidepresentment_moneyobject
Buy side currencyamount stringAmountExample:3.25currency_code stringCurrencyExample:USDshop_moneyobject
Sell side amount informationamount stringAmount, Precision 2Example:3.25currency_code stringCurrencyExample:USDtotal_tax_setobject
Total tax amount, multi-currency informationpresentment_moneyobject
Buy side currencyamount stringAmountExample:3.25currency_code stringCurrencyExample:USDshop_moneyobject
Sell side currencyamount stringAmountExample:3.25currency_code stringCurrencyExample:USDtransactionsobject[]
Refund transaction informationstatus stringHandling status, pending, failure, success, and errorExample:pendingcurrency stringCurrencyExample:USDkind stringTransaction type (authorization, capture, sale, void, refund)Example:authorizationamount stringRefund amount , accuracy 2Example:3.25created_at stringCreation timeExample:2012-05-01T14:22:25-04:00id stringRefund IDExample:2605659027312156877634user_id stringBuyer IDExample:4201057495order_id stringOrder numberExample:21056577640603870897253153processed_at stringRefund order update time ( format see IOS8601 )Example:2012-05-01T14:22:25-04:00user_id stringUser IDExample:4201057495created_at stringRefund form creation time (see IOS8601 for the format)Example:2012-05-01T14:22:25-04:00fulfillment_status stringShipping status, fulfilled-shipped; partial-partially shipped; null-unshipped; Note: the returned enum value is different from the query enumeration value of the input parameterExample:fulfilledid stringOrder number , system customization numberExample:21050224312121887324667162tax_number stringTINExample:111111fulfillmentsobject[]
Package informationtracking_company stringLogistics company nameExample:SF Internationaltracking_number stringThird party tracking numberExample:yun0001tracking_url stringLogistics company URLExample:https://www.sf-international.com/created_at stringCreation time (see IOS8601 for the format)Example:2012-05-01T14:22:25-04:00updated_at stringUpdate time (see IOS8601 for the format)Example:2012-05-01T14:22:25-04:00name stringinvoice short numberExample:1032-F2id stringPackage numberExample:22046737798141702810214336shipment_status stringPackage trackingExample:fulfilledstatus stringLogistics delivery status, success-shipped; cancelled-cancelled;Example:cancelledline_itemsobject[]
Product listquantity integerQuantity of items in the orderExample:1product_id stringSPU serial numberExample:16056761559984840457934011tax_linesobject[]
Tax informationrate doubleTax rateExample:1title stringTax nameExample:taxprice stringTax, precision 2Example:3.25price_setobject
Multi-currency information of taxpresentment_moneyobject
Currency informationcurrency_code stringCurrencyExample:USDamount stringAmountExample:3.25shop_moneyobject
Sell side amount informationamount stringAmountExample:3.25currency_code stringCurrencyExample:USDattribute stringProduct attributes : name-attribute value multiple comma " , " division like : color-red , size-xExample:redid stringThe ID of the product snapshot table, generated by the system, uniquely confirms a product with the order numberExample:312fulfillment_status stringThe shipping status of the product, shipping status, fulfilled-shipped; partial-partially shipped; null-unshipped;Example:fulfilledfulfillment_service stringLogistics company nameExample:Sfrequires_shipping booleanShipping or nottaxable booleanTax or not?Example:truevariant_title stringCommodity attribute value, multiple divided by " / ", such as: "155 / red / large"Example:biggrams doubleWeight ( grams )Example:100fulfillable_quantity integerAvailable quantityExample:1sku stringProduct code, barCodeExample:18056761559987524812644011title stringProduct titleExample:Beautiful skirtvariant_id stringProduct SKU serial numberExample:18056761559987524812644011price stringCommodity price, precision 2Example:23.09vendor stringSupplierExample:Suppliername stringSKU title, same as titleExample:Product nameorder_id stringOrder numberExample:21056577640603870897253153current_total_tax stringTotal tax, product tax + shipping taxExample:8.00total_tip_received stringTip, precision 2Example:8.00cart_token stringShopping cart tokenExample:c2c4a58186b9d96395d7e6b5c2969577checkout_token stringSettlement page tokenExample:c2c4a58186b9d96395d7e6b5c2969577customerobject
Buyer informationphone stringUser mobile phone numberExample:19872121232updated_at stringBuyer update timeExample:2012-05-01T14:22:25-04:00area_code stringPhone area codeExample:+86currency stringCurrencyExample:USDaddressesobject
Buyer address informationphone stringPhoneExample:13652133421province_code stringProvince codeExample:4300006city stringCityExample:New Yorklast_name stringFirst nameExample:Washingtoncountry_code stringCountry codeExample:USprovince stringProvinceExample:Californiazip stringPostal codeExample:52134address1 stringDetailed address 1Example:Address 1address2 stringDetailed address 2, optionalExample:Address 2country stringCountryExample:Usafirst_name stringLast nameExample:Tomname stringFull nameExample:Tom Washingtonlast_name stringLast nameExample:Washingtoncreated_at stringBuyer creation time (see IOS8601 for the format)Example:2012-05-01T14:22:25-04:00email stringUser mailboxExample:test001@Gmail.comfirst_name stringFirst nameExample:Tomid stringUser IDExample:4201057495cancelled_at stringOrder cancellation time (end) (see IOS8601 for the format), 2012-05-01T14:22:25-04:00Example:2012-05-01T14:22:25-04:00updated_at stringOrder update time, (see IOS8601 for the format)Example:2012-05-01T14:22:25-04:00discount_applicationsobject[]
discount informationtarget_selection string1 ) explicit ( discount distribution to clear selection ) 2 ) all ( discount distribution to all lines ) 3 ) ENTITLED ( discount distribution only to the line that its right to use )Example:explicittitle stringautomatic discount titleExample:Discount titlevalue_type string% discount , amount discountExample:fixed_amountallocation_method string1 ) across ( the value is distributed in all authorized lines ) 2 ) the ach ( the value is applied to each authorized line )Example:acrosscode stringdiscount codeExample:1Q3UMQM8RBP5description stringDescription of custom discountExample:Discount descriptiontype stringdiscount typeExample:manualtarget_type string1)line_item、shipping_lineExample:line_itemvalue stringThe specific value of the discount ( it can be n-fold , or it can be the specific amount value )Example:20current_total_tax_setobject
Multi-currency information of the sum of taxes, the currency and amount of buyers and sellers are the sameshop_moneyobject
Sell side currencycurrency_code stringCurrencyExample:USDamount stringAmountExample:8.00presentment_moneyobject
Buy side currencyamount stringAmountExample:8.00currency_code stringCurrencyExample:USDbrowser_ip stringClient IPExample:157.119.232.35total_weight doubleTotal product weight ( g )Example:100processed_user_id stringorder creatorExample:4201057495note_attributesobject[]
Merchant note log, date contentcreate_time stringRemark creation time (see IOS8601 for the format)Example:2012-05-01T14:22:25-04:00name stringRemark source (seller ID)Example:Notes sourcevalue stringNotesExample:Notesdeduct_member_point_amount stringCurrent order member point deduction amountExample:3.25note stringMerchant notesExample:Notesline_itemsobject[]
Order product snapshot informationgrams doubleWeight ( grams )Example:100name stringSKU title, same as titleExample:Product titlerequires_shipping booleanShipping or notExample:truevendor stringSupplierExample:Supplierfulfillable_quantity integerAvailable quantityExample:1id stringThe ID of the product snapshot table, generated by the system, uniquely confirms a product with the order numberExample:417fulfillment_service stringLogistics company nameExample:Sfdiscount_allocationsobject[]
Marketing discount detail amount multi-currencyamount stringDiscount detail amountExample:8.00amount_setobject
Discount Details Amount Multi-Currencypresentment_moneyobject
payment currencyamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDshop_moneyobject
Store currencyamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDdiscount_application_index integerIndicate the location in the discount detailsExample:1tags stringCommodity tags (separated by multiple commas)Example:Tag 1 , cutevariant_id stringProduct SKU serial numberExample:18056761559987524812644011quantity integerQuantity of items in the orderExample:2fulfillment_status stringThe shipping status of the product, shipping status, fulfilled-shipped; partial-partially shipped; null-unshipped;Example:fulfilledlocation_id stringThe location corresponding to the store in the pos sceneExample:5327026538935748524price stringCommodity price, precision 2Example:3.25title stringProduct titleExample:Nice looking skirtpropertiesobject[]
Product customization informationadditional stringAdditional Fields for Custom ItemsExample:Additional fieldname stringCustom attribute nameExample:Attribute nametype stringAttribute type, text-character, the display format is name: value; picture-picture, the display type is name: get the rendered thumbnail through URLs; link-hyperlink, the display type is name: value, supports clicking on the link to jump to urls FirstExample:texturls arrayURL resource listExample:["https://www.url.com"]value stringCustom attribute valuesExample:Attribute valuetax_linesobject[]
Tax informationprice stringTax, precision 2Example:3.25price_setobject
Multi-currency information of taxpresentment_moneyobject
Buy side currencyamount stringAmountExample:3.25currency_code stringCurrencyExample:USDshop_moneyobject
Sell side currencyamount stringAmountExample:3.25currency_code stringCurrencyExample:USDrate doubleTax rateExample:1title stringTax nameExample:taxtype stringTax fee type, used to distinguish whether it is commodity tax or freight tax, the enumerated values are as follows product_tax: commodity tax shipping_tax: freight taxExample:shipping_taxvariant_title stringCommodity attribute value, multiple divided by " / ", such as: "155 / red / large"Example:bigsku stringProduct code, barCodeExample:18056761559987524812644011taxable booleanTax or not?Example:trueproduct_id stringSPU serial numberExample:16056761559984840457934011attribute stringProduct attributes : name-attribute value multiple comma " , " division like : color-red , size-xExample:redprocessed_at stringProcessed_at time , format : 2023-04-12T22 : 59 : 52+08 : 00Example:2023-04-12T22:59:52+08:00tags stringorder labelExample:Labelemail stringBuyer's mailbox, there must be one of the twoExample:test1002@Gmail.compayment_detailsobject[]
Payment slip informationpay_amount doublePayment amountExample:3.25pay_seq stringPayment slip numberExample:23057287797738260472676128status_msg stringPayment order status code descriptionExample:PENDING_REVIEWpay_channel_deal_id stringExternal channel payment serial numberExample:pi_3MI897Hezv8FxjBO1uGxMPhXpay_status stringPayment slip status , unpaid- not paid ; pending- paying ; risking- wind control ; paid-paid ; paid_overtime- payment failed ; paid_failed- payment failure ;Example:unpaidprocessed_at stringPayment creation time , format : 2023-04-12T22 : 59 : 52+08 : 00Example:2023-04-12T22:59:52+08:00status_code stringpayment status codeExample:RISK_PENDINGorder_seq stringOrder numberExample:23057287797738260472676128create_time stringPayment slip creation timeExample:2012-05-01T14:22:25-04:00total_line_items_price_setobject
Sum of original price of goods, multi-currency informationpresentment_moneyobject
Buyer side amount informationamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDshop_moneyobject
Sell side amount informationamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDtotal_line_items_price stringSum of original prices of goods, precision 2Example:8.00user_errorsobject[]
Error prompt information in this execution , if the implementation result is wrong , this field will return error informationcode stringWrong codeExample:illegal paramfield arrayPath that causes incorrect input fieldsExample:[""]message stringError message
API Explorer
Debugger
Was this article helpful to you?