# WCPOS Documentation

> WCPOS is a point of sale (POS) for WooCommerce. It runs in a web browser or as a Windows, macOS or Linux desktop app, with iOS and Android apps in beta. It sells from the same catalogue, stock and prices as your online store and records every sale as a WooCommerce order. The free plugin takes cash and external card payments and prints receipts; WCPOS Pro adds integrated card readers, refunds, stock editing, order history, reports and multiple stores.


## zh-CN

开始使用 WCPOS，一个免费的开源 WooCommerce 销售点系统。可在网络、桌面和移动设备上使用。

- [介绍](/index.md): 开始使用 WCPOS，一个免费的开源 WooCommerce 销售点系统。可在网络、桌面和移动设备上使用。

### coupons

在 WCPOS 中管理和应用 WooCommerce 优惠券，包括创建优惠券、验证规则以及在收银台应用优惠券。

- [优惠券](/coupons.md): 在 WCPOS 中管理和应用 WooCommerce 优惠券，包括创建优惠券、验证规则以及在收银台应用优惠券。
- [在收银台应用优惠券](/coupons/applying-coupons.md): 收银员在 WCPOS 收银台应用 WooCommerce 优惠券的工作流程——搜索、优惠券标签、叠加折扣以及处理验证错误。

### customers

在 WCPOS 中管理 WooCommerce 客户，包括查找客户、编辑详细信息以及查看订单历史。

- [客户](/customers.md): 在 WCPOS 中管理 WooCommerce 客户，包括查找客户、编辑详细信息以及查看订单历史。

### error-codes

WCPOS 错误代码参考指南，涵盖同步、认证、结账、支付、打印和产品各领域，并附带故障排除步骤。

