电子税务平台Api接口-发票查验-发票验真-发票核验-发票查验真伪

简介: 随着数字化办公和财税电子化管理日益普及,发票的真实性查验已经成为企业财务、税务审计等业务流程中重要的一环。而不符合规定、虚假的发票,不得作为财务凭证,任何企业和个人有权拒收。发票查验接口即可实现发票真实性查验的功能。如对查验结果有疑议,可持发票原件至当地税务机关进行鉴定。

随着数字化办公和财税电子化管理日益普及,发票的真实性查验已经成为企业财务、税务审计等业务流程中重要的一环。而不符合规定、虚假的发票,不得作为财务凭证,任何企业和个人有权拒收。发票查验接口即可实现发票真实性查验的功能。如对查验结果有疑议,可持发票原件至当地税务机关进行鉴定。
开发者可通过编程方式将发票查验接口集成到自己的系统中,输入发票号码、发票代码、开票金额和开票日期或上传发票版式文件(pdf、ofd或xml),即可实现在线实时查询发票信息,辨别发票真伪等功能。

1、支持多种发票类型

增值税专用发票
普通发票
机动车销售发票
二手车销售发票
通行费发票
航空运输电子客票行程单
铁路电子客票
财政发票
区块链发票
通用电子发票

2、可查验的时间范围

可查验最近5年内开具的发票;
当日开具的发票当日可进行查验;

3、实现方式

接入发票查验接口即可实现发票查验功能

输入参数

名称 类型 必须 说明
appId String 用户唯一标识
timestamp Long 当前时间戳
sign String 签名,详见签名算法说明
fpdm String 发票代码 非全电发票必填
fphm String 发票号码
kprq String 开票日期 格式YYYYMMDD
jym String 校验码后 6 位, 增值税普通发票、增值税电子普通发票、增值税普通发票(卷式)、增值税电子普通发票(通行费)必填
je String 增值税专用发票、增值税电子专用发票、机动车销售统一发票输入不含税金额;二手车销售统一发票输入车价合计;全电发票输入价税合计

签名算法

sign = sha256(appId + appSecret + timestamp)
用 appId、 appSecret,当前时间时间戳 timestamp,按上述顺序拼接成字符串,再进行 sha256 哈希得到。如下:

String appId = "xyzxy2121zxyz";
String timestamp = "1555378976238";
String appSecret = "efcefcef1121cefcefc1212121";
String str = appId  + appSecret + timestamp;
String sign = sha256(str)

响应示例

以增值税专用发票为例

