建单：手工、导入、渠道、Portal、CRM

订单进入 OMS 的五种方式、必填字段、导入模板规则和草稿编辑规则。

五种建单入口都走同一套创建逻辑，所以无论订单从哪来，校验规则和单号规则都一致。

五种建单入口#

• 桌面手工建单——新建订单页，生成草稿单。
• Excel/CSV 导入——上传行数据，同一 channel_order_no 的行合并成一单。
• 渠道拉单——从已对接的销售渠道拉取订单。
• Merchant Portal 代建——货主代建订单（可指定 parcel/ltl/ftl）。
• CRM 商机转单——把商机转成订单。

手工建单：必填项#

• customer_id 加至少一条明细行（item_id + ordered_qty 大于 0）；空行会被拒绝。
• 收货地址留空时用客户默认地址；国家默认 US，币种默认 USD，单位默认 EA。
• carrier_code 必须在承运商目录里；service_code 是自由文本。
• 订单总额 = 小计 − 折扣 + 运费 + 税；行金额 = 数量 × 单价。

导入模板与合并规则#

• 必填列：channel_order_no、customer_name、sku、qty。可选：channel_code、收货地址字段、unit_price、required_ship_date、note。
• 逐行校验（SKU 必须存在、qty>0、渠道单号不重复）。失败行跳过，不影响成功行。
• 不存在的客户自动创建（编码 IMP-YYYYMMDD-####）。导入结果分别列出成功行和失败行。

草稿编辑#

• 只有 draft 和 pending_review 状态可以改；之后的状态会报 NOT_EDITABLE。
• 明细行整单替换（删旧行、插新行），总额重算。