xtraCHEF:提取监控

上次更新时间:2026年4月8日 10:09

提取监视器记录成功和不成功的提取到QuickBooks的情况。您还可以下载一个适用于非QuickBooks系统的文件。

本文内容:

 

什么是提取监控?

提取监控 是 xtraCHEF 为您的第三方会计准备和记录发票提取的地方。在这里,您可以快速查看发票提取状态,重新提取失败的发票,并发起按需提取。提取监控也是您可以下载非 QuickBooks 会计系统的 CSV 文件提取的地方。


返回顶部
 

查看提取详情

  1. 要开始,请在您的 xtraCHEF 账户左侧选择 提取监控。然后选择您的位置、日期范围和提取类型(您的提取类型将是您想要与之同步发票数据的软件)。开始日期 只能设置为您已同步的最早日期。

    提取监控导航

  2. 当您准备好时,选择 提交,您将看到您的发票提取及其批次状态的记录。
  3. 在您设置的日期范围内发生的任何提取将显示在下面。这些提取批次可能包含多个发票。提取状态将突出显示任何成功的提取并标注失败的提取。

    提取状态

  4. 发票提取状态列下,成功的提取显示为绿色,而失败的提取则为橙色。如果其中一张发票出现错误,它将显示为橙色。选择查看详情以了解特定发票的错误。

    查看详情

  5. 在大多数情况下,您将能够解决根本问题。然后可以重新提取发票,以确保应付账款没有缺口。

 

返回顶部
 

重新提取失败的提取

  1. 在发现发票提取失败的原因并解决根本原因后,您可以通过选择发票批次和重新提取来重新提取发票。

    重新提取高亮显示的

  2. 然后,在确认消息上选择注意:一次可以重新提取的发票数量是有限制的。限制根据日期范围和/或发票数量而有所不同。


返回顶部

 

调整您的提取日期

您可能会注意到某些发票未能提取,因为发票日期早于xtraCHEF账户的提取日期。在xtraCHEF中,有一种简单的方法可以纠正此问题。注意:如果在位置级别启用了QuickBooks,请联系客户服务以更改开始日期。

 

  1. 选择齿轮图标 > 账户设置 > 集成选项卡。
  2. 从QuickBooks同步区域下,您可以调整希望开始同步发票的日期。
  3. 此外,您可以启用按需选项。这将仅在您使用按需提取仅按钮时允许发票同步,位于提取监视器中。

 

突出显示的QuickBooks在线集成屏幕,带有同步开始日期和按需提取仅字段

 


返回顶部

 

 启动按需提取

您可以通过提取监视器启动按需提取。这将把当前处理的xtraCHEF中的任何发票推送到提取中。运行按需提取不会干扰您通常的提取节奏。要做到这一点,请选择按需提取。将呈现符合条件的发票列表,用户可以手动排除特定发票(通过发票日期和/或提取日期)以便于最终提取请求。
 

选择按需提取

 

返回顶部
 

提取错误和解决方案

如果在使用提取监视器或执行提取时收到错误消息,请快速跳转到下面列表中的错误消息和解决方案:

 

 

"对QuickBooks供应商 "供应商名称" 的引用无效。 QuickBooks错误消息:无效的参数。 供应商 '供应商名称' 在QuickBooks中不存在。"

此类错误是由于租户供应商代码与QuickBooks中列出的供应商名称或 "显示名称" 不匹配。要解决此问题,您必须在xtraCHEF的 供应商 中更正供应商代码,以匹配QuickBooks中列出的内容。


完成以下步骤:

 

  1. 从 xtraCHEF 的左侧菜单栏中选择 供应商
  2. 搜索特定的供应商。
  3. 选择您希望更新的 供应商代码
  4. 确保 xtraCHEF 和 QuickBooks 中的供应商代码相同。要查看此字段,请在 QuickBooks 中编辑供应商信息。
    1. QuickBooks Online:供应商代码应与 显示名称字段匹配。
    2. QuickBooks Desktop:供应商代码应与 供应商名称在桌面中匹配。
  5. 一旦供应商代码更新,您可以从 提取监视器搜索发票 中重新提取失败的文件。

 

返回顶部
 

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

当发票上列出的 GL 代码未在您的 QuickBooks 系统中列出时,将返回此错误。此错误将出现在所有带有提取错误消息中指定的 GL 代码的发票上。


有两种可能但有条件的解决方案:

 

  • 如果 GL 代码是正确的,但在 xtraCHEF 中的列出方式与在 QuickBooks 中不同,您可以编辑 GL 代码。
  • 如果错误消息中显示的 GL 代码不正确,这将表明发票上列出的产品分配了错误的类别。要纠正此问题,您可以从您的项目库中更新 GL 代码。在这里了解如何:xtraCHEF:更改产品的 GL 代码或类别

"Message=AuthenticationFailed; errorCode=003200; statusCode=401"

此错误通常与 QuickBooks Online 令牌过期有关。但是,这也可能是来自 QuickBooks 的超时错误。要确认是哪种情况,请首先尝试从 提取监视器搜索发票 重新提取提取文件或特定发票。如果再次收到相同的 401 错误,您需要刷新您的 QuickBooks 令牌。为此,请按照 xtraCHEF 中的步骤操作:QuickBooks Online 集成。 


