创建发货单（基于订单）

需要 write_orders 权限点。
更多权限点使用信息，请参考：
访问权限。
POST https://{handle}.myshopline.com/admin/openapi/v20260301/orders/:order_id/fulfillments.json
handle ：店铺的唯一标识符，值为店铺域名的前缀。例如，域名为 open001.myshopline.com 的店铺，其 handle 是 open001 。
创建发货单（基于指定的订单）。
路径参数
  • order_id string required
    订单 ID。
请求头
  • Content-Type string required
    字段值固定为 application/json; charset=utf-8。
  • Authorization string required
    资源的访问令牌。参考 应用授权 获取访问令牌，然后将获取到的访问令牌以 Bearer 格式传入。
    例子:
    Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw
请求体
  • fulfillmentobject required
    发货信息。
  • line_itemsobject[]
    订单商品快照信息列表。
    最大个数限制：不限制
  • id long required
    商品行快照表的 ID，系统生成，与订单 ID 唯一确认一个商品行。
  • quantity integer required
    商品发货数量。
  • notify_customer boolean
    是否应通知客户。
    • true：通知客户，在创建或更新发货时将发送一封电子邮件
    • false：不通知客户
    默认值：false
  • tracking_company string
    物流公司名称。
    废弃：该字段自 API 版本 v20250601 起已废弃。查看 tracking_info_list 字段。
  • tracking_info_listobject[]
    物流追踪信息列表，若指定该入参，则单个入参的tracking_url、tracking_number、tracking_company被拦截。
    最大个数限制：10
  • tracking_company string
    物流公司名称，枚举值参考 物流公司名单。
  • tracking_number string
    第三方物流单号。
  • tracking_url string
    物流公司的域名。
  • tracking_number string
    第三方物流单号。
    废弃：该字段自 API 版本 v20250601 起已废弃。查看 tracking_info_list 字段。
  • tracking_url string
    物流公司的域名。
    废弃：该字段自 API 版本 v20250601 起已废弃。查看 tracking_info_list 字段。
状态码
更多状态码信息，参考 HTTP 状态码。
响应头
  • traceId
    请求的全局唯一标识符。用于追踪请求在系统中的流转，以便于问题发生时进行定位和调试。
响应体
  • fulfillmentobject
    发货单信息。
  • created_at string
    发货单创建时间。格式：ISO 8601。
    例子: 2024-08-31T02:20:26+08:00
  • id string
    发货单 ID。
  • line_itemsobject[]
    发货单的商品行列表。
  • fulfillable_quantity integer
    商品剩余可发货数量。
  • fulfillment_quantity integer
    发货单该商品的发货数量。
  • grams double
    重量，单位：g。
  • id string
    商品行快照表的 ID, 由系统生成，与订单号唯一确认一个商品行。
  • name string
    SKU 标题，该字段值和 title 一致。
  • price string
    商品售价，以店铺币种展示。数值保留到小数点后两位。
  • price_setobject
    商品售价，分别以店铺币种金额和买家币种金额展示。
  • presentment_moneyobject
    展示给买家的商品售价信息。
  • amount string
    商品售价，数值保留到小数点后两位。
  • currency_code string
    三位币种码，遵循 ISO 4217 国际标准。
    例子: CNY
  • shop_moneyobject
    商家侧记录的商品售价信息。
  • amount string
    商品售价，数值保留到小数点后两位。
  • currency_code string
    三位币种码，遵循 ISO 4217 国际标准。
    例子: USD
  • product_id string
    款式对应商品的唯一标识 ID。
  • quantity integer
    该商品下单数量。
  • requires_shipping boolean
    商品是否需要发货：
    • true：需要发货
    • false：不需要发货
  • sku string
    商家为款式自定义的标识。
  • tax_linesobject[]
    税费明细列表。
  • price string
    税费，以店铺币种展示。数值保留到小数点后两位。
  • price_setobject
    税费，分别以买家币种和店铺币种展示。
  • presentment_moneyobject
    展示给买家的税费信息。
  • amount string
    税费，数值保留到小数点后两位。
  • currency_code string
    三位币种码，遵循 ISO 4217 国际标准。
    例子: CNY
  • shop_moneyobject
    商家侧记录的税费信息。
  • amount string
    税费，数值保留到小数点后两位。
  • currency_code string
    三位币种码，遵循 ISO 4217 国际标准。
    例子: USD
  • rate string
    税率，该信息只做展示作用。
  • title string
    税费说明标题，该信息只做展示作用。
  • taxable boolean
    该商品是否需要收税：
    • true：需要收税
    • false：不需要收税
  • title string
    商品标题。
  • total_discount string
    营销折扣金额，以店铺币种金额展示，数值保留到小数点后两位。为活动优惠+自定义单品优惠+会员活动抵扣+加其他优惠。
  • total_discount_setobject
    折扣金额，分别以买家币种和店铺币种展示。
  • presentment_moneyobject
    展示给买家的折扣金额信息。
  • amount string
    折扣金额总和，数值保留到小数点后两位。
  • currency_code string
    三位币种码，遵循 ISO 4217 国际标准。
    例子: CNY
  • shop_moneyobject
    商家侧记录的折扣金额信息。
  • amount string
    折扣金额总和，数值保留到小数点后两位。
  • currency_code string
    三位币种码，遵循 ISO 4217 国际标准。
    例子: USD
  • variant_id string
    款式的唯一标识 ID。
  • variant_title string
    商品款式值，多个以 / 分割。
    例子: big/red
  • version string
    商品的版本。
  • name string
    发货单编码。
  • order_id string
    订单号。
  • status string
    发货单状态：
    • success：已发货
    • cancelled：已取消
  • tracking_company string
    废弃：物流公司名称。该字段自 API 版本 v20250601 起已废弃。查看 tracking_info_list 字段。
  • tracking_info_listobject[]
    物流追踪信息列表。
  • tracking_company string
    物流公司名称。
  • tracking_number string
    第三方物流单号。
  • tracking_url string
    物流公司的域名。
  • tracking_number string
    第三方物流单号。
    废弃：该字段自 API 版本 v20250601 起已废弃。查看 tracking_info_list 字段。
  • tracking_numbers array
    第三方物流单号。
    废弃：该字段自 API 版本 v20250601 起已废弃。查看 tracking_info_list 字段。
  • tracking_url string
    废弃：物流公司的域名。该字段自 API 版本 v20250601 起已废弃。查看 tracking_info_list 字段。
  • tracking_urls array
    物流公司的域名。
    废弃：该字段自 API 版本 v20250601 起已废弃。查看 tracking_info_list 字段。
  • updated_at string
    发货单更新时间。格式：ISO 8601。
    例子: 2024-08-31T02:20:26+08:00
