一花一世界，一叶一如来

# 简介

# 阅读对象

技术部门的开发、维护及管理人员，应具备以下基本知识：

  1. 了解HTTPS/HTTP协议等内容。
  2. 了解信息安全的基本概念。
  3. 了解计算机至少一种编程语言。

# 产品说明

本开发手册对该系统功能接口进行详细的描述，通过该指南可以对本系统有全面的了解，使技术人员尽快掌握本系统的接口，并能够在本系统上进行开发。

# 接口列表

# 1.嘉隆鉴权参数说明

每次调用受保护的 API 时，需在请求 URL 中附加以下三个鉴权参数：

参数名 类型 必填 说明
accessKey string 是 分配给调用方的唯一应用标识（即 appKey）
timestamp long 是 当前 Unix 时间戳（单位：毫秒）
sign string 是 签名字符串，用于验证请求合法性

# 2. 签名生成规则

# 2.1 签名内容格式

将以下字段按固定顺序拼接为一个字符串（注意顺序不能错）： accessKey={accessKey}&timestamp={timestamp}&secret={accessSecret}

其中：

  • {accessKey}：你的应用公钥（即 appKey）待分配
  • {timestamp}：当前时间戳（毫秒）
  • {accessSecret}：你的应用私钥（即 appSecret）待分配

⚠️ 注意：secret 是字面量，不是参数名，直接拼接 accessSecret 的值。

# 2.2 签名算法

对上述拼接后的字符串进行 MD5 摘要，并转换为 大写十六进制字符串。

Java 示例代码如下：

import org.apache.commons.codec.digest.DigestUtils;
import java.nio.charset.StandardCharsets;

private static String generateSign(String appKey, String appSecret, long timestamp) {
    String signContent = "accessKey=" + appKey + "&timestamp=" + timestamp + "&secret=" + appSecret;
    return DigestUtils.md5DigestAsHex(signContent.getBytes(StandardCharsets.UTF_8)).toUpperCase();
}
1
2
3
4
5
6
7

# 3. 请求 URL 拼接示例

https://api.example.com/data?accessKey=myAppKey123&timestamp=1705123456789&sign=A1B2C3D4E5F678901234567890ABCDEF
1

# 4、第三方调用嘉隆接口(第三方-->嘉隆)

# 4.1根据病症名称查询ICD-10疾病编码等信息

接口名称：搜索病症
接口描述：根据关键字模糊搜索ICD-10病症信息
1
2

# 接口URL

开发地址：http://118.126.82.244:18080/app-api/third/api/v2/disease/query (opens new window)

生产地址：

/api/v1/disease/query

# 请求方式

POST Content-Type：application/json

# 请求Body参数

{
    "keywords": "",
    "page": 1,
    "page_size": 10
}
1
2
3
4
5
参数名 示例值 参数类型 是否必选 参数描述
keywords 阑尾炎 String 是 病症名称
page 1 Integer 是 分页页码，数字类型
page_size 10 Integer 是 每页条数

# 成功响应示例

