编辑草稿单

需要 write_draft_orders 权限点。

更多权限点使用信息,请参考:

[]

访问权限

PUT https://{handle}.myshopline.com/admin/openapi/v20250601/orders/draft_orders.json

[]

handle ：店铺的唯一标识符，值为店铺域名的前缀。例如，域名为 open001.myshopline.com 的店铺，其 handle 是 open001 。

[]

对一个草稿单的内容进行编辑，可以编辑商品、收货地址等信息

请求头

Content-Type required
[]
字段值固定为application/json; charset=utf-8
Authorization string required
[]
资源的访问令牌。请参考应用授权获取访问令牌，然后将获取到的访问令牌以 Bearer 格式传入
Example:
[]
Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw

请求体

draft_orderobject
[]
草稿单对象
billing_addressobject
[]
支付账单地址
address1 string
[]
详细地址信息1，用作补充信息（最大255个字符）
[]
Example: 8899 Garfield Street
address2 string
[]
详细地址信息2，用作补充信息（最大255个字符）
[]
Example: Apartment 5
area string
[]
行政区名称（最大64个字符）
[]
Example: area name
area_code string
[]
行政区编码，自定义编号
[]
Example: 4200006
city string
[]
城市名称（最大64个字符）
[]
Example: city
city_code string
[]
城市编码，自定义编号
[]
Example: city_code
company string
[]
公司名称
[]
Example: SHOPLINE
country string
[]
国家或是地区名称（最大64个字符）
[]
Example: 美国
country_code string
[]
国家或是地区编码，两位的编码缩写（ISO-3166-1）
[]
Example: US
email string
[]
用户邮箱
[]
Example: test@shoplineapp.com
first_name string
[]
用户名（最大64个字符）
[]
Example: Tom
last_name string
[]
用户姓（最大64个字符）
[]
Example: Washington
phone string
[]
联系电话（最大32个字符）
[]
Example: 13100000000
province string
[]
州或是省编码，自定义编号（最大64个字符）
[]
Example: 加利福尼亚州
province_code string
[]
支付账单收件人州或是省编码，自定义编号或两位的编码缩写（ISO-3166-2）
[]
Example: 4200006
same_as_receiver boolean
[]
是否与收货信息相同（相同下面参数可以不传）
[]
Example: true
zip string
[]
收货地址邮政编号
[]
Example: 92503
calc_sku_stock_mode string required
[]
计算库存模式：not_limit，无限库存；real，真实库存；reserve_real：预留库存+真实库存
[]
Example: not_limit
customerobject
[]
买家信息
area_code string
[]
联系方式区号
[]
Example: 123123
email string
[]
用户邮箱
[]
Example: crasdas@gmail.com
first_name string
[]
用户的名
[]
Example: Xiaoliu
id string required
[]
用户id
[]
Example: 23131
last_name string
[]
用户的姓
[]
Example: Wang
phone string
[]
用户手机号
[]
Example: 18888888888
discount_amount_ext string
[]
订单优惠金额，精度2的double类型的字符串，eg："12.41"
[]
Example: 2.00
discount_amount_ext_name string
[]
订单优惠名称（最大64个字符）
[]
Example: 满减
discountable boolean
[]
是否叠加营销优惠
[]
Example: true
id string required
[]
草稿单号
[]
Example: 2505659131831930856670
language_infoobject
[]
语言信息
customer_language string
[]
买家侧下单语种（优先使用此语种）
[]
Example: en
merchant_language string
[]
卖家侧下单语种（优先使用买家侧语种）
[]
Example: en
line_itemsobject[] required
[]
商品信息列表
applied_discountobject
[]
商品折扣信息
description string
[]
折扣描述
[]
Example: Discount description
title string
[]
折扣名称
[]
Example: Discount name
value long
[]
折扣数额，折扣值，当折扣类型为DISCOUNT_AMOUNT_PERCENTAGE时，此值最大默认100，最小为0
[]
Example: 100
value_type string
[]
折扣类型：fixed_amount（固定金额）、percentage（百分比）
[]
Example: 50
discountable boolean
[]
是否使用在线商店营销活动 true：使用 false：不使用
[]
Example: true
gift_card boolean
[]
是否为礼品卡商品
[]
Example: true
id string
[]
订单商品行id, 唯一确认一个商品行
[]
Example: 21312
price string
[]
商品售价，精度2的double类型的字符串，eg："12.41"
[]
Example: 12.45
product_id string required
[]
商品id
[]
Example: 21312321
product_source string required
[]
商品来源 main_site主站商品、customize自定义商品
[]
Example: main_site
propertiesobject[]
[]
商品的自定义信息
name string
[]
自定义属性名称
[]
Example: phone
show boolean
[]
是否要在前端展示
type string
[]
属性类型，支持： text-字符，展示格式为 name: value; picture-图片，展示类型为 name: 通过urls获取渲染出缩略图,缩略图点击弹窗展示，并支持下载 link-超链，展示类型为 name: value，支持点击跳转到urls第一个
[]
Example: name: value
urls array
[]
url列表
[]
Example: []
value string
[]
自定义属性值
[]
Example: {}
quantity integer required
[]
商品数量
[]
Example: 1
requires_shipping boolean
[]
是否需要发货
[]
Example: true
title string
[]
商品名称
[]
Example: Product name
variant_id string required
[]
商品skuId
[]
Example: 321312312312312312
market_region_country_code string
[]
市场国家
[]
Example: 免税=true
note string
[]
草稿单备注
[]
Example: 客户想要尽快发货
note_attributesobject[]
[]
附加信息
name string
[]
名称
[]
Example: name
value string
[]
值
[]
Example: value
outer_id string
[]
操作唯一标识，同一个id只能执行一次操作
[]
Example: outer_id
payment_termsobject
[]
付款信息
pay_channel_id string required
[]
支付方式id
[]
Example: 123123
pay_status string
[]
付款状态
[]
Example: unpaid
payment_channel_name string
[]
支付渠道名称
[]
Example: Payment channel name
shipping_addressobject
[]
收货人地址信息
address1 string
[]
详细地址信息1，用作补充信息（最大255个字符）
[]
Example: 8899 Garfield Street
address2 string
[]
详细地址信息2，用作补充信息（最大255个字符）
[]
Example: Apartment 5
city string
[]
城市名称（最大64个字符）
[]
Example: Riverside
city_code string
[]
城市编码，自定义编号
[]
Example: city_code
company string
[]
公司名称
[]
Example: SHOPLINE
country string
[]
国家或是地区名称（最大64个字符）
[]
Example: 美国
country_code string
[]
国家或是地区编码，两位的编码缩写（ISO-3166-1）
[]
Example: US
district string
[]
行政区名称（最大64个字符）
[]
Example: xxx
district_code string
[]
行政区编码，自定义编号
[]
Example: 4200006
first_name string
[]
名（最大64个字符）
[]
Example: Tom
last_name string
[]
姓（最大64个字符）
[]
Example: Washington
phone string
[]
联系电话（最大32个字符）
[]
Example: 13100000000
province string
[]
州或是省名称（最大64个字符）
[]
Example: 加利福尼亚州
province_code string
[]
州或是省编码，自定义编号或两位的编码缩写（ISO-3166-2）
[]
Example: 4200006
zip string
[]
收货地址邮政编号
[]
Example: 92503
shipping_linesobject
[]
物流信息
delivery_id string
[]
送货方式ID、运费模板ID
[]
Example: 运费模板
price string
[]
自定义运费，精度2的double类型的字符串，eg："12.41"
[]
Example: 12.45
shipping_type string required
[]
物流类型 system-系统物流；custom-自定义物流。当物流为系统物流时只需要传delivery_id，当物流类型伟自定义物流时传title和price字段
[]
Example: 自定义物流
title string
[]
自定义配送名称
[]
Example: 标题
stock_reserved boolean required
[]
订单维度库存预留标识：true、flase
[]
Example: true
stock_reserved_time long
[]
订单维度库存预预留时间
[]
Example: 1669280400000
tags array
[]
草稿单标签,多个标签间用逗号分隔，覆盖现有标签
[]
Example: shine,bili
tax_exempt string
[]
是否免税
[]
Example: false

