价格说明表
1元=100票点,申请试用,请联系客服。
查询方式 | 计价方式 | 价格(票点/次) | 备注 |
---|---|---|---|
接口新查 | 按次 | 15(0.15元) | 验证成功收费,“不一致”当日只收第一次查询费,其余失败不收费,调用量大请咨询客服 |
发票库 | 按次 | 0 | 不收费,缓存7天 |
接口描述
此接口是标准校验接口的升级简单版,传入发票基本信息:发票代码、发票号码、开票日期、校验码后6位(增值税普票必传)、不含税金额(增值税专票、机动车票必传)、票查查应用authCode进行查验.
请求说明
请求示例
HTTP 方法:GET/POST
请求URL:https://api.piaocc.com/rest/v_3/common_check.html?authCode=鉴权码&invoiceCode=发票代码&invoiceNo=发票号码&invoiceDate=开票日期&invoiceAmt=发票金额&checkCode=校验码后6位&useCache=是否需要缓存(发票库)
url请求参数说明如下:
请求参数
参数 | 是否必选 | 类型 | 说明 |
---|---|---|---|
authCode | 是 | string | 票查查应用鉴权码,个人中心 -> 应用管理 -> 新建应用 -> 获得应用鉴权码 |
invoiceCode | 是 | string | 发票代码(全电发票不需要填写) |
invoiceNo | 是 | string | 发票号码 |
invoiceDate | 是 | string | 开票日期,格式:yyyyMMdd,如:19990101 |
invoiceAmt | 否 | string | 增值税专票、机动车统一销售票传不含税金额,二手车销售发票、全电发票传价税合计金额 |
checkCode | 否 | string | 校验码后6位(增值税普票必传) |
useCache | 否 | string | 是否需要缓存(查询发票放入发票库),N-不需要,Y-需要,默认Y |
请求代码示例
提示一:使用示例代码前,请记得替换相应的参数值。
提示二:部分语言依赖的类或库,请在代码注释中查看下载地址。
#请先安装requests模块 url = 'https://api.piaocc.com/rest/v_3/common_check.html?authCode=&invoiceCode=&invoiceNo= &invoiceDate=&invoiceAmt=&checkCode=' r=requests.get(url) print r.text
//请先导入httpclient相应的包 HttpClient httpclient = HttpClients.createDefault(); HttpGet get = new HttpGet("https://api.piaocc.com/rest/v_3/common_check.html?authCode=&invoiceCode= &invoiceNo=&invoiceDate=&invoiceAmt=&checkCode="); HttpResponse response = httpclient.execute(get); System.out.println(EntityUtils.toString(response.getEntity()));
<?php $host = "https://api.piaocc.com"; $path = "/v_3/common_check.html?authCode=&invoiceCode=&invoiceNo=&invoiceDate=&invoiceAmt=&checkCode="; $method = "GET"; $url = $host . $path; $curl = curl_init(); curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method); curl_setopt($curl, CURLOPT_URL, $url); curl_setopt($curl, CURLOPT_FAILONERROR, false); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); curl_setopt($curl, CURLOPT_HEADER, false); if (1 == strpos("$".$host, "https://")) { curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false); curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false); } curl_setopt($curl, CURLOPT_POSTFIELDS, $bodys); echo curl_exec($curl); ?>
using System.IO; using System.Text; using System.Net; using System.Net.Security; using System.Security.Cryptography.X509Certificates; private const String host = "https://api.piaocc.com"; private const String path = "/rest/v_3/common_check.html?authCode=&invoiceCode=&invoiceNo=&invoiceDate= &invoiceAmt=&checkCode="; private const String method = "POST"; static void Main(string[] args) { String querys = ""; String url = host + path; HttpWebRequest httpRequest = null; HttpWebResponse httpResponse = null; if (0 < querys.Length) { url = url + "?" + querys; } if (host.Contains("https://")) { ServicePointManager.ServerCertificateValidationCallback = new RemoteCertificateValidationCallback (CheckValidationResult); httpRequest = (HttpWebRequest)WebRequest.CreateDefault(new Uri(url)); } else { httpRequest = (HttpWebRequest)WebRequest.Create(url); } httpRequest.Method = method; try { httpResponse = (HttpWebResponse)httpRequest.GetResponse(); } catch (WebException ex) { httpResponse = (HttpWebResponse)ex.Response; } Console.WriteLine(httpResponse.StatusCode); Console.WriteLine(httpResponse.Method); Console.WriteLine(httpResponse.Headers); Stream st = httpResponse.GetResponseStream(); StreamReader reader = new StreamReader(st, Encoding.GetEncoding("utf-8")); Console.WriteLine(reader.ReadToEnd()); Console.WriteLine("\n"); } public static bool CheckValidationResult(object sender, X509Certificate certificate, X509Chain chain, SslPolicyErrors errors) { return true; }
返回说明
响应码说明
响应码 | 说明 |
---|---|
200 | 成功 |
400 | 参数错误 |
403 | 无余额 |
405 | 访问受限(白名单限制) |
500 | 错误(详情参考message) |
返回结果示例
//----------------------------------标准发票-------------------------------------------- { "code":200,//响应码,200-成功,请参考响应码说明 "respTime": "2000-01-10 15:48:18",//响应时间 "message": "发票查验成功",//响应信息 "deduct": 15,//本次调用所消费票点数 "inArea":"重庆",//发票区域 "checkCount":"1",//历史查验次数(不包括本次) "inDate":"20100417",//开票日期 "inCode":"50****2130",//发票代码 "checkTime":"2000-12-31 15:35:44",//查验时间 "inTotalAmtCn":"叁万贰仟捌佰肆拾玖圆叁角零分整",//开票总金额大写 "salerInfo":{//销售方信息 "addressPhone":"重庆市**街道131****3456",//销售方地址、联系电话 "name":"重庆市****有限公司",//销售方名称 "taxNo":"925**********29",//销售方税号 "account":"重庆******分理处030*****0007716"//销售方银行账号、开户行信息 }, "inTaxAmt":"325.23",//总税费 "inTotalAmt":"32849.3",//开票总金额 "buyerInfo":{//购买方信息 "addressPhone":"重庆市**广场 023-89****20",//购买方地址、联系电话 "name":"重庆***有限公司",//购买方名称 "taxNo":"915********0265",//购买方税号 "account":"中国建设银行**支行营业部50****521"//购买方银行账号、开户行信息 }, "tradeInfos":[//商品明细 { "tradeAmt":"1922.28",//商品总金额 "unitPrice":"17.475247524752475",//商品单价 "taxRate":"0.01",//商品税率 "number":"110",//商品数量 "tradeName":"*非金属矿物制品*砼预制过梁",//商品名称 "unit":"根", //商品单位 "typeNo":"1000*100*60",//商品规格 "taxAmt":"19.22",//商品税费 "taxTypeNo":"31000******"//税收分类编码 } ], "inNo":"0*****76",//发票号码 "inCheckCode":"069**********813",//校验码 "inAmt":"32524.07",//不计税金额 "inMachineNo":"499******25",//机器编号 "inType":"增值税专用发票",//发票类型 "remarks":"",//备注 "delFlag":"0"//作废红冲标致,0-正常,2-作废,3-红冲,7-部分红冲,8-全部红冲 } //----------------------------------机动车销售统一发票---------------------------------- { "code":200,//响应码,200-成功,请参考响应码说明 "respTime": "2000-01-10 15:48:18",//响应时间 "message": "发票查验成功",//响应信息 "deduct": 15,//本次调用所消费票点数 "takeOrgName":"",//主管税务机关 "inDate":"",//开票日期 "inArea":"",//发票区域 "checkCount":"1",//历史查验次数(不包括本次) "checkTime":"2000-12-31 15:35:44",//查验时间 "tradeInfos":[//交易详情 { "factoryTypeNo":"",//厂牌型号 "taxRate":"",//增值税税率或征收率 "motorNo":"",//发动机号码 "taxProveNo":"",//完税凭证号码 "carType":"",//车辆类型 "productArea":"",//产地 "tradeCheckNo":"",//商检单号 "qualifyPaper":"",//合格证号 "carIdNo":"",//车辆识别代号/车架号码 "tonnage":"",//吨位 "passengerLimit":"",//限乘人数 "importProveNo":""//进口证明书号 } ], "inCode":"",//发票代码 "inTotalAmtCn":"",//价税合计金额大写 "salerInfo":{//销货单位信息 "telPhone":"",//电话 "bank":"",//开户银行 "address":"",//地址 "name":"",//销货单位名称 "taxNo":"",//销货单位纳税人识别号 "account":""//账号 }, "inTaxAmt":"",//增值税税额 "delFlag":"0",//作废红冲标致,0-正常,2-作废,3-红冲,7-部分红冲,8-全部红冲 "takeOrgId":"",//主管税务机关代码 "inTotalAmt":"",//价税合计 "buyerInfo":{ //购买方信息 "name":"", //购买方名称 "taxNo":"", //购买方组织机构代码 "idNo":"" //购买方纳税人识别号 }, "inNo":"", //发票号码 "inAmt":"", //不含税价 "inMachineNo":"", //机器编码 "inType":"机动车销售统一发票" //发票类型 } //---------------------------二手车销售统一发票------------------------ { "code":200,//响应码,200-成功,请参考响应码说明 "respTime": "2000-01-10 15:48:18",//响应时间 "message": "发票查验成功",//响应信息 "deduct": 15,//本次调用所消费票点数 "inDate":"",//开票日期 "inArea":"",//发票区域 "checkCount":"1",//历史查验次数(不包括本次) "inCode":"",//发票代码 "inTotalAmtCn":"",//价税合计金额大写 "checkTime":"2000-12-31 15:35:44", //查验时间 "salerInfo":{//卖方单位/个人信息 "telPhone":"",//电话 "address":"",//卖方单位/个人住址 "name":"",//卖方单位/个人 "idNo":""//单位代码/身份证号码 }, "delFlag":"0",//作废红冲标致,0-正常,2-作废,3-红冲,7-部分红冲,8-全部红冲 "inTotalAmt":"", //价税合计 "buyerInfo":{//买方单位/个人信息 "telPhone":"",//电话 "address":"",//买方单位/个人住址 "name":"",//买方单位/个人 "idNo":""//单位代码/身份证号码 }, "auctionInfo":{//经营、拍卖单位信息 "bank":"",//开户银行、账号 "telPhone":"",//电话 "address":"",//经营、拍卖单位地址 "name":"",//经营、拍卖单位 "taxNo":""//纳税人识别号 }, "marketInfo":{//二手车市场信息 "bank":"",//开户银行、账号 "telPhone":"",//电话 "address":"",//地址 "name":"",//二手车市场 "taxNo":""//纳税人识别号 }, "tradeInfos":[//车辆信息 { "factoryTypeNo":"",//厂牌型号 "regNo":"",//登记证号 "carType":"",//车辆类型 "carNo":"",//车牌号 "transArea":"",//转入地、车管所名称 "carIdNo":""//车辆识别代号/车架号码 } ], "inNo":""//发票号码 "inMachineNo":"",//机器编码 "remarks":"",//备注 "inType":"二手车销售统一发票"//发票类型 } //---------------------------电子发票(航空运输电子客票行程单)------------------------ { "code":200,//响应码,200-成功,请参考响应码说明 "respTime": "2000-01-10 15:48:18",//响应时间 "message": "发票查验成功",//响应信息 "deduct": 15,//本次调用所消费票点数 "inDate":"",//开票日期 "inArea":"",发票区域 "checkCount":"1",//历史查验次数(不包括本次) "inCode":"",//发票代码 "inTotalAmtCn":"",//价税合计金额大写 "GPNo":"",//GP单号 "voyageInfo":[//航程信息列表 { "flightSegment":"",//航段 "carrier":"",//承运人 "flightNo":"",//航班号 "ticketLevel":"",//客票级别/客票类型 "carrierDate":"",//承运日期 "destination":"",//目的站 "takeoffTime":"",//起飞时间 "departure":"",//始发站 "seatLevel":""//座位等级 } ], "inTaxAmt":"",//增值税税额 "delFlag":"0",//作废红冲标致,0-正常,2-作废,3-红冲,7-部分红冲,8-全部红冲 "inTotalAmt":"",//价税合计 "buyerInfo":{//购买方信息 "name":"",//购买方名称 "taxNo":""//购买方税号/纳税人识别号 }, "areaFlag":"",//国内国际标识 "checkTime":"2000-12-31 15:35:44", //查验时间 "ticketNo":"",//电子客票号码 "passenger":{//乘客信息 "name":"",//乘客名称 "IdNo":""//乘客证件号码 }, "inNo":"",//发票号码 "inType":"电子发票(航空运输电子客票行程单)"//发票类型 } //---------------------------电子发票(铁路电子客票)------------------------ { "code":200,//响应码,200-成功,请参考响应码说明 "respTime": "2000-01-10 15:48:18",//响应时间 "message": "发票查验成功",//响应信息 "deduct": 15,//本次调用所消费票点数 "departureTime":"",//出发时间 "carriage":"",//车厢 "inArea":"",//发票区域 "trainNo":"",//车次 "inTotalAmtCn":"",//价税合计金额大写(票价大写) "inTaxAmt":"",//总税费 "delFlag":"0",//作废红冲标致,0-正常,2-作废,3-红冲,7-部分红冲,8-全部红冲 "arrivalStation":"",//到达站 "inTotalAmt":"",//价税合计金额(票价) "ticketNo":"",//电子客票号 "seatClass":"",//座位级别(席别) "inAmt":"",//不含税金额 "departureStation":"",//出发站 "seatNo":"",//座位号(席位) "inType":"电子发票(铁路电子客票)",//发票类型 "inDate":"",//开票日期 "checkCount":"",//历史查验次数(不包括本次) "inCode":"",//发票代码 "taxRate":"",//税率 "businessType":"0",//业务类型:0-售,非0-退 "buyerInfo":{//买方信息 "name":"", //买方名称 "taxNo":"" //买方税号 }, "checkTime":"2000-01-01 15:43:39",//查验时间 "passenger":{//乘客信息 "name":"",//乘客姓名 "IdNo":"" //乘客证件号 }, "airConFeatures":"",//空调特征 "trainDate":"", //乘车日期 "inNo":"" //发票号码 }