# 江苏医保初始化参数申请指南

## 📋 需要申请的13个参数

### 1. 网络连接参数（向医保部门申请）
| 参数名 | 说明 | 申请对象 | 示例值 |
|--------|------|----------|--------|
| **IP** | 医疗保障平台服务端IP地址 | 江苏省医保局技术部门 | "192.168.100.100" |
| **PORT** | 医疗保障平台服务端端口 | 江苏省医保局技术部门 | 8080 |
| **TIMEOUT** | 访问服务端超时时间（秒） | 技术规范建议 | 120 |

### 2. 系统配置参数（医院自行设置）
| 参数名 | 说明 | 设置说明 | 示例值 |
|--------|------|----------|--------|
| **LOG_PATH** | 动态库日志目录 | 本地目录，需要写权限 | "C:\\log\\" |

### 3. 电子凭证参数（向国家医保局申请）
| 参数名 | 说明 | 申请对象 | 示例值 |
|--------|------|----------|--------|
| **EC_URL** | 电子凭证中台URL | 国家医保局或省医保局 | "https://fuwu.nhsa.gov.cn/localcfc/api/hsecfc/localQrCodeQuery" |

### 4. 业务配置参数（向医保部门申请）
| 参数名 | 说明 | 申请对象 | 可选值 |
|--------|------|----------|--------|
| **CARD_PASSTYPE** | 社保卡验证密码方式 | 医保部门技术科 | "1"（验证卡PIN）或"2"（验证数据库密码） |

### 5. CSB服务总线参数（向医保技术服务商申请）
| 参数名 | 说明 | 申请对象 | 示例值 |
|--------|------|----------|--------|
| **API_NAME** | CSB的_api_name | 医保技术服务商 | "api-powersi-test-pri" |
| **API_VERSION** | CSB的_api_version | 医保技术服务商 | "1.0.0" |
| **ACCESS_KEY** | CSB的_api_access_key | 医保技术服务商 | "043a6d5927174ab5a7681b193b9fe0e3" |
| **SECRETKEY** | CSB的secretKey | 医保技术服务商 | "ZugfjXENyvGIQYdB+hFB+s9JL0A=" |

### 6. 医院信息参数（医院管理部门提供）
| 参数名 | 说明 | 提供部门 | 示例值 |
|--------|------|----------|--------|
| **ORG_ID** | 定点编号（医院编码） | 医院医保科 | "H32010000001" |
| **AREA_CODE** | 定点所属行政区划代码 | 医院管理部门 | "320100"（南京市） |

### 7. 扩展参数（可选）
| 参数名 | 说明 | 设置说明 | 示例值 |
|--------|------|----------|--------|
| **EXT** | JSON对象字符串（预留） | 暂时可为空 | "" |

## 📞 **申请流程**

### 第一步：准备申请材料
1. **医院资质证明**
   - 医疗机构执业许可证
   - 定点医疗机构协议书
   - 技术负责人身份证明

2. **技术申请表**
   - 系统名称：ThCardReader江苏医保读卡系统
   - 使用目的：医保患者身份验证和信息读取
   - 预计接入时间
   - 技术负责人联系方式

### 第二步：分别申请不同参数
1. **向江苏省医保局申请**（IP、PORT、CARD_PASSTYPE、ORG_ID）
   - 联系电话：025-83275907（信息中心）
   - 邮箱：jsybxxzx@js.gov.cn
   - 地址：南京市鼓楼区中山路50号

2. **向医保技术服务商申请**（CSB相关参数）
   - 常见服务商：东软、卫宁、创业软件等
   - 需要提供：医院编码、业务需求说明

3. **向当地医保部门申请**（具体业务参数）
   - 各市医保局信息科
   - 县区医保中心技术部门

### 第三步：测试环境配置
```json
{
  "IP": "测试环境IP（医保部门提供）",
  "PORT": 测试环境端口,
  "TIMEOUT": 120,
  "LOG_PATH": "C:\\log\\jiangsu_test\\",
  "EC_URL": "测试环境电子凭证URL",
  "CARD_PASSTYPE": "1",
  "API_NAME": "测试环境API名称",
  "API_VERSION": "1.0.0", 
  "ACCESS_KEY": "测试环境访问密钥",
  "SECRETKEY": "测试环境密钥",
  "ORG_ID": "医院测试编码",
  "EXT": "",
  "AREA_CODE": "320100"
}
```

### 第四步：生产环境配置
通过测试后，申请生产环境参数替换测试参数。

## 🔒 **参数安全注意事项**

### 1. 保密要求
- **ACCESS_KEY**和**SECRETKEY**严格保密
- 不要在代码中硬编码真实生产参数
- 使用配置文件或环境变量管理

### 2. 网络安全
- **IP**和**PORT**通常需要防火墙白名单
- 可能需要VPN连接到医保专网
- SSL证书配置（如果使用HTTPS）

### 3. 配置文件建议
```json
// config/jiangsu_production.json
{
  "jiangsu_medical": {
    "IP": "${JIANGSU_IP}",
    "PORT": "${JIANGSU_PORT}",
    "TIMEOUT": 120,
    "LOG_PATH": "C:\\logs\\jiangsu\\",
    "EC_URL": "${JIANGSU_EC_URL}",
    "CARD_PASSTYPE": "1",
    "API_NAME": "${JIANGSU_API_NAME}",
    "API_VERSION": "1.0.0",
    "ACCESS_KEY": "${JIANGSU_ACCESS_KEY}",
    "SECRETKEY": "${JIANGSU_SECRET_KEY}",
    "ORG_ID": "${HOSPITAL_ORG_ID}",
    "EXT": "",
    "AREA_CODE": "${HOSPITAL_AREA_CODE}"
  }
}
```

## 📱 **联系方式参考**

### 江苏省医疗保障局
- **地址**：南京市鼓楼区中山路50号
- **技术热线**：025-83275907
- **官网**：http://ylbz.jiangsu.gov.cn/

### 各市医保局（示例）
- **南京市**：025-68505600
- **苏州市**：0512-68221800  
- **无锡市**：0510-81822800
- **常州市**：0519-86679800

### 技术服务商（常见）
- **东软集团**：医保信息化解决方案
- **卫宁健康**：医院信息系统集成
- **创业软件**：医保支付平台

## ⚠️ **重要提醒**

1. **测试优先**：务必先申请测试环境参数进行调试
2. **合规申请**：必须通过正式渠道申请，不可使用非官方参数
3. **定期更新**：部分参数（如密钥）可能有有效期，需要定期更新
4. **备案管理**：系统上线前需要向医保部门备案
5. **技术支持**：保持与医保技术部门的良好沟通

申请成功后，将真实参数替换到配置文件中即可正常使用江苏医保读卡功能。