跳转到主要内容

如何将 Xero 连接到 QashierHQ（每日销售同步）

只需几个步骤，同步销售数据并优化您的会计和财务管理流程。

将 Xero 连接到 QashierHQ 后，Qashier 每天会为每个店铺向 Xero 发布一张前一天销售的发票，并已标记为已付款。同步是单向的（从 Qashier 到 Xero），只涵盖连接之后产生的销售。连接之前的销售不会同步。

适用范围：新加坡、马来西亚、菲律宾和泰国 · QashierHQ · Qashier 商城中的 Xero Integration（Xero 集成）功能 · 拥有设置权限的 QashierHQ 登录账户。

开始之前

  • 在 QashierHQ 中打开 Qashier 商城，为每个要同步的店铺启用 Xero Integration。至少为一个店铺完成此操作后，才会出现 Xero Settings（Xero 设置）。请参阅如何在 Qashier 商城中添加功能和管理套餐（QashierHQ）。

  • 你需要一个 Xero 登录账户，并能访问你要发布销售数据的组织。

  • 请像对待密码一样对待你的 Xero Client Secret（客户端密钥）。切勿与任何人分享，包括 Qashier 客服。

第 1 部分：在 Xero 中创建应用

  1. 登录 Xero，然后前往 developer.xero.com/app/manage。

  2. 选择 New app（新建应用）。

  3. 填写表单：

    • App name（应用名称）：自行命名，例如 QashierApp

    • Integration type（集成类型）：Web app（网页应用）

    • Company or application URL（公司或应用网址）：https://hq.qashier.com/

    • Redirect URI（重定向 URI）：https://api.qashier.com/v1/xeroCallback——请原样复制，末尾不要加斜杠。这是一个要粘贴的值，不是要打开的页面。

  4. 阅读并接受条款和条件，然后选择 Create app（创建应用）。

  5. 在应用左侧的菜单中，选择 Configuration（配置）。

  6. 复制 Client id（客户端 ID）。你需要把它粘贴到 QashierHQ 中。

  7. 选择 Generate a secret（生成密钥），然后立即复制该密钥。Xero 只会显示一次。如果丢失，请重新生成一个。

第 2 部分：在 QashierHQ 中连接 Xero

  1. 登录 QashierHQ。

  2. 点击右上角的齿轮图标（设置）。在手机上，打开个人资料菜单并点按 设置。

  3. 在左侧面板的 Integrations（集成）下，选择 Xero Settings。

  4. 将从 Xero 复制的 Client id 粘贴到 Client ID（客户端 ID）。

  5. 将从 Xero 复制的密钥粘贴到 Client Secret。

  6. 点击 Submit（提交）。系统会将你转到 Xero 登录。

  7. 在 Xero 中，选择要连接的组织，然后选择 Allow access（允许访问）。系统会将你带回 QashierHQ 的 Xero Settings。

第 3 部分：将每个店铺映射到 Xero

  1. 在 Xero Settings 中，从 Store（店铺）下拉菜单中选择店铺。只会列出已启用 Xero Integration 的店铺。

  2. 在 Organization（组织）中选择 Xero 组织。

  3. 在 Accounts for Products（产品账户）下，选择你的 Default Sales Account（默认销售账户）。这是 Xero 中的收入账户，例如 200 - Sales。它适用于所有产品的销售。

  4. 选择你的 Default Payment Account（默认付款账户）。每日销售会记入此账户。如果列表为空，请参阅下方章节。

  5. 如果你的店铺收税，会出现 Sales Tax（销售税）部分。在标签为 GST 的字段中（所有市场的标签都相同），选择对应的 Xero 税率：马来西亚选择你的 SST 税率，泰国或菲律宾选择你的 VAT 税率。不收税的店铺不会看到此部分。

  6. 点击 SAVE（保存）。对每个店铺重复以上操作。

如果 Default Payment Account 没有显示任何内容

QashierHQ 只会列出 Xero 中已启用付款、处于活动状态的 Current Asset（流动资产）账户。请创建一个：

  1. 登录 Xero，从顶部菜单选择 Accounting（会计），然后选择 Chart of accounts（科目表）。

  2. 选择 + Add Account（添加账户）。

  3. 将 Account type（账户类型）设为 Current Asset。输入自选的 Code（代码）和 Name（名称），如有需要可填写描述，并设置税务选项。

  4. 勾选 Enable payments to this account（允许向此账户付款），然后选择 Save（保存）。

  5. 刷新 QashierHQ，回到 Xero Settings，再次选择 Default Payment Account。

动画指南：在 Xero 中添加付款账户。

你在 Xero 中应该看到的结果

每天午夜过后不久（新加坡时间），Qashier 会为每个店铺向 Xero 发布一张前一天已完成销售的发票，并在你的 Default Payment Account 中记录一笔付款。发票的状态为 Authorised（已授权），描述为 YYYY-MM-DD Daily Sales，联系人为 QashierPOS - 你的店铺名称，参考号为 QashierPOS Sales。退款、作废和储值充值交易不包括在内。没有销售的日子不会生成发票。

在 Xero 中创建的发票示例。

管理你的连接

  • 关联另一个 Xero 组织：在 Xero Settings 中，选择 Don't see your organization?（找不到你的组织？），然后按提示操作。

  • 断开连接：在 Xero Settings 中，选择 Disconnect from Xero（断开 Xero 连接），然后点击 断开连接 确认。你可以随时重新输入 Client ID 和 Client Secret 重新连接。

如果出现问题

症状

原因

解决方法

点击 Submit 后，Xero 显示 invalid redirect_uri 错误

你的 Xero 应用中的 Redirect URI 不完全一致

在 Xero 开发者门户中打开你的应用的 Configuration，将 Redirect URI 设置为 https://api.qashier.com/v1/xeroCallback，末尾不要加斜杠。然后在 QashierHQ 中重新提交。

设置面板中没有 Xero Settings

没有任何店铺启用 Xero Integration

在 Qashier 商城 中启用它，然后重新加载 QashierHQ。

Store 下拉菜单中缺少某个店铺

该店铺未启用 Xero Integration，或它已关联到另一个门店

为该店铺启用 Xero Integration。已关联到另一个店铺的店铺不会列出；如果你需要在 Xero 中查看其销售，请联系 Qashier 客服。

点击 SAVE 失败，并显示 Please select a tax rate（请选择税率）

你的店铺收税，但 Sales Tax 字段为空

在 GST 字段中选择对应的 Xero 税率，然后再次保存。

Xero 中没有出现发票

店铺的映射不完整、Xero 连接已过期或已被移除，或该店铺当天没有销售

打开 Xero Settings，选择该店铺，检查 Organization、Default Sales Account、Default Payment Account 以及（如收税）GST 字段是否都已保存。如果连接已在 Xero 中被移除，请从第 2 部分重新连接。没有销售的日子不会生成发票。

连接之前的销售缺失

只同步连接之后产生的销售

在 Xero 中手动录入之前的日期，或在需要帮助时联系 Qashier 客服。

仍未解决？联系 Qashier 客服。

相关文章

最后核实：2026年9月25日 · 适用市场：SG, MY, PH, TH

这是否解答了您的问题？