请求地址：/api/invoice/check

http请求方式：POST

接口诞生版本：派平台2.3版本

所属系统：π平台

接口说明：该接口用于财政票据查验，与财政票据官网保持一致；本接口可查验最近一年内开具的电子票据；每张票据当日可查询5次

单次调用最大条数：1

使用场景

当前支持查验的发票类型：电子财政票据查验

请求报文

注意：类型默认为String，特殊的类型会标注；

请求参数：
派平台
字段编码	类型	是否必填	字段名称	说明
fpdm		是	票据代码
fphm		是	票据号码
kprq		是	开票日期	格式 yyyy-MM-dd / yyyyMMdd
je		是	金额
jym		是	校验码
billTypeInvoice		是	发票类型	101：财政票据

响应报文

返回参数：主表区
派平台
字段编码	类型	字段名称	说明
code		查验失败错误码
message		查验失败错误信息
validState	boolean	查验成功标识	Y-成功；N-失败
ok	boolean	接口响应标识
isDeduct	String	是否收费	Y收费，N不收费
fpdm		票据代码
fphm		票据号码
kprq		开票日期	yyyy-MM-dd
jym		校验码
je	number \| null	金额
jshj	number \| null	价税合计
skm	string \| null	税控码/密码区
fplx	string \| null	发票类型代码	101:财政票据
dq	string \| null	地区代码

返回参数：明细区
派平台
字段编码	类型	字段名称	说明
fpdm		票据代码
fphm		票据号码
jkrnsrsbh		缴款人纳税识别号
jym		校验码
jkr		缴款人
kprq		开票日期	yyyy-MM-dd
skdw		收款单位
fhr		复核人
skr		收款人
pjmc		票据名称
jehj		金额合计
jehjcn		金额合计中文大写
ch		冲红标志	01正常 02冲红
chrq		冲红日期
chsj		冲红时间
chyy		冲红原因
dy		是否打印	01未打印 02已打印
rz		是否入账	01未入账 02 已入账
czbmyz		财政部门印章
czbmyzbh		财政部门印章编号
xmqd	array [object {8}]	项目清单
xmxh		项目序号
xmbh		项目编号
xmmc		项目名称
dw		单位
sl		数量
ggbz		规格标准
je		金额
bz		备注
xmmx	array [object {8}]	项目明细
xmxh		项目序号
xmbh		项目编号
xmmc		项目名称
dw		单位
sl		数量
ggbz		规格标准
je		金额
bz		备注
qtxx	array [object {3}]	其他信息
en		字段英文名称
cn		字段中文名称
value		字段值
detailUrl		税局查验截图url

请求报文范例

{
    "data": {
        "fpdm": "44060123",
        "fphm": "9174784249",
        "kprq": "2024-03-21",
        "je": "170.90",
        "jym": "d353ab",
        "billTypeInvoice": "101"
    },
    "appId": "ztefssc",
    "format": "json",
    "sign": "bQWhZwZzAIBaw23v8D4T/aiO3FQ=",
    "version": "V2.0",
    "noncestr": "e567b0bb-dd51-4590-9b0c-b10c101233e8",
    "timestamp": "2024-05-28 14:38:00"
}

响应报文范例

