文档中心 开票接口 查询企业下纳税人信息列表(分页)

查询企业下纳税人信息列表(分页)

1.功能说明

查询企业下纳税人信息列表(分页)

2.接口调用说明

请求URL

https://openapi.guanaitong.tech/invoice/listTaxpayer

正式环境和测试环境的域名请见通用协议

HTTPS请求方式

POST

输入参数说明

(1)公共参数

发送请求是必须传入公共参数,详见公共参数

(2)私有参数

参数名称 是否必须 参数类型 长度限制 描述
enterprise_code string [1,20] 企业编码(集团同步,企业不填)
page int [1,~] 页码,默认1
page_size int [1,20] 每页数量,默认20,最大200
请求示例
POST /invoice/listTaxpayer HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache

access_token=da7adc9907364dbafd47d53a9b87640d&page=1&page_size=2&sign=b5564ebf9911f5609c5b51bf02f3dea56db32185
&timestamp=1571990662&version=1.0.0

					
返回参数说明
参数名称 描述
code 返回码。详见错误代码
msg 如果错误,返回错误信息。
data 如果没有错误,纳税人信息
纳税人信息描述
id int类型,纳税人ID,设置员工纳税归属时会用到
title string类型,发票抬头名称
is_general int类型,是否一般纳税人, 1.是 2.否
taxpayer_no string类型,纳税人识别号
status int类型,审核状态 1.待审核 2.已通过 3.未通过 4.已禁用(2状态可绑定纳税人)
正确返回示例
{
	"code": 0,
	"data": {
		"data_list": [{
			"taxpayer_no": "",
			"is_general": 2,
			"id": 2229,
			"title": "test的发票抬头",
			"status": 1
		}, {
			"taxpayer_no": "121232123212345675",
			"is_general": 1,
			"id": 1994,
			"title": "某某公司",
			"status": 1
		}],
		"total_count": 2,
		"has_next": false
	},
	"msg": "OK"
}
错误返回示例
{"code":1000210002,"data":null,"msg":"sign check failed!"}