软件教程 V1.0 API 文档 软件教程

车辆物流系统软件教程

版本 V1.0 · 更新于 2026-07-07

阅读对象

本文给新租户和现场人员使用。默认场景是整车堆场 / 仓库:客户下单,司机或客户提车,堆场收车核验,装柜人员拍照提交,管理员在后台查看库存、报表和日志。

角色常用入口主要操作
租户管理员管理后台、小程序管理员工作台维护客户、仓库、管理员权限;收车核验;快速入库;放行;查看报表。
客户小程序客户首页、客户门户完善资料、提交入库任务、申请提车出库、查看车辆资料和照片。
司机小程序司机任务页接单、到场、装车、上传定位和照片。
装柜人员小程序装柜页领取装柜单,按要求拍柜体、封条、里程表等资料,提交异常。

上线前资料

开通系统前先准备下面资料。资料不齐也能先开通,但不要急着导入大量库存。

资料说明
租户名称后台和小程序显示的堆场 / 仓库名称。
仓库清单每个仓库的名称、地址、联系人电话。多仓库租户不要用一个仓库代替全部场地。
管理员账号管理员手机号、姓名、岗位。权限按岗位给,不要把所有账号都设成全权限。
客户资料客户公司、联系人、手机号。客户手机号用于下单、查车和历史库存归属。
车型资料常用物料号、车型名称。没有标准物料号时,现场可手填车型。
历史库存表至少包含 VIN、客户手机号、仓库 ID、库位。导入前先做预检。
仓库 ID 不要猜。进入管理后台的“仓库管理”查看实际 ID,或从库存筛选中确认。历史库存导错仓库,比晚导入更麻烦。

第一天顺序

新租户上线建议按这个顺序做。先跑通一小批,再处理历史数据。

用管理员账号登录管理后台,确认租户名称和套餐状态正常。
维护仓库、客户、管理员权限。至少先建一个真实客户和一个真实仓库。
管理员打开小程序,使用“管理员登录”绑定当前微信。
用小程序“快速入库”录入 1 到 3 台测试车,确认客户、仓库、库位、钥匙和随车资料显示正确。
客户扫码完善资料后,测试“客户下单”和“全部订单”。
确认流程正常后,再做历史库存导入预检和正式导入。

进入管理后台

管理后台地址:

https://a.wkaitool.cn/admin

输入管理员手机号和密码登录。首次登录如果系统要求修改密码,先按页面提示修改,再进入后台。

登录后先看用途
首页查看租户状态、到期时间、快捷入口和教程卡片。
设置维护公司信息、首页配置、管理员权限。
仓库管理维护仓库,确认仓库 ID。
客户接入 / 代客下单新增客户、编辑客户资料、开通客户门户、维护客户组。
库存信息查看在库车辆、历史库存导入、车辆资料、出库或调拨。

基础资料

1. 公司和首页

进入“设置”,先检查公司名称、联系人、联系电话。首页公告和轮播图可以后面再配,不影响业务流转。

2. 仓库

进入“仓库管理”,为每个实际仓库建一条记录。客户下单、快速入库、库存筛选和提车出库都会使用仓库信息。

3. 管理员权限

岗位建议权限
收车人员订单中心、入库核验、库存信息。
放行人员出库放行、提车出库、装柜管理。
仓库主管库存信息、修改库位、库存盘点、操作日志。
财务 / 管理层报表查看、报表导出。需要客户电话时再给“查看客户电话”。
“修改库位”是单独权限。现场修改库位时,小程序会要求先识别当前车辆,再输入新库位。

客户接入

客户要先有资料,后面才能下单、查车和导入历史库存。

进入“客户接入 / 代客下单”。
点击“新增客户”,填写公司名称、联系人、手机号。
需要客户电脑查车时,打开“开通客户门户”。客户入口为 https://ab.wkaitool.cn
有多个账号属于同一客户公司时,用“客户组管理”把账号放到同一组。同组账号可查看同组车辆。

如果客户自己扫码完善资料,后台客户列表会显示资料状态。历史库存导入前,先确认客户手机号能在当前租户下匹配到客户。

历史库存导入

历史库存导入入口在“库存信息”页面,按钮名为“历史导入”。适合新租户把原 Excel 库存迁入系统。

必填字段说明
VIN17 位车架号,不能包含 I / O / Q,系统会校验第 9 位校验码。
客户手机号必须能匹配当前租户下的客户。
仓库 ID用当前租户自己的仓库 ID。不要填其他租户或旧系统 ID。
库位车辆当前存放位置。

可选字段包括入仓编号、钥匙数量、卡钥、合格证、一致性证、环保证、入库时间、物料号、车型、备注。

