创建订单

需要 write_orders 权限点。

更多权限点使用信息，请参考：

POST https://{handle}.myshopline.com/admin/openapi/v20270301/orders.json

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

创建订单。

请求头

Content-Type string required

字段值固定为 application/json; charset=utf-8。
Authorization string required

资源的访问令牌。参考应用授权获取访问令牌，然后将获取到的访问令牌以 Bearer 格式传入。
例子:

Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhcHBJZCI6MCwiYXBwS2V5IjoiNzU2ZjI1NWE2NjdlZTcwNTk1MzM0ZjVjYzk4NzU5MzBmN2E3NGZjMSIsImV4cCI6MTg3OTQ4MjA3NiwiaXNzIjoieXNvdWwiLCJzZWxsZXJJZCI6IjIwMDAyMzQ4ODAiLCJzdG9yZUlkIjoiMTY3MjM2OTcyOTYwNiIsInRpbWVzdGFtcCI6MTc4NDc4NzY3NjY2MSwidmVyc2lvbiI6IlYyIn0.3ZzbGAH4cLU1QR2VPEvMOQInUDvus-C4amkINSQIPuNVlXsFKj0sAt1c0KnUy9MWUOFV9cHlkf7J90r2y1FzpA

请求体

orderobject required

订单信息。
buyer_note string

买家留言。
例子: message
currency string

买家下单币种。该字段值为三位币种码，遵循 ISO 4217 标准。
例子: USD
fulfillment_status string

订单的发货状态。有效枚举值包含：

unshipped：未发货

shipped：已发货

默认值：unshipped

注意：传入枚举值的准确性会进行强校验，如果枚举值校验不通过，则订单会创建失败，会报错 fulfillment_status is invalid。
line_itemsobject[] required

订单商品快照信息列表。
title string

商品标题。
例子: beautiful skirt
location_id string

商品库存地点 ID。
例子: 5445886274929439997
propertiesobject[]

商品定制信息列表。
value string

自定义属性值
例子: attribute value
name string

自定义属性名称
例子: attribute name
show boolean

定制信息是否可见：

true：可见

false：不可见默认值：false

type string

定制信息类型。有效枚举值包含：

text：字符类型

picture：图片类型

link：链接类型

urls array

URL 资源列表。

如果 type 是 picture，可通过 urls 获取渲染出缩略图。

如果 type 是 link，那么超链接为 urls 的第一个。

例子: ["[\"https://www.url.com\"]"]
quantity long

商品数量。
例子: 1
taxable boolean

该商品是否需要收税。

true：需要收税

false：不需要收税

默认值：true
variant_id string

分配给库存中某一特定商品的唯一编码。
例子: 18056761559987524812644011
discount_priceobject

商品自定义折扣明细。
amount string

折扣金额。数值保留到小数点后两位。
例子: 1.00
title string

折扣名称。
例子: Discount name
price string

商品售价，数值保留到小数点后两位。
例子: 3.25
product_id string

款式对应商品的唯一标识 ID。
例子: 16056761559984840457934011
requires_shipping boolean

表明商品是否需要运输。

true：需要运输

false：不需要运输

shipping_line_title string

商品行匹配的运费方案标题。在传入shipping_lines情况下，当前字段必传。
tax_lineobject

自定义商品税费信息。
price string

税费金额。商品实际收税以此字段金额为准，传入的 rate 税费仅做展示作用。
例子: 3.25
rate string

税率，以小数形式表示，数值保留到小数点后四位。如果税率为2%，该值为0.0200。该信息只做展示作用。
title string

税费说明标题。该信息只做展示作用。
例子: Tax name
price_infoobject required

价格信息。
taxes_included boolean

该订单是否包含税费金额。

true：包含税费金额

false：不包含税费金额

total_shipping_price string

运费，以店铺币种展示。数值保留到小数点后两位。
例子: 8.00
current_extra_total_discounts string

订单折扣金额，不包含折扣码优惠。数值保留到小数点后两位。
例子: 8.00
shipping_addressobject

收货地址信息。
area string

收货地址中的区或县。

最大长度限制：64
例子: Panyu District
area_code string

收货地址中区或县的编码。
例子: 510006
latitude string

收货地址所在的纬度。
例子: 43
phone string

收件人的手机号码。
例子: 13903004000
province_code string

