如何通过SuiteScript将销售订单转换为带库存明细的发货单？

核心思路 #

要替换硬编码的issueinventorynumber（批次/序列号ID）、binnumber（货位ID）和quantity，需针对销售订单的每一行商品，查询对应库存位置下的可用库存明细，再根据发货需求分配库存。

具体实现步骤 #

1. 提取销售订单行信息：加载原销售订单，获取每行商品的ID、发货位置、待发货数量。
2. 查询可用库存明细：通过nlapiSearchRecord检索inventorynumber记录，过滤出目标商品在指定位置的可用库存，返回批次/序列号ID、货位ID、可用数量。
3. 动态分配库存：根据待发货数量，按规则（如FIFO）从库存明细中分配，生成对应的inventoryassignment子记录行。

修改后的完整代码示例 #

// 替换为实际销售订单ID
var salesOrderId = 12345;
// 转换销售订单为发货单
var fulfillmentRec = nlapiTransformRecord('salesorder', salesOrderId, 'itemfulfillment');

// 遍历所有商品行
var lineTotal = fulfillmentRec.getLineItemCount('item');
for (var lineIdx = 1; lineIdx <= lineTotal; lineIdx++) {
    fulfillmentRec.selectLineItem('item', lineIdx);
    
    var itemId = fulfillmentRec.getCurrentLineItemValue('item', 'item');
    var locationId = fulfillmentRec.getCurrentLineItemValue('item', 'location');
    var needFulfillQty = parseFloat(fulfillmentRec.getCurrentLineItemValue('item', 'quantity'));
    var remainingQty = needFulfillQty;

    // 构建库存查询条件
    var searchFilters = [
        new nlobjSearchFilter('item', null, 'is', itemId),
        new nlobjSearchFilter('location', null, 'is', locationId),
        new nlobjSearchFilter('quantityavailable', null, 'greaterthan', 0)
    ];
    var searchColumns = [
        new nlobjSearchColumn('internalid', null, 'GROUP'), // 对应issueinventorynumber
        new nlobjSearchColumn('binnumber', null, 'GROUP'),
        new nlobjSearchColumn('quantityavailable', null, 'SUM')
    ];
    var inventoryList = nlapiSearchRecord('inventorynumber', null, searchFilters, searchColumns);

    if (inventoryList && inventoryList.length > 0) {
        // 创建库存明细子记录
        var inventoryDetail = fulfillmentRec.createCurrentLineItemSubrecord('item', 'inventorydetail');
        
        // 循环分配库存直到满足发货量
        for (var invIdx = 0; invIdx < inventoryList.length && remainingQty > 0; invIdx++) {
            var invItem = inventoryList[invIdx];
            var invNumberId = invItem.getValue('internalid', null, 'GROUP');
            var binId = invItem.getValue('binnumber', null, 'GROUP');
            var availableQty = parseFloat(invItem.getValue('quantityavailable', null, 'SUM'));
            
            // 取可用量与剩余发货量的较小值作为本次分配量
            var assignQty = Math.min(availableQty, remainingQty);
            
            inventoryDetail.selectNewLineItem('inventoryassignment');
            inventoryDetail.setCurrentLineItemValue('inventoryassignment', 'issueinventorynumber', invNumberId);
            inventoryDetail.setCurrentLineItemValue('inventoryassignment', 'binnumber', binId);
            inventoryDetail.setCurrentLineItemValue('inventoryassignment', 'quantity', assignQty);
            inventoryDetail.commitLineItem('inventoryassignment');
            
            remainingQty -= assignQty;
        }
        
        inventoryDetail.commit();
    }
    
    fulfillmentRec.commitLineItem('item');
}

// 提交发货单
var fulfillmentId = nlapiSubmitRecord(fulfillmentRec);

关键说明 #

• 库存查询准确性：通过inventorynumber搜索确保只获取未被占用的可用库存，避免分配已锁定的库存。
• 多批次适配：如果单批次库存不足以覆盖发货量，自动创建多个库存分配行，直到满足需求。
• 字段对应关系：inventorynumber的internalid就是issueinventorynumber，binnumber直接返回货位ID，quantityavailable为当前可用库存数量。

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