# 医保模拟接口使用说明

## 概述

本项目提供了一个医保模拟服务器（`YbMockController`），用于在本地测试医保接口功能，无需连接真实的医保系统。

## 模拟的接口

| 接口代码 | 功能 | 请求示例 |
|---------|------|---------|
| 1101 | 获取参保人信息 | `{"psn_no":"P1234567890"}` |
| 2201 | 门诊登记 | `{"psn_no":"P1234567890","org_code":"H22010402403"}` |
| 2203 | 门诊处方上传 | `{"psn_no":"P1234567890","encounter_no":"MZ20260623001"}` |
| 2207 | 门诊结算 | `{"psn_no":"P1234567890","encounter_no":"MZ20260623001"}` |
| 3201 | 住院登记 | `{"psn_no":"P1234567890","org_code":"H22010402403"}` |
| 3203 | 住院处方上传 | `{"psn_no":"P1234567890","encounter_no":"ZY20260623001"}` |
| 3207 | 住院结算 | `{"psn_no":"P1234567890","encounter_no":"ZY20260623001"}` |

## 使用方法

### 1. 启动应用

```bash
cd healthlink-his-server
mvn spring-boot:run -pl healthlink-his-application
```

### 2. 测试接口

```bash
# 测试获取参保人信息
curl -X POST http://localhost:18080/healthlink-his/yb/mock/1101 \
  -H "Content-Type: application/json" \
  -d '{"psn_no":"P1234567890"}'

# 或使用测试脚本
chmod +x scripts/test-yb-mock.sh
./scripts/test-yb-mock.sh
```

### 3. 配置医保接口地址

在 `application-dev.yml` 中配置医保接口地址：

```yaml
ybapp:
  config:
    url: http://localhost:18080/healthlink-his/yb/mock
```

## 模拟数据

### 参保人信息 (1101)

```json
{
  "psn_no": "P1234567890",
  "psn_name": "张三",
  "sex_code": "1",
  "sex_name": "男",
  "birth_date": "1980-01-15",
  "id_card": "450123198001151234",
  "insur_type": "职工基本医疗保险",
  "insur_area": "南宁市",
  "card_no": "C2024000123456",
  "balance": "12580.50",
  "status": "正常"
}
```

### 门诊结算 (2207)

```json
{
  "settle_no": "JZ20260623001",
  "total_amount": "156.80",
  "insurance_pay": "133.28",
  "self_pay": "23.52",
  "account_pay": "20.00",
  "cash_pay": "3.52",
  "settle_time": "2026-06-23 10:30:00",
  "status": "成功"
}
```

### 住院结算 (3207)

```json
{
  "settle_no": "ZYJS20260623001",
  "total_amount": "15680.50",
  "insurance_pay": "14112.45",
  "self_pay": "1568.05",
  "account_pay": "1200.00",
  "cash_pay": "368.05",
  "settle_time": "2026-06-23 10:30:00",
  "status": "成功"
}
```

## 注意事项

1. 模拟服务器仅用于本地测试，不模拟真实的医保业务逻辑
2. 返回的数据是固定的测试数据，不会根据请求参数变化
3. 生产环境请连接真实的医保接口
4. 如需更真实的测试数据，可修改 `YbMockController` 中的响应数据

## 相关文件

- `healthlink-his-yb/src/main/java/com/healthlink/his/yb/mock/YbMockController.java`
- `scripts/test-yb-mock.sh`