1. 查询企业信息
1.1. 接口说明
分页查询当前机构及其旗下企业信息。
1.2. 调用方式
请求方式:GET
https://invoice.youepiao.com/openApi/agency
1.3. 请求参数
1.3.1. 参数说明
参数 | 参数名称 | 类型 | 长度 | 必须 | 备注 |
---|---|---|---|---|---|
taxNumber | 企业税号 | String | 20 | 否 | |
agencyName | 企业名称 | String | 100 | 否 | |
pageNum | 页码 | Integer | 否 | 从1开始 默认值:1 |
|
pageSize | 分页大小 | Integer | 否 | 分页数量取值范围:[10, 20] 默认值:10 |
1.4. 返回结果
1.4.1. 返回示例
{
"status": true,
"code": 0,
"msg": "查询成功",
"timestamp": "2023-04-12T07:47:59.246+00:00",
"data": {
"pageNum": 1,
"pageSize": 10,
"size": 3,
"total": 3,
"list": [
{
"taxNumber": "税号",
"agencyName": "公司名称",
"address": "公司经营地址",
"phone": "公司联系电话",
"bank": "开户行信息",
"account": "开户行账户信息",
"taxUser": {
"idCard": "身份证号码",
"name": "用户名",
"identityPwd": "税局登录密码",
"phone": "税局登录手机号",
"taxPwd": "办税员登录密码",
"loginIdentity": "电子税局登录身份",
"email": "邮箱"
}
}
]
}
}
1.4.2. 返回说明
参数 | 参数名称 | 类型 | 长度 | 必须 | 备注 |
---|---|---|---|---|---|
pageNum | 页码 | Integer | 是 | ||
pageSize | 分页大小 | Integer | 是 | ||
size | 数量 | Integer | 是 | 本次返回数量 | |
total | 总量 | Integer | 是 | 总数据量 | |
list | 企业集合 | 是 | 企业集合 请参照企业详情说明。 |
企业详情
报文 | 参数名称 | 类型 | 长度 | 必须 | 备注 |
---|---|---|---|---|---|
ttaxNumber | 企业税号 | String | 20 | 是 | |
agencyName | 企业名称 | String | 100 | 是 | |
address | 地址 | String | 100 | 否 | 公司经营地址 |
phone | 联系电话 | String | 15 | 否 | 公司联系电话 |
bank | 开户行 | String | 30 | 否 | |
account | 账户 | String | 30 | 否 | 开户行账户信息 |
taxUser | 税局用户 | Object | 否 | 税局用户 请参照用户详情说明。 |
用户详情
报文 | 参数名称 | 类型 | 长度 | 必须 | 备注 |
---|---|---|---|---|---|
idCard | 身份证号码 | String | 20 | 是 | 办税员身份证号码 |
name | 名称 | String | 100 | 是 | 办税员名称 |
identityPwd | 企业密码 | String | 100 | 是 | 企业税局密码 |
phone | 电话 | String | 15 | 是 | 办税员手机号 |
taxPwd | 办税密码 | String | 30 | 是 | 办税员登录密码 |
loginIdentity | 登录身份 | String | 1 | 是 | 电子税局登录身份 1-财务负责人 2-法定代表人 7-开票员 |
邮箱 | String | 40 | 否 |