- [错误代码](/error-codes.md): WCPOS 错误代码参考指南，涵盖同步、认证、结账、支付、打印和产品各领域，并附带故障排除步骤。
- [API 错误](/error-codes/api.md): 与 WooCommerce 服务器通信时发生 API 错误。
- [API01001: 连接超时](/error-codes/API01001.md): API01001：连接超时 — POS 应用尝试连接 WooCommerce 服务器，但服务器响应时间过长。
- [API01002: 连接被拒绝](/error-codes/API01002.md): API01002：连接被拒绝 — 服务器主动拒绝了连接请求。
- [API01003: 连接重置](/error-codes/API01003.md): API01003：连接重置 — 已与服务器建立连接，但随后意外关闭。
- [API01004：DNS 解析失败](/error-codes/API01004.md): API01004：DNS 解析失败 — POS 无法将网站域名（例如 yourstore.com）转换为 IP 地址。
- [API01005: SSL 证书错误](/error-codes/API01005.md): API01005：SSL 证书错误 — 网站的 SSL/TLS 证书存在问题。
- [API01006: 网络不可达](/error-codes/API01006.md): API01006：网络不可达 — POS 无法建立到服务器的路由。
- [API01007: 设备离线](/error-codes/API01007.md): API01007：设备离线 — 您的设备未连接到互联网。
- [API01008: 网站不可用](/error-codes/API01008.md): API01008：网站不可用 — POS 可以连接互联网，但您的特定网站没有响应。
- [API02001: 无效凭据](/error-codes/API02001.md): API02001：无效凭据 — 您输入的用户名或密码不正确。
- [API02002：令牌已过期](/error-codes/API02002.md): API02002：令牌已过期 — 您的身份验证会话已过期。
- [API02003: 令牌无效](/error-codes/API02003.md): API02003：令牌无效 — 服务器无法识别正在使用的身份验证令牌。
- [API02004: 用户未授权](/error-codes/API02004.md): API02004：用户未授权 — 您已登录，但您的用户账户没有执行所请求操作的权限。
- [API02005: 权限不足](/error-codes/API02005.md): API02005：权限不足 — 您的用户账户缺少执行此操作所需的特定 WordPress 功能权限。
- [API02006: API 密钥无效](/error-codes/API02006.md): API02006：API 密钥无效 — 正在使用的 WooCommerce REST API 密钥无效。
- [API02007: 令牌刷新失败](/error-codes/API02007.md): API02007：令牌刷新失败 — POS 尝试自动续订身份验证会话，但刷新请求失败。
- [API02008: 刷新令牌无效](/error-codes/API02008.md): API02008：刷新令牌无效 — POS 存储的刷新令牌无法被服务器识别。
- [API02009: 刷新令牌过期](/error-codes/API02009.md): API02009：刷新令牌过期 — 您的刷新令牌已超过有效期，无法再用于获取新的访问令牌。
- [API02010: 需要认证](/error-codes/API02010.md): API02010：需要认证 — 您尝试执行的操作需要认证，但您当前尚未登录。
- [API03001: 无效的请求格式](/error-codes/API03001.md): API03001：无效的请求格式 — 发送到服务器的请求格式不符合预期。
- [API03002: 缺少必需参数](/error-codes/API03002.md): API03002：缺少必需参数 — 请求缺少服务器完成此操作所需的数据。
- [API03003: 无效的参数值](/error-codes/API03003.md): API03003：无效的参数值 — 请求中的某个值无效。
- [API03004: 请求过大](/error-codes/API03004.md): API03004：请求过大 — 您发送的请求超出了服务器的大小限制。
- [API03005: 速率限制已超出](/error-codes/API03005.md): API03005：速率限制已超出 — 您在短时间内向服务器发送了过多请求。
- [API03006: 不支持的方法](/error-codes/API03006.md): API03006：不支持的方法 — 此端点不支持所使用的 HTTP 方法（GET、POST、PUT、DELETE 等）。
- [API03007：请求队列已满](/error-codes/API03007.md): API03007：请求队列已满 — POS 有太多待发送的请求。
- [API04001: 无效的响应格式](/error-codes/API04001.md): API04001：无效的响应格式 — 服务器已响应，但响应格式不符合 POS 的预期。
- [API04002: 意外的响应代码](/error-codes/API04002.md): API04002：意外的响应代码 — 服务器返回的 HTTP 状态代码不符合此请求的预期。
- [API04003: JSON 响应格式错误](/error-codes/API04003.md): API04003：JSON 响应格式错误 — 服务器返回的数据看起来是 JSON，但已损坏或无效。
- [API04004: 缺失响应数据](/error-codes/API04004.md): API04004：缺失响应数据 — 服务器已成功响应，但响应中缺少预期的数据。
- [API04005: 尝试恢复 JSON](/error-codes/API04005.md): API04005：尝试恢复 JSON — 服务器发送的响应中包含一些无效的 JSON 内容，但 POS 尝试恢复并提取有效数据。
- [API04006: 资源未找到](/error-codes/API04006.md): API04006：资源未找到 — 服务器无法找到所请求的资源。
- [API05001: WooCommerce API 被禁用](/error-codes/API05001.md): API05001：WooCommerce API 被禁用 — 您网站上的 WooCommerce REST API 被禁用。
- [API05002: 找不到 WCPOS 插件](/error-codes/API05002.md): API05002：找不到 WCPOS 插件 — WCPOS 插件未安装或未在您的 WordPress 网站上激活。
- [API05003: WCPOS 插件过时](/error-codes/API05003.md): API05003：WCPOS 插件过时 — 您的服务器上安装的 WCPOS 插件已经过时，与您当前版本的 POS 应用程序不兼容。
- [API05004: WordPress API 禁用](/error-codes/API05004.md): API05004：WordPress API 禁用 — 您的网站已禁用 WordPress REST API。
- [API05005: 插件未找到](/error-codes/API05005.md): API05005：插件未找到 — 某个必需的 WordPress 插件未安装或未激活。
- [API06001: 无效的 URL 格式](/error-codes/API06001.md): API06001：无效的 URL 格式 — 为您的 WooCommerce 网站配置的 URL 格式无效。
- [API06002: 缺少 API URL](/error-codes/API06002.md): API06002：缺少 API URL — 尚未配置用于连接 WooCommerce 店铺的 URL。
- [API06003: 无效的站点配置](/error-codes/API06003.md): API06003：无效的站点配置 — 站点配置无效或不完整。
- [AUTH101: 会话已过期](/error-codes/AUTH101.md): 您的会话已结束，需要重新登录。
- [AUTH111: 凭据被拒绝](/error-codes/AUTH111.md): 商店没有接受这组登录凭据。
- [AUTH121: 登录了错误的用户](/error-codes/AUTH121.md): 已登录的商店账户与本收银机上的收银员不一致。
- [AUTH131：店铺会话不完整](/error-codes/AUTH131.md): 已保存的店铺会话不完整，因此 WCPOS 返回了店铺列表。
- [AUTH201: 角色权限不足](/error-codes/AUTH201.md): 您的账户没有执行此操作的权限。
- [AUTH301: 身份验证插件冲突](/error-codes/AUTH301.md): 另一个身份验证插件正在阻止 WCPOS 连接。
- [AUTH311: REST 路由缺失](/error-codes/AUTH311.md): WCPOS 无法连接到店铺中的连接端点。
- [AUTH321: 缺少 WooCommerce](/error-codes/AUTH321.md): WooCommerce 未在此网站上启用，因此 WCPOS 无法连接。
- [AUTH331：WCPOS 插件版本过旧](/error-codes/AUTH331.md): 此商店的 WCPOS 插件版本对于当前应用版本来说过旧。
- [AUTH401: TLS 不受信任](/error-codes/AUTH401.md): 无法信任与此商店建立的安全连接。
- [AUTH411: 商店 URL 无效](/error-codes/AUTH411.md): 商店地址缺失或不是有效的 URL。
- [AUTH421：认证令牌被主机拦截](/error-codes/AUTH421.md): 商店的服务器在该应用可用的每一条通道上都拦截了登录令牌。
- [AUTH431：REST 传输被拦截](/error-codes/AUTH431.md): 商店的 REST API 在该应用可用的任何地址形式上都没有响应。
- [AUTH441：认证令牌过大](/error-codes/AUTH441.md): 登录令牌超出了此服务器允许的大小。
- [AUTH999: 身份验证意外错误](/error-codes/AUTH999.md): 登录或保持登录状态时遇到了意外问题。
- [CHECKOUT101: 结账失败，购物车安全](/error-codes/CHECKOUT101.md): 结账未能完成，购物车仍可安全用于重试。
- [CHECKOUT111: 购物车更新失败](/error-codes/CHECKOUT111.md): 此更改无法应用到购物车，购物车未发生变化。
- [CHECKOUT201: 结账结果未知](/error-codes/CHECKOUT201.md): WCPOS 无法确认结账是否已完成。
- [CHECKOUT211: 结账响应为空](/error-codes/CHECKOUT211.md): 商店没有返回结账结果，因此订单状态未知。
- [CHECKOUT301: SKU 重复](/error-codes/CHECKOUT301.md): 由于产品 SKU 重复或无效，结账无法继续。
- [CHECKOUT401: 合计金额出现差异](/error-codes/CHECKOUT401.md): 此订单在店铺中的总额与收银台显示的金额不同。订单已按店铺中的总额保存。
- [CHECKOUT411：购物车商品行价格依据无法读取](/error-codes/CHECKOUT411.md): 此订单中的某个商品行包含 POS 无法读取的价格详情，因此其金额改为取自已存储的总计。
- [CHECKOUT421：订单税率未知](/error-codes/CHECKOUT421.md): 此订单引用的税率已不再存在于您的店铺中，因此其税额可能不正确。
- [CHECKOUT999: 结账意外错误](/error-codes/CHECKOUT999.md): 结账遇到了意外问题。
- [CLIENT101: 应用启动失败](/error-codes/CLIENT101.md): WCPOS 未能完成启动。
- [CLIENT111: 应用启动缓慢](/error-codes/CLIENT111.md): 同步的启动时间比预期更长。
- [CLIENT121: 多标签页功能受限](/error-codes/CLIENT121.md): 此浏览器每次只允许一个标签页发送更改。
- [CLIENT131: 请求队列溢出](/error-codes/CLIENT131.md): WCPOS 一次排入了过多请求，并丢弃了其中一部分。
- [CLIENT141：搜索结果不匹配](/error-codes/CLIENT141.md): 搜索结果中有些项目与您的商品不匹配，因此 WCPOS 已将其隐藏。
- [CLIENT142：搜索索引未响应](/error-codes/CLIENT142.md): 搜索索引未能及时响应，因此 WCPOS 改为直接搜索商品目录。
- [CLIENT143：搜索索引遗漏了一条记录](/error-codes/CLIENT143.md): 搜索未能找到本应出现的商品。
- [CLIENT144：搜索索引重建失败](/error-codes/CLIENT144.md): 搜索索引重建失败，因此应用重试初始化期间的搜索结果可能不完整。
- [CLIENT151：屏幕渲染失败](/error-codes/CLIENT151.md): 屏幕的一部分加载失败，已替换为错误消息。
- [CLIENT171：时钟不同步](/error-codes/CLIENT171.md): 此设备的时钟与店铺时钟相差超过一分钟。
- [CLIENT181：切换店铺失败](/error-codes/CLIENT181.md): WCPOS 无法切换到该店铺。
- [CLIENT201: 内存不足](/error-codes/CLIENT201.md): 此设备内存不足，最后一项操作可能未完成。
- [CLIENT211: 原生崩溃](/error-codes/CLIENT211.md): WCPOS 因设备层面的崩溃而停止运行。
- [CLIENT999: 意外错误](/error-codes/CLIENT999.md): WCPOS 遇到了意外错误。
- [数据库错误](/error-codes/db.md): 在本地数据库中存储或检索数据时发生数据库错误。
- [DB01001: 连接失败](/error-codes/DB01001.md): DB01001：连接失败 — POS 无法连接到本地数据库。
- [DB01002: 查询超时](/error-codes/DB01002.md): DB01002：查询超时 — 数据库操作耗时过长，未能及时完成。
- [DB01003: 交易失败](/error-codes/DB01003.md): DB01003：事务失败 — 无法完成数据库事务。
- [DB02001: 重复记录](/error-codes/DB02001.md): DB02001：重复记录 — 数据库尝试插入的记录使用了已存在的 ID。
- [DB02002: 记录未找到](/error-codes/DB02002.md): DB02002：记录未找到 — 本地数据库中不存在请求的记录。
- [DB02003: 约束违例](/error-codes/DB02003.md): DB02003：约束违例 — 您尝试保存的数据违反了数据库规则。
- [DB03001: 查询语法错误](/error-codes/DB03001.md): DB03001：查询语法错误 — 数据库查询存在语法错误。
- [DB03002: 无效的数据类型](/error-codes/DB03002.md): DB03002：无效的数据类型 — 数据类型与数据库要求的类型不匹配。
- [DB03003: 缺少必填字段](/error-codes/DB03003.md): DB03003：缺少必填字段 — 未提供必填字段。
- [HOST101：CORS 预检被拦截](/error-codes/HOST101.md): 服务器拦截了浏览器的权限检查（CORS 预检），因此 Web 应用无法访问它。
- [HOST111：CORS 配置错误](/error-codes/HOST111.md): 服务器的跨源（CORS）配置有误，因此浏览器拒绝其响应。
- [HOST121：机器人验证拦截了 API](/error-codes/HOST121.md): 一个机器人防护页面代替商店的 API 进行了响应。
- [HOST131：响应头被拒绝](/error-codes/HOST131.md): 商店前端的代理因响应头过多而拒绝服务器的响应。
- [HOST141：搜索被 WAF 拦截](/error-codes/HOST141.md): 主机的安全过滤器正在拦截产品搜索。
- [HOST151：缓存共享重放](/error-codes/HOST151.md): 主机的缓存可能会将某人的店铺数据转发给其他人。
- [HOST161：主机限速](/error-codes/HOST161.md): 主机正在对此商店的收银机进行限速。
- [LICENSE101: 许可证未在此激活](/error-codes/LICENSE101.md): 您的 WCPOS Pro 许可证未在此商店或此设备上激活。
- [LICENSE201: 版本错配，Pro 已停用](/error-codes/LICENSE201.md): WCPOS Pro 已被停用，因为其版本与 WCPOS 不匹配。
- [LICENSE301: 更新程序未获授权](/error-codes/LICENSE301.md): 更新程序未获授权下载 WCPOS Pro 的更新。
- [LICENSE999: 许可证意外错误](/error-codes/LICENSE999.md): 许可证检查遇到了意外问题。
- [PAYMENT101: 付款成功但状态检查失败](/error-codes/PAYMENT101.md): 付款已成功，但 WCPOS 随后无法刷新其状态。
- [PAYMENT201: 付款结果未知](/error-codes/PAYMENT201.md): WCPOS 无法确认终端是否已完成扣款。
- [PAYMENT301: 支付网关不可用](/error-codes/PAYMENT301.md): 所选的支付网关在此商店不可用。
- [PAYMENT311：退款结果未知](/error-codes/PAYMENT311.md): WCPOS 无法确认此次退款是否成功。
- [PAYMENT401: 终端配对未完成](/error-codes/PAYMENT401.md): 支付终端未能完成与 WCPOS 的配对。
- [PAYMENT999: 支付意外错误](/error-codes/PAYMENT999.md): 支付处理遇到了意外问题。
- [PRINT101: 自动打印未启动](/error-codes/PRINT101.md): 本收据没有启动自动打印。
- [PRINT201: 打印作业失败](/error-codes/PRINT201.md): WCPOS 无法确认打印作业是否已完成。
- [PRINT301: 无法连接打印机](/error-codes/PRINT301.md): 无法连接到所选的打印机。
- [PRINT311: 收据投递失败](/error-codes/PRINT311.md): 此收据无法通过电子邮件发送或下载。
- [PRINT999: 打印意外错误](/error-codes/PRINT999.md): 打印时遇到意外问题。不会影响任何销售。
- [PRODUCT101: 产品保存失败](/error-codes/PRODUCT101.md): 此产品更改尚未同步到您的店铺。
- [PRODUCT111: 变体添加失败](/error-codes/PRODUCT111.md): 无法将此变体添加到该产品。
- [PRODUCT201: 产品图片不可用](/error-codes/PRODUCT201.md): 此产品图片不可用，但该产品仍可正常销售。
- [PRODUCT301: 搜索无结果的原因](/error-codes/PRODUCT301.md): 没有产品与当前的搜索条件和筛选条件匹配。
- [PRODUCT321: 条形码不唯一](/error-codes/PRODUCT321.md): 有多个产品与此条形码匹配。
- [PRODUCT401: 库存已过时](/error-codes/PRODUCT401.md): 显示的库存可能比商店中的库存更旧。
- [PRODUCT411: 条形码配置不可用](/error-codes/PRODUCT411.md): 条形码扫描设置无法加载，因此扫描可能匹配不到产品。
- [PRODUCT421: 可变价格元数据无效](/error-codes/PRODUCT421.md): 无法读取此产品的变体价格数据，因此显示的价格可能有误或缺失。
- [PRODUCT999: 产品意外错误](/error-codes/PRODUCT999.md): 加载或更新产品时遇到了意外问题。
- [支付错误](/error-codes/py.md): 支付错误会在结账和处理付款时发生。
- [PY01001: 支付被拒](/error-codes/PY01001.md): PY01001：支付被拒 — 支付处理方或发卡机构拒绝了此次支付。
- [PY01002: 资金不足](/error-codes/PY01002.md): PY01002：资金不足 — 由于账户余额不足以支付该笔交易，此次支付被拒。
- [PY01003: 卡片过期](/error-codes/PY01003.md): PY01003：卡片过期 — 支付卡已超过有效期，无法再用于交易。
- [PY01004: 无效的卡号](/error-codes/PY01004.md): PY01004：无效的卡号 — 输入的卡号无效。
- [PY02001: 支付网关错误](/error-codes/PY02001.md): PY02001：支付网关错误 — 与支付网关通信时发生错误。
- [PY02002: 支付超时](/error-codes/PY02002.md): PY02002：支付超时 — 支付处理耗时过长，已超时。
- [系统错误](/error-codes/sy.md): 系统错误与设备资源和系统配置有关。
- [SY01001: 内存不足](/error-codes/SY01001.md): SY01001：内存不足 — 您的设备可用内存（RAM）不足，无法完成请求的操作。
- [SY01002: 磁盘已满](/error-codes/SY01002.md): SY01002：磁盘已满 — 您的设备存储空间已满。
- [SY01003: 权限被拒绝](/error-codes/SY01003.md): SY01003：权限被拒绝 — POS 应用程序没有权限访问所需资源。
- [SY02001: 无效的配置](/error-codes/SY02001.md): SY02001：无效配置 — 系统配置无效或已损坏。
- [SY02002: 服务不可用](/error-codes/SY02002.md): SY02002：服务不可用 — 所需的服务或组件当前不可用。
- [SYNC101: 本地数据库写入失败](/error-codes/SYNC101.md): WCPOS 无法将更改写入此设备的存储空间。
- [SYNC111: 本地数据库已损坏](/error-codes/SYNC111.md): 此设备上存储的部分数据已损坏，因此无法同步。
- [SYNC121: 同步无法连接](/error-codes/SYNC121.md): 目前无法连接到您的店铺。
- [SYNC131: 商店服务器错误](/error-codes/SYNC131.md): 您的店铺发生错误，未能完成此请求。
- [SYNC141: 商店请求被限流](/error-codes/SYNC141.md): 您的店铺要求 WCPOS 暂缓片刻。
- [SYNC151: 商店响应格式错误](/error-codes/SYNC151.md): 店铺的响应中包含多余文本，WCPOS 已尝试清理。
- [SYNC161: 本地数据库不可用](/error-codes/SYNC161.md): 此设备的存储已停止响应，因此暂停了保存。
- [SYNC171: 本地数据库初始化失败](/error-codes/SYNC171.md): WCPOS 无法在此设备上设置或移除存储。
- [SYNC181：本地数据库调用停滞](/error-codes/SYNC181.md): 此设备上的保存或加载速度非常慢，结果目前尚不明确。
- [SYNC191：写入仍在发送](/error-codes/SYNC191.md): 此更改仍在发送到您的店铺。
- [SYNC201: 记录被拒绝](/error-codes/SYNC201.md): 您的店铺拒绝了此更改，因此该更改尚未到达店铺。
- [SYNC202：记录已恢复到店铺版本](/error-codes/SYNC202.md): 店铺拒绝了此更改，因此此设备已恢复到店铺版本。
- [SYNC211: 记录字段无效](/error-codes/SYNC211.md): 店铺拒绝了发送给它的值。
- [SYNC221: 记录冲突](/error-codes/SYNC221.md): 此设备上的更改遇到了店铺中较新的编辑内容。没有数据丢失。
- [SYNC222：店铺编辑被覆盖](/error-codes/SYNC222.md): 此设备将自己的版本保存到了店铺中，覆盖了较新的编辑。
- [SYNC231：记录已发送，但未记录](/error-codes/SYNC231.md): 您的店铺已收到此更改，但此设备无法记录它已发送。
- [SYNC301: 同步落后于最新进度](/error-codes/SYNC301.md): 店铺的更改列表意外发生变化，因此 WCPOS 正在自动重新检查。没有数据丢失。
- [SYNC311: 数据结构不匹配](/error-codes/SYNC311.md): 此设备上的数据由其他版本的 WCPOS 保存，目前无法打开。
- [SYNC321: 同步不完整](/error-codes/SYNC321.md): 本次有部分数据未能同步。
- [SYNC331: 本地记录出现偏差](/error-codes/SYNC331.md): 此设备上的记录副本与店铺中的版本不一致。您输入的内容不受影响。
- [SYNC341：需要更新应用](/error-codes/SYNC341.md): 此店铺现在需要较新版本的 POS 应用。
- [SYNC401: 同步任务崩溃](/error-codes/SYNC401.md): 后台同步任务在完成之前意外停止。
- [SYNC411: 按需请求洪峰](/error-codes/SYNC411.md): 本设备向商店请求数据的频率远高于正常水平。
- [SYNC999: 同步意外错误](/error-codes/SYNC999.md): 同步遇到了意外问题。

