错误代码
WCPOS 遇到问题时会显示错误代码,帮助您识别问题。从 v1.10.0 起,代码采用 领域 + 三位数字 的格式,例如 SYNC131 或 AUTH311。领域表示 POS 中的功能范围,数字则标识具体情况。每个代码都有专属页面,说明其含义、处理方法以及对数据的影响。
在 POS 中,错误代码显示在 店铺健康 → 日志 中:展开某一行,点击 帮助 链接即可直接跳转到本文档中对应的代码页面。
错误领域(v1.10.0+)
| 领域 | 范围 |
|---|---|
AUTH | 登录、会话和令牌 |
CHECKOUT | 在收银台完成订单 |
CLIENT | POS 应用本身及本地存储 |
DISPLAY | 面向顾客的显示屏 |
HOST | 阻止 POS 连接的主机和防火墙规则 |
LICENSE | Pro 许可证的激活和验证 |
PAYMENT | 支付网关和终端 |
PRINT | 收据打印 |
PRODUCT | 商品数据和目录操作 |
REGISTER | 钱箱、收银会话和盘点 |
SYNC | POS 与店铺之间的同步 |
在下方查找您的代码,或直接搜索。
以 999 结尾的代码是该领域的通用代码,用于尚未分配专用代码的情况。
全部代码
AUTH:登录、会话和令牌
| 代码 | 含义 |
|---|---|
| AUTH101 | 您的会话已结束,需要重新登录。 |
| AUTH111 | 店铺未接受登录凭据。 |
| AUTH121 | 已登录的店铺账户与此收银台的收银员不匹配。 |
| AUTH131 | 保存的店铺会话不完整,因此 WCPOS 已返回店铺列表。 |
| AUTH201 | 您的账户没有执行此操作的权限。 |
| AUTH301 | 另一个身份验证插件正在阻止 WCPOS 连接。 |
| AUTH311 | WCPOS 无法访问店铺中的连接端点。 |
| AUTH321 | 此站点未启用 WooCommerce,因此 WCPOS 无法连接。 |
| AUTH331 | 此店铺的 WCPOS 插件版本过旧,无法用于当前版本的应用。 |
| AUTH341 | 此店铺报告的标识与此设备上已保存的一家店铺相同。 |
| AUTH401 | 无法信任与此店铺的安全连接。 |
| AUTH411 | 店铺地址缺失或不是有效的 URL。 |
| AUTH421 | 店铺服务器在此应用可使用的所有通道上都阻止了登录令牌。 |
| AUTH431 | 此应用尝试了所有可用的地址形式,店铺的 REST API 均未响应。 |
| AUTH441 | 登录令牌的大小超出了此服务器接受的范围。 |
| AUTH999 | 登录或保持登录状态时遇到意外问题。 |
CHECKOUT:在收银台完成订单
| 代码 | 含义 |
|---|---|
| CHECKOUT101 | 结账未完成,购物车数据完好,可以安全重试。 |
| CHECKOUT111 | 无法将此更改应用到购物车,购物车保持不变。 |
| CHECKOUT201 | WCPOS 无法确认结账是否完成。 |
| CHECKOUT211 | 店铺未返回结账结果,因此订单状态未知。 |
| CHECKOUT301 | 商品 SKU 重复或无效,无法继续结账。 |
| CHECKOUT401 | 店铺中此订单的总额与收银台显示的不同。订单已按店铺的总额保存。 |
| CHECKOUT411 | POS 无法读取此订单中某个行项目的价格详情,因此改用了已存储的合计金额作为该项目的金额。 |
| CHECKOUT421 | 此订单引用了店铺中已不存在的税率,因此税额可能有误。 |
| CHECKOUT999 | 结账时遇到意外问题。 |
CLIENT:POS 应用本身及本地存储
| 代码 | 含义 |
|---|---|
| CLIENT101 | WCPOS 无法完成启动。 |
| CLIENT111 | 同步启动所需的时间超出预期。 |
| CLIENT121 | 此浏览器同一时间只允许一个标签页发送更改。 |
| CLIENT131 | WCPOS 一次将过多请求加入队列,已丢弃其中一部分。 |
| CLIENT141 | 搜索返回了部分与您的商品不匹配的结果,WCPOS 已将其隐藏。 |
| CLIENT142 | 搜索索引未及时响应,因此 WCPOS 改为直接搜索商品目录。 |
| CLIENT143 | 搜索遗漏了本应找到的商品。 |
| CLIENT144 | 搜索索引重建失败,应用重试初始化期间,搜索结果可能不完整。 |
| CLIENT151 | 部分界面加载失败,已替换为错误提示。 |
| CLIENT161 | 当前浏览器标签页未负责运行收银台,因此未发送新的付款请求。 |
| CLIENT171 | 此设备的时钟与店铺时钟相差超过一分钟。 |
| CLIENT181 | WCPOS 无法切换到该店铺。 |
| CLIENT201 | 此设备内存耗尽,上一次操作可能尚未完成。 |
| CLIENT211 | 设备级崩溃导致 WCPOS 停止运行。 |
| CLIENT999 | WCPOS 遇到意外错误。 |
DISPLAY:面向顾客的显示屏
| 代码 | 含义 |
|---|---|
| DISPLAY101 | 顾客显示屏无法生成购物车快照,在下一次更改之前会显示待机画面。 |
HOST:阻止 POS 连接的主机和防火墙规则
| 代码 | 含义 |
|---|---|
| HOST101 | 服务器阻止了浏览器的权限检查(CORS 预检),因此网页应用无法访问服务器。 |
| HOST111 | 服务器的跨域(CORS)配置有误,因此浏览器拒绝接受其响应。 |
| HOST121 | 返回响应的是防机器人验证页面,而非店铺的 API。 |
| HOST131 | 店铺前端的代理因服务器响应中的标头过多而拒绝了响应。 |
| HOST141 | 主机的安全过滤器正在阻止商品搜索。 |
| HOST151 | 主机缓存可能将一名用户的店铺数据返回给另一名用户。 |
| HOST161 | 主机正在限制此店铺收银台的请求频率。 |
LICENSE:Pro 许可证的激活和验证
| 代码 | 含义 |
|---|---|
| LICENSE101 | 您的 WCPOS Pro 许可证未在此店铺或设备上激活。 |
| LICENSE201 | WCPOS Pro 的版本与 WCPOS 不匹配,因此已被禁用。 |
| LICENSE301 | 更新程序未获授权下载 WCPOS Pro 更新。 |
| LICENSE999 | 检查许可证时遇到意外问题。 |
PAYMENT:支付网关和终端
| 代码 | 含义 |
|---|---|
| PAYMENT101 | 付款成功,但 WCPOS 随后无法刷新付款状态。 |
| PAYMENT111 | 店铺已记录此笔付款,但收银台无法保存本地副本。 |
| PAYMENT113 | 店铺已发送或取消发票,但此收银台无法保存订单的本地副本。 |
| PAYMENT121 | 银行卡已扣款,但订单未完成。 |
| PAYMENT201 | WCPOS 无法确认终端是否已收取此笔款项。 |
| PAYMENT211 | 终端未收取此笔款项。 |
| PAYMENT212 | 支付网关未接受此笔付款。 |
| PAYMENT213 | 店铺拒绝记录此笔付款。未收取任何款项。 |
| PAYMENT221 | 无法撤销一笔付款,因此该笔资金仍被冻结。 |
| PAYMENT301 | 所选支付网关在此店铺不可用。 |
| PAYMENT311 | WCPOS 无法确认此笔退款是否成功。 |
| PAYMENT401 | 支付终端未完成与 WCPOS 的配对。 |
| PAYMENT501 | 此订单已在线付款,因此收银台收取的是一笔额外款项。 |
| PAYMENT511 | 收银台收取的款项超过了订单的剩余应付金额。 |
| PAYMENT999 | 处理付款时遇到意外问题。 |
PRINT:收据打印
| 代码 | 含义 |
|---|---|
| PRINT101 | 此收据的自动打印未启动。 |
| PRINT201 | WCPOS 无法确认打印任务是否完成。 |
| PRINT301 | 无法连接所选打印机。 |
| PRINT311 | 无法通过电子邮件发送或下载此收据。 |
| PRINT999 | 打印时遇到意外问题。销售不受影响。 |
PRODUCT:商品数据和目录操作
| 代码 | 含义 |
|---|---|
| PRODUCT101 | 此商品更改尚未同步到店铺。 |
| PRODUCT111 | 无法将此变体添加到商品。 |
| PRODUCT201 | 此商品图片不可用,但商品仍可销售。 |
| PRODUCT301 | 没有商品符合当前的搜索和筛选条件。 |
| PRODUCT321 | 多个商品与此条形码匹配。 |
| PRODUCT401 | 显示的库存数据可能落后于店铺的库存数据。 |
| PRODUCT411 | 无法加载条形码扫描设置,因此扫描结果可能无法匹配商品。 |
| PRODUCT421 | 无法读取此商品的变体价格数据,因此显示的价格可能有误或缺失。 |
| PRODUCT999 | 加载或更新商品时遇到意外问题。 |
REGISTER:钱箱、收银会话和盘点
| 代码 | 含义 |
|---|---|
| REGISTER101 | 店铺拒绝了收银台已记录的一笔现金存入、现金支出或无销售开钱箱操作。 |
| REGISTER111 | 店铺拒绝撤销一笔现金变动,因此原记录仍计入统计。 |
| REGISTER201 | 店铺拒绝开启此收银会话,因此没有任何记录计入该会话。 |
| REGISTER211 | 店铺拒绝了此收银台的盘点结果,因此店铺中的会话仍处于开启状态。 |
| REGISTER212 | 钱箱转移未在此设备上完成。店铺未切换。 |
| REGISTER221 | 另一台设备已开启此收银台,因此本收银台加入了该会话,而未新建自己的会话。 |
| REGISTER231 | 此账户无法开班、盘点或关班。 |
| REGISTER301 | 店铺拒绝接受经理对此次盘点的批准,因此收银台仍处于开启状态。 |
SYNC:POS 与店铺之间的同步
| 代码 | 含义 |
|---|---|
| SYNC101 | WCPOS 无法将一项更改写入此设备的存储。 |
| SYNC111 | 此设备上存储的部分数据已损坏,无法同步。 |
| SYNC121 | 目前无法连接您的店铺。 |
| SYNC131 | 店铺发生错误,未完成此请求。 |
| SYNC141 | 店铺要求 WCPOS 暂时降低请求频率。 |
| SYNC151 | 店铺的响应中包含多余文本,WCPOS 已尝试清理。 |
| SYNC161 | 此设备的存储停止响应,因此保存已暂停。 |
| SYNC171 | WCPOS 无法在此设备上设置或移除存储。 |
| SYNC181 | 此设备上的保存或加载操作非常缓慢,结果尚不明确。 |
| SYNC191 | 此更改仍在向店铺传送。 |
| SYNC201 | 店铺拒绝了此更改,因此更改尚未同步到店铺。 |
| SYNC202 | 店铺拒绝了此更改,因此此设备已恢复为店铺中的版本。 |
| SYNC203 | 店铺中已不存在此订单,因此此设备已将本地副本标记为已处理。 |
| SYNC211 | 店铺拒绝了发送给它的某个值。 |
| SYNC221 | 此设备上的一项更改遇到了店铺中更新的修改。没有数据丢失。 |
| SYNC222 | 此设备保存的版本覆盖了店铺中更新的修改。 |
| SYNC231 | 店铺已收到此更改,但此设备无法记录更改已发送的状态。 |
| SYNC301 | 店铺的更改列表发生了意外变动,WCPOS 正在自动重新检查。没有数据丢失。 |
| SYNC311 | 此设备上的数据由其他版本的 WCPOS 保存,目前尚无法打开。 |
| SYNC321 | 部分数据在本次同步中未能同步。 |
| SYNC331 | 此设备上的记录副本与店铺中的记录不匹配。您输入的内容不受影响。 |
| SYNC341 | 此店铺现在要求使用更新版本的 POS 应用。 |
| SYNC401 | 后台同步任务在完成前意外停止。 |
| SYNC411 | 此设备向店铺请求数据的频率远高于正常水平。 |
| SYNC999 | 同步时遇到意外问题。 |
v1.10.0 之前的代码
API04001 等代码来自 v1.10.0 之前的版本,当前版本不会产生这些代码。您仍可能在升级前保留的日志条目或旧的支持讨论中看到它们。将版本菜单切换到 1.x 即可查阅。
需要更多帮助?
如果按照故障排除步骤操作后仍遇到问题:
- 查看故障排除部分,获取更详细的指南
- 加入我们的 Discord 社区获取支持
- 在 GitHub 上报告问题