增值税发票查验
1、接口描述
该接口用于增值税发票四要素查验
2、接口地址
POST /v1/FP/cy HTTP/1.1
3、请求参数
- 参数说明
请求参数为JSON格式。
| 参数名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| customReqId | String | 否 | 传入的请求ID，用于标识一次调用，传入前先保存，需保证唯一性。 生成规则：AppKey+去掉横杠的UUID，示例：100019953790cccf01c45ce1b744e14ec46384eb |
| cyList | List | 是 | 查验发票列表，必填 |
！注意：不同类型的发票cyList里的字段不同
增值税发票信息说明
包含增值税专用发票、增值税电子专用发票、增值税普通发票、增值税普通发票（卷式）、增值税电子普通发票、增值税电子普通发票（通行费）、机动车销售统一发票、二手车销售统一发票
增值税发票查验列表-cyList说明
| 参数名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| fpdm | String | 是 | 发票代码，必填 |
| fphm | String | 是 | 发票号码，必填 |
| kprq | String | 是 | 开票日期，必填，格式 yyyy-MM-dd / yyyyMMdd |
| je | Number | 是 | 不含税金额（增值税专用发票、增值税电子专用发票、机动车销售统一发票）/车价合计（二手车销售统一发票）时必填 |
| jym | String | 是 | 校验码后 6 位，增值税普通发票、增值税电子普通发票、增值税普通发票（卷式）、增值税电子普通发票（通行费）时必填 |
- 示例参数（此参数仅为展示请求参数格式，请勿以此数据作为测试数据）
// 增值税发票查验（单张）
{
"cyList": [{
"fpdm": "33002041**",
"fphm": "011335**",
"kprq": "2021-02-25",
"je": 11979.64
}]
}
{
"cyList": [{
"fpdm": "0320019002**",
"fphm": "607724**",
"kprq": "2020-03-25",
"jym": "262045"
}]
}
// 增值税发票查验（多张）
{
"cyList": [{
"fpdm": "33002041**",
"fphm": "011335**",
"kprq": "2021-02-25",
"je": 11979.64
}, {
"fpdm": "0320019002**",
"fphm": "607724**",
"kprq": "2020-03-25",
"jym": "262045"
}]
}
4、返回结果
- 返回结果
返回结果为JSON格式。
// 01增值税发票查验成功返回结果
{
"result":{
"req_id":"f1646ad234e64b8d9861cc480d35d52a",
"success":true,
"time":177,
"timestamp":1646832326464
},
"value":[
{
"times":10, --查验次数（第几次）
"fpdm":"150****160", --发票代码
"fphm":"00****89", --发票号码
"fplx":"01", --发票类型
"kprq":"2022-01-04 00:00:00", --开票日期
"success":true, --查验是否成功标识 true成功，false失败
"je":16560, --金额
"time":"2022-03-09 10:07:44",
"data":{ --查验成功返回的发票数据
"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", --开具类型标识：0委托代开 1自开 2代开 3代办退税
"fpztDm":"0", --发票状态代码
"sbbh":"661816407119", --设备编号
"gfsbh":"91330********66XE", --购方识别号
"fpdm":"150*****60", --发票代码
"fphm":"00****89", --发票号码
"jym":"69591030500952264929"， --校验码
"fplx":"01", --发票类型
"dkXsfsbh":"152**************610", --代开销售方识别号
"gmfdzdh":"杭州市滨江区****66号 0571-8*****34", --购买方地址电话
"xsfyhzh":"31522***********07111", --销售方银行账号
"jshj":16800, --价税合计
"jshjcn":"壹万陆仟捌佰元整", --价税合计（中文大写）
"je":16560, --金额
"xfmc":"国家税务总局乌兰浩特市税务局第一税务分局", --销方名称
"txfbz":"Y",//如果是通行费，则有该字段，Y表示该通行费可抵扣，N表示不可以抵扣 --通行费标识
"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":"" --商品编码
}
]
}
}
]
}
//税务ukey开具的增值税电子专票和增值税电子普票
{
"result":{
"req_id":"1f3f89adacbe482a914837dd08afa40f",
"success":true,
"time":1087,
"timestamp":1646983366442
},
"value":[
{
"times":13, --查验次数（第几次）
"fpdm":"0330****0113", --发票代码
"fplx":"08", --发票类型
"kprq":"2021-10-09 00:00:00", --开票日期
"success":true, --查验是否成功标识
"je":908.49, --金额
"time":"2022-03-11 15:15:01",
"fphm":"09****92", --发票号码
"data":{ --查验成功返回的发票数据
"xfsbh":"91330******M3FR34P", --销方识别号
"gfmc":"广州***集成家居有限公司", --购方名称
"gmfyhzh":"招商银行股份有限公司广州**支行12091****10777", --购买方银行账号
"xhqdBz":"N", --清单标志：发票明细中是否有清单行（Y清单 N非清单）
"purl":"https://****", --PDF版式文件下载链接（只有税务ukey开具的电子专票和电子普票有）
"dq":"浙江", --地区
"tspzDm": "", -- 特殊票种代码，02农产品收购发票 08成品油发票
"xsfdzdh":"浙江省义乌市**街道**路*号*楼0579-85****66", --销售方地址电话
"se":54.51, --税额
"kprq":"2021-10-09 00:00:00", --开票日期
"bz":"", --备注
"kjlx":"1", --开具类型标识：0委托代开 1自开 2代开 3代办退税
"fpztDm":"0", --发票状态代码
"sbbh":"917106314504", --设备编号
"gfsbh":"91440*******QD3L35", --购方识别号
"fpdm":"0330****0113", --发票代码
"fplx":"08", --发票类型
"url":"https://******", --OFD版式文件下载链接（只有税务ukey开具的电子专票和电子普票有）
"gmfdzdh":"广州市增城区**镇****村、**村（办公楼D）020-82****98", --购买方地址电话
"xsfyhzh":"宁波银行股份有限公司****支行79040******245913", --销售方银行账号
"jshj":963, --价税合计
"jshjcn":"玖佰陆拾叁元整", --价税合计（中文大写）
"je":908.49, --金额
"xfmc":"义乌市**酒店管理有限公司", --销方名称
"hwxx":[ --货物信息
{
"ggxh":"", --规格型号
"jldw":"天", --计量单位
"dj":"181.698113", --单价
"mxxh":1, --明细序号
"se":54.51, --税额
"ysse":"54.51", --原始税额
"mc":"*住宿服务*住宿费", --名称
"sl":"5.000000", --数量
"je":908.49, --金额
"slv":0.06, --税率
"ysslv":"6%", --原始税率
"spbm":"30704*********000000" --商品编码
}
],
"fphm":"09****92", --发票号码
"jym":"10959777606333*******" --校验码
}
}
]
}
//03机动车销售统一发票查验成功返回结果
{
"result":{
"req_id":"ca6184792859445ba9fd1643d3cf942f",
"success":true,
"time":446,
"timestamp":1651055455190
},
"value":[
{
"times":46,
"fpdm":"1120****0160",
"data":{
"cjhm":"JN8BY2NY0J912****", -- 车架号码/车辆识别代码
"dh":"022-8625****", --电话
"gfmc":"陈**", -- 购买方名称
"sfzhm":"4203*********2712", --身份证号码/组织机构代码
"xhdwsbh":"9112*********C933", -- 销货单位纳税人识别号
"dq":"天津", --地区
"jshjcn":"肆拾叁万伍仟伍佰元整", --价税合计中文大写
"dw":"", --吨位
"yszzsse":"60068.97", --原始增值税税额字段
"xcrs":"7", --限乘人数
"kprq":"2018-09-19 00:00:00", --开票日期
"dz":"天津自贸实验区（天津港保税区）**广场*号****汽车城****室", --地址
"kjlx":"1", --开具类型标识：0委托代开 1自开 2代开 3代办退税
"cllx":"越野车", --车辆类型
"fpztDm":"0", --发票状态代码：发票状态代码 0正常 1失控（历史数据） 2作废 3已红冲
"hgzh":"", --合格证号
"khyh":"中国银行股份有限公司天津***分行", --开户银行
"sbbh":"661604157082", --机打代码/机打号码
"gfsbh":" ", --购买方纳税人识别号
"cd":"日本", --产地
"fpdm":"1120****0160", --发票代码
"fplx":"03", --发票类型
"swjgMc":"原天津市保税区国家税务局第三税务所", --主管税务机关名称
"sjdh":"BA021****", --商检单号
"zh":"27008115****", --账号
"swjgDm":"112942200", --主管税务机关代码
"wspzhm":"", --完税凭证号码
"lslbs":" ", --零税率标识：空：非零税率，0：出口零税，1：免税，2：不征税，3 普通零税率
"cpxh":"克罗迪 涂乐 ****CC越野车", --厂牌型号
"zzsse":60068.97, --增值税税额
"jkzmsh":"H0218023****", -- 进口证明书号
"xhdwmc":"天津****贸易有限公司", --销货单位名称
"jshj":435500, --价税合计
"je":375431.03, --不含税价
"slv":0.16, --增值税税率或征收率
"ysslv":"16%", --原始税率字符串
"fdjhm":"VQ40664****", --发动机号码
"fphm":"00****97" --发票号码
},
"fplx":"03",
"kprq":"2018-09-19 00:00:00",
"success":true,
"je":375431.03,
"time":"2022-04-27 18:29:53",
"fphm":"00****97"
}
]
}
// 04增值税普通发票（农产品）查验成功返回结果
{
"result":{
"req_id":"b14d6160a49a48c9a02b31da642a6afc",
"success":true,
"time":759,
"timestamp":1649061244816
},
"value":[
{
"times":18, --查验次数（第几次）
"fpdm":"0430****0104", --发票代码
"data":{
"xfsbh":"4303**********3014", --销售方识别号
"gfmc":"湘潭市**包装有限公司", --购买方名称
"gmfyhzh":"中国银行股份有限公司*****支行6054****4355", --购买方银行账号
"xhqdBz":"N", --清单标志：发票明细中是否有清单行（Y清单 N非清单）
"tspzDm":"02", --特殊票种代码，02农产品收购发票 08成品油发票
"dq":"湖南", --地区
"xsfdzdh":"", --销售方地址电话
"se":0, --税额
"kprq":"2018-08-18 00:00:00", --开票日期
"bz":"", --备注
"kjlx":"1", --开具类型标识：0委托代开 1自开 2代开 3代办退税
"fpztDm":"0", --（电子底账用）发票状态代码：发票状态代码 0正常 1失控（历史数据） 2作废 3已红冲
"sbbh":"661510345883", --设备/机器编号：税控盘号、金税盘号
"gfsbh":"9143**********016C", --购买方识别号
"fpdm":"0430****0104", --发票代码
"fplx":"04", --发票类型
"gmfdzdh":"湘潭市**区**村 0731-52****99", --购买方地址电话
"xsfyhzh":"", --销售方银行账号
"jshj":9672, --价税合计
"jshjcn":"玖仟陆佰柒拾贰元整", --价税合计（中文大写）
"je":9672, --金额
"xfmc":"冯*春", --销售方名称
"hwxx":[ --货物信息
{
"ggxh":"", --规格型号
"jldw":"吨", --计量单位
"dj":"800.00", --单价
"mxxh":1, --明细序号
"lslbs":"1", --零税率标识：空：非零税率，0：出口零税，1：免税，2：不征税，3 普通零税率
"se":0, --税额
"ysse":"***", --原始税额字符串
"mc":"*林业产品*松元木", --货物劳务名称
"sl":"12.09", --数量
"je":9672, --金额
"slv":0, --税率
"ysslv":"免税", --原始税率字符串
"spbm":"1010202010000000000" --税局编码/税收分类编码
}
],
"fphm":"26****02", --发票号码
"jym":"7699*************4758" --校验码
},
"fplx":"04", --发票类型
"kprq":"2018-08-18 00:00:00", --开票日期
"success":true, --查验是否成功标识，true成功false失败
"je":9672, --金额
"time":"2022-04-04 16:34:03", --查验时间
"fphm":"26****02", --发票号码
"jym":"65**58" --校验码
}
]
}
//14通行费发票/增值税电子普通发票（通行费）查验成功返回结果
{
"result":{
"req_id":"ef7dee5a5642475f8dbb4335fc8fb875",
"success":true,
"time":1926,
"timestamp":1669622340439
},
"value":[
{
"times":6, --查验次数，第几次
"fpdm":"042******112", --发票代码
"data":{
"xfsbh":"9142**********988G", --销方识别号
"gfmc":"中国**集团有限公司", --购方名称
"gmfyhzh":"建行***支行 4200*********0980", --购买方银行账号
"dq":"湖北", --地区
"xsfdzdh":"湖北省**市**县***农场**管理所 027-83****68", --销售方地址电话
"jshjcn":"壹佰零伍元玖角捌分", --价税合计（中文大写）
"se":3.09, --税额
"kprq":"2022-06-14 00:00:00", --开票日期
"bz":"汇总开具", --备注
"kjlx":"1", --开具类型标识：0委托代开 1自开 2代开 3代办退税
"fpztDm":"0", --发票状态代码
"sbbh":"499099651596", --设备编号
"txfbz":"Y", --通行费标志
"gfsbh":"9142********5556", --购方识别号
"fpdm":"042******112", --发票代码
"fplx":"14", --发票类型
"gmfdzdh":"**区**街坊（**区**路*号****大楼） 027-68****15", --购买方地址电话
"xsfyhzh":"工行**县支行1814**********7451", --销售方银行账号
"jshj":105.98, --价税合计
"je":102.89, --金额
"xfmc":"湖北**高速公路经营有限公司", --销方名称
"hwxx":[
{
"mxxh":1, --明细序号
"ggxh":"鄂******", --车牌号
"jldw":"客车", --类型
"sl":"20220602", --数量（通行日期起）
"dj":"20220610", --单价（通行日期止）
"txrqq":"20220602", --通行日期起
"txrqz":"20220610", --通行日期止
"lslbs":" ", --零税率标识
"se":3.09, --税额
"ysse":"3.09", --原始税额
"mc":"经营租赁通行费", --名称
"je":102.89, --金额
"slv":0.03, --税率
"ysslv":"3%", --原始税率
"spbm":"3040502020301000000" --商品编码
}
],
"fphm":"89****71", --发票号码
"jym":"0335************4357" --校验码
},
"fplx":"14", --发票类型
"kprq":"2022-06-14 00:00:00", --开票日期
"success":true, --查验是否成功标识，true成功false失败
"time":"2022-11-28 15:57:39", --查验时间
"fphm":"89****71", --发票号码
"jym":"074357" --校验码
}
]
}
//15二手车销售统一发票查验成功返回结果
{
"result":{
"req_id":"205614c567724c94a2f81a33004bc6dc",
"success":true,
"time":1108,
"timestamp":1649061074715
},
"value":[
{
"times":4, --查验次数（第几次）
"fpdm":"0370****0117", --发票代码
"data":{
"jyPmSbh":"", --经营、拍卖单位纳税人识别号
"cjhj":24600, --车价合计
"cjhjcn":"贰万肆仟陆佰元整", --车价合计（中文大写）
"dq":"青岛", --地区
"zrdclglsMc":"**区车管所", --转入地车辆管理所名称
"jyPmMc":"", --经营、拍卖单位名称
"jyPmDz":"", --经营、拍卖单位地址
"kprq":"2019-11-20 00:00:00", --开票日期
"clsbdm":"LJRC12265D600****", --车架号/车辆识别代码
"escSbh":"9137**********NH6G", --二手车市场识别号
"bz":"", --备注
"djzh":"3700****5926", --登记证号
"cllx":"重型集装箱半挂车", --车辆类型
"xfMc":"青岛****流有限公司", --卖方单位/个人名称
"xfDz":"山东省青岛市**区***路**号*号库办公楼***室", --卖方单位/个人地址
"escDh":"0532-68****25", --二手车市场电话
"fpztDm":"0", --（电子底账用）发票状态代码：发票状态代码 0正常 1失控（历史数据） 2作废 3已红冲
"jyPmDh":"", --经营、拍卖单位电话
"sbbh":"661818887363", --设备/机器编号：税控盘号、金税盘号
"fpdm":"0370****0117", --发票代码
"gfMc":"青岛**物流有限公司", --买方单位/个人名称
"gfDz":"山东省青岛市**区****路***号***室", --买方单位/个人地址
"fplx":"15", --发票类型
"xfDh":"151*****175", --卖方单位/个人电话
"escMc":"青岛**二手车交易市场有限公司", --二手车市场名称
"escDz":"山东省青岛市**区**路***号", --二手车市场地址
"xfDm":"9137**********4917", --卖方单位/个人代码
"gfDh":"151*****175", --买方单位/个人电话
"cpxh":"中集牌ZJV****TJZ", --厂牌型号
"cpzh":"鲁UF***挂", --车牌照号
"jyPmYhzh":"", --经营、拍卖单位开户银行账号
"gfDm":"9137**********BJ07", --买方单位/个人代码
"escYhzh":"中国建设银行股份有限公司*******路支行 3715**********0296", --二手车市场开户行账号
"fphm":"00****76" --发票号码
},
"fplx":"15", --发票类型
"kprq":"2019-11-20 00:00:00", --开票日期
"success":true, --查验是否成功标识，true成功，false失败
"je":24600, --金额
"time":"2022-04-04 16:31:13", --查验时间
"fphm":"00****76" --发票号码
}
]
}
// 增值税发票查验失败情况
{
"result": {
"success": true,
"req_id": "6dd110823a33447b9944a8bd23b1cb17",
"timestamp": 1606786781629,
"time": 214
},
"value": [{
"fpdm": "0320019002**", --发票代码
"fphm": "607724**", --发票号码
"kprq": "2020-03-25 00:00:00", --开票日期
"jym": "262045", --校验码
"success": false, -- 查验是否成功
"code": "CheckInvoiceException", -- 查验失败时失败编码
"message": "税局服务异常，建议15-20分钟后重试" -- 查验失败时失败信息
}]
}
- 字段说明
增值税发票全字段
| 字段 | 类型 | 说明 |
|---|---|---|
| times | String | 查验次数（第几次） |
| success | Boolean | 查验是否成功标识 true成功false失败 |
| time | String | 查验时间 |
| data | Object | 查验返回的发票数据 |
| fplx | String | 发票类型代码 |
| dq | String | 地区 |
| fpdm | String | 发票代码 |
| fphm | String | 发票号码 |
| kprq | String | 开票日期 |
| jym | String | 校验码 |
| xfsbh | String | 销方识别号 |
| xfmc | String | 销方名称 |
| xsfdzdh | String | 销售方地址电话 |
| xsfyhzh | String | 销售方银行账号 |
| gfsbh | String | 购方识别号 |
| gfmc | String | 购方名称 |
| gmfdzdh | String | 购买方地址电话 |
| gmfyhzh | String | 购买方银行账号 |
| je | Number | 金额（不含税） |
| se | Number | 税额 |
| jshj | Number | 价税合计 |
| jshjcn | String | 价税合计（中文大写） |
| bz | String | 备注 |
| xhqdBz | String | 清单标志：发票明细中是否有清单行（Y清单 N非清单） |
| kjlx | String | 开具类型标识：0委托代开 1自开 2代开 3代办退税 |
| tspzDm | String | 特殊票种代码，02农产品收购发票 08成品油发票 |
| sbbh | String | 设备编号 |
| fpztDm | String | 发票状态代码 |
| hwxx | Object | 货物信息 |
| mxxh | Number | 明细序号 |
| spbm | String | 商品编码 |
| mc | String | 名称 |
| ggxh | String | 规格型号 |
| sl | String | 数量 |
| jldw | String | 计量单位 |
| dj | String | 单价 |
| slv | Number | 税率 |
| ysslv | String | 原始税率 |
| se | Number | 税额 |
| ysse | String | 原始税额 |
| txrqq | String | 通行日期起（通行费发票专有） |
| txrqz | String | 通行日期止（通行费发票专有） |
| dkXsfsbh | String | 代开销售方识别号 |
| dkXsfmc | String | 代开销售方名称 |
| txfbz | String | 通行费标识。如果是通行费，则有该字段，Y表示该通行费可抵扣，N表示不可以抵扣 |
| url | String | OFD版式文件下载链接（只有税务ukey开具的电子专票和电子普票有） |
| purl | String | PDF版式文件下载链接（只有税务ukey开具的电子专票和电子普票有） |
| sfzhm | String | 身份证号码/组织机构代码 |
| cllx | String | 车辆类型 |
| cpxh | String | 厂牌型号 |
| cd | String | 产地 |
| hgzh | String | 合格证号 |
| jkzmsh | String | 进口证明书号 |
| sjdh | String | 商检单号 |
| fdjhm | String | 发动机号码 |
| cjhm | String | 车架号码/车辆识别代码 |
| xhdwmc | String | 销货单位名称 |
| dh | String | 电话 |
| xhdwsbh | String | 销货单位纳税人识别号 |
| zh | String | 账号 |
| dz | String | 地址 |
| khyh | String | 开户银行 |
| zzsse | Number | 增值税税额 |
| swjgDm | String | 主管税务机关代码 |
| swjgMc | String | 主管税务机关名称 |
| wspzhm | String | 完税凭证号码 |
| dw | String | 吨位 |
| xcrs | String | 限乘人数 |
| skm | String | 税控码 |
| zrdclglsMc | String | 转入地车辆管理所名称 |
| jyPmMc | String | 经营、拍卖单位名称 |
| jyPmDz | String | 经营、拍卖单位地址 |
| clsbdm | String | 车架号/车辆识别代码 |
| escSbh | String | 二手车市场识别号 |
| djzh | String | 登记证号 |
| xfMc | String | 卖方单位/个人名称 |
| xfDz | String | 卖方单位/个人地址 |
| escDh | String | 二手车市场电话 |
| jyPmDh | String | 经营、拍卖单位电话 |
| gfMc | String | 买方单位/个人名称 |
| gfDz | String | 买方单位/个人地址 |
| xfDh | String | 卖方单位/个人电话 |
| escMc | String | 二手车市场名称 |
| escDz | String | 二手车市场地址 |
| xfDm | String | 卖方单位/个人代码 |
| gfDh | String | 买方单位/个人电话 |
| cpzh | String | 车牌照号 |
| jyPmYhzh | String | 经营、拍卖单位开户银行账号 |
| gfDm | String | 买方单位/个人代码 |
| escYhzh | String | 二手车市场开户行账号 |
| cjhj | Number | 车价合计 |
| cjhjcn | String | 车价合计(中文大写) |
| qdlx | String | 全电发票类型 10 电子发票（普通发票） 20 电子发票（增值税专用发票） |
| kpr | String | 开票人 |
| skr | String | 收款人 |
| fhr | String | 复核人 |
| hsdj | String | 含税单价 |
| hsje | Number | 含税金额 |
| mxts | String | 明细条数 |
| kpjh | String | 开票机号 |
| lslbs | String | 零税率标识 空代表无出口退税；1出口免税和其他免税优惠政策；2不征增值税＿普通零税率 |
具体每种票的字段参见发票查验返回结果字段说明
5、错误码
| 错误代码 | 错误信息 | 说明 |
|---|---|---|
| CheckInvoiceNotExistence | 查验成功所查发票不存在 | 发票代码或发票号码在税局查不到，请核对代码、号码是否正确 |
| CheckInvoiceNotStandard | 查询发票不规范 | 请核对四要素是否符合发票规范 |
| CheckInvoiceNotSame | 查验成功发票不⼀致 | 请检查四要素是否与真实票面一致，传入金额是否为不含税金额（非二手车）或该发票是否为假票 |
| CheckInvoiceMoreFiveTimes | 超过该张票当天查验次数 | 请确认在调用接口前是否已经通过官方平台查验超过5次 |
| IllegalParameter | 参数不合法 | 请核对参数是否符合参数规范 |
| IllegalParameter.IllegalInvoiceCode | 请求参数不正确,参数fpdm发票代码不正确 | 请核对fpdm发票代码是否符合参数规范 |
| IllegalParameter.IllegalInvoiceNumber | 请求参数不正确,参数fphm发票号码不正确 | 请核对fphm发票号码是否符合参数规范 |
| IllegalParameter.IllegalCheckCode | 请求参数不正确,参数 jym 发票校验码后6位不正确 | 请核对jym校验码是否符合参数规范 |
| IllegalParameter.IllegalTotalAmount | 请求参数不正确,参数 je 不含税金额 不正确 | 请核对je金额是否符合参数规范 |
| CheckInvoiceException | 查验异常 | 税局服务异常，建议15-20分钟后重试 |
| CheckExceedingLimit | 查验发票张数超过限制 | 发票剩余查验量不足，请与运营负责人沟通确认 |
| ServerError | 服务器异常，请稍后重试 | 服务器异常 |
| CheckInvoiceSingular | 请求太频繁或超过服务器最大请求数，请稍后访问！ | 当前请求数达到服务最大并发数 |
| CheckInvoicesOverFiveYears | 超过五年的发票不能查验 | 请核对开票日期是否正确 |
| CheckInvoicesMoreThanToday | 开票日期超过当前日期 | 请核对开票日期是否正确 |
| CheckInvoiceForTheSameFrequent | 当前发票正在查验中,请稍后重试 | 当前发票正在查验中,请稍后重试 |
区块链发票查验
1、接口描述
该接口用于区块链发票查验
2、接口地址
POST /v1/FP/cy HTTP/1.1
3、请求参数
- 参数说明
请求参数为JSON格式。
| 参数名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| customReqId | String | 否 | 传入的请求ID，用于标识一次调用，传入前先保存，需保证唯一性。 生成规则：AppKey+去掉横杠的UUID，示例：100019953790cccf01c45ce1b744e14ec46384eb |
| cyList | List | 是 | 查验发票列表，必填 |
！注意：不同类型的发票cyList里的字段不同，不同地区区块链发票查验的cyList里的参数也不同！
深圳查验区块链发票信息说明
深圳区块链发票使用密码区方式-cyList说明 （暂不支持）
| 参数名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| qkl | Boolean | 是 | 是否区块链发票查验，固定值 true |
| dq | String | 是 | 地区代码，固定值，4403 |
| fphm | String | 是 | 发票号码，必填 |
| jshj | Number | 是 | 价税合计，必填 |
| skm | String | 是 | 密码区，必填 |
深圳区块链发票使用校验码方式-cyList说明
| 参数名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| qkl | Boolean | 是 | 是否区块链发票查验，固定值 true |
| fpdm | String | 是 | 发票代码，必填 |
| fphm | String | 是 | 发票号码，必填 |
| xfsbh | String | 是 | 销售方识别号，必填 |
| jym | String | 是 | 校验码，必填 |
北京查验区块链发票信息-cyList说明
| 参数名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| qkl | Boolean | 是 | 是否区块链发票查验，固定值 true |
| dq | String | 是 | 地区代码，固定值，1100 |
| fpdm | String | 是 | 发票代码，必填 |
| fphm | String | 是 | 发票号码，必填 |
| jym | String | 是 | 校验码，必填 |
云南查验区块链发票信息-cyList说明
| 参数名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| qkl | Boolean | 是 | 是否区块链发票查验，固定值 true |
| dq | String | 是 | 地区代码，固定值，5300 |
| fpdm | String | 是 | 发票代码，必填 |
| fphm | String | 是 | 发票号码，必填 |
| jym | String | 是 | 校验码，必填 |
| xfsbh | String | 是 | 销售方识别号，必填 |
- 示例参数（此参数仅为展示请求参数格式，请勿以此数据作为测试数据）
// 深圳区块链发票使用密码区查验请求参数示例
// 单张
{
"cyList":[
{
"qkl":true,
"dq":"4403",
"fphm":"000000**",
"skm":"a74e72a********************************************34e885**",
"jshj":198
}
]
}
// 多张
{
"cyList":[
{
"qkl":true,
"dq":"4403",
"fphm":"000000**",
"skm":"a74e72a2****************************************************434e885**",
"jshj":198
},
{
"qkl":true,
"dq":"4403",
"fphm":"000000**",
"skm":"a74e72a24*****************************************************34e885**",
"jshj":198
}
]
}
// 深圳区块链发票使用校验码查验请求参数示例
// 单张
{
"cyList":[
{
"qkl":true,
"fpdm":"1440318091**",
"fphm":"000000**",
"xfsbh":"9144030073884274**",
"jym":"88500"
}
]
}
// 多张
{
"cyList":[
{
"qkl":true,
"fpdm":"1440318091**",
"fphm":"000000**",
"xfsbh":"9144030073884274**",
"jym":"88500"
},
{
"qkl":true,
"fpdm":"1440318091**",
"fphm":"000000**",
"xfsbh":"9144030073884274**",
"jym":"88500"
}
]
}
// 北京区块链发票查验请求参数示例
// 单张
{
"cyList":[
{
"qkl":true,
"dq":"1100",
"fpdm":"1110020091**",
"fphm":"000000**",
"jym":"841418"
}
]
}
// 多张
{
"cyList":[
{
"qkl":true,
"dq":"1100",
"fpdm":"1110020091**",
"fphm":"000000**",
"jym":"841418"
},
{
"qkl":true,
"dq":"1100",
"fpdm":"1110020091**",
"fphm":"000000**",
"jym":"841418"
}
]
}
// 云南区块链发票查验请求参数示例
// 单张
{
"cyList":[
{
"qkl":true,
"dq":"5300",
"fpdm":"1530****0382",
"fphm":"00****47",
"jym":"1459d",
"xfsbh":"9153**********8312"
}
]
}
// 多张
{
"cyList":[
{
"qkl":true,
"dq":"5300",
"fpdm":"1530****0382",
"fphm":"00****47",
"jym":"1459d",
"xfsbh":"9153**********8312"
},
{
"qkl":true,
"dq":"5300",
"fpdm":"1530****0382",
"fphm":"00****47",
"jym":"1459d",
"xfsbh":"9153**********8312"
}
]
}
4、返回结果
- 返回结果
返回结果为JSON格式。
// 深圳区块链发票查验结果，使用密码区 (单张)
{
"result": {
"success": true,
"req_id": "6dd110823a33447b9944a8bd23b1cb17",
"timestamp": 1606786781629,
"time": 214
},
"value": [ {
"qkl": true, --是否区块链发票
"fphm": "000000**", --发票号码
"skm": "a74e72a24896403e5124e5f28c9739c357434640810fbd16faa836274434e885**", --密码区
"jshj": 198.0, --价税合计
"success": true, -- 查验是否成功
"data": { --查验成功返回的发票数据
"fpdm": "1440318091**", -- 发票代码
"fphm": "000000**", -- 发票号码
"kprq": "2018-08-10 00:10:07", -- 开票日期
"skm": "a74e72a24896403e5124e5f28c9739c357434640810fbd16faa836274434e885**", -- 密码区
"xfsbh": "9144030073884274**", -- 销售方识别号
"xfmc": "深圳市XX有限公司", -- 销售方名称
"gfmc": "深圳XX服务有限公司", -- 购买方名称
"se": 11.21, -- 税额
"je": 186.79, -- 金额
"jshj": 198.00, -- 价税合计
"fpzt": "1", -- 发票状态，1-已开票 2-已打印 3-已收票 4-已报销 5-已冲红 6-已登记异常 7-已标记销毁 8-已回退
"yczt": "0" -- 异常状态，1-异常发票 0-正常发票
}
}]
}
// 深圳区块链发票查验结果，使用校验码（单张）
{
"result": {
"success": true,
"req_id": "6dd110823a33447b9944a8bd23b1cb17",
"timestamp": 1606786781629,
"time": 214
},
"value": [ {
"qkl": true, --是否是区块链发票
"fpdm": "1440318091**", --发票代码
"fphm": "000000**", --发票号码
"xfsbh": "9144030073884274**", --销方识别号
"jym": "88500", --校验码
"success": true, -- 查验是否成功 true成功，false失败
"data": { --区块链发票查验成功返回的数据
"fpdm": "1440318091**", -- 发票代码
"fphm": "000000**", -- 发票号码
"kprq": "2018-08-10 00:10:07", -- 开票日期
"xfsbh": "9144030073884274**", -- 销售方识别号
"xfmc": "深圳市XX有限公司", -- 销售方名称
"gfmc": "深圳XX服务有限公司", -- 购买方名称
"jshj": 198.00, -- 价税合计
"fpzt": "1", -- 发票状态，1-已开票 2-已打印 3-已收票 4-已报销 5-已冲红 6-已登记异常 7-已标记销毁 8-已回退
"yczt": "0" -- 异常状态，1-异常发票 0-正常发票
}
}]
}
// 北京区块链发票查验结果(单张)
{
"result": {
"success": true,
"req_id": "6dd110823a33447b9944a8bd23b1cb17",
"timestamp": 1606786781629,
"time": 214
},
"value": [ {
"qkl": true, --是否是区块链发票
"fpdm": "1110020091**", --发票代码
"fphm": "000000**", --发票号码
"jym": "841418", --校验码
"success": true, -- 查验是否成功
"data": { --区块链发票查验成功后返回的数据
"kprq": "2020-03-03 00:00:00", -- 开票日期
"fpdm": "1110020091**", -- 发票代码
"fphm": "000000**", -- 发票号码
"xfmc": "北京XX有限公司", -- 销售方名称
"yczt": "0" -- 异常状态，1-异常发票 0-正常发票
}
} ]
}
// 云南区块链发票查验成功返回结果（单张）
{
"result":{
"req_id":"5d8ade291dfe403fa89dbd1f80dc32c1",
"success":true,
"time":895,
"timestamp":1642138271393
},
"value":[
{
"fpdm":"153071960382", --发票代码
"fplx":"100", --发票类型
"success":true, --查验成功与否标识
"fphm":"00239447", --发票号码
"jym":"1459d", --校验码
"data":{ --区块链发票查验成功后返回的数据
"xfsbh":"9153**********8312", --销方识别号
"gfmc":"昆明地铁****公司", --购方名称
"dq":"云南", --地区
"kprq":"2020-03-20 13:47:46", --开票日期
"kjlx":"1", --开具类型标识：0委托代开 1自开 2代开 3代办退税
"fpdm":"1530****0382", --发票代码
"fplx":"100", --发票类型
"fpzt":"5", --发票状态
"jshj":2, --价税合计
"xfmc":"昆明轨道交通集团有限公司", --销方名称
"yczt":"0", --异常状态
"fphm":"00****47", --发票号码
"jym":"1459d" --校验码
}
}
]
}
// 区块链发票查验失败情况
{
"result": {
"success": true,
"req_id": "6dd110823a33447b9944a8bd23b1cb17",
"timestamp": 1606786781629,
"time": 214
},
"value": [{
"fpdm": "0320019002**", --发票代码
"fphm": "607724**", --发票号码
"kprq": "2020-03-25 00:00:00", --开票日期
"jym": "262045", --校验码
"success": false, -- 查验是否成功
"code": "CheckInvoiceException", -- 查验失败时失败编码
"message": "税局服务异常，建议15-20分钟后重试" -- 查验失败时失败信息
}]
}
- 字段说明
| 字段名 | 说明 |
|---|---|
| fplx | 发票类型代码 |
| fpzt | 发票状态 |
| data | 发票信息相关字段，参考发票结构说明 |
5、错误码
| 错误代码 | 错误信息 | 说明 |
|---|---|---|
| IllegalParameter | 参数不合法 | 请核对参数是否符合参数规范 |
| IllegalParameter.IllegalInvoiceCode | 请求参数不正确,参数fpdm发票代码不正确！ | 请核对fpdm发票代码是否符合参数规范 |
| IllegalParameter.IllegalInvoiceNumber | 请求参数不正确,参数fphm发票号码不正确！ | 请核对fphm发票号码是否符合参数规范 |
| IllegalParameter.IllegalTotalAmountIincludingTax | 请求参数不正确,参数jshj价税合计不正确！ | 请核对jshj价税合计是否符合参数规范 |
| IllegalParameter.IllegalSkm | 请求参数不正确,参数skm密码区不正确！ | 请核对skm密码区是否符合参数规范 |
| IllegalParameter.IllegalCheckCode | 请求参数不正确,参数jym校验码不正确 | 请核对jym校验码是否符合参数规范 |
| IllegalParameter.IllegalXfsbh | 请求参数不正确,参数xfsbh销方识别号不正确！ | 请核对xfsbh销方识别号是否符合参数规范 |
| IllegalParameter.IllegalArea | 请求参数不正确,参数dq地区不正确！ | 请核对dq地区是否符合参数规范 |
| CheckInvoiceNotExistence | 查验成功所查发票不存在 | 发票代码或发票号码在税局查不到，请核对代码、号码是否正确 |
| CheckInvoiceNotStandard | 查询发票不规范 | 请核对四要素是否符合发票规范 |
| CheckInvoiceNotSame | 查验成功发票不⼀致 | 请检查四要素是否与真实票面一致，传入金额是否为不含税金额（非二手车）或该发票是否为假票 |
| CheckInvoiceMoreFiveTimes | 超过该张票当天查验次数 | 请确认在调用接口前是否已经通过官方平台查验超过5次 |
| CheckInvoiceException | 查验异常 | 税局服务异常，建议15-20分钟后重试 |
| CheckExceedingLimit | 查验发票张数超过限制 | 发票剩余查验量不足，请与运营负责人沟通确认 |
| CheckInvoiceNotSupport | 暂不支持该（省市）电子票据查验 | 该地区暂不支持该票种查验 |
| CheckAbnormal | 错误信息不固定 | 查验其他异常 |
| ServerError | 服务器异常，请稍后重试 | 服务器异常 |
| CheckInvoicesOverFiveYears | 超过五年的发票不能查验 | 请核对开票日期是否正确 |
| CheckInvoicesMoreThanToday | 开票日期超过当前日期 | 请核对开票日期是否正确 |
| CheckInvoiceForTheSameFrequent | 当前发票正在查验中,请稍后重试 | 当前发票正在查验中,请稍后重试 |
全电发票查验
1、接口描述
该接口用于全电发票查验
2、接口地址
POST /v1/FP/cy HTTP/1.1
3、请求参数
- 参数说明
请求参数为JSON格式。
| 参数名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| customReqId | String | 否 | 传入的请求ID，用于标识一次调用，传入前先保存，需保证唯一性。 生成规则：AppKey+去掉横杠的UUID，示例：100019953790cccf01c45ce1b744e14ec46384eb |
| cyList | List | 是 | 全电发票查验列表，必填 |
！注意：不同类型的发票cyList里的字段不同
全电发票-cyList说明（电子发票（增值税专用发票）、电子发票（普通发票）、电子发票（铁路电子客票）,电子发票（航空运输电子客票行程单））
| 参数名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| fphm | String | 是 | 发票号码 20 位，必填 |
| kprq | String | 是 | 开票日期，必填，格式 yyyy-MM-dd / yyyyMMdd |
| jshj | Number | 是 | 价税合计，必填 |
全电纸质发票-cyList说明（全电纸质发票(增值税专用发票)、全电纸质发票(增值税普通发票)、全电纸质(机动车销售统一发票)、全电纸质(二手车统一销售发票)）
| 参数名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| fpdm | String | 是 | 发票代码，必填 |
| fphm | String | 是 | 发票号码，必填 |
| kprq | String | 是 | 开票日期，必填，格式 yyyy-MM-dd / yyyyMMdd |
| je | Number | 是 | 不含税金额，全电纸质发票(增值税专用发票)、全电纸质(机动车销售统一发票)/车价合计（全电纸质(二手车统一销售发票)））时必填 |
| jym | String | 是 | 校验码，取票面上密码区内全电发票号码的后6位，全电纸质发票(增值税普通发票)时必填 |
- 示例参数（此参数仅为展示请求参数格式，请勿以此数据作为测试数据）
//全电发票查验请求参数示例（单张）
{
"cyList":[
{
"fphm":"2131700000000000****",
"kprq":"2021-12-01",
"jshj":"1129.99"
}
]
}
//全电纸质发票(增值税专用发票)查验请求参数示例（单张）
{
"cyList":[
{
"fpdm":"310******130",
"fphm":"36****84",
"kprq":"2022-09-22",
"je":346.9
}
]
}
//全电纸质发票(增值税普通发票)查验请求参数示例（单张）
{
"cyList":[
{
"fpdm":"031******304",
"fphm":"13****59",
"kprq":"2022-11-09",
"jym":"555922"
}
]
}
//0903全电纸质(机动车销售统一发票)查验请求参数示例（单张）
{
"cyList": [
{
"fpdm": "11*******60",
"fphm": "00****11",
"kprq": "20231117",
"je": "189203.54"
}
]
}
//0915全电纸质(二手车统一销售发票)查验请求参数示例（单张）
{
"cyList": [
{
"fpdm": "01*******17",
"fphm": "00****96",
"kprq": "20231114",
"je": "1000.00"
}
]
}
//全电发票查验请求参数示例（多张）
{
"cyList":[
{
"fphm":"2131700000000000****",
"kprq":"2021-12-01",
"jshj":"1129.99"
},
{
"fphm":"2131700000000000****",
"kprq":"2021-12-01",
"jshj":"1129.99"
}
]
}
4、返回结果
- 返回结果
返回结果为JSON格式。
//全电发票0910电子发票（普通发票）查验成功返回结果示例
{
"result": {
"req_id": "b8c1214afcef4045a89a24fed599f5ad",
"success": true,
"time": 178,
"timestamp": 1686809796352
},
"value": [
{
"times": 11, --查验次数
"fpdm": null, --发票代码
"data": { --查验成功返回数据
"xfsbh": "91****************8U", --销方识别号
"xfmc": "大连**楼******公司", --销方名称
"xsfyhzh": "中国******公司****广场支行 34****************26", --销售方银行账号
"xsfdzdh": "辽宁省**市**区**街**号***轴公建 13*******88", --销售方地址电话
"gfsbh": "91***************95", --购方识别号
"gfmc": "辽宁********公司", --购方名称
"gmfyhzh": "", --购买方银行账号
"gmfdzdh": "", --购买方地址电话
"tspzDm": "", --特殊票种代码
"purl": "", --PDF版式文件下载链接
"dq": "大连", --地区
"jshjcn": "肆佰元整", --价税合计中文大写
"kpjh": null, --开票机号
"se": 22.64, --税额
"skm": null, --密码区
"kprq": "2023-05-28 00:00:00", --开票日期
"bz": "收款人：李*; 复核人：张*", --备注
"mxts": null, --明细条数
"kjlx": "1", --开具类型标识：0委托代开 1自开 2代开 3代办退税
"fpztDm": "0", --发票状态代码
"sbbh": "", --设备/机器编号：税控盘号、金税盘号
"fpdm": "", --发票代码
"fplx": "0910", --发票类型
"qdfphm": "23****************26", --全电发票号码
"qdlx": "10", --全电类型
"kpr": null, --开票人
"url": "", --OFD版式文件下载链接
"skr": "李*", --收款人
"fhr": "张*", --复核人
"jshj": 400.0, --价税合计
"je": 377.36, --金额
"hwxx": [ --货物信息
{
"ggxh": "", --规格型号
"jldw": "", --计量单位
"dj": "377.358490566038", --单价
"mxxh": 1, --明细序号
"lslbs": "", --零税率标识
"se": 22.64, --税额
"ysse": "22.64", --原始税额
"mc": "*餐饮服务*餐费", --名称
"sl": "1", --数量
"je": 377.36, --金额
"slv": 0.06, --税率
"ysslv": "6%", --原始税率
"spbm": "3070401000000000000" --商品编码
}
],
"fphm": "23****************26", --发票号码
"jym": "23****************26" --校验码
},
"fplx": "0910", --发票类型
"kprq": "2023-05-28 00:00:00", --开票日期
"success": true, --查验是否成功，true成功，fasle失败
"jshj": 400, --价税合计
"je": null, --金额
"time": "2023-06-14 09:04:30", --查验时间
"fphm": "23****************26", --发票号码
"jym": null --校验码
}
]
}
//全电发票0920电子发票（增值税专用发票）查验成功返回结果示例
{
"result": {
"success": true,
"req_id": "6dd110823a33447b9944a8bd23b1cb17",
"timestamp": 1606786781629,
"time": 214
},
"value": [ {
"times": 122, --查验次数
"fphm": "2131700000000000****", --发票号码
"kprq": "2021-12-01 00:00:00", --开票日期
"jshj": "1129.99", --价税合计
"success": true, --查验是否成功
"data": { --查验成功返回的发票数据
"fplx": "0920", --发票类型
"fphm": "2131700000000000****", --发票号码
"kprq": "2021-12-01 00:00:00", --开票日期
"xfsbh": "91310107660704****", --销方识别号
"xfmc": "上海****有限公司", --销方名称
"xsfyhzh": "中国******公司****广场支行 34****************26", --销售方银行账号
"xsfdzdh": "辽宁省**市**区**街**号***轴公建 13*******88", --销售方地址电话
"gfsbh": "91310107566588****", --购方识别号
"gfmc": "*****有限公司", --购方名称
"gmfyhzh": "", --购买方银行账号
"gmfdzdh": "", --购买方地址电话
"je": 999.99, --金额
"se": 130.0, --税额
"jshj": 1129.99, --价税合计
"jshjcn":"壹仟壹佰贰拾玖元玖角玖分", --价税合计（中文大写）
"bz": "", --备注
"fpztDm": "0", --发票状态代码
"skr": "周*", --收款人
"fhr": "吴*", --复核人
"hwxx": [{ --货物信息
"mxxh": 1, --明细序号
"spbm": 304020300*******000, --商品编码
"mc": "*纸制品*积点卡", --名称
"ggxh": "", --规格型号
"sl": "3138.857212", --数量
"jldw": "张", --计量单位
"dj": "0.3185841", --单价
"je": 999.99, --金额
"slv": 0.13, --税率
"ysslv":"13%", --原始税率
"se": 130.0, --税额
"ysse":"130.00" --原始税额
}],
"qdlx": "20", -- 全电发票类型 10 电子发票（普通发票） 20 电子发票（增值税专用发票）
"url": null,
"purl": null
}
}]
}
//83全电发票（铁路电子客票）查验成功返回结果示例
{
"result": {
"req_id": "ff949e874c0b499bb6442320b694686b",
"success": true,
"time": 2564,
"timestamp": 1656036558115
},
"value": [
{
"times": 34, --查验次数
"fpdm": null, --发票代码
"data": {
"gfmc": "国网***东部电力有限公司", --购方名称
"pz": "", --票种
"jshjcn": "伍拾捌元整", --价税合计（中文大写）
"se": 4.79, --税额
"ywlx": "1", --业务类型： 0退 1售
"cfsj": "17:37", --出发时间
"kprq": "2022-06-09 00:00:00", --开票日期
"fpztDm": "0", --发票状态代码
"kttz": "--", --空调特征
"cc": "G2**1", --车次
"gfsbh": "9115*******595Q", --购方识别号
"fpdm": "", --发票代码
"fplx": "83", --发票类型
"xb": "二等座", --席别
"ccrq": "20220609", --乘车日期
"cx": "04车", --车厢
"cfz": "北京南", --出发站
"dzkph": "2115*********************2022", --电子客票号
"name": "杜*蔚", --姓名
"zjh": "211202******052792", --证件号
"jshj": 58.0, --价税合计（票价）
"je": 53.21, --金额
"ddz": "天津南", --到达站
"slv": 9.0, --税率
"fphm": "2211**************0001", --发票号码
"xw": "05A号" --席位
},
"fplx": "83", --发票类型
"kprq": "2022-06-09 00:00:00", --开票日期
"success": true, --查验是否成功，true成功，false失败
"jshj": 58.0, --价税合计
"je": null, --金额
"time": "2022-06-24 10:09:17", --查验时间
"fphm": "2211**************0001", --发票号码
"jym": null --校验码
}
]
}
//61电子发票（航空运输电子客票行程单）
{
"result": {
"success": true,
"req_id": "1c28ae1a730b408a9f8bd41a22661587",
"timestamp": 1682240243261,
"time": 1193
},
"value": [
{
"fplx": "61", --发票类型
"fpdm": "", --发票代码
"fphm": "23****************60", --发票号码
"kprq": "2023-03-15 00:00:00", --开票日期
"je": null, --金额
"jym": null, --校验码
"jshj": 1080.0, --价税合计
"success": true, --查验是否成功，true成功，false失败
"time": "2023-04-23 16:57:38", --查验时间
"times": 27, --查验次数
"data": {
"fplx": "61", --发票类型
"fpdm": "", --发票代码
"fphm": "23****************60", --发票号码
"cycs": "27", --查验次数
"cysj": "2023-04-23 16:57:38", --查验时间
"dkbz": "", --抵扣标志
"fpztDm": "0", --发票状态代码
"kprq": "2023-03-15 00:00:00", --开票日期
"gfsbh": "91**************XE", --购方识别号
"gfmc": "厦门****有限公司", --购方名称
"jshj": 1080.00, --价税合计
"hjse": 85.05, --合计税额
"gngjbz": "国内", --国内国际标识
"gpdh": "", --GP单
"lkxm": "徐*明", --旅客姓名
"sfzjhm": "654126******242311", --有效身份证件号码
"dzkphm": "78*********94", --电子客票号码
"hwxx": [
{
"hdxh": "1", --航段序号
"sfz": "URC 乌鲁木齐", --始发站
"mdz": "NKG 南京", --目的站
"cyr": "南航", --承运人
"hbh": "CZ**27", --航班号
"zwdj": "N", --座位等级
"cyrq": "2022-06-15", --承运日期
"qfsj": "09:03", --起飞时间
"kpjb": "NRE***NP" --客票级别/客票类别
}
]
},
"retry": null
}
]
}
//0901全电纸质发票(增值税专用发票)查验成功返回结果示例
{
"result":{
"req_id":"74251270135c414d8cfd411508cec043",
"success":true,
"time":896,
"timestamp":1666838550644
},
"value":[
{
"times":25, --查验次数
"fpdm":"310****130", --发票代码
"data":{ --查验成功返回的发票数据
"xfsbh":"9131************949G", --销方识别号
"gfmc":"上海*****有限公司", --购方名称
"gmfyhzh":"3100**********7266", --购买方银行账号
"xhqdBz":"N", --销货清单标识
"tspzDm":" ", --特殊票种代码
"xsfdzdh":"上海市**区****路***号*层021-67****89", --销售方地址电话
"jshjcn":"叁佰玖拾贰元整", --价税合计（中文大写）
"se":45.1, --税额
"kprq":"2022-09-22 00:00:00", --开票日期
"bz":"NOD-BZ-20220913-011", --备注
"kjlx":"1", --开具类型标识：0委托代开 1自开 2代开 3代办退税
"fpztDm":"0", --发票状态代码
"gfsbh":"9131**********8387", --购方识别号
"fpdm":"310****130", --发票代码
"fplx":"0901", --发票类型
"qdfphm":"2231************8309", --全电发票号码
"qdlx":"01", --全电类型
"gmfdzdh":"上海市**区**镇***路****号021*****193", --购买方地址电话
"xsfyhzh":"3100***********8188", --销售方银行账号
"jshj":392, --价税合计
"je":346.9, --金额
"xfmc":"上海****科技有限公司", --销方名称
"hwxx":[ --货物信息
{
"ggxh":"55mm", --规格型号
"jldw":"块", --计量单位
"dj":"2.4778761061947", --单价
"mxxh":1, --明细序号
"se":45.1, --税额
"ysse":"45.10", --原始税额
"mc":"*生物化学制品*胰酪大豆胨琼脂培养基", --名称
"sl":"140", --数量
"je":346.9, --金额
"slv":0.13, --税率
"ysslv":"13%", --原始税率
"spbm":"1070307100000000000" --商品编码
}
],
"fphm":"36****84", --发票号码
"jym":"2231************8309" --校验码
},
"fplx":"0901", --发票类型
"kprq":"2022-09-22 00:00:00", --开票日期
"success":true, --查验是否成功，true成功，false失败
"je":346.9, --金额
"time":"2022-10-27 10:42:30", --查验时间
"fphm":"36****84" --发票号码
}
]
}
//0904全电纸质发票(增值税普通发票)查验成功返回结果示例
{
"result":{
"req_id":"0fac01bbc370488c89e5ba5236bda6f4",
"success":true,
"time":7628,
"timestamp":1668577852064
},
"value":[
{
"times":7, --查验次数
"fpdm":"031******304", --发票代码
"data":{ --查验成功返回的发票数据
"xfsbh":"9131**********M67W", --销方识别号
"gfmc":"**（上海）****有限公司", --购方名称
"gmfyhzh":"", --购买方银行账号
"xhqdBz":"N", --销货清单标识
"tspzDm":" ", --特殊票种代码
"xsfdzdh":"上海市**区***路***号*层*区、*层***、***室、*-**层021-57****88", --销售方地址电话
"jshjcn":"玖佰玖拾元整", --价税合计中文大写
"se":56.04, --税额
"kprq":"2022-11-09 00:00:00", --开票日期
"bz":"", --备注
"kjlx":"1", --开具类型标识：0委托代开 1自开 2代开 3代办退税
"fpztDm":"0", --发票状态代码
"gfsbh":"9131***********078B", --购方识别号
"fpdm":"031******304", --发票代码
"fplx":"0904", --发票类型
"qdfphm":"2231************5922", --全电发票号码
"qdlx":"04", --全电类型
"gmfdzdh":"nullnull", --购买方地址电话
"xsfyhzh":"3105************0251", --销售方银行账号
"jshj":990, --价税合计
"je":933.96, --金额
"xfmc":"上海******有限公司", --销方名称
"hwxx":[ --货物信息
{
"ggxh":"", --规格型号
"jldw":"", --计量单位
"dj":"", --单价
"mxxh":1, --明细序号
"se":56.04, --税额
"ysse":"56.04", --原始税额
"mc":"*住宿服务*住宿服务", --名称
"sl":"", --数量
"je":933.96, --金额
"slv":0.06, --税率
"ysslv":"6%", --原始税率
"spbm":"3070402000000000000" --商品编码
}
],
"fphm":"13****59", --发票号码
"jym":"2231************5922" --校验码
},
"fplx":"0904", --发票类型
"kprq":"2022-11-09 00:00:00", --开票日期
"success":true, --查验是否成功，true成功，false失败
"time":"2022-11-16 12:02:32", --查验时间
"fphm":"13****59", --发票号码
"jym":"555922" --校验码
}
]
}
//0903全电纸质(机动车销售统一发票)查验成功返回结果
{
"result": {
"success": true,
"req_id": "63c4eb1c6e1a42bfacffa4b82ea5f12a",
"timestamp": 1700640903481,
"time": 2068
},
"value": [
{
"fplx": "0903", --发票类型
"fpdm": "118*****60", --发票代码
"fphm": "00*****11", --发票号码
"kprq": "2023-11-17 00:00:00", --开票日期
"je": 189203.54, --金额
"jym": null, --校验码
"success": true, --查验是否成功标识 true成功false失败
"time": "2023-11-22 16:22:30", --查验时间
"times": 7, --查验次数
"data": { --查验成功数据
"fplx": "0903", --发票类型
"dq": "天*", --地区
"fpdm": "11******60", --发票代码
"fphm": "00****11", --发票号码
"kprq": "2023-11-17 00:00:00", --开票日期
"gfmc": "张**", --购方名称
"sfzhm": "", --身份证号码
"gfsbh": "12*******29", --购方识别号
"cllx": "插电式混合动力轿车", --车辆类型
"cpxh": "比亚迪牌******", --厂牌型号
"cd": "深圳市", --产地
"hgzh": "YK********15", --合格证号
"jkzmsh": "无", --进口证明书号
"sjdh": "无", --商检单号
"fdjhm": "L2*****61", --发动机号码
"cjhm": "LC*******32", --车架号码/车辆识别代码
"jshj": 213800.00, --价税合计
"jshjcn": "贰拾壹万叁仟捌佰元整", --价税合计（中文大写）
"xhdwmc": "天津市******公司", --销货单位名称
"dh": "28******11", --电话
"xhdwsbh": "91*********5A", --销货单位纳税人识别号
"zh": "75**********39", --账号
"dz": "河西********85", --地址
"khyh": "中国*******业部", -开户银行
"slv": 0.13, --增值税税率或征收率
"ysslv": "13%", --原始税率 字符串 例【不征税】
"zzsse": 24596.46, --增值税税额
"yszzsse": "24596.46", --原始增值税税额
"swjgDm": "11******00", --主管税务机关代码
"swjgMc": "国家********务所", --主管税务机关名称
"je": 189203.54, --金额（不含税）
"wspzhm": "", --完税凭证号码
"dw": "0.5", --吨位
"xcrs": "5", --限乘人数
"kpr": null, --开票人
"lslbs": "", --税控码
"kjlx": "1", --开具类型
"sbbh": "", --设备编号
"fpztDm": "0" --发票状态代码
}
}
]
}
//0915全电纸质(二手车销售统一发票)查验成功返回结果
{
"result": {
"success": true,
"req_id": "58d5ffc2813b42e398333efe830d4526",
"timestamp": 1700640430236,
"time": 141
},
"value": [
{
"fplx": "0915", --发票类型
"fpdm": "01********17", --发票代码
"fphm": "00****96", --发票号码
"kprq": "2023-11-14 00:00:00", --开票日期
"je": 1000.0, --金额
"jym": null, --校验码
"success": true, --查验是否成功标识 true成功false失败
"time": "2023-11-22 15:52:19", --查验时间
"times": 4, --查验次数
"data": {
"fplx": "0915", --发票类型
"dq": "天津", --地区
"fpdm": "01********17", --发票代码
"fphm": "00****96", --发票号码
"kprq": "2023-11-14 00:00:00", --开票日期
"skm": null, --税控码
"gfDm": "12**************46", --买方单位/个人代码
"gfMc": "张*", --买方单位/个人名称
"gfDz": "天津****************14号", --买方单位/个人地址
"gfDh": "13*****21", --买方单位/个人电话
"xfDm": "12*************27", --卖方单位/个人代码
"xfMc": "吴*", --卖方单位/个人名称
"xfDz": "天津************4号", --卖方单位/个人地址
"xfDh": "18*******51", --卖方单位/个人电话
"spbm": null, --商品编码
"cpzh": "津******", --车牌照号
"djzh": "12********32", --登记证号
"cllx": "小型轿车", --车辆类型
"clsbdm": "LS******10", --车架号/车辆识别代码
"cpxh": "晶锐牌********", --厂牌型号
"zrdclglsMc": "天津市车辆管理所", --转入地车辆管理所名称
"cjhj": 1000.00, --车价合计
"cjhjcn": "壹仟元整", --车价合计(中文大写)
"jyPmSbh": "", --经营、拍卖单位纳税人识别号
"jyPmMc": "", --经营、拍卖单位纳税人识别号
"jyPmDz": "", --经营、拍卖单位地址
"jyPmDh": "", --经营、拍卖单位电话
"jyPmYhzh": "", --经营、拍卖单位开户银行账号
"escSbh": "91**********1J", --二手车市场识别号
"escMc": "天津********公司", --二手车市场名称
"escDh": "02*******58", --二手车市场电话
"escDz": "天津市********院内", --二手车市场地址
"escYhzh": "天津农**********", --二手车市场开户行账号
"bz": "", --备注
"kpfLx": null, --开票方类型：1经营单位 2拍卖单位 03二手车市场
"kpfNsrsbh": null, --开票方纳税人识别号
"kpr": null, --开票人
"kjlx": "1", --开具类型标识：1自开 2代开 3代办退税
"zfr": null, --作废人
"zfrq": null, --作废日期
"fpztBz": null, --发票状态标识：0正数票 1负数票 2空白作废发票 3正数作废发票 4负数作废发票
"bsNsrsbh": null, --报税纳税人识别号
"sbbh": "", --设备/机器编号：税控盘号、金税盘号
"zxbm": null, --自行编码
"fpztDm": "0" --发票状态代码
}
}
]
}
//全电发票查验失败返回结果示例
{
"result": {
"success": true,
"req_id": "6dd110823a33447b9944a8bd23b1cb17",
"timestamp": 1606786781629,
"time": 214
},
"value": [{
"fphm": "2131700000000000****", --发票号码
"kprq": "2020-03-25 00:00:00", --开票日期
"jym": "262045", --校验码
"success": false, -- 查验是否成功
"code": "CheckInvoiceException", -- 查验失败时失败编码
"message": "税局服务异常，建议15-20分钟后重试" -- 查验失败时失败信息
}]
}
- 字段说明
全电发票（增值税专用发票）
| 字段名称 | 类型 | 说明 |
|---|---|---|
| fphm | String | 发票号码 |
| kprq | String | 开票日期 |
| jshj | Number | 价税合计 |
| success | Boolean | 查验是否成功标识 true成功false失败 |
| time | String | 查验时间 |
| times | String | 查验次数（第几次） |
| fplx | String | 发票类型代码 |
| data | Object | 查验返回的发票数据 |
| fplx | String | 发票类型 |
| dq | String | 地区 |
| fphm | String | 发票号码 |
| kprq | String | 开票日期 |
| xfsbh | String | 销方识别号 |
| xfmc | String | 销方名称 |
| xsfyhzh | String | 销售方银行账号 |
| xsfdzdh | String | 销售方地址电话 |
| gfsbh | String | 购方识别号 |
| gfmc | String | 购方名称 |
| gmfyhzh | String | 购买方银行账号 |
| gmfdzdh | String | 购买方地址电话 |
| je | Number | 金额（不含税） |
| se | Number | 税额 |
| jshj | Number | 价税合计 |
| jshjcn | String | 价税合计（中文大写） |
| bz | String | 备注 |
| xhqdBz | String | 清单标志：发票明细中是否有清单行（Y清单 N非清单） |
| kjlx | String | 开具类型标识：0委托代开 1自开 2代开 3代办退税 |
| tspzDm | String | 特殊票种代码，02农产品收购发票 08成品油发票 |
| fpztDm | String | 发票状态代码 |
| skr | String | 收款人 |
| fhr | String | 复核人 |
| hwxx | Object | 货物信息 |
| mxxh | Number | 明细序号 |
| spbm | String | 商品编码 |
| mc | String | 名称 |
| ggxh | String | 规格型号 |
| sl | String | 数量 |
| jldw | String | 计量单位 |
| dj | String | 单价 |
| je | Number | 金额 |
| slv | Number | 税率 |
| ysslv | String | 原始税率 |
| se | Number | 税额 |
| ysse | String | 原始税额 |
| qdlx | String | 全电发票类型 10 电子发票（普通发票） 20 电子发票（增值税专用发票） |
| url | String | OFD版式文件下载链接 |
| purl | String | PDF版式文件下载链接 |
全电发票（增值税普通发票）
| 字段名称 | 类型 | 说明 |
|---|---|---|
| fphm | String | 发票号码 |
| kprq | String | 开票日期 |
| jshj | Number | 价税合计 |
| success | Boolean | 查验是否成功标识 true成功false失败 |
| time | String | 查验时间 |
| times | String | 查验次数（第几次） |
| fplx | String | 发票类型 |
| data | Object | 查验返回的发票数据 |
| fplx | String | 发票类型 |
| dq | String | 地区 |
| fphm | String | 发票号码 |
| kprq | String | 开票日期 |
| xfsbh | String | 销方识别号 |
| xfmc | String | 销方名称 |
| xsfyhzh | String | 销售方银行账号 |
| xsfdzdh | String | 销售方地址电话 |
| gfsbh | String | 购方识别号 |
| gfmc | String | 购方名称 |
| gmfyhzh | String | 购买方银行账号 |
| gmfdzdh | String | 购买方地址电话 |
| je | Number | 金额（不含税） |
| se | Number | 税额 |
| jshj | Number | 价税合计 |
| jshjcn | String | 价税合计（中文大写） |
| bz | String | 备注 |
| kjlx | String | 开具类型标识：0委托代开 1自开 2代开 3代办退税 |
| fpztDm | String | 发票状态代码 |
| skr | String | 收款人 |
| fhr | String | 复核人 |
| hwxx | Object | 货物信息 |
| mxxh | Number | 明细序号 |
| spbm | String | 商品编码 |
| mc | String | 名称 |
| ggxh | String | 规格型号 |
| sl | String | 数量 |
| jldw | String | 计量单位 |
| dj | String | 单价 |
| je | Number | 金额 |
| slv | Number | 税率 |
| ysslv | String | 原始税率 |
| se | Number | 税额 |
| ysse | String | 原始税额 |
| qdlx | String | 全电发票类型 10 电子发票（普通发票） 20 电子发票（增值税专用发票） |
| url | String | OFD版式文件下载链接 |
| purl | String | PDF版式文件下载链接 |
5、错误码
| 错误代码 | 错误信息 | 说明 |
|---|---|---|
| IllegalParameter | 参数不合法 | 请核对参数是否符合参数规范 |
| IllegalParameter.IllegalInvoiceNumber | 请求参数不正确,参数fpdm发票代码不正确！ | 请核对fpdm发票号码是否符合参数规范 |
| IllegalParameter.IllegalBillingDate | 请求参数不正确,参数kprq开票日期不正确！ | 请核对kprq开票日期是否符合参数规范 |
| IllegalParameter.IllegalTotalAmountIincludingTax | 请求参数不正确,参数jshj价税合计不正确！ | 请核对jshj价税合计是否符合参数规范 |
| CheckInvoiceNotExistence | 查验成功所查发票不存在 | 发票代码或发票号码在税局查不到，请核对代码、号码是否正确 |
| CheckInvoiceNotStandard | 查询发票不规范 | 请核对四要素是否符合发票规范 |
| CheckInvoiceNotSame | 查验成功发票不⼀致 | 请检查四要素是否与真实票面一致，传入金额是否为不含税金额（非二手车）或该发票是否为假票 |
| CheckInvoiceMoreFiveTimes | 超过该张票当天查验次数 | 请确认在调用接口前是否已经通过官方平台查验超过5次 |
| CheckInvoiceException | 查验异常 | 税局服务异常，建议15-20分钟后重试 |
| CheckExceedingLimit | 查验发票张数超过限制 | 发票剩余查验量不足，请与运营负责人沟通确认 |
| ServerError | 服务器异常，请稍后重试 | 服务器异常 |
| CheckInvoiceSingular | 请求太频繁或超过服务器最大请求数，请稍后访问！ | 当前请求数达到服务最大并发数 |
| CheckInvoicesOverFiveYears | 超过五年的发票不能查验 | 请核对开票日期是否正确 |
| CheckInvoicesMoreThanToday | 开票日期超过当前日期 | 请核对开票日期是否正确 |
| CheckInvoiceForTheSameFrequent | 当前发票正在查验中,请稍后重试 | 当前发票正在查验中,请稍后重试 |
通用电子发票查验
1、接口描述
该接口用于通用电子发票查验，目前支持浙江、广东通用电子发票查验。
2、接口地址
POST /v1/FP/cy HTTP/1.1
3、请求参数
- 参数说明
请求参数为JSON格式。
| 参数名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| customReqId | String | 否 | 传入的请求ID，用于标识一次调用，传入前先保存，需保证唯一性。 生成规则：AppKey+去掉横杠的UUID，示例：100019953790cccf01c45ce1b744e14ec46384eb |
| cyList | List | 是 | 通用电子发票查验列表，必填 |
！注意：不同类型的发票cyList里的字段不同
浙江省通用电子发票信息-cyList说明
| 参数名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| tydz | Boolean | 是 | 是否通用电子发票查验，固定值 true |
| dq | String | 是 | 地区代码，默认值3300 |
| fpdm | String | 是 | 发票代码，必填 |
| fphm | String | 是 | 发票号码，必填 |
| xfsbh | Sting | 是 | 销方识别号，必填 |
| kprq | String | 是 | 开票日期，必填，格式 yyyy-MM-dd / yyyyMMdd |
| jshj | Number | 是 | 价税合计，必填 |
广东省通用电子发票信息-cyList说明
| 参数名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| tydz | Boolean | 是 | 是否通用电子发票查验，固定值 true |
| dq | String | 是 | 地区代码，默认值4400 |
| fpdm | String | 是 | 发票代码，必填 |
| fphm | String | 是 | 发票号码，必填 |
| xfsbh | Sting | 是 | 销方识别号，必填 |
| jshj | Number | 是 | 价税合计，必填 |
- 示例参数（此参数仅为展示请求参数格式，请勿以此数据作为测试数据）
//浙江省通用电子发票查验请求参数示例（单张）
{
"cyList":[
{
"tydz":true,
"dq":"3300",
"fpdm":"2330****0111",
"fphm":"12****07",
"xfsbh":"9233********3KX6",
"kprq":"20200619",
"jshj":1800
}
]
}
//广东省通用电子发票查验请求参数示例（单张）
{
"cyList":[
{
"tydz":true,
"dq":"4400",
"fpdm":"1440****9010",
"fphm":"03****76",
"xfsbh":"9244*********7759",
"jshj":49.2
}
]
}
//浙江省通用电子发票查验请求参数示例（多张）
{
"cyList":[
{
"tydz":true,
"dq":"3300",
"fpdm":"2330****0111",
"fphm":"12****07",
"xfsbh":"9233********3KX6",
"kprq":"20200619",
"jshj":1800
},
{
"tydz":true,
"dq":"3300",
"fpdm":"2330****0111",
"fphm":"12****07",
"xfsbh":"9233********3KX6",
"kprq":"20200619",
"jshj":1800
}
]
}
//广东省通用电子发票查验请求参数示例（多张）
{
"cyList":[
{
"tydz":true,
"dq":"4400",
"fpdm":"1440****9010",
"fphm":"03****76",
"xfsbh":"9244*********7759",
"jshj":49.2
},
{
"tydz":true,
"dq":"4400",
"fpdm":"1440****9010",
"fphm":"03****76",
"xfsbh":"9244*********7759",
"jshj":49.2
}
]
}
4、返回结果
- 返回结果
返回结果为JSON格式。
//浙江省通用电子发票查验成功返回结果示例
{
"result":{
"req_id":"c2792a91feb64d46918307e54aaa0c32",
"success":true,
"time":713,
"timestamp":1651058881851
},
"value":[
{
"fpdm":"2330****0111", --发票代码
"data":{ --通用电子发票查验结果数据
"xfsbh":"9233********3KX6", --销方识别号
"gfsbh":"9133********442Q", --购方识别号
"fpdm":"2330****0111", --发票代码
"fpzt":"0", --发票状态
"gfmc":"浙江****机械股份有限公司", --购方名称
"kprq":"2020-06-19", --开票日期
"kjlx":"1", --开具类型标识：0委托代开 1自开 2代开 3代办退税
"jshj":"1800", --价税合计
"xfmc":"玉**龙机械设备维修服务部", --销方名称
"dq":"浙江", --地区
"fplbmc":"电子发票", --发票类别名称
"fphm":"12****07" --发票号码
},
"fplx":"102", --发票类型
"kprq":"2020-06-19 00:00:00", --开票日期
"success":true, --查验是否成功的标识
"jshj":1800, --价税合计
"fphm":"12****07" --发票号码
}
]
}
//广东省通用电子发票查验成功返回结果示例
{
"result":{
"req_id":"2224147309dd4144bfe663d23c17e7dd",
"success":true,
"time":574,
"timestamp":1649062054738
},
"value":[
{
"fpdm":"1440****9010", --发票代码
"data":{ --通用电子发票查验结果数据
"cybz":"found", --查验标志，found-成功
"jshj":"Right", --价税合计信息，Right-一致
"nsrshxx":"Right", --纳税人税号信息， Right-一致
"nsrmc":"广州市**区**文具商行" --纳税人名称
},
"fplx":"102", --发票类型
"success":true, --查验是否成功的标志，true成功，false失败
"jshj":49.2, --价税合计
"fphm":"03****76" --发票号码
}
]
}
//浙江省通用电子发票查验失败返回结果示例
{
"result":{
"req_id":"418484b53e0a40df9e6e0aa3753c42c7",
"success":true,
"time":813,
"timestamp":1651058824946
},
"value":[
{
"fpdm":"2330****0111", --发票代码
"code":"CheckAbnormal", --错误码
"fplx":"102", --发票类型
"message":"你录入的发票内容（发票代码:2330****111,发票号码:66****53,开票日期:20211102）无法查到相应的信息，请确认录入信息是否准确！", --错误信息
"kprq":"2021-11-02 00:00:00", --开票日期
"success":false, --查验是否成功的标志，true成功，false失败
"jshj":4278, --价税合计
"fphm":"66****53" --发票号码
}
]
}
//广东省通用电子发票查验失败返回结果示例
{
"result":{
"req_id":"d104bf5db137456ba0500082749e143a",
"success":true,
"time":2033,
"timestamp":1651058766426
},
"value":[
{
"fpdm":"1440****9010", --发票代码
"code":"CheckInvoiceNotSame", --错误码
"fplx":"102", --发票类型
"message":"价税合计和原发票不一致", --错误信息
"success":false, --查验是否成功的标志，true成功，false失败
"jshj":19, --价税合计
"fphm":"03****76" --发票号码
}
]
}
- 字段说明
| 字段名 | 说明 |
|---|---|
| fplx | 发票类型代码 |
| data | 发票信息相关字段，参考发票结构说明 |
5、错误码
| 错误代码 | 错误信息 | 说明 |
|---|---|---|
| IllegalParameter | 参数不合法 | 请核对参数是否符合参数规范 |
| IllegalParameter.IllegalArea | 请求参数不正确,参数dq地区不正确！ | 请核对dq地区是否符合参数规范 |
| IllegalParameter.IllegalInvoiceCode | 请求参数不正确,参数fpdm发票代码不正确！ | 请核对fpdm发票代码是否符合参数规范 |
| IllegalParameter.IllegalInvoiceNumber | 请求参数不正确,参数fphm发票号码不正确！ | 请核对fphm发票号码是否符合参数规范 |
| IllegalParameter.IllegalXfsbh | 请求参数不正确,参数xfsbh销方识别号不正确！ | 请核对xfsbh销方识别号是否符合参数规范 |
| IllegalParameter.IllegalBillingDate | 请求参数不正确,参数kprq开票日期不正确！ | 请核对kprq开票日期是否符合参数规范 |
| IllegalParameter.IllegalTotalAmountIincludingTax | 请求参数不正确,参数jshj价税合计不正确！ | 请核对jshj价税合计是否符合参数规范 |
| CheckInvoiceNotExistence | 查验成功所查发票不存在 | 发票代码或发票号码在税局查不到，请核对代码、号码是否正确 |
| CheckInvoiceNotStandard | 查询发票不规范 | 请核对四要素是否符合发票规范 |
| CheckInvoiceNotSame | 查验成功发票不⼀致 | 请检查四要素是否与真实票面一致，或该发票是否为假票 |
| CheckInvoiceMoreFiveTimes | 超过该张票当天查验次数 | 请确认在调用接口前是否已经通过官方平台查验超过5次 |
| CheckInvoiceException | 查验异常 | 税局服务异常，建议15-20分钟后重试 |
| CheckExceedingLimit | 查验发票张数超过限制 | 发票剩余查验量不足，请与运营负责人沟通确认 |
| CheckInvoiceNotSupport | 暂不支持该（省市）电子票据查验 | 该地区暂不支持该票种查验 |
| CheckAbnormal | 错误信息不固定 | 查验其他异常 |
| ServerError | 服务器异常，请稍后重试 | 服务器异常 |
| CheckInvoicesOverFiveYears | 超过五年的发票不能查验 | 请核对开票日期是否正确 |
| CheckInvoicesMoreThanToday | 开票日期超过当前日期 | 请核对开票日期是否正确 |
| CheckInvoiceForTheSameFrequent | 当前发票正在查验中,请稍后重试 | 当前发票正在查验中,请稍后重试 |
财政票据查验
1、接口描述
该接口用于财政票据查验
2、接口地址
POST /v1/FP/cy HTTP/1.1
3、请求参数
- 参数说明
请求参数为 JSON 格式。
| 参数名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| customReqId | String | 否 | 传入的请求ID，用于标识一次调用，传入前先保存，需保证唯一性。 生成规则：AppKey+去掉横杠的UUID，示例：100019953790cccf01c45ce1b744e14ec46384eb |
| cyList | List | 是 | 财政票据查验列表，必填 |
cyList说明
| 参数名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| xzpj | Boolean | 是 | 是否财政票据查验，固定值true。 |
| fpdm | String | 是 | 票据代码，必填 |
| fphm | String | 是 | 票据号码，必填 |
| kprq | String | 是 | 开票日期，必填，格式 yyyy-MM-dd / yyyyMMdd |
| je | String | 是 | 金额，必填 |
| jym | String | 是 | 校验码，必填 |
- 示例参数（此参数仅为展示请求参数格式，请勿以此数据作为测试数据）
// 财政票据查验请求参数（单张）
{
"cyList": [
{
"xzpj":true,
"fpdm":"45****01",
"fphm":"004****234",
"kprq":"20210925",
"je":123.94,
"jym":"f0**9c"
}
]
}
// 财政票据查验请求参数（多张）
{
"cyList": [
{
"xzpj":true,
"fpdm":"45****01",
"fphm":"004****234",
"kprq":"20210925",
"je":123.94,
"jym":"f0**9c"
},
{
"xzpj":true,
"fpdm":"45****01",
"fphm":"004****234",
"kprq":"20210925",
"je":123.94,
"jym":"f0**9c"
}
]
}
4、返回结果
- 返回结果（此结果仅为一个省份的医疗票据返回结果，不代表所有省份）
返回结果为JSON格式。
// 财政票据查验成功返回结果
{
"result":{
"req_id":"2b9826cd13794734aeddb74ff132a8c4",
"success":true,
"time":1681,
"timestamp":1646815271876
},
"value":[
{
"fpdm":"31060121", --票据代码
"fplx":"101", --发票类型
"kprq":"2021-11-23 00:00:00", --开票日期
"success":true, --查验是否成功（true成功，false失败）
"je":18, --金额
"fphm":"1289270006", --票据号码
"jym":"f739bb"， --校验码
"data":{
"code":"0",
"data":{ --财政票据查验成功返回发票数据（当前为医疗票据查验成功返回数据）
"yraXlwv":"mz20211****9150236", --业务流水号
"rmelrxrmtKzigbXlwv":"011**036", --开票单位代码
"hfkvierhliHvzoSzhs":"", --财政部门印章
"izmwlnMfnyvi":"f7**bb", --校验码
"xozhhrubkzbnvmgZnlfmg":"0.00", --分类自负
"kzbviLkYp":"", --交款人开户行
"nvwrxzoLeviYzozmxv":"0.00", --医保历年账户余额
"ivxLkYp":"", --收款人开户行
"hvoukzbnvmgXlhg":"18.00", --个人自费
"xzhvmfnyvi":"", --病历号
"rgvnOrhg":[
{
"rgvnHgw":"18.00", --收费清单项目标准
"rgvnJfzmgrgb":"1", --收费清单项目数量
"rgvnMznv":"诊察费", --收费清单项目名称
"rgvnIvnzip":"", --收费清单项目备注
"rgvnFmrg":"元", --收费清单项目单位
"rgvnXlwv":"PA0102", --收费清单项目编码
"rgvnWvgzroMznv":"", --项目详细名称
"rgvnZnlfmg":"18.00" --收费清单项目金额
}
],
"hfkvierhliHvzoMznv":"", --财务部门印章
"hgfwvmgRW":"", --学号
"hfkvierhliZivzXlwv":"310115", --财政部门编码(非空）
"kzbviKzigbMznv":"刘**", --交款人
"yfhrmvhhMfnyvi":"", --业务流水号
"nvwrxzoRmhfizmxvGbkv":"自费", --医保类型
"xfiivmxbGbkv":"", --货币种类
"xozhhvh":"", --级别
"hfkvierhliIvnzip":"", --财务部门备注
"rmelrxrmtKzigbMznv":"上海市***区**医院", --收款单位（开票单位）
"slhkrgzorazgrlmMfnyvi":"", --住院号
"hvouxlmxvrgvwZnlfmg":"0.00", --个人自负
"zxxlfmgKzbZnlfmg":"0.00", --个人账户支付
"nvwrxzoRmhfizmxvRW":"", --医保编号
"yfhrmvhhWzgv":"", --业务日期
"rmelrxrmtHvzoRw":"8ddd0c901f0f4bad9041a92e98a9f7ef", --开票单位印章编号
"vcxszmtvIzgv":"", --汇率
"ivevihzo":false, --是否被冲红
"ivxZxxg":"", --收款人账号
"rmSlhkrgzoWzgv":"", --住院日期
"kzbXlwv":"", --缴款码
"zwwivhh":"", --地址
"hvoukzbnvmgZnlfmg":"0.00", --个人自付
"ufmwKzbZnlfmg":"0.00", --医保统筹基金支付
"lfgSlhkrgzoWzgv":"", --出院日期
"lgsviKzbZnlfmg":"0.00", --其他支付
"kzgrvmgMfnyvi":"144616****47458", --门诊号
"rhhfvWzgv":"1637596800000", --开票日期
"ivufmwZnlfmg":"", --退费金额
"vRmelrxvMfnyvi":"128****006", --票据号码
"kzbviKzigbXlwv":"410922******045810", --交款人统一社会信用代码
"nvwrxzoWzgv":"1637596800000", --就诊日期
"kzbviZxxg":"", --交款人账号
"ivxMznv":"", --收款人全称
"zfcRgvnOrhg":[
{
"zfcRgvnJfzmgrgb":"1.00", --收费项目数量
"zfcRgvnMznv":"(诊查费)", --收费项目名称
"zfcRgvnIvnzip":"自费", --收费项目备注
"zfcRgvnIvozgvwXlwv":"", --对应项目编码
"zfcRgvnFmrg":"", --收费项目单位
"zfcRgvnIvozgvwMznv":"", --对应项目名称
"zfcRgvnHgw":"3.0000", --收费项目标准
"zfcRgvnZnlfmg":"3.0000", --收费项目金额
"zfcRgvnXlwv":"PA0102" --收费项目编码
},
{
"zfcRgvnJfzmgrgb":"1.00", --收费项目数量
"zfcRgvnMznv":"(诊查费)", --收费项目名称
"zfcRgvnIvnzip":"自费", --收费项目备注
"zfcRgvnIvozgvwXlwv":"", --对应项目编码
"zfcRgvnFmrg":"", --收费项目单位
"zfcRgvnIvozgvwMznv":"", --对应项目名称
"zfcRgvnHgw":"15.0000", --收费项目标准
"zfcRgvnZnlfmg":"15.0000", --收费项目金额
"zfcRgvnXlwv":"PA0102" --收费项目编码
}
],
"zwwrgrlmzoUfmwKzb":"0.00", --附加基金支付
"vRmelrxvMznv":"上海市医疗门诊收费票据（电子）", --电子票据名称
"nvwrxzoGbkv":"", --医学类型
"vRmelrxvHkvxrnvmXlwv":"310****101", --电子票据模板代码
"rmelrxrmtHvzoSzhs":"", --开票单位印章
"nvwrxzoGszgYzozmxv":"0.00", --医保当年账户余额
"hfkvierhliHvzoRw":"8ddd0c901f0f4bad9041a92e98a9f7ef", --财政部门印章编号
"uzxfogb":"", --院
"hxsllo":"", --学校
"kzbNlwv":"", --交款方式
"xsvxpvi":"系统核验", --复核人
"ldmKzbZnlfmg":"18.00", --个人现金支付
"gvnkozgvGbkv":"02", --显示模板规则
"rmelrxrmtHvzoMznv":"", --开票单位印章名称
"kivkzbZnlfmg":"", --预付款
"ivxszitvZnlfmg":"", --充值金额
"ivozgvwRmelrxvMfnyvi":"", --相关票据号码（预留扩展字段，开具红票时在此写）
"slhkrgzoWzb":"", --住院天数
"litGbkv":"综合医院", --医疗机构类型
"vRmelrxvXlwv":"31060121", --票据代码
"ivozgvwRmelrxvXlwv":"", --相关票据代码（预留扩展字段，开具红票时在此写）
"szmwormtKvihlm":"9915", --开票人
"kzbviKzigbGbkv":"1", --交款人类型
"wvkzignvmgMznv":"", --住院科别
"tvmwvi":"男", --性别
"vcxszmtvKzkvi":"false",
"ztv":"", --年龄
"glgzoZnlfmg":"18.00", --金额
"rhhfvGrnv":"14:40:57", --项目时间
"ivnzip":"财政部全国财政电子票据查验平台: http://pjcy.mof.gov.cn/； ；[微信]:18.00" --备注
},
"message":"处理成功"
}
}
]
}
//浙江省公路车辆通行费票据（电子）查验成功返回结果示例
{
"result":{
"req_id":"636307ac3f914a09930cf5bf6c6acdb6",
"success":true,
"time":225,
"timestamp":1649406098359
},
"value":[
{
"fpdm":"33****22", --票据代码
"data":{
"code":"0",
"data":{
"currencyType":"RMB", --币种
"eInvoiceCode":"33021022", --票据代码
"payTime":"0",
"bizCode":"202203108d4d46788705df90af******", --订单编号
"archiveFlag":"0",
"synNumberPrint":0,
"payWay":"PAY_WX", --收款方式
"checker":"彭**", --复核人
"accessId":"0b51eab5afd74e16ae1eed69d66c58aa",
"invoicingPartyCode":"9133********137U",
"payerPartyCode":"9133********17XY", --交款人统一社会信用代码
"enteguid":"510000007178",
"exchangeRate":1,
"regicode":"330000",
"randomNumber":"V1WW87", --校验码
"id":28863949,
"zfbSync":-1,
"printDate":0,
"eInvoiceName":"浙江省公路车辆通行费票据（电子）", --票据名称
"invoicingPdfOssKey":"V1WW87/pdf/33****22_220****974_AIS.pdf",
"xmlOssKey":"V1WW87/xml/33****22_220****974_A",
"totalAmount":31, --金额
"makeTime":"123423", --
"payerPartyName":"宁波市****有限公司", --交款人
"handlingPerson":"彭**", --收款人
"einvoiceStatus":"1",
"payWayName":"微信", --收款方式
"issueTime":"123423",
"errorDate":0,
"remark":"含合并收费：0.00元\n车牌号：豫NY****（蓝色）\n车型：客1\n出入口：浙江宁波西站-浙江马渚站\n通行日期：2022-03-10 11:53 - 2022-03-10 12:33\n", --备注
"archiveId":0,
"uid":"826e39d48ada4354861fd2efd4a5d8e9",
"errorTime":"0",
"eInvoiceNumber":"220****974", --票据号码
"issueDate":20220310,
"makeDate":20220310, --开票日期
"invoicingXmlOssKey":"V1WW87/xml/33****22_220****974_AI",
"classCode":"330210",
"tradeDate":"20220310",
"billDetailList":[
{
"itemName":"车辆通行费", --项目名称
"itemStd":31, --标准
"itemStdStr":"31.00",
"itemQuantity":1, --数量
"itemAmount":31, --金额
"itemCode":"50012424", --项目编码
"itemUnit":"元", --单位
"billId":28863949,
"itemQuantityStr":"1",
"id":30370566,
"itemAmountStr":"31.00"
}
],
"supervisorXmlOssKey":"V1WW87/xml/33****22_220****974_AIS",
"invoicingPartyName":"宁波**高速公路有限公司", --收款单位
"payerPartyType":"2",
"xmlVersion":1,
"printTime":"0",
"payDate":0,
"synFlagPrint":"0"
},
"message":"处理成功"
},
"fplx":"101", --发票类型
"kprq":"2022-03-10 00:00:00", --开票日期
"success":true, --查验是否成功的标识，true成功，false失败
"je":31, --金额
"fphm":"220****974", --票据号码
"jym":"V1WW87" --校验码
}
]
}
// 财政票据查验失败情况
{
"result":{
"req_id":"b7c7febe42f54b49a8e3ccfd679aac6a",
"success":true,
"time":2576,
"timestamp":1635767997850
},
"value":[
{
"fpdm":"45****21", --发票代码
"code":"IllegalParameter", --错误码
"xzpj":true, --是否是财政票据
"message":"票据金额不能为空", --错误信息
"kprq":"2021-09-07 00:00:00", --开票日期
"success":false, --查验是否成功状态，成功true，失败false
"fphm":"005****663", --发票号码
"jym":"3a**27" --校验码
}
]
}
//仅可查验最近一年内开具的财政电子票据示例
{
"result": {
"req_id": "e993a66715ed4f06a9c9326fd0cd071a",
"success": true,
"time": 43,
"timestamp": 1686810180592
},
"value": [
{
"times": null,
"fpdm": "37****22",
"code": "CheckInvoicesOverOneYears",
"data": null,
"fplx": "101",
"kprq": "2020-03-27 00:00:00",
"success": false,
"je": 550,
"time": null,
"message": "仅可查验最近一年内开具的财政电子票据!",
"fphm": "01******98",
"jym": "f9**36"
}
]
}
- 字段说明
| 字段名称 | 类型 | 说明 |
|---|---|---|
| rmelrxrmtKzigbMznv | String | 收款单位（开票单位） |
| xsvxpvi | String | 复核人 |
| szmwormtKvihlm | String | 开票人 |
| nvwrxzoWzgv | Date | 就诊日期 |
| nvwrxzoRmhfizmxvRW | String | 医保编号 |
| nvwrxzoRmhfizmxvGbkv | String | 医保类型 |
| lgsviKzbZnlfmg | String | 其他支付 |
| kzgrvmgMfnyvi | String | 门诊号 |
| litGbkv | String | 医疗机构类型 |
| hvoukzbnvmgXlhg | String | 个人自费 |
| yraXlwv | String | 业务流水号 |
| zxxlfmgKzbZnlfmg | String | 个人账户支付 |
| hvoukzbnvmgZnlfmg | String | 个人自付 |
| tvmwvi | String | 性别 |
| ldmKzbZnlfmg | String | 个人现金支付 |
| ufmwKzbZnlfmg | String | 医保统筹基金支付 |
| kzbviKzigbMznv | String | 交款人 |
| kzbviKzigbXlwv | String | 交款人统一社会信用代码 |
| vRmelrxvMfnyvi | String | 票据号码 |
| vRmelrxvXlwv | String | 票据代码 |
| izmwlnMfnyvi | String | 校验码 |
| vRmelrxvMznv | String | 电子票据名称 |
| rhhfvWzgv | Date | 开票日期 |
| rmelrxrmtHvzoMznv | String | 开票单位印章名称 |
| rmelrxrmtHvzoSzhs | String | 开票单位印章 |
| rmelrxrmtHvzoRw | String | 开票单位印章编号 |
| hfkvierhliHvzoMznv | String | 财务部门印章 |
| hfkvierhliHvzoSzhs | String | 财政部门印章 |
| hfkvierhliHvzoRw | String | 财政部门印章编号 |
| hvouKzbnvmgXziv | String | 个人承担/个人自理 |
| rmwrerwfzoZxxlfmgXfiiKzbnvmg | String | 本年支付 |
| rmwrerwfzoZxxlfmgKiveKzbnvmg | String | 历年支付 |
| rmwrerwfzoZxxlfmgXfiiYzozmxv | String | 本年余额 |
| rmwrerwfzoZxxlfmgKiveYzozmxv | String | 历年余额 |
| xzhvmfnyvi | String | 病历号 |
| zfcRgvnivozgvwmznv | String | 对应项目名称 |
| zfcRgvnivozgvwxlwv | String | 对应项目编码 |
| zfcRgvnznlfmg | String | 收费项目金额 |
| zfcRgvnfmrg | String | 收费项目单位 |
| zfcRgvnjfzmgrgb | String | 收费项目数量 |
| zfcRgvnxlwv | String | 收费项目编码 |
| zfcRgvnhgw | String | 收费项目标准 |
| zfcRgvnivnzip | String | 收费项目备注 |
| zfcRgvnmznv | String | 收费项目名称 |
| hfkvierhliZivzXlwv | String | 财政部门编码(非空） |
| lfgSlhkrgzoWzgv | String | 出院日期 |
| ivozgvwRmelrxvXlwv | String | 相关票据代码（预留扩展字段，开具红票时在此写） |
| ivozgvwRmelrxvMfnyvi | String | 相关票据号码（预留扩展字段，开具红票时在此写） |
| wvkzignvmgMznv | String | 住院科别 |
| ivufmwZnlfmg | String | 退费金额 |
| yfhrmvhhMfnyvi | String | 业务单号 |
| yfhrmvhhWzgv | String | 业务日期 |
| kzbXlwv | String | 缴款码 |
| rmSlhkrgzoWzgv | String | 住院日期 |
| ivxszitvZnlfmg | String | 充值金额 |
| kzbviZxxg | String | 交款人账号 |
| kzbviLkYp | String | 交款人开户行 |
| kzbviKzigbGbkv | String | 交款人类型 |
| vcxszmtvIzgv | String | 汇率 |
| vRmelrxvHkvxrnvmXlwv | String | 电子票据模板代码 |
| kzbNlwv | String | 交款方式 |
| rmelrxrmtKzigbXlwv | String | 开票单位代码 |
| ivxLkYp | String | 收款人开户行 |
| ivxMznv | String | 收款人全称 |
| ivxZxxg | String | 收款人账号 |
| vRmelrxvXlwv | String | 电子票据代码 |
| ivnzip | String | 备注 |
| xfiivmxbGbkv | String | 货币种类 |
| hfkvierhliIvnzip | String | 财务部门备注 |
| ztv | String | 年龄 |
| nvwrxzoGbkv | String | 医学类型 |
| ufmwKzbZnlfmgRmul | String | 医保统筹基金支付信息 |
| lgsviKzbZnlfmgRmul | String | 其他支付信息 |
| kzgrvmgXlnkzmb | String | 患者单位 |
| kslmvMfnyvi | String | 手机号码 |
| kivkzbZnlfmg | String | 预付款 |
| ivtrXlwv | String | 区域注册码 |
| kirmgWzgv | String | 打印日期 |
| kirmgGrnv | String | 打印时间 |
| kirmgvw | String | 打印 |
| vmgviTfrw | String | 进入标识 |
| elrwvw | String | 冲红 |
| elrwWzgv | String | 冲红日期 |
| elrwGrnv | String | 冲红时间 |
| elrwIvzhlm | String | 冲红原因 |
| yllpRw | String | 订阅RW |
| zxxvhhRw | String | 数据库RW |
| xivzgvGrnv | String | 创建时间 |
| fkwzgvGrnv | String | 最后更新时间 |
| vRmelrxvHgzgfh | String | 电子状态 |
| rgvnZnlfmgKvixvmg | String | 金额百分比 |
| kirmgXlwv | String | 打印代码 |
| kirmgMfnyvi | String | 打印编码 |
| Xozhhvh | String | 级别 |
| SlhkrgzorazgrlmMfnyvi | String | 住院号 |
| HgfwvmgRW | String | 学号 |
| Hxsllo | String | 学校 |
| Uzxfogb | String | 院 |
| Zwwivhh | String | 地址 |
| XfhLitzmrazgrlm | String | 组织 |
| XfhIvufmwXzhs | String | 现金退款 |
| XfhXfiivmgBvziZxxlfmg | String | 本年余额 |
| XfhKzhgBvziZxxlfmg | String | 历年余额 |
| XfhHvoukzbnvmgXzhsZwwfk | String | 自付现金总计 |
| XfhNvwrxzoRmhfizmxvUizgvimrgb | String | 医疗职业保险 |
| XfhIvxszitvXzhs | String | 充值现金 |
| XfhOzitvRmhfizmxv | String | 大额保险 |
| XfhHvoukzbnvmgZnlfmgZwwfk | String | 保险账户支付总计 |
| XfhIvxszitvXsvxp | String | 充值检查 |
| ivevihzo | String | 是否被冲红 |
| xozhhrubkzbnvmgZnlfmg | String | 分类自负 |
| hvouxlmxvrgvwZnlfmg | String | 个人自负 |
| zwwrgrlmzoUfmwKzb | String | 附加基金支付 |
| nvwrxzoGszgYzozmxv | String | 医保当年账户余额 |
| nvwrxzoLeviYzozmxv | String | 医保历年账户余额 |
| ufmwWqqaZnlfmg | String | 道路救助基金垫付 |
| ufmwWqqaZnlfmgRmul | String | 道路救助基金垫付信息 |
| xfhgln1 | String | 大病保险支付 |
| xfhgln2 | String | 其他保险支付 |
| xfhgln3 | String | 医疗救助支付 |
| xfhgln4 | String | 个人账户余额 |
| xfhgln5 | String | 支付方式：支付宝/现金/银联卡 |
| gvnkozgvGbkv | String | 显示模板规则 |
| xfhgln1 | String | 长期累计 |
| ldmKzbZnlfmgRmul | String | 个人现金支付明细 |
| RgvnMznv | String | 项目名称 |
| RgvnFmrg | String | 单位 |
| rgvnJfzmgrgb | String | 数量 |
| rgvnIvnzip | String | 备注 |
| rgvnZnlfmg | String | 价格 |
| glgzoZnlfmg | String | 金额 |
| rgvnHgw | String | 项目标准 |
| rgvnXlwv | String | 项目编码 |
| rgvnGbkv | String | 项目类型 |
| rgvnZnlfmgHvou | String | 项目自费 |
| RhhfvGrnv | String | 项目时间 |
| wzgz/RmelrxrmtKzigbMznv | String | 收款单位（开票单位） |
| wzgzb/KzbviKzigbMznv | String | 交款人 |
| wzgz/yrooMfnyvi | String | 票据号码 |
| wzgz/yrooXlwv | String | 票据代码 |
| wzgz/RhhfvWzgv | Date | 开票日期 |
| zfcRgvn/zfcRgvnMznv | String | 项目名称 |
| zfcRgvn/zfcRgvnFmrg | String | 单位 |
| zfcRgvn/zfcRgvnJfzmgrgb | String | 数量 |
| zfcRgvn/zfcRgvnIvnzip | String | 备注 |
| zfcRgvn/zfcRgvnZnlfmg | String | 价格 |
| zfcRgvn/zfcRgvnHgw | String | 标准 |
| wzgz/glgzoznlfmg | String | 金额 |
| zfcRgvn/zfcRgvnXlwv | String | 清单代码 |
| zfcRgvn/zfcRgvnIvozgvwXlwv | String | 清单对应项目代码 |
| zfcRgvn/zfcRgvnIvozgvwMznv | String | 清单对应项目名称 |
| zfcRgvnOrhg | String | 项目列表 |
| glgzoZnlfmgXm | String | 金额合计（大写） |
| rgvnOrhg | String | 项目清单 |
| IvxszitvZnlfmg | String | 补缴金额 |
| slhkrgzorazgrlmMfnyvi | String | 医院编号 |
浙江公路车辆通行费票据（电子）
| 字段名称 | 类型 | 说明 |
|---|---|---|
| currencyType | String | 币种 |
| eInvoiceCode | String | 票据代码 |
| payTime | String | 付款时间 |
| bizCode | String | 订单编号 |
| archiveFlag | String | 档案标志 |
| payWay | String | 收款方式 |
| checker | String | 复核人 |
| payerPartyCode | String | 交款人统一社会信用代码 |
| randomNumber | String | 校验码 |
| eInvoiceName | String | 票据名称 |
| totalAmount | String | 金额 |
| payerPartyName | String | 交款人 |
| handlingPerson | String | 收款人 |
| payWayName | String | 收款方式 |
| remark | String | 备注 |
| eInvoiceNumber | String | 票据号码 |
| makeDate | String | 开票日期 |
| itemQuantity | String | 数量 |
| itemCode | String | 项目编码 |
| itemUnit | String | 单位 |
| itemName | String | 项目名称 |
| itemStd | String | 标准 |
| itemAmount | String | 金额 |
| invoicingPartyName | String | 收款单位 |
| invoicingPartyCode | String | 收款方统一社会信用代码 |
| payerPartyPhone | String | 交款人电话 |
5、错误码
| 错误代码 | 错误信息 | 说明 |
|---|---|---|
| IllegalParameter | 参数不合法 | 请核对参数是否符合参数规范 |
| IllegalParameter.IllegalInvoiceCode | 请求参数不正确,参数fpdm发票代码不正确！ | 请核对fpdm发票代码是否符合参数规范 |
| IllegalParameter.IllegalInvoiceNumber | 请求参数不正确,参数fphm发票号码不正确！ | 请核对fphm发票号码是否符合参数规范 |
| IllegalParameter.IllegalBillingDate | 请求参数不正确,参数kprq开票日期不正确！ | 请核对kprq开票日期是否符合参数规范 |
| IllegalParameter.IllegalTotalAmount | 请求参数不正确,参数je金额不正确！ | 请核对je金额是否符合参数规范 |
| IllegalParameter.IllegalCheckCode | 请求参数不正确,参数jym校验码不正确 | 请核对jym校验码是否符合参数规范 |
| CheckInvoiceNotExistence | 查验成功所查发票不存在 | 发票代码或发票号码在税局查不到，请核对代码、号码是否正确 |
| CheckInvoiceNotStandard | 查询发票不规范 | 请核对四要素是否符合发票规范 |
| CheckInvoiceNotSame | 查验成功发票不⼀致 | 请检查四要素是否与真实票面一致，传入金额是否为不含税金额（非二手车）或该发票是否为假票 |
| CheckInvoiceMoreFiveTimes | 超过该张票当天查验次数 | 请确认在调用接口前是否已经通过官方平台查验超过5次 |
| CheckInvoiceException | 查验异常 | 税局服务异常，建议15-20分钟后重试 |
| CheckExceedingLimit | 查验发票张数超过限制 | 发票剩余查验量不足，请与运营负责人沟通确认 |
| CheckInvoiceNotSupport | 暂不支持该（省市）电子票据查验 | 该地区暂不支持该票种查验 |
| CheckAbnormal | 错误信息不固定 | 查验其他异常 |
| ServerError | 服务器异常，请稍后重试 | 服务器异常 |
| CheckInvoicesOverFiveYears | 超过五年的发票不能查验 | 请核对开票日期是否正确 |
| CheckInvoicesMoreThanToday | 开票日期超过当前日期 | 请核对开票日期是否正确 |
| CheckInvoiceForTheSameFrequent | 当前发票正在查验中,请稍后重试 | 当前发票正在查验中,请稍后重试 |
| CheckInvoicesOverOneYears | 仅可查验最近一年内开具的财政电子票据! | 请检查开票日期！ |
医疗票据获取版式文件【暂时下架】
1、接口描述
该接口用于医疗票据获取版式文件，以便核对药物清单。
2、接口地址
POST /v1/FP/cy HTTP/1.1
3、请求参数
- 参数说明
请求参数为 JSON 格式。
| 参数名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| customReqId | String | 否 | 传入的请求ID，用于标识一次调用，传入前先保存，需保证唯一性。 生成规则：AppKey+去掉横杠的UUID，示例：100019953790cccf01c45ce1b744e14ec46384eb |
| cyList | List | 是 | 医疗票据获取版式文件列表，必填 |
医疗票据获取版式文件-cyList说明
| 参数名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| ylpjFile | Boolean | 是 | 是否获取医疗票据版式文件，固定值true。 |
| fpdm | String | 是 | 票据代码，必填 |
| fphm | String | 是 | 票据号码，必填 |
| jym | String | 是 | 校验码，必填 |
| dq | String | 是 | 医疗票据版式文件支持地区代码，必填 |
- 示例参数（此参数仅为展示请求参数格式，请勿以此数据作为测试数据）
{
"cyList":[
{
"ylpjFile":true,
"fpdm":"44****01",
"fphm":"021****056",
"jym":"74**68",
"dq":"4400"
}
]
}
4、返回结果
- 返回结果
返回结果为JSON格式。
// 医疗票据获取版式文件成功返回结果
{
"result":{
"req_id":"9d7856e971ba4540aac8fdbd5b66a9c1",
"success":true,
"time":4390,
"timestamp":1640765643680
},
"value":[
{
"fpdm":"44****21", --发票代码
"data":{ --版式文件信息
"fileUrl":"https://qxy-oss-test.oss-cn-beijing.aliyuncs.com****.pdf", --文件下载url
"fileType":"PDF", --文件类型
"fileId":376936526225472 --文件id
},
"fplx":"101", --发票类型
"success":true, --获取版式文件是否成功，成功true，失败false
"fphm":"021****356", --发票号码
"jym":"74**68" --校验码
}
]
}
- 字段说明
| 字段名 | 说明 |
|---|---|
| data | 医疗票据版式文件相关字段 |
5、错误码
| 错误代码 | 错误信息 | 说明 |
|---|---|---|
| IllegalParameter | 参数不合法 | 请核对参数是否符合参数规范 |
| IllegalParameter.IllegalInvoiceCode | 请求参数不正确,参数fpdm发票代码不正确！ | 请核对fpdm发票代码是否符合参数规范 |
| IllegalParameter.IllegalInvoiceNumber | 请求参数不正确,参数fphm发票号码不正确！ | 请核对fphm发票号码是否符合参数规范 |
| IllegalParameter.IllegalCheckCode | 请求参数不正确,参数jym校验码不正确 | 请核对jym校验码是否符合参数规范 |
| IllegalParameter.IllegalArea | 请求参数不正确,参数dq地区不正确！ | 请核对dq地区是否符合参数规范 |
| CheckInvoiceNotExistence | 查验成功所查发票不存在 | 发票代码或发票号码在税局查不到，请核对代码、号码是否正确 |
| CheckInvoiceNotStandard | 查询发票不规范 | 请核对四要素是否符合发票规范 |
| CheckInvoiceNotSame | 查验成功发票不⼀致 | 请检查四要素是否与真实票面一致，传入金额是否为不含税金额（非二手车）或该发票是否为假票 |
| CheckInvoiceMoreFiveTimes | 超过该张票当天查验次数 | 请确认在调用接口前是否已经通过官方平台查验超过5次 |
| CheckInvoiceException | 查验异常 | 税局服务异常，建议15-20分钟后重试 |
| CheckExceedingLimit | 查验发票张数超过限制 | 发票剩余查验量不足，请与运营负责人沟通确认 |
| CheckInvoiceNotSupport | 暂不支持该（省市）电子票据查验 | 该地区暂不支持该票种查验 |
| CheckAbnormal | 错误信息不固定 | 查验其他异常 |
| ServerError | 服务器异常，请稍后重试 | 服务器异常 |
| CheckInvoicesOverFiveYears | 超过五年的发票不能查验 | 请核对开票日期是否正确 |
| CheckInvoicesMoreThanToday | 开票日期超过当前日期 | 请核对开票日期是否正确 |
| CheckInvoiceForTheSameFrequent | 当前发票正在查验中,请稍后重试 | 当前发票正在查验中,请稍后重试 |
| CheckInvoicesOverOneYears | 仅可查验最近一年内开具的财政电子票据! | 请检查开票日期！ |
财政票据查验增强版
1、接口描述
该接口用于财政票据查验及获取版式文件（版式文件仅限医疗票据获取）
2、接口地址
POST /v1/FP/czpjcy HTTP/1.1
3、请求参数
- 参数说明
请求参数为 JSON 格式。
| 参数名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| customReqId | String | 否 | 传入的请求ID，用于标识一次调用，传入前先保存，需保证唯一性。 生成规则：AppKey+去掉横杠的UUID，示例：100019953790cccf01c45ce1b744e14ec46384eb |
| cyList | List | 是 | 财政票据增强版查验列表，必填 |
cyList说明
| 参数名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| dq | String | 是 | 版式文件支持地区代码，必填 |
| fpdm | String | 是 | 票据代码，必填 |
| fphm | String | 是 | 票据号码，必填 |
| kprq | String | 是 | 开票日期，必填，格式 yyyy-MM-dd / yyyyMMdd |
| je | String | 是 | 金额，必填 |
| jym | String | 是 | 校验码，必填 |
- 示例参数（此参数仅为展示请求参数格式，请勿以此数据作为测试数据）
// 财政票据查验增强版请求参数（单张）
{
"cyList": [
{
"dq":"4500",
"fpdm":"45****01",
"fphm":"004****234",
"kprq":"20210925",
"je":123.94,
"jym":"f0**9c"
}
]
}
// 财政票据查验增强版请求参数（多张）
{
"cyList": [
{
"dq":"4500",
"fpdm":"45****01",
"fphm":"004****234",
"kprq":"20210925",
"je":123.94,
"jym":"f0**9c"
},
{
"dq":"4500",
"fpdm":"45****01",
"fphm":"004****234",
"kprq":"20210925",
"je":123.94,
"jym":"f0**9c"
}
]
}
4、返回结果
- 返回结果（此结果仅为一个省份的医疗票据返回结果，不代表所有省份）
返回结果为JSON格式。
// 财政票据查验增强版查验成功返回结果
{
"result":{
"req_id":"95a9f9b854bf4a3aa538d0512d3d5d1d",
"success":true,
"time":5119,
"timestamp":1651060703749
},
"value":[
{
"fpdm":"31****21", --票据代码
"data":{ --财政票据查验增强版查验结果数据
"file":{ --版式文件获取结果数据
"fileUrl":"https://qxy***/****.png", --版式文件URL
"fileType":"PNG", --版式文件类型
"fileId":"398020808990912" --版式文件id
},
"cyResult":{ --财政票据查验结果数据
"yraXlwv":"mz20211****9150236", --业务流水号
"rmelrxrmtKzigbXlwv":"011**036", --开票单位代码
"hfkvierhliHvzoSzhs":"", --财政部门印章
"izmwlnMfnyvi":"f7**bb", --校验码
"xozhhrubkzbnvmgZnlfmg":"0.00", --分类自负
"kzbviLkYp":"", --交款人开户行
"nvwrxzoLeviYzozmxv":"0.00", --医保历年账户余额
"ivxLkYp":"", --收款人开户行
"hvoukzbnvmgXlhg":"18.00", --个人自费
"xzhvmfnyvi":"", --病历号
"rgvnOrhg":[
{
"rgvnHgw":"18.00", --收费清单项目标准
"rgvnJfzmgrgb":"1", --收费清单项目数量
"rgvnMznv":"诊察费", --收费清单项目名称
"rgvnIvnzip":"", --收费清单项目备注
"rgvnFmrg":"元", --收费清单项目单位
"rgvnXlwv":"PA0102", --收费清单项目编码
"rgvnWvgzroMznv":"", --项目详细名称
"rgvnZnlfmg":"18.00" --收费清单项目金额
}
],
"hfkvierhliHvzoMznv":"", --财务部门印章
"hgfwvmgRW":"", --学号
"hfkvierhliZivzXlwv":"310115", --财政部门编码(非空）
"kzbviKzigbMznv":"刘**", --交款人
"yfhrmvhhMfnyvi":"", --业务流水号
"nvwrxzoRmhfizmxvGbkv":"自费", --医保类型
"xfiivmxbGbkv":"", --货币种类
"xozhhvh":"", --级别
"hfkvierhliIvnzip":"", --财务部门备注
"rmelrxrmtKzigbMznv":"上海市***区**医院", --收款单位（开票单位）
"slhkrgzorazgrlmMfnyvi":"", --住院号
"hvouxlmxvrgvwZnlfmg":"0.00", --个人自负
"zxxlfmgKzbZnlfmg":"0.00", --个人账户支付
"nvwrxzoRmhfizmxvRW":"", --医保编号
"yfhrmvhhWzgv":"", --业务日期
"rmelrxrmtHvzoRw":"8ddd0c901f0f4bad9041a92e98a9f7ef", --开票单位印章编号
"vcxszmtvIzgv":"", --汇率
"ivevihzo":false, --是否被冲红
"ivxZxxg":"", --收款人账号
"rmSlhkrgzoWzgv":"", --住院日期
"kzbXlwv":"", --缴款码
"zwwivhh":"", --地址
"hvoukzbnvmgZnlfmg":"0.00", --个人自付
"ufmwKzbZnlfmg":"0.00", --医保统筹基金支付
"lfgSlhkrgzoWzgv":"", --出院日期
"lgsviKzbZnlfmg":"0.00", --其他支付
"kzgrvmgMfnyvi":"144616****47458", --门诊号
"rhhfvWzgv":"1637596800000", --开票日期
"ivufmwZnlfmg":"", --退费金额
"vRmelrxvMfnyvi":"128****006", --票据号码
"kzbviKzigbXlwv":"410922******045810", --交款人统一社会信用代码
"nvwrxzoWzgv":"1637596800000", --就诊日期
"kzbviZxxg":"", --交款人账号
"ivxMznv":"", --收款人全称
"zfcRgvnOrhg":[
{
"zfcRgvnJfzmgrgb":"1.00", --收费项目数量
"zfcRgvnMznv":"(诊查费)", --收费项目名称
"zfcRgvnIvnzip":"自费", --收费项目备注
"zfcRgvnIvozgvwXlwv":"", --对应项目编码
"zfcRgvnFmrg":"", --收费项目单位
"zfcRgvnIvozgvwMznv":"", --对应项目名称
"zfcRgvnHgw":"3.0000", --收费项目标准
"zfcRgvnZnlfmg":"3.0000", --收费项目金额
"zfcRgvnXlwv":"PA0102" --收费项目编码
},
{
"zfcRgvnJfzmgrgb":"1.00", --收费项目数量
"zfcRgvnMznv":"(诊查费)", --收费项目名称
"zfcRgvnIvnzip":"自费", --收费项目备注
"zfcRgvnIvozgvwXlwv":"", --对应项目编码
"zfcRgvnFmrg":"", --收费项目单位
"zfcRgvnIvozgvwMznv":"", --对应项目名称
"zfcRgvnHgw":"15.0000", --收费项目标准
"zfcRgvnZnlfmg":"15.0000", --收费项目金额
"zfcRgvnXlwv":"PA0102" --收费项目编码
}
],
"zwwrgrlmzoUfmwKzb":"0.00", --附加基金支付
"vRmelrxvMznv":"上海市医疗门诊收费票据（电子）", --电子票据名称
"nvwrxzoGbkv":"", --医学类型
"vRmelrxvHkvxrnvmXlwv":"310****101", --电子票据模板代码
"rmelrxrmtHvzoSzhs":"", --开票单位印章
"nvwrxzoGszgYzozmxv":"0.00", --医保当年账户余额
"hfkvierhliHvzoRw":"8ddd0c901f0f4bad9041a92e98a9f7ef", --财政部门印章编号
"uzxfogb":"", --院
"hxsllo":"", --学校
"kzbNlwv":"", --交款方式
"xsvxpvi":"系统核验", --复核人
"ldmKzbZnlfmg":"18.00", --个人现金支付
"gvnkozgvGbkv":"02", --显示模板规则
"rmelrxrmtHvzoMznv":"", --开票单位印章名称
"kivkzbZnlfmg":"", --预付款
"ivxszitvZnlfmg":"", --充值金额
"ivozgvwRmelrxvMfnyvi":"", --相关票据号码（预留扩展字段，开具红票时在此写）
"slhkrgzoWzb":"", --住院天数
"litGbkv":"综合医院", --医疗机构类型
"vRmelrxvXlwv":"31****21", --票据代码
"ivozgvwRmelrxvXlwv":"", --相关票据代码（预留扩展字段，开具红票时在此写）
"szmwormtKvihlm":"9915", --开票人
"kzbviKzigbGbkv":"1", --交款人类型
"wvkzignvmgMznv":"", --住院科别
"tvmwvi":"男", --性别
"vcxszmtvKzkvi":"false",
"ztv":"", --年龄
"glgzoZnlfmg":"18.00", --金额
"rhhfvGrnv":"14:40:57", --项目时间
"ivnzip":"财政部全国财政电子票据查验平台: http://pjcy.mof.gov.cn/； ；[微信]:18.00" --备注
}
},
"fplx":"101", --发票类型
"kprq":"2021-11-23 00:00:00", --开票日期
"success":true, --查验是否成功的标识，true成功，false失败
"je":18, --金额
"fphm":"1289****06", --票据号码
"jym":"f739bb" --校验码
}
]
}
//浙江省公路车辆通行费票据（电子）查验成功返回结果示例
{
"result":{
"req_id":"6d61b3b36f3448c7ba15277dd027b3ce",
"success":true,
"time":754,
"timestamp":1651061050345
},
"value":[
{
"fpdm":"33****22",
"data":{
"file":{ --版式文件获取结果数据
"fileUrl": null,
"fileType": null,
"fileId": null
},
"cyResult":{ --财政票据查验结果数据
"currencyType":"RMB", --币种
"eInvoiceCode":"33****22", --票据代码
"payTime":"0",
"bizCode":"202203108d4d46788705df90af*******", --订单编号
"archiveFlag":"0",
"synNumberPrint":0,
"payWay":"PAY_WX", --收款方式
"checker":"彭**", --复核人
"accessId":"0b51eab5afd74e16ae1eed69d66c58aa",
"invoicingPartyCode":"91330200062940137U",
"payerPartyCode":"9133*********17XY", --交款人统一社会信用代码
"enteguid":"510000007178",
"exchangeRate":1,
"regicode":"330000",
"randomNumber":"V1WW87", --校验码
"id":28863949,
"zfbSync":-1,
"printDate":0,
"eInvoiceName":"浙江省公路车辆通行费票据（电子）", --票据名称
"invoicingPdfOssKey":"V1WW87/pdf/33****22_220****974_AIS.pdf",
"xmlOssKey":"V1WW87/xml/33****22_220****974_A",
"totalAmount":31, --金额
"makeTime":"123423",
"payerPartyName":"宁波市****有限公司", --交款人
"handlingPerson":"彭**", --收款人
"einvoiceStatus":"1",
"payWayName":"微信", --收款方式
"issueTime":"123423",
"errorDate":0,
"remark":"含合并收费：0.00元\n车牌号：豫NY****（蓝色）\n车型：客1\n出入口：浙江宁波西站-浙江马渚站\n通行日期：2022-03-10 11:53 - 2022-03-10 12:33\n", --备注
"archiveId":0,
"uid":"826e39d48ada4354861fd2efd4a5d8e9",
"errorTime":"0",
"eInvoiceNumber":"220****974", --票据号码
"issueDate":20220310,
"makeDate":20220310, --开票日期
"invoicingXmlOssKey":"V1WW87/xml/33****22_220****974_AI",
"classCode":"330210",
"tradeDate":"20220310",
"billDetailList":[
{
"itemName":"车辆通行费", --项目名称
"itemStd":31, --标准
"itemStdStr":"31.00",
"itemQuantity":1, --数量
"itemAmount":31, --金额
"itemCode":"50012424", --项目编码
"itemUnit":"元", --单位
"billId":28863949,
"itemQuantityStr":"1",
"id":30370566,
"itemAmountStr":"31.00"
}
],
"supervisorXmlOssKey":"V1WW87/xml/33****22_220****974_AIS",
"invoicingPartyName":"宁波**高速公路有限公司", --收款单位
"payerPartyType":"2",
"xmlVersion":1,
"printTime":"0",
"payDate":0,
"synFlagPrint":"0"
}
},
"fplx":"101",
"kprq":"2022-03-07 00:00:00",
"success":true,
"je":75,
"fphm":"342****302",
"jym":"GBV8F6"
}
]
}
// 财政票据查验增强版查验失败情况
{
"result":{
"req_id":"b7c7febe42f54b49a8e3ccfd679aac6a",
"success":true,
"time":2576,
"timestamp":1635767997850
},
"value":[
{
"fpdm":"45****21", --发票代码
"code":"IllegalParameter", --错误码
"xzpj":true, --是否是财政票据
"message":"票据金额不能为空", --错误信息
"kprq":"2021-09-07 00:00:00", --开票日期
"success":false, --查验是否成功状态，成功true，失败false
"fphm":"005****663", --发票号码
"jym":"3a**27" --校验码
}
]
}
- 字段说明
| 字段名称 | 类型 | 说明 |
|---|---|---|
| data | Object | 财政票据信息相关字段 |
| rmelrxrmtKzigbMznv | String | 收款单位（开票单位） |
| xsvxpvi | String | 复核人 |
| szmwormtKvihlm | String | 开票人 |
| nvwrxzoWzgv | Date | 就诊日期 |
| nvwrxzoRmhfizmxvRW | String | 医保编号 |
| nvwrxzoRmhfizmxvGbkv | String | 医保类型 |
| lgsviKzbZnlfmg | String | 其他支付 |
| kzgrvmgMfnyvi | String | 门诊号 |
| litGbkv | String | 医疗机构类型 |
| hvoukzbnvmgXlhg | String | 个人自费 |
| yraXlwv | String | 业务流水号 |
| zxxlfmgKzbZnlfmg | String | 个人账户支付 |
| hvoukzbnvmgZnlfmg | String | 个人自付 |
| tvmwvi | String | 性别 |
| ldmKzbZnlfmg | String | 个人现金支付 |
| ufmwKzbZnlfmg | String | 医保统筹基金支付 |
| kzbviKzigbMznv | String | 交款人 |
| kzbviKzigbXlwv | String | 交款人统一社会信用代码 |
| vRmelrxvMfnyvi | String | 票据号码 |
| vRmelrxvXlwv | String | 票据代码 |
| izmwlnMfnyvi | String | 校验码 |
| vRmelrxvMznv | String | 电子票据名称 |
| rhhfvWzgv | Date | 开票日期 |
| rmelrxrmtHvzoMznv | String | 开票单位印章名称 |
| rmelrxrmtHvzoSzhs | String | 开票单位印章 |
| rmelrxrmtHvzoRw | String | 开票单位印章编号 |
| hfkvierhliHvzoMznv | String | 财务部门印章 |
| hfkvierhliHvzoSzhs | String | 财政部门印章 |
| hfkvierhliHvzoRw | String | 财政部门印章编号 |
| hvouKzbnvmgXziv | String | 个人承担/个人自理 |
| rmwrerwfzoZxxlfmgXfiiKzbnvmg | String | 本年支付 |
| rmwrerwfzoZxxlfmgKiveKzbnvmg | String | 历年支付 |
| rmwrerwfzoZxxlfmgXfiiYzozmxv | String | 本年余额 |
| rmwrerwfzoZxxlfmgKiveYzozmxv | String | 历年余额 |
| xzhvmfnyvi | String | 病历号 |
| zfcRgvnivozgvwmznv | String | 对应项目名称 |
| zfcRgvnivozgvwxlwv | String | 对应项目编码 |
| zfcRgvnznlfmg | String | 收费项目金额 |
| zfcRgvnfmrg | String | 收费项目单位 |
| zfcRgvnjfzmgrgb | String | 收费项目数量 |
| zfcRgvnxlwv | String | 收费项目编码 |
| zfcRgvnhgw | String | 收费项目标准 |
| zfcRgvnivnzip | String | 收费项目备注 |
| zfcRgvnmznv | String | 收费项目名称 |
| hfkvierhliZivzXlwv | String | 财政部门编码(非空） |
| lfgSlhkrgzoWzgv | String | 出院日期 |
| ivozgvwRmelrxvXlwv | String | 相关票据代码（预留扩展字段，开具红票时在此写） |
| ivozgvwRmelrxvMfnyvi | String | 相关票据号码（预留扩展字段，开具红票时在此写） |
| wvkzignvmgMznv | String | 住院科别 |
| ivufmwZnlfmg | String | 退费金额 |
| yfhrmvhhMfnyvi | String | 业务单号 |
| yfhrmvhhWzgv | String | 业务日期 |
| kzbXlwv | String | 缴款码 |
| rmSlhkrgzoWzgv | String | 住院日期 |
| ivxszitvZnlfmg | String | 充值金额 |
| kzbviZxxg | String | 交款人账号 |
| kzbviLkYp | String | 交款人开户行 |
| kzbviKzigbGbkv | String | 交款人类型 |
| vcxszmtvIzgv | String | 汇率 |
| vRmelrxvHkvxrnvmXlwv | String | 电子票据模板代码 |
| kzbNlwv | String | 交款方式 |
| rmelrxrmtKzigbXlwv | String | 开票单位代码 |
| ivxLkYp | String | 收款人开户行 |
| ivxMznv | String | 收款人全称 |
| ivxZxxg | String | 收款人账号 |
| vRmelrxvXlwv | String | 电子票据代码 |
| ivnzip | String | 备注 |
| xfiivmxbGbkv | String | 货币种类 |
| hfkvierhliIvnzip | String | 财务部门备注 |
| ztv | String | 年龄 |
| nvwrxzoGbkv | String | 医学类型 |
| ufmwKzbZnlfmgRmul | String | 医保统筹基金支付信息 |
| lgsviKzbZnlfmgRmul | String | 其他支付信息 |
| kzgrvmgXlnkzmb | String | 患者单位 |
| kslmvMfnyvi | String | 手机号码 |
| kivkzbZnlfmg | String | 预付款 |
| ivtrXlwv | String | 区域注册码 |
| kirmgWzgv | String | 打印日期 |
| kirmgGrnv | String | 打印时间 |
| kirmgvw | String | 打印 |
| vmgviTfrw | String | 进入标识 |
| elrwvw | String | 冲红 |
| elrwWzgv | String | 冲红日期 |
| elrwGrnv | String | 冲红时间 |
| elrwIvzhlm | String | 冲红原因 |
| yllpRw | String | 订阅RW |
| zxxvhhRw | String | 数据库RW |
| xivzgvGrnv | String | 创建时间 |
| fkwzgvGrnv | String | 最后更新时间 |
| vRmelrxvHgzgfh | String | 电子状态 |
| rgvnZnlfmgKvixvmg | String | 金额百分比 |
| kirmgXlwv | String | 打印代码 |
| kirmgMfnyvi | String | 打印编码 |
| Xozhhvh | String | 级别 |
| SlhkrgzorazgrlmMfnyvi | String | 住院号 |
| HgfwvmgRW | String | 学号 |
| Hxsllo | String | 学校 |
| Uzxfogb | String | 院 |
| Zwwivhh | String | 地址 |
| XfhLitzmrazgrlm | String | 组织 |
| XfhIvufmwXzhs | String | 现金退款 |
| XfhXfiivmgBvziZxxlfmg | String | 本年余额 |
| XfhKzhgBvziZxxlfmg | String | 历年余额 |
| XfhHvoukzbnvmgXzhsZwwfk | String | 自付现金总计 |
| XfhNvwrxzoRmhfizmxvUizgvimrgb | String | 医疗职业保险 |
| XfhIvxszitvXzhs | String | 充值现金 |
| XfhOzitvRmhfizmxv | String | 大额保险 |
| XfhHvoukzbnvmgZnlfmgZwwfk | String | 保险账户支付总计 |
| XfhIvxszitvXsvxp | String | 充值检查 |
| ivevihzo | String | 是否被冲红 |
| xozhhrubkzbnvmgZnlfmg | String | 分类自负 |
| hvouxlmxvrgvwZnlfmg | String | 个人自负 |
| zwwrgrlmzoUfmwKzb | String | 附加基金支付 |
| nvwrxzoGszgYzozmxv | String | 医保当年账户余额 |
| nvwrxzoLeviYzozmxv | String | 医保历年账户余额 |
| ufmwWqqaZnlfmg | String | 道路救助基金垫付 |
| ufmwWqqaZnlfmgRmul | String | 道路救助基金垫付信息 |
| xfhgln1 | String | 大病保险支付 |
| xfhgln2 | String | 其他保险支付 |
| xfhgln3 | String | 医疗救助支付 |
| xfhgln4 | String | 个人账户余额 |
| xfhgln5 | String | 支付方式：支付宝/现金/银联卡 |
| gvnkozgvGbkv | String | 显示模板规则 |
| xfhgln1 | String | 长期累计 |
| ldmKzbZnlfmgRmul | String | 个人现金支付明细 |
| RgvnMznv | String | 项目名称 |
| RgvnFmrg | String | 单位 |
| rgvnJfzmgrgb | String | 数量 |
| rgvnIvnzip | String | 备注 |
| rgvnZnlfmg | String | 价格 |
| glgzoZnlfmg | String | 金额 |
| rgvnHgw | String | 项目标准 |
| rgvnXlwv | String | 项目编码 |
| rgvnGbkv | String | 项目类型 |
| rgvnZnlfmgHvou | String | 项目自费 |
| RhhfvGrnv | String | 项目时间 |
| wzgz/RmelrxrmtKzigbMznv | String | 收款单位（开票单位） |
| wzgzb/KzbviKzigbMznv | String | 交款人 |
| wzgz/yrooMfnyvi | String | 票据号码 |
| wzgz/yrooXlwv | String | 票据代码 |
| wzgz/RhhfvWzgv | Date | 开票日期 |
| zfcRgvn/zfcRgvnMznv | String | 项目名称 |
| zfcRgvn/zfcRgvnFmrg | String | 单位 |
| zfcRgvn/zfcRgvnJfzmgrgb | String | 数量 |
| zfcRgvn/zfcRgvnIvnzip | String | 备注 |
| zfcRgvn/zfcRgvnZnlfmg | String | 价格 |
| zfcRgvn/zfcRgvnHgw | String | 标准 |
| wzgz/glgzoznlfmg | String | 金额 |
| zfcRgvn/zfcRgvnXlwv | String | 清单代码 |
| zfcRgvn/zfcRgvnIvozgvwXlwv | String | 清单对应项目代码 |
| zfcRgvn/zfcRgvnIvozgvwMznv | String | 清单对应项目名称 |
| zfcRgvnOrhg | String | 项目列表 |
| glgzoZnlfmgXm | String | 金额合计（大写） |
| rgvnOrhg | String | 项目清单 |
| IvxszitvZnlfmg | String | 补缴金额 |
| slhkrgzorazgrlmMfnyvi | String | 医院编号 |
浙江公路车辆通行费票据（电子）
| 字段名称 | 类型 | 说明 |
|---|---|---|
| currencyType | String | 币种 |
| eInvoiceCode | String | 票据代码 |
| payTime | String | 付款时间 |
| bizCode | String | 订单编号 |
| archiveFlag | String | 档案标志 |
| payWay | String | 收款方式 |
| checker | String | 复核人 |
| payerPartyCode | String | 交款人统一社会信用代码 |
| randomNumber | String | 校验码 |
| eInvoiceName | String | 票据名称 |
| totalAmount | String | 金额 |
| payerPartyName | String | 交款人 |
| handlingPerson | String | 收款人 |
| payWayName | String | 收款方式 |
| remark | String | 备注 |
| eInvoiceNumber | String | 票据号码 |
| makeDate | String | 开票日期 |
| itemQuantity | String | 数量 |
| itemCode | String | 项目编码 |
| itemUnit | String | 单位 |
| itemName | String | 项目名称 |
| itemStd | String | 标准 |
| itemAmount | String | 金额 |
| invoicingPartyName | String | 收款单位 |
| invoicingPartyCode | String | 收款方统一社会信用代码 |
| payerPartyPhone | String | 交款人电话 |
5、错误码
| 错误代码 | 错误信息 | 说明 |
|---|---|---|
| IllegalParameter | 参数不合法 | 请核对参数是否符合参数规范 |
| IllegalParameter.IllegalArea | 请求参数不正确,参数dq地区不正确！ | 请核对dq地区是否符合参数规范 |
| IllegalParameter.IllegalInvoiceCode | 请求参数不正确,参数fpdm发票代码不正确！ | 请核对fpdm发票代码是否符合参数规范 |
| IllegalParameter.IllegalInvoiceNumber | 请求参数不正确,参数fphm发票号码不正确！ | 请核对fphm发票号码是否符合参数规范 |
| IllegalParameter.IllegalBillingDate | 请求参数不正确,参数kprq开票日期不正确！ | 请核对kprq开票日期是否符合参数规范 |
| IllegalParameter.IllegalTotalAmount | 请求参数不正确,参数je金额不正确！ | 请核对je金额是否符合参数规范 |
| IllegalParameter.IllegalCheckCode | 请求参数不正确,参数jym校验码不正确 | 请核对jym校验码是否符合参数规范 |
| CheckInvoiceNotExistence | 查验成功所查发票不存在 | 发票代码或发票号码在税局查不到，请核对代码、号码是否正确 |
| CheckInvoiceNotStandard | 查询发票不规范 | 请核对四要素是否符合发票规范 |
| CheckInvoiceNotSame | 查验成功发票不⼀致 | 请检查四要素是否与真实票面一致，传入金额是否为不含税金额（非二手车）或该发票是否为假票 |
| CheckInvoiceMoreFiveTimes | 超过该张票当天查验次数 | 请确认在调用接口前是否已经通过官方平台查验超过5次 |
| CheckInvoiceException | 查验异常 | 税局服务异常，建议15-20分钟后重试 |
| CheckExceedingLimit | 查验发票张数超过限制 | 发票剩余查验量不足，请与运营负责人沟通确认 |
| CheckInvoiceNotSupport | 暂不支持该（省市）电子票据查验 | 该地区暂不支持该票种查验 |
| CheckAbnormal | 错误信息不固定 | 查验其他异常 |
| ServerError | 服务器异常，请稍后重试 | 服务器异常 |
| CheckInvoicesOverFiveYears | 超过五年的发票不能查验 | 请核对开票日期是否正确 |
| CheckInvoicesMoreThanToday | 开票日期超过当前日期 | 请核对开票日期是否正确 |
| CheckInvoiceForTheSameFrequent | 当前发票正在查验中,请稍后重试 | 当前发票正在查验中,请稍后重试 |
| CheckInvoicesOverOneYears | 仅可查验最近一年内开具的财政电子票据! | 请检查开票日期！ |
财政票据查验【新】
1、接口描述
该接口用于财政票据查验，与财政票据官网保持一致，可查验最近一年内开具的电子票据。本接口仅支持单张财政票据查验。
2、接口地址
POST /v1/FP/czpjCy HTTP/1.1
3、请求参数
- 参数说明
请求参数为 JSON 格式。
| 参数名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| customReqId | String | 否 | 传入的请求ID，用于标识一次调用，传入前先保存，需保证唯一性。 生成规则：AppKey+去掉横杠的UUID，示例：100019953790cccf01c45ce1b744e14ec46384eb |
| cyList | List | 是 | 财政票据查验列表，必填 |
cyList说明
| 参数名称 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| fpdm | String | 是 | 票据代码，必填 |
| fphm | String | 是 | 票据号码，必填 |
| kprq | String | 是 | 开票日期，必填，格式 yyyy-MM-dd / yyyyMMdd |
| je | String | 是 | 金额，必填 |
| jym | String | 是 | 校验码，必填 |
- 示例参数（此参数仅为展示请求参数格式，请勿以此数据作为测试数据）
// 财政票据查验请求参数（单张）
{
"cyList": [
{
"fpdm":"45****01",
"fphm":"004****234",
"kprq":"20210925",
"je":123.94,
"jym":"f0**9c"
}
]
}
4、返回结果
- 返回结果（结果返回除其他信息List里的个数不固定外，其余字段均固定）
返回结果为JSON格式。
// 财政票据查验成功返回结果
{
"result": {
"success": true,
"req_id": "1b2e63a62e3e410ab3f8d51a788cf4f3",
"timestamp": 1684208408043,
"time": 2682
},
"value": [
{
"fplx": "101", --发票类型
"fpdm": "32****22", --发票代码
"fphm": "00******63", --发票号码
"kprq": "2022-05-26 00:00:00", --开票日期
"je": 2235.33, --金额
"jym": "53**96", --校验码
"success": true, --查验是否成功
"time": "2023-05-16 11:29:33", --查验时间
"times": 0, --查验次数
"data": {
"fpdm": "32****22", --发票代码
"fphm": "00******63", --发票号码
"jkrnsrsbh": "**************0010", --缴款人纳税识别号
"jym": "530996", --校验码
"jkr": "许**", --缴款人
"kprq": "2022-05-26", --开票日期
"skdw": "苏州******医院", --收款单位
"fhr": "01072", --复核人
"skr": "80139", --收款人
"pjmc": "江苏省医疗住院收费票据（电子）", --票据名称
"jehj": "2235.33", --金额合计
"jehjcn": "贰仟贰佰叁拾伍元叁角叁分", --金额合计中文大写
"ch": "01", --冲红标志 01正常，02冲红
"chrq": "", --冲红日期
"chsj": "", --冲红时间
"chyy": "", --冲红原因
"czbmyz": "", --财政部门印章
"czbmyzbh": "", --财政部门印章编号
"xmqd": [
{
"xmxh": 0, --项目序号
"xmbh": "", --项目编号
"xmmc": "床位费", --项目名称
"dw": "", --单位
"sl": "", --数量
"ggbz": "", --规格标准
"je": null, --金额
"bz": "" --备注
}
], --项目清单
"xmmx": [],
"qtxx": [ --其他信息
{
"en": "ywlsh",
"cn": "业务流水号",
"value": "10****47"
}
],
"detailUrl": "http://einvoice.jsczt.cn/finance/callback/32****22/00******63/530996/1653494400000/2235.33/013236272acb1f25445fb926e09cae1fe9fd/13/1684207775043/131f7321cd42f3383bbd934c9dbc519d521e3d95175822478e99ee1fd8388c6c" --税局查验截图url
}
}
]
}
//已打印发票查验成功返回示例
{
"result": {
"req_id": "a8baabf140754f1bb8ba97143a5d2489",
"success": true,
"time": 1798,
"timestamp": 1688003391859
},
"value": [
{
"times": 0, --查验次数
"fpdm": "50****21", --发票代码
"data": { --查验成功返回数据
"fpdm": "50****21", --发票代码
"jkrnsrsbh": "51***************43", --缴款人纳税识别号
"pjmc": "**市医疗住院收费票据", --票据名称
"ch": "01", --是否冲红：01正常 02已红冲
"rz": "", --是否入账: 01未入账 02 已入账
"jehjcn": "壹仟贰佰肆拾叁圆壹角捌分", --价税合计中文大写
"czbmyzbh": "8a3cb1dd060646778a177323993a6759", --财政部门印章编号
"chrq": "", --冲红日期
"chyy": "", --冲红原因
"jehj": "1243.18", --金额合计
"jkr": "胡*莲", --缴款人
"xmqd": [ --项目清单
{
"xmbh": "999090208", --项目编号
"xmmc": "卫生材料费", --项目名称
"dw": "片", --单位
"ggbz": "38.80", --规格标准
"bz": "", --备注
"sl": "1", --数量
"je": "38.80", --金额
"xmxh": 0 --项目序号
}
],
"fhr": "505431", --复核人
"chsj": "", --冲红时间
"dy": "02", --是否打印 : 01未打印 02已打印
"kprq": "20221205", --开票日期
"czbmyz": "", --财政部门印章
"qtxx": [ --其他信息
{
"en": "ywlsh", --字段英文名称
"cn": "业务流水号", --字段中文名称
"value": "4307201" --字段值
}
],
"xmmx": [], --项目明细
"skr": "505431", --收款人
"detailUrl": "https://pjcy.mof.gov.cn/ACyCy7Kv/thirdcheck/html/thirdDetail.html?app_id%3D0150e66f744732934187973724b6dfd30550%26einvoice_code%3D50****21%26einvoice_number%3D00******20%26random_number%3D95**7a%26total_amount%3D1243.18%26date%3D20221205%26hmac%3D33E11507E1D5001B1EAF2ED90653D639", --税局查验截图url
"skdw": "重庆大学附属肿瘤医院", --收款单位
"fphm": "00******20", --发票号码
"jym": "95**7a" --校验码
},
"fplx": "101", --发票类型
"kprq": "2022-12-05 00:00:00", --开票日期
"success": true, --查验是否成功，true成功，false失败
"je": 1243.18, --金额
"time": "2023-06-29 09:49:50", --查验时间
"fphm": "00******20", --发票号码
"jym": "95**7a" --校验码
}
]
}
//已冲红发票查验成功示例
{
"result":{
"req_id":"9835d4b8b85d44e68c793818cb27031e",
"success":true,
"time":15542,
"timestamp":1688003364243
},
"value":[
{
"times":0,
"fpdm":"31****23",
"data":{
"fpdm":"31****23",
"jkrnsrsbh":"31***************11",
"pjmc":"**市医疗门诊收费票据（电子）",
"ch":"02",
"rz":"",
"jehjcn":"肆佰柒拾叁圆整",
"czbmyzbh":"2f5be7fa304c411b913c00c0dbfb34c7",
"chrq":"",
"chyy":"",
"jehj":"473.00",
"jkr":"王*云",
"xmqd":[
{
"xmbh":"PA0103",
"xmmc":"检查费",
"dw":"元",
"ggbz":"248.00",
"bz":"",
"sl":"1.00",
"je":"248.00",
"xmxh":0
},
{
"xmbh":"PA0104",
"xmmc":"化验费",
"dw":"元",
"ggbz":"225.00",
"bz":"",
"sl":"1.00",
"je":"225.00",
"xmxh":1
}
],
"fhr":"系统核验",
"chsj":"",
"dy":"01",
"kprq":"20230219",
"czbmyz":"",
"qtxx":[
{
"en":"ywlsh",
"cn":"业务流水号",
"value":"C0_19098080"
},
{
"en":"mzh",
"cn":"门诊号",
"value":"19098080"
},
{
"en":"jzrq",
"cn":"就诊日期",
"value":"20230219"
},
{
"en":"yljglx",
"cn":"医疗机构类型",
"value":"专科医院"
},
{
"en":"yblx",
"cn":"医保类型",
"value":"职保"
},
{
"en":"ybbh",
"cn":"医保编号",
"value":"U00658150"
},
{
"en":"xb",
"cn":"性别",
"value":"男"
},
{
"en":"ybtcjjzf",
"cn":"医保统筹基金支付",
"value":"0.00"
},
{
"en":"qtzf",
"cn":"其他支付",
"value":"0.00"
},
{
"en":"grzhzf",
"cn":"个人账户支付",
"value":"473.00"
},
{
"en":"grxjzf",
"cn":"个人现金支付",
"value":"0.00"
},
{
"en":"grzf",
"cn":"个人自付",
"value":"0.00"
},
{
"en":"grzfe",
"cn":"个人自费",
"value":"0.00"
},
{
"en":"fjjjzf",
"cn":"附加基金支付",
"value":"0.00"
},
{
"en":"flzf",
"cn":"分类自负",
"value":"0.00"
},
{
"en":"grzfu",
"cn":"个人自负",
"value":"0.00"
},
{
"en":"ybdnzhye",
"cn":"医保当年账户余额",
"value":"1715.56"
},
{
"en":"yblnzhye",
"cn":"医保历年账户余额",
"value":"21772.91"
},
{
"en":"bz",
"cn":"备注",
"value":"财政部全国财政电子票据查验平台http://pjcy.mof.gov.cn/;个人账户支付中包含共济账户支付:0.00医保流水号:315739807"
}
],
"xmmx":[
{
"xmbh":"S31040100200010",
"xmmc":"纯音听阈测定",
"dw":"耳",
"ggbz":"18.0000",
"bz":"0.00;0.00",
"sl":"2.00",
"je":"36.0000",
"xmxh":0
},
{
"xmbh":"S31040101000020",
"xmmc":"声导抗测听(鼓室图)",
"dw":"次",
"ggbz":"46.0000",
"bz":"0.00;0.00",
"sl":"1.00",
"je":"46.0000",
"xmxh":1
},
{
"xmbh":"S31040101000030",
"xmmc":"声导抗测听(镫骨肌反射试验)",
"dw":"次",
"ggbz":"46.0000",
"bz":"0.00;0.00",
"sl":"1.00",
"je":"46.0000",
"xmxh":2
},
{
"xmbh":"S310401015a0010",
"xmmc":"耳声发射检查",
"dw":"次",
"ggbz":"120.0000",
"bz":"0.00;0.00",
"sl":"1.00",
"je":"120.0000",
"xmxh":3
},
{
"xmbh":"S250101015c0010",
"xmmc":"血细胞分析",
"dw":"次",
"ggbz":"20.0000",
"bz":"0.00;0.00",
"sl":"1.00",
"je":"20.0000",
"xmxh":4
},
{
"xmbh":"S250401020b0010",
"xmmc":"单项补体测定(C3测定)(免疫散射",
"dw":"项",
"ggbz":"20.0000",
"bz":"0.00;0.00",
"sl":"1.00",
"je":"20.0000",
"xmxh":5
},
{
"xmbh":"S250401020b0010",
"xmmc":"单项补体测定(C4测定)(免疫散射",
"dw":"项",
"ggbz":"20.0000",
"bz":"0.00;0.00",
"sl":"1.00",
"je":"20.0000",
"xmxh":6
},
{
"xmbh":"S250401020a0010",
"xmmc":"单项补体测定(Clq)",
"dw":"项",
"ggbz":"15.0000",
"bz":"0.00;0.00",
"sl":"1.00",
"je":"15.0000",
"xmxh":7
},
{
"xmbh":"S250401019b0010",
"xmmc":"总补体测定(CH50)(仪器法)",
"dw":"次",
"ggbz":"30.0000",
"bz":"0.00;0.00",
"sl":"1.00",
"je":"30.0000",
"xmxh":8
},
{
"xmbh":"S250101008b0010",
"xmmc":"红细胞沉降率测定(ESR)",
"dw":"次",
"ggbz":"10.0000",
"bz":"0.00;0.00",
"sl":"1.00",
"je":"10.0000",
"xmxh":9
},
{
"xmbh":"S25010100300010",
"xmmc":"红细胞比积测定(HCT)",
"dw":"次",
"ggbz":"2.0000",
"bz":"0.00;0.00",
"sl":"1.00",
"je":"2.0000",
"xmxh":10
},
{
"xmbh":"S25020307100010",
"xmmc":"全血粘度测定",
"dw":"次",
"ggbz":"26.0000",
"bz":"0.00;0.00",
"sl":"3.00",
"je":"78.0000",
"xmxh":11
},
{
"xmbh":"S25020307200010",
"xmmc":"血浆粘度测定",
"dw":"次",
"ggbz":"20.0000",
"bz":"0.00;0.00",
"sl":"1.00",
"je":"20.0000",
"xmxh":12
},
{
"xmbh":"S25020307000010",
"xmmc":"红细胞流变特性检测",
"dw":"次",
"ggbz":"10.0000",
"bz":"0.00;0.00",
"sl":"1.00",
"je":"10.0000",
"xmxh":13
}
],
"skr":"self",
"detailUrl":"https://pjcy.mof.gov.cn/3sSS4CEM/thirdcheck/html/thirdDetail.html?app_id%3D01316adf0aaf83b943ceb2d8ecc33cce1c23%26einvoice_code%3D31****23%26einvoice_number%3D09******53%26random_number%3Da0**3d%26total_amount%3D473.00%26date%3D20230219%26hmac%3DCABCEF52E55EE13088569CE353AFA101",
"skdw":"复旦大学附属眼耳鼻喉科医院",
"fphm":"09******53",
"jym":"a0**3d"
},
"fplx":"101",
"kprq":"2023-02-1900:00:00",
"success":true,
"je":473,
"time":"2023-06-2909:49:08",
"fphm":"09******53",
"jym":"a0**3d"
}
]
}
// 财政票据查验失败情况
//超过当前接口支持最大查验张数
{
"result": {
"success": true,
"req_id": "121c481c6ac34cbca5d4ab09227ac072",
"timestamp": 1684144706089,
"time": 230
},
"value": [
{
"fplx": null,
"fpdm": "nn****23",
"fphm": "00******87",
"kprq": "2023-01-01 00:00:00",
"je": 2970,
"jym": "a9**6c",
"success": false,
"time": null,
"times": null,
"code": "CheckInvoiceOverSupportCount",
"message": "超过当前接口支持最大查验张数!",
"data": null
},
{
"fplx": null,
"fpdm": "nn****23",
"fphm": "00******87",
"kprq": "2023-01-01 00:00:00",
"je": 2970,
"jym": "a9**6c",
"success": false,
"time": null,
"times": null,
"code": "CheckInvoiceOverSupportCount",
"message": "超过当前接口支持最大查验张数!",
"data": null
}
]
}
//仅可查验最近一年内开具的财政电子票据!
{
"result": {
"success": true,
"req_id": "3b3017ddd6e3438bbe5a8645bfe5acbb",
"timestamp": 1683101047220,
"time": 199
},
"value": [
{
"fplx": "101",
"fpdm": "51****22",
"fphm": "00******31",
"kprq": "2022-03-09 00:00:00",
"je": 2000,
"jym": "wq**pc",
"success": false,
"time": null,
"times": null,
"code": "CheckInvoicesOverOneYears",
"message": "仅可查验最近一年内开具的财政电子票据!",
"data": null,
"retry": null
}
]
}
//查验不规范
{
"result": {
"success": true,
"req_id": "b1cc27d66b3944a5a46cbbf7c6760330",
"timestamp": 1684143773159,
"time": 130
},
"value": [
{
"fplx": "101",
"fpdm": "nn****23",
"fphm": "00******87",
"kprq": "2023-01-01 00:00:00",
"je": 2970,
"jym": "a9**6c",
"success": false,
"time": null,
"times": null,
"code": "CheckInvoiceNotStandard",
"message": "fpdm发票代码查验不规范",
"data": null
}
]
}
//超过该张票当天查验次数
{
"result": {
"success": true,
"req_id": "ae5f8a3f27ae48c59ce43e16bcd66a7a",
"timestamp": 1682523115720,
"time": 105
},
"value": [
{
"fplx": "101",
"fpdm": "13****22",
"fphm": "01******44",
"kprq": "2022-10-06 00:00:00",
"je": 1608,
"jym": "26**58",
"success": false,
"time": null,
"times": null,
"code": "CheckInvoiceMoreFiveTimes",
"message": "超过该张票当天查验次数",
"data": null,
"retry": null
}
]
}
- 字段说明
| 字段名称 | 类型 | 说明 |
|---|---|---|
| fpdm | String | 票据代码 |
| fphm | String | 票据号码 |
| jkrnsrsbh | String | 缴款人纳税识别号 |
| jym | String | 校验码 |
| jkr | String | 缴款人 |
| kprq | String | 开票日期 |
| skdw | String | 收款单位 |
| fhr | String | 复核人 |
| skr | String | 收款人 |
| pjmc | String | 票据名称 |
| jehj | String | 金额合计 |
| jehjcn | String | 金额合计中文大写 |
| rz | String | 是否入账,01未入账 02已入账 |
| dy | String | 是否打印 ,01未打印 02已打印 |
| ch | String | 冲红标志 |
| chrq | String | 冲红日期 |
| chsj | String | 冲红时间 |
| chyy | String | 冲红原因 |
| czbmyz | String | 财政部门印章 |
| czbmyzbh | String | 财政部门印章编号 |
| xmqd | array | 项目清单 |
| xmmx | array | 项目明细 |
| qtxx | array | 其他信息 |
| detailUrl | String | 税局查验截图url |
xmqd项目清单List字段说明
| 字段名称 | 类型 | 说明 |
|---|---|---|
| xmxh | Integer | 项目序号 |
| xmbh | String | 项目编号 |
| xmmc | String | 项目名称 |
| dw | String | 单位 |
| sl | String | 数量 |
| ggbz | String | 规格标准 |
| je | String | 金额 |
| bz | String | 备注 |
xmmx项目明细List字段说明
| 字段名称 | 类型 | 说明 |
|---|---|---|
| xmxh | Integer | 项目序号 |
| xmbh | String | 项目编号 |
| xmmc | String | 项目名称 |
| dw | String | 单位 |
| sl | String | 数量 |
| ggbz | String | 规格标准 |
| je | String | 金额 |
| bz | String | 备注 |
qtxx其他信息List字段说明
| 字段名称 | 类型 | 说明 |
|---|---|---|
| en | String | 字段英文名称 |
| cn | String | 字段中文名称 |
| value | String | 字段值 |
5、错误码
| 错误代码 | 错误信息 | 说明 |
|---|---|---|
| IllegalParameter | 参数不合法 | 请核对参数是否符合参数规范 |
| IllegalParameter.IllegalInvoiceCode | 请求参数不正确,参数fpdm发票代码不正确！ | 请核对fpdm发票代码是否符合参数规范 |
| IllegalParameter.IllegalInvoiceNumber | 请求参数不正确,参数fphm发票号码不正确！ | 请核对fphm发票号码是否符合参数规范 |
| IllegalParameter.IllegalBillingDate | 请求参数不正确,参数kprq开票日期不正确！ | 请核对kprq开票日期是否符合参数规范 |
| IllegalParameter.IllegalTotalAmount | 请求参数不正确,参数je金额不正确！ | 请核对je金额是否符合参数规范 |
| IllegalParameter.IllegalCheckCode | 请求参数不正确,参数jym校验码不正确 | 请核对jym校验码是否符合参数规范 |
| CheckInvoiceNotExistence | 查验成功所查发票不存在 | 发票代码或发票号码在税局查不到，请核对代码、号码是否正确 |
| CheckInvoiceNotStandard | 查询发票不规范/fpdm发票代码查验不规范/fphm发票号码查验不规范//jym校验码查验不规范 | 请核对四要素是否符合发票规范 |
| CheckInvoiceNotSame | 查验成功发票不⼀致 | 请检查四要素是否与真实票面一致，传入金额是否为不含税金额（非二手车）或该发票是否为假票 |
| CheckInvoiceMoreFiveTimes | 超过该张票当天查验次数 | 请确认在调用接口前是否已经通过官方平台查验超过5次 |
| CheckInvoiceException | 查验异常 | 税局服务异常，建议15-20分钟后重试 |
| CheckExceedingLimit | 查验发票张数超过限制 | 发票剩余查验量不足，请与运营负责人沟通确认 |
| CheckInvoiceNotSupport | 暂不支持该（省市）电子票据查验 | 该地区暂不支持该票种查验 |
| CheckAbnormal | 错误信息不固定 | 查验其他异常 |
| ServerError | 服务器异常，请稍后重试 | 服务器异常 |
| CheckInvoiceOverSupportCount | 超过当前接口支持最大查验张数! | 检查单次查验张数 |
| CheckInvoicesOverOneYears | 仅可查验最近一年内开具的财政电子票据! | 请检查开票日期！ |
| CheckInvoicesMoreThanToday | 开票日期超过当前日期 | 请检查开票日期！ |