### extensions

从扩展目录中浏览、安装和管理 POS 扩展。了解如何创建并提交自己的扩展。

- [扩展](/extensions.md): 从扩展目录中浏览、安装和管理 POS 扩展。了解如何创建并提交自己的扩展。
- [WCPOS ATUM 集成](/extensions/atum.md): 将 WCPOS Pro 店铺与 ATUM 多仓库库存位置关联，实现 POS 端按位置管理库存、定价和 SKU。
- [WCPOS Polylang 集成](/extensions/polylang.md): 按 Polylang 语言筛选 WCPOS 产品，并避免在 POS 中出现重复的已翻译产品。
- [WCPOS StoreApps Smart Coupons](/extensions/storeapps-smart-coupons.md): StoreApps Smart Coupons 店铺余额与 WCPOS 收据、订单备注和 POS 余额扣减的兼容性。
- [WCPOS WP Multilang 集成](/extensions/wp-multilang.md): 按 WP Multilang 语言筛选 WCPOS 产品，并避免 POS 中出现重复的翻译产品。
- [WCPOS WPML 集成](/extensions/wpml.md): 按 WPML 语言筛选 WCPOS 产品，并避免 POS 中出现重复的已翻译产品。

### getting-started

- [连接到您的店铺](/getting-started/connect.md): 如何将 WCPOS 连接到您的 WooCommerce 店铺，包括登录选项和连接问题排查。
- [免费版与专业版](/getting-started/free-vs-pro.md): WCPOS 免费版与 WCPOS 专业版的详细对比——涵盖所有功能、支付网关和特性，帮助您选择适合的版本。
- [安装要求](/getting-started/installation.md): WCPOS 的最低要求，包括 WordPress、WooCommerce 和 PHP 版本、支持的浏览器，以及桌面端和移动端操作系统的最低版本。
- [Is WCPOS right for you?](/getting-started/is-wcpos-right-for-you.md): Who WCPOS suits, who it doesn't, what it needs, what it costs, and how it compares with other point-of-sale options for WooCommerce, answered plainly.
- [离线功能](/getting-started/offline.md): 了解 WCPOS 中哪些功能可离线使用、本地数据库如何与 WooCommerce 同步，以及连接中断时会发生什么。
- [重新安装 WCPOS 插件的旧版本](/getting-started/previous-versions.md): 如何通过安装 WordPress.org 上的旧版本插件来降级 WCPOS。
- [安装 WCPOS Pro](/getting-started/pro-license.md): 如果你已购买 Pro 版本，请按照以下步骤安装插件。
- [产品路线图](/getting-started/roadmap.md): WCPOS 的发展方向——公开路线图、如何提交或投票支持功能需求，以及当前开发的主要方向。

