跳到主内容
版本: 2.x

错误代码

WCPOS 遇到问题时会显示错误代码,帮助您识别问题。从 v1.10.0 起,代码采用 领域 + 三位数字 的格式,例如 SYNC131 或 AUTH311。领域表示 POS 中的功能范围,数字则标识具体情况。每个代码都有专属页面,说明其含义、处理方法以及对数据的影响。

在 POS 中,错误代码显示在 店铺健康 → 日志 中:展开某一行,点击 帮助 链接即可直接跳转到本文档中对应的代码页面。

错误领域(v1.10.0+)​

领域范围
AUTH登录、会话和令牌
CHECKOUT在收银台完成订单
CLIENTPOS 应用本身及本地存储
DISPLAY面向顾客的显示屏
HOST阻止 POS 连接的主机和防火墙规则
LICENSEPro 许可证的激活和验证
PAYMENT支付网关和终端
PRINT收据打印
PRODUCT商品数据和目录操作
REGISTER钱箱、收银会话和盘点
SYNCPOS 与店铺之间的同步

在下方查找您的代码,或直接搜索。

以 999 结尾的代码是该领域的通用代码,用于尚未分配专用代码的情况。

全部代码​

AUTH:登录、会话和令牌​

代码含义
AUTH101您的会话已结束,需要重新登录。
AUTH111店铺未接受登录凭据。
AUTH121已登录的店铺账户与此收银台的收银员不匹配。
AUTH131保存的店铺会话不完整,因此 WCPOS 已返回店铺列表。
AUTH201您的账户没有执行此操作的权限。
AUTH301另一个身份验证插件正在阻止 WCPOS 连接。
AUTH311WCPOS 无法访问店铺中的连接端点。
AUTH321此站点未启用 WooCommerce,因此 WCPOS 无法连接。
AUTH331此店铺的 WCPOS 插件版本过旧,无法用于当前版本的应用。
AUTH341此店铺报告的标识与此设备上已保存的一家店铺相同。
AUTH401无法信任与此店铺的安全连接。
AUTH411店铺地址缺失或不是有效的 URL。
AUTH421店铺服务器在此应用可使用的所有通道上都阻止了登录令牌。
AUTH431此应用尝试了所有可用的地址形式,店铺的 REST API 均未响应。
AUTH441登录令牌的大小超出了此服务器接受的范围。
AUTH999登录或保持登录状态时遇到意外问题。

CHECKOUT:在收银台完成订单​

代码含义
CHECKOUT101结账未完成,购物车数据完好,可以安全重试。
CHECKOUT111无法将此更改应用到购物车,购物车保持不变。
CHECKOUT201WCPOS 无法确认结账是否完成。
CHECKOUT211店铺未返回结账结果,因此订单状态未知。
CHECKOUT301商品 SKU 重复或无效,无法继续结账。
CHECKOUT401店铺中此订单的总额与收银台显示的不同。订单已按店铺的总额保存。
CHECKOUT411POS 无法读取此订单中某个行项目的价格详情,因此改用了已存储的合计金额作为该项目的金额。
CHECKOUT421此订单引用了店铺中已不存在的税率,因此税额可能有误。
CHECKOUT999结账时遇到意外问题。

CLIENT:POS 应用本身及本地存储​

代码含义
CLIENT101WCPOS 无法完成启动。
CLIENT111同步启动所需的时间超出预期。
CLIENT121此浏览器同一时间只允许一个标签页发送更改。
CLIENT131WCPOS 一次将过多请求加入队列,已丢弃其中一部分。
CLIENT141搜索返回了部分与您的商品不匹配的结果,WCPOS 已将其隐藏。
CLIENT142搜索索引未及时响应,因此 WCPOS 改为直接搜索商品目录。
CLIENT143搜索遗漏了本应找到的商品。
CLIENT144搜索索引重建失败,应用重试初始化期间,搜索结果可能不完整。
CLIENT151部分界面加载失败,已替换为错误提示。
CLIENT161当前浏览器标签页未负责运行收银台,因此未发送新的付款请求。
CLIENT171此设备的时钟与店铺时钟相差超过一分钟。
CLIENT181WCPOS 无法切换到该店铺。
CLIENT201此设备内存耗尽,上一次操作可能尚未完成。
CLIENT211设备级崩溃导致 WCPOS 停止运行。
CLIENT999WCPOS 遇到意外错误。

DISPLAY:面向顾客的显示屏​

代码含义
DISPLAY101顾客显示屏无法生成购物车快照,在下一次更改之前会显示待机画面。

HOST:阻止 POS 连接的主机和防火墙规则​

