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

> 接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考[接口调用指南](/doc/oplatform/developers/dev/guide.md)。

接口英文名：ewaybill_getacct

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

相关文档：
[微信小店「电子面单操作」使用指南](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/account/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
[
  {
    "参数名": "delivery_id",
    "类型": "string",
    "必填": "否",
    "说明": "快递公司编码",
    "枚举": "枚举值"
  },
  {
    "参数名": "need_balance",
    "类型": "boolean",
    "必填": "是",
    "说明": "是否需要查询库存",
    "枚举": "-"
  },
  {
    "参数名": "status",
    "类型": "number",
    "必填": "否",
    "说明": "状态过滤",
    "枚举": "枚举值"
  },
  {
    "参数名": "offset",
    "类型": "number",
    "必填": "否",
    "说明": "分页起始位置，默认0",
    "枚举": "-"
  },
  {
    "参数名": "limit",
    "类型": "number",
    "必填": "是",
    "说明": "单次请求数量,当need_balance=true请注意设置合理的limit推荐值小于20，否则limit过大会导致接口超时无返回",
    "枚举": "-"
  },
  {
    "参数名": "acct_id",
    "类型": "string",
    "必填": "否",
    "说明": "物流账号编码：每绑定一个物流商网点/月结账号分配一个acct_id",
    "枚举": "-"
  }
]
```

## 3. 返回参数

### 返回体 `Response Payload`

```json
[
  {
    "参数名": "errcode",
    "类型": "number",
    "说明": "错误码"
  },
  {
    "参数名": "errmsg",
    "类型": "string",
    "说明": "错误信息"
  },
  {
    "参数名": "total_num",
    "类型": "number",
    "说明": "总条数"
  },
  {
    "参数名": "account_list",
    "类型": "objarray",
    "说明": "账号列表"
  }
]
```

">

### Res.account_list(Array) `Object Payload`

账号列表

```json
[
  {
    "参数名": "delivery_id",
    "类型": "string",
    "说明": "快递公司id"
  },
  {
    "参数名": "acct_type",
    "类型": "number",
    "说明": "面单账号类型\n0：普通账号\n1：共享账号"
  },
  {
    "参数名": "company_type",
    "类型": "number",
    "说明": "快递公司类型\n1：加盟型\n2：直营型"
  },
  {
    "参数名": "shop_id",
    "类型": "string",
    "说明": "面单主体ID：每个供货商分配的唯一shop_id"
  },
  {
    "参数名": "acct_id",
    "类型": "string",
    "说明": "物流账号编码：每绑定一个物流商网点/月结账号分配一个acct_id"
  },
  {
    "参数名": "status",
    "类型": "number",
    "说明": "面单账号状态"
  },
  {
    "参数名": "available",
    "类型": "number",
    "说明": "面单余额"
  },
  {
    "参数名": "allocated",
    "类型": "number",
    "说明": "累积已取单"
  },
  {
    "参数名": "recycled",
    "类型": "number",
    "说明": "累积已回收"
  },
  {
    "参数名": "cancel",
    "类型": "number",
    "说明": "累计已取消"
  },
  {
    "参数名": "monthly_card",
    "类型": "string",
    "说明": "月结账号，company_type 为直营型时有效"
  },
  {
    "参数名": "site_info",
    "类型": "object",
    "说明": "网点信息"
  },
  {
    "参数名": "share",
    "类型": "object",
    "说明": "共享账号发起方信息，acct_type 为共享账号时有效"
  },
  {
    "参数名": "sender_address",
    "类型": "object",
    "说明": "绑定的发货地址信息"
  },
  {
    "参数名": "balance_retcode",
    "类型": "number",
    "说明": "查询库存的返回码，错误码取值参考接口错误码列表"
  },
  {
    "参数名": "balance_retmsg",
    "类型": "string",
    "说明": "查询库存的返回信息"
  },
  {
    "参数名": "delivery_msg",
    "类型": "string",
    "说明": "查询库存失败，快递公司返回的详情"
  },
  {
    "参数名": "available",
    "类型": "number",
    "说明": "可用库存，月结类型账号，忽略该字段"
  },
  {
    "参数名": "allocated",
    "类型": "number",
    "说明": "充值的库存数量"
  },
  {
    "参数名": "recycled",
    "类型": "number",
    "说明": "回收的面单库存量"
  },
  {
    "参数名": "cancel",
    "类型": "number",
    "说明": "取消的面单库存量"
  }
]
```

__site_info">

### Res.account_list(Array).site_info `Object Payload`

网点信息

```json
[
  {
    "参数名": "delivery_id",
    "类型": "string",
    "说明": "快递公司编码"
  },
  {
    "参数名": "site_status",
    "类型": "number",
    "说明": "网点运营状态\n1：正常\n其他值则不正常"
  },
  {
    "参数名": "site_code",
    "类型": "string",
    "说明": "网点编码"
  },
  {
    "参数名": "site_name",
    "类型": "string",
    "说明": "网点名字"
  },
  {
    "参数名": "address",
    "类型": "object",
    "说明": "地址信息"
  },
  {
    "参数名": "contact",
    "类型": "object",
    "说明": "联系信息"
  },
  {
    "参数名": "site_fullname",
    "类型": "string",
    "说明": "地址全名"
  }
]
```

__site_info__address">

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

地址信息

```json
[
  {
    "参数名": "city_code",
    "类型": "string",
    "说明": "城市编码"
  },
  {
    "参数名": "city_name",
    "类型": "string",
    "说明": "城市名"
  },
  {
    "参数名": "country_code",
    "类型": "string",
    "说明": "国家编码"
  },
  {
    "参数名": "detail_address",
    "类型": "string",
    "说明": "详细地址"
  },
  {
    "参数名": "district_code",
    "类型": "string",
    "说明": "区县编码"
  },
  {
    "参数名": "district_name",
    "类型": "string",
    "说明": "区县名"
  },
  {
    "参数名": "province_code",
    "类型": "string",
    "说明": "省编码"
  },
  {
    "参数名": "province_name",
    "类型": "string",
    "说明": "省份名"
  },
  {
    "参数名": "street_code",
    "类型": "string",
    "说明": "街道编码"
  },
  {
    "参数名": "street_name",
    "类型": "string",
    "说明": "街道名"
  }
]
```

__site_info__contact">

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

联系信息

```json
[
  {
    "参数名": "mobile",
    "类型": "string",
    "说明": "移动电话"
  },
  {
    "参数名": "name",
    "类型": "string",
    "说明": "名称"
  },
  {
    "参数名": "phone",
    "类型": "string",
    "说明": "电话"
  }
]
```

__share">

### Res.account_list(Array).share `Object Payload`

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

```json
[
  {
    "参数名": "delivery_id",
    "类型": "string",
    "说明": "快递公司id"
  },
  {
    "参数名": "site_code",
    "类型": "string",
    "说明": "网点编码"
  },
  {
    "参数名": "site_name",
    "类型": "string",
    "说明": "网点名字"
  },
  {
    "参数名": "acct_id",
    "类型": "string",
    "说明": "物流账号编码：每绑定一个物流商网点/月结账号分配一个acct_id"
  },
  {
    "参数名": "nickname",
    "类型": "string",
    "说明": "发起共享方店铺名"
  },
  {
    "参数名": "share_id",
    "类型": "string",
    "说明": "共享id"
  },
  {
    "参数名": "shop_id",
    "类型": "string",
    "说明": "面单主体ID：每个供货商分配的唯一shop_id"
  },
  {
    "参数名": "monthly_card",
    "类型": "string",
    "说明": "直营型 月结账号"
  },
  {
    "参数名": "update_time",
    "类型": "number",
    "说明": "更新时间"
  }
]
```

__sender_address">

### Res.account_list(Array).sender_address `Object Payload`

绑定的发货地址信息

```json
[
  {
    "参数名": "province",
    "类型": "string",
    "说明": "省"
  },
  {
    "参数名": "city",
    "类型": "string",
    "说明": "市"
  },
  {
    "参数名": "county",
    "类型": "string",
    "说明": "区县"
  },
  {
    "参数名": "street",
    "类型": "string",
    "说明": "街道"
  },
  {
    "参数名": "address",
    "类型": "string",
    "说明": "详细地址"
  }
]
```

## 4. 枚举信息

### Body.delivery_id `Enum`

快递公司编码

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

### Body.status `Enum`

状态过滤

```json
[
  {
    "枚举值": "1",
    "描述": "绑定审核中"
  },
  {
    "枚举值": "2",
    "描述": "取消绑定审核中"
  },
  {
    "枚举值": "3",
    "描述": "已绑定"
  },
  {
    "枚举值": "4",
    "描述": "已解除绑定"
  },
  {
    "枚举值": "5",
    "描述": "绑定未通过"
  },
  {
    "枚举值": "6",
    "描述": "取消绑定未通过"
  }
]
```

## 5. 注意事项

本接口无特殊注意事项

## 6. 代码示例

请求示例

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

返回示例

```json
{
  "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. 错误码

以下是本接口的错误码列表，其他错误码可参考 [通用错误码](/doc/store/shop/dev_before/commErrCode.md)；调用接口遇到报错，可使用官方提供的 [API 诊断工具](https://developers.weixin.qq.com/console/devtools/debug?utm_source=api_errcode) 辅助定位和分析问题。

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

## 8. 适用范围

本接口在不同账号类型下的可调用情况：

```json
[
  {
    "微信小店": "✔",
    "小店供货商": "✔"
  }
]
```

- ✔：该账号可调用此接口。
- 其他未明确声明的账号类型，如无特殊说明，均不可调用此接口。

![](https://res8.wxqcloud.qq.com.cn/wxdoc/56617deb-b17d-4cf1-bccd-71d2c41ccc76.svg)接口变更日志（1条）
2025 年 12 月 31 日更新  `status`  字段说明，新增  `Body.status`  枚举信息