Order archive
PUT https://{handle}.myshopline.com/admin/openapi/v20270301/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 eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhcHBJZCI6MCwiYXBwS2V5IjoiNzU2ZjI1NWE2NjdlZTcwNTk1MzM0ZjVjYzk4NzU5MzBmN2E3NGZjMSIsImV4cCI6MTg3OTQ4MjA3NiwiaXNzIjoieXNvdWwiLCJzZWxsZXJJZCI6IjIwMDAyMzQ4ODAiLCJzdG9yZUlkIjoiMTY3MjM2OTcyOTYwNiIsInRpbWVzdGFtcCI6MTc4NDc4NzY3NjY2MSwidmVyc2lvbiI6IlYyIn0.3ZzbGAH4cLU1QR2VPEvMOQInUDvus-C4amkINSQIPuNVlXsFKj0sAt1c0KnUy9MWUOFV9cHlkf7J90r2y1FzpA
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
user_errorsobject[]
Error prompt information in this execution , if the implementation result is wrong , this field will return error informationmessage stringError messagecode stringWrong codeExample:illegal paramfield arrayPath that causes incorrect input fieldsExample:[""]orderobject
For order information, field descriptions and examples, please refer to the response result of the order listshipping_addressobject
Shipping addresslongitude stringLongitudeExample:41company stringCompany nameExample:New company namefirst_name stringLast nameExample:Tomcountry stringCountryExample:Usalatitude stringLatitudeExample:15province stringProvinceExample:Californiaphone stringPhoneExample:1320987655last_name stringFirst nameExample:Washingtonaddress2 stringDetailed address 2, optionalExample:Address 2zip stringPostal codeExample:92503address1 stringAddress 1Example:Address 1province_code stringProvince codeExample:4200006name stringFull nameExample:Tom Washingtoncountry_code stringCountry codeExample:UScity stringCityExample:New Yorkcancelled_at stringOrder cancellation time (end) (see IOS8601 for the format), 2012-05-01T14:22:25-04:00Example:2012-05-01T14:22:25-04:00current_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 currencyamount stringAmountExample:8.00currency_code stringCurrencyExample:USDpresentment_moneyobject
Buy side currencyamount stringAmountExample:8.00currency_code stringCurrencyExample:USDapp_id stringApp IDExample:222222currency stringTransaction currencyExample:USDtax_type stringTypes of tax IDExample:typecurrent_total_discounts stringSum of discounts, precision 2, marketing offers + artificial discountsExample:3.25id stringOrder number , system customization numberExample:21050224312121887324667162browser_ip stringClient IPExample:157.119.232.35cancel_reason stringSeller's reason for cancellationExample:" don ' t want to buy "total_discounts stringTotal discount, marketing discount + artificial discountExample:3.25store_id stringstore IDExample:1644828244663discount_applicationsobject[]
discount informationtarget_type string1)line_item、shipping_lineExample:line_itemvalue_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:1Q3UMQM8RBP5value stringThe specific value of the discount ( it can be n-fold , or it can be the specific amount value )Example:20target_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 titledescription stringDescription of custom discountExample:Discount descriptiontype stringdiscount typeExample:manualpayment_detailsobject[]
Payment slip informationstatus_msg stringPayment order status code descriptionExample:PENDING_REVIEWpay_status stringPayment slip status , unpaid- not paid ; pending- paying ; risking- wind control ; paid-paid ; paid_overtime- payment failed ; paid_failed- payment failure ;Example:unpaidstatus_code stringpayment status codeExample:RISK_PENDINGorder_seq stringOrder numberExample:23057287797738260472676128create_time stringPayment slip creation timeExample:2012-05-01T14:22:25-04:00pay_amount doublePayment amountExample:3.25pay_seq stringPayment slip numberExample:23057287797738260472676128pay_channel_deal_id stringExternal channel payment serial numberExample:pi_3MI897Hezv8FxjBO1uGxMPhXprocessed_at stringPayment creation time , format : 2023-04-12T22 : 59 : 52+08 : 00Example:2023-04-12T22:59:52+08:00customerobject
Buyer informationphone stringUser mobile phone numberExample:19872121232updated_at stringBuyer update timeExample:2012-05-01T14:22:25-04:00area_code stringPhone area codeExample:+86created_at stringBuyer creation time (see IOS8601 for the format)Example:2012-05-01T14:22:25-04:00id stringUser IDExample:4201057495currency stringCurrencyExample:USDaddressesobject
Buyer address informationname stringFull nameExample:Tom Washingtonprovince_code stringProvince codeExample:4300006city stringCityExample:New Yorklast_name stringFirst nameExample:Washingtonprovince stringProvinceExample:Californiacountry stringCountryExample:Usafirst_name stringLast nameExample:Tomphone stringPhoneExample:13652133421country_code stringCountry codeExample:USzip stringPostal codeExample:52134address1 stringDetailed address 1Example:Address 1address2 stringDetailed address 2, optionalExample:Address 2last_name stringLast nameExample:Washingtonemail stringUser mailboxExample:test001@Gmail.comfirst_name stringFirst nameExample:Tomphone stringBuyer contact information, there must be one of the twoExample:12903001000created_at stringOrder creation time (see IOS8601 for the format)Example:2012-05-01T14:22:25-04:00total_tip_received stringTip, precision 2Example:8.00total_line_items_price stringSum of original prices of goods, precision 2Example:8.00order_status_url stringOrder status page URLExample:https://shoptest.myshoplinestg.com/trade/thank_you?mainOrderMark=xxx&mainOrderSeq=200565776406008509total_outstanding stringSum of unpaid amount, precision 2Example:8.00current_subtotal_price stringSum of current products, total price of products * quantityExample:78.08updated_at stringOrder update time, (see IOS8601 for the format)Example:2012-05-01T14:22:25-04:00tags stringorder labelExample:Labelcurrent_total_discounts_setobject
presentment_moneyobject
Currency informationamount stringAmountExample:3.25currency_code stringCurrency informationExample:USDshop_moneyobject
Sell side amountamount stringAmountExample:3.25currency_code stringCurrencyExample:USDpresentment_currency stringBuy side currency, same as sell side currencyExample:USDtotal_tax stringSum of taxes, precision 2, commodity tax + shipping taxExample:8.00note stringMerchant notesExample:Notestotal_line_items_price_setobject
Sum of original price of goods, multi-currency informationpresentment_moneyobject
Buyer side amount informationcurrency_code stringCurrencyExample:USDamount stringAmount, Precision 2Example:8.00shop_moneyobject
Sell side amount informationamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDtotal_discounts_setobject
Multi-currency information of discount totalpresentment_moneyobject
Buyer side amount informationcurrency_code stringCurrencyExample:USDamount stringAmount, Precision 2Example:3.25shop_moneyobject
Sell side amount informationamount stringAmount, Precision 2Example:3.25currency_code stringCurrencyExample:USDcustomer_locale stringBuyer country, language code + country name abbreviationExample:enCNcheckout_id stringDiscard idExample:2404785166526352972864processed_user_id stringorder creatorExample:4201057495deduct_member_point_amount stringCurrent order member point deduction amountExample:3.25processed_at stringProcessed_at time , format : 2023-04-12T22 : 59 : 52+08 : 00Example:2023-04-12T22:59:52+08: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:USDcurrent_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:USDcheckout_token stringSettlement page tokenExample:c2c4a58186b9d96395d7e6b5c2969577total_weight doubleTotal product weight ( g )Example:100payment_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"]name stringCustom order numberExample:test1001total_shipping_price_setobject
Order shipping sum, 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:USDfulfillmentsobject[]
Package informationtracking_company stringLogistics company nameExample:SF Internationaltracking_number stringThird party tracking numberExample:yun0001updated_at stringUpdate time (see IOS8601 for the format)Example:2012-05-01T14:22:25-04:00id stringPackage numberExample:22046737798141702810214336shipment_status stringPackage trackingExample:fulfilledstatus stringLogistics delivery status, success-shipped; cancelled-cancelled;Example:cancelledline_itemsobject[]
Product listattribute 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_service stringLogistics company nameExample:Sfrequires_shipping booleanShipping or notgrams doubleWeight ( grams )Example:100title stringProduct titleExample:Beautiful skirtquantity integerQuantity of items in the orderExample:1fulfillable_quantity integerAvailable quantityExample:1vendor stringSupplierExample:Supplierfulfillment_status stringThe shipping status of the product, shipping status, fulfilled-shipped; partial-partially shipped; null-unshipped;Example:fulfilledvariant_id stringProduct SKU serial numberExample:18056761559987524812644011price stringCommodity price, precision 2Example:23.09taxable booleanTax or not?Example:truevariant_title stringCommodity attribute value, multiple divided by " / ", such as: "155 / red / large"Example:bigsku stringProduct code, barCodeExample:18056761559987524812644011name stringSKU title, same as titleExample:Product nameproduct_id stringSPU serial numberExample:16056761559984840457934011tax_linesobject[]
Tax informationprice_setobject
Multi-currency information of taxshop_moneyobject
Sell side amount informationamount stringAmountExample:3.25currency_code stringCurrencyExample:USDpresentment_moneyobject
Currency informationcurrency_code stringCurrencyExample:USDamount stringAmountExample:3.25rate doubleTax rateExample:1title stringTax nameExample:taxprice stringTax, precision 2Example:3.25order_id stringOrder numberExample:21056577640603870897253153tracking_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:00name stringinvoice short numberExample:1032-F2current_total_tax stringTotal tax, product tax + shipping taxExample:8.00client_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 Sabilling_addressobject
billing addresscompany stringCompany nameExample:new companyaddress1 stringBilling consignee detailed address ( up to 255 characters )Example:Address 1province_code stringBilling consignee name province encodingExample:4300006country stringBilling consignee country ( up to 64 characters )Example:Usaprovince stringBilling consignee name provinceExample:Californiazip stringBilling consignee name zipExample:521000last_name stringBill consignee last nameExample:Washingtonfirst_name stringBilling consignee nameExample:Tomcity stringBilling consignee city ( up to 64 characters )Example:New Yorkcountry_code stringBilling consignee national encodingExample:USname stringBilling nameExample:Tom Washingtonphone stringBill consignee name mobile phone numberExample:13890312312address2 stringBill consignee additional to detailed address ( up to 255 characters )Example:Address 2taxes_included booleanDoes the total include tax?tax_linesobject[]
Tax informationprice_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:taxprice stringTax amountExample:3.25cart_token stringShopping cart tokenExample:c2c4a58186b9d96395d7e6b5c2969577user_id stringBuyer IDExample:4201057495current_total_price stringTotal tax, product tax + shipping taxExample:8.00current_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:USDsubtotal_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:USDsubtotal_price stringTotal product price after discount, total product price - marketing discount - artificial discountExample:3.25shipping_linesobject[]
Logistics informationsource stringShipping sourceExample:sourcetitle stringLogistics nameExample:SF Internationaldiscounted_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:LX88888phone stringPhoneExample:13243214565price stringLogistics freight, precision 2Example:8.00code stringLogistics numberExample:SFdiscount_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.00tax_number stringTINExample:111111financial_status stringPayment status , un pad , authorized , pending , partially_paid , pad , partially_refunded , refundedExample:unpaidrefundsobject[]
Refund listrefund_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 linefulfillment_service stringLogistics company nameExample:Sffulfillable_quantity integerAvailable quantityExample:2tax_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:1id stringThe ID of the product snapshot table, generated by the system, uniquely confirms a product with the order numberExample:312requires_shipping booleanShipping or notExample:truetitle stringProduct titleExample:Beautiful skirtfulfillment_status stringThe shipping status of the product, shipping status, fulfilled-shipped; partial-partially shipped; null-unshipped;Example:fulfilledquantity integerQuantity of items in the orderExample:2variant_id stringProduct SKU serial numberExample:18056761559987524812644011attribute stringProduct attributes : name-attribute value multiple comma " , " division like : color-red , size-xExample:redproduct_id stringSPU serial numberExample:16056761559984840457934011taxable booleanTax or not?Example:truegrams doubleWeight ( grams )Example:100name stringSKU title, same as titleExample:test-002vendor stringSupplierExample:Suppliervariant_title stringCommodity attribute value, multiple divided by " / ", such as: "155 / red / large"Example:bigsku stringProduct code, barCodeExample:18056761559987524812644011price stringCommodity price, precision 2Example:3.25subtotal_setobject
Total refund amount, multi-currency information, same on seller and buyer sidepresentment_moneyobject
Buy side currencycurrency_code stringCurrencyExample:USDamount stringAmountExample:3.25shop_moneyobject
Sell side amount informationamount stringAmount, Precision 2Example:3.25currency_code stringCurrencyExample:USDquantity 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:302total_tax_setobject
Total tax amount, multi-currency informationshop_moneyobject
Sell side currencyamount stringAmountExample:3.25currency_code stringCurrencyExample:USDpresentment_moneyobject
Buy side currencyamount stringAmountExample:3.25currency_code stringCurrencyExample:USDtransactionsobject[]
Refund transaction informationstatus stringHandling status, pending, failure, success, and errorExample:pendingcurrency stringCurrencyExample:USDamount stringRefund amount , accuracy 2Example:3.25order_id stringOrder numberExample:21056577640603870897253153kind stringTransaction type (authorization, capture, sale, void, refund)Example:authorizationcreated_at stringCreation timeExample:2012-05-01T14:22:25-04:00id stringRefund IDExample:2605659027312156877634user_id stringBuyer IDExample:4201057495processed_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:00id 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: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:fulfillednote_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:Notesline_itemsobject[]
Order product snapshot informationvendor stringSupplierExample:Supplierfulfillable_quantity integerAvailable quantityExample:1tags stringCommodity tags (separated by multiple commas)Example:Tag 1 , cutepropertiesobject[]
Product customization informationname 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 valueadditional stringAdditional Fields for Custom ItemsExample:Additional fieldvariant_title stringCommodity attribute value, multiple divided by " / ", such as: "155 / red / large"Example:bigsku stringProduct code, barCodeExample:18056761559987524812644011name stringSKU title, same as titleExample:Product titleid stringThe ID of the product snapshot table, generated by the system, uniquely confirms a product with the order numberExample:417discount_allocationsobject[]
Marketing discount detail amount multi-currencyamount stringDiscount detail amountExample:8.00amount_setobject
Discount Details Amount Multi-Currencypresentment_moneyobject
payment currencycurrency_code stringCurrencyExample:USDamount stringAmount, Precision 2Example:8.00shop_moneyobject
Store currencyamount stringAmount, Precision 2Example:8.00currency_code stringCurrencyExample:USDdiscount_application_index integerIndicate the location in the discount detailsExample:1variant_id stringProduct SKU serial numberExample:18056761559987524812644011location_id stringThe location corresponding to the store in the pos sceneExample:5327026538935748524taxable booleanTax or not?Example:trueproduct_id stringSPU serial numberExample:16056761559984840457934011attribute stringProduct attributes : name-attribute value multiple comma " , " division like : color-red , size-xExample:redfulfillment_service stringLogistics company nameExample:Sfquantity integerQuantity of items in the orderExample:2price stringCommodity price, precision 2Example:3.25tax_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_taxgrams doubleWeight ( grams )Example:100requires_shipping booleanShipping or notExample:truefulfillment_status stringThe shipping status of the product, shipping status, fulfilled-shipped; partial-partially shipped; null-unshipped;Example:fulfilledtitle stringProduct titleExample:Nice looking skirtemail stringBuyer's mailbox, there must be one of the twoExample:test1002@Gmail.com
API Explorer
Debugger
Was this article helpful to you?