国税局发票查验API接口文档说明
·
1 RPA技术说明
该接口通过RPA机器人技术进行查验,通过浏览器模拟的方式,使用UIpath、selenium、playwright等RPA自动化测试工具、结合人工智能图像识别技术制作而成,仅供个人方便查看自己的票,提高工作效率。
校验项目说明如下:
- 增值税电子普通发票10、增值税普通发票04、增值税普通发票(卷票)11、增值税电子普通发票(通行费)14,这四种发票使用校验项目为校验码后六位;
- 增值税专用发票01、增值税电子专用发票08,这两种发票使用的校验项目为开票金额(不含税);
- 二手车发票15,使用的校验项目为车价合计;
- 机动车发票03,使用的校验项目为不含税价; 之前的货运发票02,目前已取消,现在开的货运发票合并到增值税专用发票01。
全电票的说明:
全电票的说明:
如果该票为全电票,会有字段qdfplx为09
解析的时候还是按照返回的fplx来解析,因为全电票查验也能返回全票面信息,包含地址电话、银行账户这些。
发票代码传空,发票号码传全电发票号码
电子发票(增值税专用发票):校验项目为价税合计
电子发票(普通发票): 校验项目为价税合计
增值税专用发票(纸质发票):传入发票代码、号码、日期、金额
增值税普通发票(纸质发票):传入票面上的发票代码 发票号码 日期 ,校验项目为全电号码后6位.
{
"fpdm": "发票代码",
"fphm": "发票号码",
"kprq": "开票日期",
"value": "校验项目",
"sqm": "授权码"
}
2 RPA采集报文结构化
下面的数据为RPA从浏览器上采集的数据,进行了结构化处理。
2.1 增值税电子普通发票10、增值税普通发票04、增值税专用发票01、增值税电子专用发票08
{
“fp”: {
"cysj": "查验时间",
"fpdm": "发票代码",
"fphm": "发票号码",
"bz": "备注",
"dkbz": "代开标志 1代表自开 2代表代开",
"fplx": "发票类型",
"cycs": "查验次数",
"kprq": "开票日期",
"xfmc": "销方名称",
"xfsh": "销方税号",
"xfdzdh": "销方地址电话",
"xfyhzh": "销方银行账号",
"gfmc": "购方名称",
"gfsh": "购方税号",
"gfdzdh": "购方地址电话",
"gfyhzh": "购方银行账号",
"jym": "校验码",
"se": "税额",
"jshj": "价税合计",
"jqbm": "机器编码",
"je": "金额",
"zfbz": "作废标志 Y代表作废 N代表正常 3代表红冲 8代表全额冲红",
"txfbz": "通行费标志 Y代表是 N代表不是",
"cpybz": "成品油标志 Y代表是 N代表不是",
"ofdurl": "ofd版式文件下载地址,如果返回为空,代表该发票没版式文件",
"pdfurl": "pdf版式文件下载地址,如果返回为空,代表该发票没版式文件",
"qdbz": "清单标志 Y代表有清单 N代表无清单",
"qdbt": "清单标题",
"qdslv": "清单税率",
"sph": [{
"spmc": "商品名称",
"ggxh": "规格型号",
"jldw": "单位",
"slv": "税率",
"sl": "数量",
"dj": "单价",
"je": "金额",
"se": "税额",
"ssflbm": "商品编码"
}, {
"spmc": "",
"ggxh": "",
"jldw": "",
"slv": "",
"sl": "",
"dj": "",
"je": "",
"se": "",
"ssflbm": ""
}
]
},
"code": "0代表查验成功 1代表超过最大查验次数 2代表发票不存在 -1代表查验失败",
"msg": "code说明"
}
2.2 增值税普通发票(卷票)11
{
"fp": {
"cysj": "查验时间",
"fpdm": "发票代码",
"fphm": "发票号码",
"bz": "备注",
"dkbz": "代开标志 1代表自开 2代表代开",
"fplx": "发票类型",
"cycs": "查验次数",
"kprq": "开票日期",
"xfmc": "销方名称",
"xfsh": "销方税号",
"gfmc": "购方名称",
"gfsh": "购方税号",
"jqbm": "机器编号",
"se": "税额",
"jshj": "价税合计",
"jym": "校验码",
"je": "金额",
"shy": "收款员",
"zfbz": "作废标志 Y代表作废 N代表正常 3代表红冲 8代表全额冲红",
"txfbz": "通行费标志 Y代表是 N代表不是",
"cpybz": "成品油标志 Y代表是 N代表不是",
"qdbz": "清单标志 Y代表有清单 N代表无清单",
"qdbt": "清单标题",
"qdslv": "清单税率",
"sph": [{
"spmc": "商品名称",
"sl": "数量",
"dj": "单价",
"hsje": "含税金额",
"je": "金额",
"se": "税额",
"slv": "税率",
"ssflbm": "商品编码"
}
]
},
"code": " 0代表查验成功 1代表超过最大查验次数 2代表发票不存在 -1代表查验失败",
"msg": "code说明"
}
2.3 增值税电子普通发票(通行费) 14
{
"fp": {
"cysj": "查验时间",
"fpdm": "发票代码",
"fphm": "发票号码",
"bz": "备注",
"dkbz": "代开标志 1代表自开 2代表代开",
"fplx": "发票类型",
"cycs": "查验次数",
"kprq": "开票日期",
"xfmc": "销方名称",
"xfsh": "销方税号",
"xfdzdh": "销方地址电话",
"xfyhzh": "销方银行账号",
"gfmc": "购方名称",
"gfsh": "购方税号",
"gfdzdh": "购方地址电话",
"gfyhzh": "购方银行账号",
"jym": "校验码",
"se": "税额",
"jshj": "价税合计",
"jqbm": "机器编码",
"je": "金额",
"zfbz": "作废标志 Y代表作废 N代表正常 3代表红冲 8代表全额冲红",
"txfbz": "通行费标志 Y代表是 N代表不是",
"cpybz": "成品油标志 Y代表是 N代表不是",
"qdbz": "清单标志 Y代表有清单 N代表无清单",
"qdbt": "清单标题",
"qdslv": "清单税率",
"sph": [{
"xmmc": "项目名称",
"cph": "车牌号",
"lx": "类型",
"txrqq": "通行日期起",
"txrqz": "通行日期止",
"je": "金额",
"slv": "税率",
"se": "税额",
"ssflbm": "商品编码"
}
]
},
"code": "0代表查验成功 1代表超过最大查验次数 2代表发票不存在 - 1代表查验失败",
"msg": "code说明"
}
2.4 二手车销售发票 15
{
"fp": {
"cysj": "查验时间",
"fpdm": "发票代码",
"fphm": "发票号码",
"bz": "备注",
"dkbz": "代开标志 1代表自开 2代表代开",
"fplx": "发票类型",
"cycs": "查验次数",
"kprq": "开票日期",
"jqbm": "机器编号",
"gfdw": "买方单位/个人",
"gfdwdm": "买方单位代码",
"gfdwdz": "买方单位地址",
"gfdwdh": "买方电话",
"cpzh": "车牌照号",
"djzh": "登记证号",
"cllx": "车辆类型",
"cjhj": "车价合计",
"cjh": "车架号",
"cpxh": "厂牌型号",
"zrdclgls": "转入地车辆管理所名称",
"mfdw": "卖方单位/个人",
"mfdwdm": "卖方单位代码",
"mfdwdz": "卖方单位地址",
"mfdwdh": "卖方电话",
"jydw": "经营、拍卖单位",
"jydwdz": "经营、拍卖单位地址",
"jydwnsrsbh": "经营、拍卖单位纳税人识别号",
"jydwkhyhzh": "经营、拍卖单位开户银行、账号",
"jydwdh": "经营、拍卖单位电话",
"escsc": "二手车市场",
"escnsrsbh": "二手车纳税人识别号",
"escdz": "二手车地址",
"esckhyhzh": "二手车开户银行及账号",
"escdh": "二手车电话",
"zfbz": "作废标志 Y代表作废 N代表正常 3代表红冲 8代表全额冲红",
"txfbz": "通行费标志 Y代表是 N代表不是",
"cpybz": "成品油标志 Y代表是 N代表不是",
}
"code": "0代表查验成功 1代表超过最大查验次数 2代表发票不存在 -1代表查验失败",
"msg": "code说明"
}
2.5 机动车发票 03
{
"fp": {
"cysj": "查验时间",
"fpdm": "发票代码",
"fphm": "发票号码",
"bz": "备注",
"dkbz": "代开标志 1代表自开 2代表代开",
"fplx": "发票类型",
"cycs": "查验次数",
"kprq": "开票日期",
"jqbm": "机器编号",
"gfmc": "购方名称",
"sfz": "购方组织机构代码",
"gfsh": "购方纳税人识别号",
"cllx": "车辆类型",
"cpxh": "厂牌型号",
"cd": "产地",
"hgzh": "合格证号",
"je": "金额",
"sjdh": "商检单号",
"fdjhm": "发动机号码",
"clsbdh": "车辆识别代号",
"jkzmsh": "进口证明书号",
"xfmc": "销货单位名称",
"dh": "电话",
"xfsh": "销方纳税人识别号",
"zh": "账号",
"dz": "地址",
"khyh": "开户银行",
"sl": "税率",
"se": "税额",
"zgswjgdm": "主管税务机关代码",
"jshj": "价税合计",
"wspzhm": "完税凭证号码",
"dw": "吨位",
"xcrs": "限乘人数",
"zfbz": "作废标志 Y代表作废 N代表正常 3代表红冲 8代表全额冲红",
"txfbz": "通行费标志 Y代表是 N代表不是",
"cpybz": "成品油标志 Y代表是 N代表不是",
"zgswjg": "主管税务机关",
}
"code": "0代表查验成功 1代表超过最大查验次数 2代表发票不存在 - 1代表查验失败",
"msg": "code说明"
}
更多推荐
已为社区贡献4条内容
所有评论(0)