# 电子面单取号 > 接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考[接口调用指南](/doc/oplatform/developers/dev/guide.md)。 接口英文名：ewaybill_createorder 可通过该接口发起电子面单取号。 相关文档：[微信小店「电子面单操作」使用指南](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/create?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", "必填": "是", "说明": "电子面单订单id，全局唯一id（从预取号接口获取或者自定义）,注意该字段类型用String传递，但是数据内容要求是Uint64", "枚举": "-" }, { "参数名": "delivery_id", "类型": "string", "必填": "是", "说明": "快递公司id，可通过[获取快递公司列表](api_getdeliverycompanylistnew)查询", "枚举": "-" }, { "参数名": "site_code", "类型": "string", "必填": "否", "说明": "网点编码", "枚举": "-" }, { "参数名": "ewaybill_acct_id", "类型": "string", "必填": "是", "说明": "物流账号编码：每绑定一个物流商网点/月结账号分配一个acct_id（从ewaybill_getacct接口获取）", "枚举": "-" }, { "参数名": "sender", "类型": "object", "必填": "是", "说明": "寄件人，传明文", "枚举": "-" }, { "参数名": "ec_order_list", "类型": "objarray", "必填": "是", "说明": "合并寄件的订单需要保证商品订单内address_info.hash_code 一致，避免因为寄件人信息不一致导致订单配送错误\n代发单信息/供货单信息", "枚举": "-" }, { "参数名": "remark", "类型": "string", "必填": "否", "说明": "备注", "枚举": "-" }, { "参数名": "shop_id", "类型": "string", "必填": "是", "说明": "面单主体ID：每个供货商分配的唯一shop_id", "枚举": "-" }, { "参数名": "template_id", "类型": "string", "必填": "否", "说明": "如果需要获取打印报文，则填该字段。回包返回print_info。 如无需使用后台模板，可直接传递template_type做为默认模板， 如‘single’", "枚举": "-" }, { "参数名": "order_type", "类型": "number", "必填": "否", "说明": "支持的类型，陆续更新中，枚举值默认为1，加盟型可以不填", "枚举": "枚举值" }, { "参数名": "order_vas_list", "类型": "objarray", "必填": "否", "说明": "保价等增值服务", "枚举": "-" }, { "参数名": "ext_info", "类型": "object", "必填": "否", "说明": "温层等补充字段", "枚举": "-" }, { "参数名": "delivery_info", "类型": "object", "必填": "否", "说明": "预约上门取件、子母件等发货信息字段", "枚举": "-" } ] ``` ### Body.sender `Object Payload` 寄件人，传明文 ```json [ { "参数名": "name", "类型": "string", "必填": "是", "说明": "人名" }, { "参数名": "mobile", "类型": "string", "必填": "是", "说明": "联系电话" }, { "参数名": "province", "类型": "string", "必填": "是", "说明": "省" }, { "参数名": "city", "类型": "string", "必填": "是", "说明": "市" }, { "参数名": "county", "类型": "string", "必填": "是", "说明": "区" }, { "参数名": "street", "类型": "string", "必填": "是", "说明": "街道(收件人非必填)" }, { "参数名": "address", "类型": "string", "必填": "是", "说明": "详细地址" } ] ``` ### Body.receiver `Object Payload` ```json [ { "参数名": "name", "类型": "string", "必填": "是", "说明": "人名" }, { "参数名": "mobile", "类型": "string", "必填": "是", "说明": "联系电话" }, { "参数名": "province", "类型": "string", "必填": "是", "说明": "省" }, { "参数名": "city", "类型": "string", "必填": "是", "说明": "市" }, { "参数名": "county", "类型": "string", "必填": "是", "说明": "区" }, { "参数名": "street", "类型": "string", "必填": "是", "说明": "街道(收件人非必填)" }, { "参数名": "address", "类型": "string", "必填": "是", "说明": "详细地址" } ] ``` "> ### Body.ec_order_list(Array) `Object Payload` 合并寄件的订单需要保证商品订单内address_info.hash_code 一致，避免因为寄件人信息不一致导致订单配送错误 代发单信息/供货单信息 ```json [ { "参数名": "ds_order_id", "类型": "number", "必填": "是", "说明": "代发单id" }, { "参数名": "supply_order_id", "类型": "number", "必填": "是", "说明": "供货单id（与代发单二者必传其一）" }, { "参数名": "goods_list", "类型": "objarray", "必填": "是", "说明": "代发单/供货单货品信息" } ] ``` ### Body.return_address `Object Payload` ```json [ { "参数名": "name", "类型": "string", "必填": "是", "说明": "人名" }, { "参数名": "mobile", "类型": "string", "必填": "是", "说明": "联系电话" }, { "参数名": "province", "类型": "string", "必填": "是", "说明": "省" }, { "参数名": "city", "类型": "string", "必填": "是", "说明": "市" }, { "参数名": "county", "类型": "string", "必填": "是", "说明": "区" }, { "参数名": "street", "类型": "string", "必填": "是", "说明": "街道(收件人非必填)" }, { "参数名": "address", "类型": "string", "必填": "是", "说明": "详细地址" } ] ``` "> ### Body.order_vas_list(Array) `Object Payload` 保价等增值服务 ```json [ { "参数名": "vas_type", "类型": "string", "必填": "是", "说明": "增值服务类型，目前支持的增值服务", "枚举": "枚举值" }, { "参数名": "vas_value", "类型": "string", "必填": "否", "说明": "增值服务值, 涉及金额单位一律为分", "枚举": "-" } ] ``` ### Body.ext_info `Object Payload` 温层等补充字段 ```json [ { "参数名": "temperature_range", "类型": "number", "必填": "否", "说明": "0或不传则为月结账号的默认温层信息\n1:普通/常温\n5:鲜活\n6:控温\n7:冷藏\n8:冷冻\n9:深冷\n使用条件：温层信息，京东专用" }, { "参数名": "package_weight_g", "类型": "number", "必填": "否", "说明": "包裹总重量:单位 g\n使用条件：包裹信息字段仅支持与与菜鸟互有信任协议商家使用" }, { "参数名": "package_space_x", "类型": "number", "必填": "否", "说明": "包裹长度:单位 cm\n使用条件：包裹信息字段仅支持与与菜鸟互有信任协议商家使用" }, { "参数名": "package_space_y", "类型": "number", "必填": "否", "说明": "包裹宽度:单位 cm\n使用条件：包裹信息字段仅支持与与菜鸟互有信任协议商家使用" }, { "参数名": "package_space_z", "类型": "number", "必填": "否", "说明": "包裹高度:单位 cm\n使用条件：包裹信息字段仅支持与与菜鸟互有信任协议商家使用" }, { "参数名": "package_volume_ccm", "类型": "number", "必填": "否", "说明": "包裹体积:单位 cm3\n使用条件：包裹信息字段仅支持与与菜鸟互有信任协议商家使用" } ] ``` ### Body.delivery_info `Object Payload` 预约上门取件、子母件等发货信息字段 ```json [ { "参数名": "delivery_type", "类型": "number", "必填": "否", "说明": "发货方式，0:仓库发货，1：门店预约发货\n门店发货说明：delivery_type不传默认的发货方式是仓库发货，取件地址和取件联系人商家是和快递公司线下签约商定的地址；门店预约发货的取件地址以sender字段传入的地址为准" }, { "参数名": "collected_time_begin", "类型": "number", "必填": "否", "说明": "预约上门开始时间，秒级时间戳，delivery_type=1时必填" }, { "参数名": "collected_time_end", "类型": "number", "必填": "否", "说明": "预约上门结束时间，秒级时间戳，delivery_type=1时必填" }, { "参数名": "package_quantity", "类型": "number", "必填": "否", "说明": "子母件包裹的数量,要求 2 =2则生成子母件" }, { "参数名": "subpackage_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" }, { "参数名": "out_product_id", "类型": "string", "必填": "否", "说明": "自定义spu_id" }, { "参数名": "out_sku_id", "类型": "string", "必填": "否", "说明": "自定义sku_id" }, { "参数名": "out_goods_info", "类型": "string", "必填": "否", "说明": "自定义商品详情（若不传平台的商品id，则会展示该字段在面单商品区域）" }, { "参数名": "goods_ext", "类型": "string", "必填": "否", "说明": "自定义的额外的商品信息，向快递公司透传,限制长度512" } ] ``` __goods_list__sn_info"> ### Body.ec_order_list(Array).goods_list.sn_info `Object Payload` ```json [ { "参数名": "imei1", "类型": "string", "必填": "否", "说明": "设备iemi1码" }, { "参数名": "imei2", "类型": "string", "必填": "否", "说明": "设备imei2码" }, { "参数名": "sn_code", "类型": "string", "必填": "否", "说明": "SN码信息" } ] ``` "> ### Body.delivery_info.subpackage_list(Array) `Object Payload` 包裹的体积和重量信息，顺丰支持该字段 ```json [ { "参数名": "weight_g", "类型": "number", "必填": "否", "说明": "商品重量，单位克" }, { "参数名": "space_x", "类型": "number", "必填": "否", "说明": "商品长度，单位厘米" }, { "参数名": "space_y", "类型": "number", "必填": "否", "说明": "商品宽度，单位厘米" }, { "参数名": "space_z", "类型": "number", "必填": "否", "说明": "商品高度，单位厘米" }, { "参数名": "package_no", "类型": "string", "必填": "否", "说明": "包裹编号" } ] ``` ## 3. 返回参数 ### 返回体 `Response Payload` ```json [ { "参数名": "errcode", "类型": "number", "说明": "错误码" }, { "参数名": "errmsg", "类型": "string", "说明": "错误信息" }, { "参数名": "ewaybill_order_id", "类型": "string", "说明": "电子面单订单id" }, { "参数名": "waybill_id", "类型": "string", "说明": "快递单号" }, { "参数名": "delivery_error_msg", "类型": "string", "说明": "快递公司错误码" }, { "参数名": "print_info", "类型": "string", "说明": "如果请求参数填了template_id，则返回打印报文信息，可以传给打印组件打印面单。" }, { "参数名": "waybill_id_list", "类型": "objarray", "说明": "子母单号列表" }, { "参数名": "consolidation_waybill_info", "类型": "objarray", "说明": "偏远中转集运的补充物流信息，包含B段运单信息" } ] ``` "> ### Res.waybill_id_list(Array) `Object Payload` 子母单号列表 ```json [ { "参数名": "waybill_id", "类型": "string", "说明": "快递单号" }, { "参数名": "waybill_type", "类型": "number", "说明": "快递单号类型，1：母单号，2：子单号" }, { "参数名": "create_time", "类型": "number", "说明": "单号创建时间，秒级时间戳" } ] ``` "> ### Res.order_risk_info(Array) `Object Payload` ```json [ { "参数名": "risk_ec_order_info", "类型": "object", "说明": "疑似存在风险的订单目录" }, { "参数名": "risk_msg", "类型": "string", "说明": "风险信息内容" } ] ``` "> ### Res.consolidation_waybill_info(Array) `Object Payload` 偏远中转集运的补充物流信息，包含B段运单信息 ```json [ { "参数名": "b_segment_delivery_id", "类型": "string", "说明": "偏远中转集运B段运单的物流商id" }, { "参数名": "b_segment_ewaybill_order_id", "类型": "string", "说明": "偏远中转集运B段运单的电子面单id" }, { "参数名": "b_segment_waybill_id", "类型": "string", "说明": "偏远中转集运B段运单的运单号" } ] ``` __risk_ec_order_info"> ### Res.order_risk_info(Array).risk_ec_order_info `Object Payload` 疑似存在风险的订单目录 ```json [ { "参数名": "ec_order_id", "类型": "number", "说明": "原始订单id（非代发单id）" }, { "参数名": "goods_list", "类型": "objarray", "说明": "代发单商品信息" } ] ``` __risk_ec_order_info__goods_list"> ### Res.order_risk_info(Array).risk_ec_order_info.goods_list `Object Payload` 代发单商品信息 ```json [ { "参数名": "good_name", "类型": "string", "说明": "商品名" }, { "参数名": "good_count", "类型": "number", "说明": "商品个数" }, { "参数名": "product_id", "类型": "number", "说明": "商品product_id" }, { "参数名": "sku_id", "类型": "number", "说明": "商品sku_id" }, { "参数名": "out_product_id", "类型": "string", "说明": "商家自定义spu_id" }, { "参数名": "out_sku_id", "类型": "string", "说明": "商家自定义sku_id" }, { "参数名": "out_goods_info", "类型": "string", "说明": "商家自定义商品详情（如果不传平台的商品id的话，会展示该字段在面单商品区域）" }, { "参数名": "goods_ext", "类型": "string", "说明": "商家自定义的额外的商品信息，向快递公司透传,限制长度512" } ] ``` ## 4. 枚举信息 ### Body.order_type `Enum` 支持的类型，陆续更新中，枚举值默认为1，加盟型可以不填 ```json [ { "快递公司": "JD", "枚举值": "-", "枚举解释": "-" }, { "快递公司": "JD", "枚举值": "1", "枚举解释": "京东标快" }, { "快递公司": "JD", "枚举值": "2", "枚举解释": "京东特快" }, { "快递公司": "JD", "枚举值": "3", "枚举解释": "生鲜标快" }, { "快递公司": "JD", "枚举值": "4", "枚举解释": "生鲜特快" }, { "快递公司": "JD", "枚举值": "5", "枚举解释": "电商标快" }, { "快递公司": "JD", "枚举值": "6", "枚举解释": "特惠包裹" }, { "快递公司": "JD", "枚举值": "7", "枚举解释": "京东特惠" }, { "快递公司": "JD", "枚举值": "8", "枚举解释": "函速达" }, { "快递公司": "JD", "枚举值": "11", "枚举解释": "特快零担" }, { "快递公司": "JD", "枚举值": "12", "枚举解释": "特快重货" }, { "快递公司": "JD", "枚举值": "17", "枚举解释": "特惠专配" }, { "快递公司": "JD", "枚举值": "18", "枚举解释": "大件宅配" }, { "快递公司": "JD", "枚举值": "19", "枚举解释": "大件零担" }, { "快递公司": "JD", "枚举值": "20", "枚举解释": "大件仓配" }, { "快递公司": "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", "枚举值": "201", "枚举解释": "冷运标快" }, { "快递公司": "SF", "枚举值": "231", "枚举解释": "陆运包裹" }, { "快递公司": "SF", "枚举值": "242", "枚举解释": "丰网速运" }, { "快递公司": "SF", "枚举值": "247", "枚举解释": "电商标快" }, { "快递公司": "SF", "枚举值": "249", "枚举解释": "丰礼遇" }, { "快递公司": "SF", "枚举值": "255", "枚举解释": "顺丰卡航" }, { "快递公司": "SF", "枚举值": "263", "枚举解释": "同城半日达" }, { "快递公司": "SF", "枚举值": "266", "枚举解释": "顺丰空配（新）" }, { "快递公司": "SF", "枚举值": "283", "枚举解释": "填仓标快" }, { "快递公司": "SF", "枚举值": "285", "枚举解释": "填舱电标" }, { "快递公司": "SF", "枚举值": "293", "枚举解释": "特快包裹(新）" }, { "快递公司": "SF", "枚举值": "303", "枚举解释": "专享急件" }, { "快递公司": "SF", "枚举值": "304", "枚举解释": "特早达" }, { "快递公司": "SF", "枚举值": "323", "枚举解释": "电商微小件" }, { "快递公司": "SF", "枚举值": "325", "枚举解释": "温控包裹" }, { "快递公司": "SF", "枚举值": "381", "枚举解释": "大闸蟹专递" }, { "快递公司": "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", "枚举解释": "精准汽运(新)" }, { "快递公司": "DBKD", "枚举值": "10", "枚举解释": "微小件特惠" }, { "快递公司": "DBKD", "枚举值": "11", "枚举解释": "泡货特惠" }, { "快递公司": "DBKD", "枚举值": "12", "枚举解释": "重货特惠" }, { "快递公司": "DBKD", "枚举值": "13", "枚举解释": "特快当日" }, { "快递公司": "DBKD", "枚举值": "14", "枚举解释": "DP联运(K)" }, { "快递公司": "DBKD", "枚举值": "15", "枚举解释": "DP联运(L)" }, { "快递公司": "DBKD", "枚举值": "17", "枚举解释": "小件特快" }, { "快递公司": "DBKD", "枚举值": "18", "枚举解释": "大件特快" }, { "快递公司": "DBKD", "枚举值": "19", "枚举解释": "小件标快" }, { "快递公司": "DBKD", "枚举值": "20", "枚举解释": "大件标快" }, { "快递公司": "DBKD", "枚举值": "21", "枚举解释": "小件特惠" }, { "快递公司": "DBKD", "枚举值": "22", "枚举解释": "大件特惠" }, { "快递公司": "KYSY", "枚举值": "-", "枚举解释": "-" }, { "快递公司": "KYSY", "枚举值": "1", "枚举解释": "当天达" }, { "快递公司": "KYSY", "枚举值": "2", "枚举解释": "次日达" }, { "快递公司": "KYSY", "枚举值": "3", "枚举解释": "隔日件" }, { "快递公司": "KYSY", "枚举值": "4", "枚举解释": "陆运件" }, { "快递公司": "KYSY", "枚举值": "5", "枚举解释": "空运" }, { "快递公司": "KYSY", "枚举值": "6", "枚举解释": "专运" }, { "快递公司": "KYSY", "枚举值": "7", "枚举解释": "省内次日" }, { "快递公司": "KYSY", "枚举值": "8", "枚举解释": "省内即日" }, { "快递公司": "KYSY", "枚举值": "9", "枚举解释": "同城次日" }, { "快递公司": "KYSY", "枚举值": "10", "枚举解释": "同城即日" }, { "快递公司": "CNSD", "枚举值": "-", "枚举解释": "-" }, { "快递公司": "CNSD", "枚举值": "1", "枚举解释": "默认" }, { "快递公司": "CNSD", "枚举值": "2", "枚举解释": "菜鸟电商标快" }, { "快递公司": "CNSD", "枚举值": "3", "枚举解释": "菜鸟标快" }, { "快递公司": "CNSD", "枚举值": "4", "枚举解释": "同城半日达" }, { "快递公司": "ZTO", "枚举值": "1", "枚举解释": "普件" }, { "快递公司": "ZTO", "枚举值": "2", "枚举解释": "中通标快" }, { "快递公司": "ZTO", "枚举值": "3", "枚举解释": "中通好快" }, { "快递公司": "ZTO", "枚举值": "4", "枚举解释": "中通飞快" } ] ``` __vas_type"> ### Body.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. 注意事项 - 增值服务在使用之前，请先和快递公司或者网点确认可用。 - 目前支持子母单的快递公司有：顺丰速运、德邦快递、京东快递。 - 目前支持门店预约发货的快递公司有：顺丰速运、京东快递、中通快递。 - 子母单打印必须安装最新的微信小店打印组件。[打印组件指南](https://store.weixin.qq.com/chengzhang/webdoc/wiki/544/6c826cffaccc0396/growth_center_manual_for_store?source=6&sourceType=4) ## 6. 代码示例 请求示例 ```json { "ewaybill_order_id": "1111", "delivery_id": "xxxx", "site_code": "1111", "ewaybill_acct_id": "1111", "template_id": "xxx", // 如果需要获取打印报文，则填该字段。回包会返回 print_info。 如无需使用后台模板，可直接传递 template_type做为默认模板， 如‘single’ "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", "return_address": { "name": "test", "mobile": "13212778355", "province": "上海市", "city": "上海市", "county": "青浦区", "street": "xxxx", "address": "xxxxx" } } ``` 返回示例 ```json { "errcode": 0, "errmsg": "ok", "ewaybill_order_id":"111", "waybill_id":"1212xzcxz", "delivery_error_msg":"xxxx", "waybill_id_list":[{ "waybill_id":"xxxxxx", "waybill_type":1, "create_time":1732515904, "print_info":"xxxx" },{ "waybill_id":"xxxxxx", "waybill_type":2, "create_time":1732515904, "print_info":"xxxx" } ] } ``` ## 7. 错误码 以下是本接口的错误码列表，其他错误码可参考 [通用错误码](/doc/store/shop/dev_before/commErrCode.md)；调用接口遇到报错，可使用官方提供的 [API 诊断工具](https://developers.weixin.qq.com/console/devtools/debug?utm_source=api_errcode) 辅助定位和分析问题。 ```json [ { "错误码": "10025005", "错误描述": "物流服务商返回运单下单失败，具体原因见delivery_error_msg字段", "解决方案": "" }, { "错误码": "10025012", "错误描述": "delivery_id错误", "解决方案": "" }, { "错误码": "10025013", "错误描述": "网点信息错误", "解决方案": "" }, { "错误码": "10025014", "错误描述": "网点账号编码错误", "解决方案": "" }, { "错误码": "10025015", "错误描述": "寄件人信息错误", "解决方案": "" }, { "错误码": "10025016", "错误描述": "收件人信息错误", "解决方案": "" }, { "错误码": "10025017", "错误描述": "小店订单信息错误", "解决方案": "" }, { "错误码": "10025018", "错误描述": "店铺id信息错误", "解决方案": "" }, { "错误码": "10025019", "错误描述": "面单已存在", "解决方案": "" }, { "错误码": "10025020", "错误描述": "EWaybill Order ID 的数据内容是Uint64,用字符串传递参数,请确认是否正确", "解决方案": "" }, { "错误码": "10025027", "错误描述": "需质检订单不支持电子面单取号，请开通商品质检服务后走质检发货流程", "解决方案": "" }, { "错误码": "10025029", "错误描述": "快递公司不支持该功能（预约上门取件等）", "解决方案": "" }, { "错误码": "10025030", "错误描述": "取号请求快递公司接口超时，可稍后重试", "解决方案": "" }, { "错误码": "10025031", "错误描述": "快递公司取号接口异常，可稍后重试", "解决方案": "" }, { "错误码": "10025032", "错误描述": "快递公司的取号接口异常，可能存在故障，可稍后重试或者更换其他快递公司取号", "解决方案": "" }, { "错误码": "10025033", "错误描述": "快递公司取号接口繁忙，可稍后重试或者更换其他快递公司取号", "解决方案": "" }, { "错误码": "10025035", "错误描述": "快递公司的取号接口不可用，可稍后重试或者更换其他快递公司取号", "解决方案": "" }, { "错误码": "10025038", "错误描述": "买家申请更换商品款式，可前往「商家后台> 订单/配送 > 发货工具 > 发货前换货服务」处理，订单详情见changed_info字段", "解决方案": "" }, { "错误码": "10025042", "错误描述": "买家申请更改收件地址，需在商家后台处理, 单号详情查看changed_info字段", "解决方案": "" }, { "错误码": "10025043", "错误描述": "相同电子面单订单号重复取号，操作过于频繁请稍后重试", "解决方案": "" }, { "错误码": "10025047", "错误描述": "订单已分配给供货商代发,单号详情查看changed_info字段", "解决方案": "" }, { "错误码": "10025061", "错误描述": "物流商或揽收网点涉嫌违规，平台暂不支持使用", "解决方案": "" }, { "错误码": "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)，无法继续取号", "解决方案": "①代发场景，可切换至官方代发工具 ②关联店群场景，可根据站内信指引完成店铺关联" }, { "错误码": "268545000", "错误描述": "快递公司不支持国补", "解决方案": "" }, { "错误码": "268545001", "错误描述": "订单ID和面单的取号的商品id不匹配", "解决方案": "" }, { "错误码": "268545002", "错误描述": "电子面单中的商品订单信息无效", "解决方案": "" }, { "错误码": "268545003", "错误描述": "商品SKU不匹配", "解决方案": "" }, { "错误码": "268545004", "错误描述": "商品国补信息不存在", "解决方案": "" }, { "错误码": "268545005", "错误描述": "国补商品不支持组合打单", "解决方案": "" }, { "错误码": "268545006", "错误描述": "国补不支持多sku", "解决方案": "" }, { "错误码": "268545007", "错误描述": "订单商品不唯一", "解决方案": "" }, { "错误码": "268545008", "错误描述": "国补订单参数错误", "解决方案": "" }, { "错误码": "268545009", "错误描述": "国补锁sn码失败", "解决方案": "可以重试" }, { "错误码": "268545010", "错误描述": "国补sn码被其他平台锁定", "解决方案": "" }, { "错误码": "268545011", "错误描述": "国补sn码被其他订单锁定", "解决方案": "" }, { "错误码": "268545012", "错误描述": "国补sn码锁定参数错误", "解决方案": "可以检查SN码/IMEI码等信息" }, { "错误码": "268545013", "错误描述": "国补sn码锁定失败,其他逻辑错误", "解决方案": "" }, { "错误码": "268545014", "错误描述": "商品分类不支持国补", "解决方案": "" }, { "错误码": "268545015", "错误描述": "国补sn码不存在", "解决方案": "检查SN码" } ] ``` ## 8. 适用范围 本接口在不同账号类型下的可调用情况： ```json [ { "微信小店": "✔", "小店供货商": "✔" } ] ``` - ✔：该账号可调用此接口。 - 其他未明确声明的账号类型，如无特殊说明，均不可调用此接口。 ![](https://res8.wxqcloud.qq.com.cn/wxdoc/56617deb-b17d-4cf1-bccd-71d2c41ccc76.svg)接口变更日志（18条） 2026 年 08 月 03 日更新 `DBKD` 、 `CNSD` 等字段描述 2026 年 07 月 24 日新增 `consolidation_waybill_info` 字段 2026 年 07 月 22 日`DBKD` 字段新增「小件特快」「大件特快」等 6 个枚举类型 2026 年 05 月 18 日新增 `supply_order_id` 字段，支持供货单取号 2026 年 03 月 31 日移除vas_detail枚举值展示 2026 年 03 月 30 日ZTO增加普件order_type枚举，增加合单寄件相关注意事项说明 2026 年 03 月 24 日`SF` 枚举值下架「特快包裹」，新增「特快包裹(新）」 2026 年 03 月 18 日增加京东电子面单增值服务描述 2025 年 12 月 31 日更新 `order_type` 、 `vas_type` 等字段描述，更新 `Body.order_type` 、 `Body.order_vas_list(Array).vas_type` 枚举值描述 2025 年 12 月 12 日增加了中通增值产品的order_type 2025 年 12 月 09 日新增错误码类型 2025 年 11 月 21 日增加公告：微信小店「电子面单取号API接口」调整通知 2025 年 11 月 18 日增加10025020，10025027等错误码 2025 年 11 月 13 日修正了jd order_type 17 对应的产品名称 2025 年 11 月 07 日`product_id` 字段调整为非必填 2025 年 10 月 31 日完善错误码 2025 年 10 月 29 日`vas_type` 字段新增「枚举值」说明