1)增票查验
功能说明
从国税总局,查询增值税发票有效性。
注意事项:
1、当日开具发票,请于次日查询。
2、每份发票,每天最多可查验5次。以国税总局全国查验次数为准。
3、可查询一个自然年内开具的增值税发票。
4、查验发票类型:
- 增值税专用发票
- 增值税普通发票(含电子普通发票、卷式发票、通行费发票)
- 机动车销售统一发票
- 货物运输业增值税专用发票
- 二手车销售统一发票
接口调用请求说明
URL | http://api.smarttax.net/openapi/v2.0/common/invoice/check |
HTTP方法 | POST |
参数说明
字段名 | 数据类型 | 备注 | 是否必填 |
---|---|---|---|
accessToken | string | 授权Token。 由“获取AccessToken”接口获取。请注意有效期。 |
必填 |
requestToken | string | 请求Token。 由请求端随机生成,内容为16位随机字母数字,大小写敏感。 |
必填 |
taxDeviceType | int | 税盘设备类型: 1:金税盘(航天) 2:税控盘(百旺) |
必填 |
taxCode | string' | 纳税识别号 | 必填 |
taxMac | string | 税盘机器识别码 | 必填 |
invoiceNo | string | 发票代码/td> | 必填 |
invoiceNum | string | 发票号码 | 必填 |
gmtCreate | int | 开票日期 格式:yyyy-MM-dd | 必填 |
amount | BigDecmial | 开票金额(不含税) | 专票必填 |
checkCode | string | 校验码后六位 | 普票必填(纸票和电票) |
返回说明
字段名 | 数据类型 | 备注 | 是否必填 |
---|---|---|---|
requestToken | string | 请求Token | 必填 |
invNo | string | 发票代码 | 必填 |
invNum | string | 发票号码 | 必填 |
createDate | string | 开票日期 | 必填 |
buyer | string | 购方名称 | 必填 |
buyTaxNum | string | 购方税号 | 必填 |
buyAddress | string | 购方地址、电话 | 专票必填 |
buyAccount | string | 购方银行账号 | |
seller | string | 销方名称 | 必填 |
sellerTaxNum | string | 销方税号 | 非个人必填 |
sellerAdd | string | 销方地址、电话 | 专票必填 |
sellerBank | string | 销方银行账号 | |
deviceCode | string | 机器编码 | 必填 |
invType | string | 发票类型 | 必填 |
checkCode | string | 校验码 | |
delIde | string | 作废标志 | |
money | string | 金额(不含税) | 必填 |
taxMoney | string | 税额 | 必填 |
allMoney | string | 价税合计 | 必填 |
checkCount | int | 查验次数(该发票在国税总局的查验次数,不含当天) | 必填 |
subDetails | list | 明细信息 | 必填 |
返回subDetails说明
字段名 | 数据类型 | 备注 | 是否必填 |
---|---|---|---|
seqNo | string | 行序号 | 必填 |
itemName | string | 商品名称 | 必填 |
spec | string | 规格 | |
itemUnit | string' | 单位 | |
amount | BigDecmial | 数量 | 必填 |
itemPrice | BigDecmial | 单价(不含税) | 必填 |
money | BigDecmial | 金额(不含税) | 必填 |
taxRate | BigDecmial | 税率 | 必填 |
taxMoney | BigDecmial | 税额 | 必填 |
返回码说明
返回码 | 说明 |
---|---|
0000 | 接口调用成功,且有发票明细数据 |
0010 | content解析异常 |
0021 | S000401调用失败 |
CY0001 | 发票类型不能为空 |
CY0002 | 专票未税金额不能为空/车价合计不能为空 |
CY0003 | 普票后六位校验码不能为空 |
CY0004 | 普票后六位校验码格式错误 |
CY0005 | 发票代码格式错误 |
CY0006 | 发票号码格式错误 |
CY0007 | 开票日期格式错误 |
CY0008 | 一年以前开具的发票无法查询 |
CY0009 | 开票日期格式校验异常 |
CY0010 | 专票未税金额格式错误/车价合计格式错误 |
CY0011 | 该张发票超出当天查验次数 |
CY0012 | 网络异常 |
CY0013 | 网络超时 |
CY0014 | 发票查验请求太频繁,请稍后再试 |
CY0015 | 超过服务器最大请求数,请稍后访问 |
CY0016 | 请求不合法 |
CY0017 | 发票数据不一致 |
CY0018 | 查无此票 |
CY0019 | 服务器网络异常,未获取的发票信息 |
CY0020 | 服务器接收的请求太频繁,请稍后再试 |
CY0021 | 不存在这样的地区编码 |
CY0022 | 发票代码不合法 |
CY0023 | 发票号码不合法 |
CY0024 | 开票日期不合法 |
CY0025 | 开票金额或校验码不合法 |
CY0026 | 当日开具发票可于次日进行查验 |
CY0027 | 未知异常,请联系管理员 |
CY0028 | 其他异常 |
CY0029 | 内部异常,请联系管理员 |
CY0030 | 该张票超过当天查验次数(税局) |
CY0031 | 查验失败,请稍后重试 |