履约创建

Webhookfulfillments/create

发生任意发货操作时触发。

需要 order 访问权限。最低支持版本：202007。

请求头

X-Shoplazza-Topicstring

触发本次推送的事件，例如 orders/create

示例： orders/create

X-Shoplazza-Hmac-Sha256string

请求体的 HMAC-SHA256 签名（base64 编码），使用应用的 Client Secret 生成，用于验证请求来自 Shoplazza

X-Shoplazza-Shop-Domainstring

产生该事件的店铺域名

示例： example.myshoplaza.com

X-Shoplazza-Api-Versionstring

序列化 payload 使用的 API 版本

示例： 2025-06

X-Shoplazza-Deduplication-IDstring

本次推送的去重 ID，同一事件重发时保持不变，用于幂等去重

请求体

数据结构
示例

fulfillment object
idstring
发货记录 ID
order_idstring
订单 ID
statusstring
发货记录状态
created_atstring
创建时间（即发货时间）
updated_atstring
更新时间
tracking_companystring
物流商名称。多个运单见 tracking_items
tracking_company_codestring
物流商编码。多个运单见 tracking_items
tracking_numberstring
运单号。多个运单见 tracking_items
tracking_urlstring
物流跟踪链接。多个运单见 tracking_items
tracking_items object[]
运单列表，支持多个运单场景
Array [
tracking_companystring
物流商名称
tracking_company_codestring
物流商编码
tracking_numberstring
运单号
tracking_urlstring
物流跟踪链接
]
line_items object[]
本次运单发货的商品
Array [
idstring
订单商品记录 ID
product_idstring
商品 ID
product_titlestring
商品标题
product_handlestring
商品 Handle
product_urlstring
商品链接
variant_idstring
子款式 ID
variant_titlestring
子款式标题
skustring
子款式 SKU
spustring
商品 SPU
quantityinteger
购买数量
shipped_quantityinteger
商品本次发货数量
pricestring
商品售价（单价）
compare_at_pricestring
商品原价（单价）
totalstring
商品总价（商品单价 × 购买数量）
duty_pricestring
关税总价
payment_discount_pricestring
分摊的支付优惠金额
discount_applicationsstring
优惠明细数据
fulfillment_statusstring
物流状态
requires_shippingboolean
是否需要物流
weightstring
商品重量
weight_unitstring
重量单位
imagestring
商品图片链接
notestring
商品备注
vendorstring
供应商
custom_propertiesobject
商品自定义属性
properties object[]
商品款式属性
Array [
namestring
款式属性的属性名（如 Color）
valuestring
款式属性的属性值（如 Red）
]
main_currency_prices object
主市场币种金额数据
actual_ratestring
主市场币种兑订单币种的汇率（如值为 7.25，表示 1 主市场币种可兑 7.25 订单币种）
compare_at_pricestring
单件商品的原价（划线价）换算成主市场币种后的金额
pricestring
单件商品的售价换算成主市场币种后的金额
totalstring
该行商品的总价（售价 × 数量）换算成主市场币种后的金额
refund_quantityinteger已弃用
最近一次发起的退款数量（仅退款相关事件返回）。（已废弃：勿用）
refund_totalstring已弃用
累计退款商品售价金额（仅退款相关事件返回）。（已废弃：勿用）
]

{
  "fulfillment": {
    "id": "string",
    "order_id": "string",
    "status": "string",
    "created_at": "string",
    "updated_at": "string",
    "tracking_company": "string",
    "tracking_company_code": "string",
    "tracking_number": "string",
    "tracking_url": "string",
    "tracking_items": [
      {
        "tracking_company": "string",
        "tracking_company_code": "string",
        "tracking_number": "string",
        "tracking_url": "string"
      }
    ],
    "line_items": [
      {
        "id": "string",
        "product_id": "string",
        "product_title": "string",
        "product_handle": "string",
        "product_url": "string",
        "variant_id": "string",
        "variant_title": "string",
        "sku": "string",
        "spu": "string",
        "quantity": 0,
        "shipped_quantity": 0,
        "price": "string",
        "compare_at_price": "string",
        "total": "string",
        "duty_price": "string",
        "payment_discount_price": "string",
        "discount_applications": "string",
        "fulfillment_status": "string",
        "requires_shipping": true,
        "weight": "string",
        "weight_unit": "string",
        "image": "string",
        "note": "string",
        "vendor": "string",
        "custom_properties": {},
        "properties": [
          {
            "name": "string",
            "value": "string"
          }
        ],
        "main_currency_prices": {
          "actual_rate": "string",
          "compare_at_price": "string",
          "price": "string",
          "total": "string"
        }
      }
    ]
  }
}

请求头​

请求体​

请求头

请求体