文档中心 开票接口 新增纳税人信息(仅体检)

新增纳税人信息(仅体检)

1.功能说明

新增纳税人信息(仅体检)(不存在纳税人信息则新增,否则查询并返回)

2.接口调用说明

请求URL

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

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

HTTPS请求方式

POST

输入参数说明

(1)公共参数

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

(2)私有参数

参数名称 是否必须 参数类型 长度限制 描述
contract_name String [1-100] 发票抬头
is_general_taxpayer Integer [1] 是否一般纳税人 1、是(identifier同步) 2、否(bank_account,open_bank_account_permission,general_taxpayer_certificate,registered_address,deposit_bank,identifier,tax_registration_certificate不传)
identifier string [15/18/20] 纳税人识别号:长度15位 18位 20位,仅is_general_taxpayer=1时必传
registered_address string [1-150] 注册地址
registered_phone string [1-45] 注册电话
deposit_bank String [1-50] 开户银行
bank_account String [5-25] 银行账号
email String [1-100] 邮箱
tax_registration_certificate String [1-150] 税务登记证
open_bank_account_permission String [1-150] 银行开户证
general_taxpayer_certificate String [1-150] 一般纳税人资格认定书
is_show Integer [1] 是否对员工可见:1、是 0 、否
请求示例
POST /invoice/addPhysicTaxpayer HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded
cache-control: no-cache

access_token=50276bc1ad828017a7137c463741e7d5&sign=6ef3f39fc29b7f072f7d9174f437512ac0ac55f1&identifier=913101096988189546
&contract_name=某某公司营业部&is_general_taxpayer=1&timestamp=1574216863

					
返回参数说明
参数名称 描述
code 返回码。详见错误代码
msg 如果错误,返回错误信息。
data 如果没有错误,返回业务数据(此处返回纳税人编号)
正确返回示例
{"code":0,"data":2226,"msg":"OK"}
错误返回示例
{"code":1000210002,"data":null,"msg":"sign check failed!"}