响应

[]

更多状态码信息请参考 HTTP 状态码

响应头

traceId
[]
traceId

响应体

draft_orderobject
[]
草稿单
billing_addressobject
[]
支付账单地址
address1 string
[]
详细地址信息1，用作补充信息
[]
Example: 8899 Garfield Street
address2 string
[]
详细地址信息2，用作补充信息
[]
Example: Apartment 5
area string
[]
行政区名称
[]
Example: 东城区
area_code string
[]
行政区编码，自定义编号
[]
Example: 4200006
city string
[]
城市名称
[]
Example: Riverside
city_code string
[]
城市编码，自定义编号
[]
Example: 4200006
company string
[]
公司名称
[]
Example: SHOPLINE
country string
[]
国家或是地区名称
[]
Example: 美国
country_code string
[]
国家或是地区编码，两位的编码缩写（ISO-3166-1）
[]
Example: US
email string
[]
用户邮箱
[]
Example: test@shoplineapp.com
first_name string
[]
用户名
[]
Example: Tom
last_name string
[]
用户姓
[]
Example: Washington
phone string
[]
联系电话
[]
Example: 13100000000
province string
[]
州或是省名称
[]
Example: 加利福尼亚州
province_code string
[]
州或是省编码，自定义编号或两位的编码缩写（ISO-3166-2）
[]
Example: 4200006
same_as_receiver boolean
[]
是否与收货信息相同：true、false
[]
Example: true
zip string
[]
收货地址邮政编号
[]
Example: 92503
create_time long
[]
创建时间，时间戳格式
[]
Example: 1667638652832
currency string
[]
店铺币种
[]
Example: USD
customerobject
[]
买家信息
area_code string
[]
联系方式区号
[]
Example: 86
email string
[]
用户邮箱
[]
Example: xxxxx@gmail.com
first_name string
[]
用户的名
[]
Example: Xiaoliu
id string
[]
用户id
[]
Example: 2200000611
last_name string
[]
用户的姓
[]
Example: Wang
phone string
[]
用户手机号
[]
Example: 188888888888
discount_amount_ext string
[]
订单优惠金额，精度2的double类型的字符串，eg："12.41"
[]
Example: 3.15
discount_amount_ext_name string
[]
订单优惠名称
[]
Example: 订单折扣
discount_amount_ext_setobject
[]
订单优惠金额（多币种）
presentment_moneyobject
[]
买家侧金额
amount string
[]
金额
[]
Example: 2.00
currency_code string
[]
币种
[]
Example: USD
shop_moneyobject
[]
卖家侧金额
amount string
[]
金额
[]
Example: 2.00
currency_code string
[]
币种
[]
Example: USD
id string
[]
草稿单号
[]
Example: 2505659131831930856670
invoice_url string
[]
invoice链接
[]
Example: https://xxx.myshopline.com/invoices/xxxx?secret=xxxx
line_itemsobject[]
[]
商品信息列表
applied_discountobject
[]
商品自定义折扣信息
amount string
[]
折扣金额，精度2的double类型的字符串，eg："12.41"
[]
Example: 1.00
amount_setobject
[]
折扣金额(多币种)
presentment_moneyobject
[]
买家侧金额
amount string
[]
金额
[]
Example: 2.00
currency_code string
[]
币种
[]
Example: USD
shop_moneyobject
[]
卖家侧金额
amount string
[]
金额
[]
Example: 2.00
currency_code string
[]
币种
[]
Example: USD
before_amount string
[]
商品售价，精度2的double类型的字符串，eg："12.41"
[]
Example: 3.00
before_amount_setobject
[]
商品售价(多币种)
presentment_moneyobject
[]
买家侧金额
amount string
[]
金额
[]
Example: 2.00
currency_code string
[]
币种
[]
Example: USD
shop_moneyobject
[]
卖家侧金额
amount string
[]
金额
[]
Example: 2.00
currency_code string
[]
币种
[]
Example: USD
description string
[]
折扣描述
[]
Example: 满两件减5元
title string
[]
折扣名称
[]
Example: 满减
value long
[]
折扣数额，折扣值，当折扣类型为DISCOUNT_AMOUNT_PERCENTAGE时，此值最大默认100，最小为0
[]
Example: 1
value_type string
[]
折扣类型：fixed_amount（固定金额）、percentage（百分比）
[]
Example: fixed_amount
gift_card boolean
[]
是否为礼品卡商品：true、false
[]
Example: true
id string
[]
商品行id, 唯一确认一个商品行
[]
Example: 1231244545
image_url string
[]
商品图片
[]
Example: http://www.abc.com/123
price string
[]
商品参加自定义折扣后的金额
[]
Example: 2.00
price_setobject
[]
商品参加自定义折扣后的金额(多币种)
presentment_moneyobject
[]
买家侧金额
amount string
[]
金额
[]
Example: 2.00
currency_code string
[]
币种
[]
Example: USD
shop_moneyobject
[]
卖家侧金额
amount string
[]
金额
[]
Example: 2.00
currency_code string
[]
币种
[]
Example: USD
product_id string
[]
商品spu序列号
[]
Example: 16056577393789045351043258
product_source string
[]
商品来源 main_site主站商品、customize自定义商品
[]
Example: main_site
propertiesobject[]
[]
商品定制信息
name string
[]
属性名称
[]
Example: name
show boolean
[]
是否要在前端展示
[]
Example: true
type string
[]
属性类型, text-字符，展示格式为 name: value; picture-图片，展示类型为 name: 通过urls获取渲染出缩略图；link-超链，展示类型为 name: value，支持点击链接跳转到urls第一个
[]
Example: text-one
urls array
[]
url列表
[]
Example: https://www.baidu.com/link?url=k3EHU-qjI0OSL0cgUdsCD-vLjHJjG1wD33rgoXZsUOtmx_HaAGY9fak439hiCSZcowQdM
value string
[]
自定义属性值
[]
Example: value
quantity integer
[]
商品数量
[]
Example: 1
requires_shipping boolean
[]
是否需要实物运输发货：true、false
[]
Example: true
tax_linesobject[]
[]
税费信息
name string
[]
税费标题
[]
Example: tax
price string
[]
价格
[]
Example: 8.00
price_setobject
[]
价格信息
presentment_moneyobject
[]
买家侧金额
amount string
[]
金额
[]
Example: 8.00
currency_code string
[]
币种
[]
Example: USD
shop_moneyobject
[]
卖家侧金额
amount string
[]
金额
[]
Example: 8.00
currency_code string
[]
币种
[]
Example: USD
rate double
[]
税率
[]
Example: 1
type string
[]
税费类型
[]
Example: shipping_tax
title string
[]
商品标题
[]
Example: 自定义这口
variant_id string
[]
商品sku序列号
[]
Example: 18056577393793239655103258
variant_title string
[]
商sku标题
[]
Example: RED / L
logistics_price string
[]
运费总金额
[]
Example: 2.00
logistics_price_setobject
[]
运费总金额(多币种)
presentment_moneyobject
[]
买家侧金额
amount string
[]
金额
[]
Example: 2.00
currency_code string
[]
币种
[]
Example: USD
shop_moneyobject
[]
卖家侧金额
amount string
[]
金额
[]
Example: 2.00
currency_code string
[]
币种
[]
Example: USD
logistics_tax string
[]
运费总税费
[]
Example: 2.00
logistics_tax_setobject
[]
运费总税费(多币种)
presentment_moneyobject
[]
买家侧金额
amount string
[]
金额
[]
Example: 2.00
currency_code string
[]
币种
[]
Example: USD
shop_moneyobject
[]
卖家侧金额
amount string
[]
金额
[]
Example: 2.00
currency_code string
[]
币种
[]
Example: USD
market_name string
[]
市场名称
[]
Example: 美国市场
market_region_country_code string
[]
市场国家
[]
Example: US
note string
[]
草稿单备注
[]
Example: 客户想要尽快发货
note_attributesobject[]
[]
附加信息
name string
[]
名称
[]
Example: xxx
value string
[]
值
[]
Example: xxx
payment_termsobject
[]
支付条款和付款信息
created_at string
[]
创建时间
[]
Example: 2024-06-05 08:00:00
due_in_days integer
[]
当条款类型为NET时提供，多少天后未付款则到期
[]
Example: 2
id string
[]
唯一识别该支付条款的id
[]
Example: 6497210673894431747
overdue boolean
[]
支付条款是否超时：true/false
[]
Example: true
pay_channel_id string
[]
支付渠道ID
[]
Example: custom
pay_status string
[]
支付单状态：未支付unpaid、已支付paid 草稿单生成订单后，该状态不会同步订单的支付状态
[]
Example: unpaid
payment_channel_name string
[]
支付渠道名称
[]
Example: 自定义付款
payment_schedulesobject[]
[]
与付款条件相关联的一组时间表
completed_at string
[]
付款完成时间
[]
Example: 2024-06-05 08:00:00
due_at string
[]
预计付款时间
[]
Example: 2024-06-05 08:00:00
issued_at string
[]
付款条件启动的时间。当为FIXED时，为保存时间（若草稿单成单，则订单继承草稿单时间）；当为FULFILLMENT/RECEIPT时，为条件生效时间；当为NET时，则为保存时间（若草稿单成单，则订单继承草稿单时间）
[]
Example: 2024-06-05 08:00:00
payment_terms_name string
[]
用于创建付款条件的付款条件模板的名称
[]
Example: Due on receipt
payment_terms_type string
[]
用于创建付款条件的付款条件模板类型： FIXED：商家指定日期 FULFILLMENT：完成发货日期 NET：固定条件日期 RECEIPT：发送账单日期 UNKNOWN：未知类型
[]
Example: RECEIPT
updated_at string
[]
更新时间
[]
Example: 2024-06-05 08:00:00
po_number string
[]
B2B场景在订单上记录的采购订单号
presentment_currency_code string
[]
市场币种
[]
Example: USD
product_tax string
[]
商品总税费
[]
Example: 2.00
product_tax_setobject
[]
商品总税费(多币种)
presentment_moneyobject
[]
买家侧金额
amount string
[]
金额
[]
Example: 2.00
currency_code string
[]
币种
[]
Example: USD
shop_moneyobject
[]
卖家侧金额
amount string
[]
金额
[]
Example: 2.00
currency_code string
[]
币种
[]
Example: USD
shipping_addressobject
[]
收货地址
address1 string
[]
详细地址信息1，用作补充信息
[]
Example: 8899 Garfield Street
address2 string
[]
详细地址信息2，用作补充信息
[]
Example: Apartment 5
city string
[]
城市名称
[]
Example: Riverside
city_code string
[]
城市编码，自定义编号
[]
Example: city_code
company string
[]
公司名称
[]
Example: SHOPLINE
country string
[]
国家或是地区名称
[]
Example: 美国
country_code string
[]
国家或是地区编码，两位的编码缩写（ISO-3166-1）
[]
Example: US
district string
[]
行政区名称
[]
Example: 天河区
district_code string
[]
行政区编码，自定义编号
[]
Example: 100000
first_name string
[]
名
[]
Example: Tom
last_name string
[]
姓
[]
Example: Washington
phone string
[]
联系电话
[]
Example: 13100000000
province string
[]
州或是省名称
[]
Example: 加利福尼亚州
province_code string
[]
州或是省编码，自定义编号或两位的编码缩写（ISO-3166-2）
[]
Example: 4200006
zip string
[]
收货地址邮政编号
[]
Example: 92503
shipping_linesobject
[]
物流信息
delivery_id string
[]
送货方式ID、运费模板ID
[]
Example: 234541123123
price long
[]
物流运费，精度2的double类型的字符串
price_setobject
[]
物流运费(多币种)
presentment_moneyobject
[]
买家侧金额
amount string
[]
金额
[]
Example: 2.00
currency_code string
[]
币种
[]
Example: USD
shop_moneyobject
[]
卖家侧金额
amount string
[]
金额
[]
Example: 2.00
currency_code string
[]
币种
[]
Example: USD
shipping_type string
[]
物流类型 system-系统物流；custom-自定义物流
[]
Example: system
title string
[]
物流名称
[]
Example: CustomProducts F
status integer
[]
草稿单状态：open 、 complete
stock_reserved boolean
[]
订单维度库存预留标识：true、flase
[]
Example: true
stock_reserved_time long
[]
订单维度库存预预留时间
[]
Example: 1669280400000
store_id string
[]
店铺id
[]
Example: 123414345235
tags array
[]
草稿单标签,多个标签间用逗号分隔，店铺维度最大支持99个标签
[]
Example: shine,bili
tax_linesobject[]
[]
税费信息
name string
[]
名字
[]
Example: Tax
price string
[]
金额
[]
Example: 8.00
price_setobject
[]
价格信息
presentment_moneyobject
[]
买家侧
amount string
[]
金额
[]
Example: 8.00
currency_code string
[]
币种
[]
Example: USD
shop_moneyobject
[]
卖家侧
amount string
[]
金额
[]
Example: 8.00
currency_code string
[]
币种
[]
Example: USD
rate double
[]
税费
[]
Example: 1
type string
[]
类型
[]
Example: shipping_tax
total_duties_setobject
[]
总关税
presentment_moneyobject
[]
买家侧金额信息
amount string
[]
金额
[]
Example: 8.00
currency_code string
[]
币种
[]
Example: USD
shop_moneyobject
[]
卖家侧金额信息
amount string
[]
金额
[]
Example: 8.00
currency_code string
[]
币种
[]
Example: USD
total_line_items_price string
[]
当前草稿单商品总金额
[]
Example: 2.00
total_line_items_price_setobject
[]
商品总金额（多币种）
presentment_moneyobject
[]
买家侧金额
amount string
[]
金额
[]
Example: 2.00
currency_code string
[]
币种
[]
Example: USD
shop_moneyobject
[]
卖家侧金额
amount string
[]
金额
[]
Example: 2.00
currency_code string
[]
币种
[]
Example: USD
total_price string
[]
当前草稿单总金额，商品售价-折扣+税费+运费
[]
Example: 2.00
total_price_setobject
[]
总金额（多币种）
presentment_moneyobject
[]
买家侧金额
amount string
[]
金额
[]
Example: 2.00
currency_code string
[]
币种
[]
Example: USD
shop_moneyobject
[]
卖家侧金额
amount string
[]
金额
[]
Example: 2.00
currency_code string
[]
币种
[]
Example: USD
update_time long
[]
更新时间，时间戳格式
[]
Example: 1667638652832

