当前位置:
  1. 资源中心
  2. 发票查验API
发票查验API
乐税发票查验API支持全国的增值税专用发票、增值税普通发票(含电子普通发票、卷式发票)、机动车销售统一发票、货物运输业增值税专用发票的查验及全票面信息的获取。
产品亮点
  • 1、一站式服务,销项开具、发票查验、发票验真、发票认证等一键搞定
  • 2、发票明细,最方便、稳定、高效的发票明细数据获取,支持电子数据下载
  • 3、安全无忧,直连官方网站,丰富安全策略,确保您的数据安全
  • 4、对接方便,多种发票信息采集和应用提供方式,满足您各种不同需求
  • 5、产品全面,多种产品,支持移动采集、影像、在线、自部署等不同应用场景
产品规格(识别成功每次扣除15点,查验成功每次扣除15点,试用赠送400点)
10元/500点
50元/2500点
100元/5000点
200元/10000点
  • 服务商
    : 乐税科技(北京)有限公司
  • 在线时间
    : 9:00-18:00
  • 电话
    : 186-0004-0500

invoiceInfoForCom(根据发票代码、发票号码等进行查验)

企业  个人   免费送测试点     收费


公共参数


请求地址:

环境请求地址
正式环境https://open.lskj365.com/api/invoiceInfoForCom


支持格式


JSON(需指定contentType=application/json)


HTTP请求方式


POST


是否需要登录


是 (关于登录授权,参见如何登录授权)


发票查验接口demo下载


JAVA_Demo下载   |   Python_Demo下载   |    .net_Demo下载  | PHP_demo下载


支持票种


支持的增值税发票种类:

增值税普通发票,增值税专用发票,增值税电子普通发票,卷式发票,通行费发票,机动车销售统一发票,二手车发票,增值税电子专用发票,电子发票(增值税专用发票),电子发票(普通发票),电子发票(铁路电子客票),电子发票(航空运输电子客票行程单),数电纸质发票(增值税专用发票),数电纸质发票(普通发票)。


注意事项


1.接口暂不支持批量查票,您可以自己做并发处理,但是建议并发数不要超过10张,如果可以的话,将相同地区的发票放在一起查,这样速度和效率会更高。

2.不同发票请求参数是不同的,请按照要求进行传值 【请求参数链接】。

3.返回发票的内容根据不同发票种类有所不同,现在有四种返回结果,建议根据文档进行判断解析发票内容【返回参数链接】 【返回示例链接】。

4.根据返回错误码可以判断是否需要再次请求,是否是参数输入有误,是否是账号余额不足等原因,请认真参考文档 【返回码链接】。

5.invoiceResult字段是一个字符串,需要解析成json对象,才能使用。

6.卷式发票使用扫描查票时,建议检测一下二维码是否完整,因为税局软件问题,生成二维码不全。


请求参数


名称类型是否必须描述
invoiceCodeString发票代码。数电发票没有发票代码,其他类型的发票必填
invoiceNumberString发票号码。
billTimeString开票日期。格式为:yyyy-MM-dd,如:2017-05-11,不支持其他格式    
checkCodeString校验码后六位。
invoiceAmountString金额。不含税价或价税合计。
tokenString授权码


参数说明


请求参数根据所查验的票种而定:

  • 增值税专用发票、增值税电子专用发票:发票代码、发票号码、开票日期和开具金额(不含税);
  • 增值税普通发票、增值税电子普通发票(含通行费发票)、增值税普通发票(卷票):发票代码、发票号码、开票日期和校验码后6位;
  • 机动车销售统一发票:发票代码、发票号码、开票日期和不含税价;
  • 二手车销售统一发票发票:发票代码、发票号码、开票日期和车价合计;
  • 电子发票(普通发票)、电子发票(增值税专用发票):发票号码、开票日期和价税合计;
  • 电子发票(铁路电子客票):发票号码、开票日期和票价;
  • 电子发票(航空运输电子客票行程单):发票号码、开票日期和价税合计;
  • 全电纸质发票(增值税专用发票):发票代码、发票号码、开票日期和开具金额(不含税);
  • 全电纸质发票(普通发票):发票代码、发票号码、开票日期和校验码后6位(密码区全电发票号码后6位);


