履约单更新
事件分组 | 事件标识 |
---|---|
fulfillment_order | fulfillment_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店铺idExample:
1610418123456
- X-Shopline-Merchant-Id string required商户IDExample:
2000001234
- X-Shopline-API-Version string required版本号Example:
v20210901
- X-Shopline-Webhook-Id string required消息IDExample:
b54557e48a5fbf7d70bcd043
请求体
fulfillment_orderobject
履约详情assigned_locationobject
被分配的地点详情address1 string地址1Example:"Chestnut Street 92"
address2 string地址2Example:"Chestnut Street 92"
city string城市Example:"Louisville"
country string国家Example:"United States"
country_code string国家码Example:"US"
location_id string地址idExample:"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被分配的地点idExample:"5327026538935748524"
delivery_methodobject
履约单配送方式信息max_delivery_date_time string最晚发货时间Example:"2021-05-26T10:00:00-04:00"
method_type string配送方式:local、none、pick_up、retail、shippingExample:"none"
min_delivery_date_time string可发货时间Example:"2021-05-26T10:00:00-04:00"
destinationobject
收货人信息address1 string地址1Example:"Chestnut Street 92"
address2 string地址2Example:"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履约单idExample:"4005740193290131085320"
line_itemsobject[]
商品行信息country_code_of_origin string原产地/发货地的国家代码Example:"US"
fulfillable_quantity string可履约商品数量Example:1
fulfillment_order_id string履约单idExample:"4005740193290131085320"
harmonized_system_code string海关编码Example:"1231"
id string履约单商品行idExample:"1039283"
line_item_id string商品行idExample:"518995019"
quantity long订单商品行商品数量Example:1
shop_id string店铺idExample:"1644828244663"
variant_id string商品skuExample:"18055128824718541486811487"
merchant_requestsobject[]
请求发货信息列表kind string请求类型: ① fulfillment_request ② cancellation_requestExample:"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订单idExample:"21057401932826316666967110"
request_status string履约单请求状态,包括:accepted,cancellation_accepted,cancellation_rejected,cancellation_requested,closed,rejected,submitted,unsubmittedExample:"submitted"
shop_id string店铺idExample:"1644828244663"
status string履约单状态,包括:open,in_progress,closed,cancelled,incomplete,on_hold,scheduledExample:"open"
supported_actions array履约单支持的操作,包括:create_fulfillment -- 创建发货,move -- 移动到新地点,hold -- 暂停发货,release_hold -- (暂停之后)开始发货Example:"release_hold"
响应
收到 SHOPLINE 发送的 Webhook 通知后,你需要按照如下 SHOPLINE 要求的格式进行响应。
HTTP/1.1 200 OK
关于如何订阅 Webhooks 及更多 Webhook 响应规则说明,请参考 Webhook 概述。
这篇文章对你有帮助吗?