履约单列表查询

需要 read_assigned_fulfillment_orders 权限点。
更多权限点使用信息，请参考：
访问权限。
GET https://{handle}.myshopline.com/admin/openapi/v20261201/fulfillment_orders/fulfillment_orders_search.json
handle ：店铺的唯一标识符，值为店铺域名的前缀。例如，域名为 open001.myshopline.com 的店铺，其 handle 是 open001 。
搜索履约单列表
查询参数
  • assignment_status string
    请求状态
    例子: "unsubmitted"
  • limit integer
    查询的数据数量，默认20，最大100条
    例子: 10
  • location_ids string
    地点id列表
    例子: "24826418,24826411"
  • page_info string
    分页查询的唯一标识，用于定位特定页面。
    该字段值需要在你已经查询完分页信息后，在该接口响应头中的 link 字段值中获取。例如，你获取到的 link 的值为 <https://{handle}.myshopline.com/admin/openapi/{version}/fulfillment_orders/fulfillment_orders_search.json?limit=1&page_info=eyJzaW5jZUlkIjoiMTYwNTc1OTAxNTM4OTA4Mjk1MjExMTI3ODgiLCJkaXJlY3Rpb24iOiJuZXh0IiwibGltaXQiOjF9>; rel="next" ，那么 page_info 的值为 eyJzaW5jZUlkIjoiMTYwNTc1OTAxNTM4OTA4Mjk1MjExMTI3ODgiLCJkaXJlY3Rpb24iOiJuZXh0IiwibGltaXQiOjF9 。
    关于更多如何使用分页信息，请参考 分页机制。
    例子: "7AFD7393C6E7CF18672C038477E2EF6A463464BDBAF766DD8F8CB8E0085F82419A94B80084BCDA0B838B3F13C302A2C9044E"
  • since_id string
    要查询的数据的订单号id的起始位置
    例子: "21056199447626881527947685"
请求头
  • Content-Type string required
    字段值固定为 application/json; charset=utf-8。
  • Authorization string required
    资源的访问令牌。参考 应用授权 获取访问令牌，然后将获取到的访问令牌以 Bearer 格式传入。
    例子:
    Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhcHBJZCI6MCwiYXBwS2V5IjoiNzU2ZjI1NWE2NjdlZTcwNTk1MzM0ZjVjYzk4NzU5MzBmN2E3NGZjMSIsImV4cCI6MTg3OTQ4MjA3NiwiaXNzIjoieXNvdWwiLCJzZWxsZXJJZCI6IjIwMDAyMzQ4ODAiLCJzdG9yZUlkIjoiMTY3MjM2OTcyOTYwNiIsInRpbWVzdGFtcCI6MTc4NDc4NzY3NjY2MSwidmVyc2lvbiI6IlYyIn0.3ZzbGAH4cLU1QR2VPEvMOQInUDvus-C4amkINSQIPuNVlXsFKj0sAt1c0KnUy9MWUOFV9cHlkf7J90r2y1FzpA
状态码
更多状态码信息，参考 HTTP 状态码。
响应头
  • link
    提供分页数据的 URL 链接。你可以获取该字段值中的 page_info 信息用于下一次分页请求中。
    当你请求的页面存在上一页或下一页的时候，该字段会被返回。关于更多如何使用分页信息，请参考 分页机制。
  • traceId
    请求的全局唯一标识符。用于追踪请求在系统中的流转，以便于问题发生时进行定位和调试。