返回参数



名称类型示例值描述
RtnCodeString00或9900:成功,99:失败
resultCodeString1000或2001查询发票状态码,1000:查询到票的信息,2001:没有查询到票的信息
invoicefalseCodeString201,210,220等失败状态码,如果resultCode为1000,该字段不返回,如果resultCode为2001,会返回不同类型错误码            
resultMsgString查验结果成功提示信息,resultCode为1000返回:查验结果成功,resultCode为2001返回对应invoicefalseCode的错误信息              
invoiceNameString江苏增值税(专用发票)发票名称            
invoiceResultString数据查询结果,详情请查看返回业务参数(不同票种对应不同返回业务参数)            
isFreeStringY或N查询是否免费,Y:是,N:否


返回业务参数一(普通发票,专用发票,增值税电子普通发票,卷式发票,通行费发票,电子发票(增值税专用发票),电子发票(普通发票))


名称类型示例值描述
invoiceDataCodeString1100162130发票代码
invoiceNumberString11555290发票号码
invoiceTypeNameString北京增值税(专用发票)            发票类型名称
invoiceTypeCodeString01或02,03,04,08,10,11发票类型:01-增值税专用发票;03-机动车销售统一发票;04-增值税普通发票;08-增值税电子专用发票;10-增值税电子普通发票;11-卷式普通发票;14-电子普通[通行费]发票;15-二手车统一发票;31-电子发票(增值税专用发票);32-电子发票(普通发票);51-电子发票(铁路电子客票);61-电子发票(航空运输电子客票行程单)
billingTimeString2017-06-29开票日期
checkDateString2018-01-09 09:24:54查询日期
checkNumString查验次数
checkCodeString6……67校验码            
taxDiskCodeString499912031913机器码
purchaserNameString神州易泰信息服务(北京)有限公司购方名称
taxpayerNumberString110108344363729购方纳税人识别号
taxpayerBankAccountString招商银行股份有限公司北京双榆树支110917330210901购方银行账号
taxpayerAddressOrIdString北京市海淀区蓝靛厂东路2号院2号楼(金源时代商务中心2号楼)1单元(A座)16C 88895883购方地址,电话
salesNameString北京腾信软创科技股份有限公司销方名称
salesTaxpayerNumString110108666949407销方纳税人识别号
salesTaxpayerBankAccountString招商银行北京中关村支行860380483310001销方银行,账号
salesTaxpayerAddressString北京市海淀区苏州街79号4层401室010-62133361销方地址,电话
totalTaxSumString49814.99价税合计
totalTaxNumString2819.72税额            
totalAmountString46995.27不含税价(金额)
invoiceRemarksString备注            
isBillMarkStringY或N是否为清单票,Y:是,N:否
voidMarkString0或1作废标志,0:正常,1:作废
invoiceStatusString发票状态。
00:正常
10:作废
20:红票
30:红冲
40:部分红冲
50:全额红冲
goodsClerkString陈六英收货员(卷式发票新增字段,其他票可以不用)
tollSignString07收费标志(06:可抵扣通行费 07:不可抵扣通行费,08:成品油)支持票种:普通发票,专用发票,卷式发票,普通增值税(通行费),普通增值税(折叠费)
tollSignNameString成品油收费标志名称(没有为空)


> 货物详情一(普通发票,专用发票,增值税电子普通发票,卷式发票,电子发票(增值税专用发票),电子发票(普通发票))

  名称类型   示例值   描述
invoiceDetailDataString[{
       "unit": "s",
       "model": "",
       "price": "990000",
       "tax": "168300.00",
       "taxRate": "17%",
       "isBillLine": "N",
       "goodserviceName": "px2345",
       "sum": "990000",
       "lineNum": "1",
       "number": "1",
       "zeroTaxRateSign": "",
       "zeroTaxRateSignName": ""
   }
]
发票详情(数组,多条数据):
[{
       "unit": "单位",
       "model": "型号",
       "isBillLine": "是否是清单行(Y:是,N:否)",
       "price": "单价",
       "tax": "税额",
       "taxRate": "税率",
       "goodserviceName": "货劳务名称",
       "sum": "金额",
       "number": "数量",
       "zeroTaxRateSign": "零税率标志",
       "zeroTaxRateSignName": "零税率标志名称"
   }
]


