# 妇保接口文档(妇科 / 儿科档案) > 本文档仅包含以下 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 | 获取儿科档案详情 | --- ## 一、通用说明 ### 1.1 服务地址 - 前缀:`http://服务IP:端口`(默认开发环境为 `http://localhost:8080`) ### 1.2 认证方式 - 所有接口均需登录后调用。 - 请求头携带:`Authorization: Bearer {token}` ### 1.3 请求与响应格式 - 请求体:`Content-Type: application/json` - 列表接口响应结构(TableDataInfo): | 字段 | 类型 | 说明 | | --- | --- | --- | | total | long | 总记录数 | | rows | array | 数据列表 | | code | int | 状态码,200 为成功 | | msg | string | 提示信息,如“查询成功” | - 非列表接口响应结构(AjaxResult): | 字段 | 类型 | 说明 | | --- | --- | --- | | code | int | 状态码,200 为成功,500 为失败 | | msg | string | 提示信息,如“操作成功”、“操作失败” | | data | object | 业务数据(可能为空) | --- ## 二、妇科档案接口 ### 2.1 查询妇科档案列表 - **URL**:`POST /smartor/maternityArchive/selectPatMaternityArchiveList` - **说明**:分页查询妇科档案主表列表(未删除数据 `del_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 | **请求示例** ```json { "pageNum": 1, "pageSize": 10, "patname": "张", "archiveType": "1" } ``` **响应示例** ```json { "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" } ] } ``` --- ### 2.2 新增或修改妇科档案 - **URL**:`POST /smartor/maternityArchive/insertOrUpdateMaternityArchive` - **说明**:同时维护妇科档案主表与详情表。 - 主表有 `archiveid`(或详情有 `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) | **请求示例(新增)** ```json { "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" } ``` **响应示例** ```json { "code": 200, "msg": "操作成功", "data": 1001 } ``` --- ### 2.3 批量删除妇科档案 - **URL**:`POST /smartor/maternityArchive/batchDelete` - **说明**:按主表ID批量删除妇科档案,同时逻辑删除对应的妇科档案详情表数据(`del_flag` 置为 1),两步在同一事务中。 **请求体(JSON)** | 参数名 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | ids | Long[] | 是 | 妇科档案主表ID数组 | **请求示例** ```json [1001, 1002, 1003] ``` **响应示例** ```json { "code": 200, "msg": "操作成功" } ``` --- ### 2.4 获取妇科档案详情 - **URL**:`GET /smartor/maternityArchiveDetail/getInfo/{archiveid}` - **说明**:按档案主表ID查询妇科档案详情(未删除数据 `del_flag = '0'`),返回第一条详情记录;无数据时 `data` 为 `null`。 **路径参数** | 参数名 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | archiveid | Long | 是 | 妇科档案主表ID(`pat_maternity_archive.id`) | **响应示例** ```json { "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 请求体字段。 --- ## 三、儿科档案接口 ### 3.1 查询儿科档案列表 - **URL**:`POST /smartor/childArchive/selectPatChildArchiveList` - **说明**:分页查询儿科档案主表列表(未删除数据 `del_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 | **请求示例** ```json { "pageNum": 1, "pageSize": 10, "patname": "王", "archiveType": "1" } ``` **响应示例** ```json { "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" } ] } ``` --- ### 3.2 新增或修改儿科档案 - **URL**:`POST /smartor/childArchive/insertOrUpdateChildArchive` - **说明**:同时维护儿科档案主表与详情表。 - 主表有 `archiveid`(或详情有 `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) | **请求示例(新增)** ```json { "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" } ``` **响应示例** ```json { "code": 200, "msg": "操作成功", "data": 2001 } ``` --- ### 3.3 批量删除儿科档案 - **URL**:`POST /smartor/childArchive/batchDelete` - **说明**:按主表ID批量删除儿科档案,同时逻辑删除对应的儿科档案详情表数据(`del_flag` 置为 1),两步在同一事务中。 **请求体(JSON)** | 参数名 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | ids | Long[] | 是 | 儿科档案主表ID数组 | **请求示例** ```json [2001, 2002, 2003] ``` **响应示例** ```json { "code": 200, "msg": "操作成功" } ``` --- ### 3.4 获取儿科档案详情 - **URL**:`GET /smartor/childArchiveDetail/getInfo/{archiveid}` - **说明**:按档案主表ID查询儿科档案详情(未删除数据 `del_flag = '0'`),返回第一条详情记录;无数据时 `data` 为 `null`。 **路径参数** | 参数名 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | archiveid | Long | 是 | 儿科档案主表ID(`pat_child_archive.id`) | **响应示例** ```json { "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 请求体字段。