编辑 | blame | 历史 | 原始文档

妇保接口文档(妇科 / 儿科档案)

本文档仅包含以下 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

请求示例

{
  "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"
    }
  ]
}

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)

请求示例(新增)

{
  "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
}

2.3 批量删除妇科档案

  • URL:POST /smartor/maternityArchive/batchDelete
  • 说明:按主表ID批量删除妇科档案,同时逻辑删除对应的妇科档案详情表数据(del_flag 置为 1),两步在同一事务中。

请求体(JSON)

参数名 类型 必填 说明
ids Long[] 是 妇科档案主表ID数组

请求示例

[1001, 1002, 1003]

响应示例

{
  "code": 200,
  "msg": "操作成功"
}

2.4 获取妇科档案详情

  • URL:GET /smartor/maternityArchiveDetail/getInfo/{archiveid}
  • 说明:按档案主表ID查询妇科档案详情(未删除数据 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 请求体字段。


三、儿科档案接口

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

请求示例

{
  "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"
    }
  ]
}

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)

请求示例(新增)

{
  "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
}

3.3 批量删除儿科档案

  • URL:POST /smartor/childArchive/batchDelete
  • 说明:按主表ID批量删除儿科档案,同时逻辑删除对应的儿科档案详情表数据(del_flag 置为 1),两步在同一事务中。

请求体(JSON)

参数名 类型 必填 说明
ids Long[] 是 儿科档案主表ID数组

请求示例

[2001, 2002, 2003]

响应示例

{
  "code": 200,
  "msg": "操作成功"
}

3.4 获取儿科档案详情

  • URL:GET /smartor/childArchiveDetail/getInfo/{archiveid}
  • 说明:按档案主表ID查询儿科档案详情(未删除数据 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 请求体字段。