g1_sipgl 系统级 Scenario 清单
本清单用于开发拆解和测试验证。颗粒度保持为“用户发起的一次写入数据库的操作请求”；纯 CRUD 直接写表单，涉及状态流转、联动生成、库存、费用、报文、打印、移动端动作时写 p_ 业务过程。
整理口径
HTML 版 Scenario 作为当前讨论主文档，旧 Markdown 清单保留为历史参考。
37当前 HTML 数据库设计中的业务对象/视图
85本版先整理的系统级写入 Scenario
5流程主线：4 条业务主线 + 公共能力
0本次只整理文档，不执行数据库写入
关键规则：单纯新增、编辑、删除的用户写入请求，表单列只写物理表单；按钮型提交、打印、叫车、确认、收费、报文、移动端作业等联动动作，表单/存储过程列只写被调用的
p_ 过程，不展开后台被写入的表。本次调整摘要
按《业务仓库一体化模拟业务数据.html》收敛旧 Scenario 口径。
| 旧口径 | 当前口径 | 对 Scenario 的影响 |
|---|---|---|
t_business_order_cargo | t_cargo | “进仓编号/单票货”统一落到 t_cargo，票级服务需求使用 t_cargo_service_request。 |
t_stock_lot | t_cargo + t_stock_movement + t_pile_card | 库存事实以单票货和库存流水表达，入库、上架、出库的验收点不再检查库存批次表。 |
t_gate_pass | t_vehicle_work_unit、t_warehouse_status_event、费用/收付款表 | “出门凭证”不作为当前核心物理表；离场事实由车辆作业单元、收费结果和状态事件共同表达。 |
| 多个监管报文子表 | t_regulatory_message | 报文生成、发送、回执、补发统一写入报文中心表。 |
核心对象映射
这里不是字段级设计，只用于 Scenario 编写时统一对象名称。
| 业务概念 | 当前对象 | 使用原则 |
|---|---|---|
| 业务主单 | t_business_order | 承载委托、流程主线、客户、方向、业务状态。 |
| 关封/报关扩展 | t_order_customs_ext | 承载关封号、报关属性、关封场景开票快照、车辆预约锚点和受理后的进仓作业关联。 |
| 进口业务扩展 | t_order_import_ext | 承载进口分拨、国际中转的提单、拆箱、分拨和中转属性。 |
| 进仓编号/单票货 | t_cargo | 业务生命周期最小主线，库存、费用、监管、提离、装箱都应能追溯到单票货。 |
| 提货装箱计划 | t_loading_plan + t_order_container | 统一装箱出运主线；一张计划对应一个目标箱，计划下可关联一票或多票 t_cargo。 |
| 仓库作业 | t_warehouse_job | 仓库受理后生成的现场计划和执行主对象；业务草稿、提交和预约阶段不提前生成。 |
| 车辆预约/现场车辆 | t_vehicle_work_unit | 预约阶段承载司机、车队、车牌、计划窗口和票车关系；仓库受理时关联仓库作业并进入排队、叫车、库门、离场等现场状态。 |
Scenario 清单
每行表示一次用户写入请求。搜索和顶部流程过滤会作用于下面全部表格。
列说明：PC 作业、移动端作业或 PC/后台混合动作放在“用户操作”格子的第一行标识；“表单/存储过程”用于标识 G1 标准表单、组合表单关系或业务库 p_ 过程；移动端节点需要同时列出页面加载/扫码校验所需的查询过程，以及用户提交动作的写入过程。
组合表单关系读法：同一层级的表表示 1:1 关系；缩进一层表示上一层表 1:N 当前表。存在组合表单关系树时，不再重复展示表名标签。
关封出口
从客户创建关封进仓计划，到仓库入库、进仓收费和入库监管数据异常处理。装箱出运已抽出为“统一装箱出运”，关封货入库完成后进入统一出口在库池，由提货装箱计划承接后续装箱、落箱和送港。
| ID | 场景 | 角色 | 前置条件 | 用户操作 | 表单/存储过程 | 系统处理逻辑 | 验收点 |
|---|---|---|---|---|---|---|---|
| A建单与进仓计划 | |||||||
| SIPGL-GF-ORD-001 | 保存关封进仓计划草稿 | 客户/货代 | 启用的客户权限账号可登录客户门户，账号已绑定委托客户；客户门户显示“新建监管货委托”，客户、仓库、业务类型及报关/关封基础资料可选取。 | PC 使用客户权限账号登录 → 进入客户门户 → 点击“新建监管货委托” → 等待客户新增表单及其动态组件加载稳定 → 填写主单、关封扩展、开票快照、车辆预约和票货信息 → 点击“保存”。 | 只允许客户角色从客户门户的客户裁剪视图创建；保存草稿数据并归属当前登录客户；草稿阶段生成进仓编号、票货和车辆预约，不生成仓库作业；开票快照挂在关封扩展，不挂业务主单。页面操作在加载遮罩消失、有限动画结束后继续，并保留短暂可视停顿。 | 登录账号角色为 customer，创建入口来自客户门户；草稿归属当前账号绑定客户并保持 DRAFT；草稿可再次编辑；进仓编号、业务主单、关封扩展、票货和车辆预约可互相追溯；不会生成仓库作业或进入可叫车队列；浏览器无运行时错误；回归结束后测试数据精确清理。 | |
| SIPGL-GF-ORD-002 | 提交关封单票货并自动受理 | 客户/货代 | 草稿资料完整，进仓编号、票货、预计进仓、车辆预约、开票快照已保存；存在适用的标准费收方案。 | PC 客户点击“提交”并确认。 | 标准工作流A401AF451C → 893048B109 写入p_submit_export_seal_order | 校验必填、业务类型和状态；自动匹配并关联标准费收方案，生成只关联主单和票货的进仓收费明细初版；写 DRAFT→SUBMITTED 提交事件后，标准工作流按 SUPERVISED 分支自动推进到 BUSINESS_ACCEPTED。关封不再等待人工业务受理，提交阶段不生成仓库作业。 | 客户提交后最终状态精确为 BUSINESS_ACCEPTED；业务单已关联标准费收方案；进仓编号保持唯一，初版费用与主单、票货关系完整且 Job 为空；主单和车辆均未关联仓库作业；不出现关封人工受理步骤；重复操作不产生重复事件或有效费用。 |
| SIPGL-GF-ORD-003 | 修改进仓计划时间 | 客户/货代、业务操作 | 关封进仓计划由客户提交后已自动业务受理，状态为 BUSINESS_ACCEPTED，仓库作业尚未生成；允许修改计划时间。 | PC 在关封进仓计划详情页点击“修改计划时间” → 系统立即提示“修改计划时间将产生计划更改费，是否继续？” → 选择“是” → 在参数框填写新日期、新预约时段和普通多行修改原因 → 提交。 | 标准操作前提警告（level=2） 写入p_update_inbound_plan_time | 动作先执行标准操作前提警告；选择“否”时终止，不打开参数框且不写业务数据。选择“是”后校验计划仍为 BUSINESS_ACCEPTED 且尚未仓库受理；更新车辆预约计划日期与时段；按现行正式计价主数据生成一条计划修改费用（计费项目“计划更改费”，每票 100 元）；费用只关联主单和票货；记录修改前后时间、动作 UUID 和费用关联事件，事件前后状态均为 BUSINESS_ACCEPTED。 | 标准警告先于参数框出现；修改原因是普通多行文本而非密码框；取消无副作用；成功后状态保持 BUSINESS_ACCEPTED，进仓编号、车辆和票货关系不变且仍无仓库作业；费用引用 P_STD_OPTIONAL / G_OPT_JHGG / D_OPT_JHGG 正式规则；相同目标时间拒绝且不重复收费。 |
| SIPGL-GF-ORD-005 | 打印送货通知单 | 客户/货代、业务操作 | 按当前 Scenario 顺序，前三步已经完成且计划为 BUSINESS_ACCEPTED；该状态由客户提交后自动取得，不再依赖关封人工业务受理。业务主单、进仓编号、票货、车辆预约和开票快照关系完整，仓库作业尚未生成。打印状态前提尚未明确，现阶段不启用状态操作前提。 | PC 客户账号登录门户，从“委托查询”的标准列表选择“业务已受理”，搜索并双击目标委托，在详情点击“打印送货通知单”。业务角色可从其授权业务菜单执行同一受控动作；不得通过强行访问 URL 绕过菜单权限。 | 标准打印报表sa_report_generate / r_gf_delivery_notice 写入p_print_inbound_delivery_notice | 标准系统接口 sa_report_generate 使用旧系统版式生成三页 A4 PDF：货物送货通知单、动态进仓标签、到仓路线图；不使用自定义 PDF 脚本。标签张数按进仓形态计算：loose_quantity > 0 时固定一张；没有散货时按大包装数量生成，单次最多 999 张。只有 PDF 成功生成后才写独立首次/补打履历；打印前后保持 BUSINESS_ACCEPTED，不创建打印状态或仓库作业。 | 动作配置为标准 sa_report_generate 且没有自定义打印 JS，状态操作前提处于停用状态；真实下载文件为三页 A4 PDF；同时覆盖“无散货→按大包装数量”和“有散货→固定 1 张”两个 Pattern；打印履历可追溯，业务状态及主单、票货、车辆、开票关系不变化，仓库作业仍为空；自动回归逐页保留最近回归画面。 |
| B送货受理与叫车 | |||||||
| SIPGL-GF-INB-001 | 受理关封送货车辆 | 仓库受理台 | 上一环节送货通知单已成功打印，计划仍为 BUSINESS_ACCEPTED；司机及预约车辆已到场；单票货未冻结；业务单、票货和车辆预约关系完整；首次受理前仓库作业尚未生成，且尚未叫车或开始作业。 | PC 仓库受理账号从“仓库管理 → 出口受理 → 进仓受理”进入，扫描送货通知单或录入进仓编号，核对委托、货物、预约车辆和到场状态后点击“仓库受理”并确认。需要撤销时，点击“撤销受理”并填写原因。 | 领域入口p_accept_inbound_vehicle 任务展开p_ensure_inbound_job_tasks 撤销入口p_inbound_acceptance_revoke | 校验当前账号角色、BUSINESS_ACCEPTED 状态、成功打印履历、关封业务类型、票货冻结状态、车辆到场状态和一对一关系；在同一事务内新建唯一 INBOUND/ACCEPTED 现场执行 Job，一次性展开该 Job 的完整任务链：卸车 GF_INB_UNLOAD / UNLOAD / PENDING / 10、理货 GF_INB_TALLY / TALLY / PENDING / 20、入库复核 GF_INB_REVIEW / REVIEW / PENDING / 30；任务均从“待处理”开始，先后关系由节点和顺序表达，叫车不改变任务状态；计划推进为 WAREHOUSE_ACCEPTED；车辆进入 WAITING 并生成排队号；写唯一 INBOUND_ACCEPT 事件。同一已受理业务单的重复请求只补齐缺失任务，不重复新增；撤销后重新受理则生成新的 Job 和任务链。撤销受理在同一事务中将原 Job 状态置为 VOIDED、保存 void_reason，并把该 Job 全部 Task 置为 CANCELLED；释放业务单、车辆的当前 Job 指针和排队资料，但保留原关联供审计；再次受理生成新 Job 和新任务链。Job 作废只使用 job_state，不保留重复的 voided 字段。 | 非仓库受理角色看不到真实菜单和工作流动作；业务未受理、无成功打印履历、票货冻结、车辆未到场、关系断裂或已叫车时均阻断且无副作用；受理前 Job/Task 均为 0，受理后 t_warehouse_job 唯一且为 ACCEPTED；同一 Job 下恰好存在卸车、理货、入库复核三条任务，类型为 UNLOAD/TALLY/REVIEW、初始状态均为 PENDING、顺序为 10/20/30，且 job/票货/车辆/仓库关联全部正确；任务状态只能为“待处理、作业中、暂停、已完成、已取消”；t_vehicle_work_unit 处于 WAITING；既有打印履历不变化；只新增一条 INBOUND_ACCEPT 事件；重复受理 task ID 集合不变。撤销后原 Job 状态为 VOIDED、作废原因有效，其三条任务全部为 CANCELLED，且只写一条原生 CANCEL 事件；即使旧任务已经开始或完成，撤销后仍全部变为 CANCELLED；重新受理后的 Job ID 和 Task ID 均不得复用原作废对象。 |
| SIPGL-GF-INB-002 | 叫下一车并指定库门 | 仓库现场操作员 | 存在已受理车辆，月台/库门可用，移动端进仓作业入口可见待叫车队列。 | 移动端 在进仓作业入口点击“叫下一车”，在叫车确认页选择库门并确认。 | 查询p_mobile_get_inbound_call_queue 写入p_mobile_call_next_inbound_vehicle | 按队列规则锁定推荐车辆；保存库门；写车辆作业单元叫车状态；激活进仓仓库任务。 | 叫车确认页展示业务形态、货物属性、大件属性、车辆/票数；确认后车辆进入场内作业中，库门占用可见。 |
| C卸车、理货与入库复核 | |||||||
| SIPGL-GF-INB-003 | 确认车牌并开始卸车 | 装卸工、叉车工 | 车辆已叫入库门，单票货处于待卸车；可扫描送货通知单二维码，或手工输入进仓编号。 | 移动端 原型 05-A0/05-A0a：扫描送货通知单或手工输入进仓编号，核对车牌后点击“确认车牌并开始卸车”。 | 查询p_mobile_get_unloading_task 写入p_mobile_start_inbound_unloading | 校验进仓编号、车牌、库门、状态和人员权限；任务进入卸车中；记录卸车开始时间和操作人。 | 状态不是待卸车时阻断；卸车中时仅已登记装卸工/叉车工可继续作业；任务时间线出现开始卸车记录。 |
| SIPGL-GF-INB-004 | 登记协助卸车人员 | 装卸工、叉车工、协助人员 | 卸车任务进行中，需要其他人员协助。 | 移动端 原型 05-A2/05-A3：发起协助二维码，协助人员扫码确认。 | 查询p_mobile_get_unloading_assist_info 写入p_mobile_confirm_unloading_assistant | 校验二维码有效期、任务状态和人员身份；写 t_warehouse_task_assistant；二维码确认后失效。 | 协助人员出现在任务协作人员中；未登记人员不能继续当前票卸车；二维码过期或任务结束后不能确认。 |
| SIPGL-GF-INB-005 | 完成卸车 | 装卸工、叉车工 | 卸车任务进行中，必拍照片已满足或允许补拍，液压车使用情况可确认。 | 移动端 原型 05-A/05-A1：完成卸车，选择是否使用液压车。 | 查询p_mobile_get_unloading_task 写入p_mobile_finish_inbound_unloading | 保存卸车全景、货物外观等照片状态；记录是否使用液压车；任务进入待理货；写卸车完成时间。 | 照片规则、液压车选择和卸车完成状态可查；完成后回到进仓作业入口，票货进入可理货范围。 |
| SIPGL-GF-INB-006 | 确认开始理货 | 理货员 | 卸车已完成，单票货处于待理货；尚未分配理货员。 | 移动端 原型05-B0 原型 05-B0：第一次扫描/确认进仓编号时，点击“确认开始理货”。 | 查询p_mobile_get_tally_start_info 写入p_mobile_start_inbound_tally | 校验进仓编号、状态和理货员占用；首次开始时锁定当前理货员并记录开始时间；同一理货员中途退出后再次扫码直接进入理货页面；其他人员再次理货被阻断。 | 一票货只出现一次“确认并开始理货”；理货员锁定为首次确认人员；同一理货员可继续未完成理货；其他人员不能接管。 |
| SIPGL-GF-INB-007 | 保存测量数据 | 理货员 | 理货任务进行中。 | 移动端 原型05-B1 原型 05-B1：录入单件、整托、拉板等测量规格，保存全部测量数据。 | 查询p_mobile_get_measurement_info 写入p_mobile_save_measurement | 保存测量类型、包装类型、件数、长宽高、唛头；支持多条规格；阻断校验包括长不能小于宽、宽度不能大于 2.4 米、高度不能大于 2.7 米、非大件货三边码超过 12 米、非大件货单条记录超过 4 CBM、测量规格重复、总件数大于委托件数。测量体积与委托体积差异过大为提示性校验，操作人员确认后可继续保存。 | t_warehouse_measurement 可按进仓编号查询；阻断项不保存；提示性差异需展示并记录操作人确认结果。 |
| SIPGL-GF-INB-008 | 保存做关数据 | 理货员 | 理货任务进行中，散货需要现场做关。 | 移动端 原型05-B2 原型 05-B2：录入关号和对应件数，点击保存做关数据。 | 查询p_mobile_get_customs_split_info 写入p_mobile_save_customs_split | 保存关号分配和件数；校验合计数量不超过理货实收数量。 | 关号分配可追溯到进仓编号；数量校验失败时不保存。 |
| SIPGL-GF-INB-009 | 指定理货库位 | 理货员 | 理货任务进行中，库位可用。 | 移动端 原型 05-B3/05-B3a：选择库位后查看该库位下小库位占用情况，点击小库位分配货物占用。 | 查询p_mobile_get_location_suggestp_mobile_get_sublocation_occupancy 写入p_mobile_save_tally_location | 保存一票货的小库位占用分配；不做货物类型适配控制；按所选库位返回小库位占用情况供用户分配。 | 同一进仓编号可有多条小库位占用记录；保存后理货页面可查看已分配库位；入库复核不依赖库位信息。 |
| SIPGL-GF-INB-010 | 保存残损、照片和仓库服务 | 理货员 | 理货任务进行中。 | 移动端 原型 05-B4/05-B5/05-B6：记录残损类型和件数，拍理货/残损照片，选择液力车、打托、货主标签等服务。 | 查询p_mobile_get_tally_task_info 写入p_mobile_save_tally_exception_photo_service | 保存残损记录、照片留痕和服务选择；严重异常可生成控制申请或冻结。 | 残损照片满足必拍规则；服务记录可用于后续费用生成；异常原因和证据可追溯。 |
| SIPGL-GF-INB-011 | 打印桩脚牌并完成理货入库 | 理货员、仓库打印点 | 测量、做关、库位、残损/照片等必需理货任务已完成。 | 移动端 原型05-B 原型 05-B：点击“打印桩脚牌”。 | 查询p_mobile_get_pile_card_print_info 写入p_mobile_print_pile_card | 生成桩脚牌编号并打印；绑定进仓编号、库位分布和理货结果；记录打印批次；同步写入入库库存流水、单票货在库状态和进仓作业已入库状态，并记录入库完成时间；按旧系统 00-T4 货物入库上架口径生成待发送监管报文草稿。 | t_pile_card 可扫码且显示入库时间；桩脚牌数量与理货/库位分布一致；t_stock_movement 有入库流水，t_cargo 为在库；t_regulatory_message 可按进仓编号查到入库上架报文草稿或失败原因。 |
| SIPGL-GF-INB-012 | 确认开始入库复核 | 复核员 | 桩脚牌已打印，单票货处于待入库复核。 | 移动端 原型05-C0 原型 05-C0：确认进仓编号，点击“确认开始入库复核”。 | 查询p_mobile_get_inbound_review_start_info 写入p_mobile_start_inbound_review | 校验进仓编号和状态；任务进入入库复核中；记录复核开始时间和操作人。 | 入库复核页面展示客户标签、桩脚牌、照片要求和库位信息；非待复核状态阻断。 |
| SIPGL-GF-INB-013 | 完成入库复核 | 复核员 | 桩脚牌已打印，货物已在库，待做入库复核扫码校验。 | 移动端 原型 05-C/05-C1：扫描桩脚牌，点击“入库复核完成”。 | 查询p_mobile_get_inbound_review_info 写入p_mobile_scan_inbound_review_labelp_mobile_finish_inbound_review | 保存桩脚牌扫码复核结果和入库照片；不写入库库存流水，不改变单票货在库状态，不依赖库位信息。 | 重复扫码不计数；全部应复核桩脚牌通过后才能完成；复核结果可按进仓编号追溯。 |
| SIPGL-GF-INB-014 | 入库复核扫码异常冻结 | 复核员 | 入库复核连续扫码中。 | 移动端 原型 05-C3/05-C4：扫到不属于当前进仓编号的桩脚牌，确认错误提示。 | 查询p_mobile_get_inbound_review_info 写入p_mobile_freeze_inbound_review_by_scan_error | 立即冻结入库复核任务；保存扫描桩脚牌、基准进仓编号和异常原因；生成仓库控制申请或状态事件。 | 页面提示“入库作业已冻结”；后续复核按钮不可继续；异常记录可由主管处理。 |
| D进仓收费 | |||||||
| SIPGL-GF-FEE-001 | 最终计算关封进仓费用 | 仓库受理台、财务 | 收费明细初版已随进仓计划提交生成，货物已入库或进仓作业已完成，司机到受理台结账。 | PC 受理台打开进仓收费页面，点击最终计算。 | p_finalize_inbound_fee | 基于进仓编号、仓库作业、车辆作业单元和最终计费规则重算/更新既有 t_fee_detail；每条费用明细标识现结或月结，汇总现结总额和月结总额供受理台确认。 | 费用明细可追溯到 t_cargo、t_warehouse_job、t_vehicle_work_unit；现结/月结标识、单项金额、现结合计和月结合计正确。 |
| SIPGL-GF-FEE-002 | 确认进仓收费、开票并放行 | 仓库受理台、财务 | 进仓费用已最终计算，现结合计和月结合计已确认，客户满足现结收款或月结放行条件。 | PC 收取现结总额，确认月结部分，联动开票并打印出门单。 | p_confirm_inbound_payment | 校验费用状态和客户结算条件；现结时写收付款与核销记录；月结时标记结算方式；联动招商聚合平台开具增值税普通发票；车辆作业单元进入可离场状态；生成或打印出门单。 | 费用状态与收付款/核销状态一致；增值税普通发票结果可追溯；未收费或未满足月结条件时不能放行；车辆后续可进入离场确认，出门单可打印。 |
| E监管数据异常处理 | |||||||
| SIPGL-GF-MSG-001 | 补发或重生成关封入库监管数据 | 报文人员、业务操作 | 票货已入库，入库上架报文草稿生成失败、发送失败，或需按最新桩脚牌/库位信息重生成。 | PC 在报文中心选择进仓编号或失败报文，点击补发/重生成。 | p_regenerate_inbound_goods_message | 按旧系统 00-T4 货物入库上架口径重建 t_regulatory_message payload；保留原报文、失败原因和补发链路；不重复改写库存和入库状态。 | 报文中心可按进仓编号追溯原始失败记录、重生成记录和发送回执；补发不会重复产生库存流水或重复完成入库。 |
统一装箱出运
从提货装箱计划草稿、预录、受理、叫车、装箱确认，到暂落、监管报文、出库核对、装箱复核、执行装箱、箱体作业、收费和委托送港。适用于关封出口货、入库报关货、国际中转货及混装箱；每票货继续保留自身进仓编号和业务来源。
| ID | 场景 | 角色 | 前置条件 | 用户操作 | 表单/存储过程 | 系统处理逻辑 | 验收点 |
|---|---|---|---|---|---|---|---|
| A提货装箱计划 | |||||||
| SIPGL-COM-OUT-001 | 保存提货装箱计划草稿 | 客户/货代、业务人员 | 所选出口委托已形成正式单票货物对象，处于可进入提货装箱计划状态；目标箱、船名航次、出境地和计划时间可维护。 | PC 从 G1 标准配置的提货装箱计划列表点击“新建提货装箱计划”，录入目标集装箱、箱号、箱型、封志、船名航次、出境地、计划到场时间和送港方式，并在计划内点击“添加出口委托”选择一票或多票在库货物；箱内本港普货需要在监管仓内报关时标注“入库报关”，校验通过后保存草稿。出口委托列表不再提供勾选后生成提货装箱计划的反向入口。 | 保存提货装箱计划草稿和目标箱信息；建立计划与单票货物之间的关联，保留关封出口、入库报关、国际中转等业务来源；校验仓库、出境地、货物可用状态和共同装箱条件；根据入库报关选择和货物组成预判出口运抵、国际中转准单及监管放行控制链路；不改变库存，不建立待叫车任务。 | 提货装箱计划列表保持 G1 标准配置列表；一张计划对应一个目标集装箱，可关联一票或多票出口委托；重复占用、状态不允许、仓库或出境地不一致时阻断保存并明确提示；国际中转货不因客户未标注“入库报关”而阻断草稿保存；草稿不生成实际收费明细。 | |
| SIPGL-COM-OUT-002 | 提交提货装箱计划并发送预录报文 | 客户/货代、业务人员 | 提货装箱计划草稿资料完整，目标箱和货物范围已确定，费用方案有效，计划内货物未被其他有效计划占用。 | PC 点击“提交计划”。 | p_submit_unified_loading_plan | 校验计划、集装箱和货物关系；校验入库报关选择与货物组成；客户标注入库报关或计划内存在国际中转货时，确定进入箱级出口运抵及后续监管链路；锁定目标箱和计划货物范围；生成收费明细初版、预录报文及提交履历，不生成仓库作业。 | t_fee_detail 有初版费用且幂等；预录报文三类业务共用，不按关封/入库报关/国际中转拆分；仓库作业等待仓库受理时生成。 |
| SIPGL-COM-OUT-003 | 修改已提交的提货装箱计划 | 客户/货代、业务人员 | 计划已提交，尚未进入不允许修改的仓库受理或现场作业节点，当前用户具备修改权限。 | PC 修改计划时间、车辆、箱号或其他允许调整的信息，并确认保存。 | p_update_unified_loading_plan | 校验当前状态和可修改范围；更新计划及预约车辆/箱信息；保存修改前后内容和操作履历；必要时重新判断预录报文处理；按规则生成“计划更改费”。业务人员可按费用权限调整或删除该收费明细，保留履历。 | 计划修改可追溯；计划更改费关联提货装箱计划、目标箱、修改前后时间、触发原因、费用方案和生成来源；重复修改按规则合并或生成，不重复有效收费。 |
| B受理与叫车 | |||||||
| SIPGL-COM-OUT-004 | 仓库受理提货装箱计划 | 客户司机、仓库受理台 | 计划已提交，预录报文已有发送结果或符合现场受理条件；客户车辆和集装箱到场，状态为已提交待受理。 | PC 司机出示提货装箱计划相关单据；受理台按计划号或计划内进仓编号查询，核对箱号、车辆、送港方式、预录结果和计划资料后点击“受理”。洋山查验分流场景下，可将“委托送港”调整为“自送港”。箱内货物明细只读，不提供勾选、出库核销、入库委托、打印提货通知单或从计划中删除等操作。 | p_accept_unified_loading_plan | 校验计划中预约阶段已有车辆作业单元；生成或激活出仓仓库作业并关联已有车辆作业单元；车辆进入装箱出运待叫车队列；记录实际受理时间并与计划窗口比较，超窗口时生成计划更改费但不阻断后续叫车。若委托送港改为自送港，取消或不生成未结算的落箱费、送港费。 | t_warehouse_job 受理后生成；t_vehicle_work_unit 进入待叫车；受理条件和预录结果清晰可见；货物明细无操作列和操作按钮；超窗口费用可追溯；受理本身不生成装箱费、暂落费、落箱费或送港费。 |
| SIPGL-COM-OUT-005 | 首次叫车并指定库门 | 仓库现场操作员、装卸人员 | 提货装箱计划已受理，系统排序得到的下一辆车辆处于待叫车状态，库门和叫车名额可用。 | 移动端 确认系统排序得到的下一辆待叫车辆，选择库门并点击“确认叫车”。 | 查询p_mobile_get_loading_call_queue 写入p_mobile_call_next_loading_vehicle | 占用叫车名额；保存库门；车辆进入库门；激活装箱确认任务。叫车目的首先是让客户车辆带箱进入现场完成装箱确认，不代表一定立即开始装货。 | 页面只展示系统推荐的下一辆车，不提供人工跨队列挑车；车辆出现在场内装箱确认任务中；库门占用可见；本节点不生成收费明细。 |
| C装箱确认与路径判定 | |||||||
| SIPGL-COM-OUT-006 | 完成装箱确认并确定作业路径 | 装卸工、装箱确认员 | 车辆到达库门，箱号和计划有效，箱体可检查。 | 移动端 核对箱号，按原型拍摄必需的开箱门照片；箱内、箱况等其他照片通过“补充类型”按现场需要追加。选择掏箱方式和“不暂落/暂落区/大件区”，必要时记录特殊处理并完成装箱确认。 | 查询p_mobile_get_loading_confirm_info 写入p_mobile_confirm_loading_ready | 保存装箱确认记录、照片、掏箱方式和是否暂落；入库报关箱必须暂落，手机端在此作为逻辑校验项阻断“不暂落”。其他货物按计划数据、现场条件和线下监管判断选择路径；暂落时生成空箱暂落指令。生成或补齐客户车辆离场前可确定的出库必收费用，后续按实际作业调整。 | 装箱确认完成时间、开箱门照片、掏箱方式和暂落选择可查；入库报关箱选择“不暂落”时明确阻断；暂落指令正确生成；不因预判费用重复生成相同有效费用。 |
| D暂落、监管与提箱上板 | |||||||
| SIPGL-COM-OUT-007 | 执行空箱暂落 | 正面吊司机、调度 | 装箱确认选择暂落路径，调度或后台已分配空箱暂落指令。 | 移动端 正面吊司机选择已分配的暂落指令，核对箱号，将空箱从客户车辆转移至暂落区并确认完成。 | 查询p_mobile_get_equipment_instruction_boardp_mobile_get_equipment_instruction_list 写入p_mobile_finish_equipment_instructionp_mobile_report_equipment_instruction_exception | 记录空箱暂落事实、暂落位置、设备指令结果和箱操作；客户车辆与集装箱解除当前作业绑定；按费用方案确认或生成暂落费、正面吊作业费等实际发生费用。 | t_equipment_instruction 完成结果正确；暂落位置可查；不得仅因生成指令就重复生成正式收费明细。 |
| SIPGL-COM-OUT-008 | 发送出口运抵及国际中转准单 | 业务人员、报文人员 | 装箱确认已完成，空箱已实际暂落，计划内货物与箱号关系确定，报文资料完整。 | PC 在提货装箱计划“报文”页签读取入库报关选择和货物组成，先手工发送箱级出口运抵并查看发送状态、回执和失败重试；运抵成功后，计划内存在国际中转货时逐票发送国际中转准单。 | p_send_loading_arrival_and_transit_permit | 客户已标注入库报关时发送箱级出口运抵；客户未标注但计划内存在国际中转货时仍发送箱级出口运抵，并按国际中转货逐票发送准单；保存报文版本、发送记录和回执，失败转报文中心。 | t_regulatory_message 可追溯箱级运抵和逐票准单；运抵未成功时准单操作不可用；失败可重试且保留原失败履历；发送报文本身不重复生成仓库作业费用，重发不得重复收费。 |
| SIPGL-COM-OUT-010 | 将暂落箱提箱上板 | 正面吊司机、调度 | 仓库已线下判断出口运抵、国际中转准单、查验、放行或其他适用监管条件满足；调度已分配从暂落区至装箱库门作业板的提箱上板指令。系统不另设“开启真实装箱任务”操作入口。 | 移动端 正面吊司机选择提箱上板指令，核对箱号和目标库门，从暂落区提取空箱并转移至装箱作业板后确认完成。 | 查询p_mobile_get_equipment_instruction_boardp_mobile_get_equipment_instruction_list 写入p_mobile_finish_equipment_instructionp_mobile_report_equipment_instruction_exception | 更新箱体当前位置；提货装箱计划进入可执行出库核对和装箱复核的现场状态；按费用方案确认正面吊转移、箱体搬移等实际发生的设备服务费用。 | 车载机展示“提箱上板”且路线为暂落区至目标库门；同一次转移只形成一笔有效作业事实；设备作业收费明细幂等。 |
| E出库核对、装箱复核与执行装箱 | |||||||
| SIPGL-COM-OUT-011 | 完成出库核对 | 装箱作业人员 | 装箱确认已完成；立即装箱路径的集装箱位于库门，或暂落路径已完成提箱上板；应装货物在库且无冻结阻断。出库核对与装箱复核互不作为对方的前置条件。 | 移动端 确认箱号，扫描应装货物标签，按原型完成货物核对和必拍照片，点击“出库核对完成”。 | 查询p_mobile_get_loading_execute_info 写入p_mobile_scan_loading_pile_cardp_mobile_submit_loading_ready_for_review | 校验货物属于当前计划且在库可出运；保存标签扫码、核对结果和照片；异常标签、冻结、数量不一致或未解除异常时阻断；完成后仅更新出库核对结果，不要求装箱复核已完成，也不写库存流水。 | 箱号确认、逐票核对进度、扫码结果、照片、人员和完成时间可追溯；装箱复核可在本步骤之前或之后完成；未完成本步骤时不得进入执行装箱。 |
| SIPGL-COM-OUT-012 | 完成装箱复核 | 装箱复核员 | 装箱确认已完成；集装箱位于可装货位置；应装货物可供复核。装箱复核与出库核对互不作为对方的前置条件。 | 移动端 扫描应装货物桩脚牌，拍摄复核照片，所有货物核对通过后点击“装箱复核完成”。 | 查询p_mobile_get_loading_review_info 写入p_mobile_scan_loading_review_labelp_mobile_finish_loading_review | 保存复核扫码结果和照片；校验全部应装货物通过；完成后仅更新装箱复核结果，不要求出库核对已完成，不写出库库存流水，不完成提货装箱计划，不生成收费明细。 | 复核结果、人员和时间可追溯；出库核对可在本步骤之前或之后完成；未完成本步骤时不得进入执行装箱。 |
| SIPGL-COM-OUT-013 | 执行实际装箱并确认装箱完成 | 装箱作业人员、叉车工 | 装箱确认、出库核对和装箱复核均已完成；出库核对与装箱复核的先后顺序不限；集装箱位于可装货位置，不存在未处理的阻断异常。 | 移动端 扫描配载单进入“执行装箱”；系统先校验装箱确认、出库核对和装箱复核均已完成。通过后逐票将货物实际装入目标集装箱，拍摄过程和装箱完成照片，记录材料、耗材、人工、大件监护、暂停或交班等特殊动作，确认全部计划货物装入后点击“装箱完成”。 | 查询p_mobile_get_loading_execute_info 写入p_mobile_save_loading_extrap_mobile_submit_loading_special_actionp_mobile_finish_loading | 进入页面前校验三个前置作业；任一未完成即阻断并返回。通过后记录装箱开始、完成时间和操作人；保存最终箱货关系；写出库库存流水，更新计划内货物出库状态、提货装箱计划和仓库作业装箱结果；发送电子装箱单；按实际装箱结果生成、确认或调整票级和箱级收费明细。 | t_stock_movement 有出库流水；t_cargo 更新为已出库；任一前置未完成时不能进入执行装箱；电子装箱单可追溯；不同票的票级装箱费不得合并成箱级费用。 |
| F箱体作业、收费与送港 | |||||||
| SIPGL-COM-OUT-014 | 执行装箱完成后的箱体作业 | 正面吊司机、仓库现场人员 | 装箱已完成；系统已根据提货装箱计划中的“委托送港/自送港”和装箱确认中的“是否暂落”，结合箱体当前位置确定所需的落箱或提箱上车指令，无需另设 PC 箱体去向确认页面。 | 移动端 正面吊司机选择系统已派发的落箱或提箱上车指令，核对箱号、当前位置和目标位置后确认完成。 | 写入p_mobile_finish_equipment_instruction | 按送港方式和是否暂落字段形成的设备指令记录实际箱体作业结果；以实际作业结果确认或调整装箱确认阶段预生成的落箱费、委托送港费及设备作业费。自送港且原车直接重箱离场时不生成设备指令，不得保留未实际发生的落箱费或委托送港费。 | 箱操作链路能看到落箱、提箱上车和箱体当前位置；指令类型与送港方式、是否暂落字段一致；费用按实际发生确认或调整；同一箱体作业事实不得重复收费。 |
| SIPGL-COM-OUT-015 | 客户车辆结费并打印出门单 | 仓库受理台、财务、客户司机 | 客户车辆当前路径已达到可离场条件：空箱暂落完成、原车装箱后重箱落箱完成，或原车自送港装箱完成；当前已产生或可确定费用已汇总。 | PC 费用页与结费交互暂缓设计；本 Scenario 仅保留业务口径，暂不作为 PC 原型画面验收项。后续页面应由受理台汇总收费明细，区分现结和月结，收取现结部分，确认月结部分，联动开票并打印出门单。 | p_confirm_loading_payment | 写收款及核销记录；按规则联动开票；生成并打印出门单；车辆作业单元进入可离场状态。暂落后续装箱产生的费用仍归集到原提货装箱计划，不因司机已经离场而遗漏，也不在送港车辆节点重复收费。 | 当前阶段只验收业务规则和数据归集，不验收费用页交互；页面设计恢复后再补客户车辆放行、费用、发票、收款、月结标记和出门单的一致性验收。 |
| SIPGL-COM-OUT-016 | 创建委托送港任务并派发提箱上车指令 | 送港调度 | 提货装箱计划送港方式为委托送港；装箱完成，重箱已落至可提箱位置；可安排送港车辆。 | PC 调度页面暂缓设计；后续由调度选择送港车辆，绑定箱号并派发提箱上车指令。本 Scenario 保留为独立写入动作，不与车载机完成指令或车辆离场确认合并。 | 调度页面与过程待设计 | 后续实现应建立委托送港任务，绑定箱号与送港车辆并生成提箱上车设备指令；不得在本节点写提箱完成或车辆离场事实。 | 当前阶段只验收 Scenario 粒度和前置数据口径，不验收调度页面；页面与过程设计确认后补充任务、车辆、箱号和指令的幂等验收。 |
| SIPGL-COM-OUT-017 | 确认委托送港车辆提箱上车 | 正面吊司机 | 委托送港任务已建立，送港车辆与箱号已绑定，提箱上车指令已分配。 | 移动端 正面吊司机选择提箱上车指令，核对箱号、送港车牌和库门，将重箱提至送港车辆后确认完成。 | 写入p_mobile_finish_equipment_instruction | 记录提箱上车事实和设备指令完成结果；不同时确认车辆离场，不新增、不确认客户收费明细。 | 送港车辆与箱号关系准确；提箱上车时间、设备和操作人可追溯；委托送港费用不在本节点重复收费。 |
| SIPGL-COM-OUT-018 | 确认委托送港车辆离场 | 送港调度、仓库现场人员 | 送港车辆已完成提箱上车，道闸或现场确认车辆可以离场。 | PC 车辆离场确认页面随调度页面暂缓设计；后续由调度或现场人员独立确认送港车辆离场。 | p_confirm_port_delivery_departure | 记录送港车辆离场事实并更新送港状态；不修改提箱上车指令结果，不新增、不确认客户收费明细，不办理客户现场收费、不开票、不打印客户结费出门单。 | 当前阶段只验收离场动作独立于提箱上车；页面恢复设计后补车辆、箱号、离场时间、操作人和送港状态的可追溯验收。 |
进口分拨
当前口径为 IMP-01 至 IMP-22：进口委托、箱/HBL 清单、监管报文、拆箱理货与自动分票入库、海关放行维护、客户查验/提货预约、单票提离，以及国际中转两港联动。客户货物查询在业务单据录入完成后即开放，不以入库完成为前提。
| ID | 场景 | 角色 | 前置条件 | 用户操作 | 表单/存储过程 | 系统处理逻辑 | 验收点 |
|---|---|---|---|---|---|---|---|
| A进口委托与HBL清单 | |||||||
| SIPGL-IMD-IMP-001 | 建立进口分拨委托 | 业务人员 | 客户、联系人、结算/开票资料、船名航次、MBL、箱预报和费用方案可确认。 | PC 新建进口分拨委托，选择客户、结算主体、开票快照、MBL、船名航次、ETA、箱预报和费用方案后保存。 | 保存进口分拨委托草稿，记录费用方案版本和基础单证信息；建单阶段不生成正式收费明细。 | 委托号可查询；费用方案版本可追溯；未生成 t_fee_detail。 | |
| SIPGL-IMD-IMP-002 | 维护MBL、集装箱与HBL清单 | 业务人员 | 进口分拨委托已保存，客户提供箱单/HBL清单。 | PC 维护 MBL、箱号、封志、HBL 清单、品名、理论件毛体和业务去向；可手工录入或导入清单。 | 每个 HBL 生成唯一进仓编号和分拨提单号；业务去向仅允许国内分拨或国际中转；理论数据与后续实际理货数据分层保存。 | HBL 不重复；每票都有进仓编号、分拨提单号和业务去向；理论差异可记录但正式申报前必须处理。 | |
| B监管申报与提箱准备 | |||||||
| SIPGL-IMD-IMP-003 | 申报进口分拨舱单 | 报文人员、业务人员 | MBL、箱信息、HBL 理论清单完整。 | PC 在业务上下文页面点击发送进口分拨舱单。 | p_send_import_distribution_manifest | 按箱级生成进口分拨舱单报文，记录版本、发送状态和回执；失败、重发、更正和撤销转报文中心处理。 | t_regulatory_message 有箱级舱单报文和回执；本节点不生成客户应收费用。 |
| SIPGL-IMD-IMP-004 | 维护到港、卸港与换单 | 业务人员 | 船舶动态、卸港、换单资料由业务人工确认。 | PC 录入 ATA、卸港时间、码头出场准备、换单状态和相关附件。 | 仅记录人工查询和换单结果；本期不做港航纵横自动集成，不自动产生进口分拨包干费。 | 到港/卸港/换单履历可查；附件可追溯；费用明细不因本节点自动产生。 | |
| SIPGL-IMD-IMP-005 | 发送分拨申请并确认整箱大报关完成 | 业务人员、报文人员 | 舱单报文可用，换单和申报资料满足进口分拨申请条件。 | PC 发送进口分拨申请；收到受理后确认整箱大报关完成。 | 写入p_submit_import_distribution_applicationp_confirm_import_container_customs_done | 生成进口分拨申请报文并接收回执；确认整箱大报关完成后锁定 HBL 理论版本，已被监管接受的版本不得普通覆盖。 | 申请回执可查；大报关完成状态明确；HBL 理论数据被锁定；不生成包干费。 |
| SIPGL-IMD-IMP-006 | 安排车辆、打印纸质拆箱清单并完成码头提箱 | 业务人员、调度 | 进口分拨申请已受理，整箱大报关完成，码头可提箱。 | PC 安排一箱一车，打印纸质拆箱清单，并记录码头提箱/出场事实。 | 写入p_arrange_import_pickup_vehiclep_print_import_devanning_listp_record_terminal_container_pickup | 生成进口箱车辆作业单元和纸质拆箱清单打印履历；记录码头提箱、出场和供应商成本触发依据。 | 一箱只关联一辆提箱车辆；纸质拆箱清单版本可追溯；客户包干费仍未生成。 |
| C进仓受理与拆箱理货 | |||||||
| SIPGL-IMD-IMP-007 | 纸质拆箱清单受理并进入进仓叫号队列 | 仓库受理台 | 司机持当前纸质拆箱清单到仓，车辆已到场。 | PC 扫描纸质拆箱清单，核验任务和车辆基础信息；可打印拆箱清单，并执行工作流“拆箱仓库受理”。 | imd_print_devanning_listWHDEACC001 → p_devanning_acceptance_accept_by_order | 受理台只校验纸质清单和基本任务信息，不做箱体、封志、外观和货物实物核验；创建进仓拆箱仓库作业，关联 IMP-006 已生成的车辆作业单元并加入叫号队列，进入队列不占用叫号名额。 | t_warehouse_job 受理后生成；IMP-006 生成的 t_vehicle_work_unit 状态进入已受理/待叫号；运抵报文触发点保持可配置。 |
| SIPGL-IMD-IMP-008 | 叫号进场并完成开箱前实体核验 | 仓库现场人员 | 拆箱车辆在进仓叫号队列中，叫号名额可用。 | 移动端 现场叫号，车辆进拆箱区后核验车牌、箱号、封志、箱况和纸质清单。 | 查询p_mobile_get_import_devanning_call_queue 写入p_mobile_call_import_devanning_vehiclep_mobile_confirm_import_container_check | 确认叫号时占用统一叫号名额；实体核验通过后允许拆箱；若运抵报文配置在实体核验后触发，则满足发送条件；异常冻结时释放名额。 | 叫号、进场、实体核验和异常履历可查；未通过实体核验不能进入拆箱。 |
| SIPGL-IMD-IMP-009 | 开箱并完成整箱拆箱 | 装卸工、仓库现场人员 | 开箱前实体核验通过，HBL 理论清单已锁定。 | 移动端 原型05-D 扫描拆箱清单，拍摄开箱必拍照片，确认开箱并完成整箱拆箱。 | 查询p_mobile_get_import_devanning_task 写入p_mobile_start_import_devanningp_mobile_finish_import_devanning_physical | 记录开箱和整箱拆箱事实；释放拆箱车辆，按 HBL 生成后续逐票理货任务。本步骤不填写逐票理货结果、不生成桩脚牌或入库流水。 | 开箱照片、操作人和时间可追溯；整箱拆箱完成后每票 HBL 都有且只有一条待理货任务。 |
| SIPGL-IMD-IMP-010 | 按HBL逐票理货 | 理货员 | 整箱拆箱已完成，当前 HBL 的理货任务待执行。 | 移动端 逐票核对 HBL，录入实际件毛体、测量/做关结果、残损、照片、附加服务和大库位。 | 查询p_mobile_get_import_hbl_tally_info 写入p_mobile_save_import_hbl_tally | 实际理货数据与锁定的理论申报数据分层保存；异常未处理、必拍照片或库位不完整时不得完成当前票理货。 | 国内分拨和国际中转逐票独立理货；实际数据不覆盖理论数据；差异、照片、库位和附加服务可追溯。 |
| SIPGL-IMD-IMP-011 | 分票入库并自动完成后续处理 | 理货员、系统 | 当前 HBL 理货数据和库位完整，允许打印桩脚牌。 | 移动端 逐票打印桩脚牌并确认打印成功，完成分票入库。 | 写入p_mobile_print_pile_card 自动处理p_ensure_import_transit_export_order | 打印有效桩脚牌即当前 HBL 入库完成并开始库存/堆存计时；国际中转 HBL 入库后自动生成对应出口委托单。理货报文接口规格尚未确定，本期暂不实现。 | 每票保留原进仓编号并有桩脚牌和入库流水；每张国际中转 HBL 有且只有一张对应出口委托单；本期不验收理货报文。 |
| D货物查询、海关放行与查验 | |||||||
| SIPGL-IMD-IMP-012 | 定期查询并更新海关放行结果 | 仓库人员 | 存在需要跟踪海关状态的国内分拨 HBL。 | PC 仓库人员定期访问海关系统查询结果，在“库存查询”标准列表中定位并选择对应进口分拨货物，通过“维护放行状态”按钮勾选是非参数“已放行”。 | act_update_customs_releasep_import_stock_update_release | 当前放行状态、更新时间和维护人保存在货物表；不维护反转履历。未放行不得进入正式提货受理。 | 库存查询保持 G1 标准列表；单选货物后可通过标准操作按钮更新当前放行结果；客户查询读取最新结果；未放行票不能被受理提货。 |
| SIPGL-IMD-IMP-013 | 持续开放客户货物查询并办理查验或提货预约 | 客户 | 业务单据和 HBL 已录入；不要求货物已经入库。 | PC 客户在门户自定义页面输入“分拨提单号＋货物重量”查询货物；需要查验时提交查验预约；已放行时维护提货预约和开票信息。 | 查询p_customer_import_distribution_query 写入p_customer_import_inspection_requestp_customer_import_pickup_save | 查询不限定当前账号货物，因此必须以分拨提单号和预报重量共同校验；查询从业务单据录入后即开放，不以入库为门禁。已放行才允许保存提货预约。 | 未入库货物仍可查询；重量不匹配不得返回货物；查验预约、提货预约和开票信息可按状态保存。 |
| SIPGL-IMD-IMP-014 | 手机端执行查验任务并生成查验费 | 仓库现场人员 | 客户已完成查验预约，HBL 在库且不存在其他阻断性冻结。 | 移动端 在查验任务页领取任务，扫描桩脚牌，依次执行开始、完成和复位。 | 查询p_mobile_import_inspection_tasks 写入p_mobile_import_inspection_action | 查验现场执行全部在手机端完成；每次实际完成的查验生成一笔票级查验费，取消或未实际执行不收费。 | 开始、完成、复位、人员和时间可追溯；查验费按票/次生成且幂等。 |
| E最终预约、单票提离与结算 | |||||||
| SIPGL-IMD-IMP-015 | 小程序登记最终提货预约 | 司机 | 国内分拨 HBL 已放行，司机准备正式入场提货。 | 独立微信小程序 司机输入分拨提单号和提货密码校验后，填写最终车牌、提货人、联系电话、到场日期和到场时段。 | p_driver_import_pickup_queryp_driver_import_pickup_register | 最终预约通过受理前车辆作业单元保存，直接覆盖当前预约内容；不维护覆盖版本或覆盖提示。 | 车辆作业单元可在受理前创建；最终预约字段完整；受理台读取同一车辆作业单元。 |
| SIPGL-IMD-IMP-016 | 分拨提货首次受理并进入装车提离队列 | 司机、仓库受理台 | 司机已完成小程序最终预约，车辆已进场，HBL 已放行且分拨提货单有效。 | PC 受理人员扫描分拨提货单，核验货物、最终车辆司机、开票信息和放行结果后确认受理。 | p_distribution_acceptance_accept | 关联预约阶段已有车辆作业单元，受理时才创建装车提离仓库作业并进入待叫号队列。 | 一张 HBL/一个进仓编号/一张提货单只形成一条任务；第一次受理不收费、不打印出门单、不生成欠费状态。 |
| SIPGL-IMD-IMP-017 | 单票叫号并引导车辆到装车位 | 现场叫号人员 | 单票装车提离任务已受理待叫号，叫号名额和装车位可用。 | 移动端 原型装车提离 在装车提离队列确认叫车并引导最终预约车辆到装车位。 | p_mobile_import_pickup_queuep_mobile_import_pickup_action / CALL | 叫车占用统一名额；未叫号任务不得开始备货装车。 | 叫号对象与最终预约车辆一致；队列和叫号状态可追溯。 |
| SIPGL-IMD-IMP-018 | 按库位备货并扫描复核 | 仓库装车人员 | 车辆已叫号到位，当前 HBL 在库且无查验/冻结阻断。 | 移动端 按库位备货，逐张扫描桩脚牌并确认备货。 | p_mobile_import_pickup_action / SCAN | 校验桩脚牌属于当前 HBL 且处于既有可用状态；存在冻结时阻断。 | 备货扫码结果完整；非本票、无效或冻结桩脚牌不得通过。 |
| SIPGL-IMD-IMP-019 | 整票装车完成并执行出库 | 仓库装车人员 | 当前 HBL 已完成全部备货和扫描复核。 | 移动端 将整票货物装车，确认结果后点击“装车完成”。 | p_mobile_import_pickup_action / FINISH | 装车完成时写出库流水、扣减库存并将桩脚牌置为已作废，提货任务进入待结算。 | 库存出库时点是装车完成，不等待结算或闸机；不允许部分装车后关闭整票。 |
| SIPGL-IMD-IMP-020 | 票级费用结算并完成车辆出场 | 司机、仓库受理台、财务、闸机 | 单票已装车待结算，全部票级费用已形成且无金额异常。 | PC 费用完成现结收款或月结确认后，受理台核验结清状态并下发闸机放行资格；闸机核销后车辆出场。 | p_import_pickup_settlementp_import_pickup_gate_out | 只处理票级费用；全部费用必须已收费或已确认月结才取得闸机资格。正式出门单模板和打印本期暂缓。 | 不使用欠费放行；闸机资格只可在费用结清后取得；车辆出场不改变已经完成的 HBL 库存状态；本期不验收出门单打印。 |
| F国际中转两港联动 | |||||||
| SIPGL-IMD-IMP-021 | PC制定两港联动转仓计划 | 业务人员、调度 | 一张或多张国际中转 HBL 在起点仓正常在库，目标仓可确认。 | PC 使用现有已配置功能创建两港联动转仓计划，选择起点仓、目标仓和多张待转 HBL。 |
| PC 计划功能本期只验证既有配置，不新增车辆、审批或费用口径；仅制定计划不改变库存状态。 | 现有计划配置可用；计划范围、仓库和 HBL 清单完整；计划确认前库存仍在起点仓。 |
| SIPGL-IMD-IMP-022 | 手机端执行两港联动转仓 | 起点仓、目标仓现场人员 | 两港联动转仓计划已确认，两端仓库作业可执行。 | 移动端 起点仓执行发出，目标仓执行接收并更新目标仓库位。 | 查询p_mobile_port_transfer_tasks 写入p_mobile_port_transfer_action | 发出后 HBL 进入在途；接收后恢复在库并切换目标仓。既有桩脚牌随货更新仓库并计入重打次数。 | 不形成普通提货出库，不重新开始堆存计时；发出、在途、接收和入库状态可追溯。 |
入库报关
按《入库报关进仓完成为止的 scenario》修正：客户创建一票一单的入库报关委托，业务配置费用方案并受理后开放送货通知书；仓库受理台核验纸质单据、系统信息和现场车辆，关联预约阶段已有车辆作业单元并生成仓库作业，再复用进仓作业完成卸货、理货、桩脚牌和入库复核。
| ID | 场景 | 角色 | 前置条件 | 用户操作 | 表单/存储过程 | 系统处理逻辑 | 验收点 |
|---|---|---|---|---|---|---|---|
| A委托创建、业务受理与送货通知书 | |||||||
| SIPGL-CBD-IBD-001 | 保存入库报关委托草稿 | 客户 | 客户已具备入库报关业务操作权限，货物、送货计划和开票信息可录入。 | PC 客户新建入库报关委托单，在同一张单据中录入单票货物、送货车辆/司机/计划到场时间/进仓仓库和开票信息后保存。 | 保存草稿；建立独立单票货物对象并生成唯一进仓编号；入库报关委托和送货计划使用同一张单据、同一个单据编号；不维护箱号、封号、船名航次等后置出运信息。 | 单据状态为草稿；一张委托单只对应一票货物、一个进仓编号、一组送货计划和一组开票信息；未生成正式收费明细、成本或应付。 | |
| SIPGL-CBD-IBD-002 | 提交入库报关委托 | 客户 | 草稿货物、送货计划和开票信息已保存完整。 | PC 客户点击“提交”。 | 标准工作流A401AF451C → 893048B109 写入p_submit_export_seal_order | 校验必填项、字段格式和基础资料有效性；不自动套用关封标准费收方案，也不生成初版费用；标准工作流按 INBOUND_CUSTOMS 分支停留在 SUBMITTED，等待业务确认费用方案。 | 最终状态为 SUBMITTED；业务单尚未关联费用方案且无自动初版收费；客户不能继续仓库受理；待业务受理状态可追溯。 |
| SIPGL-CBD-IBD-003 | 确认费用方案并受理委托 | 业务人员 | 委托单处于 SUBMITTED；业务人员具备费用方案维护和单据受理权限。 | PC 业务人员根据商务约定选择并保存本次适用费用方案，然后点击标准工作流“受理”。 | 标准表单quotation_plan_id 标准工作流C98F1E4862 | 标准操作前提只允许 INBOUND_CUSTOMS 使用人工受理动作，并要求费用方案已保存；通过后状态推进为 BUSINESS_ACCEPTED。关封使用该动作会被阻断。 | 未确认费用方案时受理被标准前提阻断且无副作用；确认后状态精确为 BUSINESS_ACCEPTED，方案版本可追溯；受理本身不生成正式收费明细。 |
| SIPGL-CBD-IBD-004 | 打印入库报关送货通知书 | 客户 | 委托单已受理待进仓。 | PC 客户点击打印或生成送货通知书，并安排车辆和货物进仓。 | p_print_inbound_delivery_notice | 生成送货通知书编号和打印记录；锁定关键送货字段；重复打印保留履历。客户未按计划送货时，单据仍停留已受理待进仓，可显示超时但不自动取消。 | 送货通知书可用于仓库受理；打印次数、打印人、打印时间可查；未受理单据不能打印。 |
| B受理台核验与叫车单元 | |||||||
| SIPGL-CBD-INB-001 | 受理台核验并建立叫车单元 | 仓库受理台 | 司机持有效纸质送货通知书到仓；委托单已受理待进仓；客户已登记车辆、司机和票车关系。 | PC 扫描或输入送货通知书，核对纸质单据、系统委托信息和现场车辆；一车多票逐票核对，一票多车线下确认全部到齐后点击“受理”。 | p_accept_inbound_customs_vehicle | 受理台只核对，不新增、删除或修改车辆、司机、票车关系、货物或送货计划；受理成功后生成进仓仓库作业，关联预约阶段已有车辆作业单元，记录实际受理时间和受理人，按既有票车关系加入待叫号队列，委托单进入进仓作业中。若实际受理时间超出允许窗口，按费用方案版本自动生成一笔计划更改费。 | t_warehouse_job 受理后生成；叫车单元进入待叫号但不占用叫车名额；每张委托单只允许一次有效受理；计划更改费重复操作不重复生成；计划更改费不阻断正常受理。 |
| C叫车与卸货 | |||||||
| SIPGL-CBD-INB-002 | 叫下一车并指定库门 | 仓库现场操作员 | 存在已受理叫车单元，月台/库门可用，移动端进仓作业入口可见待叫号队列。 | 移动端 在进仓作业入口点击“叫下一车”，在叫车确认页选择库门并确认。 | 查询p_mobile_get_inbound_call_queue 写入p_mobile_call_next_inbound_vehicle | 按队列规则锁定叫车单元；保存库门；写车辆作业单元叫车状态；后续确认叫车时才按叫车单元内实际车辆数占用名额。 | 一车多票只叫入现场一次；一票多车共同组成一个叫车单元；现场卸车和理货仍按进仓编号逐票执行。 |
| SIPGL-CBD-INB-003 | 确认车牌并开始卸车 | 装卸工、叉车工 | 车辆已叫入库门，单票货处于待卸车；可扫描送货通知书二维码或手工输入进仓编号。 | 移动端 扫描送货通知书或手工输入进仓编号，核对车牌后点击“确认车牌并开始卸车”。 | 查询p_mobile_get_unloading_task 写入p_mobile_start_inbound_unloading | 校验进仓编号、车牌、库门、状态和人员权限；任务进入卸车中；记录卸车开始时间和操作人。 | 状态不是待卸车时阻断；卸车中时仅已登记装卸工/叉车工可继续作业；任务时间线出现开始卸车记录。 |
| SIPGL-CBD-INB-004 | 登记协助卸车人员 | 装卸工、叉车工、协助人员 | 卸车任务进行中，需要其他人员协助。 | 移动端 发起协助二维码，协助人员扫码确认。 | 查询p_mobile_get_unloading_assist_info 写入p_mobile_confirm_unloading_assistant | 校验二维码有效期、任务状态和人员身份；写 t_warehouse_task_assistant；二维码确认后失效。 | 协助人员出现在任务协作人员中；未登记人员不能继续当前票卸车；二维码过期或任务结束后不能确认。 |
| SIPGL-CBD-INB-005 | 完成卸车 | 装卸工、叉车工 | 卸车任务进行中，必拍照片已满足或允许补拍，液压车使用情况可确认。 | 移动端 完成卸车，选择是否使用液压车。 | 查询p_mobile_get_unloading_task 写入p_mobile_finish_inbound_unloading | 保存卸车全景、货物外观等照片状态；记录是否使用液压车；任务进入待理货；写卸车完成时间。 | 照片规则、液压车选择和卸车完成状态可查；完成后回到进仓作业入口，票货进入可理货范围。 |
| D理货、测量、库位与服务 | |||||||
| SIPGL-CBD-INB-006 | 确认开始理货 | 理货员 | 卸车已完成，单票货处于待理货；尚未分配理货员。 | 移动端 原型05-B0 第一次扫描/确认进仓编号时，点击“确认开始理货”。 | 查询p_mobile_get_tally_start_info 写入p_mobile_start_inbound_tally | 校验进仓编号、状态和理货员占用；首次开始时锁定当前理货员并记录开始时间；同一理货员可继续未完成理货，其他人员被阻断。 | 一票货只出现一次“确认并开始理货”；理货员锁定为首次确认人员；委托单仍按进仓编号逐票追溯。 |
| SIPGL-CBD-INB-007 | 保存测量数据 | 理货员 | 理货任务进行中。 | 移动端 原型05-B1 录入单件、整托、拉板等测量规格，保存全部测量数据。 | 查询p_mobile_get_measurement_info 写入p_mobile_save_measurement | 保存测量类型、包装类型、件数、长宽高、唛头；支持多条规格；阻断校验和提示性差异确认复用进仓作业规则。 | t_warehouse_measurement 可按进仓编号查询；阻断项不保存；提示性差异需展示并记录确认结果。 |
| SIPGL-CBD-INB-008 | 保存做关数据 | 理货员 | 理货任务进行中，散货需要现场做关。 | 移动端 原型05-B2 录入关号和对应件数，点击保存做关数据。 | 查询p_mobile_get_customs_split_info 写入p_mobile_save_customs_split | 保存关号分配和件数；校验合计数量不超过理货实收数量。 | 关号分配可追溯到进仓编号；数量校验失败时不保存。 |
| SIPGL-CBD-INB-009 | 指定理货库位 | 理货员 | 理货任务进行中，库位可用。 | 移动端 选择库位后查看小库位占用情况，点击小库位分配货物占用。 | 查询p_mobile_get_location_suggestp_mobile_get_sublocation_occupancy 写入p_mobile_save_tally_location | 保存一票货的小库位占用分配；不做货物类型适配控制；按所选库位返回小库位占用情况供用户分配。 | 同一进仓编号可有多条小库位占用记录；保存后理货页面可查看已分配库位；入库复核不依赖库位信息。 |
| SIPGL-CBD-INB-010 | 保存残损、照片和仓库服务 | 理货员 | 理货任务进行中。 | 移动端 记录残损类型和件数，拍理货/残损照片，选择液力车、打托、货主标签等服务。 | 查询p_mobile_get_tally_task_info 写入p_mobile_save_tally_exception_photo_service | 保存残损记录、照片留痕和服务选择；严重异常可生成控制申请或冻结；实际服务用于后续按业务动作生成费用。 | 残损照片满足必拍规则；服务记录可用于后续费用生成；异常原因和证据可追溯。 |
| E桩脚牌、入库完成与复核 | |||||||
| SIPGL-CBD-INB-011 | 打印桩脚牌并完成理货入库 | 理货员、仓库打印点 | 测量、做关、库位、残损/照片等必需理货任务已完成。 | 移动端 原型05-B 点击“打印桩脚牌”。 | 查询p_mobile_get_pile_card_print_info 写入p_mobile_print_pile_card | 生成桩脚牌编号并打印；绑定进仓编号、库位分布和理货结果；记录打印批次；写入入库库存流水、单票货在库状态和进仓作业已入库状态，并记录入库完成时间。正式收费明细可在真实业务动作发生后生成，不能来自受理时预计费用。 | t_pile_card 可扫码且显示入库时间；桩脚牌数量与理货/库位分布一致；t_stock_movement 有入库流水，t_cargo 为在库。 |
| SIPGL-CBD-INB-012 | 确认开始入库复核 | 复核员 | 桩脚牌已打印，单票货处于待入库复核。 | 移动端 原型05-C0 确认进仓编号，点击“确认开始入库复核”。 | 查询p_mobile_get_inbound_review_start_info 写入p_mobile_start_inbound_review | 校验进仓编号和状态；任务进入入库复核中；记录复核开始时间和操作人。 | 入库复核页面展示客户标签、桩脚牌、照片要求和库位信息；非待复核状态阻断。 |
| SIPGL-CBD-INB-013 | 完成入库复核 | 复核员 | 桩脚牌已打印，货物已在库，待做入库复核扫码校验。 | 移动端 扫描桩脚牌，点击“入库复核完成”。 | 查询p_mobile_get_inbound_review_info 写入p_mobile_scan_inbound_review_labelp_mobile_finish_inbound_review | 保存桩脚牌扫码复核结果和入库照片；不写入库库存流水，不改变单票货在库状态，不依赖库位信息；相关委托单进入已入库。 | 重复扫码不计数；全部应复核桩脚牌通过后才能完成；复核结果可按进仓编号追溯。 |
| SIPGL-CBD-INB-014 | 入库复核扫码异常冻结 | 复核员 | 入库复核连续扫码中。 | 移动端 扫到不属于当前进仓编号的桩脚牌，确认错误提示。 | 查询p_mobile_get_inbound_review_info 写入p_mobile_freeze_inbound_review_by_scan_error | 立即冻结入库复核任务；保存扫描桩脚牌、基准进仓编号和异常原因；生成仓库控制申请或状态事件。 | 页面提示“入库作业已冻结”；后续复核按钮不可继续；异常记录可由主管处理。 |
| F进仓完成后的报关监管与出运占位 | |||||||
| SIPGL-CBD-MSG-001 | 提交入库报关监管数据 | 报文人员、报关操作 | 货物已完成进仓入库，报关资料完整。 | PC 点击生成并发送或提交报关数据。 | p_submit_inbound_customs_message | 生成监管报文，写发送状态和回执；回执成功后更新业务监管状态。本节点属于进仓完成后的后续监管，需继续细化。 | t_regulatory_message 有发送和回执记录；业务可判断是否允许后续箱级出运。 |
| SIPGL-CBD-OUT-001 | 创建入库报关出运计划 | 业务操作 | 监管条件满足，票货在库，后置出运箱信息可确认。 | PC 维护装箱/出运计划并保存。 | 保存提货装箱计划；提货装箱计划号关联在货物对象上，不直接关联在入库报关委托单上。 | 装箱计划能关联业务主单、箱号和票货候选范围；进仓委托阶段未提前维护箱信息。 | |
| SIPGL-CBD-OUT-002 | 完成入库报关装箱出运 | 仓库现场操作员 | 票货在库，箱可装，监管未冻结。 | 移动端 确认装箱完成和出运。 | p_finish_customs_loading | 写装箱任务、箱操作、出库库存流水和照片；更新票货和计划状态。 | 票货库存扣减；计划完成；出运监管数据可生成。 |
公共能力
查验/冻结/移库、费用、报文、财务等跨主线能力。
| ID | 场景 | 角色 | 前置条件 | 用户操作 | 表单/存储过程 | 系统处理逻辑 | 验收点 |
|---|---|---|---|---|---|---|---|
| A查验、冻结与移库 | |||||||
| SIPGL-WH-EXC-001 | 提交查验/冻结/控制申请 | 业务操作、仓库管理员、报关操作 | 业务主单、票货、箱或仓库作业存在，且未处于终结状态。 | PC 选择对象、控制类型、原因和附件后提交。 | 保存控制申请；按控制类型将对象标记为待处理或冻结；写状态事件。 | 被冻结对象不能继续出库、装箱、提离等关键动作；申请有原因和处理链路。 | |
| SIPGL-WH-EXC-002 | 处理并解除控制 | 仓库管理员、业务主管 | 存在未完成控制申请。 | PC 填写处理结果，点击解除或完成。 | p_resolve_warehouse_control_request | 校验处理权限；解除冻结或保留限制；写处理人、处理时间、状态事件。 | 控制申请状态完成；对象后续动作权限按处理结果恢复或继续受限。 |
| SIPGL-WH-EXC-003 | 执行移库 | 叉车工、仓库管理员 | 票货在库，源/目标库位有效，未被禁止移库。 | 移动端 原型移库 扫描桩脚牌和目标库位，确认移库。 | p_move_cargo_location | 校验库位和冻结状态；写移库库存流水和状态事件；更新当前库位。 | 库存生命周期可看到移库记录；当前库位更新正确。 |
| B费用、对账、开票与收付款 | |||||||
| SIPGL-FEE-FEE-001 | 生成实际费用明细 | 业务操作、财务 | 业务节点达到计费条件，计费规则或人工费用项目可用。 | PC 点击生成费用，或手工录入可调整费用项。 | p_generate_fee_detail | 按业务对象、费用项目和计费规则写 t_fee_detail；保存计费快照和来源节点；防重复生成。 | 费用明细可追溯到业务主单、票货、作业、箱或提离通知；金额和币种正确。 |
| SIPGL-FEE-FEE-002 | 费用对账归集 | 财务 | 存在待结算费用明细。 | PC 选择客户、期间和费用范围，生成对账/结算归集单。 | 生成 t_fee_statement 和 t_fee_statement_item；锁定归集范围；费用进入对账中。 | 同一费用明细不能同时归入多个有效对账单；对账单金额汇总正确。 | |
| SIPGL-FEE-FEE-003 | 开票登记 | 财务 | 对账单已确认，开票信息完整。 | PC 录入发票号码、税率、金额和明细后保存或确认。 | 保存发票和发票明细；关联对账单或费用明细；更新开票状态。 | 发票金额与明细一致；费用/对账单可追溯发票。 | |
| SIPGL-FEE-FEE-004 | 登记收付款并核销 | 财务 | 存在应收/应付费用、对账单或发票。 | PC 录入收付款流水，选择费用或发票进行核销。 | p_allocate_fund_transaction | 写 t_fund_transaction 和 t_fund_allocation；更新费用、发票和对账单收款状态。 | 核销金额不超收付款余额；未核销余额、已核销金额准确。 |
| SIPGL-FEE-FEE-005 | 同步财务凭证 | 财务、系统接口人员 | 费用、发票或收付款达到财务过账条件。 | PC/后台 点击生成/同步财务凭证。 | p_sync_finance_voucher | 生成 t_finance_voucher；调用外部财务系统；写 t_finance_sync_log 和回执。 | 凭证状态、外部凭证号、失败原因和重试记录可查。 |
| C监管报文共用动作 | |||||||
| SIPGL-MSG-MSG-001 | 发送监管报文 | 报文人员 | 报文草稿已生成，接口配置有效。 | PC 选择报文并点击发送。 | p_send_regulatory_message | 校验状态和权限；发送报文；保存请求、回执、错误和状态流转。 | 报文状态从待发送到发送中/成功/失败；失败可重发且留痕。 |
| SIPGL-MSG-MSG-002 | 撤销或作废监管报文 | 报文人员、业务主管 | 报文状态允许撤销，且业务未进入不可撤销节点。 | PC 填写撤销原因并提交。 | p_cancel_regulatory_message | 生成撤销/作废记录；必要时发送撤销报文；更新原报文状态和业务监管状态。 | 原报文和撤销报文可互相追溯；撤销原因、审批和回执完整。 |
下一步建议
先用这版 HTML 做范围校准，再进入配置和过程落地拆解。
建议评审顺序：先确认关封出口入库段是否按新表口径表达准确，再确认进口分拨的“开票快照挂提离通知”颗粒度，最后补充每条 Scenario 对应的 G1 菜单、表单、按钮和接口注册矩阵。
2026-07-27 配置开发校准：仓库作业改为仓库受理后生成；预约阶段已有
t_vehicle_work_unit 承载司机、车队、车牌、预约窗口和票车关系；后续需要修正进仓受理查询与受理过程，使其从业务单据、票货和车辆预约读取，确认受理时再创建 t_warehouse_job 并回填车辆作业单元关联。需要继续讨论：受理前车辆作业单元如何独立保存作业入口、仓库和业务来源，
warehouse_job_id 是否改为受理后回填字段；装箱计划是否长期通过 t_cargo.outbound_loading_plan_id 表达票货归属；离场凭证是否需要恢复独立物理表。