1、接口说明
2、接口接收参数
序号 |
名称 |
类型 |
必填 |
说明 |
1 |
key |
String |
是 |
用户ocrKey |
2 |
secret |
String |
是 |
用户ocrSecrert |
3 |
invoiceCode |
String |
是 |
发票代码(电子) |
4 |
invoiceNumber |
String |
是 |
发票号码(电子) |
5 |
billingDate |
String |
是 |
开票日期:YYYY-MM-DD |
6 |
amountTax |
String |
是 |
票面金额 |
7 |
checkCode |
String |
是 |
校验码 |
8 |
typeId |
Integer |
是 |
发票验真:3017 |
3、接口返回值参说明
序号 |
名称 |
类型 |
说明 |
1 |
code |
String |
查验状态(详见 附录-1) |
2 |
checkNum |
String |
查验次数(部分地区没有查验次数显示“0”) |
3 |
administrativeDivisionName |
String |
所属行政区名称 |
4 |
invoiceCode |
String |
发票代码 |
5 |
invoiceNumber |
String |
发票号码 |
6 |
billingDate |
String |
开票日期(yyyy-mm-dd) |
7 |
totalAmount |
String |
不含税金额 |
8 |
checkCode |
String |
校验码 |
9 |
amountTax |
String |
票面金额 |
10 |
purchaserName |
String |
购方名称 |
11 |
purchaserTaxNo |
String |
购方税号 |
12 |
salesName |
String |
销方名称 |
13 |
salesTaxNo |
String |
销方税号 |
14 |
totalTax |
String |
合计税额 |
15 |
amountTaxCN |
String |
票面金额(大写) |
16 |
receiverName |
String |
收款人 |
17 |
recheckName |
String |
复核人 |
18 |
remarks |
String |
备注 |
19 |
entryTag |
String |
入账标识 0未入账 1已入账 |
20 |
printTag |
String |
打印标识 0未打印 1已打印 |
21 |
redTag |
String |
冲红标识 0正常,1冲红 |
22 |
redDate |
String |
冲红日期 |
23 |
redTime |
String |
冲红时间 |
24 |
redReason |
String |
冲红原因 |
25 |
financeSeal |
String |
财政部门印章 |
26 |
financeSealNo |
String |
财政部门印章编码 |
27 |
invoiceLists |
String |
明细列表(1大类明细) |
28 |
invoiceDetails |
String |
项目明细(2小类明细) |
29 |
otherInfos |
String |
其他信息(详见 附录-2) |
30 |
commodityCode |
String |
项目编号 |
31 |
commodityName |
String |
项目名称(详见 附录-3) |
32 |
specificationModel |
String |
规格型号 |
33 |
unit |
String |
单位 |
34 |
quantity |
String |
数量 |
35 |
unitPrice |
String |
单价 |
36 |
amount |
String |
金额 |
37 |
taxRate |
String |
税率 |
38 |
tax |
String |
税额 |
39 |
notes |
String |
备注 |
40 |
serialNo |
String |
项目序号 |
41 |
type |
String |
1大类,2小类 |
42 |
fieldEn |
String |
英文名称 |
43 |
fieldCn |
String |
中文名称 |
44 |
fieldValue |
String |
字段值 |
45 |
invoiceType |
String |
发票类型 34 财政医疗票据 |
46 |
title |
String |
标题 |
47 |
supervisorAreaCode |
String |
地区代码(详见 附录-4) |
48 |
checksumCategories |
String |
大类金额校验 |
49 |
costCategories |
String |
大类金额,大类金额之和是否等于总金额。0-通过校验,1-未通过校验 |
4、查验结果返回示例
(1) 医疗门诊收费票据(电子)
{
"code": 0,
"msg": "成功",
"data": {
"checkNum": "查验次数",
"administrativeDivisionName": "所属行政区名称",
"invoiceType": "发票类型",
"invoiceCode": "发票代码",
"invoiceNumber": "发票号码",
"billingDate": "开票日期",
"totalAmount": "不含税金额",
"checkCode": "校验码",
"amountTax": "票面金额",
"purchaserName": "购方名称",
"purchaserTaxNo": "购方税号",
"salesName": "销方名称",
"salesTaxNo": "销方税号",
"totalTax": "合计税额",
"amountTaxCN": "票面金额(大写) ",
"receiverName": "收款人",
"recheckName": "复核人",
"remarks": "备注",
"entryTag": "入账标识 0未入账 1已入账",
"printTag": "打印标识 0未打印 1已打印",
"redTag": "冲红标识 0正常,1冲红",
"redDate": "冲红日期",
"redTime": "冲红时间",
"redReason": "冲红原因",
"financeSeal": "财政部门印章",
"financeSealNo": "财政部门印章编码",
"invoiceLists": [
{
"commodityCode": "项目编号",
"commodityName": "项目名称",
"specificationModel": "规格标准",
"unit": "单位",
"quantity": "数量",
"unitPrice": "单价",
"amount": "金额",
"taxRate": "税率",
"tax": "税额",
"notes": "备注"
},
……
],
"invoiceDetails": [
{
"commodityCode": "税务编码",
"commodityName": "项目名称",
"specificationModel": "规格标准",
"unit": ""
"quantity": "",
"unitPrice": "",
"amount": "",
"taxRate": "",
"tax": "",
"notes": "",
"serialNo": "",
"type": ""
……
],
"otherInfos": [
{
"fieldEn": "英文名称",
"fieldCn": "中文名称",
"fieldValue": "字段值"
},
……
]
"title": "标题"
"supervisorAreaCode":"地区代码"
"checksumCategories": [
{
"costCategories":""
}
]
}
}
(2) 医疗住院收费票据(电子)
{
"code": 0,
"msg": "成功",
"data": {
"checkNum": "0",
"administrativeDivisionName": "所属行政区名称",
"invoiceType": "发票类型",
"invoiceCode": "发票代码",
"invoiceNumber": "发票号码",
"billingDate": "开票日期",
"totalAmount": "不含税金额",
"checkCode": "校验码",
"amountTax": "票面金额",
"purchaserName": "购方名称",
"purchaserTaxNo": "购方税号",
"salesName": "销方名称",
"salesTaxNo": "销方税号",
"totalTax": "合计税额",
"amountTaxCN": "票面金额(大写)",
"receiverName": "收款人",
"recheckName": "复核人",
"remarks": "备注",
"entryTag": "入账标识",
"printTag": "打印标识",
"redTag": "冲红标识",
"redDate": "冲红日期",
"redTime": "冲红时间",
"redReason": "冲红原因",
"financeSeal": "财政部门印章",
"financeSealNo": "财政部门印章编码",
"invoiceLists": [
{
"commodityCode": "税务编码",
"commodityName": "项目名称",
"specificationModel": "规格标准",
"unit": "单位",
"quantity": "数量",
"unitPrice": "单价",
"amount": "金额",
"taxRate": "税率",
"tax": "税额",
"notes": "备注"
"serialNo": "",
"type":""
},
……
],
"invoiceDetails": [
{
"commodityCode": "税务编码",
"commodityName": "项目名称",
"specificationModel": "规格标准",
"unit": "",
"quantity": "",
"unitPrice": "",
"amount": "",
"taxRate": "",
"tax": "",
"notes": "",
"serialNo": "",
"type":
……
],
"otherInfos": [
{
"fieldEn": "英文名称",
"fieldCn": "中文名称",
"fieldValue": "字段值"
},
……
]
"title": "标题"
"supervisorAreaCode":"地区代码"
"checksumCategories": [
{
"costCategories":""
}
]
}
}
(3) 非税收入票据(电子)
{
"code": 0,
"msg": "成功",
"data": {
"checkNum": "5",
"administrativeDivisionName": "所属行政区名称",
"invoiceType": "发票类型",
"invoiceCode": "发票代码",
"invoiceNumber": "发票号码",
"billingDate": "开票日期",
"totalAmount": "不含税金额",
"checkCode": "校验码",
"amountTax": "票面金额",
"purchaserName": "购方名称",
"purchaserTaxNo": "购方税号",
"salesName": "销方名称",
"salesTaxNo": "销方税号",
"totalTax": "合计税额",
"amountTaxCN": "票面金额(大写) ",
"receiverName": "收款人",
"recheckName": "复核人",
"remarks": "备注",
"entryTag": "入账标识 0未入账 1已入账",
"printTag": "打印标识 0未打印 1已打印",
"redTag": "冲红标识 0正常,1冲红",
"redDate": "冲红日期",
"redTime": "冲红时间",
"redReason": "冲红原因",
"financeSeal": "财政部门印章",
"financeSealNo": "财政部门印章编码",
"invoiceLists": [ //明细列表
{
"commodityCode": "项目编号",
"commodityName": "项目名称",
"specificationModel": "规格标准",
"unit": "单位",
"quantity": "数量",
"unitPrice": "单价",
"amount": "金额",
"taxRate": "税率",
"tax": "税额",
"notes": "备注"
"serialNo": "", //项目序号
"type": //类型(1:大类)
……
}
],
"invoiceDetails": [ //项目明细
{
"commodityCode": "项目编号",
"commodityName": "项目名称",
"specificationModel": "规格标准",
"unit": "单位",
"quantity": "数量",
"unitPrice": "单价",
"amount": "金额",
"taxRate": "税率",
"tax": "税额",
"notes": "备注"
"serialNo": "", //项目序号
"type": //类型(2:小类)
……
}
],
"otherInfos": [ //其他信息
{
"fieldEn": "英文名称",
"fieldCn": "中文名称,
"fieldValue": "字段值"
}
]
"title": "标题"
"supervisorAreaCode":"地区代码"
"checksumCategories": [ //票据内金额校验结果
{
"costCategories":( 0-通过校验,1-未通过校验)
}
]
}
}
附录-1 code查验状态码说明
code |
message |
0 |
查验成功发票一致(扣费) |
-30000 |
该票今日本平台核验失败已超5次(扣费) |
-30001 |
发票信息不一致(扣费) |
-30002 |
所查发票不存在(扣费) |
-30003 |
超过该张票当天查验次数(请于次日再次查验) |
-30004 |
查询发票不规范 |
-30005 |
参数不能为空 |
-30008 |
参数长度不正确 |
-30010 |
查验异常 |
-30015 |
类型错误 |
-30017 |
传入参数不正确 |
-30020 |
查验失败 |
-30021 |
超过一年的不能查验 |
附录-2 otherInfos
其他信息字段,不区分地区,按该表格顺序输出字段。由于各地区、医院可能会出现内部自有的字段信息,如果有新的字段,将会在本表格字段后面增加显示。
序号 |
fieldEn(英文名称) |
类型 |
fieldCn(中文名称) |
1 |
ywlsh |
String |
业务流水号 |
2 |
zyh |
String |
住院号 |
3 |
blh |
String |
病历号 |
4 |
zyts |
String |
住院天数 |
5 |
zysj |
String |
住院时间 |
6 |
cysj |
String |
出院时间(yyyy-mm-dd) |
7 |
xb |
String |
性别 |
8 |
yljglx |
String |
医疗机构类型 |
9 |
yblx |
String |
医保类型 |
10 |
ybtcjjzf |
String |
医保统筹基金支付 |
11 |
grzhzf |
String |
个人账户支付 |
12 |
yjje |
String |
预缴金额 |
13 |
bjje |
String |
补缴金额 |
14 |
tfje |
String |
退费金额 |
15 |
mzh |
String |
门诊号 |
16 |
ybbh |
String |
医保编号 |
17 |
qtzf |
String |
其他支付 |
18 |
grxjzf |
String |
个人现金支付 |
19 |
grzf |
String |
个人自付 |
20 |
grzfe |
String |
个人自费 |
21 |
jzrq |
String |
就诊日期 |
22 |
zykb |
String |
住院科别 |
23 |
flzf |
String |
分类自负 |
24 |
grzfu |
String |
个人自负 |
25 |
fjjjzf |
String |
附加基金支付 |
26 |
ybdnzhye |
String |
医保当年账户余额 |
27 |
yblnzhye |
String |
医保历年账户余额 |
28 |
zcxjm |
String |
政策性减免 |
29 |
yycd |
String |
医院承担 |
30 |
djjzjjdf |
String |
道交救助基金垫付 |
31 |
djjzjjdfxx |
String |
道交救助基金垫付信息 |
32 |
grzl |
String |
个人自理 |
33 |
grxjzfmx |
String |
个人现金支付明细 |
34 |
yltcjjzfmx |
String |
医疗统筹基金支付明细 |
35 |
qtzfmx |
String |
其他支付明细 |
36 |
dbbxzf |
String |
大病保险支付 |
37 |
qtbxzf |
String |
其他保险支付 |
38 |
yljzzf |
String |
医疗救助支付 |
39 |
grzhye |
String |
个人账户余额 |
40 |
zffs |
String |
支付方式 |
41 |
cqlj |
String |
长期累计 |
42 |
ylszf |
String |
乙类首自付 |
43 |
ablzf |
String |
按比例自付 |
44 |
gwybz |
String |
公务员补助 |
45 |
szbz |
String |
师职补助 |
46 |
debxbx |
String |
大额保险报销 |
47 |
cxjzffy |
String |
超限价自费费用 |
48 |
dbbcbxbx |
String |
大病补充保险报销 |
49 |
cqjcf |
String |
产前检查费 |
50 |
lnzf |
String |
历年支付 |
51 |
bnzf |
String |
本年支付 |
52 |
qfbz |
String |
起付标准 |
53 |
kpr |
String |
开票人 |
54 |
jkrzh |
String |
交款人账号 |
55 |
skrzh |
String |
收款人账号 |
56 |
jkrkhh |
String |
交款人开户行 |
57 |
skrkhh |
String |
收款人开户行 |
58 |
kpsj |
String |
开票时间 |
59 |
fhr |
String |
复核人 |
60 |
ndybfwn |
String |
年度医保范围内 |
61 |
mzdezf |
String |
门诊大额支付 |
62 |
cjbzzf |
String |
残军补助支付 |
63 |
zf1 |
String |
自付一 |
64 |
cfdje |
String |
超封顶金额 |
65 |
ybjylsh |
String |
医保交易流水号 |
66 |
dwbcygl |
String |
单位补充[原公疗] |
67 |
ybfwn |
String |
医保范围内 |
68 |
ndmzdezf |
String |
年度门诊大额支付 |
69 |
qfje |
String |
起付金额 |
70 |
zf2 |
String |
自付二 |
71 |
txbczf |
String |
退休补充支付 |
72 |
ybyssjs |
String |
医保已实时结算 |
73 |
qfe |
String |
起付额 |
74 |
qf |
String |
欠费 |
75 |
cbd |
String |
参保地 |
76 |
hsjcyycd |
String |
核酸检测医院承担 |
77 |
yljz |
String |
医疗救助 |
78 |
zf |
String |
自费 |
79 |
lnye |
String |
历年余额 |
80 |
bnye |
String |
本年余额 |
81 |
grzhzfmx |
String |
个人账户支付明细 |
82 |
tys |
String |
退银商 |
83 |
zyylwjs |
String |
住院已联网结算 |
84 |
yydfje |
String |
医院垫付金额 |
85 |
de |
String |
大额 |
86 |
qh |
String |
卡号 |
87 |
gr |
String |
个人 |
88 |
mzyblwyjs |
String |
门诊医保联网已结算 |
89 |
jzzf |
String |
救助自负 |
90 |
jmybmzzf |
String |
居民医保门诊支付 |
91 |
nddbbzfwn |
String |
年度大病保障范围内 |
92 |
ndjmybmzzf |
String |
年度居民医保门诊支付 |
93 |
jfrq |
String |
交费日期 |
94 |
sbqh |
String |
社保卡号 |
95 |
zyks |
String |
住院科室 |
96 |
zpph |
String |
纸票票号 |
97 |
xjzf |
String |
现金支付 |
98 |
qtybzf |
String |
其他医保支付 |
附录-3 commodityName项目名称列表
|
|
|
|
|
床位费 |
诊察费 |
检查费 |
化验费 |
治疗费 |
手术费 |
护理费 |
卫生材料费 |
西药费 |
中药饮片 |
中成药费 |
一般诊疗费 |
挂号费 |
|
附录-4 地区代码
代码 |
地区 |
代码 |
地区 |
11 |
北京市 |
3702 |
青岛市 |
12 |
天津市 |
41 |
河南省 |
13 |
河北省 |
42 |
湖北省 |
14 |
山西省 |
43 |
湖南省 |
15 |
内蒙古 |
44 |
广东省 |
21 |
辽宁省 |
4403 |
深圳市 |
2102 |
大连市 |
45 |
广西 |
22 |
吉林省 |
46 |
海南省 |
23 |
黑龙江省 |
50 |
重庆市 |
31 |
上海市 |
51 |
四川省 |
32 |
江苏省 |
52 |
贵州省 |
33 |
浙江省 |
53 |
云南省 |
3302 |
宁波市 |
54 |
西藏 |
34 |
安徽省 |
61 |
陕西省 |
35 |
福建省 |
62 |
甘肃省 |
3502 |
厦门市 |
63 |
青海省 |
36 |
江西省 |
64 |
宁夏 |
37 |
山东省 |
65 |
新疆 |