创建草稿单

需要 write_draft_orders 权限点。

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

[]

访问权限

POST 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
[]
支付账单收件人详细地址（最大255个字符）
[]
Example: 8899 Garfield Street
address2 string
[]
支付账单收件人详细地址附加
[]
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
[]
支付账单收件人国家编码
[]
Example: US
email string
[]
支付账单收件人邮箱（最大64个字符）
[]
Example: test@shoplineapp.com
first_name string
[]
支付账单收件人名（最大64个字符）
[]
Example: Tom
last_name string
[]
支付账单收件人姓（最大64个字符）
[]
Example: Washington
phone string
[]
支付账单收件人手机（最大32个字符）
[]
Example: 13100000000
postcode string
[]
支付账单收件人邮编
[]
Example: 4200006
province string
[]
支付账单收件人省（最大64个字符）
[]
Example: 加利福尼亚州
province_code string
[]
支付账单收件人州或是省编码，自定义编号或两位的编码缩写（ISO-3166-2）
[]
Example: 4200006
same_as_receiver boolean
[]
是否与收货信息相同（相同下面参数可以不传）
[]
Example: true
calc_sku_stock_mode string required
[]
计算库存模式：not_limit，无限库存；real，真实库存；reserve_real：预留库存+真实库存
[]
Example: not_limit
customerobject
[]
买家信息
area_code string
[]
手机号区码
[]
Example: 92503
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
language_infoobject required
[]
语言信息
customer_language string
[]
买家侧下单语种（优先使用此语种）
[]
Example: en
merchant_language string
[]
卖家侧下单语种（优先使用买家侧语种）
[]
Example: en
line_itemsobject[] required
[]
商品信息列表
applied_discountobject
[]
商品折扣信息
description string
[]
折扣描述
[]
Example: 折扣描述
title string
[]
折扣名称
[]
Example: 折扣名称
value long required
[]
折扣数额，折扣值，当折扣类型为DISCOUNT_AMOUNT_PERCENTAGE时，此值最大默认100，最小为0
[]
Example: 100
value_type string required
[]
折扣类型：fixed_amount（固定金额）、percentage（百分比）
[]
Example: 50
discountable boolean
[]
是否使用在线商店营销活动 true：使用 false：不使用
gift_card boolean
[]
是否为礼品卡商品：true、false
[]
Example: true
price string
[]
商品售价，精度2的double类型的字符串，eg："12.41"
[]
Example: 12.45
product_id string required
[]
商品spu序列号
[]
Example: 16056577393789045351043258
product_source string required
[]
商品来源 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://image.baidu.com/search/detail?ct=503316480&z=0&ipn=d&word=%E5%9B%BE%E7%89%87&hs=0&pn=0&spn=0
value string
[]
自定义属性值
[]
Example: example
quantity integer required
[]
商品数量
[]
Example: 1
requires_shipping boolean
[]
是否需要发货
[]
Example: true
taxable boolean
[]
是否需要收税
[]
Example: true
title string
[]
商品名称
[]
Example: 商品名称
variant_id string required
[]
商品sku序列号
[]
Example: 18056577393793239655103258
market_region_country_code string
[]
市场国家
[]
Example: CN
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: 支付方式
pay_status string
[]
付款状态（paid、unpaid）默认unpaid
[]
Example: 支付状态
payment_channel_name string
[]
支付渠道名称
[]
Example: 渠道名称
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: 4200006
company string
[]
公司名称（最大255个字符）
[]
Example: SHOPLINE
country string
[]
收货人国家名称（最大64个字符）
[]
Example: 美国
country_code string
[]
国家或地区，请参考国家代码
[]
Example: US
district string
[]
收货人区县名称（最大64个字符）
[]
Example: 区
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
[]
邮编（最大64个字符）
[]
Example: 92503
shipping_linesobject
[]
物流信息
delivery_id string
[]
送货方式ID、运费模板ID
[]
Example: 运费模板id
price string
[]
自定义运费，精度2的double类型的字符串，eg："12.41"
[]
Example: 12.41
shipping_type string required
[]
物流类型 system-系统物流；custom-自定义物流。当物流为系统物流时只需要传delivery_id，当物流类型伟自定义物流时传title和price字段
[]
Example: system
title string
[]
配送名称
[]
Example: 标题
stock_reserved boolean required
[]
订单维度库存预留标识：true、false
[]
Example: true
stock_reserved_time long
[]
订单维度库存预预留时间
[]
Example: 1669280400000
tags array
[]
标签列表
[]
Example: 标签列表
tax_exempt boolean
[]
是否免税

响应

[]

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

响应头

traceId
[]
traceId

响应体