收货地址中省份的编码，该编码可以是自定义编号或者为二位的 ISO 3166-2 国际编码。
例子: 4220006
city_code string

收货地址中城市的编码。
例子: 510000
longitude string

收货地址所在的经度。
例子: 34
province string

收货地址中的州或省份。
例子: Guangdong Province
address2 string

收货地址的第二行。通常是公寓、套房或单元等信息。

最大长度限制：255
例子: Apartment 5
city string

收货地址中的城市。

最大长度限制：64
例子: Guangzhou City
email string

买家的邮箱地址。
例子: test001@Gmail.com
last_name string

收件人的姓。

最大长度限制：64
例子: Washington
zip string

收货地址的邮编信息。
例子: 510036
address1 string

收货地址的第一行。通常是街道地址或邮政信箱编号等信息。

最大长度限制：255
例子: Xiaoguwei Street
company string

收件人的公司名称。
例子: Company Name
country string

收货地址中的国家或区域。

最大长度限制：64
例子: China
country_code string

收货地址中国家或地区的二位国家码，遵循 ISO 3166-1 国际标准。
例子: CN
first_name string

收件人的名。

最大长度限制：64
例子: Tom
shipping_lineobject

运费信息。
code string

物流编号。
例子: SF
price string

运费金额，数值保留到小数点后两位。
例子: 3.25
tax_lineobject

自定义商品税费信息。
title string

税费说明标题。该信息只做展示作用。
例子: Tax name
price string

税费金额。商品实际收税以此字段金额为准，传入的 rate 税费仅做展示作用。
例子: 100
rate string

税率，以小数形式表示，数值保留到小数点后四位。如果税率为2%，该值为0.0200。该信息只做展示作用。
title string

运费名称。
例子: Shipping name
shipping_linesobject[]

运费方案列表。最大个数限制：10
title string

运费名称。
price string

运费金额
tax_lineobject

运费税费明细
price string

税费金额
rate string

税率，以小数形式表示，数值保留到小数点后四位。如果税率为2%，该值为0.0200。该信息只做展示作用。
title string

税费说明标题。该信息只做展示作用。
billing_addressobject

用于邮寄账单发票的地址。
city string

账单地址中的城市。

最大长度限制：64
例子: Guangzhou City
company string

账单收件人的公司名称。
例子: Company Name
phone string

账单收件人的手机号码。
例子: 13903004000
same_as_receiver boolean

表示账单地址 billing_address 是否与收货地址 shipping_address 是一样的。
address1 string

账单地址的第一行。通常是街道地址或邮政信箱编号等信息。

最大长度限制：256
例子: Xiaoguwei Street
address2 string

账单地址的第二行。通常是公寓、套房或单元等信息。

最大长度限制：256
例子: Apartment 5
country string

账单地址中的国家或地区。

最大长度限制：64
例子: China
last_name string

账单收件人的姓。
例子: Washington
province string

账单地址中的省份。
例子: Guangdong Province
city_code string

账单地址中城市的编码。
例子: 510000
country_code string

账单地址中国家或地区的二位国家码，遵循 ISO 3166-1 国际标准。
例子: US
zip string

账单地址的邮编信息。
例子: 510036
area string

账单地址中的区或县。

最大长度限制：64
例子: Panyu District
area_code string

账单地址中区或县的编码。
例子: 510007
email string

账单收件人的邮箱。
例子: test001@Gmail.com
first_name string

账单收件人的名。
例子: Tom
province_code string

账单地址中省份的编码，该编码可以是自定义编号或者为二位的 ISO 3166-1 国际编码。
例子: 4220006
customer_locale string

买家语种编码，语种编码遵循 ISO 639 标准。
例子: en
financial_status string

订单的付款状态。有效枚举值包含：

unpaid：未支付

partially_paid：部分支付

paid：已完成支付

默认值：unpaid

注意：传入枚举值的准确性会进行强校验，如果枚举值校验不通过，则订单创建会失败，会报错 financial_status is invalid。
inventory_behaviour string

在订单创建过程中库存的处理方式。有效枚举值包含：

bypass：不处理库存。在创建订单时，系统不会对库存进行任何操作，库存数量不会发生变化。

decrement_ignoring_policy：扣减库存。不受商家配置的库存策略影响。

decrement_obeying_policy：按照商家配置的库存策略扣减库存。
send_fulfillment_receipt boolean

