跟单

今天要做什么

跟单是销售确认订单之后的履约窗口：推进订单状态、协调交期、触发备货、提交发货、跟回款、处理开票请求。每日盯交期、每周复核里程碑与验货、每月清已发未确认。

每日

1. 打开订单看板，筛「已确认 / 生产中 / 部分已发货」三个 Tab，按「预计发货日」升序排列。
2. 找出预计发货日 ≤ 今天 且仍未发货的单：向生产 / 仓库推进备货，或走工作流推状态。
3. 客户银行回单到账：在订单详情点「记录付款」，定金回款会把订单自动从「已确认」跃迁到「生产中」。
4. 备货完成：订单详情点「创建送货单」，逐行绑定订单明细（订单行 + 数量 + 单位），保存草稿后提交发货。
5. 客户签回签收单 / 物流显示已送达：打开送货单详情点「确认签收」。

每周

• 周一复核付款里程碑：到期未收款节点提醒销售 / 出纳催款，必要时调整里程碑「预计到账日」。
• 周三做发货前验货登记（结论「通过 / 未通过」+ 备注 + 照片路径），未通过的单据锁死「提交发货」与「确认签收」两个按钮。
• 周五清理 VAT 开票请求：已收款订单的「待开票」请求交给会计 / 开票员去开，开完回填发票号与开票日。

每月

• 清「已发货未确认签收」的送货单：批量走签收，触发收入确认凭证入账（账本配置「签收后确认收入」时自动）。
• 核对「已全部收款 + 已全部签收」的订单是否自动跃迁到「已完成」；未跃迁的手动推工作流。
• 对账 VAT：收到税局反馈的已开票请求回填发票号与开票日，状态推进到「已开票」。

权限红线（先看这 5 条）

• 不能建 / 改订单明细——订单行量价由销售定，跟单不直接改；极特殊情况走销售会签。
• 订单处于「草稿 / 待审批 / 已取消」时不能建送货单、也不能录收款——这几个状态还不具备履约资格。
• 送货单不能超发（某行数量 > 订单行剩余未发量）——会被 DB CHECK 拒绝，别尝试拆行绕开。
• 验货结论「未通过」的送货单不能「提交发货」也不能「确认签收」——必须先补救 / 重新验货。
• 已「开票」的 VAT 请求不能取消——走税局红字流程，不点「取消请求」。

Quickstart — 日常核心任务

2.1 录入客户回款（推进订单到生产中）

客户银行打款到账，收到银行水单或付款凭证。订单处于「已确认 / 生产中 / 部分已发货 / 已发货 / 已签收」任一可收款状态即可录入。

1. 筛「已确认」Tab 找到目标订单，进入订单详情。（见图 ①）
2. 右上操作区点「记录付款」按钮打开对话框。（见图 ②）
3. 填到账金额（币种以订单币种为准）、付款类型（定金 / 进度款 / 尾款 / 其他）、付款方式（电汇 / 信用证 / 其他）、银行流水号、到账日期。
4. 点「确认」——若是定金到账，订单状态会自动从「已确认」跃迁到「生产中」，同时企微推送「订单收款到账」卡片给销售群。

何时不该做：订单处于「草稿 / 待审批 / 已取消」时先让销售走审批 / 确认，草稿单录款会报错也不会改订单状态。币种与订单不一致时先核对汇率——不要按折算后金额录入，会导致订单「已收款」金额偏差。已开过 VAT 票的订单改金额前先查开票记录，否则会引发税金差异。

观测信号：

1. 订单顶部「已收 / 合计」数字同步增长。
2. 付款列表出现新行（金额、方式、到账日）。
3. 订单状态徽标由「已确认」变「生产中」（首次收定金时）。
4. 企微群收到「订单收款 X 到账」卡片。

技术追溯：sales_orders.paid_amount 等额增加；payments 新增一行；sales_orders.status 按工作流触发 confirmed→processing。

系统动作：recordOrderPaymentAction、getOrderPayments、deleteOrderPaymentAction、recordRefundAction

2.2 创建送货单

