NetSuite中SOAP Web服务创建重复单据号销售订单无告警问题排查

问题根源 #

NetSuite UI端的重复单据号校验逻辑和SOAP Web服务端的校验并不完全一致，你现有的配置只对UI操作生效，Web服务端需要额外设置才能触发拦截。

解决办法 #

• 检查SOAP请求的ignoreWarning参数：在调用add或upsert接口时，必须把ignoreWarning设为false。如果这个参数是true，系统会直接忽略所有警告（包括重复单据号的提示），强行创建订单。
• 开启Web服务专属的重复检测：
  1. 登录NetSuite后台，进入Setup > Integration > Web Services Preferences
  2. 找到并勾选Enable Duplicate Detection for Web Services选项
  3. 保存配置
• 确认集成偏好的生效范围：你勾选的Treat Warnings and Errors，要确保对应的SOAP服务所用的角色被正确关联，而且该角色没有被授予Override Duplicate Document Number权限——这个权限会允许跳过重复校验，必须禁用。
• 排查自定义脚本/工作流：如果系统里有针对销售订单的自定义脚本或工作流，检查其中是否存在绕过重复单据号校验的逻辑，比如强制覆盖tranId或忽略校验错误。

验证方法 #

配置完成后，重新发送带重复tranId的SOAP请求，系统应该返回错误信息，明确提示单据号重复并阻止订单创建。如果还是不行，再核对一遍Web服务角色的权限设置，确保没有遗漏的权限导致校验失效。

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