是否发送订单发货邮件。

true：发送

false：不发送
send_receipt boolean

是否发送订单确认邮件。

true：发送

false：不发送
company_location_id string

公司地点 ID，用于创建 B2B 订单。
例子: 3232423438438
customerobject

买家信息。
area_code string

国家或地区的手机区号。
例子: +86
email string

买家的邮箱地址。
例子: test001@Gmail.com
first_name string

买家的名。
例子: Tom
id string

买家 ID。

最大长度限制：64
例子: 4201057495
last_name string

买家的姓。
例子: Washington
phone string

买家手机号。
例子: 13903004000
exchange_rate string

订单货币和店铺货币之间的汇率。
例子: 7.1245
name string

订单编号（和订单 ID 不同，该编号可以在商家后台自定义前缀）。
例子: D101
order_note string

商家订单备注。

最大长度限制：50
例子: Notes
market_region_country_code string

订单下单所在市场的国家或区域码。遵循 ISO 4217 标准。
例子: US
note string

订单备注。

最大长度限制：50

废弃：该字段自 API 版本 v20210901 起已废弃。
例子: Notes
note_attributesobject[]

商家备注日志列表。
name string

商家 ID，表明备注来源。
例子: Note source
value string

备注内容。
例子: Notes
processed_at string

订单成单时间。格式：ISO 8601。
例子: 2023-04-12T22:59:52+08:00
transaction_listobject[]

支付单列表。
amount string

支付单金额。数值保留到小数点后两位。
例子: 3.25
gateways string

支付渠道。
例子: PayPal
processed_at string

支付单创建时间。格式：ISO 8601。
例子: 2023-04-12T22:59:52+08:00
status string required

支付状态。有效枚举值包含：

unpaid：未支付

failure：支付失败

success：支付成功

error：支付出错

例子: string
transactionsobject

支付单信息。
id string

支付方式 ID。
例子: 424243

状态码

更多状态码信息，参考 HTTP 状态码。

响应头

traceId

请求的全局唯一标识符。用于追踪请求在系统中的流转，以便于问题发生时进行定位和调试。

响应体

orderobject

订单信息。
note_attributesobject[]

商家备注日志。
name string

卖家标识，表明备注来源。
例子: Note source
value string

备注内容。
例子: Notes
po_number string

B2B 场景在订单上记录的采购订单号。
tax_type string

订单的税费类型。有效枚举值包含：

product_tax：商品税

shipping_tax：运费税
total_line_items_price string

商品原价总和，数值保留到小数点后两位，以店铺币种金额展示。
例子: 3.25
total_line_items_price_setobject

商品原价总和，分别以买家币种金额和店铺币种金额展示。
presentment_moneyobject

展示给买家的商品原价信息。
amount string

商品原价，数值保留到小数点后两位。
例子: 3.25
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
shop_moneyobject

商家侧记录的商品原价信息。
amount string

商品原价，数值保留到小数点后两位。
例子: 3.25
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
total_tax_setobject

税费总和，分别以买家币种金额和店铺币种金额展示。
presentment_moneyobject

展示给买家的税费信息。
amount string

税费，数值保留到小数点后两位。
例子: 3.25
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
shop_moneyobject

商家侧记录的税费信息。
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
amount string

税费，数值保留到小数点后两位。
例子: 3.25
total_tip_received string

小费，数值保留到小数点后两位，以店铺币种金额展示。
例子: 3.25
current_subtotal_price string

商品金额总和，为商品单价 * 数量，以店铺币种展示。
例子: 7.12
current_total_duties_setobject

商品总关税，分别以买家币种金额和店铺币种金额展示。
presentment_moneyobject

展示给买家的商品总关税信息。
amount string

关税金额，数值保留到小数点后两位。
例子: 8.88
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
shop_moneyobject

商家侧记录的商品总关税信息。
amount string

关税金额，数值保留到小数点后两位。
例子: 8.88
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
current_total_tax_setobject

税费金额总和，分别以买家币种金额和店铺币种金额展示。
presentment_moneyobject

展示给买家的税费信息。
amount string

税费，数值保留到小数点后两位。
例子: 1.03
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
shop_moneyobject

商家侧记录的税费信息。
amount string

税费，数值保留到小数点后两位。
例子: 1.03
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
name string

