取消订单归档
PUT https://{handle}.myshopline.com/admin/openapi/v20260301/orders/:id/cancel_hide_mark.json
handle :店铺的唯一标识符,值为店铺域名的前缀。例如,域名为 open001.myshopline.com 的店铺,其 handle 是 open001 。取消归档订单v1
路径参数
- id string required订单号Example:
21050342939778451436179579
请求头
- Content-Type string required字段值固定为
application/json; charset=utf-8。 - Authorization string required资源的访问令牌。参考 应用授权 获取访问令牌,然后将获取到的访问令牌以 Bearer 格式传入。Example:
Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw
状态码
- 200
- 401
- 429
更多状态码信息,参考 HTTP 状态码。
响应头
traceId
请求的全局唯一标识符。用于追踪请求在系统中的流转,以便于问题发生时进行定位和调试。
响应体
orderobject
订单信息,字段描述、示例请参考订单列表响应结果updated_at string订单更新时间,(格式见IOS8601)Example:2012-05-01T14:22:25-04:00deduct_member_point_amount string当前订单会员积分抵扣金额Example:3.25subtotal_price string商品折后价总和, 商品总价 - 营销优惠 - 人工折扣Example:3.25tags string订单标签Example:标签tax_type string税号类型Example:类型total_tax_setobject
税费总和,多币种信息shop_moneyobject
卖家侧金额信息amount string金额,精度2Example:8.00currency_code string币种Example:USDpresentment_moneyobject
买家侧金额信息amount string金额,精度2Example:8.00currency_code string币种Example:USDfulfillment_status string发货状态, fulfilled-已发货; partial-部分发货; null-未发货; 注:返回的枚举值与入参的查询枚举值不一样Example:fulfilledline_itemsobject[]
订单商品快照信息sku string商品码,barCodeExample:18056761559987524812644011title string商品标题Example:好看的裙子location_id stringpos场景下店铺对应的地点Example:5327026538935748524taxable boolean是否收税Example:truevariant_title string商品属性值, 多个以" / "分割, 如: “155 / 红色 / 大"Example:大id string商品快照表的id, 系统生成,与订单号唯一确认一个商品Example:417quantity integer订单中的商品数量Example:2grams double重量(克)Example:100price string商品售价,精度2Example:3.25fulfillable_quantity integer可发货数量Example:1fulfillment_status string商品的发货状态, 发货状态, fulfilled-已发货; partial-部分发货; null-未发货;Example:fulfilledpropertiesobject[]
商品定制信息urls arrayurl资源列表Example:["https://www.url.com"]value string自定义属性值Example:属性值additional string定制商品附加字段Example:附加字段name string自定义属性名称Example:属性名称type string属性类型, text-字符,展示格式为 name: value; picture-图片,展示类型为 name: 通过urls获取渲染出缩略图;link-超链,展示类型为 name: value,支持点击链接跳转 到urls第一个Example:textproduct_id stringspu序列号Example:16056761559984840457934011fulfillment_service string物流商名称Example:顺丰requires_shipping boolean是否需要发货Example:truetax_linesobject[]
税费信息type string税费用类型,用于区分是商品税还是运费税,枚举值如下 product_tax:商品税 shipping_tax:运费税Example:shipping_taxprice string税费,精度2Example:3.25price_setobject
税费多币种信息presentment_moneyobject
买家侧币种amount string金额Example:3.25currency_code string币种Example:USDshop_moneyobject
卖家侧币种amount string金额Example:3.25currency_code string币种Example:USDrate double税率Example:1title string税费名称Example:税费variant_id string商品sku序列号Example:18056761559987524812644011attribute string商品属性:名称 - 属性值 多个以逗号", "分割 如:颜色 - 红色, 尺寸 - XExample:红色tags string商品标签(多个逗号隔开)Example:标签1,可爱的vendor string供应商Example:供应商discount_allocationsobject[]
营销折扣明细金额多币种amount string折扣明细金额Example:8.00amount_setobject
折扣明细金额多币种presentment_moneyobject
支付币种amount string金额,精度2Example:8.00currency_code string币种Example:USDshop_moneyobject
店铺币种amount string金额,精度2Example:8.00currency_code string币种Example:USDdiscount_application_index integer标明在折扣明细中的位置Example:1name stringsku标题,同titleExample:商品标题customer_locale string买家国家,语种编码+国家名称缩写Example:enCNid string订单号,系统自定义编号Example:21050224312121887324667162discount_codesobject[]
优惠码信息type string优惠类型,减金额;打折;免运费;固定售价;最低价商品免费;打包价;第N件打折;Example:减金额amount string优惠金额,精度2Example:3.25code string优惠码Example:KIN4GNAB2FRHcurrent_total_discounts string折扣总和,精度2,营销优惠+人工折扣Example:3.25total_tip_received string小费,精度2Example:8.00current_total_price string税费总和,商品税 + 运费税Example:8.00total_discounts_setobject
折扣总额多币种信息shop_moneyobject
卖家侧金额信息amount string金额,精度2Example:3.25currency_code string币种Example:USDpresentment_moneyobject
买家侧金额信息amount string金额,精度2Example:3.25currency_code string币种Example:USDtaxes_included boolean总计额是否包含税额phone string买家联系方式,二者必有其一Example:12903001000billing_addressobject
账单地址name string账单收件姓名Example:Tom Washingtoncity string账单收件人城市(最大64个字符)Example:纽约country_code string账单收件人国家编码Example:USphone string账单收件人名手机号Example:13890312312zip string账单收件人名邮编Example:521000country string账单收件人国家(最大64个字符)Example:美国first_name string账单收件人名Example:Tomprovince_code string账单收件人名省份编码Example:4300006company string公司名称Example:新公司last_name string账单收件人姓Example:Washingtonprovince string账单收件人 名省份Example:加利福尼亚州address1 string账单收件人详细地址(最大255个字符)Example:地址1address2 string账单收件人详细地址附加(最大255个字符)Example:地址2order_status_url string订单状态页urlExample:https://shoptest.myshoplinestg.com/trade/thank_you?mainOrderMark=xxx&mainOrderSeq=200565776406008509current_total_price_setobject
税费总和多币种信息, 买卖家币种和金额一致presentment_moneyobject
买家侧币种amount string金额Example:8.00currency_code string币种Example:USDshop_moneyobject
卖家侧币种amount string金额Example:8.00currency_code string币种Example:USDshipping_addressobject
收货地址country string国家Example:美国last_name string名Example:Washingtonlongitude string经度Example:41name string全名Example:Tom Washingtoncompany string公司名称Example:新公司名province_code string省份码Example:4200006country_code string国家码Example:USzip string邮编Example:92503address2 string详细地址2,备选Example:地址2first_name string姓Example:Tomphone string电话Example:1320987655address1 string地址1Example:地址1city string城市Example:纽约latitude string纬度Example:15province string省份Example:加利福尼亚州total_line_items_price string商 品原价总和,精度2Example:8.00total_shipping_price_setobject
订单运费总和,多币种信息presentment_moneyobject
买家侧金额信息currency_code string币种Example:USDamount string金额,精度2Example:8.00shop_moneyobject
卖家侧金额信息currency_code string币种Example:USDamount string金额,精度2Example:8.00total_tax string税费总和,精度2, 商品税 + 运费税Example:8.00store_id string店铺idExample:1644828244663current_total_tax string税费总和,商品税 + 运费税Example:8.00note_attributesobject[]
商家备注日志,日期内容create_time string备注创建时间(格式见IOS8601)Example:2012-05-01T14:22:25-04:00name string备注来源(卖家标识)Example:备注来源value string备注内容Example:备注内容created_at string订单创建时间(格式见IOS8601)Example:2012-05-01T14:22:25-04:00tax_linesobject[]
税费信息rate double税率Example:1title string税费名称Example:税费price string税费金额Example:3.25price_setobject
税费多币种信息shop_moneyobject
卖家侧金额信息amount string金额,精度2Example:3.25currency_code string币种Example:USDpresentment_moneyobject
买家侧金额信息amount string金额,精度2Example:USDcurrency_code string币种total_weight double商品总重量(g)Example:100checkout_id string弃单idExample:2404785166526352972864subtotal_price_setobject
商品折后价总和多币种信息presentment_moneyobject
买家侧金额信息amount string金额,精度2Example:3.25currency_code string币种Example:USDshop_moneyobject
卖家侧金额信息amount string金额,精度2Example:3.25currency_code string币种Example:USDcustomerobject
买家信息currency string币种Example:USDfirst_name string名Example:Tomid string用户idExample:4201057495updated_at string买家更新时间Example:2012-05-01T14:22:25-04:00addressesobject
买家地址信息country_code string国家码Example:USlast_name string名Example:Washingtonname string全名Example:Tom Washingtonzip string邮编Example:52134first_name string姓Example:Tomphone string电话Example:13652133421province string省份Example:加利福尼亚州province_code string省份码Example:4300006address1 string详细地址1Example:地址1address2 string详细地址2,备选Example:地址2city string城市Example:纽约country string国家Example:美国area_code string手机区号Example:+86created_at string买家创建时间(格式见IOS8601)Example:2012-05-01T14:22:25-04:00last_name string姓Example:Washingtonphone string用户手机号Example:19872121232email string用户邮箱Example:test001@Gmail.comprocessed_at stringprocessed_at 成单时间,格式:2023-04-12T22:59:52+08:00Example:2023-04-12T22:59:52+08:00checkout_token string结算页tokenExample:c2c4a58186b9d96395d7e6b5c2969577shipping_linesobject[]
物流信息discounted_price string折扣金额,精度2Example:8.00phone string电话Example:13243214565price_setobject
物流运费多资源信息presentment_moneyobject
买家侧金额信息currency_code string币种Example:USDamount string金额,精度2Example:8.00shop_moneyobject
店铺侧金额信息amount string金额,精度2Example:8.00currency_code string币种Example:USDrequested_fulfillment_service_id string运输服务代号Example:LX88888price string物流运费,精度2Example:8.00shipping_price string原运费金额值(非折扣后金额)Example:8.00source string运费来源Example:来源discounted_price_setobject
折扣多币种金额presentment_moneyobject
买家侧金额信息amount string金额,精度2Example:8.00currency_code string币种Example:USDshop_moneyobject
店铺侧金额信息amount string金额,精度2Example:8.00currency_code string币种Example:USDtitle string物流名称Example:顺丰国际code string物流编号Example:SFtax_linesobject[]
物流征税列表price string税费Example:8.00price_setobject
税费多币种信息presentment_moneyobject
买家侧金额信息amount string金额Example:8.00currency_code string币种Example:USDshop_moneyobject
卖家侧金额信息amount string金额,精度2Example:8.00currency_code string币种Example:USDrate double税率Example:1title string税费名称Example:税费discount_allocationsobject[]
折扣明细amount string折扣金额,精度2Example:8.00amount_setobject
折扣多币种金额presentment_moneyobject
买家侧金额信息currency_code string币种Example:USDamount string金额,精度2Example:8.00shop_moneyobject
店铺侧金额信息currency_code string币种Example:USDamount string金额,精度2Example:8.00discount_application_index integer折扣索引信息:标明在折扣明细中的位置Example:1cancel_reason string卖家取消原因Example:“不想买了”browser_ip string客户端ipExample:157.119.232.35processed_user_id string订单创建者Example:4201057495total_line_items_price_setobject
商品原价总和,多币种信息shop_moneyobject
卖家侧金额信息amount string金额,精度2Example:8.00currency_code string币种Example:USDpresentment_moneyobject
买家侧金额信息currency_code string币种Example:USDamount string金额,精度2Example:8.00current_total_tax_setobject
税费总和多币种信息, 买卖家币种和金额一致presentment_moneyobject
买家侧币种amount string金额Example:8.00currency_code string币种Example:USDshop_moneyobject
卖家侧币种amount string金额Example:8.00currency_code string币种Example:USDcurrency string交易币种Example:USDuser_id string买家idExample:4201057495app_id string应用方idExample:222222cart_token string购物车tokenExample:c2c4a58186b9d96395d7e6b5c2969577email string买家邮箱,二者必有其一Example:test1002@Gmail.comcurrent_subtotal_price string当前商品总和,商品总价*数量Example:78.08current_total_discounts_setobject
presentment_moneyobject
买家侧金额amount string金额Example:3.25currency_code string币种信息Example:USDshop_moneyobject
卖家侧金额amount string金额Example:3.25currency_code string币种Example:USDtotal_outstanding string未付款金额总和,精度2Example:8.00total_discounts string折扣总额,营销优惠+人工折扣Example:3.25tax_number string税号Example:111111name string自定义订单号Example:test1001current_subtotal_price_setobject
当前商品总和多币种信息, 买卖家币种和金额一致shop_moneyobject
卖家侧金额currency_code string币种codeExample:USDamount string金额,精度2Example:78.08presentment_moneyobject
买家侧币种amount string金额Example:78.08currency_code string币种Example:USDfulfillmentsobject[]
包裹信息id string包裹编号Example:22046737798141702810214336tracking_number string第三方物流单号Example:yun0001name string发货单短号Example:1032-F2order_id string订单号Example:21056577640603870897253153shipment_status string包裹状态Example:fulfilledtracking_company string物流公司名称Example:顺丰国际updated_at string更新时间(格式见IOS8601)Example:2012-05-01T14:22:25-04:00line_itemsobject[]
商品列表name stringsku标题,同titleExample:商品名称requires_shipping boolean是否需要发货variant_title string商品属性值, 多个以" / "分割, 如: “155 / 红色 / 大"Example:大attribute string商品属性:名称 - 属性值 多个以逗号", "分割 如:颜色 - 红色, 尺寸 - XExample:红色fulfillment_service string物流商名称Example:顺丰fulfillment_status string商品的发货状态, 发货状态, fulfilled-已发货; partial-部分发货; null-未发货;Example:fulfilledtaxable boolean是否收 税Example:truesku string商品码,barCodeExample:18056761559987524812644011fulfillable_quantity integer可发货数量Example:1variant_id string商品sku序列号Example:18056761559987524812644011grams double重量(克)Example:100product_id stringspu序列号Example:16056761559984840457934011tax_linesobject[]
税费信息price_setobject
税费多币种信息presentment_moneyobject
买家侧金额amount string金额Example:3.25currency_code string币种Example:USDshop_moneyobject
卖家侧金额信息amount string金额Example:3.25currency_code string币种Example:USDrate double税率Example:1title string税费名称Example:税费price string税费,精度2Example:3.25quantity integer订单中的商品数量Example:1price string商品售价,精度2Example:23.09title string商品标题Example:漂亮的裙子vendor string供应商Example:供应商id string商品快照表的id, 系统生成,与订单号唯一确认一个商品Example:312status string物流配送状态, success-已发货; cancelled-已取消;Example:cancelledtracking_url string物流公司urlExample:https://www.sf-international.com/created_at string创建时间(格式见IOS8601)Example:2012-05-01T14:22:25-04:00presentment_currency string买家侧币种,同卖家侧币种Example:USDfinancial_status string支付状态,unpaid,authorized, pending,partially_paid,paid,partially_refunded,refundedExample:unpaidpayment_detailsobject[]
支付单信息status_code string支付状态码Example:RISK_PENDINGpay_amount double支付金额Example:3.25pay_status string支付单状态, unpaid-未支付;pending-支付中;risking-风控中;paid-已支付;paid_overtime-支付失败;paid_failed-支付失败;Example:unpaidprocessed_at string支付创建时间,格式:2023-04-12T22:59:52+08:00Example:2023-04-12T22:59:52+08:00create_time string支付单创建时间Example:2012-05-01T14:22:25-04:00order_seq string订单号Example:23057287797738260472676128pay_seq string支付单号Example:23057287797738260472676128status_msg string支付单状态码描述Example:PENDING_REVIEWpay_channel_deal_id string外部渠道支付流水号Example:pi_3MI897Hezv8FxjBO1uGxMPhXcancelled_at string订单取消时间(结束)(格式见IOS8601),2012-05-01T14:22:25-04:00Example:2012-05-01T14:22:25-04:00discount_applicationsobject[]
折扣信息target_selection string1)explicit(折扣分配到明确选择的行) 2)all(折扣分配到所有行) 3)ENTITLED(折扣仅分配到其有权使用的行)Example:explicitvalue_type string百分比折扣、金额折扣Example:fixed_amountdescription string自定义折扣的描述Example:折扣描述title string自动折扣的标题Example:折扣标题type string折扣类型Example:manualvalue string折扣的具体值(可以是 N折,也可以是具体的 金额值)Example:20allocation_method string1)across(该值分布在所有授权行中) 2)each(该值应用于每个授权行)Example:acrosstarget_type string1)line_item、shipping_lineExample:line_itemcode string折扣码Example:1Q3UMQM8RBP5client_detailsobject
客户端详细信息browser_ip string客户端IP地址Example:157.119.232.35session_hash string会员会话加密信息Example:c2c4a58186b9d96395d7e6b5c2969577user_agent string客户端代理Example:Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/106.0.0.0 Sanote string