价格说明表
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":"" //发票号码
}

渝公网安备 50010802003856号