商家自定义的订单号，从 1001 开始，可以设置前缀。
例子: test1001
payment_detailsobject[]

支付单信息列表。
pay_seq string

支付单号。
例子: 23057287797738260472676128
pay_status string

支付单状态。有效枚举值包含：

unpaid：未支付

pending：支付中

risking：风控中

paid：已支付

paid_overtime：支付超时

paid_failed：支付失败

processed_at string

支付单创建时间。格式：ISO 8601。
例子: 2023-04-12T22:59:52+08:00
pay_amount string

支付金额，以店铺币种金额展示。数值保留到小数点后两位。
例子: 3.25
pay_channel string

支付渠道。
例子: Paypal
pay_channel_deal_id string

外部渠道支付流水号。
例子: pi_3MI897Hezv8FxjBO1uGxMPhX
pos_location_id string

POS 交易地点 ID。
例子: 5327026538935748524
presentment_currency string

买家侧币种，同卖家侧币种。三位币种码，遵循 ISO 4217 国际标准。
例子: USD
tax_number string

税号。
例子: 111111111111
created_at string

订单创建时间。格式：ISO 8601。
例子: 2021-08-16T08:27:57+00:00
current_total_tax string

税费金额总和，以店铺币种金额展示。
例子: 2.41
customerobject

买家信息。
area_code string

国家或地区的手机区号。
例子: +86
currency string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
email string

买家的邮箱地址。
例子: test001@Gmail.com
first_name string

买家的名。
例子: Tom
id string

买家 ID。
例子: 4201057495
last_name string

买家的姓。
例子: Washington
phone string

买家的手机号。
例子: 13100000000
order_status_url string

订单状态页 URL。
例子: https://shoptest.myshoplinestg.com/trade/thank_you?mainOrderMark=xxx&mainOrderSeq=200565776406008509
subtotal_price string

商品折后价总和，为商品总价 - 营销优惠 - 自定义折扣，以店铺币种展示。
例子: 4.12
subtotal_price_setobject

商品折后价总和，分别以买家币种金额和店铺币种金额展示。
presentment_moneyobject

展示给买家的折后价格信息。
amount string

折后价格，数值保留到小数点后两位。
例子: 4.12
currency_code string

三位币种码，遵循 ISO 4217 标准。
例子: USD
shop_moneyobject

商家侧记录的折后价格信息。
amount string

折后价格，数值保留到小数点后两位。
例子: 4.12
currency_code string

三位币种码，遵循 ISO 4217 标准。
例子: USD
taxes_included boolean

该订单是否包含税费金额。

true：包含税费金额

false：不包含税费金额
total_discounts string

订单折扣总和，为营销折扣 + 自定义折扣，数值保留到小数点后两位，以店铺币种金额展示。

废弃：该字段自 API 版本 v20210901 起已废弃。
例子: 3.25
current_total_price string

订单总额，以店铺币种金额展示。
例子: 1000.25
deduct_member_point_amount string

当前订单会员积分抵扣金额，以店铺币种展示。数值保留到小数点后两位。
例子: 3.25
discount_codesobject

优惠码信息。
amount string

优惠金额，以店铺币种展示，数值保留到小数点后两位。
例子: 3.25
code string

优惠码。
例子: 82UD6BTPX9L2
type string

优惠类型。有效枚举值包含：

减金额：全场满 100 元立减 10 元

打折：全场满 100 元打 9 折

免运费：满 3 件免运费

加价品：需要支付额外金额

任意N件优惠价：任意买 3 件商品，只需 99 元

A+B组合优惠价：同时买 A 商品和 B 商品，两件一起只需 88 元

赠品：购买制定商品赠送额外商品

固定售价：统一售价 29 元

最低价商品免费：买 3 件商品，最便宜的那件免费

打包价：多件商品组合以固定总价出售

第N件打折：第 2 件打 8 折

买x送y：满 2 件送 1 件

自定义：自定义折扣

注意：返回的值为中文。
id string

订单号，系统自定义编号。
例子: 21050224312121887324667162, 21050224312121887324667164
status string

订单状态。有效枚举值包含：

open：订单处理中

cancelled：订单已取消
total_outstanding string

未付款金额总额，数值保留到小数点后两位，以店铺币种金额展示。
例子: 3.25
current_subtotal_price_setobject

