为履约单创建发货单（单个或批量）

需要 write_assigned_fulfillment_orders 权限点。

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

POST https://{handle}.myshopline.com/admin/openapi/v20260301/fulfillments/fulfillments.json

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

给一个或多个履约订单创建一个发货单

请求头

Content-Type string required

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

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

Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw

请求体

fulfillmentobject required

包裹单物流信息
line_items_by_fulfillment_orderobject[] required

履约订单号列表
fulfillment_order_id string required

履约订单号
例子: "1046000807"
fulfillment_order_line_itemsobject[]

履约单商品行
id string required

履约订单商品行id
例子: 6076
quantity integer required

发货数量
例子: 2
message string

通知信息
例子: "he package was shipped this morning."
notify_customer boolean

是否通知消费者
例子: true
tracking_infoobject

物流信息

废弃: 该字段自 API 版本 v20250601 起已废弃。参考 tracking_info_list 字段查看相关信息。
url string

追踪链接
例子: http://www.my-url.com
company string

物流公司
例子: "my-company"
number string

物流单号
例子: "UG15439033"
tracking_info_listobject[]

物流追踪信息列表，若指定该入参，则单个入参的tracking_url、tracking_number、tracking_company被拦截。最多传入 10 个追踪信息。
tracking_company string

物流服务商。
例子: "my-company"
tracking_number string

物流单号。
例子: "UG15439033"
tracking_url string

追踪链接。
例子: http://www.my-url.com
order_id string required

订单id
例子: "21057116277667827637773776"

状态码

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

响应头

traceId

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

响应体

fulfillmentobject

包裹单详情
location_id string

地点id
例子: "54039222210"
order_id string

订单id
例子: "21057116277667827637773776"
tracking_info_listobject[]

物流追踪信息列表，若指定该入参，则单个入参的tracking_url、tracking_number、tracking_company被拦截。最多传入 10 个追踪信息。
tracking_company string

物流服务商。
tracking_number string

物流单号。
tracking_url string

追踪链接。
tracking_urls array

物流追踪URL列表
例子: ["[\"\"https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=1Z2345\"\"]"]
updated_at string

更新时间
例子: 2022-10-21T08:56:20-04:00
line_itemsobject[]

包裹商品
fulfillment_quantity integer

发货数量
例子: 1
fulfillment_status string

包裹状态
例子: "open"
tax_linesobject[]

税项
name string

税费名
例子: " item tax "
price string

税费
例子: "10.00"
price_setobject

税费多币种信息
presentment_moneyobject

价格
amount string

总额
例子: "10.00"
currency_code string

币种
例子: "USD"
shop_moneyobject

店铺价格
amount string

总额
例子: "10.00"
currency_code string

币种
例子: "USD"
rate string

税率
例子: "1.00"
title string

税费标题
例子: " Product tax "
taxable boolean

是否收税
例子: true
title string

商品标题
例子: "Draft"
vendor string

供应商
price string

商品价格
例子: "100.00"
quantity integer

sku数量
例子: 1
sku string

商品条码
例子: "183423409238904944"
variant_title string

商品属性值
例子: "Black / Bracelet / Bracelet""
id string

id
例子: "466157049"
name string

sku标题
例子: Trade name
product_id string

商品序号
例子: "343342675"
propertiesobject[]

附加信息
type string

属性类型
例子: "picture"
urls array

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

自定义属性值
例子: "value"
additional string

附加信息
例子: " add-on information "
name string

自定义属性名称
例子: " picture "
requires_shipping boolean

是否需要发货
例子: true
total_discount string

优惠
例子: "0.00"
total_discount_setobject

优惠价格信息
shop_moneyobject

店铺价格
currency_code string

币种
例子: "USD"
amount string

总额
例子: "0.00"
presentment_moneyobject

价格
amount string

总额
例子: "0.00"
currency_code string

币种
例子: "USD"
version string

商品版本
例子: "1"
fulfillable_quantity integer

剩余可以发货数量
例子: 1
grams double

重量
例子: 10.5
price_setobject

商品价格信息
presentment_moneyobject

价格
amount string

总额
例子: "100.00"
currency_code string

币种
例子: "USD"
shop_moneyobject

店铺价格
amount string

总额
例子: "100.00"
currency_code string

币种
例子: "USD"
variant_id string

sku序号
例子: "183423409238904944"
shipment_status string

物流状态
例子: "success"
status string

包裹单状态
例子: "success"
created_at string

创建时间
例子: 2022-10-21T08:56:20-04:00
id string

包裹单id
例子: "4005740193290131085320"
tracking_number string

第三方物流单号。

废弃: 该字段自 API 版本 v20250601 起已废弃。参考 tracking_info_list 字段查看相关信息。
例子: "UG198768340YP"
tracking_numbers array

第三方物流单号列表
例子: ["[\"UG198768340YP\"]"]
name string

包裹名称
例子: "#21057116277667827637773776.1"
tracking_company string

物流公司名称。

废弃: 该字段自 API 版本 v20250601 起已废弃。参考 tracking_info_list 字段查看相关信息。
例子: "Other"
tracking_url string

物流跟踪 URL。

废弃: 该字段自 API 版本 v20250601 起已废弃。参考 tracking_info_list 字段查看相关信息。
例子: "https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=1Z2345"

API Explorer

调试台

Base URL

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

ParamOptions

Authorization — header required

Body

Body required

{
  "fulfillment": {
    "line_items_by_fulfillment_order": [
      {
        "fulfillment_order_id": "\"1046000807\"",
        "fulfillment_order_line_items": [
          {
            "id": "6076",
            "quantity": 2
          }
        ]
      }
    ],
    "message": "\"he package was shipped this morning.\"",
    "notify_customer": true,
    "tracking_info": {
      "company": "\"my-company\"",
      "number": "\"UG15439033\"",
      "url": "http://www.my-url.com"
    },
    "tracking_info_list": [
      {
        "tracking_company": "\"my-company\"",
        "tracking_number": "\"UG15439033\"",
        "tracking_url": "http://www.my-url.com"
      }
    ]
  },
  "order_id": "\"21057116277667827637773776\""
}

Language

curl --request POST \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301/fulfillments/fulfillments.json \
     --header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --header 'accept: application/json'

这篇文章对你有帮助吗？

SHOPLINE

条款协议