本文档仅包含以下 8 个接口:
| 序号 | 模块 | 接口 | 方法 | 说明 |
|---|---|---|---|---|
| 1 | 妇科档案 | /smartor/maternityArchive/selectPatMaternityArchiveList |
POST | 查询妇科档案列表 |
| 2 | 妇科档案 | /smartor/maternityArchive/insertOrUpdateMaternityArchive |
POST | 新增或修改妇科档案 |
| 3 | 妇科档案 | /smartor/maternityArchive/batchDelete |
POST | 批量删除妇科档案(含详情) |
| 4 | 妇科档案详情 | /smartor/maternityArchiveDetail/getInfo/{archiveid} |
GET | 获取妇科档案详情 |
| 5 | 儿科档案 | /smartor/childArchive/selectPatChildArchiveList |
POST | 查询儿科档案列表 |
| 6 | 儿科档案 | /smartor/childArchive/insertOrUpdateChildArchive |
POST | 新增或修改儿科档案 |
| 7 | 儿科档案 | /smartor/childArchive/batchDelete |
POST | 批量删除儿科档案(含详情) |
| 8 | 儿科档案详情 | /smartor/childArchiveDetail/getInfo/{archiveid} |
GET | 获取儿科档案详情 |
http://服务IP:端口(默认开发环境为 http://localhost:8080)Authorization: Bearer {token}Content-Type: application/json| 字段 | 类型 | 说明 |
|---|---|---|
| total | long | 总记录数 |
| rows | array | 数据列表 |
| code | int | 状态码,200 为成功 |
| msg | string | 提示信息,如“查询成功” |
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码,200 为成功,500 为失败 |
| msg | string | 提示信息,如“操作成功”、“操作失败” |
| data | object | 业务数据(可能为空) |
POST /smartor/maternityArchive/selectPatMaternityArchiveListdel_flag = '0')。请求体(JSON,全部可选)
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| pageNum | Integer | 否 | 页码(分页时必填) |
| pageSize | Integer | 否 | 每页条数(分页时必填) |
| archiveType | String | 否 | 档案类型:1 早孕关爱,2 围绝经期MHI |
| outhospno | String | 否 | 门诊编号(精确匹配) |
| inhospno | String | 否 | 住院编号(精确匹配) |
| serialnum | String | 否 | 流水号(精确匹配) |
| patid | Long | 否 | 患者ID |
| patname | String | 否 | 患者姓名(模糊匹配) |
| parentname | String | 否 | 家长姓名(模糊匹配) |
| birthdate | Date | 否 | 出生日期 |
| idcardno | String | 否 | 证件号码(精确匹配) |
| phone | String | 否 | 联系电话(精确匹配) |
| diagTime | Date | 否 | 诊断时间 |
| plannedFollowTime | Date | 否 | 拟随访时间 |
| followupCycleTimes | String | 否 | 随访周期(次数) |
| sex | Long | 否 | 性别:1 男,2 女 |
| doctorCode | String | 否 | 主治医生(精确匹配) |
| doctorName | String | 否 | 主治医生姓名(模糊匹配) |
| managementDoctorCode | String | 否 | 经管医生(精确匹配) |
| managementDoctorName | String | 否 | 经管医生姓名(模糊匹配) |
| deptcode | String | 否 | 科室编号(精确匹配) |
| deptname | String | 否 | 科室名称(模糊匹配) |
| wardcode | String | 否 | 病区编号(精确匹配) |
| wardname | String | 否 | 病区名称(模糊匹配) |
| icd10code | String | 否 | 诊断ID(精确匹配) |
| diagname | String | 否 | 诊断名称(模糊匹配) |
| pregnancySituation | String | 否 | 妊娠情况 |
| closeStatus | String | 否 | 结案状态 |
| registerUser | String | 否 | 登记人员 |
| orgid | String | 否 | 医院机构ID(后端按登录用户自动注入) |
| campusid | String | 否 | 院区ID(后端按登录用户自动注入) |
| params.beginTime | String | 否 | 建档时间范围开始,格式 yyyy-MM-dd |
| params.endTime | String | 否 | 建档时间范围结束,格式 yyyy-MM-dd |
请求示例
{
"pageNum": 1,
"pageSize": 10,
"patname": "张",
"archiveType": "1"
}
响应示例
{
"code": 200,
"msg": "查询成功",
"total": 1,
"rows": [
{
"id": 1001,
"archiveType": "1",
"outhospno": "MZ20261001001",
"inhospno": null,
"serialnum": "LS20261001001",
"patid": 9001,
"patname": "张三",
"parentname": null,
"birthdate": "1995-06-01 00:00:00",
"idcardno": "330102199506010022",
"phone": "13800000000",
"diagTime": "2026-10-01 09:30:00",
"archiveTime": "2026-10-01 10:00:00",
"plannedFollowTime": "2026-11-01 00:00:00",
"followupCycleTimes": "4",
"sex": 2,
"doctorCode": "D001",
"doctorName": "李医生",
"managementDoctorCode": "D002",
"managementDoctorName": "王医生",
"deptcode": "FK",
"deptname": "妇科",
"wardcode": null,
"wardname": null,
"icd10code": "O20.0",
"diagname": "先兆流产",
"pregnancySituation": "孕12周",
"closeStatus": "0",
"registerUser": "李医生",
"orgid": "1",
"campusid": "1",
"delFlag": "0"
}
]
}
POST /smartor/maternityArchive/insertOrUpdateMaternityArchivearchiveid(或详情有 id 且能反查)且存在时更新,否则新增。data 为妇科档案主表ID。请求体(JSON)
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | Long | 否 | 妇科档案详情主键ID(更新详情时传入) |
| archiveid | Long | 否 | 妇科档案主表ID(更新主表时传入) |
| archiveType | String | 否 | 档案类型:1 早孕关爱,2 围绝经期MHI |
| sourceType | String | 否 | 来源类型:1 门诊接诊,2 住院随访,3 手工新增 |
| sourceBizId | Long | 否 | 来源业务ID:门诊记录ID/住院记录ID |
| sourceBizNo | String | 否 | 来源业务编号:门诊号/住院号 |
| sourceSubId | Long | 否 | 来源随访子任务ID:住院随访生成时为 service_subtask.id |
| outhospno | String | 否 | 门诊编号 |
| inhospno | String | 否 | 住院编号 |
| serialnum | String | 否 | 流水号 |
| patid | Long | 否 | 患者ID |
| patname | String | 否 | 患者姓名 |
| birthdate | Date | 否 | 出生日期,格式 yyyy-MM-dd HH:mm:ss |
| idcardno | String | 否 | 证件号码 |
| phone | String | 否 | 联系电话 |
| diagTime | Date | 否 | 诊断时间 |
| archiveTime | Date | 否 | 建档时间 |
| plannedFollowTime | Date | 否 | 拟随访时间 |
| sex | Long | 否 | 性别:1 男,2 女 |
| doctorCode | String | 否 | 主治医生 |
| doctorName | String | 否 | 主治医生姓名 |
| managementDoctorCode | String | 否 | 经管医生 |
| managementDoctorName | String | 否 | 经管医生姓名 |
| deptcode | String | 否 | 科室编号 |
| deptname | String | 否 | 科室名称 |
| wardcode | String | 否 | 病区编号 |
| wardname | String | 否 | 病区名称 |
| icd10code | String | 否 | 诊断ID |
| diagname | String | 否 | 诊断名称 |
| pregnancySituation | String | 否 | 妊娠情况 |
| specificSituation | String | 否 | 具体情况 |
| handleSuggestion | String | 否 | 处理建议 |
| closeStatus | String | 否 | 结案状态 |
| isRecordEstablished | String | 否 | 是否建册:0 否,1 是 |
| dueDate | Date | 否 | 预产期 |
| registerUser | String | 否 | 登记人员 |
| followupPeriod | String | 否 | 随访周期 |
| followupCycleTimes | String | 否 | 随访周期(次数) |
| lastMenstrualTime | Date | 否 | 末次月经 |
| firstDoctorCode | String | 否 | 首诊医生 |
| firstDoctorName | String | 否 | 首诊医生姓名 |
| contactPhone | String | 否 | 联系人联系电话 |
| address | String | 否 | 居住地址 |
| epEarlyPregnancyFollowupForm | String | 否 | 早孕关爱-早孕随访表 |
| mhiMenopauseFollowupSystemIssuesForm | String | 否 | 围绝经期MHI-更年期随访系统问题表 |
| mhiMhtInitialVisitMedicalRecordForm | String | 否 | 围绝经期MHI-MHT首诊病历表 |
| mhiMhtFollowUpMedicalRecordForm | String | 否 | 围绝经期MHI-MHT复诊病历表 |
| mhiModifiedKuppermanScoringScaleForm | String | 否 | 围绝经期MHI-改良Kupperman评分标准表 |
| mhiMenopauseRatingScaleForm | String | 否 | 围绝经期MHI-更年期评定量表(MRS) |
| mhiPittsburghSleepQualityIndexForm | String | 否 | 围绝经期MHI-匹兹堡睡眠质量指数量表(PSQI) |
| remark | String | 否 | 备注 |
| orgid | String | 否 | 医院机构ID(后端按登录用户自动覆盖) |
| campusid | String | 否 | 院区ID(后端按登录用户自动覆盖) |
| delFlag | String | 否 | 删除标志:0 未删除,1 已删除(默认 0) |
请求示例(新增)
{
"archiveType": "1",
"patid": 9001,
"patname": "张三",
"birthdate": "1995-06-01 00:00:00",
"idcardno": "330102199506010022",
"phone": "13800000000",
"diagTime": "2026-10-01 09:30:00",
"archiveTime": "2026-10-01 10:00:00",
"sex": 2,
"deptcode": "FK",
"deptname": "妇科",
"pregnancySituation": "孕12周",
"closeStatus": "0"
}
响应示例
{
"code": 200,
"msg": "操作成功",
"data": 1001
}
POST /smartor/maternityArchive/batchDeletedel_flag 置为 1),两步在同一事务中。请求体(JSON)
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ids | Long[] | 是 | 妇科档案主表ID数组 |
请求示例
[1001, 1002, 1003]
响应示例
{
"code": 200,
"msg": "操作成功"
}
GET /smartor/maternityArchiveDetail/getInfo/{archiveid}del_flag = '0'),返回第一条详情记录;无数据时 data 为 null。路径参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| archiveid | Long | 是 | 妇科档案主表ID(pat_maternity_archive.id) |
响应示例
{
"code": 200,
"msg": "操作成功",
"data": {
"id": 5001,
"archiveid": 1001,
"archiveType": "1",
"sourceType": "1",
"outhospno": "MZ20261001001",
"inhospno": null,
"serialnum": "LS20261001001",
"patid": 9001,
"patname": "张三",
"birthdate": "1995-06-01 00:00:00",
"idcardno": "330102199506010022",
"phone": "13800000000",
"diagTime": "2026-10-01 09:30:00",
"archiveTime": "2026-10-01 10:00:00",
"plannedFollowTime": "2026-11-01 00:00:00",
"sex": 2,
"doctorCode": "D001",
"doctorName": "李医生",
"managementDoctorCode": "D002",
"managementDoctorName": "王医生",
"deptcode": "FK",
"deptname": "妇科",
"wardcode": null,
"wardname": null,
"icd10code": "O20.0",
"diagname": "先兆流产",
"pregnancySituation": "孕12周",
"specificSituation": "具体情况",
"handleSuggestion": "注意休息",
"closeStatus": "0",
"isRecordEstablished": "1",
"dueDate": "2027-03-20 00:00:00",
"registerUser": "李医生",
"followupPeriod": "每月",
"followupCycleTimes": "4",
"lastMenstrualTime": "2026-06-10 00:00:00",
"firstDoctorCode": "D001",
"firstDoctorName": "李医生",
"contactPhone": "13900000000",
"address": "杭州市西湖区",
"orgid": "1",
"campusid": "1",
"delFlag": "0"
}
}
返回对象
data为妇科档案详情对象,字段说明同 2.2 请求体字段。
POST /smartor/childArchive/selectPatChildArchiveListdel_flag = '0')。请求体(JSON,全部可选)
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| pageNum | Integer | 否 | 页码(分页时必填) |
| pageSize | Integer | 否 | 每页条数(分页时必填) |
| archiveType | String | 否 | 档案类型:1 营养性疾病,2 学习困难,3 高危儿专案 |
| outhospno | String | 否 | 门诊编号(精确匹配) |
| inhospno | String | 否 | 住院编号(精确匹配) |
| serialnum | String | 否 | 流水号(精确匹配) |
| patid | Long | 否 | 患者ID |
| patname | String | 否 | 患者姓名(模糊匹配) |
| parentname | String | 否 | 家长姓名(模糊匹配) |
| birthdate | Date | 否 | 出生日期 |
| idcardno | String | 否 | 证件号码(精确匹配) |
| phone | String | 否 | 联系电话(精确匹配) |
| diagTime | Date | 否 | 诊断时间 |
| plannedFollowTime | Date | 否 | 拟随访时间 |
| followupCycleTimes | String | 否 | 随访周期(次数) |
| sex | Long | 否 | 性别:1 男,2 女 |
| doctorCode | String | 否 | 主治医生(精确匹配) |
| doctorName | String | 否 | 主治医生姓名(模糊匹配) |
| managementDoctorCode | String | 否 | 经管医生(精确匹配) |
| managementDoctorName | String | 否 | 经管医生姓名(模糊匹配) |
| deptcode | String | 否 | 科室编号(精确匹配) |
| deptname | String | 否 | 科室名称(模糊匹配) |
| wardcode | String | 否 | 病区编号(精确匹配) |
| wardname | String | 否 | 病区名称(模糊匹配) |
| icd10code | String | 否 | 诊断ID(精确匹配) |
| diagname | String | 否 | 诊断名称(模糊匹配) |
| closeStatus | String | 否 | 结案状态 |
| registerUser | String | 否 | 登记人员 |
| orgid | String | 否 | 医院机构ID(后端按登录用户自动注入) |
| campusid | String | 否 | 院区ID(后端按登录用户自动注入) |
| params.beginTime | String | 否 | 建档时间范围开始,格式 yyyy-MM-dd |
| params.endTime | String | 否 | 建档时间范围结束,格式 yyyy-MM-dd |
请求示例
{
"pageNum": 1,
"pageSize": 10,
"patname": "王",
"archiveType": "1"
}
响应示例
{
"code": 200,
"msg": "查询成功",
"total": 1,
"rows": [
{
"id": 2001,
"archiveType": "1",
"outhospno": "MZ20261001002",
"inhospno": null,
"serialnum": "LS20261001002",
"patid": 9002,
"patname": "王小宝",
"parentname": "王强",
"birthdate": "2023-01-15 00:00:00",
"idcardno": null,
"phone": "13800000001",
"diagTime": "2026-10-01 09:00:00",
"archiveTime": "2026-10-01 09:30:00",
"plannedFollowTime": "2026-11-01 00:00:00",
"followupCycleTimes": "3",
"sex": 1,
"doctorCode": "D003",
"doctorName": "赵医生",
"managementDoctorCode": "D004",
"managementDoctorName": "孙医生",
"deptcode": "EK",
"deptname": "儿科",
"wardcode": null,
"wardname": null,
"icd10code": "E44.0",
"diagname": "中度营养不良",
"closeStatus": "0",
"registerUser": "赵医生",
"orgid": "1",
"campusid": "1",
"delFlag": "0"
}
]
}
POST /smartor/childArchive/insertOrUpdateChildArchivearchiveid(或详情有 id 且能反查)且存在时更新,否则新增。data 为儿科档案主表ID。请求体(JSON)
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | Long | 否 | 儿科档案详情主键ID(更新详情时传入) |
| archiveid | Long | 否 | 儿科档案主表ID(更新主表时传入) |
| archiveType | String | 否 | 档案类型:1 营养性疾病,2 学习困难,3 高危儿专案 |
| sourceType | String | 否 | 来源类型:1 门诊接诊,2 住院随访,3 手工新增 |
| sourceBizId | Long | 否 | 来源业务ID:门诊记录ID/住院记录ID |
| sourceBizNo | String | 否 | 来源业务编号:门诊号/住院号 |
| sourceSubId | Long | 否 | 来源随访子任务ID:住院随访生成时为 service_subtask.id |
| outhospno | String | 否 | 门诊编号 |
| inhospno | String | 否 | 住院编号 |
| serialnum | String | 否 | 流水号 |
| patid | Long | 否 | 患者ID |
| patname | String | 否 | 患者姓名 |
| parentname | String | 否 | 家长姓名 |
| parentRelation | String | 否 | 家长与儿童关系 |
| parentPhone | String | 否 | 家长联系电话 |
| parentIdcardno | String | 否 | 家长证件号码 |
| parentAddress | String | 否 | 家长联系地址 |
| birthdate | Date | 否 | 出生日期,格式 yyyy-MM-dd HH:mm:ss |
| idcardno | String | 否 | 证件号码 |
| phone | String | 否 | 联系电话 |
| diagTime | Date | 否 | 诊断时间 |
| archiveTime | Date | 否 | 建档时间 |
| sex | Long | 否 | 性别:1 男,2 女 |
| doctorCode | String | 否 | 主治医生 |
| doctorName | String | 否 | 主治医生姓名 |
| managementDoctorCode | String | 否 | 经管医生 |
| managementDoctorName | String | 否 | 经管医生姓名 |
| deptcode | String | 否 | 科室编号 |
| deptname | String | 否 | 科室名称 |
| wardcode | String | 否 | 病区编号 |
| wardname | String | 否 | 病区名称 |
| icd10code | String | 否 | 诊断ID |
| diagname | String | 否 | 诊断名称 |
| nutritionIcd10Code | String | 否 | 营养性疾病ID |
| nutritionDiagName | String | 否 | 营养性疾病名称 |
| ndPhysicalMeasurements | String | 否 | 营养性疾病-体格测量 |
| ndDietaryAssessment | String | 否 | 营养性疾病-膳食评估 |
| ndInterventionProgram | String | 否 | 营养性疾病-干预方案 |
| appointmentSituation | String | 否 | 学习困难-预约情况 |
| ldLearningAbilityAssessment | String | 否 | 学习困难-学习能力评估 |
| ldBehavioralAssessment | String | 否 | 学习困难-行为评估 |
| ldInterventionTrainingRecord | String | 否 | 学习困难-干预训练记录 |
| highRiskChildType | String | 否 | 高危儿专案-高危儿分类 |
| highRiskChildName | String | 否 | 高危儿专案-高危儿名称 |
| plannedFollowTime | Date | 否 | 高危儿专案-拟随访时间 |
| hrcGrowthDevelopmentMonitoring | String | 否 | 高危儿专案-生长发育检测 |
| hrcNeurologicalEvaluation | String | 否 | 高危儿专案-神经系统评估 |
| hrcInterventionRecords | String | 否 | 高危儿专案-干预记录 |
| closeStatus | String | 否 | 结案状态 |
| gestationalWeek | BigDecimal | 否 | 出生孕周 |
| birthWeight | BigDecimal | 否 | 出生体重(kg) |
| registerUser | String | 否 | 登记人员 |
| remark | String | 否 | 备注 |
| orgid | String | 否 | 医院机构ID(后端按登录用户自动覆盖) |
| campusid | String | 否 | 院区ID(后端按登录用户自动覆盖) |
| delFlag | String | 否 | 删除标志:0 未删除,1 已删除(默认 0) |
请求示例(新增)
{
"archiveType": "1",
"patid": 9002,
"patname": "王小宝",
"parentname": "王强",
"parentRelation": "父子",
"parentPhone": "13900000001",
"birthdate": "2023-01-15 00:00:00",
"phone": "13800000001",
"diagTime": "2026-10-01 09:00:00",
"archiveTime": "2026-10-01 09:30:00",
"sex": 1,
"deptcode": "EK",
"deptname": "儿科",
"icd10code": "E44.0",
"diagname": "中度营养不良",
"nutritionIcd10Code": "E44.0",
"nutritionDiagName": "中度营养不良",
"closeStatus": "0"
}
响应示例
{
"code": 200,
"msg": "操作成功",
"data": 2001
}
POST /smartor/childArchive/batchDeletedel_flag 置为 1),两步在同一事务中。请求体(JSON)
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ids | Long[] | 是 | 儿科档案主表ID数组 |
请求示例
[2001, 2002, 2003]
响应示例
{
"code": 200,
"msg": "操作成功"
}
GET /smartor/childArchiveDetail/getInfo/{archiveid}del_flag = '0'),返回第一条详情记录;无数据时 data 为 null。路径参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| archiveid | Long | 是 | 儿科档案主表ID(pat_child_archive.id) |
响应示例
{
"code": 200,
"msg": "操作成功",
"data": {
"id": 6001,
"archiveid": 2001,
"archiveType": "1",
"sourceType": "1",
"outhospno": "MZ20261001002",
"inhospno": null,
"serialnum": "LS20261001002",
"patid": 9002,
"patname": "王小宝",
"parentname": "王强",
"parentRelation": "父子",
"parentPhone": "13900000001",
"parentIdcardno": null,
"parentAddress": "杭州市拱墅区",
"birthdate": "2023-01-15 00:00:00",
"idcardno": null,
"phone": "13800000001",
"diagTime": "2026-10-01 09:00:00",
"archiveTime": "2026-10-01 09:30:00",
"sex": 1,
"doctorCode": "D003",
"doctorName": "赵医生",
"managementDoctorCode": "D004",
"managementDoctorName": "孙医生",
"deptcode": "EK",
"deptname": "儿科",
"wardcode": null,
"wardname": null,
"icd10code": "E44.0",
"diagname": "中度营养不良",
"nutritionIcd10Code": "E44.0",
"nutritionDiagName": "中度营养不良",
"closeStatus": "0",
"gestationalWeek": 39.5,
"birthWeight": 3.2,
"registerUser": "赵医生",
"orgid": "1",
"campusid": "1",
"delFlag": "0"
}
}
返回对象
data为儿科档案详情对象,字段说明同 3.2 请求体字段。