商品金额总和，为商品单价 * 数量，分别以买家币种和店铺币种展示。
shop_moneyobject

商家侧记录的订单价格信息。
amount string

订单金额。数值保留到小数点后两位。
例子: 3.25
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
presentment_moneyobject

展示给买家的订单价格信息。
amount string

订单金额。数值保留到小数点后两位。
例子: 3.25
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
current_total_discounts string

折扣金额总和，数值保留到小数点后两位，为营销优惠 + 人工折扣，以店铺币种展示。
例子: 0.25
current_total_price_setobject

订单总额，分别以买家币种金额和店铺币种金额展示。
presentment_moneyobject

展示给买家的订单价格信息。
amount string

订单总额，数值保留到小数点后两位。
例子: 3.25
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
shop_moneyobject

商家侧记录的订单价格信息。
amount string

订单总额，数值保留到小数点后两位。
例子: 3.25
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
deduct_member_point_amount_setobject

当前订单会员积分抵扣金额，分别以买家币种金额和店铺币种金额展示。
presentment_moneyobject

展示给买家的订单抵扣金额信息。
amount string

抵扣金额，数值保留到小数点后两位。
例子: 3.25
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
shop_moneyobject

商家侧记录的订单抵扣金额信息。
amount string

抵扣金额，数值保留到小数点后两位。
例子: 3.25
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
shipping_addressobject

收货地址。
city string

地址中的城市。
例子: New York
company string

收件人所在的公司名称。
例子: New company name
district string

地址中的区。
例子: Manhattan
district_code string

地址中的区编码。
例子: NY100xx
province_code string

地址中省份的编码，该编码可以是自定义编号或者为二位的 ISO 3166-2 国际编码。
例子: NY
address1 string

地址的第一行。通常是街道地址或邮政信箱编号等信息。
例子: Address 1
address2 string

地址的第二行。通常是公寓、套房或单元等信息。
例子: Address 2
country string

地址中的国家或区域。
例子: USA
country_code string

地址中国家或区域的二位码，遵循 ISO 3166-1 国际标准的二位国家或区域码，用于识别市场所在的国家或地区。
例子: US
first_name string

收件人的名。
例子: Tom
last_name string

收件人的姓。
例子: Washington
zip string

地址的邮编信息。
例子: 10007
latitude string

地址所在的纬度。
例子: 40.7831°N
longitude string

地址所在的经度。
例子: 73.9712°W
phone string

收件人的手机号码。
例子: 19821119121
province string

地址中的省份。
例子: New York state
standard_province_code string

账单地址中省份的编码，该编码为二位的 ISO 3166-2 国际编码，区别于province_code返参为自定义编码。
tax_linesobject[]

税费明细列表。
rate double

税率，以小数形式表示，数值保留到小数点后四位。如果税率为2%，该值为0.0200。该信息只做展示作用。
title string

税费说明标题。该信息只做展示作用。
例子: taxes
name string

税费名称。
例子: taxes
price string

税费，以店铺币种展示。数值保留到小数点后两位。
例子: 3.25
price_setobject

税费，分别以买家币种和店铺币种展示。
presentment_moneyobject

展示给买家的税费信息。
amount string

税费，数值保留到小数点后两位。
例子: 3.25
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
shop_moneyobject

商家侧记录的税费信息。
amount string

税费，数值保留到小数点后两位。
例子: 3.25
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
total_discounts_setobject

订单折扣总和，为营销折扣 + 自定义折扣，分别以店铺币种金额和买家币种金额展示。

废弃：该字段自 API 版本 v20210901 起已废弃。
presentment_moneyobject

展示给买家的折扣信息。
currency_code string

三位币种码，遵循 ISO 4217 标准。
例子: USD
amount string

折扣金额，数值保留到小数点后两位。
例子: 3.25
shop_moneyobject

商家侧记录的折扣信息。
amount string

折扣金额，数值保留到小数点后两位。
例子: 3.25
currency_code string

三位币种码，遵循 ISO 4217 标准。
例子: USD
billing_addressobject

用于邮寄账单发票的地址。
province_code string

账单地址中省份的编码，该编码可以是自定义编号或者为二位的 ISO 3166-2 国际编码。
例子: 4200006
standard_province_code string

账单地址中省份的编码，该编码为二位的 ISO 3166-2 国际编码，区别于province_code返参为自定义编码。
city string