draft_orderobject
[]
草稿单对象
billing_addressobject
[]
账单地址信息
address1 string
[]
详细地址信息1，用作补充信息
[]
Example: 8899 Garfield Street
address2 string
[]
详细地址信息2，用作补充信息
[]
Example: Apartment 5
area string
[]
行政区名称
[]
Example: 4200006
area_code string
[]
行政区编码，自定义编号
[]
Example: US
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
[]
是否和收货地址相同
[]
Example: true
zip string
[]
收货地址邮政编号
[]
Example: 92503
create_at long
[]
创建时间，时间戳格式
[]
Example: 1667638652832
currency string
[]
店铺币种
[]
Example: USD
customerobject
[]
买家信息
area_code string
[]
联系方式区号
[]
Example: 86
email string
[]
用户邮箱
[]
Example: 123@gmail.com
first_name string
[]
用户的名
[]
Example: Xiaoliu
id string
[]
用户id
[]
Example: 20384764
last_name string
[]
用户的姓
[]
Example: Wang
phone string
[]
用户手机号
[]
Example: 18688888888
discount_amount_ext string
[]
订单优惠金额，精度2的double类型的字符串，eg："12.41"
[]
Example: 12.41
discount_amount_ext_name string
[]
订单优惠名称
[]
Example: name
discount_amount_ext_setobject
[]
订单优惠金额（多币种）
presentment_moneyobject
[]
买家侧金额
amount string
[]
金额
[]
Example: 12.41
currency_code string
[]
币种
[]
Example: USD
shop_moneyobject
[]
卖家侧金额
amount string
[]
金额
[]
Example: 12.41
currency_code string
[]
币种
[]
Example: USD
id string
[]
草稿单号
[]
Example: 2505659131831930856670
invoice_url string
[]
invoice链接
[]
Example: https://xxx.com/xxxx
line_itemsobject[]
[]
商品信息列表
applied_discountobject
[]
商品自定义折扣信息
amount string
[]
折扣金额，精度2的double类型的字符串，eg："12.41"
[]
Example: 1.00
amount_setobject
[]
折扣金额(多币种)
presentment_moneyobject
[]
买家侧金额
amount string
[]
金额
[]
Example: 12.41
currency_code string
[]
币种
[]
Example: USD
shop_moneyobject
[]
卖家侧金额
amount string
[]
金额
[]
Example: 12.41
currency_code string
[]
币种
[]
Example: USD
before_amount string
[]
商品售价，精度2的double类型的字符串，eg："12.41"
[]
Example: 3.00
before_amount_setobject
[]
商品售价(多币种)
presentment_moneyobject
[]
买家侧金额
amount string
[]
金额
[]
Example: 12.41
currency_code string
[]
币种
[]
Example: USD
shop_moneyobject
[]
卖家侧金额
amount string
[]
金额
[]
Example: 12.41
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: 68970912747823
image_url string
[]
商品图片
[]
Example: http://www.abc.com/123
name string
[]
sku标题,同title
[]
Example: example
price string
[]
商品参加自定义折扣后的金额
[]
Example: 2.00
price_setobject
[]
商品参加自定义折扣后的金额(多币种)
presentment_moneyobject
[]
买家侧金额
amount string
[]
金额
[]
Example: 12.41
currency_code string
[]
币种
[]
Example: USD
shop_moneyobject
[]
卖家侧金额
amount string
[]
金额
[]
Example: 12.41
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://image.baidu.com/search/detail?ct=503316480&z=0&ipn=d&word=%E5%9B%BE%E7%89%87&hs=0&pn=0&spn=0
value string
[]
自定义属性值
[]
Example: example
quantity integer
[]
商品数量
[]
Example: 1
requires_shipping boolean
[]
是否需要实物运输发货：true、false
[]
Example: true
sku string
[]
商品码，barCode
[]
Example: 1234567
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: title
variant_id string
[]
商品sku序列号
[]
Example: 18056577393793239655103258
variant_title string
[]
商sku标题
[]
Example: title
logistics_price string
[]
运费总金额
[]
Example: 2.00
logistics_price_setobject
[]
运费总金额(多币种)
presentment_moneyobject
[]
买家侧金额
amount string
[]
金额
[]
Example: 12.41
currency_code string
[]
币种
[]
Example: USD
shop_moneyobject
[]
卖家侧金额
amount string
[]
金额
[]
Example: 12.41
currency_code string
[]
币种
[]
Example: USD
logistics_tax string
[]
运费总税费
[]
Example: 2.00
logistics_tax_setobject
[]
运费总税费(多币种)
presentment_moneyobject
[]
买家侧金额
amount string
[]
金额
[]
Example: 12.41
currency_code string
[]
币种
[]
Example: USD
shop_moneyobject
[]
卖家侧金额
amount string
[]
金额
[]
Example: 12.41
currency_code string
[]
币种
[]
Example: USD
market_name string
[]
市场名称
[]
Example: name
market_region_country_code string
[]
市场国家
[]
Example: US
note string
[]
草稿单备注
[]
Example: 客户想要尽快发货
note_attributesobject[]
[]
附加信息
name string
[]
名称
[]
Example: name
value string
[]
值
[]
Example: value
order_id string
[]
由当前草稿单生成的订单单号
[]
Example: 21056577640603870897253153
payment_termsobject
[]
支付条款和付款信息
created_at string
[]
创建时间
[]
Example: 2024-06-05 08:00:00
due_in_days integer
[]
在选定的付款条件模板中定义的发票日期和到期日之间的天数
[]
Example: 2
id string
[]
唯一识别该支付条款的id
[]
Example: 6497210673894431747
overdue boolean
[]
支付条款是否超时：true/false
[]
Example: true
pay_channel_id string
[]
支付渠道ID
[]
Example: 124356
pay_status string
[]
支付单状态：未支付unpaid、已支付paid 草稿单生成订单后，该状态不会同步订单的支付状态
[]
Example: unpaid
payment_channel_name string
[]
支付渠道名称
[]
Example: name
payment_schedulesobject[]
[]
与付款条件相关联的一组时间表
completed_at string
[]
购买完成的日期和时间。最初返回null，并在捕获付款时更新
[]
Example: 2024-06-05 08:00:00
due_at string
[]
付款到期的日期和时间。根据issued_at和due_in_days计算，如果类型固定，则根据自定义的固定日期计算。
[]
Example: 2024-06-05 08:00:00
issued_at string
[]
付款条件启动的日期和时间
[]
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: 12.41
currency_code string
[]
币种
[]
Example: USD
shop_moneyobject
[]
卖家侧金额
amount string
[]
金额
[]
Example: 12.41
currency_code string
[]
币种
[]
Example: USD
seller_id string
[]
商户id
[]
Example: 123456
shipping_addressobject
[]
收货地址
address1 string
[]
详细地址信息1，用作补充信息
[]
Example: 8899 Garfield Street
address2 string
[]
详细地址信息2，用作补充信息
[]
Example: Apartment 5
city string
[]
城市名称
[]
Example: Riverside
city_code string
[]
城市编码，自定义编号
[]
Example: 4200006
company string
[]
公司名称
[]
Example: example
country string
[]
国家或是地区名称
[]
Example: 美国
country_code string
[]
国家或是地区编码，两位的编码缩写（ISO-3166-1）
[]
Example: US
district string
[]
行政区名称
[]
Example: Washington
district_code string
[]
行政区编码，自定义编号
[]
Example: 4200006
first_name string
[]
名
[]
Example: Tom
last_name string
[]
姓
[]
Example: Washington
name string
[]
全名
[]
Example: Tom 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: 123456
price string
[]
物流运费，精度2的double类型的字符串
[]
Example: 12.41
price_setobject
[]
物流运费(多币种)
presentment_moneyobject
[]
买家侧金额
amount string
[]
金额
[]
Example: 12.41
currency_code string
[]
币种
[]
Example: USD
shop_moneyobject
[]
卖家侧金额
amount string
[]
金额
[]
Example: 12.41
currency_code string
[]
币种
[]
Example: USD
shipping_type string
[]
物流类型 system-系统物流；custom-自定义物流
[]
Example: system
title string
[]
物流名称
[]
Example: title
status integer
[]
草稿单状态（completed、open）
stock_reserved boolean
[]
订单维度库存预留标识：true、flase
[]
Example: true
stock_reserved_time long
[]
订单维度库存预预留时间
[]
Example: 1669280400000
store_id string
[]
店铺id
[]
Example: 123456
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: 12.41
currency_code string
[]
币种
[]
Example: USD
shop_moneyobject
[]
卖家侧金额
amount string
[]
金额
[]
Example: 12.41
currency_code string
[]
币种
[]
Example: USD
total_price string
[]
当前草稿单总金额，商品售价-折扣+税费+运费
[]
Example: 2.00
total_price_setobject
[]
总金额（多币种）
presentment_moneyobject
[]
买家侧金额
amount string
[]
金额
[]
Example: 12.41
currency_code string
[]
币种
[]
Example: USD
shop_moneyobject
[]
卖家侧金额
amount string
[]
金额
[]
Example: 12.41
currency_code string
[]
币种
[]
Example: USD
update_at 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",
      "postcode": "4200006",
      "province": "加利福尼亚州",
      "province_code": "4200006",
      "same_as_receiver": true
    },
    "calc_sku_stock_mode": "not_limit",
    "customer": {
      "area_code": "92503",
      "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,
    "language_info": {
      "customer_language": "en",
      "merchant_language": "en"
    },
    "line_items": [
      {
        "applied_discount": {
          "description": "折扣描述",
          "title": "折扣名称",
          "value": 100,
          "value_type": "50"
        },
        "discountable": false,
        "gift_card": true,
        "price": "12.45",
        "product_id": "16056577393789045351043258",
        "product_source": "main_site",
        "properties": [
          {
            "name": "name",
            "show": true,
            "type": "text-one",
            "urls": [
              "https://image.baidu.com/search/detail?ct=503316480&z=0&ipn=d&word=%E5%9B%BE%E7%89%87&hs=0&pn=0&spn=0"
            ],
            "value": "example"
          }
        ],
        "quantity": 1,
        "requires_shipping": true,
        "taxable": true,
        "title": "商品名称",
        "variant_id": "18056577393793239655103258"
      }
    ],
    "market_region_country_code": "CN",
    "note": "客户想要尽快发货",
    "note_attributes": [
      {
        "name": "name",
        "value": "value"
      }
    ],
    "outer_id": "outer_id",
    "payment_terms": {
      "pay_channel_id": "支付方式",
      "pay_status": "支付状态",
      "payment_channel_name": "渠道名称"
    },
    "shipping_address": {
      "address1": "8899 Garfield Street",
      "address2": "Apartment 5",
      "city": "Riverside",
      "city_code": "4200006",
      "company": "SHOPLINE",
      "country": "美国",
      "country_code": "US",
      "district": "区",
      "district_code": "4200006",
      "first_name": "Tom",
      "last_name": "Washington",
      "phone": "13100000000",
      "province": "加利福尼亚州",
      "province_code": "4200006",
      "zip": "92503"
    },
    "shipping_lines": {
      "delivery_id": "运费模板id",
      "price": "12.41",
      "shipping_type": "system",
      "title": "标题"
    },
    "stock_reserved": true,
    "stock_reserved_time": 1669280400000,
    "tags": [
      "标签列表"
    ],
    "tax_exempt": false
  }
}

