erpnext node get all issue

在 n8n 的 ERPNext 节点执行 getAll (Get many documents)时,如果请求的 DocType 在 ERPNext 端无法识别,接口会返回 404 与 DocType ... not found 。优先排查节点里选择的 DocType 名称与 ERPNext 中实际存

快速结论:在 n8n 的 ERPNext 节点执行 getAll(Get many documents)时,如果请求的 DocType 在 ERPNext 端无法识别,接口会返回 404 与 DocType ... not found。优先排查节点里选择的 DocType 名称与 ERPNext 中实际存在的 DocType 是否完全一致。

适用环境:n8n 1.109.2(Self Hosted),节点类型 n8n-nodes-base.erpNext(nodeVersion 1),资源为 document、操作为 getAll;Issue 未提供 ERPNext 版本、操作系统及部署方式。

最快修复方案:暂无确认的一步修复方案。Issue 仅被归入 Linear 工单(GHC-4249),讨论链中没有提交验证过的处理方式。

注意事项:报错中的 DocType 被编码为 Sales%20Order,说明请求路径里出现了经过 URL 编码的空格。这可能是 DocType 名称拼写/格式问题,也可能与 n8n 节点构造请求路径的方式有关;讨论链未确认根因,不要据此直接修改 ERPNext 端数据。

问题场景

用户在 n8n 中使用 ERPNext 节点,对某个客户(“test customer”)执行 Get many documents(getAll)操作,期望取回该客户的销售订单。用户确认该客户在 ERPNext 中已存在销售订单,但节点执行时直接失败并返回 404。

报错原文

The resource you are requesting could not be found

404 - {"exc_type":"DoesNotExistError","_server_messages":"[\\"{\\\\\\\"message\\\\\\\": \\\\\\\"DocType Sales%20Order not found\\\\\\\", ...}\\"}","httpCode":"404"}

nodeName: Get many documents
nodeType: n8n-nodes-base.erpNext
resource: document
operation: getAll

原因分析

核心报错是 ERPNext 端返回的 DocType Sales%20Order not found,即 ERPNext 认为所请求的 DocType 不存在。可能原因包括:

  • 请求中携带的 DocType 名称格式不正确(例如带空格且被编码为 %20),与 ERPNext 实际的 DocType 标识不匹配;
  • 节点配置中选择的 DocType 与 ERPNext 站点中实际启用的 DocType 不一致;
  • n8n ERPNext 节点在构造 getAll 请求路径时对该 DocType 参数处理不当,导致服务端无法解析。

以上均为基于报错文本的推测,Issue 讨论链未给出官方根因结论。

环境排查

  • n8n 版本是否为 1.109.2 或相近版本(Self Hosted)。
  • ERPNext 节点中实际选择的 DocType 值,以及它在 ERPNext 站点中的准确名称。
  • 所用 ERPNext 账号对该 DocType 的读取权限。
  • 同一条 ERPNext 凭据在节点中执行其他操作(如单个文档查询)是否正常,用于区分是凭据问题还是 DocType 解析问题。
  • Issue 未提供 Python、CUDA、PyTorch 或显卡环境,这些与本问题无关。

解决步骤

  1. 在 ERPNext 中确认目标 DocType 的准确名称,并在 n8n 节点的 DocType 字段中逐字符核对,避免多余空格或大小写差异。
  2. 检查节点执行详情中的实际请求路径,确认 DocType 参数是否被编码为 Sales%20Order 这类形式;若节点配置中手动填写导致空格被编码,可优先尝试改为 ERPNext 中的标准 DocType 标识。
  3. 用同一 ERPNext 凭据在节点中执行一次针对单个已知文档的查询,确认凭据与权限正常。
  4. 若上述检查均无异常但 404 依旧出现,可优先尝试升级 n8n 后复测,并关注 Linear 工单 GHC-4249 的处理进展。

验证方法

重新执行 Get many documents 节点,确认不再返回 404 与 DocType ... not found,且执行结果中能正常返回对应客户的销售订单数据。由于该 Issue 无已验证修复方案,验证结果仅供参考,不能视为官方确认。

参考来源

n8n-io/n8n #19271

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 35203

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注