纳税人新增

请求URL

https://openapi.guanaitong.tech/taxpayer/add

HTTP请求方式

POST

输入参数说明

(1)公共参数

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

(2)私有参数

参数名称	是否必须	参数类型	长度限制	描述
taxpayer_name	是	string	[1,100]	纳税人名称（抬头）
enterprise_code	否	string	[1,20]	企业编号（集团和运营商同步,企业不填）
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,50]	银行账号

请求示例

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

返回参数说明

参数名称	描述
code	返回码。详见错误代码。
msg	如果错误，返回错误信息。
data	如果没有错误，返回纳税人id

正确返回示例

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

错误返回示例

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