verify_vat_invoice

• 1.接口描述
• 2.请求参数
• 3.返回参数
• 4.错误码
• 5.输入示例

1.接口描述

该 API 用于对输入税票的五要素进行税票的验真,并返回验真后的结构化数据

请求方式

POST

http://cloudapi.deepfinch.com/data/verify_vat_invoice

2.请求参数

2.1 请求头域

2.2 请求体

3.返回参数

3.1 data 字段的参数：

3.2 tax_tick_main_info 字段的参数：

3.2.1 tax_charge_items 字段的参数：

3.2.2 `expands ` 字段的参数：

3.2.3 tick_type 字段的类型列表：

3.2.4 `medical_expands ` 字段的参数：

3.2.4.1 `payments_info ` 字段的参数：

3.2.4.2 `cost_categories ` 字段的参数：

3.2.4.3 `cost_detail_list ` 字段的参数：

3.2.4.4 payments_info 中name的取值：

以下字段如票面中不包含或未提取到,不做输出

以上字段不同地区票面打印内容不一致,我方将含义一致的词进行了统一化处理,不同增值税发票相同含义词均按以下词表中的词固定输出,如需对应的词库请联系商务索取

返回结果示例

{
  "data": {
    "check_time": "2022-10-26 16:52:41",
    "invoice_status": "0",
    "tax_tick_main_info": {
      "expands": [
        {
          "code": "100001",
          "name": "销方地址、 电话（税票）",
          "value": "北京市海淀区中关村环保科技园锦带路66号院0101-83055000"
        },
        {
          "code": "100002",
          "name": "销方开户行、账号（税票）",
          "value": "民生 银行北京环保园支行 161377953"
        }
      ],
      "invoice_code": "011002200211",
      "invoice_no": "53817869",
      "invoice_total_price": "8.00",
      "invoice_total_price_tax": "8.00",
      "invoice_total_tax": "0.00",
      "invoicing_party_code": "9111***************",
      "invoicing_party_name": "北京谱尼医学检验实验室有限公司",
      "issue_date": "2022-04-11",
      "payer_party_code": "9111***************",
      "payer_party_name": "深源恒际科技有限公司",
      "random_number": "69970033660035186106",
      "random_number6": "186106",
      "remarks": "",
      "tax_charge_items": [
        {
          "amt": "8.00",
          "amt_tax": "8.00",
          "charge_code": "3070202000000000000",
          "charge_name": "核酸检测",
          "num": "1.00",
          "specification_model": "",
          "std": "8.00000000",
          "tax": "0.00",
          "tax_rate": "0.000000",
          "unit": ""
        }
      ],
      "tick_type": "10",
      "medical_expands": {
        "patient_name": "深智",
        "note_no": "711196782",
        "note_code": "021111100104",
        "check_code": "0279911113719152212",
        "billing_date": "2024-04-26",
        "total_cost": 216.0,
        "hospital_name": "自营医院有限公司",
        "treatment_date": "2024-04-26",
        "payments_info": [
          {
            "name": "个人现金支付",
            "cost": 216.0
          }
        ],
        "start_hospital_date": null,
        "end_hospital_date": null,
        "cost_categories": [
          {
            "name": "医疗服务",
            "cost": 216.0
          }
        ],
        "cost_detail_list": [
          {
            "ocr_name": "X线计算机体层(CT)螺旋扫描（4-64层，不含64层）",
            "class": "医疗服务",
            "amount": 1.0,
            "cost": 216.0
          }
        ]
      }
    }
  },
  "request_id": "TID6d74b8ced57748d39f3fa204e418edde",
  "status": "OK"
}

4.错误码

4.1 服务错误码

备注: 以上40X系列错误描述请参考reason字段

4.2 验真错误码

当验真失败时（status=VERIFY_FAILED），我们通过返回的error_code字段可以区分不同的错误原因：

输出样例

{ 
    "error_code": 303,
    "status": "VERIFY_FAILED",
     "reason": "note_code is required", 
    "request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e", 
    "qrcode_scan_result": 1
}

5.输入示例