> 货物详情二(通行费发票)

  名称类型   示例值   描述
invoiceDetailDataString[{
       "lineNum": "1",
       "goodserviceName": "*经营租赁*通行费",
       "plateNo": "辽CB6097",
       "passStartDate": "20180101",
       "passEndDate": "20180101",
       "sum": "334.95",
       "model": "货车",
       "taxRate": "3%",
       "tax": "10.05",
       "isBillLine": "N",
       "zeroTaxRateSign": "",
       "zeroTaxRateSignName": ""
   }
]
发票详情(数组,有多条数据):
[{
        "goodserviceName": "货劳务名称",
        "plateNo": "车牌号",
        "passStartDate": "通行日期起",
        "passEndDate": "通行日期止",
        "tax": "税额",
        "taxRate": "税率",
        "sum": "金额",
        "isBillLine": "是否是清单行(Y:是,N:否)",
        "zeroTaxRateSign": "零税率标志",
        "zeroTaxRateSignName": "零税率标志名称"
    }
]

返回业务参数二(xx增值税(机动车销售统一发票))


名称类型示例值描述
invoiceDataCodeString144031...160发票代码
invoiceNumberString0062..68发票号码
invoiceTypeNameString深圳增值税(机动车销售统一发票)            发票类型名称
billingTime
         
String2017-09-11开票日期
checkDateString2018-01-09 09:24:54查询日期
checkNumString查验次数
machineCodeString144031...160机打代码
machineNumberString0062..68机打号码
taxDiskCodeString6615..671458机器编号
purchaserNameString陈*坤购方名称
taxpayerIdOrOrginCodeString41282....211187612身份证号码/组织机构代码
taxpayerNumberString0000000..000000购方识别号
vehicleTypeString轿车车辆类型
brandTypeString雪佛兰牌/SGM7154EAA1厂牌类型
producingAreaString上海市产地
certifNumberStringWAE271..0265593合格证号
totalTaxSumString124520.00价税合计
inspectionOrderString商检单号
engineNumberString1721..425发动机号码
frameNumbrStringLSGGJ5457JS00..33车辆识别代号/车架号码
importCertifString进口证明书号
salesNameString深圳市xxxx汽车销售服务有限公司销货单位名称
salesTaxpayerTelString0755-2592..00电话
salesTaxpayerNumString914403….7581533G销货方纳税人识别号
salesTaxpayerAccountString中国银行彩虹支行75..57957081销货方开户银行
salesTaxpayerAddressString深圳市罗湖区….xx号销货方地址
salesTaxpayerBankString中国银行深圳彩虹支行…795708销方银行账号
taxRateString17%增值税税率/或征收率
totalTaxNumString18092.65税额
taxOfficeNameString深圳市罗湖区国家税务局税源管理三科<br/>144….1000主管税务机关及代码
totalAmountString106427.35不含税价(金额)
taxReceiptCodeString完税凭证号码
tonnageString吨位
limitNumString5限乘人数
invoiceTypeCodeString01或02,03,04,10,11发票类型:01-增值税专用发票;03-机动车销售统一发票;04-增值税普通发票;08-增值税电子专用发票;10-增值税电子普通发票;11-卷式普通发票;14-电子普通[通行费]发票;15-二手车统一发票;31-电子发票(增值税专用发票);32-电子发票(普通发票);51-电子发票(铁路电子客票);61-电子发票(航空运输电子客票行程单)
voidMarkString0或1作废标志,0:正常,1:作废
invoiceStatusString发票状态。
00:正常
10:作废
20:红票
30:红冲
40:部分红冲
50:全额红冲
invoiceRemarksString备注(可以不用)


返回业务参数三(xx增值税(二手车销售统一发票))