响应体
  • fulfillment_ordersobject[]
    数据列表
  • merchant_requestsobject[]
    请求发货时的具体信息列表
  • notify_customer boolean
    发货时是否通知客户
    例子: true
  • created_at string
    发生时间，（格式见IOS8601）
    例子: 2023-04-12T22:59:52+08:00
  • kind string
    第三方请求状态,包括： submit：fulfillment_request，cancellation_requested，cancellation_reques
    例子: submit
  • message string
    备注
    例子: none
  • assigned_location_id string
    被分配的地点id
    例子: 5668167071852661850
  • shop_id string
    店铺id
    例子: 541380002
  • fulfill_at string
    可发货时间（格式见IOS8601）
    例子: 2023-04-12T22:59:52+08:00
  • line_itemsobject[]
    履约商品列表
  • fulfillable_quantity long
    可履约商品数量
    例子: 1
  • harmonized_system_code string
    海关编码
    例子: 121
  • country_code_of_origin string
    原产地/发货地的国家代码
    例子: US
  • line_item_id string
    商品行id
    例子: 40057889
  • id string
    履约单商品表id
    例子: 400574123
  • quantity long
    商品行对应商品数量
    例子: 1
  • variant_id string
    商品sku序列号
    例子: 156223761
  • fulfillment_order_id string
    履约单id
    例子: 4005740193290131085320
  • shop_id string
    店铺id
    例子: 541380002
  • request_status string
    请求状态，包括：unsubmitted，submitted，rejected，closed，cancellation_requested，cancellation_rejected，cancellation_accepted，accepted
    例子: unsubmitted
  • order_id string
    订单id
    例子: 21057116277667827637773776
  • supported_actions array
    履约单支持的操作
    例子: ["\"create_fulfillment\""]
  • destinationobject
    收货人地址
  • delivery_store_name string
    本地配送门店名称，仅本地配送时提供
    例子: Napo Shop
  • province_code string
    州或是省编码，IOS 3166-2编码
    例子: KY
  • company string
    公司
    例子: LLL
  • address1 string
    地址1
    例子: Chestnut Street 12
  • phone string
    电话号码
    例子: 18883290137
  • last_name string
    lastName
  • city string
    城市
    例子: Louisville
  • address2 string
    地址2
    例子: Chestnut Street 13
  • country_code string
    国家或地区编码
    例子: CA
  • province string
    州省名称
    例子: Kentucky
  • email string
    邮箱
    例子: sswe.t@mail.example.com
  • first_name string
    firstName
    例子: Jack
  • country string
    国家或地区名称
    例子: Canada
  • name string
    顾客姓名
    例子: Jack Wang
  • delivery_store_code string
    本地配送门店id，仅本地配送时提供
    例子: A121
  • id string
    唯一编码
    例子: 1046000771
  • display_status string
    到店取货场景下才赋值。如果不是到店取货，或者是到店取货-未取货状态都返回null
    例子: Picked up
  • id string
    履约单id
    例子: 4005740193290131085320
  • status string
    履约单状态，包括：open，in_progress，closed，cancelled，incomplete，on_hold，scheduled
    例子: open
  • assigned_locationobject
    被分配到的地点详情
  • name string
    地点名称
    例子: Ottawa Store
  • address2 string
    地址2
    例子: Unit 42
  • location_id string
    地点id
    例子: 5668167071852661850
  • province string
    省份
    例子: Ontario
  • city string
    城市
    例子: Ottawa
  • country_code string
    国家或是地区编码
    例子: CA
  • country string
    国家或是地区名称
    例子: Canada
  • phone string
    电话号码
    例子: 18883290139
  • zip string
    邮编
    例子: A1B 2C3
  • address1 string
    地址1
    例子: 126 York Street
  • delivery_method string
    物流方式，包括：shipping、pickup、local_delivery、none
    例子: none
  • fulfillment_holdsobject[]
    暂停信息
  • reason_note string
    暂停备注
    例子: something wrong
  • reason string
    暂停原因
    例子: something wrong
  • fulfill_by string
    最晚发货时间（格式见IOS8601）
    例子: 2023-04-12T22:59:52+08:00
API Explorer
https://openapiceshidianpu.myshopline.com/admin/openapi/v20261201

ParamOptions

— header required
— query
— query
— query
— query
— query

Language

curl --request GET \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20261201/fulfillment_orders/fulfillment_orders_search.json \
     --header 'Authorization: Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhcHBJZCI6MCwiYXBwS2V5IjoiNzU2ZjI1NWE2NjdlZTcwNTk1MzM0ZjVjYzk4NzU5MzBmN2E3NGZjMSIsImV4cCI6MTg3OTQ4MjA3NiwiaXNzIjoieXNvdWwiLCJzZWxsZXJJZCI6IjIwMDAyMzQ4ODAiLCJzdG9yZUlkIjoiMTY3MjM2OTcyOTYwNiIsInRpbWVzdGFtcCI6MTc4NDc4NzY3NjY2MSwidmVyc2lvbiI6IlYyIn0.3ZzbGAH4cLU1QR2VPEvMOQInUDvus-C4amkINSQIPuNVlXsFKj0sAt1c0KnUy9MWUOFV9cHlkf7J90r2y1FzpA' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --header 'accept: application/json'
这篇文章对你有帮助吗？
SHOPLINE
SHOPLINE
SHOPLINE Enterprise
条款协议
隐私
条款
开发者协议
LinkedInEmail
LinkedInEmail
© Copyright 2013-2026 SHOPLINE Limited.