LedgerPort 将您的 WooCommerce 商店连接到 QuickBooks Online (QBO) 并保持自动同步。当在 WooCommerce 中下订单、更新订单或完成订单时，LedgerPort 会实时将该数据发送到您的 QuickBooks 公司 – 无需手动导出，无需上传 CSV，无需重复数据录入。
本指南将介绍 LedgerPort 的功能、安装前的准备工作以及从头到尾的设置过程。
LedgerPort 的功能
LedgerPort 使用 Webhook 监听您的 WooCommerce 商店，并通过 LedgerPort SaaS 平台将数据转发到 QuickBooks Online。以下数据会进行同步：
| WooCommerce 数据 | 同步方向 |
|---|---|
| 订单（创建、更新、删除） | WooCommerce – QuickBooks Online |
| 产品（创建、更新、删除） | WooCommerce – QuickBooks Online |
| 产品变体 | WooCommerce – QuickBooks Online |
| 客户（创建、更新、删除） | WooCommerce – QuickBooks Online |
| 退款 | WooCommerce – QuickBooks Online |
当 WooCommerce 中发生事件时，同步会自动实时进行。您也可以随时从 LedgerPort 管理菜单触发手动同步。
工作原理
LedgerPort 是一个由两部分组成的系统：
- WordPress 插件 – 安装在您的 WooCommerce 商店中。它提供 WooCommerce API 凭证和 Webhook，并充当您的商店与 LedgerPort 平台之间的桥梁。
- LedgerPort SaaS 平台 – 托管在 app.ledgerport.com。在这里，您可以管理您的 QuickBooks Online 连接、存储您的账户映射、运行同步逻辑以及保留您的审计日志。
该插件负责处理 WordPress 端发生的所有事情。SaaS 平台负责 QuickBooks 端。您可以在 WordPress 中的 LedgerPort 管理菜单中管理两者。
要求
在安装 LedgerPort 之前，请确认您的环境满足以下条件：
| 要求 | 最低版本 |
|---|---|
| WordPress | 6.0 或更高版本 |
| PHP | 8.0 或更高版本 |
| WooCommerce | 已安装并激活（任何近期版本） |
| HTTPS | 必需 – 您的网站必须使用 SSL |
| LedgerPort 账户 | 在 ledgerport.com 上的有效账户 |
| QuickBooks Online | 已链接到您的 LedgerPort 账户的有效 QBO 公司 |
需要 HTTPS。 LedgerPort 不允许您在未使用 SSL/HTTPS 的网站上完成连接流程。如果您的网站仅使用 HTTP，请在继续之前启用 SSL。大多数托管提供商通过 Let’s Encrypt 提供免费 SSL。
货币必须匹配。 您的 WooCommerce 商店货币和您的 QuickBooks Online 公司的主货币必须相同。LedgerPort 不进行货币转换。如果存在不匹配，连接将不会激活。
LedgerPort 管理菜单
安装并连接插件后，这些页面可在您 WordPress 管理后台的 LedgerPort 菜单下找到：
| 页面 | 显示内容 |
|---|---|
| 仪表盘 | 连接状态、上次同步时间、最近的错误 |
| 连接 | 连接详情、QuickBooks 账户、套餐和使用情况、断开连接 |
| 映射 | 将 WooCommerce 产品、客户和账户映射到 QuickBooks 实体 |
| 手动同步 | 触发立即同步到 QuickBooks |
| 审计日志 | 完整的同步历史记录，可按类型、实体、状态和日期进行筛选 |
| 同步配置 | 配置同步内容和方式 |
| 调试日志 | 插件级别的诊断日志 |
设置概览
设置 LedgerPort 大约需要五分钟。流程如下：
- 在您的 WordPress 网站上安装 LedgerPort 插件（从 WordPress.org 或上传 zip 文件）。
- 激活后，插件会自动打开设置向导。
- 在设置向导中，点击 连接 开始连接流程。
- 您将被重定向到 app.ledgerport.com 进行登录和授权连接。
- 授权后，您将被重定向回您的 WordPress 网站。
- LedgerPort 会自动创建 WooCommerce REST API 密钥并注册 Webhook。
- 连接已确认，您将进入仪表盘。
- 配置您的账户映射，以便 WooCommerce 数据正确映射到您的 QuickBooks 账户表。
常见问题解答
LedgerPort 是否支持 HPOS（高性能订单存储）？ 是的。LedgerPort 声明完全兼容 WooCommerce 的高性能订单存储（自定义订单表）。无需额外配置。
安装插件前是否需要 LedgerPort 账户？ 是的。您需要一个有效的 ledgerport.com 账户才能完成连接。如果您还没有账户，可以在设置过程中创建。
我能否将多个 WooCommerce 商店连接到一个 LedgerPort 账户？ 这取决于您的 LedgerPort 套餐。每个连接的商店计为一个连接。您的套餐连接限制显示在管理菜单的“连接”页面上。
LedgerPort 是否支持 WooCommerce Subscriptions？ LedgerPort 会同步标准的 WooCommerce 订单和客户数据。订阅续订订单在 WooCommerce 中创建时，会作为常规订单进行同步。
如果我的网站失去互联网连接或 LedgerPort API 暂时不可用，会发生什么？ LedgerPort 使用 WooCommerce 网页钩子进行实时同步。如果网页钩子传递失败，WooCommerce 将自动重试。您也可以使用“手动同步”页面按需推送数据。
如果您遇到任何问题，请随时在此处单击 联系我们。我们的支持团队将能够为您提供帮助。
