103 lines
3.0 KiB
Markdown
103 lines
3.0 KiB
Markdown
# Contract: REV-006 催缴事件与通知协同
|
|
|
|
## 1. Formal Interface Allocation
|
|
|
|
| Interface | Role | Direction |
|
|
|---|---|---|
|
|
| `IF-REV-013` | `REV-006` 催缴任务生成、任务查询、结果承接的正式业务接口 | `SYS-002` 内部正式业务接口 |
|
|
| `IF-EXT-008` | `SYS-002` 与 `SYS-010` 的消息触达协同接口 | `SYS-002 -> SYS-010` 发送，`SYS-010 -> SYS-002` 回写 |
|
|
|
|
约束：
|
|
|
|
- `IF-REV-009` 继续保留给 `REV-005` 发票结果查询，不得再用于 `REV-006`。
|
|
- `IF-REV-013` 是本 feature 新增的正式业务接口编号。
|
|
|
|
## 2. IF-REV-013 Business Contract
|
|
|
|
### Purpose
|
|
|
|
统一承接催缴任务生成、任务状态查询和业务侧结果查看，不承担消息平台内部发送逻辑。
|
|
|
|
### Request Shape
|
|
|
|
| Field | Meaning | Required |
|
|
|---|---|---|
|
|
| `taskNo` | 催缴任务号 | 查询时是；生成时否 |
|
|
| `custId` | 客户标识 | 是 |
|
|
| `chargeIds` | 账单集合 | 是 |
|
|
| `billPeriod` | 账期 | 是 |
|
|
| `arrearsAmount` | 欠费金额 | 是 |
|
|
| `strategyCode` | 催缴策略编码 | 是 |
|
|
| `channelType` | 触达渠道 | 是 |
|
|
| `triggerType` | 触发方式 | 是 |
|
|
| `eventNo` | 业务事件号 | 生成后返回；回写承接时是 |
|
|
|
|
### Response Shape
|
|
|
|
| Field | Meaning |
|
|
|---|---|
|
|
| `taskNo` | 催缴任务号 |
|
|
| `interfaceCode` | 固定为 `IF-REV-013` |
|
|
| `status` | `PENDING` / `SUCCESS` / `FAIL` / `MANUAL_VERIFIED` |
|
|
| `resultTime` | 最近结果时间 |
|
|
| `failureReason` | 失败原因 |
|
|
| `relatedDisposalRef` | 关联停复水或工单引用 |
|
|
|
|
## 3. IF-EXT-008 Collaboration Contract
|
|
|
|
### Outbound to SYS-010
|
|
|
|
| Field | Meaning |
|
|
|---|---|
|
|
| `eventNo` | 业务事件号 |
|
|
| `taskNo` | 催缴任务号 |
|
|
| `custId` | 客户标识 |
|
|
| `receiver` | 接收目标 |
|
|
| `channelType` | 触达渠道 |
|
|
| `templateCode` | 消息模板编码 |
|
|
| `arrearsAmount` | 欠费金额 |
|
|
| `billPeriod` | 账期 |
|
|
| `triggerType` | 自动/人工 |
|
|
|
|
### Writeback from SYS-010
|
|
|
|
| Field | Meaning |
|
|
|---|---|
|
|
| `eventNo` | 业务事件号 |
|
|
| `status` | `SUCCESS` / `FAIL` / `PENDING` |
|
|
| `failureReason` | 失败原因 |
|
|
| `resultChannel` | 实际触达渠道 |
|
|
| `resultTime` | 结果时间 |
|
|
|
|
### Manual Verification Supplement
|
|
|
|
当外部结果长期未定或与业务侧核查结论不一致时，由 `SYS-002` 将任务状态补记为 `MANUAL_VERIFIED`，并保留核查人和核查说明。
|
|
|
|
## 4. State Contract
|
|
|
|
| State | Meaning | Allowed Source |
|
|
|---|---|---|
|
|
| `PENDING` | 已生成任务，等待协同结果或人工核查 | `SYS-002` |
|
|
| `SUCCESS` | 已确认触达成功 | `SYS-010` 回写 |
|
|
| `FAIL` | 已确认发送失败 | `SYS-010` 回写或失败确认 |
|
|
| `MANUAL_VERIFIED` | 经过人工核查后补记为有效结果 | `SYS-002` 人工核查 |
|
|
|
|
## 5. History Query Contract
|
|
|
|
历史查询最小字段集必须支持：
|
|
|
|
- 客户号
|
|
- 账期
|
|
- 催缴方式
|
|
- 执行结果
|
|
- 发送时间
|
|
- 发送对象
|
|
- 关联账单
|
|
- 关联停复水/工单引用
|
|
|
|
该查询合同用于：
|
|
|
|
- 正式设计中的历史只读口径
|
|
- 迁移验收对账
|
|
- 后续催缴与停复水核查
|