NetSuite SOAP创建含Group Items的销售订单时End Of Group匹配错误问题

错误根因 #

USER_ERROR 下的 End Of Group without matching Group item at line 报错本质是SOAP请求中销售订单行的组项目层级结构不符合NetSuite的校验规则，和自定义脚本、配置的关联度较低，绝大多数是请求体的行属性设置错误导致。

必查校验点 #

• 确认组项目行的item类型是否正确：传入的Group Item必须是系统中类型为Item Group的物料，不能是套件（Kit/Package）或者其他类型物料，NetSuite对不同组合类物料的行结构校验逻辑完全不同。
• 检查每一组的行顺序和isGroup、isEndGroup属性设置：
  • 组起始行：isGroup必须设为true，isEndGroup设为false，该行仅填Group Item本身，不要填金额、数量等子项属性
  • 组内所有子项行（包括你要新增的非预设额外子项）：isGroup和isEndGroup都设为false，所有子项必须紧跟在对应组起始行之后，不能插入其他不属于该组的独立行
  • 组结束行：isEndGroup必须设为true，isGroup设为false，该行的item必须和组起始行的Group Item为同一个物料，不能单独传“End Of Group Item”类型的虚拟物料
• 组内新增非预设额外子项无需修改系统配置，只要把额外子项放在组起始行和组结束行之间即可，额外子项的行属性和普通组子项完全一致。
• 检查是否存在组嵌套：NetSuite SOAP API默认不支持Item Group的嵌套结构，如果请求里出现组的子项又是另一个Group Item，就会触发层级校验错误。

最简请求示例参考 #

可以对照修改请求体的行部分：

<!-- 组起始行 -->
<SalesOrderItem>
  <item internalId="123"/> <!-- 替换为你的Group Item内部ID -->
  <isGroup>true</isGroup>
  <isEndGroup>false</isEndGroup>
</SalesOrderItem>
<!-- 预设子项1 -->
<SalesOrderItem>
  <item internalId="456"/>
  <quantity>1</quantity>
  <isGroup>false</isGroup>
  <isEndGroup>false</isEndGroup>
</SalesOrderItem>
<!-- 额外新增的非预设子项 -->
<SalesOrderItem>
  <item internalId="789"/>
  <quantity>2</quantity>
  <isGroup>false</isGroup>
  <isEndGroup>false</isEndGroup>
</SalesOrderItem>
<!-- 组结束行 -->
<SalesOrderItem>
  <item internalId="123"/> <!-- 和组起始行的Group Item ID完全一致 -->
  <isGroup>false</isGroup>
  <isEndGroup>true</isEndGroup>
</SalesOrderItem>

配置/脚本排查方案 #

如果修改请求结构后仍然报错，按以下顺序排查：

• 关闭当前销售订单关联的所有用户事件脚本、工作流，重新发起请求，判断是否是自定义逻辑修改了行结构导致校验失败
• 检查你使用的角色是否有Item Group的完整权限，以及对应子项物料的销售权限
• 查看设置 > 会计 > 会计首选项 > 项目/任务下的组项目相关配置，确认没有勾选“强制组项目仅使用预设子项”的限制规则

内容的提问来源于stack exchange，提问作者user1275628