国税发票查验API接口说明

人工智能财税小助手

已于 2023-10-20 14:05:49 修改

阅读量1.2w

点赞数 5

分类专栏：发票查验国税查验电子税局文章标签： python 经验分享笔记金融

于 2023-04-01 00:53:37 首次发布

本文链接：https://blog.csdn.net/2301_77375571/article/details/129891136

版权

本文详细介绍了国税发票的API接口，包括请求地址、数据项、支持的发票类型、发票状态和票种标志。提供了增值税专用发票、机动车销售统一发票等不同类型的发票响应报文说明，适用于进行发票信息的查验和处理。

摘要由CSDN通过智能技术生成

2.1. 增值税专用发票、增值税普通发票、增值税电子普通发票、增值税普通发票(卷票)、电子发票(增值税专用发票)、电子发票(增值税普通发票)

测试授权全用test，如有问题，请及时联系。

业务咨询请加QQ1576813605

1.请求地址与数据项说明

1.1. 请求说明

接口地址：http://xxxxxxx/v1/fpcy

请求格式：application/json

请求报文：

  {
   "data": "发票信息base64编码",
   "global": {
       "enterpriseCode": "",
       "sqid": "test",
       "uuid": "32位随机数",
       "version": "V1.0"
   },
   "sqxx": {
       "appSec": "test",
       "appKey": "test"
   }
}

data节点解析：

{
   "fpdm": "发票代码",
   "fphm": "发票号码",
   "fprq": "开票格式[yyyyMMdd]",
   "other": "校验码/不含税金额/价税合计"
}

将上述信息做base64赋值到data节点

1.2. other项说明

    当发票种类为 01，02，03，15，08，31，32，83，61 时此项为金额:
       且当 01，02，03 填写发票不含税金额，
       且当15 填写发票车价合计；
       且当31,32,83,61时填写发票价税合计；
   发票种类为 04，10，11，14 时此项为校验码后6位；

1.3. 支持发票类型[fpzl]

增值税专用发票：01
机动车销售统一发票：03
增值税普通发票：04
增值税专用发票（电子）：08
增值税普通发票（电子）：10
增值税普通发票（卷式）：11
增值税普通发票（通行费）：14
二手车销售统一发票：15
全电发票专票：31
全电发票普票：32
全电发票纸专：01[可根据sfqd字段用于区分普通 01 类型]
全电发票纸普：04[可根据sfqd字段用于区分普通 04 类型，校验码为对应的全电发票号码]
铁路电子客票：83
航空电子客票：61

1.4. 发票状态说明[fpzt]

    0-正常
   2-作废
   3-红冲
   7-部分红冲
   8-全额红冲

1.5. 票种标志说明[pzbz]

   01-成品油
   02-稀土
   03-通行费
   04-机动车
   05-建筑服务

2. 响应报文说明

2.1. 增值税专用发票、增值税普通发票、增值税电子普通发票、增值税普通发票(卷票)、电子发票(增值税专用发票)、电子发票(增值税普通发票)

{
"returnStateInfo": {
"returnCode": "001",
"returnMessage": "查验成功"
},
"invoice": {
"qdbz": "作废标志",
"cycs": "查验次数",
"fpzl": "发票类型",
"fpdm": "发票代码",
"fphm": "发票号码",
"fprq": "发票日期",
"jym": "校验码",
"hjje": "合计金额[不含税]",
"hjse": "合计税额",
"jshj": "价税合计",
"jqbh":