SOAP Operation – getItemAvailability

The getItemAvailability operation can be used to retrieve the inventory availability for a specific list of items.

You can filter the returned list using a lastQtyAvailableChange filter. If set, only items with quantity available changes recorded as of this date are returned.

If the Multi-Location Inventory feature is enabled, this operation returns results for all locations. For locations that do not have any items available, only location IDs and names are listed in results.

This operation supports up to 10,000 records. If this limit is exceeded, an error is returned.

Request

<soapenv:Envelope
    xmlns:xsd='http://www.w3.org/2001/XMLSchema'
    xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
    xmlns:soapenv='http://schemas.xmlsoap.org/soap/envelope/'
    xmlns:platformCore='urn:core_2021_2.platform.webservices.netsuite.com'
    xmlns:listRel='urn:relationships_2021_2.lists.webservices.netsuite.com'
    xmlns:listAcct='urn:accounting_2021_2.lists.webservices.netsuite.com'
    xmlns:platformMsgs='urn:messages_2021_2.platform.webservices.netsuite.com'>
    <soapenv:Header>
        <tokenPassport xsi:type='platformCore:TokenPassport'>
            <account xsi:type='xsd:string'>{{accountId}}</account>
            <consumerKey xsi:type='xsd:string'>{{consumerKey}}</consumerKey>
            <token xsi:type='xsd:string'>{{tokenId}}</token>
            <nonce xsi:type='xsd:string'>{{nonce}}</nonce>
            <timestamp xsi:type='xsd:long'>{{timestamp}}</timestamp>
            <signature algorithm='HMAC_SHA256' xsi:type='platformCore:TokenPassportSignature'>{{signature}}</signature>
        </tokenPassport>
    </soapenv:Header>
    <soapenv:Body>
        <getItemAvailability xsi:type='platformMsgs:GetItemAvailabilityRequest'>
            <itemAvailabilityFilter xsi:type='platformCore:ItemAvailabilityFilter'>
                <item xsi:type='platformCore:RecordRefList'>
                    <recordRef xsi:type='platformCore:RecordRef' internalId='36' type='inventoryItem'></recordRef>
                </item>
            </itemAvailabilityFilter>
        </getItemAvailability>
    </soapenv:Body>
</soapenv:Envelope>

Response

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <soapenv:Header>
        <platformMsgs:documentInfo
            xmlns:platformMsgs="urn:messages_2021_2.platform.webservices.netsuite.com">
            <platformMsgs:nsId>WEBSERVICES_TSTDRV2782962_08062023829995058196952332_2f0b954</platformMsgs:nsId>
        </platformMsgs:documentInfo>
    </soapenv:Header>
    <soapenv:Body>
        <getItemAvailabilityResponse
            xmlns="">
            <platformCore:getItemAvailabilityResult
                xmlns:platformCore="urn:core_2021_2.platform.webservices.netsuite.com">
                <platformCore:status isSuccess="true"/>
                <platformCore:itemAvailabilityList>
                    <platformCore:itemAvailability>
                        <platformCore:item internalId="36" type="inventoryItem">
                            <platformCore:name>JJ Test Item 1</platformCore:name>
                        </platformCore:item>
                        <platformCore:locationId internalId="1" type="location">
                            <platformCore:name>MidWest</platformCore:name>
                        </platformCore:locationId>
                        <platformCore:reorderPoint>50.0</platformCore:reorderPoint>
                        <platformCore:preferredStockLevel>100.0</platformCore:preferredStockLevel>
                        <platformCore:quantityAvailable>0.0</platformCore:quantityAvailable>
                    </platformCore:itemAvailability>
                </platformCore:itemAvailabilityList>
            </platformCore:getItemAvailabilityResult>
        </getItemAvailabilityResponse>
    </soapenv:Body>
</soapenv:Envelope>