Files
tms-erp-api/CONTEXT.md
T

83 lines
4.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# TMS(运输业务中台)—— 业财集成语境
TMS 与集团财务系统(金蝶星瀚)、合同合规系统(HCS)集成,单据在三个系统间流转。
本表只收录集成语境下易混淆的业务术语,不含实现细节。
## Language
**合同合规系统(HCS)**:
集团合同合规管控系统(桂物数字合同合规),接收 TMS 推送的项目、合同、履约与付款数据并做合规审批。
_Avoid_: 桂物系统、合同系统、数字合同系统
**相对方**:
HCS 对签约主体(甲乙方)的称谓,与 TMS 的"客商"同指一个外部单位。
_Avoid_: 在 HCS 集成语境用"客户/供应商"
**来源单据键**:
TMS 单据在 HCS 侧的对账主键(接口字段 `fd_kingdee_id`,字段名沿用金蝶),统一存 TMS 业务单据主键。
_Avoid_: 外部ID、kingdeeId(泛指金蝶单据号时易混淆)
**来源标识**:
TMS 推送给 HCS 时声明自身身份的常量(接口字段 `fd_sources`,约定值 "TMS")。
_Avoid_: XH(那是星瀚侧的来源标识)
**履约规则**:
合同维度的资金计划阶段(付款/收款、款项性质、计划金额、计划日期、开票规则),由 TMS 维护并同步到 HCS。
_Avoid_: 履约计划(旧版已废弃接口的叫法)、付款计划
**履约阶段**:
履约规则表中的一行;HCS 为其生成阶段ID,后续更新/删除必须凭该ID。
_Avoid_: 阶段项、plan 行
**履约记录**:
付款/收款执行事实在 HCS 的登记(一笔付款申请一条记录,随实际付款推进更新),与履约规则是"计划 vs 执行"的关系。
_Avoid_: 履约流水
**额度校验**:
付款提交时由 HCS 判定申请金额是否超出合同/项目剩余额度的同步检查;超额不阻断提交,转入特批链路。
_Avoid_: 余额检查
**特批流程**:
额度超额(或风险不通过)时在 HCS 发起的审批流程;TMS 持有其流程ID,流程结束由 HCS 经 B103 回传结果。
_Avoid_: 特殊审批、绿色通道
**特批放行**:
特批结果为"通过"后对**本次**付款申请解除推送拦截的动作;只改特批状态,不触发推送,单次有效。
_Avoid_: 特批通过自动付款、放行推送
**锁单(B901)**:
金蝶确认接收 TMS 推送的单据后,经 B901 通知 TMS 将本地源单据置为不可编辑、不可作废、不可重推的状态;金蝶反审核及删除后经 B901 解锁。
_Avoid_: 冻结、金蝶锁定(那是金蝶侧单据自己的状态)
**解锁**:
B901 通知金蝶侧单据已反审核及删除后,TMS 解除锁单、同步状态置失败、清金蝶单号留痕;不自动重推,人工核实后重新推送。
_Avoid_: 反审核(那是金蝶侧的动作)、自动重推
**合规附件ID**:
TMS 附件先上传 HCS 附件服务换取的 fdId;同一附件以 TMS 附件元数据为键缓存映射,不重复上传。
_Avoid_: 附件fdId(指代不明)
**同步状态**:
TMS 单据对 HCS 的推送生命周期(待同步/已同步/失败),权威状态在 TMS 侧字段,HCS 不回写业务状态。
_Avoid_: 推送标志
**二次认领**:
金蝶司库完成第一轮自动认领(客户维度)后,TMS 把收款流水认领到合同/结算单维度的动作;只在 TMS 本地登记,本身不产生金蝶收款单。
_Avoid_: 收款认领(泛指整条链路时易与金蝶第一轮自动认领混淆)
**公告未认领金额**:
金蝶认领公告(A301-2)上尚未被认领的金额(字段 unclaimamount),是 TMS 二次认领的上限和"认领完成"的判定基准;以金蝶侧为准,推送前须重查最新值。
_Avoid_: 剩余可认领金额(那是本地展示口径)、未认领金额(不指明公告侧/本地侧时指代不明)
**认领完成**:
一条收款流水的累计有效认领金额等于公告未认领金额的状态;只有认领完成的流水才满足推送金蝶的条件,不认领完就不推。
_Avoid_: 认领完毕、全部认领(未指明对照基准)
**认领状态**:
收款流水本地认领进度(未认领/部分认领/认领完成),对照公告未认领金额计算;作废的认领分摊不计入累计。
_Avoid_: 与推送状态混用
**推送状态**:
收款流水对金蝶 A301-3 的推送生命周期(未推送/已推送/推送失败),权威在流水级,认领主单仅冗余展示;已推送的流水不可二次推送。
_Avoid_: 金蝶状态(那是 A301-1 回写的单据生命周期:已推送/审核通过/已收款)