查询开通的网点账号信息

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

# 接口说明

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

# 注意事项

自营性快递公司陆续会接入，快递公司详细信息如下：

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

# 接口调用请求说明

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

# 请求参数说明

参数	类型	是否必填	描述
delivery_id	String	否	快递公司编码，详情请参考delivery_id
acct_id	String	No	电子面单账号id
need_balance	Boolean	是	是否需要查询库存
status	Uint32	否	状态过滤，枚举值详情请参考status
offset	Uint32	否	分页起始位置，默认0
limit	Uint32	是	单次请求数量,当need_balance=true请注意设置合理的limit推荐值小于20，否则limit过大会导致接口超时无返回

# 请求参数示例

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

# 返回参数说明

参数	类型	描述
errcode	Number	错误码
errmsg	String	错误信息
total_num	Uint32	总条数
account_list	array[AccountInfo]	账号列表，结构体详情请参考AccountInfo

# 返回参数示例

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

# 错误码

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

# 结构体

# AccountInfo

账号列表

参数	类型	是否必填	描述
delivery_id	String	是	快递公司id
company_type	Uint32	是	快递公司类型 1：加盟型 2：直营型
shop_id	String	是	店铺id，全局唯一，一个店铺分配一个shop_id
acct_id	String	是	电子面单账号id，每绑定一个网点分配一个acct_id
acct_type	Uint32	是	面单账号类型 0：普通账号 1：共享账号
status	Uint32	是	面单账号状态
available	Uint32	是	面单余额
allocated	Uint32	是	累积已取单
recycled	Uint32	是	累积已回收
cancel	Uint32	是	累计已取消
site_info	SiteInfo	否	网点信息，结构体详情请参考SiteInfo
monthly_card	String	否	月结账号，company_type 为直营型时有效
available	int32	否	可用库存，月结类型账号，忽略该字段
allocated	int32	否	充值的库存数量
recycled	int32	否	回收的面单库存量
cancel	int32	否	取消的面单库存量
balance_retcode	int32	否	查询库存的返回码，错误码取值参考接口错误码列表
balance_retmsg	string	否	查询库存的返回信息
delivery_msg	string	否	查询库存失败，快递公司返回的详情
sender_address	SenderAddress	是	绑定的发货地址信息，结构体详情请参考SenderAddress
share	EWaybillAcctShare	否	共享账号发起方信息，acct_type 为共享账号时有效，结构体详情请参考EWaybillAcctShare

# SiteInfo

网点信息

参数	类型	描述
delivery_id	String	快递公司编码
site_status	Uint32	网点运营状态 1：正常其他值则不正常
site_code	String	网点编码
site_name	String	网点名字
site_fullname	String	地址全名
address	SiteAddress	地址信息，结构体详情请参考SiteAddress
contact	SiteContact	联系信息，结构体详情请参考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	更新时间

# 枚举值

# status

面单账号状态

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