企业经营凭证核验

产品详情

提交查询

1、接口描述

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

2、请求地址

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

3、请求头说明

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

4、请求参数说明

参数名称	参数值描述	示例	类型	必填
account	APIID（用户中心【认证核验】-【企业信息验证】-【产品总览】查看)	xxxxxxxx	string	是
password	1、APIKEY(用户中心【认证核验】-【企业信息验证】-【产品总览】查看) 2、动态密码（生成动态密码方式请看该文档末尾的说明）	xxxxxxxxx	string	是
inv_code	发票代码（发票种类为全电发票时发票代码为空，其它必填）	031001900111	string	否
inv_no	发票号码	263170000011******35	string	是
inv_time	开票日期，格式：YYYYMMDD	20260401	string	是
inv_other	不含税金额（发票类型为增值税专用发票、货运运输业增值税专用发票、机动车销售统一发票、二手车发票时此字段不可为空；增值税专用发票、货运运输业增值税专用发票、机动车销售统一发票填写不含税金额；二手车发票，填写发票车价合计；发票种类为电子发票（不包含数电纸质发票），填写价税合计。金额格式：90.00)	1115.76	string	否
check_code	校验码(校验码后六位（发票类型为增值税普通发票、增值税普通发票（电子）、增值税普通发票（卷式）、通行费发票时不可为空）)	965535	string	否
time	Unix时间戳（10位整型数字，当使用动态密码方式时为必填）	1623643787	string	否

5、响应参数

参数名称	参数值描述	示例	类型	必返
code	返回值为2时，表示提交成功	2\|1	int
msg	提交结果描述	查询成功\|查询失败	string
idcardid	当提交成功后，此字段为流水号，否则为0或空	16236437872836\|0	string
result	查询结果		object
info	信息详情		object
invoiceList	发票信息列表		array

6、响应状态码说明

code	msg
0	未知错误
1	提交失败
2	提交成功
400	非法ip访问
401	帐号不能为空
402	密码不能为空
403	应用不存在
406	企业名称、统代、组织机构代码、工商注册号四选一
405	API ID 或 API KEY 不正确
4050	账号被冻结
40501	动态密码已过期
40502	动态密码校验失败
40505	没有签定合同
4051	剩余条数不足
4052	访问 ip 与备案 ip 不符
4086	通道无效
4010	通道错误
4202	发票代码格式有误
4203	校验码不能为空
4204	校验码格式有误
4205	金额不可以为空
4206	发票号码格式有误
4207	开票日期格式有误
4208	接口查验数据返回为空，请检查
4209	请求数据为空，请检查
4210	请求数据格式有误，请检查
4211	接口返回异常
4212	请求参数有误，请检查
4214	超过该张票当天查验次数
4215	发票查验请求太频繁，请稍后再试
4216	超过服务器最大请求数，请稍后访问
4217	请求不合法
4220	已超过最大查验量
4221	查询发票不规范
4222	查验异常
4223	网络超时，请重试
4224	内部错误
4225	日期当天不能查验
4226	超过一年不能查验
4227	没有查验权限
4228	不存在这样的地区编码
4229	当前地区发票查验服务不稳定，请稍后重试

7、GET传参示例

https://api.ihuyi.com/idcard/entvob/Submit.json?account=xxxxxxxx&password=xxxxxxxxx&inv_code=031001900111&inv_no=263170000011******35&inv_time=20260401&inv_other=1115.76&check_code=965535&

8、响应示例

示例（成功）

<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>2</code><msg>查询成功</msg><idcardid>16236437872836</idcardid><result><info><invoiceList></invoiceList></info></result></SubmitResult>

{    "code":
            2
        ,        "msg":
            "查询成功"
        ,        "idcardid":
            "16236437872836"
        ,        "result":
                {    "info":
                {    "invoiceList":
            ""
            }
                }
                }

示例（失败）

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

{"code":1,"msg":"查询失败"}

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

$account = 'xxxxxxxx';
$password = 'xxxxxxxxx';
$app = 'entvob'; //固定值
$ent_name = '';
$ent_code = '';
$time = '1623643787';
$password=md5($account.$password.$app.$ent_name.$ent_code.$time);
$password=md5('xxxxxxxxxxxxxxxxxentvob1623643787');

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

企业经营凭证核验

提交查询

1、接口描述

2、请求地址

3、请求头说明

4、请求参数说明

5、响应参数

6、响应状态码说明

7、GET传参示例

8、响应示例

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

10、代码示例

5分钟快速自助开通免费体验账户