xtraCHEF：获取 QuickBooks 提取错误的帮助

本文内容：

• 确定提取是否成功
• QuickBooks 错误代码
  • 对供应商的无效引用
  • 对 XCG-TAX 的无效引用
  • 账户在 QuickBooks 中不存在
  • Message=AuthenticationFailed
  • 字符串长度
  • 不支持的功能
  • 位置账户号码未分配

确定提取是否成功

要确定提取是否成功导入到 QuickBooks，请查看 提取监视器。对于任何状态不是绿色的发票提取，选择 查看详细信息 以获取该特定文件。

根据错误消息的内容，使用本指南来解决该错误。

返回顶部

QuickBooks 错误代码

本指南的其余部分将引用 QuickBooks 提取错误代码及其修复方法。

返回顶部

对供应商的无效引用

“在账单中对 QuickBooks 供应商 '供应商名称' 的引用无效。QuickBooks 错误消息：无效的参数。”
或
“供应商 '供应商名称' 在 QuickBooks 中不存在"

此类错误是由于供应商代码与 QuickBooks 中列出的供应商名称或 "显示名称" 不匹配。可以通过以下步骤更正供应商代码：

• 在 xtraCHEF 的左侧菜单栏中打开 供应商 页面。
• 搜索特定的供应商。
• 选择要更新的 租户供应商代码。
• 进行更改并选择 确认按钮。
  • xtraCHEF 中的供应商代码应与 QuickBooks 中的供应商完全匹配。
    • QuickBooks Online：xtraCHEF 中的供应商代码应与供应商的 "显示名称" 匹配。
    • QuickBooks Desktop：xtraCHEF 中的供应商代码应与 QuickBooks 中的供应商名称匹配。
• 一旦租户供应商代码更新，您可以从提取监视器中重新提取失败的文件。

返回顶部

对 XCG-TAX 的无效引用

“账单中对 QuickBooks 账户 "XCG-TAX" 的引用无效。QuickBooks 错误消息：无效的参数。”

此错误是由于您的标题级别费用分配方式造成的。xtraCHEF 有四个标题级别费用，可以根据您的偏好进行分配。

• 销售税
• 运费/分配费用
• 折扣
• 其他费用

有3种选项来处理这些头部级别的费用。从三者中选择一个：

1. 在所有应用于发票的GL代码中均匀分配。
2. 仅适用于发票上列出的最高成本的GL代码。
3. 适用于您QB系统中的特定GL代码。

如果没有列出偏好，xtraCHEF将把这些应用于默认GL：XCG-FC、XCG-OC、XCG-DC和XCG-TAX。

返回顶部

账户在QuickBooks中不存在

“账户 '1234' 在QuickBooks中不存在”
或
“账单中对QuickBooks账户"1234"的引用无效。QuickBooks 错误消息：无效的参数。指定的记录在列表中不存在。”

当发票上列出的GL代码在您的QuickBooks系统中不存在时，可能会出现此错误。此错误将在所有包含提取错误消息中指定的GL代码的发票上出现。

选项 1：如果GL是正确的，但在xtraCHEF中列出与在QuickBooks中显示的不同，可以通过以下步骤编辑GL代码：

1. 在xtraCHEF账户的右上角选择齿轮图标 > GL代码。只有租户管理员才能访问此功能。
2. 选择错误消息中列出的特定GL代码，然后选择编辑GL代码。
3. 然后更新GL代码以匹配在QuickBooks中的显示方式。选择“保存”。

选项 2：如果错误消息中显示了不正确的 GL 代码，这将表明发票上列出的产品分配了不正确的类别。要纠正此问题，请按照以下步骤从项目库更新类别（GL 代码）：

1. 在 xtraCHEF 的左侧导航中导航到 项目库。
2. 使用下拉菜单筛选与发票相关的特定供应商并选择发票项目。
3. 在页面底部，更新 类别 字段，您将看到 GL 代码字段相应更新。选择 保存更改。
4. 一旦类别更新，尝试重新提取发票。

返回顶部

Message=AuthenticationFailed

“message=AuthenticationFailed; errorCode=003200; statusCode=401”

此错误通常与 QuickBooks Online 令牌过期有关，或者可能只是来自 QuickBooks 的超时错误。 首先，尝试从提取监视器或发票搜索中重新提取提取文件或特定发票。如果再次收到相同的错误，请指导客户刷新 QuickBooks 令牌。

要刷新 QuickBooks 令牌，客户需要：

1. 在 xtraCHEF 右上角导航到 齿轮图标 > 账户设置。
2. 选择 集成 选项卡。
3. 选择 连接到 QuickBooks。

这将提示他们登录 QuickBooks Online，并需要由具有 QuickBooks 管理员访问权限的人完成。

返回顶部

字符串长度

“字符串长度短于或长于规范支持的长度”

发票 ID 太长。QBO 对发票 ID 的字符数限制为 21 个。

1. 在 xtraCHEF 的左侧导航中导航到 搜索发票。
2. 找到发票并选择 编辑发票。
3. 将发票号码更正为少于 21 个字符。
4. 提交发票。
5. 然后您应该能够从发票搜索中重新提取发票。

返回顶部

不支持的功能

“错误信息：不支持的功能错误。”

此错误表示 QuickBooks 的版本不支持 API 集成。自雇和简单启动的 QuickBooks Online 版本不支持与 xtraCHEF 的集成。以下是支持 API 集成的 QuickBooks Online 版本：

• QuickBooks Online Essentials
• QuickBooks Online Plus
• QuickBooks Online Advanced

返回顶部

位置账户号码未分配

“警告：在 XtraCHEF 中未分配位置账户号码。账单已推送到 QBO，但未分配任何类别。”

这不是提取失败；带有此警告的发票仍将被提取到QuickBooks。这是来自QuickBooks的提取警告，说明该位置的账户号码与QuickBooks中该位置名称的显示不匹配。 此错误可以通过租户管理员按照以下步骤解决：

1. 从xtraCHEF右上角选择齿轮图标 > 位置。
2. 选择具体的问题位置。
3. 选择编辑位置详情。
4. 根据在xtraCHEF中输入的类别名称编辑账户号码。
5. 解决错误后，重新提取发票。
6. 导航到提取监控器。
7. 选择未能提取的文件。
8. 一旦文件被高亮，选择右上角的重新提取。

如果相关发票根本没有被提取，您需要确认以下内容：

• 确认所有行项目是否已映射到发票上的GL代码。
  • 导航到搜索发票，选择发票编号，它将列出所有分配给该发票的GL。如果列出了未分配，那么该项目应该在您的映射发票项目队列中。
• 确认发票处于已处理状态。如果没有，它可能在您的异常、产品验证或审批队列中。
• 确认特定供应商是否列出了供应商代码。您可以通过在供应商中心搜索该供应商来检查。供应商代码应与以下内容一一匹配：
  • QuickBooks Online:供应商代码应与“显示名称”匹配。
  • QuickBooks Desktop:供应商代码应与供应商名称匹配。

在确认上述步骤不适用于发票但仍未提取后，运行按需提取。对于 QuickBooks Online，您可以按照以下步骤运行按需提取：

• 在 xtraCHEF 的左侧菜单中选择 提取监视器。
• 在左上角选择 按需提取 按钮。
• 将出现一个弹出窗口，说明按需提取中包含多少张发票。

如果您使用的是 QuickBooks Desktop，请按照 本文 中的步骤使用 Web 连接器进行手动同步。

返回顶部