前言
随着营改增的要求,企业对发票管理的智能化需求越来越紧迫,企业ERP系统、财务系统均希望直接对接国家发票校验平台进行发票校验,本文结合自己企业对接的票查查平台给出一个对接例子,希望能帮到有此需求的企业伙伴。(票查查地址:https://www.piaocc.com)。
2020/11/05更新(V3更简洁接口)
从票查查了解到,他们提供了更为简洁的接口V3版本接口,一个请求url搞定:
最简单的测试方式就是将填好参数后的url放到浏览器访问,结果就出来了。
2020/10/30更新
请求头部要加上content-type,值为:application/json
一、本文使用编程语言
由于python语言容易上手,所以本文使用python语言。
二、接口对接代码示例
请求代码如下:
#请先安装requests模块
url = 'https://api.piaocc.com/rest/v_1/common_check.html'
header={
'content-type':'application/json',
'authCode':'票查查平台authCode' #注册后应用中心创建应用之后就能看到
}
data={
'invoiceCode':'', #发票代码
'invoiceNo':'', #发票号码
'invoiceDate':'', #开票日期,格式:yyyyMMdd,如:19990101
'invoiceAmt':'', #不含税金额(增值税专票、机动车票必传)
'checkCode':'' #校验码后6位(增值税普票必传)
}
r=requests.post(url,json = data,headers = header)
print r.text
返回示例如下:
{
"code":200, //响应码,200表示查询成功,其余均为查询失败
"inArea":"重庆", //发票区域
"inDate":"20100417", //开票日期
"inCode":"50****2130", //发票代码
"inTotalAmtCn":"叁万贰仟捌佰肆拾玖圆叁角零分整", //开票总金额大写
"salerInfo":{ //销售方信息
"addressPhone":"重庆市**街道131****3456", //销售方地址、联系电话
"name":"重庆市****有限公司", //销售方名称
"taxNo":"925**********29", //销售方税号
"account":"重庆******分理处030*****0007716" //销售方银行账号、开户行信息
},
"inTaxAmt":"325.23", //总税费
"message":"发票查验成功", //响应信息
"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" //商品税费
}
],
"inNo":"0*****76", //发票号码
"inCheckCode":"069**********813", //校验码
"inAmt":"32524.07", //税后金额
"inMachineNo":"499******25", //机器编号
"inType":"增值税专用发票", //发票类型
"remarks":"" //备注
}