NetSuite REST API销售订单部分发货(Item Fulfillment)报错求助

问题场景 #

尝试通过NetSuite REST API将指定销售订单部分发货，调用POST /services/rest/record/v1/salesorder/{{SALES_ORDER_ID}}/!transform/itemFulfillment接口，无论只提交要发货的行（设置itemreceive: true）还是全量提交所有行（均设itemreceive: false），均返回400错误：

{
    "type": "https://www.rfc-editor.org/rfc/rfc9110.html#section-15.5.1",
    "title": "Bad Request",
    "status": 400,
    "o:errorDetails": [
        {
            "detail": "Error while accessing a resource. You must have at least one valid line item for this transaction.",
            "o:errorCode": "USER_ERROR"
        }
    ]
}

系统已启用**高级发货（Advanced Shipping）**功能。

错误原因分析 #

1. 无效的行项目配置：第二个请求中把所有行的itemreceive设为false，没有任何行被标记为需要发货，必然触发"无有效行项目"错误；第一个请求可能存在语法或字段配置问题（比如JSON格式错误、行号/位置无效、字段名称不匹配）。
2. 高级发货的字段要求：启用高级发货后，部分字段的校验逻辑会变化，比如库存位置匹配、发货状态字段的正确性。

解决方案 #

1. 修正请求体格式与内容 #

确保请求体JSON格式正确，且仅包含需要发货的行项目，设置正确的字段值：

{
  "item": {
    "items": [
      {
        "orderLine": 2,
        "location": 3,
        "quantity": 1,
        "itemreceive": true
      }
    ]
  }
}

需注意：

• orderLine必须是销售订单中存在的有效行号（NetSuite行号从1开始，若存在子行需确认实际行号）；
• location需与该销售订单行的库存位置匹配，且该位置有足够可用库存；
• quantity不能超过该订单行的未发货数量；
• 确保请求体没有语法错误（比如缺失大括号、逗号等）。

2. 适配高级发货功能的配置 #

启用高级发货后，无需额外特殊接口，但需确认以下业务规则：

• 销售订单需允许部分发货：检查销售订单的Allow Partial Fulfillment设置是否开启；
• 若使用多发货组（Ship Group），需确保行项目的发货组配置正确，必要时在请求体中指定shipGroup字段；
• 确认API角色拥有创建Item Fulfillment的权限，以及对应库存位置、销售订单的访问权限。

3. 额外排查步骤 #

• 先在NetSuite UI中手动尝试创建该销售订单的部分发货，确认业务规则上无阻碍（比如商品是否可发货、是否有未完成审批）；
• 通过NetSuite Record Browser查看Item Fulfillment的字段定义，确认itemreceive等字段在transform场景下的正确性（部分场景下可能需使用isFulfilled字段）；
• 检查请求头部的Content-Type是否为application/json，确保请求格式被正确识别。

内容的提问来源于stack exchange，提问作者Jordan van Zyl