排查税务引擎问题 （GTE）

税务引擎（也称为 GTE）是一种高度可配置的引擎，用于处理Microsoft Dynamics 365 中的税收适用性、计算、发布和结算。 本文列出了用户在使用税务引擎时通常遇到的问题，并说明了如何解决这些问题。

注意

税务引擎功能仅适用于在印度拥有主要地址的法律实体。

有关税务引擎的快速概述，请参阅税务引擎概述（YouTube 视频）。

调试模式

熟悉税务引擎的调试模式有助于确定与税务引擎相关的问题的根本原因。

若要打开调试模式，请将 &debug=vs%2CconfirmExit& 添加到 Microsoft Dynamics 365 Finance 的 URL 末尾。

启用调试模式后，打开税务文档时，系统会生成包含运行时详细信息的转储文件。

转储文件的结构如下所示。 仅当“检查模型映射差异”选项设置为“是”时，数据模型映射不匹配部分才可用。

======Tax engine calculation parameter======
...
===========Taxable document JSON===========
...
=====Tax engine runtime posting profiles=====
...
========Data model mapping mismatch========
Unmatched data provider fields
...
Unmatched taxable document fields
...

=====Tax engine runtime posting profiles=====
Header - TaxDocLine: TableId=6791 RecId=68719507754:
Line - TaxDocLine: TableId=13307 RecId=68719685245:
Path of the tax component 1:
-"Posting profile 1 description(Hit)"
-"Posting profile 2 description"
...
Path of the tax component 2:
-"Posting profile 1 description(Hit)"
-"Posting profile 2 description"
...
Line - TaxDocLine: TableId=13307 RecId=68719685245:
...

可能的问题

GST 的不均衡凭证

通过添加或修改发布配置文件来扩展 GST 配置后，可能会出现此问题。

在当前设计中，每个税务组件都有一组发布配置文件来处理所有可能的纳税申报。 在运行时，税务引擎会选取第一个匹配的发布配置文件。

有时，如果在不仔细处理每个配置文件的情况下添加或修改发布配置文件，则可能会在运行时选取意外的发布配置文件。

启用调试模式后，可以在转储文件的“税务引擎运行时发布配置文件”部分找到所选的发布配置文件。

税率或税务组件不正确

为了正常工作，税务引擎依赖于应纳税文档（如销售和购买发票）的输入。 如果通过添加新字段来扩展配置，字段可能未正确映射，或者写入数据提供程序可能不正确。 若要识别问题，请将 “检查模型映射差异 ”选项设置为 “是”。 可以查看另一部分以显示差异。

税务组件不正确

如果未看到预期的税务组件，则交易无法满足 税务组件或税务类型的适用性 规则。 如果扩展了配置，请验证是否存在差异，然后将转储文件的“可纳税文档 JSON”部分中的字段值与税务组件的适用性规则进行比较。

税率不正确

如果未看到预期的税率，请检查税务设置中使用的字段值，并将其与转储文件的“可纳税文档 JSON”部分中的字段值进行比较。

无法使用 GST 发布凭证

可能会收到类似于以下消息的错误消息：

在设置层次结构 ## 版本 ## 中找不到 ## ，请检查并重试。

通常，发生此错误的原因是通过添加新的税务组件或修改信用池来扩展配置。

若要解决此问题，请按照以下步骤操作。

1. 将较新版本添加到当前销售税层次结构，选择“同步”，然后激活新版本。
2. 在“维护设置层次结构配置文件”页上，按照设置销售税层次结构中的步骤使新版本可用。