> For the complete documentation index, see [llms.txt](https://docs.docbits.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.docbits.com/chinese/gai-shu-yu-ji-chu/faq/document-processing/table-extraction-troubleshoot.md).

# 表格提取故障排查

## **步骤 1：打开 OCR 视图检查提取结果**

如果表格提取训练结果不理想：

1. 点击带有 **OCR** 字样的放大镜图标，打开 **OCR View**（OCR 视图）。
2. 查看提取结果，确认 OCR 处理能否改善数据采集。
3. 如果结果仍然不理想，请尝试使用其他文档，确认问题是否仅与当前文档有关。
4. 如果问题仅与当前文档有关，请使用另一份文档进行提取。
   * 如果问题仍然存在，请继续执行以下步骤。

## **步骤 2：检查是否有电子文本**

1. 检查文档是否包含 **电子文本**。
   * 可以使用 **Adobe Acrobat** 等工具进行确认。
   * 如果文档包含电子文本，请执行**步骤 3**。
   * 如果文档不包含电子文本，请执行**步骤 4**。

## **步骤 3：启用电子文本提取**

如果文档包含电子文本，可以通过以下两种方式启用提取：

1. **仅为此供应商启用电子文本提取**：
   * 返回 **Documents Field Validation**（文档字段验证）。
   * 点击左侧工具栏中带有三个点的方框。
   * 在此处启用 **Use E-text if available**（如果有电子文本则使用）选项，即可仅为此供应商启用该功能。
2. **为所有供应商启用电子文本提取**：
   * 前往 **设置** > **Document Processing**（文档处理）> **OCR Settings**（OCR 设置）。
   * 在此部分找到 **Use E-text if available** 选项，即可为所有供应商启用该功能。
3. 启用电子文本提取后，重新尝试**表格提取训练**。
   * 如果结果有所改善，问题即已解决。
   * 如果结果仍然不理想，请继续执行**步骤 4**。

## **步骤 4：没有电子文本时，更改 AI OCR 版本**

如果文档没有可用的电子文本：

1. 前往 **设置** > **Document Processing**（文档处理）> **OCR Settings**（OCR 设置）。
2. 将 **AI OCR Version**（AI OCR 版本）更改为其他版本。
3. 返回 **Table Extraction Training**（表格提取训练），然后重试。
4. 如果结果有所改善：
   * 检查其他供应商的文档，确保此更改没有影响这些供应商的提取结果。
   * **请谨慎操作，因为此更改可能影响其他供应商的提取结果。**
   * 此更改可能影响其他供应商，因此请彻底验证结果，确保没有对其他供应商的文档提取产生负面影响。
5. 如果更改 AI OCR 版本后结果没有改善，请**联系我们**以获取进一步帮助。

## 表格中的消息 <a href="#messages-on-the-table" id="messages-on-the-table"></a>

提取结果看起来正确，文档却仍然无法通过审批。以下是 DocBits 在线项目表格中或其下方显示的消息、触发原因及解决方法。

| 消息                                                                     | 原因                                                                                                                                                                                                                | 解决方法                                                                                                                   |
| ---------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **必填列为空**（单元格标记为红色，工具提示中显示列名）                                          | 此行中，表格列设置里标记为 *Is Required*（必填）的列没有值。                                                                                                                                                                             | 填写该单元格。如果此类文档中始终不存在该值，管理员可以在 Settings → Document Types → Table Columns（设置 → 文档类型 → 表格列）中取消勾选 *Is Required*，然后重新启动文档。   |
| **行总额与数量 × 单价不匹配（预期 …，实际 …）**                                          | DocBits 会检查每一行：`TOTAL_AMOUNT = QUANTITY × UNIT_PRICE + CHARGES`，再减去 `DISCOUNT`；或者乘以 (100 − `DISCOUNT_PERCENT`) / 100；或者减去 `DISCOUNT_PER_UNIT × QUANTITY`，具体取决于哪个折扣列已填写。差额超过 0.02 时会显示此消息。只有在数量、单价和总额均已填写时才会执行此检查。 | 将这四个值与文档进行对比。通常是某个值被读取到了错误的列中；最常见的情况是费用或折扣值被读入了错误的单元格。更正单元格后，保存时此消息会消失。                                                |
| **行总额与数量 × 单价减折扣／减百分比折扣／减单件折扣不匹配**                                     | 同一项检查，具体取决于已填写的折扣列。                                                                                                                                                                                               | 同上；请先检查折扣单元格。                                                                                                          |
| **行项目总和为 …，但净额为 …**（警告）                                                | 所有 `TOTAL_AMOUNT` 单元格的总和与页眉中的净额不一致。                                                                                                                                                                               | 检查是否缺少行、存在重复行，或页眉净额读取错误。警告不会阻止审批。                                                                                      |
| **总额不匹配：预期 …，实际 …**（页眉）                                                | 净额 + 税额（美国版式中还包括运费）与页眉总额不一致。                                                                                                                                                                                      | 这是页眉检查，不是表格问题：请更正页眉金额。                                                                                                 |
| **行项目表缺少 PO 所需的必填列（如 Item Number、Unit Price、Quantity 和 Total amount）** | PO 匹配需要这四个默认列，其中某一列被隐藏或替换为自定义列。                                                                                                                                                                                   | 管理员：在 Table Columns（表格列）中取消隐藏默认列，或在表格训练中将值映射到该列。                                                                       |
| **AI 已提取表格。是否要手动训练？**                                                  | 你为使用 AI 提取表格的供应商打开了表格训练。                                                                                                                                                                                          | 确认以进行训练；保存的规则随后会替代此供应商的 AI 表格。取消则保留 AI 表格。                                                                             |
| **AI 表格将在此处显示。请在 … 中启用**                                               | 组织已关闭 AI 表格提取。                                                                                                                                                                                                    | 管理员：Settings → Document Processing → Classification and Extraction（设置 → 文档处理 → 分类与提取）> *AI Table extraction*（AI 表格提取）。 |
| **尚无行项目**                                                              | 未提取到任何内容：此供应商没有规则，且 AI 未找到表格；或者文档中没有可读取的文本。                                                                                                                                                                       | 按照上面的步骤 1–4 操作（OCR 视图、电子文本）。然后训练一次表格，或使用 *Add new table row*（添加新表格行）手动添加行。                                             |

### AI 持续将错误的值填入某一列

实际案例：AI 将行总额写入 `CHARGES`。这样每一行都会未通过行总额检查，因为费用会加到数量 × 单价的结果上。

1. 如果该供应商已保存规则，请取消勾选该列的 *Use AI*（使用 AI）（Settings → Document Types → Table Columns），以便由规则填充该列。
2. 如果该供应商没有规则，请训练一次表格，让该列与页面上的位置绑定；如果供应商从不打印此值，也可以隐藏该列。
3. 添加一个 [AI 表格标签](/chinese/zui-zhong-yong-hu-yu-he-zuo-huo-ban/end-user-section/ai-table/ai-table-tags.md)，例如 *"该供应商的费用列为空"*；标签会按供应商保存。

### 关闭表格检查

Settings → Document Types → *your type* → More Settings → **Skip table validation**（跳过表格验证）会将该类型每份文档的表格标记为有效：系统不再报告行总额不匹配和必填列为空的问题。页眉检查（总额 = 净额 + 税额）仍会执行。此设置仅适用于表格仅供参考且不会导出到 ERP 的文档类型。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.docbits.com/chinese/gai-shu-yu-ji-chu/faq/document-processing/table-extraction-troubleshoot.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.