### hardware

将实体设备连接到 WCPOS——收据打印机、条码扫描器、读卡器和钱箱。

- [硬件](/hardware.md): 将实体设备连接到 WCPOS——收据打印机、条码扫描器、读卡器和钱箱。
- [收据打印机](/hardware/printers.md): 在 WCPOS 中添加收据打印机——一次扫描同时覆盖 USB、Bluetooth 和 Wi-Fi，再用一张测试页确认可以打印。
- [Android 上的打印机权限](/hardware/printers/android-permissions.md): 附近的设备、本地网络访问和明文连接——这三项 Android 权限决定了打印机是出现还是消失。
- [配对 Bluetooth 收据打印机](/hardware/printers/bluetooth-pairing.md): 为什么 Bluetooth 打印机不在选择器里——一次只连一台主机、Classic 与 Low Energy 的区别，以及状态页。
- [从浏览器打印：权限与证书](/hardware/printers/browser-permissions.md): Chrome 的本地网络权限、混合内容和自签名证书——挡在浏览器与打印机之间的三件事。
- [把钱箱连接到打印机](/hardware/printers/cash-drawer.md): 钱箱插在收据打印机上，而不是收银台上。如何接线、如何开启，以及弹不开时该检查什么。
- [让应用在 iPad 或 iPhone 上找到打印机](/hardware/printers/ios-local-network.md): 在 iOS 上，被拒绝的本地网络权限看起来和一台没开机的打印机一模一样。这里说明去哪里把它重新打开。
- [浏览器打印的收据上没有徽标](/hardware/printers/logo-missing-browser.md): 收据打印正常，唯独缺了店铺徽标，而且只在浏览器标签页里如此——缺少的是 WordPress 上传目录上的一个 CORS 响应头。
- [在同一网络上给打印机一个固定地址](/hardware/printers/network-address.md): 为什么 Wi-Fi 打印机找不到，或者用了几周之后突然失灵——子网、访客 Wi-Fi、客户端隔离和 DHCP。
- [中文、泰文、阿拉伯文或西里尔文收据](/hardware/printers/non-latin-receipts.md): 打出问号或方框，说明打印机没有你所用语言的字符。改成把收据当作图像打印即可。
- [Epson 打印了一次之后就停了——先断电重启](/hardware/printers/printed-once-then-stopped.md): Epson 扣着一个永远不会打印的作业时，会连带拒绝其他所有作业。断电重启十秒就能清掉。
- [把收据宽度调对（58 mm、80 mm、42 或 48 个字符）](/hardware/printers/receipt-width.md): 测试页上的标尺能告诉你纸张宽度，以及四个字符宽度选项该选哪一个。
- [Epson 安全打印：它拦下了什么，以及如何关闭](/hardware/printers/secure-printing.md): 新的 Epson 打印机出厂时已启用安全打印，会静默丢弃收据。本文说明设置在哪里、它拦下哪些端口，以及如何关闭。
- [Epson 什么都不打印，但它的网页仍然能打开（Server Direct Print）](/hardware/printers/server-direct-print.md): 当 Epson 上的另一项服务占用了打印引擎，每一张收据都会失败，而打印机看起来完全正常。
- [打印机设置向导](/hardware/printers/setup-wizard.md): 回答几个问题，我们将逐步引导你连接收据打印机——如果测试打印失败，我们还会帮你排查解决。
- [支持的收据打印机](/hardware/printers/supported-printers.md): 哪些收据打印机经过实测、哪些预计可用、哪些暂不支持——以及如何把你的型号反馈给我们。
- [Linux 上的 USB 打印机权限](/hardware/printers/usb-linux.md): 在 Linux 上通过 USB 打印时报访问错误，说明该设备属于 root——添加一条 udev 规则把它交给你的用户。
- [Windows 上的 USB 收据打印机：安装 Generic/Text 驱动](/hardware/printers/usb-windows.md): 为什么 Windows 上的 USB 打印机要么什么都不打印，要么吐出一整页乱码符号，以及 Generic/Text 队列如何解决它。
- [条码扫描器](/hardware/scanners.md): 将条码扫描器连接到 WCPOS —— 涵盖 Web、桌面和移动端上的摄像头、键盘模式、USB 及蓝牙扫描器。
- [扫描仪设置向导](/hardware/scanners/setup-wizard.md): 回答几个问题，我们将逐步引导你设置条形码扫描仪——如果扫描没有反应，我们还会帮你排查解决。

