财政电子票据验真

使用说明

统一接口版本号 v2

八戒财税提供全国财政电子票据验真接口,以下区划的财政电子票据:

地区
中央、北京、天津、河北、山西、辽宁、吉林、黑龙江、上海、江苏、浙江、安徽、福建、江西、山东、河南、湖北、广东、广西、海南、重庆、四川、贵州、云南、西藏、甘肃、宁夏

接口列表和资费

接口通常分为 3 步:

  1. 预处理:参数校验等
  2. 发票查验:同步查询官方平台信息
  3. 格式化数据:返回格式化数据结果,提供额外的信息

TIP

接口响应结果返回success: true才计费

不同接口单次请求成功消耗的资源点数不同,具体如下

接口路径 消耗资源点 功能 描述
/v2/eInvoice/query 1 基础查验(获取文件) 基础查验结果

基础查验

参数名称类型必选描述
fpdmString电子票据代码
fphmString电子票据号码
kprqString开票日期,如YYYYMMDD
checkCodeString校验码
moneyString票据金额

响应结果

基础信息

{
  "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": "类型",
    }
  ],
  "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": "", // 医疗救助'(河北),
    ...
  }
}

错误码定义

参考错误码定义