轻易云
注册体验
POSThttps://dopen.weimob.com/api/1_0/weimob_shop/order/list/searchaccess_token(accesstoken query 参数)

订单列表搜索(weimob_shop/order/list/search)

微盟商城订单列表搜索接口,按时间、状态、订单号等条件分页查询订单,是微盟店铺订单同步进 ERP 与财务对账的取数口。

来源：https://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=1510&id=3282&isold=2
## 接口说明 weimob_shop/order/list/search(v2.0)按条件分页搜索微盟商城订单,返回订单编号(orderNo)、状态、金额、买家信息及商品明细。配套接口 weimob_shop/order/detail/get 按订单号查完整详情。调用前需在微盟云控制台申请该 API 能力。 ### 请求要点 1. POST + application/json;access_token 以 accesstoken 参数拼在 URL query 上。 2. body 查询参数:pageNum/pageSize 分页;createStartTime/createEndTime(下单时间窗口)、orderNo(精确查)、statuses(订单状态数组)等条件按需传入。 3. 响应 code.errcode 为 "0" 时,data.pageList 为订单数组,data.totalCount 为总条数;订单号可作为 detail/get 的入参拉取明细行(商品、实付、优惠、运费)。 4. 增量同步以创建时间窗口推进并重叠数分钟;大促期间按小时切片,防止单窗口超出翻页上限。 ### 对账场景 微盟店铺的实收金额、运费、优惠分摊,与微信/支付宝账单、ERP 应收做三单匹配;轻易云对账方案以 orderNo 为关联键,差异单自动归类(金额差/缺单/状态差)。 ### 金额字段口径 微盟订单金额分商品总额、优惠、运费、实付多段,优惠可能同时包含平台券与店铺券,分摊到明细行的规则以接口文档为准;写入财务系统前先与财务确认取“实付”还是“商品总额减店铺优惠”的口径,否则与微信/支付宝账单核对时会出现系统性差额,被误判为对账异常。

代码示例

curl
curl -X POST "https://dopen.weimob.com/api/1_0/weimob_shop/order/list/search?accesstoken=TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"pageNum":1,"pageSize":50,"createStartTime":1780000000000,"createEndTime":1780003600000}'

错误码

错误码消息含义
0success成功
token_invalidaccesstoken 无效token 过期或未按店铺维度获取,重新换取
api_not_granted无接口权限未在控制台申请该 API 能力