票据查询相关接口

此页面包含了票据查询相关的接口，包括票据查询。

票据查询

接口信息

• 接口名称: 票据查询
• 请求方式: POST
• 请求地址: /bill-query
• 接口描述: 根据患者ID查询患者票据信息
• 认证要求: 需要

请求参数

参数名	类型	说明	示例
patientId	string	患者ID	"1"
timeRange	string	时间范围	"WEEK"

TIP

固定时间段查询即可,超过一年的票据不予查询,符合大多数小程序的使用场景

• 一周内：WEEK
• 三个月：THREE_MONTHS
• 半年内：HALF_YEAR
• 一年内：YEAR

请求示例

{ "patientId":1, "timeRange":"WEEK"}

返回参数

参数名	类型	说明	示例
time	string	时间	"2025-01-15 04:33:23"
depName	string	科室名称	"妇科门诊"
invoiceNumber	string	发票号码	"1234567890"
invoicePrice	string	发票金额	"1234567890"
PdfLink	string	发票PDF下载链接	"https://example.com/invoice.pdf"

WARNING

• 发票PDF下载链接具体实施时候商议,是通过流传输还是通过base64编码,还是直接返回PDF链接前端通过链接访问下载

返回示例

{
  "errcode":0,
  "msg":"",
  "rcursor":[
    {
      "time": "2025-01-15 04:33:23",
      "depName": "妇科门诊",
      "invoiceNumber": "1234567890",
      "invoicePrice": "1234567890",
      "PdfLink": "https://example.com/invoice.pdf"
    },
    {
      "time": "2025-01-16 04:33:23",
      "depName": "产科门诊",
      "invoiceNumber": "1234567891",
      "invoicePrice": "1234567891",
      "PdfLink": "https://example.com/invoice.pdf"
    }
  ]
}