API Explorer

调试台

Base URL

https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601

ParamOptions

Authorization — header required

Body

Body required

{
  "draft_order": {
    "billing_address": {
      "address1": "8899 Garfield Street",
      "address2": "Apartment 5",
      "area": "area name",
      "area_code": "4200006",
      "city": "city",
      "city_code": "city_code",
      "company": "SHOPLINE",
      "country": "美国",
      "country_code": "US",
      "email": "test@shoplineapp.com",
      "first_name": "Tom",
      "last_name": "Washington",
      "phone": "13100000000",
      "province": "加利福尼亚州",
      "province_code": "4200006",
      "same_as_receiver": true,
      "zip": "92503"
    },
    "calc_sku_stock_mode": "not_limit",
    "customer": {
      "area_code": "123123",
      "email": "crasdas@gmail.com",
      "first_name": "Xiaoliu",
      "id": "23131",
      "last_name": "Wang",
      "phone": "18888888888"
    },
    "discount_amount_ext": "2.00",
    "discount_amount_ext_name": "满减",
    "discountable": true,
    "id": "2505659131831930856670",
    "language_info": {
      "customer_language": "en",
      "merchant_language": "en"
    },
    "line_items": [
      {
        "applied_discount": {
          "description": "Discount description",
          "title": "Discount name",
          "value": 100,
          "value_type": "50"
        },
        "discountable": true,
        "gift_card": true,
        "id": "21312",
        "price": "12.45",
        "product_id": "21312321",
        "product_source": "main_site",
        "properties": [
          {
            "name": "phone",
            "show": false,
            "type": "name: value",
            "urls": [
              "[]"
            ],
            "value": "{}"
          }
        ],
        "quantity": 1,
        "requires_shipping": true,
        "title": "Product name",
        "variant_id": "321312312312312312"
      }
    ],
    "market_region_country_code": "免税=true",
    "note": "客户想要尽快发货",
    "note_attributes": [
      {
        "name": "name",
        "value": "value"
      }
    ],
    "outer_id": "outer_id",
    "payment_terms": {
      "pay_channel_id": "123123",
      "pay_status": "unpaid",
      "payment_channel_name": "Payment channel name"
    },
    "shipping_address": {
      "address1": "8899 Garfield Street",
      "address2": "Apartment 5",
      "city": "Riverside",
      "city_code": "city_code",
      "company": "SHOPLINE",
      "country": "美国",
      "country_code": "US",
      "district": "xxx",
      "district_code": "4200006",
      "first_name": "Tom",
      "last_name": "Washington",
      "phone": "13100000000",
      "province": "加利福尼亚州",
      "province_code": "4200006",
      "zip": "92503"
    },
    "shipping_lines": {
      "delivery_id": "运费模板",
      "price": "12.45",
      "shipping_type": "自定义物流",
      "title": "标题"
    },
    "stock_reserved": true,
    "stock_reserved_time": 1669280400000,
    "tags": [
      "shine,bili"
    ],
    "tax_exempt": "false"
  }
}

