查询开通的网点账号信息

# 查询开通的网点账号信息

# 接口调用请求说明

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

查询商家已经开通的面单账号信息，包括面单账号的状态，库存等等。

# 请求参数示例

{
   "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"
      }
    }
  ]
}

# 请求参数说明

参数	类型	是否必填	说明
delivery_id	String	No	快递公司编码
acct_id	String	No	电子面单账号id
need_balance	Boolean	Yes	是否需要查询库存
status	Uint32	No	状态过滤
offset	Uint32	No	分页起始位置，默认0
limit	Uint32	Yes	单次请求数量

快递公司名称	类型	delivery_id
中通	加盟	ZTO
圆通	加盟	YTO
韵达	加盟	YUNDA
极兔	加盟	JTSD
申通	加盟	STO
顺丰	自营	SF
京东	自营	JD
中国邮政	自营	EMS
菜鸟速递(丹鸟)	自营	CNSD
德邦快递	自营	DBKD

自营性快递公司陆续会接入。

# 回包参数说明

参数	类型	说明
errcode	Number	错误码
errmsg	String	错误信息
total_num	Uint32	总条数
account_list	array[AccountInfo]	账号列表

AccountInfo的结构体定义

参数	是否必填	类型	说明
delivery_id	Yes	String	快递公司id
company_type	Yes	Uint32	快递公司类型 1 加盟型，2 直营型
shop_id	Yes	String	店铺id，全局唯一，一个店铺分配一个shop_id
acct_id	Yes	String	电子面单账号id，每绑定一个网点分配一个acct_id
acct_type	Yes	Uint32	面单账号类型，0 普通账号，1 共享账号
status	Yes	Uint32	面单账号状态
available	Yes	Uint32	面单余额
allocated	Yes	Uint32	累积已取单
recycled	Yes	Uint32	累积已回收
cancel	Yes	Uint32	累计已取消
site_info	No	SiteInfo	网点信息
monthly_card	No	String	月结账号，company_type 为直营型时有效
sender_address	Yes	SenderAddress	绑定的发货地址信息
share	No	EWaybillAcctShare	共享账号发起方信息，acct_type 为共享账号时有效

status状态枚举：

状态	说明
1	绑定审核中
2	取消绑定审核中
3	已绑定
4	已解除绑定
5	绑定未通过
6	取消绑定未通过

SiteInfo的结构体定义

参数	类型	说明
delivery_id	String	快递公司编码
site_status	Uint32	网点运营状态, 1 正常, 其他值则不正常
site_code	String	网点编码
site_name	String	网点名字
site_fullname	String	地址全名
address	SiteAddress	地址信息
contact	SiteContact	联系信息

SiteAddress的结构体定义

参数	类型	说明
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	街道名

SiteContact的结构体定义

参数	类型	说明
mobile	String	移动电话
name	String	名称
phone	String	电话

SenderAddress的结构体定义

参数	类型	说明
province	String	省
city	String	市
county	String	区县
street	String	街道
address	String	详细地址

EWaybillAcctShare 的结构体定义

参数	类型	说明
delivery_id	String	快递公司id
site_code	String	网点编码
site_name	String	网点名字
acct_id	String	电子面单账号id
nickname	String	发起共享方店铺名
share_id	String	共享id
shop_id	String	店铺id，全局唯一，一个店铺分配一个shop_id
monthly_card	String	直营型月结账号
update_time	Uint64	更新时间

# 错误码

错误码	错误信息
公共错误码	点击查看
10025120	电子面单帐号列表为空，请检查请求参数
10025102	快递公司不支持