### integrations

WCPOS 可直接与哪些第三方 WooCommerce 插件配合使用，以及各插件的预期表现。

- [集成](/integrations.md): WCPOS 可直接与哪些第三方 WooCommerce 插件配合使用，以及各插件的预期表现。
- [WooCommerce 税费](/integrations/woocommerce-tax.md): 在 WCPOS 中使用 WooCommerce Tax 自动税费（TaxJar）：了解 POS 订单如何获取税率、设置步骤以及收银台的预期行为。

### orders

在 WCPOS 中查看和管理 WooCommerce 订单，包括订单历史、退款和重新打印收据。

- [订单](/orders.md): 在 WCPOS 中查看和管理 WooCommerce 订单，包括订单历史、退款和重新打印收据。
- [退款](/orders/refunds.md): 直接从 WCPOS 为 WooCommerce 订单发起全额或部分退款，支持退回原付款方式，或从钱箱以现金退款。

### payment

配置 WCPOS 的支付方式，包括现金、卡和自定义支付网关，如 Stripe Terminal 和 SumUp。

- [支付方式](/payment.md): 配置 WCPOS 的支付方式，包括现金、卡和自定义支付网关，如 Stripe Terminal 和 SumUp。
- [支付网关](/payment/gateways.md): WCPOS 的支付网关
- [电子邮件发票网关](/payment/gateways/email-invoice.md): 在 WCPOS 中通过电子邮件向客户发送付款发票
- [Mercado Pago Terminal 网关](/payment/gateways/mercadopago-terminal.md): 在 WCPOS 中使用 Mercado Pago Point Smart 终端收取线下付款
- [Mollie Terminal 支付网关](/payment/gateways/mollie-terminal.md): 在 WCPOS 中通过 Mollie Terminal 设备接受线下付款
- [PayArc Terminal 支付网关](/payment/gateways/payarc-terminal.md): 在 WCPOS 中通过 PayArc PAX 终端收取现场付款
- [PayPal 读卡器 (Zettle) 网关](/payment/gateways/paypal-reader.md): PayPal 读卡器网关可让您使用 PayPal 读卡器 (Zettle) 卡终端直接从 WCPOS 接受当面卡付款。浏览器通过安全连接将实时支付状态从读卡器传输到 Zettle 的 Reader Connect API，以便收银员实时查看支付的每一步。
- [Square Terminal 支付网关](/payment/gateways/square-terminal.md): 在 WCPOS 中使用 Square Terminal 设备收取线下付款
- [Stripe Terminal 网关](/payment/gateways/stripe-terminal.md): 在 WCPOS 中使用 Stripe Terminal 硬件读卡器接受付款
- [SumUp Terminal 网关](/payment/gateways/sumup-terminal.md): 在 WCPOS 中通过 SumUp 读卡器处理付款
- [Vipps MobilePay 网关](/payment/gateways/vipps-mobilepay.md): 在 WCPOS 中通过二维码或推送通知接受基于电话的支付
- [网页结账网关](/payment/gateways/web-checkout.md): 通过 WCPOS 在网络商店结账完成支付
- [Windcave 终端支付网关](/payment/gateways/windcave-terminal.md): 在 WCPOS 中通过 Windcave 终端（HIT）收取现场银行卡付款