{
    "invoiceTypeName": "财政票据",
    "feeWithoutTax": "170.90",
    "billingTime": "2024-03-21",
    "billingNo": "44060123",
    "rawData": "{\"code\":\"2000\",\"data\":[{\"data\":{\"fpdm\":\"44060123\",\"jkrnsrsbh\":\"\",\"pjmc\":\"广东省医疗门诊收费票据（电子）\",\"ch\":\"01\",\"rz\":\"\",\"czbmyzbh\":\"\",\"jehjcn\":\"壹佰柒拾圆玖角\",\"chrq\":\"\",\"chyy\":\"\",\"jehj\":\"170.90\",\"jkr\":\"罗迪\",\"xmqd\":[{\"dw\":\"元\",\"xmbh\":\"99920007\",\"xmmc\":\"检查费\",\"bz\":\"\",\"ggbz\":\"170.90\",\"sl\":\"1\",\"je\":\"170.90\",\"xmxh\":0}],\"fhr\":\"黄俊杰\",\"chsj\":\"\",\"dy\":\"01\",\"czbmyz\":\"\",\"kprq\":\"20240321\",\"qtxx\":[{\"en\":\"ywlsh\",\"cn\":\"业务流水号\",\"value\":\"OP20467425\"},{\"en\":\"mzh\",\"cn\":\"门诊号\",\"value\":\"0003003248\"},{\"en\":\"jzrq\",\"cn\":\"就诊日期\",\"value\":\"20240320\"},{\"en\":\"yljglx\",\"cn\":\"医疗机构类型\",\"value\":\"中医医院\"},{\"en\":\"yblx\",\"cn\":\"医保类型\",\"value\":\"健康体检\"},{\"en\":\"ybbh\",\"cn\":\"医保编号\",\"value\":\"44130000000002593679\"},{\"en\":\"xb\",\"cn\":\"性别\",\"value\":\"男\"},{\"en\":\"ybtcjjzf\",\"cn\":\"医保统筹基金支付\",\"value\":\"0.00\"},{\"en\":\"qtzf\",\"cn\":\"其他支付\",\"value\":\"0.00\"},{\"en\":\"grzhzf\",\"cn\":\"个人账户支付\",\"value\":\"125.90\"},{\"en\":\"grxjzf\",\"cn\":\"个人现金支付\",\"value\":\"45.00\"},{\"en\":\"grzf\",\"cn\":\"个人自付\",\"value\":\"125.90\"},{\"en\":\"grzfe\",\"cn\":\"个人自费\",\"value\":\"45.00\"},{\"en\":\"zcxjm\",\"cn\":\"政策性减免\",\"value\":\"\"}],\"xmmx\":[],\"detailUrl\":\"\",\"skr\":\"舒英\",\"skdw\":\"广州中医药大学深圳医院（福田）\",\"fphm\":\"9174784249\",\"jym\":\"d353ab\"},\"dq\":\"44\",\"times\":27,\"kprq\":\"2024-03-21 00:00:00\",\"czpj\":true,\"fpdm\":\"44060123\",\"fplx\":\"101\",\"customReqId\":\"100022104c08f569ca6840429d8cc807a51a3fea\",\"success\":true,\"je\":170.90,\"time\":\"2024-07-16 09:20:16\",\"fphm\":\"9174784249\",\"jym\":\"d353ab\"}],\"success\":true,\"reqId\":\"0fd04fd4cb794e0090c2dd5bf21a1570\"}",
    "message": "查验成功",
    "checkCode": "d353ab",
    "billingCode": "9174784249",
    "paiResponseId": "72d276b65bce4df088abb54f3a1c1843",
    "validState": "Y",
    "extendCategory": "",
    "paiResponseCost": 2336,
    "appId": "ztefssc",
    "invoiceTypeCode": "101",
    "id": "5dfbf8c586344c6abe7f1320aed81a25",
    "ok": true,
    "isDeduct": "Y",
    "paiResponseTime": "2024-07-16 09:20:18"
}

A.1:错误代码

错误码	收费	场景说明	提示语	需求说明
	是		查验成功
201	是	所查发票不存在	所查发票不存在	201&216&243三种失败状态，前端系统会触发自动查验
202	是	超过该张票当天查验次数	超过该张票当天查验次数
211		参数不合法		其他错误码，保持原逻辑，取厂商返回的错误信息
212	是		发票信息不一致
213		服务器异常，请稍后重试	保持原逻辑，取厂商返回的错误信息	213&500失败状态，会自动触发降级查验，依次为企享云>高灯>航信
216		当日开具发票可于次日进行查验	保持原逻辑，取厂商返回的错误信息
217		超过五年不能查验	保持原逻辑，取厂商返回的错误信息
217		仅可查验最近一年内开具的财政电子票据!	保持原逻辑，取厂商返回的错误信息
241		没有查验权限	保持原逻辑，取厂商返回的错误信息
242		已超过最大查验量	保持原逻辑，取厂商返回的错误信息
243		查验异常	保持原逻辑，取厂商返回的错误信息
221		当前查验未完成	保持原逻辑，取厂商返回的错误信息
500		未知异常，请联系管理员	保持原逻辑，取厂商返回的错误信息	除与供应商映射错误信息外，还包含其他未知错误，属于兜底错误码，错误信息为“未知异常，请联系管理员”

财政票据查验

关联知识库

财政票据查验

关于作者

关联知识库

目录