生产完成 / 外协货到仓，备货量足够，需要给客户发货。订单处于「已确认 / 生产中 / 部分已发货」且至少有一行「剩余未发数量 > 0」时可建。

1. 在订单详情右上找「创建送货单」按钮，点开进入送货单新建流程。（见图 ①）
2. 弹窗 / 新建页里选出货仓（分仓发货时精确对仓，关系到库存扣减源头）。
3. 填计划发货日、收货地址（默认带客户默认地址）。（见图 ②）
4. 点「保存草稿」——系统生成 DN- 开头的送货单号，进入「草稿」状态。

何时不该做：订单处于「草稿 / 待审批 / 已取消」状态禁止建送货单——库存会被误扣且签收后无法冲回。分仓发货选错出货仓会让仓库从错的仓位扣减导致盘点对不上，事后只能走撤销重建。

观测信号：

1. 送货单列表顶部出现新行，单号 DN- 前缀，状态「草稿」。
2. 订单详情「发货进度」区显示关联新单号。
3. 仓库出库队列出现该送货单，但订单行的「已发数量」未递增（待行项提交）。

技术追溯：delivery_notes.status='draft'、delivery_notes.sales_order_id 指向源订单；line_items.shipped_qty 此时还没动。

系统动作：createDeliveryNoteAction、createDeliveryNoteFromOrder、getDeliverableQtysWithProducts、getCustomerAddressAction

2.3 录入送货单明细并提交发货

送货单处于「草稿」状态，备货数量已由仓库 / QC 确认；运输信息（承运商 / 运单号 / 毛净重）也已备齐，推仓库出库。

1. 进送货单详情，点「添加明细」选要发的订单行（含产品信息）、数量、单位——系统自动拉订单行剩余可发量做上限校验。（见图 ①）
2. 编辑运输信息卡：承运商、运单号、运输方式（陆 / 海 / 空 / 快递 / 其他）、毛重 / 净重。（见图 ②）
3. 点「提交发货」按钮——系统原子递增订单行「已发数量」并写库存扣减记录。（见图 ③）
4. 订单状态依剩余可发量自动跃迁：部分发完 → 「部分已发货」；全部发完 → 「已发货」。

何时不该做：某行数量超过订单行剩余未发量会被 Postgres CHECK 约束拒绝并回滚到「草稿」——别拆行硬改数量，超发规则保护库存不出负值。验货结论「未通过」时「提交发货」按钮会被锁死，硬走会触发 UI 拦截提示（详见验货任务）。

观测信号：

1. 送货单状态由「草稿」变「已提交」，提交时间 / 提交人显示在头部。
2. 订单列表状态徽标变「部分已发货」或「已发货」。
3. 库存模块出现出库流水，数量与送货单明细总和一致。
4. 物流在出口 / 运输看板看到该送货单进入待装车 / 待装箱队列。

技术追溯：delivery_notes.status='submitted'，submitted_at / submitted_by 落笔；line_items.shipped_qty 由 RPC increment_shipped_qty 原子递增；sales_orders.status 按量跃迁到 partial_shipped / shipped。

系统动作：addDeliveryNoteItemAction、updateDeliveryNoteItemAction、removeDeliveryNoteItemAction、updateDeliveryNoteAction、submitDeliveryNoteAction

2.4 记录发货前验货

送货单提交前仓库或 QC 完成质检：验货通过才能提交发货并后续确认签收；未通过自动锁死两个动作。

1. 送货单详情页下方有「验货」卡片，单据处于「草稿」或「已提交」状态时都可录入。（见图 ①）
2. 选结论：「通过」或「未通过」（两个单选项）。
3. 填验货备注（简述缺陷 / 批次 / 抽检比例），如有照片把 OSS / 企微图片路径粘到备注尾部。
4. 点「保存」——若选「未通过」系统会把「提交发货」「确认签收」按钮置灰。

何时不该做：验货未通过不要硬点「提交发货」绕过——UI 工具提示会拦截；就算 DB 直改验货标志也绕不开签收前的二次校验。照片字段以备注尾缀持久化，路径写错 OSS 取不到就丢证据——录入前确认路径可访问。

观测信号：

