事件分组事件标识
fulfillment_orderfulfillment_order/update
履约单更新事件
请求头
  • X-Shopline-Topic string required
    事件操作标识
    Example: orders/edited
  • X-Shopline-Hmac-Sha256 string required
    签名
    Example: XWmrwMey6OsLMeiZKwP4FppHH3cmAiiJJAweH5Jo4bM=
  • X-Shopline-Shop-Domain string required
    店铺域名
    Example: shophub.myshopline.com
  • X-Shopline-Shop-Id string required
    店铺id
    Example: 1610418123456
  • X-Shopline-Merchant-Id string required
    商户ID
    Example: 2000001234
  • X-Shopline-API-Version string required
    版本号
    Example: v20210901
  • X-Shopline-Webhook-Id string required
    消息ID
    Example: b54557e48a5fbf7d70bcd043
请求体
  • fulfillment_orderobject
    履约详情
  • assigned_locationobject
    被分配的地点详情
  • address1 string
    地址1
    Example: "Chestnut Street 92"
  • address2 string
    地址2
    Example: "Chestnut Street 92"
  • city string
    城市
    Example: "Louisville"
  • country string
    国家
    Example: "United States"
  • country_code string
    国家码
    Example: "US"
  • location_id string
    地址id
    Example: "5327026538935748524"
  • name string
    名称
    Example: "Apple Api Shipwire"
  • phone string
    手机
    Example: "+1(502)-459-3417"
  • province string
    省份
    Example: "Kentucky"
  • zip string
    邮编
    Example: "40202"
  • assigned_location_id string
    被分配的地点id
    Example: "5327026538935748524"
  • delivery_methodobject
    履约单配送方式信息
  • max_delivery_date_time string
    最晚发货时间
    Example: "2021-05-26T10:00:00-04:00"
  • method_type string
    配送方式:local、none、pick_up、retail、shipping
    Example: "none"
  • min_delivery_date_time string
    可发货时间
    Example: "2021-05-26T10:00:00-04:00"
  • destinationobject
    收货人信息
  • address1 string
    地址1
    Example: "Chestnut Street 92"
  • address2 string
    地址2
    Example: "Chestnut Street 92"
  • city string
    城市
    Example: "Louisville"
  • company string
    公司
    Example: "Apple inc"
  • country string
    国家
    Example: "US"
  • country_code string
    国家码
    Example: "US"
  • delivery_store_code string
    本地配送门店id,仅本地配送时提供
    Example: "A121"
  • delivery_store_name string
    本地配送门店名称,仅本地配送时提供
    Example: "Napo Shop"
  • email string
    邮箱
    Example: "bob.norman@mail.example.com"
  • first_name string
    名称
    Example: "Bob"
  • last_name string
    姓氏
    Example: "Norman"
  • name string
    姓名
    Example: "Bob Norman"
  • phone string
    手机
    Example: "+1(502)-459-3417"
  • province string
    省份
    Example: "Kentucky"
  • province_code string
    州或是省编码,IOS 3166-2编码
    Example: "KY"
  • zip string
    邮编
    Example: "40202"
  • fulfillment_holdsobject[]
    暂停信息
  • reason string
    暂停原因
    Example: "out of stock"
  • reason_note string
    暂停备注
    Example: "customer require"
  • id string
    履约单id
    Example: "4005740193290131085320"
  • line_itemsobject[]
    商品行信息
  • country_code_of_origin string
    原产地/发货地的国家代码
    Example: "US"
  • fulfillable_quantity string
    可履约商品数量
    Example: 1
  • fulfillment_order_id string
    履约单id
    Example: "4005740193290131085320"
  • harmonized_system_code string
    海关编码
    Example: "1231"
  • id string
    履约单商品行id
    Example: "1039283"
  • line_item_id string
    商品行id
    Example: "518995019"
  • quantity long
    订单商品行商品数量
    Example: 1
  • shop_id string
    店铺id
    Example: "1644828244663"
  • variant_id string
    商品sku
    Example: "18055128824718541486811487"
  • merchant_requestsobject[]
    请求发货信息列表
  • kind string
    请求类型: ① fulfillment_request ② cancellation_request
    Example: "fulfillment_request"
  • message string
    履约发货应用的备注
    Example: "accept"
  • request_optionsobject
    请求参数
  • notify_customer boolean
    是否通知客户
  • send_at string
    请求时间
    Example: "2021-05-26T10:00:00-04:00"
  • order_id string
    订单id
    Example: "21057401932826316666967110"
  • request_status string
    履约单请求状态,包括:accepted,cancellation_accepted,cancellation_rejected,cancellation_requested,closed,rejected,submitted,unsubmitted
    Example: "submitted"
  • shop_id string
    店铺id
    Example: "1644828244663"
  • status string
    履约单状态,包括:open,in_progress,closed,cancelled,incomplete,on_hold,scheduled
    Example: "open"
  • supported_actions array
    履约单支持的操作,包括:create_fulfillment -- 创建发货,move -- 移动到新地点,hold -- 暂停发货,release_hold -- (暂停之后)开始发货
    Example: "release_hold"
响应
收到 SHOPLINE 发送的 Webhook 通知后,你需要按照如下 SHOPLINE 要求的格式进行响应。
HTTP/1.1 200 OK
关于如何订阅 Webhooks 及更多 Webhook 响应规则说明,请参考 Webhook 概述
这篇文章对你有帮助吗?