mhCardReader/江苏医保参数申请指南.md

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

📋 需要申请的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	医保技术服务商	"043a6d5927"
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. 向当地医保部门申请（具体业务参数）

   • 各市医保局信息科
   • 县区医保中心技术部门

第三步：测试环境配置

{
  "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. 配置文件建议

// 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. 技术支持：保持与医保技术部门的良好沟通

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