账单地址中的城市。
例子: Guangzhou City
country_code string

账单地址中国家或地区的二位码，遵循 ISO 3166-1 国际标准。
例子: CN
first_name string

账单收件人的名。
例子: Tom
last_name string

账单收件人的姓。
例子: Washington
zip string

账单地址的邮编信息。
例子: 510000
address1 string

账单地址的第一行。通常是街道地址或邮政信箱编号等信息。
例子: Xiaoguwei Street,
address2 string

账单地址的第二行。通常是公寓、套房或单元等信息。
例子: Apartment 5
company string

账单收件人所在的公司名称。
例子: new company
country string

账单地址中的国家或区域。
例子: China
phone string

账单收件人的手机号码。
例子: 13100000000
province string

账单地址中的省份。
例子: Guangdong Province
email string

买家邮箱。
例子: test001@Gmail.com
line_itemsobject[]

订单商品快照信息列表。
variant_id string

分配给库存中某一特定商品的唯一编码。
例子: 18056761559987524812644011
variant_title string

商品属性值，多个以 / 分割。
例子: 155 / red / large
vendor string

供应商。
例子: Supplier
country_code_of_origin string

原产地或发货地的国家或地区代码，用于识别市场所在的国家或地区。遵循 ISO 3166-1 国际标准。
例子: US
price string

商品售价，以店铺币种金额展示，数值保留到小数点后两位。
例子: 100
tags string

商品标签，多个以逗号隔开。
例子: watch
harmonized_system_code string

海关编码，用于在国际贸易中对产品进行分类。
例子: harmonized system code
quantity integer

订单中的商品数量。
例子: 1
requires_shipping boolean

商品是否需要发货。

true：需要发货

false：不需要发货

sku string

商品 SKU 序列号。
例子: 18056761559987524812644011
tax_linesobject[]

税费明细列表。
title string

税费说明标题。该信息只做展示作用。
例子: taxes
name string

税费名称
例子: taxes
price string

税费，以店铺币种展示。数值保留到小数点后两位。
例子: 3.25
price_setobject

税费，分别以买家币种和店铺币种展示。
presentment_moneyobject

展示给买家的税费信息。
amount string

税费，数值保留到小数点后两位。
例子: 1.03
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
shop_moneyobject

商家侧记录的税费信息。
amount string

税费，数值保留到小数点后两位。
例子: 1.03
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
rate double

税率，以小数形式表示，数值保留到小数点后四位。如果税率为2%，该值为0.0200。该信息只做展示作用。
attribute string

款式规格信息，以款式名称和规格值拼接展示。
例子: red
dutiesobject[]

关税信息。
country_code_of_origin string

原产地或发货地的国家或地区代码，用于识别市场所在的国家或地区。遵循 ISO 3166-1 国际标准。
例子: US
harmonized_system_code string

海关编码，用于在国际贸易中对产品进行分类。
例子: D2314244
id string

关税编号。
例子: 3155232
priceobject

关税金额，分别以买家币种金额和店铺币种金额展示。
presentment_moneyobject

展示给买家的关税金额信息。
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
amount string

关税金额，数值保留到小数点后两位。
例子: 8.88
shop_moneyobject

商家侧记录的关税金额信息。
amount string

关税金额，数值保留到小数点后两位。
例子: 8.88
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
tax_linesobject[]

税费信息列表。
price_setobject

税费金额，分别以买家币种金额和店铺币种金额展示。
presentment_moneyobject

展示给买家的税费信息。
amount string

税费金额，数值保留到小数点后两位。
例子: 8.88
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
shop_moneyobject

商家侧记录的税费信息。
amount string

税费金额，数值保留到小数点后两位。
例子: 8.88
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
rate double

税率，以小数形式表示，数值保留到小数点后四位。如果税率为2%，该值为0.0200。该信息只做展示作用。
rate_percentage double

税率，以百分比数值形式表示，数值保留到小数点后两位。如果税率为2%，该值为2.00。该信息只做展示作用。
title string

税费说明标题。该信息只做展示作用。
例子: tariff
name string

SKU 标题，该字段值和 title 一致。
例子: skirt
product_id string

款式对应商品的唯一标识 ID。
例子: 16056761559984840457934011
propertiesobject[]

商品定制信息列表。
name string