API Explorer
https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301

ParamOptions

— path required
— header required

Body

required
{
  "fulfillment": {
    "line_items": [
      {
        "id": 0,
        "quantity": 0
      }
    ],
    "notify_customer": null,
    "tracking_company": null,
    "tracking_info_list": [
      {
        "tracking_company": null,
        "tracking_number": null,
        "tracking_url": null
      }
    ],
    "tracking_number": null,
    "tracking_url": null
  }
}

Language

curl --request POST \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301/orders/order_id/fulfillments.json \
     --header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --header 'accept: application/json'
Examples
创建发货单（基于订单）
Request
{
  "fulfillment": {
    "line_items": [
      {
        "id": 12345678901234,
        "quantity": 1
      }
    ],
    "notify_customer": true,
    "tracking_company": "ABC",
    "tracking_info_list": [
      {
        "tracking_company": "ABC",
        "tracking_number": 123456789012345,
        "tracking_url": "www.example.com"
      }
    ],
    "tracking_number": 1234567890123458600,
    "tracking_url": "www.example.com"
  }
}
Response
{
  "created_at": 1755482822634,
  "id": "***************32539",
  "line_items": [
    {
      "fulfillable_quantity": 0,
      "fulfillment_quantity": 1,
      "fulfillment_status": "fulfilled",
      "grams": 2,
      "id": 10000000,
      "name": "ABC",
      "price": "26.99",
      "price_set": {
        "presentment_money": {
          "amount": "26.99",
          "currency_code": "USD"
        },
        "shop_money": {
          "amount": "26.99",
          "currency_code": "USD"
        }
      },
      "product_id": "********************53575",
      "quantity": 1,
      "requires_shipping": true,
      "sku": "************7YYS",
      "tax_lines": [
        {
          "price": "0.0",
          "price_set": {
            "presentment_money": {
              "amount": "0.0",
              "currency_code": "USD"
            },
            "shop_money": {
              "amount": "0.0",
              "currency_code": "USD"
            }
          },
          "rate": 1,
          "title": "VAT"
        }
      ],
      "taxable": true,
      "title": "ABC",
      "total_discount": "2.7",
      "total_discount_set": {
        "presentment_money": {
          "amount": "2.7",
          "currency_code": "USD"
        },
        "shop_money": {
          "amount": "2.7",
          "currency_code": "USD"
        }
      },
      "variant_id": "*********************833575",
      "variant_title": null,
      "version": "0"
    }
  ],
  "name": "ABC",
  "order_id": "****************342539",
  "status": "success",
  "tracking_company": "ABC",
  "tracking_number": "*********0HGW",
  "tracking_numbers": [
    "*********0HGW"
  ],
  "tracking_url": "www.example.com",
  "tracking_urls": [
    "www.example.com"
  ],
  "updated_at": 1755482822634
}
这篇文章对你有帮助吗？
SHOPLINE
SHOPLINE
SHOPLINE Enterprise
条款协议
隐私
条款
开发者协议
LinkedInEmail
LinkedInEmail
© Copyright 2013-2025 SHOPLINE Limited.