{
   
  "code": 200, // 返回码,详见code返回码说明
  "msg": "成功", //code对应的描述
  "taskNo": "12552230716560623515",  // 本次唯一请求号
  "charge": true, // 计费标志
  "data": {
   
    "fplx": "01", // 发票类型,详见发票类型说明
    "times": 4, // 查验次数(第几次)
    "xfsbh":"1522***********K01451",    //销方识别号
    "gfmc":"东方****有限公司",            //购方名称
    "gmfyhzh":"工行杭州景江苑支行 12******************36",    //购买方银行账号
    "xhqdBz":"N",                        //清单标志:发票明细中是否有清单行(Y清单 N非清单)
    "dkXsfmc":"马*弟<",                    //代开销售方名称
    "dq":"内蒙古自治区",                    //地区
    "tspzDm": "",                         // 特殊票种代码,02农产品收购发票 08成品油发票
    "xsfdzdh":"乌兰浩特市 1584****535",    //销售方地址电话
    "se":240,                            //税额
    "kprq":"2022-01-04 00:00:00",        //开票日期
    "bz":"代开企业税号:15222*****71610 代开企业名称:马*弟<br/>房屋坐落地址:乌兰浩特市爱国小区*号楼",    //备注
    "kjlx":"2",                            //开具类型
    "fpztDm":"0",                        //发票状态代码
    "sbbh":"661816407119",                //设备编号
    "gfsbh":"91330********66XE",        //购方识别号
    "fpdm":"150*****60",                //发票代码
    "fphm":"00****89",                    //发票号码
    "jym":"69591030500952264929",     //校验码
    "dkXsfsbh":"152**************610",    //代开销售方识别号
    "gmfdzdh":"杭州市滨江区****66号 0571-8*****34",    //购买方地址电话
    "xsfyhzh":"31522***********07111",    //销售方银行账号
    "jshj":16800,                        //价税合计
    "jshjcn":"壹万陆仟捌佰元整",            //价税合计(中文大写)
    "je":16560,                            //金额
    "xfmc":"国家税务总局乌兰浩特市税务局第一税务分局",    //销方名称
    "txfbz":"Y",//如果是通行费,则有该字段,Y表示该通行费可抵扣,N表示不可以抵扣    //通行费标识
    "tspzDm": "86",//特殊票种,02-农产品收购;03-稀土矿产品发票;04-稀土产成品发票;05-石脑油;06-通行费可抵扣;07-通行费(不可抵扣);08-成品油发票;12-机动车; 76-报废产品收购;77-报废产品收购; 83-建筑服务; 84-货物运输服务; 85-不动产销售; 86-不动产经营租赁服务; 89-旅客运输服务; 92-自产农产品销售; 93-拖拉机按减征税; 96-农产品收购;其它为空;
    "hwxx":[                            //货物信息
      {
   
        "ggxh":"",                    //规格型号
        "jldw":"套",                    //计量单位
        "dj":"16560.00",            //单价
        "mxxh":1,                    //明细序号
        "se":240,                    //税额
        "ysse":"240",                //原始税额
        "mc":"房屋租赁(20220101-20221231)",    //名称
        "sl":"1",                    //数量
        "je":16560,                    //金额
        "slv":0.015,                //税率
        "ysslv":"1.5%",                //原始税率
        "spbm":""                    //商品编码
      }
    ]
  }
}

示例(java)

import com.anq.core.utils.HttpUtil;
import com.anq.core.utils.JsonUtil;
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.codec.digest.DigestUtils;
import org.junit.Test;
import java.util.HashMap;
import java.util.Map;
@Slf4j
public class Examples {
   