自定义属性名称。
例子: attribute name
show boolean

定制信息是否可见：

true：可见

false：不可见默认值：false

type string

定制信息类型。有效枚举值包含：

text：字符类型

picture：图片类型

link：链接类型

urls array

URL 资源列表。

如果 type 是 picture，可通过 urls 获取渲染出缩略图。

如果 type 是 link，那么超链接为 urls 的第一个。

例子: ["[\"https://www.url.com\"]"]
value string

自定义属性值。
例子: attribute value
id string

商品快照表的 ID，系统生成，与订单号 order.id 唯一确认一个商品。
例子: 3452
image_url string

商品图片的 URL 地址。
例子: https://d2n979dmt31clo.cloudfront.net/image/store/4211449909/1667384795847/63928f08a7174ab2958c6a969
price_setobject

商品售价，分别以店铺币种金额和买家币种金额展示。
shop_moneyobject

商家侧记录的商品售价信息。
amount string

商品售价，数值保留到小数点后两位。
例子: 1.03
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
presentment_moneyobject

展示给买家的商品售价信息。
amount string

商品售价，数值保留到小数点后两位。
例子: 1.03
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
taxable boolean

该商品是否需要收税。

true：需要收税

false：不需要收税

title string

商品标题。
例子: beautiful skirt
locationsobject[]

到店取货地点地址信息列表。
location_id string

取货地点唯一编号。
例子: 5327026538935748524
name string

取货地址名称。
例子: us.street
type string

地点类型。有效枚举值包含：

posLocation：POS 渠道创建该订单的门店地点。建议使用 posLocationId，因为 posLocation 后续将废弃。

pickupLocation：当订单的配送方式为自提时，自提的门店地点。

productLocation：订单中商品的库存地点。建议使用商品行中的 location 信息，因为 productLocation 后续将废弃。
order_source string

订单来源渠道的 handle。handle 为语义化标识符。
total_shipping_price_setobject

订单运费总和，分别以买家币种金额和店铺币种金额展示。
presentment_moneyobject

展示给买家的运费信息。
amount string

运费金额，数值保留到小数点后两位。
例子: 3.25
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
shop_moneyobject

商家侧记录的运费信息。
amount string

运费，数值保留到小数点后两位。
例子: 3.25
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
total_tax string

税费总额，数值保留到小数点后两位，以店铺币种金额展示。
例子: 3.25
currency string

交易币种，三位币种码，遵循 ISO 4217 国际标准。
例子: USD
current_total_discounts_setobject

折扣金额总和，数值保留到小数点后两位，为营销优惠 + 人工折扣，分别以买家币种金额和店铺币种金额展示。
presentment_moneyobject

展示给买家的折扣金额信息。
amount string

折扣金额总和，数值保留到小数点后两位。
例子: 3.25
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
shop_moneyobject

商家侧记录的折扣金额信息。
amount string

折扣金额总和，数值保留到小数点后两位。
例子: 3.25
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
financial_status string

订单付款状态。有效枚举值包含：

unpaid：未支付

authorized：已授权

pending：处理中

partially_paid：部分付款

paid：已付款

partially_refunded：部分退款

refunded：已退款
phone string

买家的手机号。
例子: 13900000000
adjust_price_setobject

POS 交易场景下因金额四舍五入带来的差额金额，分别以买家币种和卖家币种展示。
presentment_moneyobject

展示给买家的差额金额信息。
amount string

差额金额。数值保留到小数点后两位。
例子: 3.25
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
shop_moneyobject

商家侧记录的差额金额信息。
amount string

差额金额。数值保留到小数点后两位。
例子: 3.25
currency_code string

三位币种码，遵循 ISO 4217 国际标准。
例子: USD
note string

商家备注内容。
例子: Notes
processed_at string

成单时间。格式：ISO 8601。
例子: 2023-04-12T22:59:52+08:00
total_weight string

商品总重量，单位：g。
例子: 1000
adjust_price string

POS 交易场景下因金额四舍五入带来的差额金额，用店铺币种。
例子: 7.23

API Explorer

调试台

Base URL

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

ParamOptions

Authorization — header required

Body

Body required

