查询开通的电子面单网点/账号信息

查看 llm.txt

最后一次编辑于 2026-01-16

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南。

接口英文名:ewaybill_getacct

可通过该接口查询商家已经开通的网点账号信息,面单账号信息,包括面单账号的状态,库存等等

相关文档: 微信小店「电子面单操作」使用指南

1. 调用方式

HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/logistics/ewaybill/biz/account/get?access_token=ACCESS_TOKEN

云调用

  • 本接口不支持云调用。

第三方调用

2. 请求参数

查询参数 Query String Parameters

参数名类型必填示例说明
access_tokenstring是ACCESS_TOKEN接口调用凭证,可使用 access_token(供货商)、authorizer_access_token(服务商代调用)

请求体 Request Payload

参数名类型必填说明枚举
delivery_idstring否快递公司编码枚举值
need_balanceboolean是是否需要查询库存-
statusnumber否状态过滤枚举值
offsetnumber否分页起始位置,默认0-
limitnumber是单次请求数量,当need_balance=true请注意设置合理的limit推荐值小于20,否则limit过大会导致接口超时无返回-
acct_idstring否物流账号编码:每绑定一个物流商网点/月结账号分配一个acct_id -

3. 返回参数

返回体 Response Payload

参数名类型说明
errcodenumber错误码
errmsgstring错误信息
total_numnumber总条数
account_listobjarray账号列表

Res.account_list(Array) Object Payload

账号列表

参数名类型说明
delivery_idstring快递公司id
acct_typenumber面单账号类型 0:普通账号 1:共享账号
company_typenumber快递公司类型 1:加盟型 2:直营型
shop_idstring面单主体ID:每个供货商分配的唯一shop_id
acct_idstring物流账号编码:每绑定一个物流商网点/月结账号分配一个acct_id
statusnumber面单账号状态
availablenumber面单余额
allocatednumber累积已取单
recyclednumber累积已回收
cancelnumber累计已取消
monthly_cardstring月结账号,company_type 为直营型时有效
site_infoobject网点信息
shareobject共享账号发起方信息,acct_type 为共享账号时有效
sender_addressobject绑定的发货地址信息
balance_retcodenumber查询库存的返回码,错误码取值参考接口错误码列表
balance_retmsgstring查询库存的返回信息
delivery_msgstring查询库存失败,快递公司返回的详情
availablenumber可用库存,月结类型账号,忽略该字段
allocatednumber充值的库存数量
recyclednumber回收的面单库存量
cancelnumber取消的面单库存量

Res.account_list(Array).site_info Object Payload

网点信息

参数名类型说明
delivery_idstring快递公司编码
site_statusnumber网点运营状态 1:正常 其他值则不正常
site_codestring网点编码
site_namestring网点名字
addressobject地址信息
contactobject联系信息
site_fullnamestring地址全名

Res.account_list(Array).site_info.address Object Payload

地址信息

参数名类型说明
city_codestring城市编码
city_namestring城市名
country_codestring国家编码
detail_addressstring详细地址
district_codestring区县编码
district_namestring区县名
province_codestring省编码
province_namestring省份名
street_codestring街道编码
street_namestring街道名

Res.account_list(Array).site_info.contact Object Payload

联系信息

参数名类型说明
mobilestring移动电话
namestring名称
phonestring电话

Res.account_list(Array).share Object Payload

共享账号发起方信息,acct_type 为共享账号时有效

参数名类型说明
delivery_idstring快递公司id
site_codestring网点编码
site_namestring网点名字
acct_idstring物流账号编码:每绑定一个物流商网点/月结账号分配一个acct_id
nicknamestring发起共享方店铺名
share_idstring共享id
shop_idstring面单主体ID:每个供货商分配的唯一shop_id
monthly_cardstring直营型 月结账号
update_timenumber更新时间

Res.account_list(Array).sender_address Object Payload

绑定的发货地址信息

参数名类型说明
provincestring省
citystring市
countystring区县
streetstring街道
addressstring详细地址

4. 枚举信息

Body.delivery_id Enum

快递公司编码

delivery_id快递公司名称类型
ZTO中通加盟
YTO圆通加盟
YUNDA韵达加盟
JTSD极兔加盟
STO申通加盟
SF顺丰自营
JD京东自营
EMS中国邮政自营
CNSD菜鸟速递(丹鸟)自营
DBKD德邦快递自营
SXJD顺心捷达加盟
ZTOKY中通快运加盟
YDKY韵达快运加盟
ANEKY安能物流加盟
BTWL百世快运加盟
KYSY跨越速运直营
YMDD壹米滴答加盟
RJTCSD锐界同城速递直营
ZJS宅急送直营
JSD吉时达加盟
XFEX信丰物流加盟
JGSD京广速递加盟

Body.status Enum

状态过滤

枚举值描述
1绑定审核中
2取消绑定审核中
3已绑定
4已解除绑定
5绑定未通过
6取消绑定未通过

5. 注意事项

本接口无特殊注意事项

6. 代码示例

请求示例

{
   "need_balance":true,
   "limit":10
}

返回示例

{
  "errcode": 0, 
  "errmsg": "ok", 
  "total_num": 1,
  "account_list": [
    {
      "delivery_id": "JTSD", 
      "shop_id": "5xxxxxxxxx8", 
      "acct_id": "6xxxxxxxxx6", 
      "status": 3, 
      "available": 0, 
      "allocated": 0, 
      "recycled": 0, 
      "cancel": 0, 
      "site_info": {
        "delivery_id": "JTSD", 
        "site_status": 1, 
        "site_code": "2100002", 
        "site_name": "测试网点02", 
        "address": {
          "city_code": "310100000", 
          "city_name": "上海市", 
          "detail_address": "上海上海市青浦区华新镇华隆路1777号", 
          "district_code": "310118000", 
          "district_name": "青浦区", 
          "province_code": "310000000", 
          "province_name": "上海", 
          "street_code": "", 
          "street_name": ""
        }, 
        "contact": {
          "mobile": "15xxxxxxxxx", 
          "name": "测试团队", 
          "phone": "15xxxxxxxxx"
        }, 
        "site_fullname": "测试网点02"
      }
    }
  ]
}

7. 错误码

以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。

错误码错误描述
10025030请求快递公司接口超时,可稍后重试
10025031快递公司接口异常,可稍后重试
10025032快递公司接口异常,可能存在故障,可稍后重试
10025033快递公司接口繁忙,可稍后重试
10025035快递公司的接口不可用,可稍后重试
10025102快递公司不支持
10025120电子面单帐号列表为空,请检查请求参数

8. 适用范围

本接口在不同账号类型下的可调用情况:
微信小店小店供货商
✔ ✔
  • ✔:该账号可调用此接口。
  • 其他未明确声明的账号类型,如无特殊说明,均不可调用此接口。
接口变更日志(1条)
2025 年 12 月 31 日
更新 status 字段说明,新增 Body.status 枚举信息