点击“下载模板”,按模板整理 Excel。
点击“选择文件”,系统先做预检,不会直接导入。
查看“可导入”“需修正”“提醒”分类。先导出问题清单给现场核对。
只确认无误的数据再点“导入”。导入后会生成历史入库订单和在库车辆。
预检提示 VIN 校验不通过、客户手机号未匹配、仓库 ID 不正确、入库时间格式不正确时,先修表。不要为了赶时间强行改成看起来相近的 VIN。

进入小程序

小程序按角色进入同一个系统。系统会根据当前账号身份显示客户首页、司机任务或管理员工作台。

角色进入方式进入后看到
管理员小程序“我的” → “管理员登录”,输入后台账号密码。工作台:待核验、在库车辆、快速入库、装柜出库、提车出库、库存盘点。
客户扫码完善资料,或进入小程序选择已绑定租户。客户首页:客户下单、全部订单、我的车辆。
司机通过客户或管理员分享的任务码进入。司机任务:接单、到场、装车、上传照片和定位。
装柜人员扫码装柜任务码进入。装柜任务:领取、核验、拍照、异常上报、提交。
管理员微信绑定后,后续可直接进入管理员工作台。更换手机或微信时,需要重新登录绑定。

客户下单

客户在小程序首页点击“客户下单”。当前有两类任务:

任务适用场景客户填写
入库任务客户准备把车送到堆场。VIN、车型或物料号、随车证件、送达仓库、提车地点、备注。
提车出库客户从在库车辆中申请提车。当前仓库、VIN、提车地址、提车人和联系方式。

VIN 支持扫码识别和批量粘贴。系统会提示无效、重复、校验错的 VIN,客户应先修正再提交。

任务池

后台“提车任务池”用于管理员跟进入库提车和出库提车。

页签管理员常用操作
入库提车任务查看客户创建的入库任务,跟进司机装车进度,必要时关闭任务。
出库提车任务查看客户提车出库申请,跟进司机到场、装车、待放行和已完成状态。

出库任务进入“待放行”后,管理员在小程序或后台放行。放行后车辆正式出库。

快速入库

快速入库适合现场直接建库存,不要求客户先在小程序下单。管理员小程序首页点击“快速入库”。

选择客户。客户未建档时,先回后台新增客户或让客户扫码完善资料。
选择仓库,填写默认库位。库位也可以逐车调整。
扫码或连续拍照识别 VIN。识别不准时,现场核对后再改。
补充车型、物料号、钥匙数量、卡钥、合格证、一致性证、环保证。
确认列表无误后提交。系统生成入库订单,车辆进入库存。

快速入库完成后,可在“库存信息”按 VIN、客户、仓库筛选查看。

库存与库位

管理员小程序“库存信息”可查在库、未改装、已改装车辆。点击车辆进入“车辆明细”。

操作说明
搜索 VIN支持手输或扫码。
查看车辆明细查看客户、车型、仓库、库位、入仓编号、钥匙、随车资料、核验人和改装人。
修改库位有“修改库位”权限时显示。先识别当前车辆,识别通过后输入新库位。
库存盘点按仓库扫车,核对实际车辆和系统库存是否一致。
库位只改最后实际库位,不要用库位字段记录临时备注。备注类信息应写在订单或车辆备注里。

装柜出库

装柜出库一般由管理员创建装柜批次,装柜人员扫码进入小程序完成现场资料。

后台进入“装柜管理”,创建或查看装柜批次。
分享装柜码给装柜人员。
装柜人员扫码领取任务,按 SO / 柜号查看车辆清单。
按页面要求上传柜体、封条、里程表、车辆等照片或视频。
提交后管理员复核并放行。放行后车辆状态变为已出库。

客户需要查看资料时,可通过车辆资料包或客户门户查看已授权车辆资料。

报表和日志

入口用途
报表查看库存、客户、台账、人员绩效。人员绩效可导出核验数、异常数、改装数。
操作日志查看管理员操作记录。排查 VIN 修改、库位修改、放行、导入等问题时先看日志。
库存信息导出按当前筛选条件导出车辆状态和资料。

常见问题

问题先检查
客户看不到车辆客户手机号是否建档;是否在同一租户;是否加入了正确客户组;车辆客户归属是否正确。
客户不能下单客户资料是否完善;当前租户是否选择正确;是否被停用。
快速入库找不到客户后台客户是否已新增;手机号是否一致;客户是否属于当前租户。
历史导入失败先看预检问题清单。重点查 VIN 校验位、客户手机号、仓库 ID、入库时间格式。
司机打不开任务任务码是否过期;是否扫错租户;任务是否已关闭或完成。
装柜照片缺失先查装柜单详情和操作日志,确认是否已提交、是否有异常上报。
后台登录不了确认账号是否属于当前租户、是否被停用、密码是否已重置。
联系服务方排查时,请提供租户名称、手机号、VIN、订单号或任务号、操作时间。接口联调问题同时提供 requestId。