更新订单

需要 write_orders 权限点。
更多权限点使用信息,请参考:
PUT https://{handle}.myshopline.com/admin/openapi/v20220901/orders/:id.json
handle ：店铺的唯一标识符，值为店铺域名的前缀。例如，域名为 open001.myshopline.com 的店铺，其 handle 是 open001 。
更新订单
路径参数
  • id string required
    订单号
    Example: "21050342939778451436179579"
请求头
  • Content-Type required
    字段值固定为application/json; charset=utf-8
  • Authorization string required
    资源的访问令牌。请参考 应用授权 获取访问令牌，然后将获取到的访问令牌以 Bearer 格式传入
    Example:
    Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw
请求体
  • orderobject
    订单对象
  • id string
    订单号
  • note_attributesobject[]
    附加信息
  • name string
    名称
  • value string
    值
  • tags string
    订单标签，多个以英文逗号分割
    Example: xternal, Inbound, Outbound
响应
更多状态码信息请参考 HTTP 状态码
响应头
  • traceId
    traceId
响应体
  • orderobject
    订单信息,字段描述、示例请参考订单列表响应结果
  • app_id string
    应用方id
  • billing_addressobject
    账单地址
  • address1 string
    账单收件人详细地址（最大255个字符）
  • address2 string
    账单收件人详细地址附加（最大255个字符）
  • city string
    账单收件人城市（最大64个字符）
  • company string
    公司名称
  • country string
    账单收件人国家（最大64个字符）
  • country_code string
    账单收件人国家编码
  • first_name string
    账单收件人名
  • last_name string
    账单收件人姓
  • name string
    账单收件姓名
  • phone string
    账单收件人名手机号
  • province string
    账单收件人名省份
  • province_code string
    账单收件人名省份编码
  • zip string
    账单收件人名邮编
  • browser_ip string
    客户端ip
  • cancel_reason string
    卖家取消原因
  • cancelled_at string
    订单取消时间（结束）（格式见IOS8601）,2012-05-01T14:22:25-04:00
  • cart_token string
    购物车token
  • checkout_id string
    弃单id
  • checkout_token string
    结算页token
  • client_detailsobject
    客户端详细信息
  • browser_ip string
    详细地址1
  • session_hash string
    sessionId
  • user_agent string
    客户端代理
  • created_at string
    订单创建时间（格式见IOS8601）
  • currency string
    交易币种
  • current_subtotal_price string
    当前商品总和，商品总价*数量
  • current_subtotal_price_setobject
    当前商品总和多币种信息， 买卖家币种和金额一致
  • presentment_moneyobject
    买家侧币种
  • amount string
    金额
  • currency_code string
    币种
  • shop_moneyobject
    卖家侧金额
  • amount string
    金额，精度2
  • currency_code string
    币种code
  • current_total_discounts string
    折扣总和，精度2，营销优惠+人工折扣
  • current_total_discounts_setobject
  • presentment_moneyobject
    买家侧金额
  • amount string
    金额
  • currency_code string
    币种信息
  • shop_moneyobject
    卖家侧金额
  • amount string
    金额
  • currency_code string
    币种
  • current_total_price string
    税费总和，商品税 + 运费税
  • current_total_price_setobject
    税费总和多币种信息， 买卖家币种和金额一致
  • presentment_moneyobject
    买家侧币种
  • amount string
    金额
  • currency_code string
    币种
  • shop_moneyobject
    卖家侧币种
  • amount string
    金额
  • currency_code string
    币种
  • current_total_tax string
    税费总和，商品税 + 运费税
  • current_total_tax_setobject
    税费总和多币种信息， 买卖家币种和金额一致
  • presentment_moneyobject
    买家侧币种
  • amount string
    金额
  • currency_code string
    币种
  • shop_moneyobject
    卖家侧币种
  • amount string
    金额
  • currency_code string
    币种
  • customerobject
    买家信息
  • addressesobject
    买家地址信息
  • address1 string
    详细地址1
  • address2 string
    详细地址2，备选
  • city string
    城市
  • country string
    国家
  • country_code string
    国家码
  • first_name string
    姓
  • last_name string
    名
  • name string
    全名
  • phone string
    电话
  • province string
    省份
  • province_code string
    省份码
  • zip string
    邮编
  • area_code string
    手机区号
  • created_at string
    买家创建时间（格式见IOS8601）
  • currency string
    币种
  • email string
    用户邮箱
  • first_name string
    名
  • id string
    用户id
  • last_name string
    姓
  • phone string
    用户手机号
  • updated_at string
    买家更新时间
  • customer_locale string
    买家国家，语种编码+国家名称缩写
  • deduct_member_point_amount string
    当前订单会员积分抵扣金额
  • discount_applicationsobject[]
    折扣信息
  • allocation_method string
    1）across（该值分布在所有授权行中） 2）each（该值应用于每个授权行）
    Example: across
  • code string
    折扣码
    Example: 1Q3UMQM8RBP5
  • description string
    自定义折扣的描述
    Example: 折扣描述
  • target_selection string
    1）explicit（折扣分配到明确选择的行） 2）all（折扣分配到所有行） 3）ENTITLED（折扣仅分配到其有权使用的行）
    Example: explicit
  • target_type string
    1）line_item、shipping_line
    Example: line_item
  • title string
    自动折扣的标题
    Example: 折扣标题
  • type string
    折扣类型
    Example: manual
  • value string
    折扣的具体值（可以是 N折，也可以是具体的 金额值）
    Example: 20
  • value_type string
    百分比折扣、金额折扣
    Example: fixed_amount
  • discount_codesobject[]
    优惠码信息
  • amount string
    优惠金额,精度2
  • code string
    优惠码
  • type string
    优惠类型，减金额；打折；免运费；固定售价；最低价商品免费；打包价；第N件打折；
  • email string
    买家邮箱,二者必有其一
  • financial_status string
    支付状态，unpaid，authorized, pending，partially_paid，paid，partially_refunded，refunded
  • fulfillment_status string
    发货状态， fulfilled-已发货; partial-部分发货； null-未发货; 注：返回的枚举值与入参的查询枚举值不一样
  • fulfillmentsobject[]
    包裹信息
  • created_at string
    创建时间（格式见IOS8601）
  • id string
    包裹编号
  • line_itemsobject[]
    商品列表
  • attribute string
    商品属性：名称 - 属性值 多个以逗号", "分割 如：颜色 - 红色, 尺寸 - X
  • fulfillable_quantity integer
    可发货数量
  • fulfillment_service string
    物流商名称
  • fulfillment_status string
    商品的发货状态， 发货状态， fulfilled-已发货; partial-部分发货； null-未发货;
  • grams double
    重量（克）
  • id string
    商品快照表的id, 系统生成，与订单号唯一确认一个商品
  • name string
    sku标题,同title
  • price string
    商品售价，精度2
  • product_id string
    spu序列号
  • quantity integer
    订单中的商品数量
  • requires_shipping boolean
    是否需要发货
  • sku string
    商品码，barCode
  • tax_linesobject[]
    税费信息
  • price string
    税费，精度2
  • price_setobject
    税费多币种信息
  • presentment_moneyobject
    买家侧金额
  • amount string
    金额
  • currency_code string
    币种
  • shop_moneyobject
    卖家侧金额信息
  • amount string
    金额
  • currency_code string
    币种
  • rate double
    税率
  • title string
    税费名称
  • taxable boolean
    是否收税
  • title string
    商品标题
  • variant_id string
    商品sku序列号
  • variant_title string
    商品属性值, 多个以" / "分割, 如： “155 / 红色 / 大"
  • vendor string
    供应商
  • name string
    发货单短号
    Example: 1032-F2
  • order_id string
    订单号
  • shipment_status string
    包裹状态
  • status string
    物流配送状态， success-已发货； cancelled-已取消；
  • tracking_company string
    物流公司名称
  • tracking_number string
    第三方物流单号
  • tracking_url string
    物流公司url
  • updated_at string
    更新时间（格式见IOS8601）
  • id string
    是否是归档订单, true=已归档订单， false=未归档订单
  • line_itemsobject[]
    订单商品快照信息
  • attribute string
    商品属性：名称 - 属性值 多个以逗号", "分割 如：颜色 - 红色, 尺寸 - X
  • discount_allocationsobject[]
    营销折扣明细金额多币种
  • amount string
    折扣明细金额
    Example: 8.00
  • amount_setobject
    折扣明细金额多币种
  • presentment_moneyobject
    支付币种
  • amount string
    金额，精度2
    Example: 8.00
  • currency_code string
    币种
    Example: USD
  • shop_moneyobject
    店铺币种
  • amount string
    金额，精度2
    Example: 8.00
  • currency_code string
    币种
    Example: USD
  • discount_application_index integer
    标明在折扣明细中的位置
    Example: 1
  • fulfillable_quantity integer
    可发货数量
  • fulfillment_service string
    物流商名称
  • fulfillment_status string
    商品的发货状态， 发货状态， fulfilled-已发货; partial-部分发货； null-未发货;
  • grams double
    重量（克）
  • id string
    商品快照表的id, 系统生成，与订单号唯一确认一个商品
  • location_id string
    pos场景下店铺对应的地点
    Example: 5327026538935748524
  • name string
    sku标题,同title
  • price string
    商品售价，精度2
  • product_id string
    spu序列号
  • propertiesobject[]
    商品定制信息
  • additional string
    定制商品附加字段
  • name string
    自定义属性名称
  • type string
    属性类型, text-字符，展示格式为 name: value; picture-图片，展示类型为 name: 通过urls获取渲染出缩略图；link-超链，展示类型为 name: value，支持点击链接跳转 到urls第一个
  • urls array
    url资源列表
    Example: ``
  • value string
    自定义属性值
  • quantity integer
    订单中的商品数量
  • requires_shipping boolean
    是否需要发货
  • sku string
    商品码，barCode
  • tags string
    商品标签（多个逗号隔开）
  • tax_linesobject[]
    税费信息
  • price string
    税费，精度2
  • price_setobject
    税费多币种信息
  • presentment_moneyobject
    买家侧币种
  • amount string
    金额
  • currency_code string
    币种
  • shop_moneyobject
    卖家侧币种
  • amount string
    金额
  • currency_code string
    币种
  • rate double
    税率
  • title string
    税费名称
  • type string
    税费用类型，用于区分是商品税还是运费税，枚举值如下 product_tax：商品税 shipping_tax：运费税
    Example: shipping_tax
  • taxable boolean
    是否收税
  • title string
    商品标题
  • variant_id string
    商品sku序列号
  • variant_title string
    商品属性值, 多个以" / "分割, 如： “155 / 红色 / 大"
  • vendor string
    供应商
  • name string
    自定义订单号
  • note string
    商家备注内容
  • note_attributesobject[]
    商家备注日志，日期内容
  • create_time string
    备注创建时间（格式见IOS8601）
  • name string
    备注来源（卖家标识）
  • value string
    备注内容
  • order_status_url string
    订单状态页url
  • payment_detailsobject[]
    支付单信息
  • create_time string
    支付单创建时间
  • order_seq string
    订单号
  • pay_amount double
    支付金额
  • pay_channel_deal_id string
    外部渠道支付流水号
  • pay_seq string
    支付单号
  • pay_status string
    支付单状态, unpaid-未支付；pending-支付中；risking-风控中；paid-已支付；paid_overtime-支付失败；paid_failed-支付失败；
  • payment_gateway_names array
    付款方式列表,该订单所用到的付款方式列表, SLpayments ,Paypal(PayPal支付), Oceanpay(钱海支付), TwoCheckout,AsiaBill, Stripe,Pacypay, WorldPay, COD（货到付款), CUSTOM(自定义), adjustPay（资金调整）, Xendit(xendit信用卡), XenditOther
    Example: ``
  • phone string
    买家联系方式，二者必有其一
  • presentment_currency string
    买家侧币种,同卖家侧币种
  • processed_user_id string
    订单创建者
  • refundsobject[]
    退款列表
  • created_at string
    退款单创建时间 （格式见IOS8601）
  • id string
    退款id
  • note string
    退款备注
  • order_id string
    订单号
  • processed_at string
    更新时间 （格式见IOS8601）
  • refund_line_itemsobject[]
    退款详细信息
  • id string
    退款单号
  • line_itemobject
    退款商品行
  • attribute string
    商品属性：名称 - 属性值 多个以逗号", "分割 如：颜色 - 红色, 尺寸 - X
  • fulfillable_quantity integer
    可发货数量
  • fulfillment_service string
    物流商名称
  • fulfillment_status string
    商品的发货状态， 发货状态， fulfilled-已发货; partial-部分发货； null-未发货;
  • grams double
    重量（克）
  • id string
    商品快照表的id, 系统生成，与订单号唯一确认一个商品
  • name string
    sku标题,同title
  • price string
    商品售价，精度2
  • product_id string
    spu序列号
  • quantity integer
    订单中的商品数量
  • requires_shipping boolean
    是否需要发货
  • sku string
    商品码，barCode
  • tax_linesobject[]
    税费信息
  • price string
    税费，精度2
  • price_setobject
    税费多币种信息
  • presentment_moneyobject
    买家侧币种
  • amount string
    金额，精度2
  • currency_code string
    币种
  • shop_moneyobject
    卖家侧金额信息
  • amount string
    金额
  • currency_code string
    币种
  • rate double
    税率
  • title string
    标题
  • taxable boolean
    是否收税
  • title string
    商品标题
  • variant_id string
    商品sku序列号
  • variant_title string
    商品属性值, 多个以" / "分割, 如： “155 / 红色 / 大"
  • vendor string
    供应商
  • line_item_id string
    商品快照表的id, 系统生成，与订单号唯一确认一个商品
  • quantity integer
    数量,商品数量
  • restock_type string
    库存返还类型,no_restock-未返还，cancel-取消， return-返还 只有未返还
  • subtotal double
    退款金额合计，精度2
  • subtotal_setobject
    退款金额合计，多币种信息，卖家和买家侧相同
  • presentment_moneyobject
    买家侧币种
  • amount string
    金额
  • currency_code string
    币种
  • shop_moneyobject
    卖家侧金额信息
  • amount string
    金额，精度2
  • currency_code string
    币种
  • total_tax double
    退款商品的税额，精度2
  • total_tax_setobject
    总税额，多币种信息
  • presentment_moneyobject
    买家侧币种
  • amount string
    金额
  • currency_code string
    币种
  • shop_moneyobject
    卖家侧币种
  • amount string
    金额
  • currency_code string
    币种
  • transactionsobject[]
    退款交易信息
  • amount string
    退款金额，精度2
  • created_at string
    创建时间
  • currency string
    币种
  • id string
    退款id
  • kind string
    交易类型（authorization， capture， sale， void， refund）
  • order_id string
    订单号
  • processed_at string
    创建时间
  • status string
    处理状态, pending, failure, success, and error
  • user_id string
    买家id
  • user_id string
    用户id
  • shipping_addressobject
    收货地址
  • address1 string
    地址1
  • address2 string
    详细地址2，备选
  • city string
    城市
  • company string
    公司名称
  • country string
    国家
  • country_code string
    国家码
  • first_name string
    姓
  • last_name string
    名
  • latitude string
    纬度
  • longitude string
    经度
  • name string
    全名
  • phone string
    电话
  • province string
    省份
  • province_code string
    省份码
  • zip string
    邮编
  • shipping_linesobject[]
    物流信息
  • code string
    物流编号
  • discount_allocationsobject[]
    折扣明细
  • amount string
    折扣金额，精度2
    Example: 8.00
  • amount_setobject
    折扣多币种金额
  • presentment_moneyobject
    买家侧金额信息
  • amount string
    金额，精度2
    Example: 8.00
  • currency_code string
    币种
    Example: USD
  • shop_moneyobject
    店铺侧金额信息
  • amount string
    金额，精度2
    Example: 8.00
  • currency_code string
    币种
    Example: USD
  • discount_application_index integer
    折扣索引信息：标明在折扣明细中的位置
    Example: 1
  • discounted_price string
    折扣金额，精度2
  • discounted_price_setobject
    折扣多币种金额
  • presentment_moneyobject
    买家侧金额信息
  • amount string
    金额，精度2
    Example: 8.00
  • currency_code string
    币种
    Example: USD
  • shop_moneyobject
    店铺侧金额信息
  • amount string
    金额，精度2
    Example: 8.00
  • currency_code string
    币种
    Example: USD
  • phone string
    电话
  • price string
    物流运费,精度2
  • price_setobject
    物流运费多资源信息
  • presentment_moneyobject
    买家侧金额信息
  • amount string
    金额，精度2
    Example: 8.00
  • currency_code string
    币种
    Example: USD
  • shop_moneyobject
    店铺侧金额信息
  • amount string
    金额，精度2
    Example: 8.00
  • currency_code string
    币种
    Example: USD
  • requested_fulfillment_service_id string
    运输服务代号
    Example: LX88888
  • shipping_price string
    原运费金额值（非折扣后金额）
    Example: 8.00
  • source string
    运费来源
  • tax_linesobject[]
    物流征税列表
  • price string
    税费
  • price_setobject
    税费多币种信息
  • presentment_moneyobject
    买家侧金额信息
  • amount string
    金额
  • currency_code string
    币种
  • shop_moneyobject
    卖家侧金额信息
  • amount string
    金额，精度2
  • currency_code string
    币种
  • rate double
    税率
  • title string
    税费名称
  • title string
    物流名称
  • store_id string
    店铺id
  • subtotal_price string
    商品折后价总和, 商品总价 - 营销优惠 - 人工折扣
  • subtotal_price_setobject
    商品折后价总和多币种信息
  • presentment_moneyobject
    买家侧金额信息
  • amount string
    金额，精度2
  • currency_code string
    币种
  • shop_moneyobject
    卖家侧金额信息
  • amount string
    金额，精度2
  • currency_code string
    币种
  • tags string
    订单标签，无
  • tax_linesobject[]
    税费信息
  • price string
    税费名称
  • price_setobject
    税费多币种信息
  • presentment_moneyobject
    买家侧金额信息
  • amount string
    金额，精度2
  • currency_code string
    币种
  • shop_moneyobject
    卖家侧金额信息
  • amount string
    金额，精度2
  • currency_code string
    币种
  • rate double
    税率
  • title string
    税费名称
  • tax_number string
    税号
  • tax_type string
    税号类型
  • taxes_included boolean
    总计额是否包含税额
  • total_discounts string
    折扣总额，营销优惠+人工折扣
  • total_discounts_setobject
    折扣总额多币种信息
  • presentment_moneyobject
    买家侧金额信息
  • amount string
    金额，精度2
  • currency_code string
    币种
  • shop_moneyobject
    卖家侧金额信息
  • amount string
    金额，精度2
  • currency_code string
    币种
  • total_line_items_price string
    商品原价总和，精度2
  • total_line_items_price_setobject
    商品原价总和，多币种信息
  • presentment_moneyobject
    卖家侧金额信息
  • amount string
    金额，精度2
  • currency_code string
    币种
  • shop_moneyobject
    卖家侧金额信息
  • amount string
    金额，精度2
  • currency_code string
    币种
  • total_outstanding string
    未付款金额总和，精度2
  • total_shipping_price_setobject
    订单运费总和，多币种信息
  • presentment_moneyobject
    买家侧金额信息
  • amount string
    金额，精度2
  • currency_code string
    币种
  • shop_moneyobject
    卖家侧金额信息
  • amount string
    金额，精度2
  • currency_code string
    币种
  • total_tax string
    税费总和，精度2, 商品税 + 运费税
  • total_tax_setobject
    税费总和，多币种信息
  • presentment_moneyobject
    买家侧金额信息
  • amount string
    金额，精度2
  • currency_code string
    币种
  • shop_moneyobject
    卖家侧金额信息
  • amount string
    金额，精度2
  • currency_code string
    币种
  • total_tip_received string
    小费，精度2
  • total_weight double
    商品总重量（g）
  • updated_at string
    订单更新时间，（格式见IOS8601）
  • user_id string
    买家id
API Explorer
https://openapiceshidianpu.myshopline.com/admin/openapi/v20220901

ParamOptions

— path required
— header required

Body

required
{
  "order": {
    "id": "",
    "note_attributes": [
      {
        "name": "",
        "value": ""
      }
    ],
    "tags": "xternal, Inbound, Outbound"
  }
}

Language

curl --request PUT \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20220901/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'
这篇文章对你有帮助吗？
SHOPLINE
SHOPLINE
SHOPLINE Enterprise
条款协议
隐私
条款
开发者协议
LinkedInEmail
LinkedInEmail
© Copyright 2013-2025 SHOPLINE Limited.

Error loading component.

Error loading component.