{
  "order": {
    "transactions": {
      "id": "424243"
    },
    "company_location_id": "3232423438438",
    "currency": "USD",
    "customer": {
      "email": "test001@Gmail.com",
      "first_name": "Tom",
      "id": "4201057495",
      "last_name": "Washington",
      "phone": "13903004000",
      "area_code": "+86"
    },
    "fulfillment_status": null,
    "send_receipt": null,
    "shipping_lines": [
      {
        "price": null,
        "tax_line": {
          "price": null,
          "rate": null,
          "title": null
        },
        "title": null
      }
    ],
    "buyer_note": "message",
    "exchange_rate": "7.1245",
    "market_region_country_code": "US",
    "processed_at": "2023-04-12T22:59:52+08:00",
    "transaction_list": [
      {
        "amount": "3.25",
        "gateways": "PayPal",
        "processed_at": "2023-04-12T22:59:52+08:00",
        "status": "string"
      }
    ],
    "name": "D101",
    "note": "Notes",
    "customer_locale": "en",
    "financial_status": null,
    "inventory_behaviour": null,
    "line_items": [
      {
        "taxable": null,
        "title": "beautiful skirt",
        "variant_id": "18056761559987524812644011",
        "location_id": "5445886274929439997",
        "price": "3.25",
        "properties": [
          {
            "name": "attribute name",
            "show": null,
            "type": null,
            "urls": [
              "[\"https://www.url.com\"]"
            ],
            "value": "attribute value"
          }
        ],
        "shipping_line_title": null,
        "discount_price": {
          "amount": "1.00",
          "title": "Discount name"
        },
        "product_id": "16056761559984840457934011",
        "quantity": 1,
        "requires_shipping": null,
        "tax_line": {
          "title": "Tax name",
          "price": "3.25",
          "rate": null
        }
      }
    ],
    "note_attributes": [
      {
        "name": "Note source",
        "value": "Notes"
      }
    ],
    "price_info": {
      "current_extra_total_discounts": "8.00",
      "taxes_included": null,
      "total_shipping_price": "8.00"
    },
    "billing_address": {
      "address2": "Apartment 5",
      "city": "Guangzhou City",
      "country_code": "US",
      "phone": "13903004000",
      "zip": "510036",
      "area": "Panyu District",
      "area_code": "510007",
      "company": "Company Name",
      "country": "China",
      "first_name": "Tom",
      "address1": "Xiaoguwei Street",
      "last_name": "Washington",
      "province": "Guangdong Province",
      "same_as_receiver": null,
      "city_code": "510000",
      "email": "test001@Gmail.com",
      "province_code": "4220006"
    },
    "order_note": "Notes",
    "send_fulfillment_receipt": null,
    "shipping_address": {
      "address1": "Xiaoguwei Street",
      "country": "China",
      "email": "test001@Gmail.com",
      "longitude": "34",
      "company": "Company Name",
      "first_name": "Tom",
      "zip": "510036",
      "address2": "Apartment 5",
      "area": "Panyu District",
      "last_name": "Washington",
      "province": "Guangdong Province",
      "province_code": "4220006",
      "area_code": "510006",
      "city": "Guangzhou City",
      "city_code": "510000",
      "country_code": "CN",
      "latitude": "43",
      "phone": "13903004000"
    },
    "shipping_line": {
      "title": "Shipping name",
      "code": "SF",
      "price": "3.25",
      "tax_line": {
        "rate": null,
        "title": "Tax name",
        "price": "100"
      }
    }
  }
}

Language

curl --request POST \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20270301/orders.json \
     --header 'Authorization: Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhcHBJZCI6MCwiYXBwS2V5IjoiNzU2ZjI1NWE2NjdlZTcwNTk1MzM0ZjVjYzk4NzU5MzBmN2E3NGZjMSIsImV4cCI6MTg3OTQ4MjA3NiwiaXNzIjoieXNvdWwiLCJzZWxsZXJJZCI6IjIwMDAyMzQ4ODAiLCJzdG9yZUlkIjoiMTY3MjM2OTcyOTYwNiIsInRpbWVzdGFtcCI6MTc4NDc4NzY3NjY2MSwidmVyc2lvbiI6IlYyIn0.3ZzbGAH4cLU1QR2VPEvMOQInUDvus-C4amkINSQIPuNVlXsFKj0sAt1c0KnUy9MWUOFV9cHlkf7J90r2y1FzpA' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --header 'accept: application/json'

这篇文章对你有帮助吗？

SHOPLINE

条款协议