{
	"code": 0,
	"msg": "",
	"success": true,
	"data": {
		"count": 1381,
		"total_page": 139,
		"current_page": 1,
		"page_size": 10,
		"rows": [
			{
				"id": "4579",
				"code": "K30",
				"name": "消化不良"
			},
			{
				"id": "8006",
				"code": "R11",
				"name": "恶心和呕吐"
			},
			{
				"id": "4182",
				"code": "J20",
				"name": "急性支气管炎、小儿急性支气管炎"
			},
			{
				"id": "4528",
				"code": "K25",
				"name": "胃溃疡"
			},
			{
				"id": "4538",
				"code": "K26",
				"name": "十二指肠溃疡"
			},
			{
				"id": "4204",
				"code": "J31",
				"name": "慢性鼻炎、慢性鼻咽炎和咽炎、过敏性鼻炎"
			},
			{
				"id": "4112",
				"code": "J00",
				"name": "急性鼻咽炎［普通感冒］、小儿发烧、小儿感冒"
			},
			{
				"id": "2001",
				"code": "E10",
				"name": "I型糖尿病"
			},
			{
				"id": "2012",
				"code": "E11",
				"name": "II型糖尿病"
			},
			{
				"id": "4568",
				"code": "K29",
				"name": "慢性胃炎、胆汁返流性胃炎"
			}
		]
	}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
参数名 示例值 参数类型 参数描述
code - Number 返回码，0 代表请求成功，非 0 代表异常编码
msg success String 响应消息(这里特别注意，原来的接口返回的关键字是msg而非message)
data - Object 返回数据
data.count 1381 Number 总条数
data.total_page 139 Number 总页数
data.current_page 1 Number 当前页码
data.page_size 10 Number 每页条数
data.rows Object 病症列表
data.rows.id 4579 String 病症ID
data.rows.code K30 String 病症编码
data.rows.name 消化不良 String 病症名称

# 4.2 第三方发起问诊（现有接口）

接口名称：第三方发起问诊
接口描述：根据第三方传入的信息，发起在线问诊
1
2

# 接口URL

开发地址：http://118.126.82.244:18080/app-api/third/api/v2/inquiry/boot (opens new window)

生产地址：待发布

/api/v1/inquiry/boot

# 请求方式

POST Content-Type：application/json

# 请求Body参数

{
    "request_no": "PR0122051700001790",
    "user_id": "000024f930104386b56f3c109fa613d1",
    "name": "王朗",
    "mobile": "18000000001",
    "id_no": "110101198603077239",
    "cert_code": 1,
    "gender": "",
    "birthday": "",
    "pre_medical": "", 
    "allergy": "",
    "family_medical": "",
    "liver_function": 0,
    "renal_function": 0,
    "special": "",
    "chain_id": "397",
    "shop_code": "100094",
    "store_code": "100094",
    "backUrl": "http://localhost:8080/#/goods/placeOrder?cartItemIds=2108,2106&storeId=4561&chainId=397&goods=",
    "product_list": [
        {
            "product_code": "1111935",
            "name": "苯磺酸氨氯地平片",
            "blId": "0",
            "qty": 1,
            "is_rx": 1,
            "diseases_codes": [
                "R05",
                "K30"
            ]
        },
        {
            "product_code": "1270072",
            "name": "清凉油",
            "blId": "0",
            "qty": 2,
            "is_rx": 0,
            "diseases_codes": [
                "R05",
                "K30"
            ]
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
参数名 示例值 参数类型 是否必填 参数描述
request_no PR0122051700001790 String 是 处方预订单号
user_id 000024f930104386b56f3c109fa613d1 String 是 第三方的用户id
name 王朗 String 是 患者真实姓名
mobile 18000000001 String 是 患者手机号
id_no 110101198603077239 String 是 患者证件号
cert_code 1 Number 是 患者证件类型的编码,有以下枚举值, 请传数字 1 身份证, 2 护照, 3 军官证, 4 出生证, 5 其他, 6 外国人在华居住证, 7 异常身份证, 8 港澳回乡证, 9 户口本 , 10 警官证 , 11 台胞证 , 12 驾驶证, 13 港澳台居民居住证
gender Integer 是 cert_code不是1(身份证)时,需要提供患者性别, 枚举值为0=未知,1=男,2=女
birthday Date 是 cert_code不是1(身份证)时,需要提供患者生日, 格式YYYY-MM-DD
pre_medical String 是 患者过往病史,可多选, 可为空,以半角逗号分隔,枚举值有: 高血压,糖尿病,冠心病,乙肝,支气管炎,慢性阻塞性肺病,荨麻疹
allergy String 是 患者过敏史, 可多选, 可为空, 以半角都好分隔, 枚举值有: 青霉素, 阿司匹林, 螨尘, 花粉, 海鲜, 蛋白质(牛奶鸡蛋)
family_medical String 是 家族病史, 可多选, 可为空, 以半角都好分隔, 枚举值有: 高血压, 冠心病, 乙肝, 精神病, 哮喘, 白血病
liver_function 0 Number 是 肝功能是否异常 0=否 1=是
renal_function 0 Number 是 肾功能是否异常 0=否 1=是
special String 是 特殊人群, 可为空,半角都好分隔, 枚举值有: 备孕期,妊娠期,哺乳
chain_id 397 String 是 门店ID(用于查询商品库存使用)
shop_code 100094 String 是 门店唯一编码(chain_code)
store_code 100094 String 是 微商城的门店区域编码(用于区分唯一门店)
backUrl http://localhost:8080/#/goods/placeOrder?cartItemIds=2108,2106&storeId=4561&chainId=397&goods= (opens new window) String 是 第三方返回继续购药地址（可以不使用）
product_list Array 是 处方药的商品信息数组
product_list.product_code 1111935 String 是 第三方商品唯一编码
product_list.name 苯磺酸氨氯地平片 String 是 商品名称
product_list.blId 0 String 是 微商城组套ID
product_list.qty 1 Number 是 第三方商品购买数量
product_list.is_rx 1 Number 是 微商城的是否处方药标识,1=是,0=否
product_list.diseases_codes R05 Array 是 患者复诊选择的病症编码数组, 传入ICD-10的编码(code)

# 成功响应示例

{
	"code": 0,
	"msg": "",
	"success": true,
	"data": {
		"uid": "54003",
		"patient_id": "12007",
		"url": "https://m.jl.haowuda.cn/#/pages/inquiry/boot?request_no=PR1118102300000005&app_id=guoda_store"
	}
}
1
2
3
4
5
6
7
8
9
10
参数名 示例值 参数类型 参数描述
code 0 Number 返回码，0 代表请求成功，非 0 代表异常编码
msg 处方预订单号不能为空 String 响应消息(这里特别注意，原来的接口返回的关键字是msg而非message)
success false String 是否成功
data Object 业务数据字段标识
data.uid 54003 String 对应的嘉隆用户ID
data.patient_id 12007 String 患者ID
data.url https://m.jl.haowuda.cn/#/pages/inquiry/boot?request_no=PR1118102300000005&app_id=guoda_store (opens new window) String 嘉隆问诊H5的地址

# 4.3获取药品对应适应症信息

接口名称：查询药品适应症
接口描述：根据商品ID(productIds)或条形码(barcodes)获取药品对应的前10个适应症信息(多于10个按前10返回，不足按实际返回)
1
2

# 接口URL

开发地址：http://118.126.82.244:18080/app-api/third/api/v2/query/drug/indications (opens new window)

生产地址：待发布

/api/v2/query/drug/indications

# 请求方式

POST Content-Type：application/json

# 请求Body参数

{
    "productIds": ["2013314","2365694","2157461"],
    "barcodes": ["6901234567890","6901234567891"]
}
1
2
3
4
参数名 示例值 参数类型 是否必选 参数描述
productIds ["2013314","2365694","2157461"] List 否 请求查询的商品ID列表（与 barcodes 至少传一个）
barcodes ["6901234567890","6901234567891"] List 否 请求查询的药品条形码列表（与 productIds 至少传一个）

说明：

  • 仅传 productIds：按商品ID查询；
  • 仅传 barcodes：按条形码查询；
  • 同时传 productIds 与 barcodes：按并集查询并去重返回。

# 成功响应示例

{
    "code": 0,
    "msg": "success",
    "data": [
        {
            "productId": "2013314",
            "productName": "药品名称",
            "rows": [
                {
                    "code": "K30",
                    "name": "消化不良"
                },
                {
                    "code": "R11",
                    "name": "恶心和呕吐"
                },
                {
                    "code": "J20",
                    "name": "急性支气管炎、小儿急性支气管炎"
                }
            ]
        },
        {
            "productId": "2365694",
            "productName": "药品名称",
            "rows": [
                {
                    "code": "L27.9",
                    "name": "药物性皮炎"
                },
                {
                    "code": "L28.0",
                    "name": "慢性单纯性苔藓"
                }
            ]
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
参数名 示例值 参数类型 参数描述
code - Number 返回码，0 代表请求成功，非 0 代表异常编码
msg success String 响应消息(这里特别注意，原来的接口返回的关键字是msg而非message)
data - Object 返回数据
data.productId 2013314 String 药品商品ID（product_code）
data.productName 药品名称 String 药品名称
data.rows {} List 药品对应适应症信息
data.rows.code L27.9 String ICD-10适应症编码
data.rows.name 药物性皮炎 String 适应症名称

# 4.4 第三方传入用药人信息，问询信息生成处方（新增）

接口名称：传入用药人信息，问询信息生成处方
接口描述：第三方传入用药人信（包括姓名、身份证号、禁忌情况），用药问询记录后获取问诊处方
1
2

# 接口URL

开发地址：http://118.126.82.244:18080/app-api/third/api/v2/inquiry/pres-create (opens new window)

生产地址：待发布

/api/v2/inquiry/pres-create

# 请求方式

POST Content-Type：application/json

# 请求Body参数

{
    "request_no": "PR0122051700001790",
    "user_id": "000024f930104386b56f3c109fa613d1",
    "name": "王朗",
    "mobile": "18000000001",
    "id_no": "110101198603077239",
    "cert_code": 1,
    "gender": "",
    "birthday": "",
    "pre_medical": "", 
    "allergy": "",
    "family_medical": "",
    "liver_function": 0,
    "renal_function": 0,
    "special": "",
    "chain_id": "397",
    "shop_code": "100094",
    "store_code": "100094",
    "backUrl": "http://localhost:8080/#/goods/placeOrder?cartItemIds=2108,2106&storeId=4561&chainId=397&goods=",
    "product_list": [
        {
            "product_code": "1111935",
            "name": "苯磺酸氨氯地平片",
            "blId": "0",
            "qty": 1,
            "is_rx": 1,
            "diseases_codes": [
                "R05",
                "K30"
            ]
        },
        {
            "product_code": "1270072",
            "name": "清凉油",
            "blId": "0",
            "qty": 2,
            "is_rx": 0,
            "diseases_codes": [
                "R05",
                "K30"
            ]
        }
    ]
  "symptom_description": "病情描述",
  "first_visit_files":[{"url":"首诊文件URL地址","name":"血常规报告、诊断报告等","type":"文件类型：report-诊断报告，image-图片"}]
  "informed_qa_record": [
    {"question_key":"liver_abnormal","question":"肝功能异常？","answer":"否"},
    {"question_key":"kidney_abnormal","question":"肾功能异常？","answer":"否"},
    {"question_key":"pregnant","question":"是否孕妇？","answer":"否"},
    {"question_key":"lactating","question":"是否哺乳期？","answer":"否"},
    {"question_key":"allergy_history","question":"同类药过敏史？","answer":"否"}
  ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
参数名 示例值 参数类型 是否必填 参数描述
request_no PR0122051700001790 String 是 处方预订单号
user_id 000024f930104386b56f3c109fa613d1 String 是 第三方的用户id
name 王朗 String 是 患者真实姓名
mobile 18000000001 String 是 患者手机号
id_no 110101198603077239 String 是 患者证件号
cert_code 1 Number 是 患者证件类型的编码,有以下枚举值, 请传数字 1 身份证, 2 护照, 3 军官证, 4 出生证, 5 其他, 6 外国人在华居住证, 7 异常身份证, 8 港澳回乡证, 9 户口本 , 10 警官证 , 11 台胞证 , 12 驾驶证, 13 港澳台居民居住证
gender Integer 是 cert_code不是1(身份证)时,需要提供患者性别, 枚举值为0=未知,1=男,2=女
birthday Date 是 cert_code不是1(身份证)时,需要提供患者生日, 格式YYYY-MM-DD
pre_medical String 是 患者过往病史,可多选, 可为空,以半角逗号分隔,枚举值有: 高血压,糖尿病,冠心病,乙肝,支气管炎,慢性阻塞性肺病,荨麻疹
allergy String 是 患者过敏史, 可多选, 可为空, 以半角都好分隔, 枚举值有: 青霉素, 阿司匹林, 螨尘, 花粉, 海鲜, 蛋白质(牛奶鸡蛋)
family_medical String 是 家族病史, 可多选, 可为空, 以半角都好分隔, 枚举值有: 高血压, 冠心病, 乙肝, 精神病, 哮喘, 白血病
liver_function 0 Number 是 肝功能是否异常 0=否 1=是
renal_function 0 Number 是 肾功能是否异常 0=否 1=是
special String 是 特殊人群, 可为空,半角都好分隔, 枚举值有: 备孕期,妊娠期,哺乳
chain_id 397 String 是 门店ID
shop_code 100094 String 否 门店唯一编码(chain_code)
store_code 100094 String 否 门店区域编码
backUrl http://localhost:8080/#/goods/placeOrder?cartItemIds=2108,2106&storeId=4561&chainId=397&goods= (opens new window) String 是 第三方返回继续购药地址（可以不使用）
product_list Array 是 处方药的商品信息数组
product_list.product_code 1111935 String 是 第三方商品唯一编码
product_list.name 苯磺酸氨氯地平片 String 是 商品名称
product_list.blId 0 String 否 微商城组套ID（国药系才用）
product_list.qty 1 Number 是 第三方商品购买数量
product_list.is_rx 1 Number 是 是否处方药标识,1=是,0=否
product_list.diseases_codes R05 Array 是 患者复诊选择的病症编码数组, 传入ICD-10的编码(code)
symptom_description 病情描述 String 否 病情描述
first_visit_files 首诊文件项 Array 否 首诊文件项
first_visit_files.url 首诊文件项访问地址 String 否 首诊文件项访问地址
first_visit_files.name 首诊文件名称 String 否 血常规报告、诊断报告等
first_visit_files.type 文件类型 String 否 report-诊断报告，image-图片
informed_qa_record 问诊问询清单 Array 是
informed_qa_record.question_key 问询关键字 String 是 liver_abnormal,kidney_abnormal,pregnant,lactating,allergy_history
informed_qa_record.question String 是 肝功能异常？肾功能异常？是否孕妇？是否哺乳期？同类药过敏史？
informed_qa_record.answer String 是 是或者否

# 成功响应示例

{
    "code": 0,
    "msg": "success",
    "data": 
       {
          "productList": {
            "productListRX": [
              {
                "productId": "1111132",
                "number": 1,
                "blId": "0",
                "unit": "盒",
                "consume": "1",
                "consumeUnit": "盒",
                "frequency": "1次/天",
                "doseUnit": "片",
                "days": "1",
                "isRx": "true",
                "usagem": "口服",
                "specification":"规格"
              }
            ]
          },
          "userInfo": {
            "userId": "44022",
            "phone": "18521703XXX",
            "patientName": "张三",
            "patientSex": "女",
            "patientAge": "33",
            "cardNo": "4127211992030XXXXX",
            "birthDay": "1992-03-07"
          },
          "departName": "内科",
          "requestNo": "staging_TPO20260113000018",
          "doctorName": "郑XXX",
          "diagnose": "甲状腺功能减退症",
          "chainId": "66001",
          "state": "1",
          "refuseReason": "",
          "doctorAdvice": "",
          "diseasesNames": "甲状腺功能减退症",
          "storeCode": "122001-ali",
          "prescImageList": [
            "https://s1.jialongjk.com/pres/images/XXXX.pdf"
          ],
          "createTime": "2026-01-13 15:10:52",
          "JlCode": "202601131510520268242",
          "pres_doc_name": "X医生",
          "pres_time": "1768288252",
          "status": "2"
        }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

# 5.1.3 字段说明（嘉隆回调第三方）

说明：本节对应 5.1.2 请求JSON（嘉隆 -> 第三方回调），不是 4.4 入站接口响应。

字段名 所属模块 类型 示例值 说明
requestNo 处方基本信息 string staging_TPO20260113000018 第三方请求编号（处方预订单号）
createTime 处方基本信息 date 2026-01-13 15:10:52 处方创建时间（序列化格式以实际回调为准）
JlCode 处方基本信息 string 202601131510520268242 嘉隆系统内部处方编码
pres_time 处方基本信息 string 1768288252 处方生成 Unix 时间戳（秒）
status 处方基本信息 string "2" 处方状态（当前回调固定为 "2"）
state 处方基本信息 string "1" 开方结果（1=成功，0=拒绝）
refuseReason 处方基本信息 string "" 拒绝原因（空表示未拒绝）
doctorAdvice 处方基本信息 string "" 医嘱
doctorName 医生与科室 string 郑建杰 开方医生姓名
pres_doc_name 医生与科室 string 郑建杰 医生姓名（冗余字段）
departName 医生与科室 string 内科 就诊科室名称
userInfo.userId 患者信息 string 44022 用户平台ID
userInfo.phone 患者信息 string 18521703685 患者手机号
userInfo.patientName 患者信息 string 刘宁X 患者姓名
userInfo.patientSex 患者信息 string 女 患者性别
userInfo.patientAge 患者信息 string 33 患者年龄（字符串）
userInfo.birthDay 患者信息 string 1992-03-07 出生日期
userInfo.cardNo 患者信息 string 412721199203071060 身份证号
diagnose 诊断信息 string 甲状腺功能减退症 主诊断结果
diseasesNames 诊断信息 string 甲状腺功能减退症 疾病名称（兼容多病种）
productList.productListRX[].productId 药品信息 string 1111132 药品ID/商品编码
productList.productListRX[].number 药品信息 int 1 开药数量
productList.productListRX[].blId 药品信息 int 0 批次/组合活动ID（0 表示未指定）
productList.productListRX[].unit 药品信息 string 盒 药品包装单位
productList.productListRX[].consume 药品信息 string "1" 单次/单日用量（按对接约定）
productList.productListRX[].consumeUnit 药品信息 string 盒 用量单位
productList.productListRX[].frequency 药品信息 string 1次/天 用药频次
productList.productListRX[].doseUnit 药品信息 string 片 剂量单位
productList.productListRX[].days 药品信息 string "1" 用药天数
productList.productListRX[].isRx 药品信息 string "true" 是否处方药（true/false）
productList.productListRX[].usagem 药品信息 string 口服 用法（如口服、外用等）
productList.productListRX[].specification 药品信息 string 规格信息 规格描述
productList.productListOTC 药品信息 array [] 非处方药集合（当前固定返回空数组）
storeCode 门店与渠道 string 122001-ali 门店编码（含渠道标识）
chainId 门店与渠道 string 66001 连锁药店ID（merchant_id）
prescImageList 处方图片 array ["https://s1.jialongjk.com/pres/images/XXXX.jpg"] 处方图片URL列表

# 4.5 第三方药店分页查询（新增）

接口名称：第三方药店分页查询
接口描述：根据当前 accessKey 对应商户，分页查询药店列表（hospital_pharmacy）
1
2

# 接口URL

开发地址：http://118.126.82.244:18080/app-api/third/api/v2/pharmacy/query (opens new window)

生产地址：待发布

/api/v2/pharmacy/query

# 请求方式

POST Content-Type：application/json

# 请求Body参数

{
  "keywords": "大药房",
  "page": 1,
  "page_size": 10
}
1
2
3
4
5
参数名 示例值 参数类型 是否必填 参数描述
keywords 大药房 String 否 关键字（支持药店名称/编码）
page 1 Integer 否 页码，默认 1
page_size 10 Integer 否 每页条数，默认 10

# 成功响应示例

{
  "code": 0,
  "msg": "",
  "success": true,
  "data": {
    "count": 2,
    "total_page": 1,
    "current_page": 1,
    "page_size": 10,
    "rows": [
      {
        "id": 10001,
        "code": "100094",
        "name": "嘉隆大药房（测试店）",
        "manager_name": "张店长",
        "phone": "13800000000",
        "detail_address": "北京市朝阳区xxx路xx号",
        "status": 0
      },
      {
        "id": 10002,
        "code": "100095",
        "name": "嘉隆大药房（分店）",
        "manager_name": "李店长",
        "phone": "13900000000",
        "detail_address": "北京市海淀区xxx路xx号",
        "status": 0
      }
    ]
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
参数名 示例值 参数类型 参数描述
code 0 Number 返回码，0 表示成功
msg String 响应消息
success true Boolean 是否成功
data - Object 返回数据
data.count 2 Number 总条数
data.total_page 1 Number 总页数
data.current_page 1 Number 当前页码
data.page_size 10 Number 每页条数
data.rows - Array 药店列表
data.rows.id 10001 Number 药店ID
data.rows.code 100094 String 药店编码
data.rows.name 嘉隆大药房（测试店） String 药店名称
data.rows.manager_name 张店长 String 负责人姓名
data.rows.phone 13800000000 String 联系电话
data.rows.detail_address 北京市朝阳区xxx路xx号 String 药店详细地址
data.rows.status 0 Integer 药店状态（0-正常，1-禁用）

# 4.6 第三方处方分页查询（新增）

接口名称：第三方处方分页查询
接口描述：根据 pharmacy_id 分页查询处方列表；列表项字段尽量与 /inquiry/pres-create 保持一致
1
2

# 接口URL

开发地址：http://118.126.82.244:18080/app-api/third/api/v2/prescription/page (opens new window)

生产地址：待发布

/api/v2/prescription/page

# 请求方式

POST Content-Type：application/json

# 请求Body参数

{
  "pharmacy_id": 10001,
  "prescription_no": "No2026",
  "year": 2026,
  "page": 1,
  "page_size": 10
}
1
2
3
4
5
6
7
参数名 示例值 参数类型 是否必填 参数描述
pharmacy_id 10001 Long 是 药店ID（必须属于当前 accessKey 对应商户）
prescription_no No2026 String 否 处方单号（模糊查询）
year 2026 Integer 否 年份（按年分表查询；不传默认当前年）
page 1 Integer 否 页码，默认 1
page_size 10 Integer 否 每页条数，默认 10，最大 50

# 成功响应示例

{
  "code": 0,
  "msg": "",
  "success": true,
  "data": {
    "count": 1,
    "total_page": 1,
    "current_page": 1,
    "page_size": 10,
    "rows": [
      {
        "productList": {
          "productListOTC": [],
          "productListRX": [
            {
              "productId": "1111935",
              "number": 1,
              "blId": "0",
              "isRx": "true",
              "specification": "7片"
            }
          ]
        },
        "userInfo": {
          "userId": "54003",
          "phone": "18000000001",
          "patientName": "王朗",
          "patientSex": "男",
          "birthDay": "1986-03-07",
          "cardNo": "110101198603077239"
        },
        "requestNo": "PR0122051700001790",
        "doctorName": "李医生",
        "diagnose": "高血压",
        "chainId": "10001",
        "state": "1",
        "refuseReason": "",
        "doctorAdvice": "",
        "diseasesNames": "高血压",
        "storeCode": "10001",
        "prescImageList": [
          "https://s1.jialongjk.com/pres/images/XXXX.pdf"
        ],
        "createTime": "2026-06-02 20:00:00",
        "JlCode": "No2026060220000012345",
        "pres_doc_name": "李医生",
        "pres_time": "1780392000",
        "status": "2",
        "uid": "54003",
        "patient_id": "12007"
      }
    ]
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

# 返回参数说明

参数名 示例值 参数类型 参数描述
code 0 Number 返回码，0 表示成功
msg String 响应消息
success true Boolean 是否成功
data - Object 返回数据
data.count 1 Number 总条数
data.total_page 1 Number 总页数
data.current_page 1 Number 当前页码
data.page_size 10 Number 每页条数
data.rows - Array 处方列表
data.rows.requestNo PR0122051700001790 String 第三方请求单号
data.rows.doctorName 李医生 String 医生姓名
data.rows.diagnose 高血压 String 诊断结果
data.rows.state 1 String 开方结果（1=开方成功，0=拒绝开方）
data.rows.refuseReason String 拒绝原因
data.rows.doctorAdvice String 医嘱
data.rows.storeCode 10001 String 门店编码
data.rows.prescImageList ["https://.../XXXX.pdf"] Array 处方图片/PDF地址列表
data.rows.createTime 2026-06-02 20:00:00 String 处方创建时间
data.rows.JlCode No2026060220000012345 String 嘉隆处方单号
data.rows.pres_doc_name 李医生 String 开方医生姓名（冗余字段）
data.rows.pres_time 1780392000 String 开方时间戳（秒）
data.rows.status 2 String 处方状态（2=已开方）
data.rows.uid 54003 String 嘉隆用户ID
data.rows.patient_id 12007 String 嘉隆患者ID
data.rows.productList.productListRX - Array 处方药列表
data.rows.productList.productListOTC - Array 非处方药列表
data.rows.productList.productListRX[] - Object 药品项
data.rows.productList.productListRX[].productId 1111935 String 商品编码
data.rows.productList.productListRX[].number 1 Number 数量
data.rows.productList.productListRX[].blId 0 String 组套标识
data.rows.productList.productListRX[].isRx true String 是否处方药（true/false）
data.rows.productList.productListRX[].specification 7片 String 规格
data.rows.userInfo - Object 患者信息
data.rows.userInfo.userId 54003 String 用户ID
data.rows.userInfo.phone 18000000001 String 手机号
data.rows.userInfo.patientName 王朗 String 患者姓名
data.rows.userInfo.patientSex 男 String 患者性别
data.rows.userInfo.birthDay 1986-03-07 String 出生日期
data.rows.userInfo.cardNo 110101198603077239 String 身份证号

# 5、嘉隆回调第三方接口(嘉隆-->第三方)

  • 生产域名：
  • 测试域名：

# 5.1 处方药单信息同步

# 5.1.1 基础信息

URL: /api/item/service/provider/JL/prescSync

方式:POST

# 5.1.2 请求JSON

{
  "productList": {
    "productListRX": [
      {
        "productId": "1111132",
        "number": 1,
        "blId": "0",
        "unit": "盒",
        "consume": "1",
        "consumeUnit": "盒",
        "frequency": "1次/天",
        "doseUnit": "片",
        "days": "1",
        "isRx": "true",
        "usagem": "口服",
        "specification":"规格"
      }
    ]
  },
  "userInfo": {
    "userId": "44022",
    "phone": "18521703XXX",
    "patientName": "张三",
    "patientSex": "女",
    "patientAge": "33",
    "cardNo": "4127211992030XXXXX",
    "birthDay": "1992-03-07"
  },
  "departName": "内科",
  "requestNo": "staging_TPO20260113000018",
  "doctorName": "郑XXX",
  "diagnose": "甲状腺功能减退症",
  "chainId": "66001",
  "state": "1",
  "refuseReason": "",
  "doctorAdvice": "",
  "diseasesNames": "甲状腺功能减退症",
  "storeCode": "122001-ali",
  "prescImageList": [
    "https://s1.jialongjk.com/pres/images/XXXX.jpg"
  ],
  "createTime": "2026-01-13 15:10:52",
  "JlCode": "202601131510520268242",
  "pres_doc_name": "X医生",
  "pres_time": "1768288252",
  "status": "2"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

# 5.1.3 字段说明

字段名 所属模块 类型 示例值 说明
requestNo 处方基本信息 string staging_TPO20260113000018 处方请求编号（唯一标识）
createTime 处方基本信息 string 2026-01-13 15:10:52 处方创建时间（YYYY-MM-DD HH:mm:ss）
JlCode 处方基本信息 string 202601131510520268242 嘉龙系统内部处方编码
pres_time 处方基本信息 string 1768288252 处方生成 Unix 时间戳（秒）
status 处方基本信息 string "2" 处方状态（如：2=已开方）
state 处方基本信息 string "1" 审核状态（1=正常/通过）
refuseReason 处方基本信息 string "" 拒绝原因（空表示未拒绝）
doctorAdvice 处方基本信息 string "" 医生附加建议
doctorName 医生与科室 string 郑建杰 开方医生姓名
pres_doc_name 医生与科室 string 郑建杰 医生姓名（冗余字段）
departName 医生与科室 string 内科 就诊科室名称
userId 患者信息 string 44022 用户平台ID
phone 患者信息 string 18521703685 患者手机号
patientName 患者信息 string 刘宁X 患者姓名
patientSex 患者信息 string 女 患者性别
patientAge 患者信息 string 33 患者年龄（字符串）
birthDay 患者信息 string 1992-03-07 出生日期
cardNo 患者信息 string 412721199203071060 身份证号
diagnose 诊断信息 string 甲状腺功能减退症 主诊断结果
diseasesNames 诊断信息 string 甲状腺功能减退症 疾病名称（兼容多病种）
productId 药品信息 string 1111132 药品ID
number 药品信息 int 1 开药总数量
blId 药品信息 string "0" 批次/库存ID（0 表示未指定）
unit 药品信息 string 盒 药品包装单位
consume 药品信息 string "1" 单日消耗量
consumeUnit 药品信息 string 盒 消耗单位
frequency 药品信息 string 1次/天 用药频次
doseUnit 药品信息 string 片 单次剂量单位
days 药品信息 string "1" 用药天数
isRx 药品信息 string "true" 是否为处方药（true/false）
usagem 药品信息 string 口服 用法（如口服、外用等）
specification 药品信息 string 规格信息 50 g*100T
storeCode 门店与渠道 string 122001-ali 门店编码（含渠道标识）
chainId 门店与渠道 string 66001 连锁药店ID
prescImageList 处方图片 array "[https://s1.jialongjk.com/..."] (opens new window) 处方图片URL列表