NetSuite REST API跨子公司发货报错及实现咨询

调用NetSuite的Item Fulfillment REST API时出现以下错误：

Error while accessing a resource. You must have at least one valid line item for this transaction.

需求是使用另一子公司的可用库存完成销售订单发货，该操作在NetSuite UI中可以实现，但调用REST API时失败。

请求使用的JSON如下：

{
    "item": {
        "items": [
            {
                "orderLine": 1,
                "quantity": 1,
                "itemReceive": true,
                "location": {
                    "id": "239"
                },
                "inventoryDetail": {
                    "inventoryassignment": {
                        "items": [
                            {
                                "issueInventoryNumber": {
                                    "refName": "1D3B62A4000070"
                                },
                                "quantity": 1.0
                            }
                        ]
                    },
                    "quantity": 1.0,
                    "totalResults": 1
                },
                "shipGroup" : 1,
                "subsidiary": {
                    "id": "1"
                }
            }
        ]
    },
    "subsidiary": {
        "id": "1"
    },
    "location": {
        "id": "239"
    }
}

背景信息：仓库ID239归属子公司1，目标销售订单归属子公司3。

请问是否可通过NetSuite REST API实现跨子公司发货？若可以，请求中缺少什么配置？

可以通过NetSuite REST API实现跨子公司发货，你的请求存在字段错误和关键配置缺失，导致API无法识别有效行项目，具体修正点如下：

1. 添加createdFrom字段（核心缺失）
   Item Fulfillment必须关联对应的销售订单，请求中必须包含createdFrom字段并指定目标销售订单的ID，否则API无法关联到订单行，这是触发“无有效行项目”错误的主要原因。

2. 修正itemReceive字段值
   该字段用于采购收货场景，发货操作（Item Fulfillment）需将其设为false，当前设为true属于场景误用。

3. 调整子公司配置

   • 顶层subsidiary应设置为销售订单归属的子公司（ID:3），而非仓库所在的子公司1；
   • 行项目内无需单独指定subsidiary字段，仓库ID239已关联子公司1，NetSuite会自动识别跨子公司出库逻辑。

4. 移除冗余字段
   请求中的totalResults是API响应返回的字段，无需在请求中提交，应删除。

修正后的请求JSON示例 #

{
    "createdFrom": {
        "id": "目标销售订单的ID"
    },
    "item": {
        "items": [
            {
                "orderLine": 1,
                "quantity": 1,
                "itemReceive": false,
                "location": {
                    "id": "239"
                },
                "inventoryDetail": {
                    "inventoryassignment": {
                        "items": [
                            {
                                "issueInventoryNumber": {
                                    "refName": "1D3B62A4000070"
                                },
                                "quantity": 1.0
                            }
                        ]
                    },
                    "quantity": 1.0
                },
                "shipGroup": 1
            }
        ]
    },
    "subsidiary": {
        "id": "3"
    },
    "location": {
        "id": "239"
    },
    "tranDate": "2024-05-20"
}

额外注意事项 #

• 确保API授权的角色拥有跨子公司操作权限，同时具备销售订单所在子公司的发货权限、仓库所在子公司的库存出库权限；
• 确认仓库239中对应序列号/批号的库存处于可用状态；
• 若启用了高级库存管理，需确保跨子公司出库的配置在NetSuite系统中已启用（UI中能操作则该配置已生效）。

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