### pos

WCPOS 销售点屏幕布局概览——标题栏、产品面板、购物车、导航抽屉，以及哪些屏幕属于免费版和专业版。

- [POS屏幕概览](/pos.md): WCPOS 销售点屏幕布局概览——标题栏、产品面板、购物车、导航抽屉，以及哪些屏幕属于免费版和专业版。
- [购物车面板](/pos/cart.md): 管理 WCPOS 中的购物车，包括线条项目、数量、折扣、费用和客户选择。
- [购物车折扣](/pos/cart/discounts.md): 在 WCPOS 收银台应用折扣 —— 快速百分比折扣、商品行价格调整和订单级折扣费用。
- [购物车行项目](/pos/cart/line-items.md): 在 WCPOS 中编辑购物车行项目，包括数量、价格、折扣和产品详情，支持内联编辑。
- [打开订单](/pos/cart/open-orders.md): 在 WCPOS 中同时处理多个订单，包括停车订单、在交易之间切换以及从中断中恢复。
- [订单操作](/pos/cart/order-actions.md): 在 WCPOS 中访问订单管理功能，包括订单备注、元数据、费用、运费和折扣。
- [结账](/pos/checkout.md): 在 WCPOS 结账中完成销售，包括支付方式、支付处理和订单完成。
- [产品面板](/pos/product-panel.md): 在 WCPOS 产品面板中浏览、搜索和添加产品到购物车。包括网格/列表视图和类别过滤。
- [条码扫描](/pos/product-panel/barcode-scanning.md): 在 WCPOS 中使用 USB 扫描器、摄像头扫描或自定义条码字段设置条码扫描。
- [元数据键](/pos/product-panel/meta-data-keys.md): 使用元数据键设置，在 WCPOS 中将自定义产品元数据复制到购物车和订单行项目。
- [搜索与筛选](/pos/product-panel/search-filtering.md): 在 WCPOS 中按名称、SKU、分类、标签和其他属性搜索和筛选产品。
- [变量产品](/pos/product-panel/variations.md): 在 WCPOS 中处理 WooCommerce 变量产品，包括快速选择、行内扩展和变体条码扫描。
- [日终对账](/pos/reconciliation.md): WCPOS 收银员快速日终结账——清点收银抽屉、生成报表、核对现金和银行卡金额并签字确认。
- [收银台退款](/pos/refunds.md): 在 WCPOS 销售过程中发起退款的快速指南——发起退款、选择退款去向并确认。

