2026年12月31日后CRPT不再接受手动上传，所有数据必须走API。本文从技术视角拆解对接过程，给IT负责人参考。

一、认证机制

CRPT API使用基于证书的身份验证（X.509客户端证书）。企业需要先申请电子签名（ЭП）和客户端证书，配置到服务器上。证书有效期通常为1年，到期前需更新。

二、核心接口清单

①获取令牌（/api/v1/auth）；②申请码包（/api/v1/codes/order）；③下载码包（/api/v1/codes/download）；④上传出厂数据（/api/v1/products/introduce）；⑤查询码状态（/api/v1/codes/status）。

三、码包申请流程

调用申请接口→等待CRPT处理（通常5-30分钟）→轮询状态→下载码包文件（.dat格式）→解析码值→导入产线系统。建议做成异步任务，不要同步等待。

四、数据上传与回执

产品出厂时，将码值+批次信息+物流信息打包上传。CRPT返回回执ID，需要轮询确认最终状态。建议实现自动重试机制（最多3次，间隔递增）。

五、常见错误码

401=证书过期；403=权限不足（检查账号类型）；429=请求频率超限（限速100次/分钟）；500=CRPT服务端错误（等5分钟后重试）；503=系统维护中。