商家注册流程
在发布运价或现仓前，需先注册并入驻为平台商家。普通用户与商家走同一入口，区别在于商家需平台审核营业执照。
-
进入注册页打开 登录 / 注册 页，点击右上「注册」页签切换到注册表单。
-
选择入驻角色在角色选项中选择：
· 普通用户：查询公开运价、跟踪物流、提交 VGM，免审核即刻使用；
· 商家入驻：可发布运价与现仓舱位，需平台审核营业执照通过后生效。 -
填写账号信息依次填写：手机号（即登录账号，11 位）→ 点击「获取验证码」收到短信后填入 → 设置密码（≥8 位且含字母）。
若系统要求图形验证码，先填写图中字符再获取短信码（图形码防脚本刷短信，一次性，发完自动换一张）。 -
补充商家资料选择「商家入驻」时，公司名称为必填项；选填绑定邮箱、联系人。普通用户无需公司名。
-
提交注册点击「注册并登录」：
· 普通用户 → 注册成功，直接进入客户中心；
· 商家 → 提示「执照待平台审核」，跳转商家工作台预览页（/merchant?onboard=pending）。 -
等待执照审核审核通过前，商家可在工作台预览，但不可发布运价 / 现仓。运营在后台审核营业执照通过后，账号获得「已验证商家」标签，方可发布。
注意：注册默认是普通用户。若想以商家身份发布，务必在注册时显式选择「商家入驻」并填写公司名称，否则账号只有客户权限。
多角色切换：一个手机号若拥有多个角色，登录后进入工作台选择页（
/role-chooser）切换对应工作台，各角色令牌独立、互不串号。运费发布流程
商家在运价管理工作台维护舱位运价。提交即公开上架、无需审核；但必须先获得「授权启运港」，且账号执照已审核通过。
-
进入运价管理以商家身份登录，进入运价管理工作台（
/freight-rates.html或商家工作台「运价管理」）。客户视图为只读，发布请用商家工作台。 -
申请启运港授权（首次发布前）若尚未分配授权航线，页面会提示「尚未授权任何启运港」。点击「申请开通」，勾选需要发布运价但尚未授权的启运港提交，由运营审核；通过后即可在该港发布。
-
新增一条运价点击「新增运价」，填写：方式（海运/空运/铁路/快递）、起运港、目的港（英+中）、截关、开船、有效期、四档箱型价格（20GP / 40GP / 40HQ / 45HQ）、可选附加费。
-
批量导入（可选）多条航线可点「批量导入 CSV」，下载模板按列填好后导入，系统自动上架。
-
提交并上架点击「发布 / 提交」，提示「提交后立即公开上架（运费发布无需审核）」。运价随即对全站公开查询可见。
-
标注发布来源（可选）勾选多条运价 → 点「设置来源」，填写发布方（如 聚合庄官方 / 自有品牌名）。来源仅用于区分庄家、船东与平台自营，不影响上架。
-
日常维护在列表行内可直接「编辑」或「删除」运价；价格变动请即时更新，保证公开比价准确。
只能发布已授权启运港的运价。未授权港口不可发布，需先走第 2 步申请开通。授权范围在页面顶部「可发布启运港」提示中可见。
运价 vs 现仓：运费发布无需审核、立即上架；而现仓发布需平台审核（见下一节），两者流程不同，请勿混淆。
批量报价操作流程
平台核心撮合机制：买家在首页查运价后，一键向该航线上的认证商家发起「批量真实报价」请求；各商家各自回价，买家对比后选定一家，选定瞬间双向交换联系方式。以下按买家操作视角拆解。
-
查运费并选定航线在首页 查运价 填写起运港 / 目的港查询；从搜索结果中勾选目标航线或具体商家。公开运价即时可见，无需登录。
-
发起批量报价点击「让选中商家报真实价 / 批量报价」按钮。系统将按航线匹配认证商家，向它们批量发起报价邀请。
-
登录账号（必须）未登录时会弹出引导浮层，要求先 注册 / 登录。只有登录后，本次询价才会绑定到你的账号、可在客户中心「我的询价」持续跟踪。未登录无法转化。
-
平台匹配并通知商家系统按航线筛选 licenseStatus=verified（已验证商家） 的认证商家，生成询价单，并通过站内信 + 免登录魔法链接 / 短信向候选商家发送报价邀请。未审核通过的商家不参与撮合。
-
等待报价在报价等待页（
quote.html?id=...）可实时查看进度「已通知 X 家 · 已报价 Y 家」。商家通常在短时间内回价，你无需守在页面，可稍后回客户中心查看。 -
对比各家真实报价进入报价对比页，逐家查看：海运费、币种、船公司、直航 / 中转、截关与开船日期、备注说明，按需排序筛选。
-
选定供应商点「选定这家」。选定即与对方双向交换联系方式（不可更改），并自动通知中标商家。选定前双方只见公司名，联系方式被锁定。
-
后续沟通（可选）在平台托管信道中与商家沟通细节；当沟通达到消息门槛且买家同意后，可解锁商家真实电话。沟通全程留痕，保障双方权益。
仅向已验证商家发起。批量报价只匹配 licenseStatus=verified 的认证商家；执照待审或未通过审核的商家不会收到邀请，也不会出现在候选中。
商家侧如何响应：商家在工作台「我的询盘」收到分配，填写海运费 + 币种 + 船期(ETA) + 船公司 + 直航/中转 + 备注后提交报价；也可通过魔法链接免登录回价；平台直报由运营在后台完成。报价出现后，买家上一步的对比页即实时刷新。
现仓发布流程
现仓是「一手现货舱位」，强时效、需平台审核。发布前需：商家账号执照已审 + 商家积分 ≥ 30（不足 30 发布按钮禁用）。
-
进入现仓上传商家工作台左侧点击「现仓上传」（
/merchant的 spot 视图）。若积分不足 30，顶部红条提示且提交按钮禁用。 -
填写航线信息必填：起运港、目的港、船公司/承运；选择箱型（20GP / 40GP / 40HQ / 45HQ，默认 40HQ）。
-
填写报价与时效填写船期/起飞、截关/截单、价格（基准价，不含附加费）、计价单位、币种（USD / CNY / EUR / HKD / GBP）。
-
填写库存与补充信息必填可售库存(柜)；选填备注、联系微信、联系人。
-
理解 48 小时强时效表单没有「有效期」字段。现仓统一按 提交发布起满 48 小时自动下架；若平台后续为你补录 SO 号，则以截关时间为准（可能更早）。无需也无法自行填写有效期。
-
提交审核点「提交审核」。状态流转：pending（待平台审核）→ approved（上架公开）。审核通过前不对公开商城可见。
-
跟踪剩余时效在「我的现仓」查看每条舱位剩余时间；不足 6 小时会标红闪烁提醒，到期自动下架。
只发真实舱位。平台要求发布自有 / 代理真实舱位，杜绝虚盘；价格为不含附加费的基准价，最终以 SO 确认为准。
客户下单后：舱位进入「待确认」，柜量先行锁定但库存暂不扣减；你点「确认接单」才真正扣库存（见下一节）。
现仓客户购买后 · 商家操作流程
客户在现仓商城以客户账号下单后，订单进入「待确认」。此时是软预占——柜量锁定但库存未扣，最终由商家确认或拒绝决定归属。
-
进入订单管理商家工作台左侧「订单管理」。待确认订单整行淡黄高亮 + 左侧色条，置于列表最前，提醒你尽快处理。
-
确认接单（扣库存）点「确认接单」→ 弹窗二次确认 → 系统立即扣减该现仓库存，并向客户开放你的联系方式（确认前客户只见公司名、联系方式被锁定）。提示该现仓剩余可销柜量。
-
拒绝订单（释放柜量）点「拒绝」→ 填写拒绝原因（会展示给客户，便于他改下其他舱位）→ 提交后柜量立即释放回可售库存。
-
超时自动取消订单进入待确认后 24 小时未处理，系统自动取消并释放柜量。请务必在时限内响应，避免真实舱位被占死。
-
放舱后填写 SO 号确认接单、放舱完成后，点「编辑」填写 SO 号 / 提单号 并保存，便于后续跟踪与对账。
-
其他管理动作还可手动取消订单（释放柜量）、修改订单状态、删除订单等，按需使用。
确认接单是唯一真正扣库存的动作，直接影响库存归属，请确认有真实舱位再点。软预占机制实时求和待确认量，避免「取消未释放」导致超卖。
防超卖三道闸：① 客户下单时按可销量校验；② 你确认时排除自身二次校验；③ 仍不足则自动取消并返回 409。联系方式可见性由后端统一控制，前端无法绕过。