### products

在WCPOS中管理WooCommerce产品，包括库存更新、价格变更和库存管理。

- [产品管理](/products.md): 在WCPOS中管理WooCommerce产品，包括库存更新、价格变更和库存管理。
- [仅限 POS 产品](/products/pos-only-products.md): 控制您的在线商店和 POS 之间的产品可见性，包括仅限 POS 和仅限在线的产品。
- [产品同步](/products/sync.md): WCPOS 如何从 WooCommerce 下载和同步产品，包括同步预设、覆盖率以及保持产品目录最新。

### receipts

使用模板库、无逻辑 HTML 模板和热敏打印机 XML 模板自定义 WCPOS 小票。

- [小票](/receipts.md): 使用模板库、无逻辑 HTML 模板和热敏打印机 XML 模板自定义 WCPOS 小票。
- [小票](/receipts/at-checkout.md): 在 WCPOS 中打印和通过电子邮件发送小票，包括打印机设置和小票自定义选项。
- [云打印](/receipts/cloud-printing.md): 将 WCPOS 收据打印到未连接到收银台的打印机——Star Online、Star CloudPRNT、Epson Server Direct Print 和 PrintNode。
- [自定义收据](/receipts/customise.md): 更改 WCPOS 收据外观的最简单方法——选择不同的模板、让 AI 帮您调整，或手动编辑。
- [HTML 模板](/receipts/html-templates.md): 使用 Mustache 风格的占位符创建和自定义无逻辑的 HTML 收据模板。
- [收据数据参考](/receipts/receipt-data.md): WCPOS 收据模板中可用的规范数据契约完整参考。
- [在线商店收据](/receipts/storefront.md): 让在线客户从“我的账户”下载使用自定义 WCPOS 模板呈现的收据和发票。
- [热敏打印机模板](/receipts/thermal-templates.md): 为支持 Epson 和 Star 的 ESC/POS 热敏打印机创建基于 XML 的收据模板。

### reference

- [架构](/reference/architecture.md): WCPOS 的技术架构，解释 POS 客户端如何与 WooCommerce REST API 通信。
- [财务合规与认证](/reference/fiscal-compliance.md): WCPOS 在财务认证（法国 NF525、西班牙 VERIFACTU、挪威、智利）和 EU OSS 方面的现状，以及可用的替代方案。
- [网关模板](/reference/gateway-template.md): 为 WCPOS 创建自定义的仅限 POS 的支付网关
- [POS 折扣技术参考](/reference/pos-discounts.md): 面向开发者的参考，介绍 WCPOS 如何存储 POS 行项目价格覆盖、它们如何与 WooCommerce 优惠券交互，以及可用的过滤器。
- [角色端点访问](/reference/role-endpoint-access.md): 面向开发者的参考，说明每个默认角色（administrator、shop_manager、cashier）可访问哪些 WCPOS REST 端点，以及令牌过期行为和诊断提示。
- [同步引擎的工作原理](/reference/sync-engine.md): v1.10.0 引入的 WCPOS 同步引擎的开发者参考：作用域、同步通道、变更检测、声明式需求、覆盖率上报以及离线写入队列。
- [同步性能与服务器友好性](/reference/sync-performance.md): WCPOS 同步引擎如何保护您的服务器：有界的请求上限、压力下的退避、响应性保证，以及支撑这些结论的实测数据。
- [理解 WooCommerce REST API](/reference/wc-rest-api.md): WooCommerce REST API 就像一组标准化的“通道”，允许商店拥有者将他们的 WooCommerce 商店连接到其他应用程序和服务。

### reports

在 WCPOS 中查看销售报告和数据分析，包括每日摘要、支付细分和收银员报告。

- [报告](/reports.md): 在 WCPOS 中查看销售报告和数据分析，包括每日摘要、支付细分和收银员报告。
- [日终对账](/reports/reconciliation.md): WCPOS 日终操作流程——清点收银抽屉、生成报表、核对现金与刷卡金额、处理差异并签字确认。

### search

- [搜索文档](/search.md)

### settings

WCPOS 设置的概述，包括 WordPress 管理设置、商店设置和应用首选项。

