增值税发票查验API接口说明

### 增值税发票查验API接口说明 #### 一、接口概述 增值税发票查验API是一种用于自动验证增值税发票真实性的技术工具。该接口通过提供发票的特定信息（如发票代码、发票号码等），能够迅速反馈发票的有效性，并提供相关的发票详情。 #### 二、请求参数及地址 **请求地址**： ``` http://xx.xx.xx.xx:xx/fpcy ``` **请求类型**： - POST 请求 **请求参数**： - **Content-Type**: `application/json;charset=utf-8` **JSON格式参数**： ```json { "fpdm": "发票代码", // 必须 "fphm": "发票号码", // 必须 "kprq": "开票日期", // 必须 "value": "校验项目", // 必须 "sqm": "授权码" // 必须 } ``` #### 三、请求参数说明 - **fpdm (发票代码)**：由14位数字组成，用于唯一标识发票。 - **fphm (发票号码)**：由8位数字组成，与发票代码一起构成每张发票的唯一标识。 - **kprq (开票日期)**：发票开具的日期，格式为YYYYMMDD。 - **value (校验项目)**：根据不同类型的发票，此字段所包含的信息也不同。具体如下： - 增值税电子普通发票（10）、增值税普通发票（04）、增值税普通发票（卷票）（11）、增值税电子普通发票（通行费）（14），校验项目为校验码后六位。 - 增值税专用发票（01）、增值税电子专用发票（08），校验项目为开票金额（不含税）。 - 二手车发票（15），校验项目为车价合计。 - 机动车发票（03），校验项目为不含税价。 - 货运发票（02）已取消，合并至增值税专用发票（01）。 - **sqm (授权码)**：用于确保请求的安全性和合法性。 #### 四、校验项目说明 - **增值税电子普通发票（10）/增值税普通发票（04）/增值税普通发票（卷票）（11）/增值税电子普通发票（通行费）（14）**： - 校验项目为校验码后六位。 - **增值税专用发票（01）/增值税电子专用发票（08）**： - 校验项目为开票金额（不含税）。 - **二手车发票（15）**： - 校验项目为车价合计。 - **机动车发票（03）**： - 校验项目为不含税价。 #### 五、全电票说明 - 全电专票发票类型为09，全电普票发票类型为90。 - 根据发票号码来判断校验项目应填写的内容。 #### 六、错误码说明 - **2响应报文**：针对不同类型的发票，返回的报文格式有所差异。 - **2.1增值税电子普通发票（10）、增值税普通发票（04）、增值税专用发票（01）、增值税电子专用发票（08）**： ```json { "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）**： ```json { "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说明" } ``` #### 七、总结 增值税发票查验API接口主要通过POST方式向指定URL发送请求，并携带必要的发票信息，以验证发票的真实性和有效性。通过返回的数据包，可以获取详细的发票信息，包括但不限于发票代码、发票号码、查验时间、发票类型等。此外，不同的发票类型有不同的校验规则，系统会根据这些规则进行校验并返回相应的结果。对于开发者来说，理解和掌握这些细节是非常重要的，以便于在实际应用中正确地使用该API接口。