采购单（PO）

手工建 PO（供应商、仓库、数量单价明细行），提交审核、审批通过或驳回。只有草稿能编辑删除。

采购单（PO）就是"我们要买货了"的单据：找哪个供应商、货送到哪个仓库、买多少、什么单价。需要向供应商买货时就用它。每张 PO 都从草稿开始——没有任何逻辑会从 OMS 缺货自动生成 PO。

新建采购单 4 步#

1. 建 PO（草稿）：选供应商（shared_vendors）、仓库，加至少一行明细（产品、数量>0、单价≥0）。单号 PO-000001 自动取号，小计/合计（=小计+税）自动求和。
2. 提交审核：draft → pending_approval。没有明细行的 PO 提交不了。
3. 审批通过（pending_approval → approved）或驳回（回到 draft）。被驳回的可以改完重新提交。
4. 下发 WMS（approved → released），或先建 ASN 再说——见 ASN 页。下发的 PO 会生成 WMS 入库单（幂等：点两次只会关联同一张入库单，不会重复建）。

要填哪些字段

• 供应商（必填）：从共享供应商名单（shared_vendors）里选，和 WMS 供应商是同一批数据。供应商必须是活跃的、本组织的。
• 仓库（必填）：standalone 模式选采购自己维护的仓库名单（purchase_warehouses）；wms_sync 模式选 WMS 仓库名单（wms_warehouses）。在采购设置里切换。
• 明细行（至少一行）：产品、数量（>0）、单价（≥0）。每行金额和小计/合计都自动算。
• 货主（3PL 版必填）：组织是 3PL（company_type=3pl）时，新建 PO 必须指定货主（merchant）；标准版可空。
• 可选：下单日期、预计到货日、币种、备注。

邮件发给供应商#

• PO 详情页点「发送给供应商」：弹窗的收件人/抄送/主题/正文全预填好，附件带上服务端生成的 PO PDF。
• 收件人默认取供应商主数据的 po_email（供应商档案上的字段），为空时回退 contact_email。
• 下发确认弹窗有「同时邮件发给供应商」勾选，默认勾上——下发 PO 和通知供应商一步完成。
• 走 Resend 发件（六语邮件模板）；每次发送都记进 PO 时间线。没配 Resend key 时降级记日志，不抛错。

审批时的自动动作（开关）#

• auto_create_asn_on_approve：审批通过后自动从 PO 建 ASN（明细/货主/仓库/预计日期带过来；承运商默认取供应商的 preferred_carrier）。
• auto_push_asn_to_wms：自动建的 ASN 建完后自动推 WMS（建入库单并回写 wms_receipt_id）。
• 自动建 ASN 失败不会回滚审批——页面会给一个 auto_asn_warning 提示，您手工建 ASN 就行。
• 两个开关都在采购设置里，默认关闭。