    String appId = "聚美智数分配的appId";
    String appSecret = "聚美智数分配的appSecret";
    String apiUrl = "";
    @Test
    public void examples() {
   
        long timestamp = System.currentTimeMillis();
        String sign = DigestUtils.sha256Hex(appId + appSecret + timestamp); // 生成sign
        Map<String, Object> params = new HashMap<String, Object>();
        params.put("appId", appId);  // 聚美智数分配的appId
        params.put("timestamp", timestamp);
        params.put("sign", sign);
        params.put("productCode", "invoice_validate_v2");// 固定值
        params.put("fpdm", ""); // 发票代码 ,发票代码  非全电发票必填
        params.put("fphm", ""); // 发票号码 
        params.put("kprq", ""); // 开票日期 ,格式YYYYMMDD
        params.put("jym", ""); // 校验码后6位 ,增值税普通发票、增值税电子普通发票、增值税普通发票(卷式)、增值税电子普通发票(通行费)必填
        params.put("je", ""); // 金额 ,增值税专用发票、增值税电子专用发票、机动车销售统一发票输入**不含税金额**; 二手车销售统一发票输入**车价合计**; 全电发票输入**价税合计**
        // HttpUtil可从这里下载 https://file.jumdata.com/support/HttpUtil.java
        String resultJson = HttpUtil.postForm(apiUrl, null, params);
        log.info(resultJson);
        // JumeiOpenApiResponse 可从这里下载 https://file.jumdata.com/support/JumeiOpenApiResponse.java
        // JsonUtil可从这里下载 https://file.jumdata.com/support/JsonUtil.java
        JumeiOpenApiResponse jumeiOpenApiResponse = JsonUtil.toObject(resultJson, JumeiOpenApiResponse.class)
        if(jumeiOpenApiResponse.getCode() == 200){
   
           //TODO
        }else{
   
           //TODO
        }
    }
}
相关文章
|
XML 机器学习/深度学习 人工智能
电子税务财务发票全生命周期API接口集合-自动开票-发票查验-发票识别-发票下载-开票信息
本文将介绍发票全生命周期API接口,包括:自动开票,发票识别,发票查验,发票下载,企业开票信息查询。
520 1
|
5月前
|
JSON API 区块链
发票查验接口详细接收参数说明-C#语言集成完整示例-API高效财税管理方案
发票查验API提供全票种实时核验,支持增值税发票、全电票、区块链发票等,覆盖当日开票、批量处理与多系统集成,返回结构化数据,助力企业高效实现财税自动化管理。
|
4月前
|
人工智能 安全 网络安全
喂饭级教程:OpenClaw阿里云及Windows本地一键部署:+多Agent/多网关配置,一人群控全域 AI 指南
2026年,AI代理工具的使用场景已从单一设备延伸至多端协同——家里的Mac Mini跑着Claude Max处理日常对话,公司服务器搭载Gemini专注代码开发,阿里云主机负责长时自动化任务,而开发者需要在主力机上快速切换,无需反复修改配置。OpenClaw的群控模式完美解决这一痛点,通过多Agent分工、多Gateway+Profile隔离、环境变量临时切换三大方案,实现“一条命令操控多台AI”的高效体验。
3724 4
|
XML API 计算机视觉
自动开票API接口:重塑企业财税效率的自动化引擎
每月开票高峰,财务手动录入易错、耗时、红冲频繁?自动开票API助力财税数字化:对接ERP/收银系统,实现“支付即开票”,1小时完成原需3-5天的开票台账;保障数据准确合规,支持专票/普票、开具、交付、冲红全流程自动化。
612 2
|
6月前
|
前端开发 JavaScript Java
API调用实现财政票据真伪查验-电子医疗发票清单查验-发票查验接口
财政票据真伪查验接口,支持医疗发票等多类票据在线核验。通过发票代码、号码、日期、校验码等要素,快速获取全国票据信息,实现高效防伪与合规审查,助力医保、财务系统防范虚假报销,保障财税数据真实完整。
|
7月前
|
人工智能 JSON 文字识别
发票验真API:基于权威数据源与阿里云平台的发票验真代码解析
发票验真迈向智能化新阶段,融合OCR识别与权威查验平台,实现全票种自动化验真。一站式接口高效、安全、可溯,支持批量处理与高并发调用,显著提升效率、降低合规风险,助力企业构建智能财税风控体系。(238字)
|
5月前
|
JSON Java 编译器
Protobuf 是什么?一篇文章搞懂这个高性能序列化神器
Protobuf是Google开源的高效二进制序列化协议,体积小、速度快,支持跨语言、向后兼容。相比JSON,更适合RPC等高性能场景,广泛应用于微服务通信。通过`.proto`文件定义结构,自动生成代码,实现数据的快速序列化与反序列化。
2450 158
|
3月前
|
API UED
企业开票信息-发票抬头查询API接口介绍
在金税四期与数电票全面推行背景下,企业开票信息接口可智能匹配企业全称、税号等开票要素,支持模糊搜索与标准化,助力电商、ERP、报销系统自动填单,避免人工错误,提升开票效率与合规性。
626 1
|
2月前
|
API
国内国际全球贵金融黄金白银行情查询API接口介绍
本API提供全球贵金属实时行情服务,覆盖国内(黄金、白银、铜等11个品种)及国际(伦敦金、美黄金、现货铂钯等15个品种)市场,支持实时报价、多周期K线(1分钟至日线)、期货合约查询,数据全面精准,助力投资决策。
687 1