名称类型示例值描述
invoiceDataCodeString01400.....17发票代码
invoiceNumberString00108..1发票号码
invoiceTypeNameString山西增值税(二手车销售统一发票)            发票类型名称
billingTime
         
String2018-04-01开票日期
checkDateString2018-04-08 15:23:11查询日期
checkNumString查验次数
taxDiskCodeString499099...309机器编号
purchaserNameString刘**买方名称/个人
taxpayerIdOrOrginCodeString23012...6204160017买方单位代码/身份证号码
taxpayerAddressString辽宁省...买方单位/个人住址
taxpayerTelString654..97(买方)电话
salesNameString王**卖方单位/个人
salesTaxpayerNumString1400....029卖方单位代码/身份证号码
salesTaxpayerAddressString山西省...卖方单位/个人住址
salesTaxpayerTelString857....(卖方)电话
plateNoString晋......车牌号
registNoString1400.....29登记证号
vehicleTypeString小型普通*车车辆类型
frameNumbrStringLJXCM......车辆识别代号/车架号码
brandTypeString江铃.......厂牌型号
vehicleOfficeNameString辽宁省大连市车管所转入地车辆管理所名称
totalTaxSumString10000.00车价合计
auctionUnitNameString山西****
经营、拍卖单位
auctionUnitAddressString深圳市罗湖区….xx号经营、拍卖单位地址
auctionUnitNoString…795708(经营、拍卖单位)纳税人识别号
auctionUnitBankAccountString(经营、拍卖单位)开户银行、账号
auctionUnitTelString(经营、拍卖单位)电话
secondHandMarketString山西旧机动车交易中心(有限责任公司)二手车市场
secondHandMarketNoString911......(二手车市场)纳税人识别号
marketAddressString山西省太原市...(二手车市场)地址
marketBankAccountString兴业银行..支行48...(二手车市场)开户银行、账号
marketTelString0351-....(二手车市场)电话
invoiceTypeCodeString01或02,03,04,10,11发票类型:01-增值税专用发票;03-机动车销售统一发票;04-增值税普通发票;08-增值税电子专用发票;10-增值税电子普通发票;11-卷式普通发票;14-电子普通[通行费]发票;15-二手车统一发票;31-电子发票(增值税专用发票);32-电子发票(普通发票);51-电子发票(铁路电子客票);61-电子发票(航空运输电子客票行程单)
voidMarkString0或1作废标志,0:正常,1:作废
invoiceStatusString发票状态。
00:正常
10:作废
20:红票
30:红冲
40:部分红冲
50:全额红冲
invoiceRemarksString备注


返回业务参数四(电子发票(铁路电子客票))

stationTo名称类型示例值描述
invoiceNumberString24548088***000447807发票号码
invoiceTypeNameString电子发票(铁路电子客票)发票类型名称
invoiceTypeCodeString61发票类型:01-增值税专用发票;03-机动车销售统一发票;04-增值税普通发票;08-增值税电子专用发票;10-增值税电子普通发票;11-卷式普通发票;14-电子普通[通行费]发票;15-二手车统一发票;31-电子发票(增值税专用发票);32-电子发票(普通发票);51-电子发票(铁路电子客票);61-电子发票(航空运输电子客票行程单)
billingTimeString2017-06-29开票日期
checkDateString2024-11-11 09:24:54查询日期
checkNumString 查验次数
purchaserNameString 购方名称
businessTypeString业务类型
taxpayerNumberString 购方纳税人识别号
totalTaxSumString票价
totalTaxNumString税额
totalAmountString不含税价
taxRateString9%税率
stationFromString出发站
stationToString到达站
trainNumberString车次
departureDateString出发日期
departureTimeString出发时间
seatClassString席别
carriageNumberString车厢
seatString席位
ticketTypeString票种
airConditioningFeaturesString空调特征
nameString 姓名
idNumberString 证件号码
eticketNumberString 电子客票号码
invoiceRemarksString备注
voidMarkString0或1作废标志(0:正常,1:作废)
invoiceStatusString 发票状态。
00:正常
10:作废
20:红票
30:红冲
40:部分红冲
50:全额红冲


