十一、业务集成
11.1 ERP 收付款自动凭证
链路:ERP 收款单/付款单【审批通过】→ 系统事件 → 财务凭证引擎 → 按账套规则生成凭证。
- 账套路由:按审批人所在组织沿组织树上溯到公司 → 该公司默认账套
- 凭证:收款 借 1002/贷 1122(客户);付款 借 2202(供应商)/贷 1002(规则可在【凭证规则】调整)
- 防重:同一 ERP 单据只生成一次(业务类型+单据ID+账套唯一)
- 凭证失败不阻断 ERP 审批:错误记后台日志,可用下方补偿接口重试
11.2 手动补偿入口
业务事件偶发失败时,管理员可调用 POST /fin/engine/generate(body:bizType + bizId + context)手动补生成;幂等,已生成过返回空。
11.3 可自动生成凭证的全部业务类型一览
| bizType | 来源 | 防重键 |
|---|---|---|
| ERP_RECEIPT / ERP_PAYMENT | ERP 审批 | 单据ID+账套 |
| FIN_RECEIPT / FIN_PAYMENT | 收款审核 / 付款执行 | 单据ID |
| FIN_TRANSFER | 转账审核 | 单据ID |
| FIN_LOAN / FIN_LOAN_REPAY | 借款登记(选账户) / 还款(选账户) | 借款ID / 无 |
| FA_DEP / FA_DISPOSE | 折旧计提 / 资产处置 | 期间ID / 卡片ID |
| BILL_RECEIVABLE_ENDORSE / DISCOUNT / SETTLE | 票据背书/贴现/托收 | 票据ID |
| BILL_PAYABLE_CREATE / PAY | 应付票据开出/兑付 | 票据ID |
| BAD_DEBT_PROVISION / WRITEOFF | 坏账计提/核销 | 无 |
| FIN_ADJUST | 日记账手工流水(选对方科目) | 流水ID |
| PROFIT_CARRY | 期末结转损益 | 期间ID |