1. 验货卡片显示结论徽标「通过 / 未通过」+ 备注。
2. 未通过时「提交发货」「确认签收」按钮置灰，悬停显示拦截原因。

技术追溯：delivery_notes.inspection_passed 布尔；delivery_notes.inspection_notes 保存备注（含图片路径）；i18n 拦截文案 key inspectionFailedTooltip。

系统动作：confirmInspectionAction

2.5 确认客户签收

货物已送达，客户签回签收单 / 物流 API 显示已送达。送货单处于「已提交」且验货结论非「未通过」时触发签收。

1. 打开送货单详情，确认状态是「已提交」且验货结果非「未通过」。（见图 ①）
2. 点右上「确认签收」按钮，系统弹对话框确认。（见图 ②）
3. 点「确认」——送货单状态变「已签收」；若该订单所有行的「已签收量 ≥ 订单量」，订单状态跃迁到「已签收」。
4. 若账本配置了「签收后确认收入」，同步触发收入确认凭证入账（走 GL）。

何时不该做：签收前必须拿到客户签收回执（邮件 / 物流 API / 书面），漏签或未签先点会让收入提前确认、月结数据失真，月底盘账会计会回退。验货「未通过」时按钮已锁，不要尝试改 DB 绕开——签收后产品质量争议会无证据可查。

观测信号：

1. 送货单状态徽标变「已签收」，详情头部显示签收时间。
2. 若本单是最后一批，订单状态变「已签收」。
3. 会计模块出现收入凭证（账本配「签收后确认收入」时）。

技术追溯：delivery_notes.status='delivered'；当 SUM(delivered_qty) >= SUM(quantity) 时 sales_orders.status='delivered'；GL 凭证由 onInvoiceDeliveryConfirmed 写入（账本 revenue_recognition_trigger='delivery_confirmed' 时）。

系统动作：confirmDeliveryAction

2.6 推进订单工作流节点

订单有非自动跃迁的工作流节点（如「定金到账」「开始生产」「提交给销售经理复核」等），按业务流程手动推进。

1. 订单详情页右上「可用操作」区列出当前状态可用的跃迁。（见图 ①）
2. 点目标跃迁按钮（或下拉选），弹窗里填备注（留痕用）。
3. 提交后订单工作流节点更新，审批历史 / 审计轨迹写一条新记录。

何时不该做：已「已完成 / 已取消」的订单不再跃迁——工作流引擎会拒绝并报「non-matching transition」。不要直接改 DB 绕过引擎——会让工作流节点与订单状态失去同步，审计断链。回退前先确认下游未动作（比如签收后不能回退到草稿）。

观测信号：

1. 订单头部状态徽标按跃迁定义变化。
2. 「审批历史 / 审计」Tab 出现一条新记录（操作人、时间、备注）。
3. 企微推送对应节点的审批 / 通知卡片给下一责任人。

技术追溯：sales_orders.workflow_state_id 更新；workflow_audit_trail 新增 from_status / to_status / actor_id；sales_orders.status 由 syncWorkflowState 同步。

系统动作：executeOrderTransitionAction、getOrderWorkflowState、getOrderAvailableTransitions、getOrderAuditTrail

2.7 创建 VAT 开票请求并回填开票信息

客户申请开具增值税专用发票 / 普票：订单已部分或全额回款时发起请求；会计或开票员开完票后回填发票号与开票日。

1. 订单详情 VAT 开票区块，点「申请开票」打开对话框。（见图 ①）
2. 填开票金额（不能超过已回款金额）、税率（13 / 9 / 6 / 0）、购方名称、购方税号、备注。
3. 点「提交」——新建「待开票」状态的请求，走会计 / 开票员队列。
4. 开票员开完后进来点「标记已开」，填发票号与开票日。（见图 ②）

何时不该做：开票金额 > 订单已回款余额会被拦截。已「开票」的请求不要再对同一订单重复申请相同金额——税局会因重复发票回退。已「开票」的不能「取消」——走税局红字流程，不动本系统。

观测信号：

1. VAT 区块出现新请求行，状态徽标由「待开票」变「已开票」。
2. 开完后显示发票号 + 开票日。
3. 企微 / 邮件推送给会计或客户（看推送规则配置）。