- [设置概述](/settings.md): WCPOS 设置的概述，包括 WordPress 管理设置、商店设置和应用首选项。
- [商店设置](/settings/store.md): 配置 WCPOS 商店设置，包括常规选项、税收、条形码扫描、主题和键盘快捷键。
- [条形码设置](/settings/store/barcode.md): 在 WCPOS 中配置条形码扫描设置，包括扫描延迟、搜索操作和相机扫描选项。
- [常规设置](/settings/store/general.md): 配置 WCPOS 商店设置，包括货币显示、数字格式和默认订单状态。
- [键盘快捷键](/settings/store/hotkeys.md): 在 WCPOS 中配置键盘快捷键，以便更快地进行结账和导航，使用可自定义的热键。
- [税务设置](/settings/store/tax.md): 在 WCPOS 中配置税费计算和显示设置，包括含税定价和逐项税费显示。
- [主题设置](/settings/store/theme.md): 通过明亮、黑暗、系统主题及强调色选项自定义 WCPOS 的外观。
- [WordPress 管理后台中的设置](/settings/wp-admin.md): 在 WordPress 管理后台配置 WCPOS 后端设置，包括常规选项、结账和用户访问权限。
- [访问 POS](/settings/wp-admin/access.md): 配置 WCPOS 访问权限的用户角色和能力，包括管理员、店铺经理和收银员权限。
- [结账设置](/settings/wp-admin/checkout.md): 在 WordPress 管理中配置 WCPOS 结账设置，包括支付网关和订单处理。
- [客户税号](/settings/wp-admin/customer-tax-ids.md): WCPOS 如何存储客户税号、检测要写入哪个插件的字段，以及如何在结账时将税号复制到订单上。
- [电子邮件通知](/settings/wp-admin/email-notifications.md): 控制 POS 订单触发哪些 WooCommerce 电子邮件通知——WCPOS 设置中针对管理员、客户和收银员的每封电子邮件开关。
- [通用设置](/settings/wp-admin/general.md): 在 WordPress 管理中配置 WCPOS 通用设置，包括仅限 POS 的产品、小数数量和条形码字段。
- [会话](/settings/wp-admin/sessions.md): 查看每个用户和设备的活跃 POS 登录会话，并远程将设备从 WCPOS 中登出。
- [商店税号](/settings/wp-admin/store-tax-ids.md): 配置 WCPOS 在 POS 收据和发票上打印的企业税号标识符，包括 VAT、ABN、GSTIN、EIN 和公司注册号。

### stores

在 WCPOS 中设置和管理多个店铺位置，包括按店铺定价、ATUM 库存集成、税率和报表。

- [多店铺](/stores.md): 在 WCPOS 中设置和管理多个店铺位置，包括按店铺定价、ATUM 库存集成、税率和报表。
- [设置店铺](/stores/setup.md): 在 WCPOS Pro 中创建和配置店铺位置的分步指南——店铺详情、授权用户、税务、定价和登录行为。

### support

通过 Discord、电子邮件支持或浏览故障排除指南和常见问题解答，获取 WCPOS 的帮助。

- [支持](/support.md): 通过 Discord、电子邮件支持或浏览故障排除指南和常见问题解答，获取 WCPOS 的帮助。
- [日志](/support/logs.md): 访问和理解 WCPOS 日志以进行故障排除，包括商店健康活动日志、服务器端日志和错误代码。
- [通知](/support/notifications.md): 了解 WCPOS 应用内的通知铃铛——公告、插件更新和许可证提醒都会显示在这里。
- [性能](/support/performance.md): 优化 WCPOS 性能，包括服务器配置、结账速度和 WooCommerce HPOS 迁移。
- [结账性能](/support/performance/checkout.md): 通过分析执行时间和识别瓶颈来排查 WCPOS 中缓慢的结账时间问题。
- [服务器性能](/support/performance/server.md): 优化 WCPOS 的 WordPress 服务器性能，包括 HPOS、缓存、数据库优化和托管建议。
- [商店健康](/support/store-health.md): WCPOS 中的商店健康区域：同步性能预设与实测服务器负载、各集合的下载覆盖情况、恢复被拒绝的更改，以及活动日志。
- [参与翻译](/support/translations.md): WCPOS 的翻译方式：由 AI 按调校后的规则生成，并由社区持续改进。请在 wcpos/translations 仓库中为应用和插件提出修正建议，并在 wcpos/docs 仓库中为这些文档提出修正建议。
- [清除所有本地数据](/support/troubleshooting/clear-local-data.md): 如何清除本地 WCPOS 数据库并从您的 WooCommerce 商店触发新的同步。
- [Cloudflare](/support/troubleshooting/cloudflare.md): Stop Cloudflare's security checks from blocking the WCPOS app's connection to your store.
- [排查“网站上发生了严重错误。”](/support/troubleshooting/critical-error.md): 通过检查 WooCommerce 致命错误日志并识别原因，修复 WCPOS 中的 WordPress 严重错误。
- [插件冲突](/support/troubleshooting/plugin-conflicts.md): 使用系统化的故障排除方法识别和解决影响 WCPOS 的 WordPress 插件冲突。
- [解决“无法读取未定义的属性（读取'data'）”错误](/support/troubleshooting/response-error.md): 修复WCPOS中因空服务器响应或插件冲突导致的“无法读取未定义的属性”错误。
- [您的店铺与 POS 的总计不一致](/support/troubleshooting/totals-disagree.md): 了解 WCPOS 报告店铺更改订单总计的含义，以及如何查找原因。

## Optional
- [WCPOS Website](https://wcpos.com): Product website and downloads
- [GitHub](https://github.com/wcpos): Source code and issue tracker
- [Discord](https://wcpos.com/discord): Community support chat
- [WordPress.org plugin](https://wordpress.org/plugins/woocommerce-pos/): Free version on the WordPress plugin directory
- [WCPOS Pro](https://wcpos.com/pro): Pro features and licensing
- [Compare WooCommerce POS systems](https://wcpos.com/compare): WCPOS compared with Oliver POS, WooCommerce's official POS, Square, Jovvie, Vitepos, YITH and FooSales: pricing, offline support, hardware, and when each is the better choice