返回顶部
 

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

发票 ID 太长。QuickBooks Online 对发票 ID 的限制为 21 个字符。

 

  1. 导航到 搜索发票 并打开发票。
  2. 选择 查看详细信息
  3. 更正 发票号码 字段,使其少于 21 个字符并提交发票。
  4. 然后,您应该能够从 提取监视器搜索发票 重新提取发票。 

 

"不支持的功能"

此错误表示您的 QuickBooks 版本不支持 API 集成。自雇和简单入门的 QuickBooks Online 版本不支持与 xtraCHEF 的集成。以下是支持 API 集成的 QuickBooks Online 版本: 

 

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

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

此错误是由于您的头部级别费用分配方式造成的。xtraCHEF有四个可以根据您的偏好分配的头部级别费用: 销售税运费/分配费用折扣,和其他费用


您有3种选择来处理这些头部级别费用:在应用于发票的所有GL代码之间均匀分配,仅应用于发票上列出的最高成本的GL代码,或应用于您QuickBooks系统中的特定GL代码。


如果没有列出偏好,xtraCHEF将将其应用于默认GL:XCG-FC,XCG-OC,XCG-DC,和XCG-TAX。如果此错误出现并且您需要更改默认头部分解,请告知我们您的头部级别提取偏好,发送至support@xtrachef.com


返回顶部
 

"警告:位置账户号码未在XtraCHEF中分配。账单已推送到QuickBooks Online,但未分配任何类别。"

xtraCHEF仅具有基于位置的类别分配。按照以下步骤提取带有类别分配的发票。

 

  1. 首先,从QuickBooks Online或QuickBooks Desktop导入类别到xtraCHEF。如果您已经导入,可以忽略此步骤。
  2. 在xtraCHEF中,导航到齿轮图标 > 位置
  3. 选择编辑 位置详情
  4. 在账户号码字段中,输入类别名称。确保您输入类别名称而不是参考号码。
  5. 一旦班级被分配,您的发票将反映相关的班级名称。注意:如果启用了位置和班级跟踪,则账户号码将与您会计系统中的位置同步。


返回顶部
 

"付款 'XXXXX' 在 QuickBooks 中不存在。"

当在 xtraCHEF 中输入的付款信息与在 QuickBooks 中输入的信息不匹配时,会出现此错误消息。要解决此问题,请导航到 QuickBooks > 设置> 所有列表 > 付款方式。然后,验证在 名称 列中输入的信息是否与在 xtraCHEF 中输入的信息完全匹配。


返回顶部
 

"无效的账户类型:在继续之前,请检查您的账户详细信息。您可能需要为您的交易选择不同类型的账户。"

登录 QuickBooks 并验证 GL 账户类型和代码是否与在 xtraCHEF 中指定的匹配。如果不匹配,请相应更新。一旦进行了更改,请在 xtraCHEF 中重新提取发票,路径为 搜索发票。 


返回顶部

"QuickBooks 连接未建立。"

您必须先将 QuickBooks 连接到 xtraCHEF。阅读 xtraCHEF:开始使用 QuickBooks 在线集成xtraCHEF:开始使用 QuickBooks 桌面集成


返回顶部


"QuickBooks 错误消息:在位置 0 没有行。"

这种类型的错误表示没有为收据分配付款方式。每当在 RC(收据)文档类型下处理发票时,必须分配付款方式以将发票提取到 QuickBooks。
 

分配付款方式:

 

  1. 在xtraCHEF中选择搜索发票
  2. 输入发票号码。
  3. 然后选择搜索>查看详情>编辑发票>付款详情
  4. 付款详情选项卡中,从下拉菜单中选择正确的付款方式。
  5. 选择提交发票

 

一旦付款方式被分配,您可以重新提取所有失败的发票,以便它们在QuickBooks中反映。


返回顶部


"会计期间已关闭,无法通过服务API更新。"

由于发票日期的会计期间已关闭,此发票未被提取。 如果您需要从QuickBooks提取发票,可以将发票日期更新为当前会计期间。
 

返回顶部


"在账单中对QuickBooks AP账户"XXXX"的引用无效。QuickBooks错误消息:无效的参数。指定的记录在列表中不存在。"

当GL代码信息不匹配时,会出现此错误消息。请确保xtraCHEF和QuickBooks中列出的GL代码是相同的。
 

返回顶部


"发票未处于完成状态"

要解决此问题,您必须将发票状态从"待处理"更改为"已处理"。
 

返回顶部
 

"对象引用未设置为对象的实例"

首先,确保GL代码和类别、供应商代码以及发票状态已分配给发票。

 

  • 如果没有缺失信息,请重新提取发票。 
  • 如果在重新提取后仍然遇到相同的错误消息,请联系客户服务。


返回顶部
 

"重复发票"

此类错误表示相同的发票号码已被提取到您的QuickBooks中。检查您的会计软件,看看相同的发票号码是否已经存在。


返回顶部