短信签名快速报备,马上注册寻求客户经理支持!
所有文档
企业信息核验
文档中心 > 企业信息核验 > 企业一般纳税人核查

企业一般纳税人核查


提交查询

1、接口描述

请求支持 POST 和 GET 两种方法,字符编码为 utf-8 ,支持全天24小时发送。

2、请求地址

https://api.ihuyi.com/idcard/enttax/Submit.json

3、请求头说明

参数名称 参数值描述 示例 类型 必填
Content-Type 内容类型,固定值 application/x-www-form-urlencoded string

4、请求参数说明

参数名称 参数值描述 示例 类型 必填
account APIID(用户中心【认证核验】-【企业信息验证】-【产品总览】查看) xxxxxxxx string
password 1、APIKEY(用户中心【认证核验】-【企业信息验证】-【产品总览】查看)
2、动态密码(生成动态密码方式请看该文档末尾的说明)
xxxxxxxxx string
ent_name 企业名称(ent_name、ent_code、organization_code、reg_no四选一传递) 上海************有限公司 string
ent_code 社会信用代码(ent_name、ent_code、organization_code、reg_no四选一传递) 913****** string
organization_code 组织机构代码(ent_name、ent_code、organization_code、reg_no四选一传递) 403925****** string
reg_no 注册号(ent_name、ent_code、organization_code、reg_no四选一传递) 403925****** string
time Unix时间戳(10位整型数字,当使用动态密码方式时为必填) 1623643787 string

5、响应参数

参数名称 参数值描述 示例 类型 必返
code 返回值为2时,表示提交成功 2|1 int
msg 提交结果描述 查询成功|查询失败 string
idcardid 当提交成功后,此字段为流水号,否则为0或空 16236437872836|0 string
result 认证结果 object
total 总数 1 string
lists[] 数据列表 array
area 经营地址 上海市************ string
entityName 企业名称 上海************有限公司 string
taxpayerType 纳税人资格 增值税一般纳税人 string
taxDepartment 所属税务机关 国家税务总局上海市金山区税务局第十二税务所 string
judgeDate 认定日期 2012-02-23 string
startDate 有效日期起 string
endDate 截止日期 string
taxpayerStatus 纳税人状态 正常 string
exportStatusRecord 进出口备案状态 非出口退(免)税企业 string
duty 扣缴义务 string
isDeclareQuarter 是否按季申报 string
isTaxpayerStatus 是否具有资格 string
websiteUrl 网页链接 http://shanghai.chinatax.gov.cn string
taxpayerCode 纳税人识别号 913******** string
legalPerson 法人姓名 张三 string
taxManager 税务管理员 张三 string

6、响应状态码说明

code msg
0 未知错误
1 提交失败
2 提交成功
400 非法ip访问
401 帐号不能为空
402 密码不能为空
403 应用不存在
404 姓名不能为空
4041 姓名格式不正确(2-10个中文汉字)
406 企业名称、统代、组织机构代码、工商注册号四选一
4061 身份证格式不正确
405 API ID 或 API KEY 不正确
4050 账号被冻结
40501 动态密码已过期
40502 动态密码校验失败
40505 没有签定合同
4051 剩余条数不足
4052 访问 ip 与备案 ip 不符
4086 通道无效
4010 通道错误
4201 查询无结果
4202 查询失败
4203 参数有误或者不支持查询关键字,请检查

7、GET传参示例

https://api.ihuyi.com/idcard/enttax/Submit.json?account=xxxxxxxx&password=xxxxxxxxx&ent_name=上海************有限公司&ent_code=913******&organization_code=403925******&reg_no=403925******&time=1623643787

8、响应示例

示例(成功)

