档案管理系统对接EDI许可证资质核验模块全流程实操指南

一、前置准备物料

开始操作前请提前准备好以下所有物料，避免中途卡壳：

• 有效期内的EDI类《增值电信业务经营许可证》原件扫描件（分辨率≥300DPI，无遮挡）
• 档案管理系统的ICP备案截图、域名所有权证书
• 档案管理系统服务器出口公网IP（最多可填报3个，用于接口白名单配置）
• 开发环境：JDK1.8+/Node.js16+，服务器开放443端口出网权限
• 企业统一社会信用代码、接口对接责任人实名认证手机号

二、步骤1：EDI许可证接口权限申请

所有对接必须先申请官方接口权限，未申请的接口调用会直接返回403：

1. 登录官方管理系统：https://tsm.miit.gov.cn/dxxzsp/，使用企业法人账号实名认证登录
2. 点击左侧菜单栏「增值电信业务经营许可」-「接口对接申请」
3. 选择对接场景为「档案跨区域跨主体数据交换EDI资质核验」，上传提前准备的EDI许可证扫描件、域名备案截图、档案系统功能说明文档
4. 填写服务器出口公网IP、对接责任人手机号，提交审核

审核周期为3个工作日，审核通过后系统会自动生成唯一的appKey和appSecret，appSecret仅展示1次，请立即保存到本地加密存储。

三、步骤2：档案管理系统侧接口开发

3.1 接口规范说明

生产环境接口地址：https://tsm.miit.gov.cn/dxxzsp/api/edi/verify

测试环境接口地址：https://tsm.miit.gov.cn/dxxzsp/test/api/edi/verify

请求方式：POST，请求头必须携带以下参数：

• appKey：申请通过后获取的appKey
• timestamp：13位毫秒级时间戳，误差不能超过5分钟
• sign：签名值，生成规则为：将appKey+timestamp+请求体JSON字符串（无空格无转义）拼接后，用appSecret作为密钥进行HmacSHA256加密，结果转16进制小写
• Content-Type：application/json

请求体JSON格式（可直接复制修改）：

```json { "licenseNo": "你的EDI许可证号", "creditCode": "企业统一社会信用代码", "domain": "档案管理系统备案域名" } ```

3.2 可直接运行的代码示例

Java版（基于OkHttp3）：

```java import okhttp3.; import javax.crypto.Mac; import javax.crypto.spec.SecretKeySpec; import java.util.Formatter; public class EdiVerifyDemo { // 替换为自己的appKey和appSecret private static final String APP_KEY = "xxxxxx"; private static final String APP_SECRET = "xxxxxx"; private static final String PROD_URL = "https://tsm.miit.gov.cn/dxxzsp/api/edi/verify"; public static void main(String[] args) throws Exception { long timestamp = System.currentTimeMillis(); String requestBody = "{\"licenseNo\":\"你的EDI许可证号\",\"creditCode\":\"企业统一社会信用代码\",\"domain\":\"你的档案系统域名\"}"; String sign = generateSign(APP_KEY + timestamp + requestBody, APP_SECRET); OkHttpClient client = new OkHttpClient(); MediaType mediaType = MediaType.parse("application/json"); RequestBody body = RequestBody.create(mediaType, requestBody); Request request = new Request.Builder() .url(PROD_URL) .post(body) .addHeader("appKey", APP_KEY) .addHeader("timestamp", String.valueOf(timestamp)) .addHeader("sign", sign) .addHeader("Content-Type", "application/json") .build(); Response response = client.newCall(request).execute(); System.out.println(response.body().string()); } private static String generateSign(String data, String secret) throws Exception { Mac mac = Mac.getInstance("HmacSHA256"); SecretKeySpec secretKeySpec = new SecretKeySpec(secret.getBytes(), "HmacSHA256"); mac.init(secretKeySpec); byte[] bytes = mac.doFinal(data.getBytes()); Formatter formatter = new Formatter(); for (byte b : bytes) { formatter.format("%02x", b); } return formatter.toString(); } } ```

Node.js版（基于Axios）：

```javascript const axios = require('axios'); const crypto = require('crypto'); // 替换为自己的appKey和appSecret const APP_KEY = 'xxxxxx'; const APP_SECRET = 'xxxxxx'; const PROD_URL = 'https://tsm.miit.gov.cn/dxxzsp/api/edi/verify'; const generateSign = (data, secret) => { return crypto.createHmac('sha256', secret).update(data).digest('hex'); } const verifyEdi = async () => { const timestamp = Date.now(); const requestBody = { licenseNo: '你的EDI许可证号', creditCode: '企业统一社会信用代码', domain: '你的档案系统域名' }; const sign = generateSign(APP_KEY + timestamp + JSON.stringify(requestBody), APP_SECRET); const headers = { appKey: APP_KEY, timestamp: timestamp, sign: sign, 'Content-Type': 'application/json' }; const res = await axios.post(PROD_URL, requestBody, { headers }); console.log(res.data); } verifyEdi(); ```

四、步骤3：联调测试与上线配置

1. 先调用测试环境接口，使用官方测试参数：licenseNo填「粤B2-20230001」、creditCode填「91440300MA5EL0001X」、domain填「test.archives.com」，返回结果为{"code":200,"msg":"核验通过","data":{"status":1}}即为调试成功
2. 回到官方管理系统，提交测试报告（包含接口调用成功截图、请求响应日志），申请上线权限，审核周期为1个工作日
3. 审核通过后将代码中的接口地址切换为生产地址，在档案管理系统的系统设置-资质管理模块填写appKey，开启「EDI资质自动核验」开关
4. 将核验逻辑绑定到跨机构档案交换、用户档案上传的前置节点，核验不通过时禁止操作，满足合规要求

五、常见卡壳问题解决方案

• 签名验证失败：先检查timestamp是否为13位毫秒级，请求体JSON是否有多余空格/换行，加密方式是否为HmacSHA256，签名结果是否为全小写；Postman测试时可在Pre-request Script中粘贴上述Node.js签名代码，将结果设为环境变量即可
• 接口返回403：检查服务器出口IP是否和申请时填写的白名单IP一致，是否有代理服务器导致出口IP变化，appKey是否填写正确
• 核验返回无效：检查EDI许可证是否在有效期内，许可证号是否包含空格/特殊字符，企业统一社会信用代码是否和许可证登记信息一致
• 数据交换触发核验失败：检查传输的档案数据格式是否符合国内EDI标准GB/T 14805，是否包含敏感字段