Language

curl --request POST \
     --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",
      "postcode": "4200006",
      "province": "加利福尼亚州",
      "province_code": "4200006",
      "same_as_receiver": true
    },
    "calc_sku_stock_mode": "not_limit",
    "customer": {
      "area_code": "92503",
      "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,
    "language_info": {
      "customer_language": "en",
      "merchant_language": "en"
    },
    "line_items": [
      {
        "applied_discount": {
          "description": "折扣描述",
          "title": "折扣名称",
          "value": 100,
          "value_type": "50"
        },
        "discountable": false,
        "gift_card": true,
        "price": "12.45",
        "product_id": "16056577393789045351043258",
        "product_source": "main_site",
        "properties": [
          {
            "name": "name",
            "show": true,
            "type": "text-one",
            "urls": [
              "https://image.baidu.com/search/detail?ct=503316480&z=0&ipn=d&word=%E5%9B%BE%E7%89%87&hs=0&pn=0&spn=0"
            ],
            "value": "example"
          }
        ],
        "quantity": 1,
        "requires_shipping": true,
        "taxable": true,
        "title": "商品名称",
        "variant_id": "18056577393793239655103258"
      }
    ],
    "market_region_country_code": "CN",
    "note": "客户想要尽快发货",
    "note_attributes": [
      {
        "name": "name",
        "value": "value"
      }
    ],
    "outer_id": "outer_id",
    "payment_terms": {
      "pay_channel_id": "支付方式",
      "pay_status": "支付状态",
      "payment_channel_name": "渠道名称"
    },
    "shipping_address": {
      "address1": "8899 Garfield Street",
      "address2": "Apartment 5",
      "city": "Riverside",
      "city_code": "4200006",
      "company": "SHOPLINE",
      "country": "美国",
      "country_code": "US",
      "district": "区",
      "district_code": "4200006",
      "first_name": "Tom",
      "last_name": "Washington",
      "phone": "13100000000",
      "province": "加利福尼亚州",
      "province_code": "4200006",
      "zip": "92503"
    },
    "shipping_lines": {
      "delivery_id": "运费模板id",
      "price": "12.41",
      "shipping_type": "system",
      "title": "标题"
    },
    "stock_reserved": true,
    "stock_reserved_time": 1669280400000,
    "tags": [
      "标签列表"
    ],
    "tax_exempt": false
  }
}
'

这篇文章对你有帮助吗？

SHOPLINE

条款协议