返回业务参数五(电子发票(航空运输电子客票行程单))

类型示例值描述
invoiceNumberString24548088***000447807发票号码
invoiceTypeNameString电子发票(航空运输电子客票行程单) 发票类型名称
invoiceTypeCodeString61发票类型:01-增值税专用发票;03-机动车销售统一发票;04-增值税普通发票;08-增值税电子专用发票;10-增值税电子普通发票;11-卷式普通发票;14-电子普通[通行费]发票;15-二手车统一发票;31-电子发票(增值税专用发票);32-电子发票(普通发票);51-电子发票(铁路电子客票);61-电子发票(航空运输电子客票行程单)
billingTimeString2017-06-29开票日期
checkDateString2018-01-09 09:24:54查询日期
checkNumString 查验次数
purchaserNameString 购方名称
taxpayerNumberString 购方纳税人识别号
totalTaxSumString49814.99价税合计
totalTaxNumString2819.72税额
domesticOrIntlString国内国内国际标识
gpNoStringGP2406**641000GP单号
nameString 姓名
idNumberString 证件号码
eticketNumberString 电子客票号码
invoiceRemarksString备注
voidMarkString0或1作废标志(0:正常,1:作废)
invoiceStatusString 发票状态。
00:正常
10:作废
20:红票
30:红冲
40:部分红冲
50:全额红冲

> 详情(电子发票(航空运输电子客票行程单))

  名称类型   示例值   描述
invoiceDetailDataString[{
       "lineNum": "1",
       "stationFrom": "成都-双流 T2",
       "stationTo": "上海-虹桥 T2",
       "carrier": "西藏",
       "flightNo": "TVXXX",
       "seatClass": "L",
       "departureDate": "2024-06-28",
       "departureTime": "10:00",
       "ticketClass": "LGP95"
   }
]
发票详情(数组,多条数据):
[{
        "lineNum": "航段",
        "stationFrom": "始发站",
        "stationTo": "目的站",
        "carrier": "承运人",
        "flightNo": "航班号",
        "seatClass": "座位等级",
        "departureDate": "承运日期",
        "departureTime": "起飞时间",
        "ticketClass": "客票级别/客票类型"
    }
]



返回码



序号返回码是否收费返回信息说明
100RtnCode:00,查询成功
299RtnCode:99,查询失败
31000查询到发票明细信息
42001没有查询到发票信息,请查看invoicefalseCode对应状态码信息没有查询到发票信息,请查看invoicefalseCode对应状态码信息
5201invoicefalseCode:201,查无此票不要再次查询,请确认数据正确性。也可能发票尚未上传至税局
6202invoicefalseCode:202,查验失败:失败原因,超过该张发票的单日查验次数(5次),请于24小时之后再进行查验不要再次查询,今天查询已经达到上限
7210invoicefalseCode:210,代码或号码格式有误请确认数据正确性,调整后可再次查询
8211invoicefalseCode:211,您输入的发票信息不完全请确认数据正确性,调整后可再次查询
9213invoicefalseCode:213,查询失败,服务忙可再次查询
10216invoicefalseCode:216,您查询的发票是当日开具的,请于次日查询不要再次查询,今日发票尚未上传至税局
11217invoicefalseCode:217,过了查票期不要再次查询,只支持一年内发票查询
12218invoicefalseCode:218,税局查验服务暂时不可用,请稍后再试可再次查询
13219invoicefalseCode:219,您输入的发票暂时不支持查询不要再次查询,该票不支持查询
14220invoicefalseCode:220,您输入的发票信息不一致请确认数据正确性,调整后可再次查询            
15221invoicefalseCode:221,您输入的发票正在查询中,请不要重复提交请求不要再次查询
16230invoicefalseCode:230,您输入的发票日期格式不正确,请重新输入(格式2016-01-01)请确认数据正确性,调整后可再次查询            
17240invoicefalseCode:240,余额不足,请充值
18241invoicefalseCode:241,发票查询失败,请联系管理员