2.3 KiB
2.3 KiB
Contract: IF-EXT-008 消息触达协同接口
1. 合同定位
- 接口编号：
IF-EXT-008 - 归属模块：
REV-006 / CS-006 - 责任系统：
SYS-010 - 调用方：
SYS-002 - 合同类型：外部协同接口设计合同
2. 业务职责
IF-EXT-008 负责：
- 承接
SYS-002传入的通知任务 - 按短信、微信公众号、站内信等渠道执行触达
- 返回受理结果，并在后续回传最终执行结果或失败摘要
IF-EXT-008 不负责：
- 生成催缴候选对象
- 定义催缴业务状态体系
- 决定停复水或工单联动流程
3. 输入合同
| 字段 | 说明 | 约束 |
|---|---|---|
| eventNo | 业务事件号 | 必填 |
| taskNo | 催缴任务号 | 必填 |
| channelType | 渠道类型 | 必填 |
| receiver | 触达对象 | 必填 |
| messageTemplateCode | 消息模板编码 | 必填 |
| messageParams | 模板参数 | 可为空对象 |
| priority | 优先级 | 可选 |
| callbackUrlOrMode | 结果回传方式 | 必填 |
4. 输出合同
4.1 受理返回
| 字段 | 说明 |
|---|---|
| accepted | 是否受理 |
| externalRequestNo | 外部请求号 |
| acceptedTime | 受理时间 |
| rejectReason | 拒绝原因 |
4.2 结果回传
| 字段 | 说明 |
|---|---|
| eventNo | 业务事件号 |
| taskNo | 催缴任务号 |
| deliveryStatus | 渠道执行结果 |
| deliveryTime | 执行时间 |
| externalResultCode | 外部结果码 |
| externalResultMessage | 外部结果说明 |
5. 边界合同
SYS-010的执行结果不直接定义REV-006业务态，而是由SYS-002映射为PENDING、SUCCESS、FAIL、MANUAL_VERIFIED。- 若仅返回受理成功、未返回终态，则
SYS-002维持PENDING。 - 若外部长时间无终态回写，业务侧可通过人工核查进入
MANUAL_VERIFIED。 - 渠道模板、供应商协议与重试细节由
SYS-010管理，不在REV-006正式设计中展开。
6. 失败与补偿语义
| 场景 | 协同要求 |
|---|---|
| 渠道受理失败 | 立即回传拒绝原因，由 SYS-002 视情况转 FAIL |
| 发送成功 | 回传成功结果，由 SYS-002 转 SUCCESS |
| 发送失败 | 回传失败摘要，由 SYS-002 转 FAIL |
| 无终态回写 | 允许保留 PENDING，由人工补记收口 |