Understanding NetSuite Payload Requirements for Partial Fulfillment of Serialized Kit Items

Integrator.io
,
1

Problem Statement

I am unable to create a partial Item Fulfillment for a Sales Order that contains Kit/Package items with Serialized Inventory.

Despite providing all required sublist details, including item-level information, serial numbers, and quantity assignments, NetSuite is not accepting the partial fulfillment request.

To help troubleshoot, I have attached all relevant screenshots, as well as dummy request payloads and sample data that replicate the issue.

The expected behavior is that NetSuite should allow fulfillment of only a subset of the kit components or quantities, but the fulfillment attempt consistently fails or rejects the partial data.

I need assistance understanding:

  • What specific data or structure NetSuite requires for such fulfillments,

  • And how to correctly prepare the payload to successfully create a partial Item Fulfillment.

{
  "orderId": "SO52",
  "purchaseOrderNumber": "2000004204",
  "shipDate": "2025-10-24T19:04:57.000Z",
  "facilityName": "W2G (L) - Memphis",
  "customerName": "ABC",
  "shippingSpeed": "Economy",
  "OrderDetails": {
    "skuQuantities": [
      {
        "lots": [
          {
            "quantity": 1,
            "serialNumbers": "B8AB2026100011680"
          }
        ],
        "carrier": null,
        "skuId": "RVR-BBA-510-B",
        "status": "SHIP_COMPLETE",
        "skuID": "RVR-BBA-510-B",
        "quantity": 1
      }
    ],
    "packages": [
      {
        "id": "22973",
        "trackingNumber": "1Z3A92R80302170304",
        "trackingUrl": "https://wwwapps.anc.com/etracking/tracking.cgi?tracknum=1Z3A92R80302170304",
        "status": "SHIPPED",
        "carrierName": "UPS",
        "height": 4,
        "width": 3,
        "length": 2,
        "weight": 3.06,
        "contents": [
          {
            "sku": "RVR-BBA-510-B",
            "quantity": 1,
            "serialNumbers": [
              "B8AB2026100011680"
            ]
          }
        ],
        "proofOfDelivery": "No",
        "carrierAccountNumber": "3A92R8",
        "serviceLevel": "UPS_GND",
        "merchantManaged": "W2G_MANAGED"
      }
    ],
    "customerOrderType": "ECOMMERCE",
    "orderId": "SO52",
    "orderDate": "2025-10-21T19:36:14.000Z",
    "purchaseOrderNumber": "2000004204",
    "shippingSpeed": "ECONOMY"
  }
}

image
image1038×874 178 KB

image
image1324×856 40.6 KB

image
image1916×1144 141 KB

2

@nuriensing you have any ideas here since you were just working on partial fulfillments?

3

The problem here is with you trying to fulfil a KIT item.

Instead, each kit component must be explicitly fulfilled, with correct subrecord inventory assignment, serial numbers, and component-level quantities.

For serialized kit components: You must fulfill at the component level, not the kit line

SO line (parent) — not fulfillable
SO line (component A) — fulfillable
SO line (component B) — fulfillable

example payload:

{
    "skuId": "RVR-BBA-510-B",
    "components": [
        {
            "item": "COMP-001",
            "quantity": 1,
            "serialNumbers": [
                "B8AB2026100011680"
            ]
        }
    ]
}
1 Like
4

Hey @Ovina_Peiris ,

The Warehouse is only sending us the Item SKU - Component Level.
We don’t know if it is a Component of an Kit / Normal Serialized Inventory Item.

If possible can you please share the Mappings here.

5

Remove all dynamic fields and replace the lines entirely.
For now, only include the required fields so you can test.
Make sure the mapping with your skuid is set as a key-value pair and that the field exists on your sales order. That should be enough.

If it still errors, share the full request and the error message.

image
image758×635 24.1 KB