Language

curl --request PUT \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601/orders/draft_orders.json \
     --header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --header 'accept: application/json' \
     --data '
{
  "draft_order": {
    "billing_address": {
      "address1": "8899 Garfield Street",
      "address2": "Apartment 5",
      "area": "area name",
      "area_code": "4200006",
      "city": "city",
      "city_code": "city_code",
      "company": "SHOPLINE",
      "country": "美国",
      "country_code": "US",
      "email": "test@shoplineapp.com",
      "first_name": "Tom",
      "last_name": "Washington",
      "phone": "13100000000",
      "province": "加利福尼亚州",
      "province_code": "4200006",
      "same_as_receiver": true,
      "zip": "92503"
    },
    "calc_sku_stock_mode": "not_limit",
    "customer": {
      "area_code": "123123",
      "email": "crasdas@gmail.com",
      "first_name": "Xiaoliu",
      "id": "23131",
      "last_name": "Wang",
      "phone": "18888888888"
    },
    "discount_amount_ext": "2.00",
    "discount_amount_ext_name": "满减",
    "discountable": true,
    "id": "2505659131831930856670",
    "language_info": {
      "customer_language": "en",
      "merchant_language": "en"
    },
    "line_items": [
      {
        "applied_discount": {
          "description": "Discount description",
          "title": "Discount name",
          "value": 100,
          "value_type": "50"
        },
        "discountable": true,
        "gift_card": true,
        "id": "21312",
        "price": "12.45",
        "product_id": "21312321",
        "product_source": "main_site",
        "properties": [
          {
            "name": "phone",
            "show": false,
            "type": "name: value",
            "urls": [
              "[]"
            ],
            "value": "{}"
          }
        ],
        "quantity": 1,
        "requires_shipping": true,
        "title": "Product name",
        "variant_id": "321312312312312312"
      }
    ],
    "market_region_country_code": "免税=true",
    "note": "客户想要尽快发货",
    "note_attributes": [
      {
        "name": "name",
        "value": "value"
      }
    ],
    "outer_id": "outer_id",
    "payment_terms": {
      "pay_channel_id": "123123",
      "pay_status": "unpaid",
      "payment_channel_name": "Payment channel name"
    },
    "shipping_address": {
      "address1": "8899 Garfield Street",
      "address2": "Apartment 5",
      "city": "Riverside",
      "city_code": "city_code",
      "company": "SHOPLINE",
      "country": "美国",
      "country_code": "US",
      "district": "xxx",
      "district_code": "4200006",
      "first_name": "Tom",
      "last_name": "Washington",
      "phone": "13100000000",
      "province": "加利福尼亚州",
      "province_code": "4200006",
      "zip": "92503"
    },
    "shipping_lines": {
      "delivery_id": "运费模板",
      "price": "12.45",
      "shipping_type": "自定义物流",
      "title": "标题"
    },
    "stock_reserved": true,
    "stock_reserved_time": 1669280400000,
    "tags": [
      "shine,bili"
    ],
    "tax_exempt": "false"
  }
}
'

这篇文章对你有帮助吗？

SHOPLINE

条款协议

Error loading component.