# 查询面单详情 > 接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考[接口调用指南](/doc/oplatform/developers/dev/guide.md)。 接口英文名：ewaybill_getorder 可通过该接口查询电子面单详情。 相关事件通知：[物流轨迹推送通知](/doc/store/supplier/notify/merchant_callback/ewaybill_push_path) 相关文档： [微信小店「电子面单操作」使用指南](https://store.weixin.qq.com/chengzhang/webdoc/wiki/540/8928bda6d81898f4/growth_center_manual_for_store) ## 1. 调用方式 ### HTTPS 调用 ```bash POST https://api.weixin.qq.com/channels/ec/logistics/ewaybill/biz/order/get?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 [ { "参数名": "ewaybill_order_id", "类型": "string", "必填": "是", "示例": "11111", "说明": "电子面单订单id，全局唯一id" } ] ``` ## 3. 返回参数 ### 返回体 `Response Payload` ```json [ { "参数名": "errcode", "类型": "number", "说明": "错误码" }, { "参数名": "errmsg", "类型": "string", "说明": "错误信息" }, { "参数名": "order_info", "类型": "object", "说明": "电子面单列表" } ] ``` ### Res.order_info `Object Payload` 电子面单列表 ```json [ { "参数名": "ewaybill_order_id", "类型": "string", "说明": "电子面单订单id，全局唯一id", "枚举": "-" }, { "参数名": "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", "枚举": "-" }, { "参数名": "waybill_id", "类型": "string", "说明": "快递单号", "枚举": "-" }, { "参数名": "status", "类型": "number", "说明": "状态，电子面单状态", "枚举": "枚举值" }, { "参数名": "path_info", "类型": "objarray", "说明": "轨迹信息", "枚举": "-" }, { "参数名": "order_type", "类型": "number", "说明": "订单类型", "枚举": "枚举值" }, { "参数名": "monthly_card", "类型": "string", "说明": "月结账号", "枚举": "-" }, { "参数名": "order_vas_list", "类型": "objarray", "说明": "保价等增值服务", "枚举": "-" }, { "参数名": "ext_info", "类型": "object", "说明": "温层等补充字段", "枚举": "-" } ] ``` ### Res.order_info.sender `Object Payload` 寄件人 ```json [ { "参数名": "name", "类型": "string", "说明": "人名" }, { "参数名": "mobile", "类型": "string", "说明": "联系电话" }, { "参数名": "province", "类型": "string", "说明": "省" }, { "参数名": "city", "类型": "string", "说明": "市" }, { "参数名": "county", "类型": "string", "说明": "区" }, { "参数名": "street", "类型": "string", "说明": "街道" }, { "参数名": "address", "类型": "string", "说明": "详细地址" } ] ``` ### Res.order_info.receiver `Object Payload` ```json [ { "参数名": "name", "类型": "string", "说明": "人名" }, { "参数名": "mobile", "类型": "string", "说明": "联系电话" }, { "参数名": "province", "类型": "string", "说明": "省" }, { "参数名": "city", "类型": "string", "说明": "市" }, { "参数名": "county", "类型": "string", "说明": "区" }, { "参数名": "street", "类型": "string", "说明": "街道" }, { "参数名": "address", "类型": "string", "说明": "详细地址" } ] ``` "> ### Res.order_info.ec_order_list(Array) `Object Payload` 代发单信息 ```json [ { "参数名": "ds_order_id", "类型": "number", "说明": "代发单id" }, { "参数名": "goods_list", "类型": "objarray", "说明": "代发单商品信息" } ] ``` __goods_list"> ### Res.order_info.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" } ] ``` "> ### Res.order_info.path_info(Array) `Object Payload` 轨迹信息 ```json [ { "参数名": "status", "类型": "number", "说明": "轨迹状态", "枚举": "枚举值" }, { "参数名": "desc", "类型": "string", "说明": "轨迹描述", "枚举": "-" }, { "参数名": "update_time", "类型": "number", "说明": "更新时间", "枚举": "-" } ] ``` "> ### Res.order_info.order_vas_list(Array) `Object Payload` 保价等增值服务 ```json [ { "参数名": "vas_type", "类型": "string", "说明": "增值服务类型，目前支持的增值服务", "枚举": "枚举值" }, { "参数名": "vas_value", "类型": "string", "说明": "增值服务描述", "枚举": "-" }, { "参数名": "vas_detail", "类型": "string", "说明": "增值服务值, 涉及金额单位一律为分", "枚举": "-" } ] ``` ### Res.order_info.ext_info `Object Payload` 温层等补充字段 ```json [ { "参数名": "temperature_range", "类型": "number", "说明": "温层信息，京东专用\n0或不传则为月结账号的默认温层信息\n1:普通/常温\n5:鲜活\n6:控温\n7:冷藏\n8:冷冻\n9:深冷" } ] ``` ## 4. 枚举信息 ### Res.order_info.status `Enum` 状态，电子面单状态 ```json [ { "枚举值": "1", "描述": "下单成功" }, { "枚举值": "2", "描述": "取消" }, { "枚举值": "3", "描述": "已打单" }, { "枚举值": "4", "描述": "已发货" } ] ``` ### Res.order_info.order_type `Enum` 订单类型 ```json [ { "快递公司": "JD", "枚举值": "-", "枚举解释": "-" }, { "快递公司": "JD", "枚举值": "1", "枚举解释": "京东标快" }, { "快递公司": "JD", "枚举值": "2", "枚举解释": "京东快送" }, { "快递公司": "JD", "枚举值": "3", "枚举解释": "生鲜标快" }, { "快递公司": "JD", "枚举值": "4", "枚举解释": "生鲜特快" }, { "快递公司": "JD", "枚举值": "5", "枚举解释": "电商特惠" }, { "快递公司": "JD", "枚举值": "6", "枚举解释": "特惠包裹" }, { "快递公司": "JD", "枚举值": "7", "枚举解释": "特惠小件" }, { "快递公司": "JD", "枚举值": "8", "枚举解释": "函速达" }, { "快递公司": "JD", "枚举值": "11", "枚举解释": "特快零担" }, { "快递公司": "JD", "枚举值": "12", "枚举解释": "特快重货" }, { "快递公司": "SF", "枚举值": "-", "枚举解释": "[顺丰产品详情](https://open.sf-express.com/developSupport/734349?activeIndex=324604)" }, { "快递公司": "SF", "枚举值": "1", "枚举解释": "顺丰特快" }, { "快递公司": "SF", "枚举值": "2", "枚举解释": "顺丰标快" }, { "快递公司": "SF", "枚举值": "6", "枚举解释": "顺丰即日" }, { "快递公司": "SF", "枚举值": "10", "枚举解释": "国际小包" }, { "快递公司": "SF", "枚举值": "23", "枚举解释": "顺丰国际特惠(文件)" }, { "快递公司": "SF", "枚举值": "24", "枚举解释": "顺丰国际特惠(包裹)" }, { "快递公司": "SF", "枚举值": "60", "枚举解释": "顺丰特快（文件）" }, { "快递公司": "SF", "枚举值": "144", "枚举解释": "当日配-门(80CM/1KG以内)" }, { "快递公司": "SF", "枚举值": "199", "枚举解释": "特快包裹" }, { "快递公司": "SF", "枚举值": "201", "枚举解释": "冷运标快" }, { "快递公司": "SF", "枚举值": "231", "枚举解释": "陆运包裹" }, { "快递公司": "SF", "枚举值": "242", "枚举解释": "丰网速运" }, { "快递公司": "SF", "枚举值": "247", "枚举解释": "电商标快" }, { "快递公司": "SF", "枚举值": "249", "枚举解释": "丰礼遇" }, { "快递公司": "SF", "枚举值": "255", "枚举解释": "顺丰卡航" }, { "快递公司": "SF", "枚举值": "263", "枚举解释": "同城半日达" }, { "快递公司": "SF", "枚举值": "266", "枚举解释": "顺丰空配（新）" }, { "快递公司": "SF", "枚举值": "283", "枚举解释": "填仓标快" }, { "快递公司": "SF", "枚举值": "285", "枚举解释": "填舱电标" }, { "快递公司": "SF", "枚举值": "303", "枚举解释": "专享急件" }, { "快递公司": "SF", "枚举值": "304", "枚举解释": "特早达" }, { "快递公司": "SF", "枚举值": "323", "枚举解释": "电商微小件" }, { "快递公司": "SF", "枚举值": "325", "枚举解释": "温控包裹" }, { "快递公司": "EMS", "枚举值": "-", "枚举解释": "-" }, { "快递公司": "EMS", "枚举值": "1", "枚举解释": "特快专递（EMS）" }, { "快递公司": "EMS", "枚举值": "2", "枚举解释": "快递包裹（youzhengguonei）" }, { "快递公司": "EMS", "枚举值": "3", "枚举解释": "邮政电商标快（yzdsbk）" }, { "快递公司": "DBKD", "枚举值": "-", "枚举解释": "-" }, { "快递公司": "DBKD", "枚举值": "1", "枚举解释": "大件快递3.60" }, { "快递公司": "DBKD", "枚举值": "2", "枚举解释": "标准快递" }, { "快递公司": "DBKD", "枚举值": "3", "枚举解释": "特快专递" }, { "快递公司": "DBKD", "枚举值": "4", "枚举解释": "航空大件隔日达" }, { "快递公司": "DBKD", "枚举值": "5", "枚举解释": "特快次日" }, { "快递公司": "DBKD", "枚举值": "6", "枚举解释": "重包入户" }, { "快递公司": "DBKD", "枚举值": "7", "枚举解释": "精准卡航(新)" }, { "快递公司": "DBKD", "枚举值": "8", "枚举解释": "精准重货(新)" }, { "快递公司": "DBKD", "枚举值": "9", "枚举解释": "精准汽运(新)" }, { "快递公司": "KYSY", "枚举值": "-", "枚举解释": "-" }, { "快递公司": "KYSY", "枚举值": "1", "枚举解释": "当天达" }, { "快递公司": "KYSY", "枚举值": "2", "枚举解释": "次日达" }, { "快递公司": "KYSY", "枚举值": "3", "枚举解释": "隔日件" }, { "快递公司": "KYSY", "枚举值": "4", "枚举解释": "陆运件" }, { "快递公司": "KYSY", "枚举值": "5", "枚举解释": "空运" }, { "快递公司": "KYSY", "枚举值": "6", "枚举解释": "专运" }, { "快递公司": "KYSY", "枚举值": "7", "枚举解释": "省内次日" }, { "快递公司": "KYSY", "枚举值": "8", "枚举解释": "省内即日" }, { "快递公司": "KYSY", "枚举值": "9", "枚举解释": "同城次日" }, { "快递公司": "KYSY", "枚举值": "10", "枚举解释": "同城即日" } ] ``` __status"> ### Res.order_info.path_info(Array).status `Enum` 轨迹状态 ```json [ { "枚举值": "0", "描述": "待揽件" }, { "枚举值": "1", "描述": "揽收" }, { "枚举值": "2", "描述": "运输中" }, { "枚举值": "3", "描述": "派件" }, { "枚举值": "4", "描述": "入柜" }, { "枚举值": "5", "描述": "签收" }, { "枚举值": "6", "描述": "退回" }, { "枚举值": "7", "描述": "转寄" }, { "枚举值": "8", "描述": "异常" }, { "枚举值": "9", "描述": "出柜" }, { "枚举值": "99", "描述": "其他未知" } ] ``` __vas_type"> ### Res.order_info.order_vas_list(Array).vas_type `Enum` 增值服务类型，目前支持的增值服务 ```json [ { "快递公司": "SF", "vas_type": "INSURE", "vas_detail": "基础保", "vas_value": "{\"value\":\"500\"}" }, { "快递公司": "SF", "vas_type": "IN160", "vas_detail": "定额保", "vas_value": "{\"value\":\"500\"}" }, { "快递公司": "SF", "vas_type": "IN159", "vas_detail": "足额保", "vas_value": "{\"value\":\"500\"}" }, { "快递公司": "SF", "vas_type": "IN67", "vas_detail": "纸箱", "vas_value": "-" }, { "快递公司": "CNSD", "vas_type": "VA002", "vas_detail": "标准保价", "vas_value": "保价金额，单位：分" }, { "快递公司": "DBKD", "vas_type": "insuranceValue", "vas_detail": "保价", "vas_value": "保价金额，单位：分" }, { "快递公司": "STO", "vas_type": "INSURE_SERVICE", "vas_detail": "保价业务", "vas_value": "保价金额，单位：分" }, { "快递公司": "JD", "vas_type": "1", "vas_detail": "普通保价-快递", "vas_value": "保价金额，单位：分" }, { "快递公司": "JD", "vas_type": "2", "vas_detail": "包装", "vas_value": "-" }, { "快递公司": "EMS", "vas_type": "insuranceFlag", "vas_detail": "保价", "vas_value": "保价金额，单位：分" }, { "快递公司": "ZTO", "vas_type": "SVC-INSURE", "vas_detail": "保价", "vas_value": "保价金额，单位：分" }, { "快递公司": "KYSY", "vas_type": "INSURE", "vas_detail": "保价", "vas_value": "保价金额，单位：分" } ] ``` ## 5. 注意事项 ## 6. 代码示例 请求示例 ```json { "ewaybill_order_id":"11111" } ``` 返回示例 ```json { "errcode": 0, "errmsg": "ok", "order_info": { "ewaybill_order_id": "1111", "delivery_id": "xxxx", "site_code": "1111", "ewaybill_acct_id": "1111", "sender": { "name": "test", "mobile": "1111", "province": "静安区", "city": "上海市", "county": "静安区", "street": "xxxxx", "address": "xxxxxx" }, "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", "waybill_id": "xxxx", "status": 2, "path_info": [{ "update_time": 11, "status": 1, "desc": "xxxx" }] } } ``` ## 7. 错误码 以下是本接口的错误码列表，其他错误码可参考 [通用错误码](/doc/store/shop/dev_before/commErrCode.md)；调用接口遇到报错，可使用官方提供的 [API 诊断工具](https://developers.weixin.qq.com/console/devtools/debug?utm_source=api_errcode) 辅助定位和分析问题。 ```json [ { "错误码": "10025010", "错误描述": "面单不存在" } ] ``` ## 8. 适用范围 本接口在不同账号类型下的可调用情况： ```json [ { "微信小店": "✔", "小店供货商": "✔" } ] ``` - ✔：该账号可调用此接口。 - 其他未明确声明的账号类型，如无特殊说明，均不可调用此接口。