# 电子面单预取号 > 接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考[接口调用指南](/doc/oplatform/developers/dev/guide.md)。 接口英文名：ewaybill_precreateorder 可通过该接口校验电子面单取号接口的参数，并获取全局唯一的ewaybill_order_id用于真正取号的接口 相关文档： [微信小店「电子面单操作」使用指南](https://store.weixin.qq.com/chengzhang/webdoc/wiki/540/8928bda6d81898f4/growth_center_manual_for_store) [微信小店「电子面单取号API接口」调整通知](https://developers.weixin.qq.com/community/minihome/doc/0004aab9c6cd10430b441c27566801) ## 1. 调用方式 ### HTTPS 调用 ```bash POST https://api.weixin.qq.com/channels/ec/logistics/ewaybill/biz/order/precreate?access_token=ACCESS_TOKEN ``` ### 云调用 - 本接口不支持云调用。 ### 第三方调用 - 本接口支持第三方平台代供货商调用。[第三方服务商调用模式介绍](/doc/store/supplier/product/service_market_desc) - 该接口所属的权限集 id 为：130、159、192 - 服务商获得其中之一权限集授权后，可通过使用 [authorizer_access_token](/doc/oplatform/developers/dev/AuthorizerAccessToken.md) 代供货商进行调用，具体可查看 [第三方调用](/doc/oplatform/Third-party_Platforms/2.0/Before_Develop/call_interface.md) 说明文档。 ## 2. 请求参数 ### 查询参数 `Query String Parameters` ```json [ { "参数名": "access_token", "类型": "string", "必填": "是", "示例": "ACCESS_TOKEN", "说明": "接口调用凭证，可使用 [access_token](/doc/store/supplier/api/basics/api_getaccesstoken)（供货商）、[authorizer_access_token](/doc/oplatform/openApi/ticket-token/api_getauthorizeraccesstoken.md)（服务商代调用）" } ] ``` ### 请求体 `Request Payload` ```json [ { "参数名": "delivery_id", "类型": "string", "必填": "是", "说明": "快递公司id" }, { "参数名": "site_code", "类型": "string", "必填": "否", "说明": "网点编码" }, { "参数名": "ewaybill_acct_id", "类型": "string", "必填": "是", "说明": "物流账号客户编码：每绑定一个物流商网点/月结账号分配一个acct_id" }, { "参数名": "sender", "类型": "object", "必填": "是", "说明": "寄件人,传明文" }, { "参数名": "ec_order_list", "类型": "objarray", "必填": "是", "说明": "代发单信息/供货单信息" }, { "参数名": "remark", "类型": "string", "必填": "否", "说明": "备注" }, { "参数名": "shop_id", "类型": "string", "必填": "是", "说明": "面单主体ID：每个供货商分配的唯一shop_id（从ewaybill_getacct接口获取）" } ] ``` ### Body.sender `Object Payload` 寄件人,传明文 ```json [ { "参数名": "name", "类型": "string", "必填": "是", "说明": "人名" }, { "参数名": "mobile", "类型": "string", "必填": "是", "说明": "联系电话" }, { "参数名": "province", "类型": "string", "必填": "是", "说明": "省" }, { "参数名": "city", "类型": "string", "必填": "是", "说明": "市" }, { "参数名": "county", "类型": "string", "必填": "是", "说明": "区" }, { "参数名": "street", "类型": "string", "必填": "是", "说明": "街道" }, { "参数名": "address", "类型": "string", "必填": "是", "说明": "详细地址" } ] ``` "> ### Body.ec_order_list(Array) `Object Payload` 代发单信息/供货单信息 ```json [ { "参数名": "ds_order_id", "类型": "number", "必填": "是", "说明": "代发单id" }, { "参数名": "supply_order_id", "类型": "number", "必填": "是", "说明": "供货单id（与代发单二者必传其一）" }, { "参数名": "goods_list", "类型": "objarray", "必填": "是", "说明": "代发单/供货单货品信息" } ] ``` __goods_list"> ### Body.ec_order_list(Array).goods_list `Object Payload` 代发单/供货单货品信息 ```json [ { "参数名": "good_name", "类型": "string", "必填": "是", "说明": "货品名" }, { "参数名": "good_count", "类型": "number", "必填": "是", "说明": "货品个数" }, { "参数名": "product_id", "类型": "number", "必填": "否", "说明": "货品product_id" }, { "参数名": "sku_id", "类型": "number", "必填": "是", "说明": "货品sku_id" } ] ``` ## 3. 返回参数 ### 返回体 `Response Payload` ```json [ { "参数名": "errcode", "类型": "number", "说明": "错误码" }, { "参数名": "errmsg", "类型": "string", "说明": "错误信息" }, { "参数名": "ewaybill_order_id", "类型": "string", "说明": "电子面单订单id，用于取号接口请求参数" } ] ``` ## 4. 注意事项 ## 5. 代码示例 请求示例 ```json { "delivery_id": "xxxx", "site_code": "1111", "ewaybill_acct_id": "1111", "sender": { "name": "test", "mobile": "1111", "province": "静安区", "city": "上海市", "county": "静安区", "street": "xxxxx", "address": "xxxxxx" }, "receiver": { // 供货商代发单无需上传receiver字段 "name": "test", "mobile": "11111", "province": "上海市", "city": "上海市", "county": "青浦区", "street": "xxxx", "address": "xxxxxxx" }, "ec_order_list": [{ "ec_order_id": 1111, // 供货商代发单为ds_order_id "goods_list": [{ "good_name": "电子资料书，", "good_count": 1, "product_id": 111, "sku_id": 11 }] }], "remark": "test", "shop_id": "xxxx" } ``` 返回示例 ```json { "errcode": 0, "errmsg": "ok", "ewaybill_order_id":"111" } ``` ## 6. 错误码 以下是本接口的错误码列表，其他错误码可参考 [通用错误码](/doc/store/shop/dev_before/commErrCode.md)；调用接口遇到报错，可使用官方提供的 [API 诊断工具](https://developers.weixin.qq.com/console/devtools/debug?utm_source=api_errcode) 辅助定位和分析问题。 ```json [ { "错误码": "10025012", "错误描述": "delivery_id错误", "解决方案": "" }, { "错误码": "10025013", "错误描述": "网点信息错误", "解决方案": "" }, { "错误码": "10025014", "错误描述": "网点账号编码错误", "解决方案": "" }, { "错误码": "10025015", "错误描述": "寄件人信息错误", "解决方案": "" }, { "错误码": "10025016", "错误描述": "收件人信息错误", "解决方案": "" }, { "错误码": "10025017", "错误描述": "小店订单信息错误", "解决方案": "" }, { "错误码": "10025018", "错误描述": "shop_id信息错误", "解决方案": "" }, { "错误码": "10025026", "错误描述": "单个订单取号次数超过100次", "解决方案": "" }, { "错误码": "10025087", "错误描述": "不满足[「跨店铺取号代发」条件](https://store.weixin.qq.com/chengzhang/webdoc/wiki/8469/5f00c2182495bdfd/growth_center_platform_notice?bpath=%252Fnotice)，当前为提醒阶段，当日仍可继续取号。超过提醒阶段后，平台将限制取号", "解决方案": "①代发场景，可切换至官方代发工具 ②关联店群场景，可根据站内信指引完成店铺关联" }, { "错误码": "10025088", "错误描述": "不满足[「跨店铺取号代发」条件](https://store.weixin.qq.com/chengzhang/webdoc/wiki/8469/5f00c2182495bdfd/growth_center_platform_notice?bpath=%252Fnotice)，无法继续取号", "解决方案": "①代发场景，可切换至官方代发工具 ②关联店群场景，可根据站内信指引完成店铺关联" } ] ``` ## 7. 适用范围 本接口在不同账号类型下的可调用情况： ```json [ { "微信小店": "✔", "小店供货商": "✔" } ] ``` - ✔：该账号可调用此接口。 - 其他未明确声明的账号类型，如无特殊说明，均不可调用此接口。 ![](https://res8.wxqcloud.qq.com.cn/wxdoc/56617deb-b17d-4cf1-bccd-71d2c41ccc76.svg)接口变更日志（5条） 2026 年 05 月 18 日新增 `supply_order_id` 字段，支持供货单预取号 2025 年 12 月 18 日新增错误码10025026 2025 年 12 月 09 日新增错误码枚举 2025 年 11 月 07 日`product_id` 字段调整为非必填