主题
手机物流信息录入
基础信息
| 项 | 说明 |
|---|---|
| 菜单路径 | /operationsManagement/logisticsManagement/infoEntry(录入);编辑入口 /logisticsManagement/infoEntry/logisticsInfoEdit?pageType=edit |
| 路由名称 | /operationsManagement/logisticsManagement/infoEntry(菜单路由 name) |
| 页面组件 | src/views/operationsManagement/logisticsManagement/infoEntry/index.vue(录入);logisticsInfoEdit.vue(编辑,复用同一套子组件) |
| 接口模块 | 组件内 this.$api.post(...) / this.$api.get(...) 直接调用 |
| Store | logisticsFeeMng(namespaced) |
| 页面定位 | 手机物流信息录入与编辑,支持系统顺丰下单、手动下单、人工配送三种物流方式,并维护关联工单 |
页面功能
页面由「关联工单信息(OderInfo)+ 物流信息(LogisticsInfo)」两区块构成。录入与编辑共用同一套组件,通过路由 query.pageType === 'edit' 区分;编辑回显数据来自 sessionStorage(editInfo) 及临时缓存(tempEditInfo/tempImportInfo)。
1. 物流方式与录入表(LogisticsInfo)
顶部「物流方式」下拉(字典 logistics_order_type),切换后按 componentsName[orderType-1] 动态渲染对应表组件:
| 物流方式 orderType | 组件 | 默认物流状态 | 提交接口 |
|---|---|---|---|
1 系统顺丰下单 | SystemTable | 待招揽 1 | 录入:wo/logistics/inputAddOrder |
2 手动下单 | ManualTable | 待招揽 1 | 录入:wo/logistics/input;编辑:wo/logistics/editLogistics |
3 人工配送 | PersonalTable | 已签收 5 | 录入:wo/logistics/input;编辑:wo/logistics/editLogistics |
每个表组件用 NoHeaderTable 渲染键值对表单(配送方式/路径/类型、快递单号、快递费/保价费、寄件人/收件人、寄收地址、物流状态、费用承担方、各类时间等)。下拉项来自字典:logistics_route_type、logistics_delivery_category、logistics_company、logistics_status、logistics_delivery_type、logistics_fee_payer。
底部按钮:非系统下单时显示「取消 / 保存 / 录入(或提交修改)」;系统下单(orderType=1)时录入页显示「取消 / 快递下单」,编辑页显示「取消下单」。
- 保存:把当前表单与地址存入
sessionStorage(录入存tempImportInfo,编辑存tempEditInfo),并通过$emit('getTempList')把关联工单列表存入tempImportList/tempEditList。 - 录入/提交:系统下单走
inputAddOrder,其余录入走input,编辑走editLogistics(带id)。校验含必填、电话格式^[\w()-]{6,16}$、金额^(([1-9]\d*)|\d)(\.\d{1,2})?$;系统下单的取件时间须为 8:00-21:00 且 3 天内(checkTime)。 - 取消下单(系统下单编辑态):调
wo/logistics/exitOrder取消顺丰下单。
寄/收件人通过「添加」按钮打开弹窗,按配送路径选择分拣中心(SelectSortingCenter)或维修商(SelectMaintainer)回填姓名/电话/地址/省市区编码。配送路径为 1/4/5 时显示「信息自动识别」按钮,调 autoParseAdress 智能识别地址并回填。
2. 物流跟踪记录
LogisticsInfo 第二个 Tab 展示 TrackRecord,编辑态若有快递单号则调 logisticsTrack/page 加载轨迹。
3. 关联工单信息(OderInfo)
通过工单号/报案人/报案人电话「添加关联」,调 wo/serviceOrderLogistics/serviceOrderPageQuery 查询并把工单追加到表格;可「移除」。表格行带勾选框,选中工单的 id 列表经 SET_ORDERIDLIST 存入 logisticsFeeMng 供录入提交时携带(serviceOrderIdList)。
勾选规则与配送路径联动(routeType 2/3 多选,其余单选);配送路径变化时(非首次回显)会清空已勾选。编辑态下:系统下单或非「待招揽/已签收/已退回」状态时关联列表不可编辑;已签收(4)时可移除但不可添加。
4. Store 联动(logisticsFeeMng)
changeByRouteType 通过 SET_ROUTETYPE 把配送路径写入 Store,OderInfo 监听该值联动重置勾选;组件销毁时 SET_ROUTETYPE('') 重置。SET_ORDERIDLIST 维护已勾选关联工单 id 列表。
5. 页面缓存
路由 keepAlive: true。
使用组件
| 组件 | 路径 | 用途 |
|---|---|---|
Container | @/components/container | 页面标题容器 |
OderInfo | ./components/OderInfo | 关联工单信息区块 |
LogisticsInfo | ./components/LogisticsInfo | 物流信息区块(含物流方式/表/跟踪记录) |
SystemTable | ./components/Tables/SystemTable | 系统顺丰下单表单 |
ManualTable | ./components/Tables/ManualTable | 手动下单表单 |
PersonalTable | ./components/Tables/PersonalTable | 人工配送表单 |
TrackRecord | ./components/Tables/TrackRecord | 物流跟踪记录表格 |
SelectSortingCenter | ./components/Tables/SelectSortingCenter | 选择分拣中心弹窗 |
SelectMaintainer | ./components/Tables/SelectMaintainer | 选择维修商弹窗 |
NoHeaderTable | @/components/componentTable/NoHeaderTable | 无表头键值对表格 |
DistrictSelect | @/components/DistrictSelect | 省/市/区地址选择 |
autoParseAdress | @/components/autoParseAdress/index | 信息自动识别弹窗 |
使用 Store
| Store | 使用位置 | 用途 |
|---|---|---|
logisticsFeeMng | OderInfo | SET_ORDERIDLIST 维护已勾选关联工单 id 列表;state.chosedOrderIdList 提交时携带 |
logisticsFeeMng | SystemTable/ManualTable/PersonalTable | SET_ROUTETYPE 写入配送路径;destroyed 时重置 |
logisticsFeeMng | OderInfo | 监听 state.routeType 联动重置勾选 |
Store 定义于
src/store/logisticsFeeMng(index.js+infoEntry.js),namespaced: true,含 state:editStatus、chosedOrderIdList、routeType;mutations:SET_EDITSTATUS、SET_ORDERIDLIST、SET_ROUTETYPE。
调用接口
所有接口实际请求统一带
/api前缀(下表为业务路径简写)。
| 接口 URL | 用途 |
|---|---|
wo/logistics/inputAddOrder | 系统顺丰下单录入 |
wo/logistics/input | 手动下单/人工配送录入 |
wo/logistics/editLogistics | 编辑物流信息 |
wo/logistics/exitOrder | 取消系统下单(编辑态) |
wo/logistics/generateRgLogisticsNumber | 生成人工配送快递单号(GET,PersonalTable) |
wo/serviceOrderLogistics/serviceOrderPageQuery | 关联工单查询(OderInfo) |
logisticsTrack/page | 物流跟踪记录(LogisticsInfo 编辑态) |
ddic/getList | 字典(物流方式/配送路径/类型/状态/配送方式/费用承担方等) |
修改记录
| 修改人 | 修改时间 | 修改内容 |
|---|---|---|
| zhouw | 2026-07-03 | 初始化页面 |
| zhouw | 2026-07-09 | 编写页面内容 |