码头拖车公司上线指南：从建单到开票

码头拖车公司如何用 Drayage 管司机、底盘和箱：建单、调度看板、码头预约、LFD 跟踪与开票催收。

本指南面向码头拖车公司（drayage trucker）。Drayage 把“箱”作为核心对象：从建单、派司机和底盘、码头预约提箱，到盯住 LFD（免费用箱最后一天）、还空箱，最后开票催收——一条链全在系统里。

第一步：建单——把信息一次填对#

1. 选 move_type：四种作业类型四选一（提进口重箱、送出口重箱、还空箱、提空箱等），类型决定了后续流程的字段和状态机。
2. 提货地和送货地必填：pickup 和 delivery 地点必须填。常用地点先录入地址簿，建单时直接选，不用每次手敲地址。
3. merchant_id 必填：每个订单必须归属一个货主（merchant），这是后续按货主对账开票的依据。
4. delivery_to_warehouse 标记：如果这票是“送到自家仓库”，勾上这个标记。订单完成后系统会自动触发 WMS 入库单，仓库那边直接开始收货，不用再手工建单。
5. 录入箱号与船期：把 container_no、船名航次和 vessel_eta（预计到港）填上，调度看板才能按紧急度排序。

第二步：调度与派单#

1. 调度看板一眼看全：所有进行中订单排在一起，关键信息直接可见——last_free_day 剩余免费天数、customs_hold（海关扣留）、vessel_eta、截关时间，再加上司机状态和底盘状态。看板按紧急度自动排序，最危险的箱永远在最上面。
2. 派单：driver_id 必填（必须指定司机），chassis_id 可选（有就挂上）。派单成功后司机状态变为 on_job（执行中），底盘变为 in_use（使用中）。
3. 码头预约：提箱/还箱前先做码头预约，状态流转 scheduled（已预约）→ completed（已完成），爽约记 missed，取消记 cancelled。预约状态直接影响调度排班。
4. 海关扣留要盯：customs_hold 的箱会被看板高亮，优先处理——先解决扣留，再谈还箱，否则 LFD 照走、费用照算。
5. 司机手机端带 GPS：司机在手机端点状态按钮（到达码头、提箱完成等），位置自动上报。调度在看板上实时看到每台车到哪了，不用打电话问。

第三步：箱跟踪——LFD 是生命线#

1. 状态流转看箱在哪：on_vessel（在船上）→ at_terminal（到码头）→ out_for_delivery（出港派送中）→ at_customer（在客户处）→ empty_returned（空箱已还）。每个状态都有时间戳，客户问起箱在哪，一秒能答。
2. LFD 剩余≤2 天预警：系统按 last_free_day 算剩余免费天数，≤2 天自动预警。看到预警就两种动作：赶紧还箱，或者提前跟船公司谈延期。
3. 逾期费用按 per_diem_rate 累计：过了 LFD 还没还箱，系统按每条箱的 per_diem_rate（日费率）逐日累计费用。这笔钱最终要转嫁给责任方，数据越准越好谈。
4. 底盘维保到期提醒：每个底盘有 maintenance_due_date（维保到期日），临近自动提醒。别让“底盘年检过期”这种低级原因耽误提箱。
5. 还空箱闭环：empty_returned 是整单的终点。还箱完成、司机和底盘状态自动回到 available（空闲），可以接下一单。

第四步：完成与开票#

1. 订单完成：司机手机端确认送达/还箱后，订单状态流转到完成。司机和底盘自动回到 available，无需调度手动释放。
2. 生成 drayage 发票：按货主（merchant_id）汇总已完成订单生成发票。账龄按 due_date（到期日）计算，超期未付的一眼可见。
3. 催收跟进：collection_status 记录每张发票的催收状态（待催收/催收中/已回款等）。每周看一次超期账款清单，先催金额大、超期久的。
4. per diem 费用单独列：逾期产生的 per diem 费用建议在发票上单独列项，客户对账时一目了然，也减少扯皮。