微信小店
取消
中文
中文
EN
取消
  • 供货商

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

    调试诊断

    接口应在服务器端调用，不可在前端（小程序、网页、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 枚举信息