Xero 连接器 (API) - 同步

重要提示：Xero 连接器（API）是一个可选的付费附加组件。

欲了解更多信息，请联系[email protected]

本文将指导您如何将 Zedonk 连接到 Xero 以及如何执行首次同步。

#连接到 Xero

#登录到 Xero

#输入您的 Xero 用户名/电子邮件地址和密码，然后点击[登录]

#点击[允许访问]

提示：由于 Xero 的 API 安全措施，您在每次执行连接器上的同步后都需要重新登录。

#点击[测试连接]以测试 Zedonk 和 Xero 之间的连接

“测试连接结果”将显示测试是否成功：

#如果您在 Zedonk 的首次同步之前使用过 Xero

重要提示：请务必注意，Zedonk 和 Xero 的客户名称必须完全匹配。

此外，Zedonk 的账户代码和 Xero 的客户代码也必须完全匹配。

1. 手动交叉引用 Zedonk 中的客户名称和账户代码与 Xero 中相应的账户代码以确保匹配。
2. 仅在首次同步时启用“检查现有客户”任务，然后点击[同步]

这将创建匹配记录之间的链接。

现在，Zedonk 中任何不存在于 Xero 的新客户都可以导出。

仅执行“导出客户”任务，然后点击[同步]

Zedonk 中名称/账户代码在 Xero 中不存在的任何客户将被创建为 Xero 中的新客户记录。

1. 手动检查客户名称和账户代码（Zedonk）与账户代码（Xero）以匹配
2. 仅在首次同步时执行检查现有客户任务：

#如果您在 Zedonk 的首次同步之前未使用过 Xero

重要提示：请务必注意，Zedonk 和 Xero 的客户名称必须完全匹配。

此外，Zedonk 的账户代码和 Xero 的客户代码也必须完全匹配。

您的首次同步应包括“导出客户”和“检查现有客户”任务。

请按照下述指示操作：

#Xero 连接器：审查和解决客户导出错误

提示：如果您首次同步发票，您可能会注意到以下错误：

• （消息）处理发票（带通用产品）...
• （错误）字典中不存在给定的键。

忽略错误消息，点击[连接到 Xero]，然后再次点击[同步]，您应该不再看到错误。

导出后，您可以在导出结果区域查看任何错误。如果客户记录未在 Xero 中创建，通常是由于电子邮件地址格式不正确。阅读导出结果以查找任何异常，然后在 Zedonk 中修改客户详细信息后再次运行同步。如果您对任何错误不确定，可以复制完整的导出结果并发送给我们的帮助台。

对于从 Zedonk 新导出的客户记录，Xero 将自动为现有或空白账户代码应用唯一前缀以避免重复。例如，代码可能显示为Z_000000_XXXXXX。为了确保您的系统匹配，您必须从 Xero 将此新的唯一代码复制回 Zedonk 中的客户账户代码字段。这是确保未来发票和信用票据可以正确导出的关键步骤。

#现在您了解了其工作原理，您可以根据需要导出您的文档数据。

1. 导出客户 和 检查现有客户 - 选择此选项以导出、创建和/或检查 Zedonk 客户记录与 Xero 的匹配。客户必须已存在于 Xero 中才能接收文档，Zedonk 中的客户名称是同步的控制名称。
2. 导出发票、第一张发票 和 最后一张发票 - 勾选这些选项以在 Xero 中创建发票。您可以按特定的数字范围过滤，该范围应与 Zedonk 的发票文档编号匹配。或者，您可以输入如 00000 - 99990 的范围仅根据修改日期导出。注意：'9' 的数量必须与您文档中的数字位数匹配（例如，如果您的发票是 2019001，您将输入 9999999）。
3. 导出信用票据、第一张信用票据 和最后一张信用票据 - 勾选这些选项以在 Xero 中创建信用票据。您可以按特定的数字范围过滤，该范围应与 Zedonk 的信用票据文档编号匹配。或者，您可以输入如 00000 - 99990 的范围仅根据修改日期导出。注意：'9' 的数量必须与您文档中的数字位数匹配（例如，如果您的发票是 2019001，您将输入 9999999）。
4. 未锁定的文档 和 已锁定的文档 - 选择导出未锁定或已锁定的文档，或两者。您可以在 Zedonk 中锁定文档以防止用户进一步修改。
5. 修改于或之后 - 添加日期过滤器以仅导出在特定日期或之后创建或修改的文档。这是与销售税提交日期或年终提交日期对齐的有用工具，因为它可以匹配您 Xero 帐户中的锁定日期。
6. 保存 - 为了避免重复选择并确保您选择的最后日期可见，请务必保存您的导出设置。

#点击[同步]

#示例

在此示例中，导出设置被设置为同步在 2016 年 10 月 1 日之后创建或修改的已锁定和未锁定的发票。

查看结果，将显示成功的条目。

如果您遇到任何错误消息，阅读此文章。

不活跃的记录将不会被导出：

#在 Xero 中，您现在有一张发票

1. 项目代码 - 您在 Xero 连接器配置设置中输入的通用产品名称
2. 描述 - 发票/信用票据上产品数量的摘要
3. 账户 - 您在 Xero 连接器配置设置中输入的名义账户名称
4. 税率 - 根据发票确认税率
5. 跟踪选项 1 - 跟踪选项 1 在 Xero 连接器配置设置中定义
6. 跟踪选项 2 - 跟踪选项 2 在 Xero 连接器配置设置中定义
7. PDF - 从 Zedonk 上传的发票/信用票据 PDF
8. 到期日 - 如果您在 Zedonk 发票中输入了“付款到期日”，此字段将被填充