<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>2</code><msg>查询成功</msg><idcardid>16236437872836</idcardid><result><total>1</total><lists><list><area>上海市************</area><entityName>上海************有限公司</entityName><taxpayerType>增值税一般纳税人</taxpayerType><taxDepartment>国家税务总局上海市金山区税务局第十二税务所</taxDepartment><judgeDate>2012-02-23</judgeDate><startDate></startDate><endDate></endDate><taxpayerStatus>正常</taxpayerStatus><exportStatusRecord>非出口退(免)税企业</exportStatusRecord><duty></duty><isDeclareQuarter>月</isDeclareQuarter><isTaxpayerStatus></isTaxpayerStatus><websiteUrl>http://shanghai.chinatax.gov.cn</websiteUrl><taxpayerCode>913********</taxpayerCode><legalPerson>张三</legalPerson><taxManager>张三</taxManager></list><list><area>上海市************</area><entityName>上海************有限公司</entityName><taxpayerType>增值税一般纳税人</taxpayerType><taxDepartment>国家税务总局上海市金山区税务局第十二税务所</taxDepartment><judgeDate>2012-02-23</judgeDate><startDate></startDate><endDate></endDate><taxpayerStatus>正常</taxpayerStatus><exportStatusRecord>非出口退(免)税企业</exportStatusRecord><duty></duty><isDeclareQuarter>月</isDeclareQuarter><isTaxpayerStatus></isTaxpayerStatus><websiteUrl>http://shanghai.chinatax.gov.cn</websiteUrl><taxpayerCode>913********</taxpayerCode><legalPerson>张三</legalPerson><taxManager>张三</taxManager></list><list><area>上海市************</area><entityName>上海************有限公司</entityName><taxpayerType>增值税一般纳税人</taxpayerType><taxDepartment>国家税务总局上海市金山区税务局第十二税务所</taxDepartment><judgeDate>2012-02-23</judgeDate><startDate></startDate><endDate></endDate><taxpayerStatus>正常</taxpayerStatus><exportStatusRecord>非出口退(免)税企业</exportStatusRecord><duty></duty><isDeclareQuarter>月</isDeclareQuarter><isTaxpayerStatus></isTaxpayerStatus><websiteUrl>http://shanghai.chinatax.gov.cn</websiteUrl><taxpayerCode>913********</taxpayerCode><legalPerson>张三</legalPerson><taxManager>张三</taxManager></list></lists></result></SubmitResult>
{    "code":
            2
        ,        "msg":
            "查询成功"
        ,        "idcardid":
            "16236437872836"
        ,        "result":
                {    "total":
                "1"
                    ,        "lists":
                    [    {    "area":
            "上海市************"
        ,        "entityName":
            "上海************有限公司"
        ,        "taxpayerType":
            "增值税一般纳税人"
        ,        "taxDepartment":
            "国家税务总局上海市金山区税务局第十二税务所"
        ,        "judgeDate":
            "2012-02-23"
        ,        "startDate":
            ""
        ,        "endDate":
            ""
        ,        "taxpayerStatus":
            "正常"
        ,        "exportStatusRecord":
            "非出口退(免)税企业"
        ,        "duty":
            ""
        ,        "isDeclareQuarter":
            "月"
        ,        "isTaxpayerStatus":
            ""
        ,        "websiteUrl":
            "http://shanghai.chinatax.gov.cn"
        ,        "taxpayerCode":
            "913********"
        ,        "legalPerson":
            "张三"
        ,        "taxManager":
            "张三"
                }
    ,        {    "area":
            "上海市************"
        ,        "entityName":
            "上海************有限公司"
        ,        "taxpayerType":
            "增值税一般纳税人"
        ,        "taxDepartment":
            "国家税务总局上海市金山区税务局第十二税务所"
        ,        "judgeDate":
            "2012-02-23"
        ,        "startDate":
            ""
        ,        "endDate":
            ""
        ,        "taxpayerStatus":
            "正常"
        ,        "exportStatusRecord":
            "非出口退(免)税企业"
        ,        "duty":
            ""
        ,        "isDeclareQuarter":
            "月"
        ,        "isTaxpayerStatus":
            ""
        ,        "websiteUrl":
            "http://shanghai.chinatax.gov.cn"
        ,        "taxpayerCode":
            "913********"
        ,        "legalPerson":
            "张三"
        ,        "taxManager":
            "张三"
                }
    ,        {    "area":
            "上海市************"
        ,        "entityName":
            "上海************有限公司"
        ,        "taxpayerType":
            "增值税一般纳税人"
        ,        "taxDepartment":
            "国家税务总局上海市金山区税务局第十二税务所"
        ,        "judgeDate":
            "2012-02-23"
        ,        "startDate":
            ""
        ,        "endDate":
            ""
        ,        "taxpayerStatus":
            "正常"
        ,        "exportStatusRecord":
            "非出口退(免)税企业"
        ,        "duty":
            ""
        ,        "isDeclareQuarter":
            "月"
        ,        "isTaxpayerStatus":
            ""
        ,        "websiteUrl":
            "http://shanghai.chinatax.gov.cn"
        ,        "taxpayerCode":
            "913********"
        ,        "legalPerson":
            "张三"
        ,        "taxManager":
            "张三"
                }
        ]
            }
                }

示例(失败)

<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>1</code><msg>查询失败</msg></SubmitResult>
{"code":1,"msg":"查询失败"}

9、PHP生成动态密码方式代码示例

$account = 'xxxxxxxx';
$password = 'xxxxxxxxx';
$app = 'enttax'; //固定值
$ent_name = '上海************有限公司';
$ent_code = '913******';
$time = '1623643787';
$password=md5($account.$password.$app.$ent_name.$ent_code.$time);
$password=md5('xxxxxxxxxxxxxxxxxenttax上海************有限公司913******1623643787');

//注意:所有字符编码统一为UTF-8

10、代码示例

在线咨询
服务热线:
4008 808 898

免费体验

提交成功
若短信发送异常,系统将自动给您发送语音验证码,请注意接听电话。

填写验证码后,点击“开通体验账户”自动开通体验账户。

收不到短信验证码?
×