技术追溯：vat_invoices.status ∈ {requested, issued, cancelled}；vat_invoices.vat_number、vat_invoices.issue_date 回填。

系统动作：createVatInvoiceRequestAction、markVatIssuedFormAction、updateVatInvoiceStatusAction、cancelVatInvoiceRequestAction、getOrderVatInvoiceRequests

2.8 由送货单直接开具商业 / 形式发票

外贸客户要求凭送货单出商业发票或形式发票。送货单处于「已提交」或「已签收」状态后可开。

1. 打开送货单详情，右上点「创建发票」按钮。（见图 ①）
2. 弹窗选发票类型：「商业发票」（记应收账款）或「形式发票」（不记应收，仅供客户走内部审批）。
3. 确认——系统按送货单明细自动生成 INV- 开头的发票，状态「草稿」。
4. 如需发票 PDF 推给客户，进发票详情走发送。

何时不该做：送货单未提交或已取消时不能开票。同一送货单反复开票会产生重复——先查送货单详情下方「关联发票」区有没有已开单。客户未收款只开「形式发票」，开「商业发票」会进应收账款，之后撤销要走贷项通知单。

观测信号：

1. 送货单详情「关联发票」区出现新发票号。
2. 发票列表顶部出现 INV- 前缀新行，状态「草稿」。
3. 应收账款模块出现应收挂账（仅「商业发票」类型）。

技术追溯：invoices.delivery_note_id 指向源送货单；invoices.status='draft'；invoices.type = commercial / proforma。

系统动作：createInvoiceFromDnAction

上下游交接契约

跟单在「销售→生产→仓库→物流→会计」的履约链中处在交叉口，每次状态推进都触发下游动作。下面是三条最频繁的交接契约。

异常回滚

误操作不要直接改 DB。按下表选入口按业务规则回滚，注意前置条件——比如已签收的送货单不能直接作废，要走贷项单 + 退库。

进阶功能

相关业务场景

跟单主责「标准成单」的履约段；项目流与销售 / 设计 / PMC 协同；回款由跟单登账；采购付款与报销不参与。

