3.5 KiB
3.5 KiB
Contract: IF-REV-013 催缴任务生成与结果承接接口
1. 合同定位
- 接口编号：
IF-REV-013 - 归属模块：
REV-006 - 责任系统：
SYS-002 - 协同系统：
SYS-010 - 合同类型：业务接口设计合同
2. 业务职责
IF-REV-013 负责：
- 基于欠费账单、策略与渠道偏好生成催缴任务
- 查询催缴任务状态与历史催缴记录
- 承接消息协同后的业务侧四态状态
- 记录人工核查补记和处置引用
IF-REV-013 不负责：
- 短信、微信、站内信等渠道实际发送
- 停复水内部审批、派工和现场执行
- 扩展五态以上的细粒度业务状态
3. 输入合同
3.1 任务生成
| 字段 | 说明 | 约束 |
|---|---|---|
| strategyCode | 催缴策略编码 | 必填 |
| triggerType | 触发类型 | 自动 / 人工 |
| candidateList | 催缴候选对象集合 | 至少 1 条 |
| channelPreference | 渠道优先级 | 至少 1 项 |
| operator | 操作人或任务来源 | 人工触发时必填 |
3.2 任务查询
| 字段 | 说明 | 约束 |
|---|---|---|
| taskNo | 催缴任务号 | 与条件查询二选一 |
| custId | 客户标识 | 可选 |
| billPeriod | 账期 | 可选 |
| status | 任务状态 | 仅允许四态 |
| channelType | 渠道类型 | 可选 |
3.3 人工核查
| 字段 | 说明 | 约束 |
|---|---|---|
| taskNo | 催缴任务号 | 必填 |
| verifyResult | 人工核查结果 | 当前固定映射 MANUAL_VERIFIED |
| verifyNote | 核查说明 | 必填 |
| disposalRefNo | 关联处置引用号 | 可选 |
| operator | 核查人 | 必填 |
4. 输出合同
4.1 任务生成返回
| 字段 | 说明 |
|---|---|
| interfaceCode | 固定返回 IF-REV-013 |
| taskNo | 生成的催缴任务号 |
| eventNo | 业务事件号 |
| status | 初始状态，固定为 PENDING |
| taskCount | 本次生成任务数 |
| skippedReasonSummary | 被排除对象摘要 |
4.2 状态查询返回
| 字段 | 说明 |
|---|---|
| taskNo | 催缴任务号 |
| eventNo | 业务事件号 |
| status | PENDING / SUCCESS / FAIL / MANUAL_VERIFIED |
| channelType | 当前渠道 |
| receiver | 触达对象 |
| sendTime | 发送发起时间 |
| lastCallbackTime | 最近回写时间 |
| failReason | 失败原因 |
| disposalRefs | 关联处置引用 |
5. 业务规则合同
- 催缴对象必须来源于有效欠费账单，不得把已收费、已作废或已进入不允许催缴流程的账单纳入任务。
- 同一候选对象在频控窗口内不得重复生成同策略、同渠道的正式任务。
- 正式状态只允许四态，不扩展其他临时枚举值。
- 历史催缴、停水、预存短信记录按只读查询口径挂接，不表述为新建平行在线主表。
- 处置引用只承担追溯职责，不在本接口中展开停复水或工单内部流程。
6. 失败与阻断语义
| 场景 | 阻断要求 | 返回语义 |
|---|---|---|
| 候选账单不满足欠费前提 | 阻断生成 | 返回排除原因摘要 |
| 策略编码无效 | 阻断生成 | 返回策略校验失败 |
| 频控规则命中 | 可部分阻断 | 返回被跳过对象与原因 |
| 外部结果未定 | 不强制失败 | 保持 PENDING 或经人工核查转 MANUAL_VERIFIED |
| 外部明确失败 | 回写失败 | 更新为 FAIL 并记录原因 |
7. 可追溯字段最小集
taskNoeventNostrategyCodechannelTypetriggerTypestatusfailReasonreceiversendTimedisposalRefNo