代码含义
HOST101服务器阻止了浏览器的权限检查(CORS 预检),因此网页应用无法访问服务器。
HOST111服务器的跨域(CORS)配置有误,因此浏览器拒绝接受其响应。
HOST121返回响应的是防机器人验证页面,而非店铺的 API。
HOST131店铺前端的代理因服务器响应中的标头过多而拒绝了响应。
HOST141主机的安全过滤器正在阻止商品搜索。
HOST151主机缓存可能将一名用户的店铺数据返回给另一名用户。
HOST161主机正在限制此店铺收银台的请求频率。

LICENSE:Pro 许可证的激活和验证​

代码含义
LICENSE101您的 WCPOS Pro 许可证未在此店铺或设备上激活。
LICENSE201WCPOS Pro 的版本与 WCPOS 不匹配,因此已被禁用。
LICENSE301更新程序未获授权下载 WCPOS Pro 更新。
LICENSE999检查许可证时遇到意外问题。

PAYMENT:支付网关和终端​

代码含义
PAYMENT101付款成功,但 WCPOS 随后无法刷新付款状态。
PAYMENT111店铺已记录此笔付款,但收银台无法保存本地副本。
PAYMENT113店铺已发送或取消发票,但此收银台无法保存订单的本地副本。
PAYMENT121银行卡已扣款,但订单未完成。
PAYMENT201WCPOS 无法确认终端是否已收取此笔款项。
PAYMENT211终端未收取此笔款项。
PAYMENT212支付网关未接受此笔付款。
PAYMENT213店铺拒绝记录此笔付款。未收取任何款项。
PAYMENT221无法撤销一笔付款,因此该笔资金仍被冻结。
PAYMENT301所选支付网关在此店铺不可用。
PAYMENT311WCPOS 无法确认此笔退款是否成功。
PAYMENT401支付终端未完成与 WCPOS 的配对。
PAYMENT501此订单已在线付款,因此收银台收取的是一笔额外款项。
PAYMENT511收银台收取的款项超过了订单的剩余应付金额。
PAYMENT999处理付款时遇到意外问题。

PRINT:收据打印​

代码含义
PRINT101此收据的自动打印未启动。
PRINT201WCPOS 无法确认打印任务是否完成。
PRINT301无法连接所选打印机。
PRINT311无法通过电子邮件发送或下载此收据。
PRINT999打印时遇到意外问题。销售不受影响。

PRODUCT:商品数据和目录操作​

代码含义
PRODUCT101此商品更改尚未同步到店铺。
PRODUCT111无法将此变体添加到商品。
PRODUCT201此商品图片不可用,但商品仍可销售。
PRODUCT301没有商品符合当前的搜索和筛选条件。
PRODUCT321多个商品与此条形码匹配。
PRODUCT401显示的库存数据可能落后于店铺的库存数据。
PRODUCT411无法加载条形码扫描设置,因此扫描结果可能无法匹配商品。
PRODUCT421无法读取此商品的变体价格数据,因此显示的价格可能有误或缺失。
PRODUCT999加载或更新商品时遇到意外问题。

REGISTER:钱箱、收银会话和盘点​

代码含义
REGISTER101店铺拒绝了收银台已记录的一笔现金存入、现金支出或无销售开钱箱操作。
REGISTER111店铺拒绝撤销一笔现金变动,因此原记录仍计入统计。
REGISTER201店铺拒绝开启此收银会话,因此没有任何记录计入该会话。
REGISTER211店铺拒绝了此收银台的盘点结果,因此店铺中的会话仍处于开启状态。
REGISTER212钱箱转移未在此设备上完成。店铺未切换。
REGISTER221另一台设备已开启此收银台,因此本收银台加入了该会话,而未新建自己的会话。
REGISTER231此账户无法开班、盘点或关班。
REGISTER301店铺拒绝接受经理对此次盘点的批准,因此收银台仍处于开启状态。

SYNC:POS 与店铺之间的同步​

代码含义
SYNC101WCPOS 无法将一项更改写入此设备的存储。
SYNC111此设备上存储的部分数据已损坏,无法同步。
SYNC121目前无法连接您的店铺。
SYNC131店铺发生错误,未完成此请求。
SYNC141店铺要求 WCPOS 暂时降低请求频率。
SYNC151店铺的响应中包含多余文本,WCPOS 已尝试清理。
SYNC161此设备的存储停止响应,因此保存已暂停。
SYNC171WCPOS 无法在此设备上设置或移除存储。
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 即可查阅。

需要更多帮助?​

如果按照故障排除步骤操作后仍遇到问题:

  1. 查看故障排除部分,获取更详细的指南
  2. 加入我们的 Discord 社区获取支持
  3. 在 GitHub 上报告问题