1. 标准成单流（询盘 → 报价 → 订单 → 发货 → 开票）： 跟单承接「已确认」订单后推状态、收定金、建送货单、提交发货、确认签收，最后把「已全部收款 + 已签收」的订单推到「已完成」。 → 场景详解
2. 定制家具项目流： 跟单按里程碑阶段推进分批发货，与设计 / PMC / 仓库对拆单后的各段进度；项目阶段变化时调整里程碑「预计到账日」和「金额」。 → 场景详解
3. 回款流： 跟单主责「客户侧」回款登账，触发订单自动跃迁；出纳对账后若有错由跟单删错行或走退款；不建贷项通知单（销售职责）。 → 场景详解
4. 采购付款流：跟单不参与——/dashboard/purchasing/* 由采购角色操作。 → 场景（了解即可）
5. 月结流： 跟单协同：清理「已发货未确认签收」批量推签收、核对「已收款 vs 合同总额」、开 VAT 票并回填开票信息、核对「已签收 + 已收款」订单自动「已完成」。 → 场景详解
6. 报销审批流：跟单不参与作为核心业务——仅作为申请人走 /dashboard/expenses（如出差跟货报销），非跟单核心动作。 → 场景（作为申请人）

外部协作入口

• /dashboard/wecom — 企微推送（订单收款到账、送货单提交、签收确认）配置与模板。
• /dashboard/export/shipments — 物流出口装箱 / 报关 / 运输跟踪看板，送货单提交后下游入口。
• /dashboard/inventory — 仓库备货 / 出库 / 预留追踪，送货单草稿 / 提交联动点。
• /dashboard/reports/sales — 订单交付率、及时发货率、退款率看板，月会用。
• /dashboard/accounting/payments — 出纳对账入口，收款录入后下游查账。
• /dashboard/manual — 系统内置使用手册（补充参考）。

权限与范围

看得到什么（RLS 边界）

• 当前 organization_id 下的所有 sales_orders / delivery_notes / payments / refunds / vat_invoices / order_payment_milestones。
• 当前 book_id 下的财务数据——多账套下不同账本隔离，切账套后看到的数据会变。
• 订单行明细读权限；改 / 删 sales_orders.line_items 的权限默认属于销售，跟单只读。

改得了什么（权限点）

• sales.orders：工作流推进、收款录入、退款登记、VAT 请求、里程碑调整；不含订单行改量。
• sales.delivery_notes：创建 / 编辑 / 提交 / 签收 / 取消 / 删除（草稿）；行项增删改（草稿态）。

核心概念

• book_id — 账套隔离键。切账套后看到的订单 / 发货 / 回款数据完全不同。
• organization_id — 租户隔离键，多租户下跨组织通过 RLS 隔离。
• 工作流引擎（src/services/workflow-engine.ts）——订单 / 送货单状态机统一走引擎；transition 由 DB 配置，不在代码写死。跟单日常动作大多数通过 executeOrderTransitionAction 触发对应 transition。
• syncWorkflowState — 把 workflow_state_id 映射回 sales_orders.status 字段，两者需一致；直改 DB 会让二者失同步。
• 自动跃迁 — 定金到账会把「已确认」推到「生产中」；全部签收会把「已发货」推到「已签收」；完全收款 + 全部签收会把「已签收」推到「已完成」。

术语表

销售订单 sales order

sales_orders.order_number（SO-YYYYMM-NNNN）

送货单 / 发货通知单 delivery note

delivery_notes.dn_number（DN-）

发票 invoice

invoices.invoice_number（INV-）

交货期 / 预计发货日

sales_orders.expected_ship_date（跟单主 KPI 字段）

实际发货日

sales_orders.shipped_date（全量发货后自动落笔）

已发数量

line_items.shipped_qty（由 increment_shipped_qty RPC 原子维护）

回款金额

sales_orders.paid_amount（payments 汇总）

里程碑 milestone

order_payment_milestones（expected_date / amount / status pending/received）

运单号 / 承运商

delivery_notes.tracking_number / delivery_notes.carrier

运输方式枚举

陆 / 海 / 空 / 快递 / 其他 ↔ land | sea | air | express | other（delivery_notes.shipping_method）

送货单状态枚举

草稿 / 已提交 / 已签收 / 已取消 ↔ draft | submitted | delivered | cancelled

订单状态枚举（跟单相关）

已确认 / 生产中 / 部分已发货 / 已发货 / 已签收 / 已完成 / 已取消 ↔ confirmed | processing | partial_shipped | shipped | delivered | completed | cancelled

验货结果

delivery_notes.inspection_passed + inspection_notes（控制提交发货 / 确认签收门禁）

工作流状态

sales_orders.workflow_state_id（与 status 通过 syncWorkflowState 同步）

付款类型枚举

定金 / 进度款 / 尾款 / 其他 ↔ deposit | progress_payment | final_payment | other

退款原因枚举

多付款 / 订单取消 / 质量问题 / 其他 ↔ refunds.refund_reason ∈ (overpayment | order_cancelled | quality_issue | other) + refund_method

VAT 请求状态

待开票 / 已开票 / 已取消 ↔ vat_invoices.status ∈ (requested | issued | cancelled)+ vat_number + issue_date

发票类型

商业发票 / 形式发票 ↔ invoices.type ∈ (commercial | proforma)

账套隔离键

book_id（所有财务表）

收入确认触发

账本配「签收后确认收入」↔ revenue_recognition_trigger='delivery_confirmed'（触发 onInvoiceDeliveryConfirmed）

收款核心动作

recordOrderPaymentAction / deleteOrderPaymentAction / recordRefundAction

发货核心动作

createDeliveryNoteAction → addDeliveryNoteItemAction → submitDeliveryNoteAction → confirmDeliveryAction

工作流推进动作

executeOrderTransitionAction（getOrderAvailableTransitions 查可用）

VAT 核心动作

createVatInvoiceRequestAction → markVatIssuedFormAction；撤销 cancelVatInvoiceRequestAction

常见问题