纳税人创建¶

功能说明¶

纳税人创建

接口地址¶

测试环境: https://openapi.guanaitong.tech/taxpayer/add
生产环境: https://openapi.guanaitong.com/taxpayer/add

HTTP请求方式¶

Method: POST
Content-Type: application/x-www-form-urlencoded

参数说明¶

公有参数

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

私有参数

参数名称	是否必须	参数类型	长度限制	描述
enterprise_code	否	string	[1,20]	企业编号(集团和运营商必填,企业不填)
taxpayer_name	是	string	[1,100]	纳税人名称（抬头）
identifier	是	string	[1,45]	纳税人识别号
taxpayer_nature	否	int		纳税人性质，1，一般纳税人；2，小规模纳税人；默认2
email	否	string	[1,100]	默认通知邮箱
registered_address	否	string	[1,150]	注册地址
registered_phone	否	string	[1,100]	注册电话
deposit_bank	否	string	[1,100]	开户银行
bank_account	否	string	[1,100]	银行账号

请求示例¶

POST /taxpayer/add?access_token=cf90339d1de8188623fd7bac32a99736&version=1.0.0&timestamp=1640001019&sign=bead14a668e94eb1b3883f7d5d7b34f013bac6bc&taxpayer_name=Tom测试企业&identifier=18923123654521 HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded

返回参数说明¶

参数说明	描述
code	返回码，0代表正确返回
msg	如果错误，返回错误信息。
data	如果没有错误，返回纳税人id

正确返回示例¶

{
  "code": 0,
  "msg": "OK",
  "data": 2346
}

错误返回示例¶

{
  "code": 1000210001,
  "msg": "timestamp check failed!",
  "data": null
}