回款管理、回款计划
这篇解决什么
回款和计划各是哪张表、审批走哪个 key、待办提醒怎么算。读完能对上 crm_receivable、crm_receivable_plan、PUT /submit、crm-receivable-audit。计划本身不走流程。
默认端口 48080，管理端前缀 /admin-api。PC 开发页 http://127.0.0.1:5800。合同要先有，见 合同管理、合同提醒。
示意图：计划先排期。真正入账是回款单，提交后走回款审批。
从哪改
| 名称 | 说明 | 仓库路径 |
|---|---|---|
| 回款接口 | @RequestMapping("/crm/receivable") | ruoyi-office/yudao-module-crm/.../controller/admin/receivable/CrmReceivableController.java |
| 回款表 | crm_receivable | CrmReceivableDO |
| 提交审批 | PUT /submit | 同上 |
| 待审数量 | GET /audit-count | 同上 |
| 计划接口 | @RequestMapping("/crm/receivable-plan") | CrmReceivablePlanController |
| 计划表 | crm_receivable_plan | CrmReceivablePlanDO |
| 计划提醒数量 | GET /remind-count | 同上 |
| 流程 key | crm-receivable-audit | CrmReceivableServiceImpl、CrmBillTypeEnum 402 |
| PC | /crm/receivable、/crm/receivable-plan | ruoyi-office-vben/apps/web-antd/src/views/crm/receivable/ |
官方菜单：2422 回款管理，2428 回款计划。按钮 crm:receivable:create / update，计划 crm:receivable-plan:*。
本系统截图：CRM → 回款管理。合同、金额、回款方式、审批状态在这一张表。
本系统截图：CRM → 回款计划。期数、计划日期、是否已挂回款单在这里看。
计划和回款怎么挂
回款号 Redis 前缀 HK。回款必须挂客户和合同，planId 可选。计划用 receivableId 反挂已入账的回款。审批状态和合同共用 CrmAuditStatusEnum。回款方式见 CrmReceivableReturnTypeEnum：支票、现金、汇款、电汇、网转、支付宝、微信、其它。
| 名称 | 说明 | 仓库路径 |
|---|---|---|
contractId / customerId | 回款、计划都要挂 | 两张表 |
planId | 回款可选挂某一期 | crm_receivable |
receivableId | 计划已入账则有值 | crm_receivable_plan |
period / returnTime / price | 期数、日期、金额（元） | 计划 |
remindDays / remindTime | 提前几天、提醒日 | 计划 |
auditStatus | 仅回款单有 | CrmAuditStatusEnum |
CREATE TABLE crm_receivable (
id bigint NOT NULL AUTO_INCREMENT,
no varchar(64) DEFAULT NULL,
plan_id bigint DEFAULT NULL,
customer_id bigint DEFAULT NULL,
contract_id bigint DEFAULT NULL,
return_time datetime DEFAULT NULL,
price decimal(24,6) DEFAULT NULL,
process_instance_id varchar(64) DEFAULT NULL,
audit_status int DEFAULT NULL,
PRIMARY KEY (id)
);待办「待回款提醒」数：我负责的计划、还没挂 receivableId、计划日已过、提醒日也已到。不是 XXL-Job。
示意图：计划可以先排多期。每一期再开一张回款去审。通过后本仓库可按合同中心是否可用写履约。
计划和回款不要共用合同审批 key
合同是 crm-contract-audit，回款是 crm-receivable-audit。计划没有流程。审批中或已通过的回款，删除会按服务校验拦住。
合同列表上的已回款金额，来自已通过回款按 contractId 汇总，不是改合同 totalPrice。
配置与操作
先在 回款计划（2428）按合同排期：period、returnTime、price，可选 remindDays / remindTime。计划不走流程。
入账走 回款管理（2422），必挂客户和合同，planId 可选。回款号前缀 HK。未提交才能 PUT /submit，key 是 crm-receivable-audit（CrmBillTypeEnum 402）。通过后计划反挂 receivableId。待办「待回款提醒」看我负责、还没挂回款、计划日和提醒日都已到的计划，不是 Job。合同列表已回款金额是已通过回款按 contractId 汇总。
截图见上文。
