财政电子票据验真
使用说明
统一接口版本号 v2
八戒财税提供全国财政电子票据验真接口(当获取明细信息时,目前支持以下地区:广东、江苏、四川、河北、浙江、天津、陕西、海南、安徽、北京、上海、重庆、吉林、山东、辽宁、湖北、广西、贵州、深圳地区)
接口列表和资费
接口通常分为 3 步:
- 预处理:参数校验等
- 发票查验:同步查询官方平台信息
- 格式化数据:返回格式化数据结果,提供额外的信息
TIP
接口响应结果返回success: true
才计费
不同接口单次请求成功消耗的资源点数不同,具体如下
接口路径 | 消耗资源点 | 功能 | 描述 |
---|---|---|---|
/v2/eInvoice/query | 1 | 基础查验(获取文件) | 基础查验结果 |
/v2/eInvoice/query | 1.5 | 获取明细信息 | 当获取明细信息时,消耗资源点为1.5 |
基础查验
参数名称 | 类型 | 必选 | 描述 |
---|---|---|---|
fpdm | String | 是 | 电子票据代码 |
fphm | String | 是 | 电子票据号码 |
kprq | String | 是 | 开票日期,如YYYYMMDD |
checkCode | String | 是 | 校验码 |
money | String | 是 | 票据金额 |
details | Boolean | 否 | true表示获取明细,其他值不获取(获取明细时,消耗资源点为1.5) |
payer | String | 否 | 缴款人姓名 |
idcard | String | 否 | 身份证后六位。重庆、湖北、四川、海南、陕西、辽宁地区必填。 |
响应结果
基础信息
{
"EInvoiceName": "电子票据名称",
"EInvoiceCode": "电子票据代码",
"EInvoiceNumber": "电子票据号码",
"RandomNumber": "校验码",
"Checker": "复核人",
"HandlingPerson": "收款人",
"TotalAmount": "票据金额小写",
"IssueDate": "开票日期",
"TotalAmountYuan": "票据金额大写",
"InvoicingPartyName": "收款单位",
"PayerPartyCode": "交款人统一社会信用代码",
"PayerPartyName": "交款人",
"otherInfoJson": [ // 其他信息,没有其他信息时返回值为 null
[
{ "zh_val": "具体其他信息名称:", "value": "具体其他信息的值", "en_val": "英文名,对应MainExt里面字段名" },
// 例如:
{ "zh_val": "性别:", "value": "男", "en_val": "Gender" },
],
],
"Details": [
{
"ItemRemark": "备注",
"ItemName": "项目名称",
"ItemUnit": "单位",
"ItemAmount": "价格",
"ItemCode": "项目编码",
"ItemStd": "标准",
"ItemQuantity": "数量",
"ItemAmountPercent": "个人自付百分比",
"ItemAmountSelf": "个人自付金额",
"ItemType": "类型",
}
],
"AuxDetails": [ // 明细
{
"ItemRemark": "备注",
"ItemName": "项目名称",
"ItemUnit": "单位",
"ItemAmount": "价格",
"ItemCode": "项目编码",
"ItemStd": "标准",
"ItemQuantity": "数量",
"ItemRelatedCode": "大项编码",
"ItemRelatedName": "大项名称",
"ItemAmountPercent": "个人自付百分比",
"ItemAmountSelf": "个人自付金额",
"ItemType": "类型",
"ItemDj": "单价",
"ItemZf": "自费",
"ItemFlzf": "分类自负",
}
],
"queryCount": "查询次数",
"isRed": true, // 是否是红票
"isPrint": false, // 是否已打印
"queryTime": "上次查询时间",
"MainExt": { // 附加信息
"MedicalDate": "", // 就诊日期
"MedicalInsuranceID": "", // 业务流水号(医保编号)
"MedicalInsuranceType": "", // 医保类型
"Gender": "", // 性别
"OrgType": "", // 医疗机构类型
"PatientNumber": "", // 门诊号
"SelfpaymentAmount": "", // 个人自付
"OtherPayAmount": "", // 其他支付
"OtherPayAmountInfo": "", // 其他支付明细
"SelfpaymentCost": "", // 个人自费
"AccountPayAmount": "", // 个人账户支付
"OwnPayAmountInfo": "", // 个人现金支付明细
"OwnPayAmount": "", // 个人现金支付
"FundPayAmount": "", // 医保统筹基金支付
"FundPayAmountInfo": "", // 医保统筹基金支付明细
"FundDjjzAmount": "", // 道交救助基金垫付
"FundDjjzAmountInfo": "", // 道交救助基金垫付明细
"DepartmentName": "", // 部门名
"HospitalizationNumber": "", // 住院号
"InHospitalDate": "", // 住院日期
"OutHospitalDate": "", // 出院日期
"MedicalType": "", // 治疗类型
"PrepayAmount": "", // 预缴金额
"RechargeAmount": "", // 补缴金额
"RefundAmount": "", // 退费金额
"SelfPaymentCare": "", // 个人自理
"PatientCompany": "", // 工作单位
"CS_BLH": "", // 病历号(河北、江苏)
"CS_BJJE": "", // 补缴金额(河北、江苏)
"CS_TFJE": "", // 退费金额(河北、江苏)
"CS_YJJE": "", // 预缴金额(河北、江苏)
"CS_ZYH": "", // 住院号(河北、江苏)
"CS_ZYKB": "", // 住院科别(河北、江苏)
"CS_ZYSJ": "", // 住院时间(河北、江苏)
"CS_OwnPayBalance": "", // 个人账户余额(河北、江苏)
"CS_PayWay": "", // 支付方式(河北、江苏)
"CS_Insurance": "", // 大病保险支付(河北、江苏)
"CS_OtherIns": "", // 其他保险支付(河北、江苏)
"CS_Salvation": "", // 医疗救助支付(河北、江苏)
"CS_BCFHJBYLFY": "", // 本次符合基本医疗费用'(河北),
"CS_BNDBZCLJ": "", // 本年大病支出累计'(河北),
"CS_DETCLJFW": "", // 大额统筹累计支付'(河北),
"CS_DETCZF": "", // 大额统筹支付'(河北),
"CS_GWYBZZF": "", // 公务员补助支付'(河北),
"CS_JRDBJE": "", // 进入大病金额'(河北),
"CS_PKRKTGZFE": "", // 贫困人口提高支付额'(河北),
"CS_QZDB": "", // 其中大病'(河北),
"CS_QZJB": "", // 其中基本'(河北),
"CS_QFBZLJ": "", // 起付标准累计'(河北),
"CS_TCLJZF": "", // 统筹累计支付'(河北),
"CS_ELJZ": "", // 医疗救助'(河北),
...
}
}
错误码定义
参考错误码定义