快速结论:在 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 或显卡环境,这些与本问题无关。
解决步骤
- 在 ERPNext 中确认目标 DocType 的准确名称,并在 n8n 节点的 DocType 字段中逐字符核对,避免多余空格或大小写差异。
- 检查节点执行详情中的实际请求路径,确认 DocType 参数是否被编码为
Sales%20Order这类形式;若节点配置中手动填写导致空格被编码,可优先尝试改为 ERPNext 中的标准 DocType 标识。 - 用同一 ERPNext 凭据在节点中执行一次针对单个已知文档的查询,确认凭据与权限正常。
- 若上述检查均无异常但 404 依旧出现,可优先尝试升级 n8n 后复测,并关注 Linear 工单 GHC-4249 的处理进展。
验证方法
重新执行 Get many documents 节点,确认不再返回 404 与 DocType ... not found,且执行结果中能正常返回对应客户的销售订单数据。由于该 Issue 无已验证修复方案,验证结果仅供参考,不能视为官方确认。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。


