NetSuiteの始め方 | SOAP: getItemAvailability

以下の記事で説明されているSOAP Web Services統合に関する手順を成功裏に完了した後： 

1. 記事「NetSuite の始め方 | SOAPおよびREST Web Servicesのセットアップの前提条件」に従ってSOAP統合を有効にする。 
2. 記事「NetSuite の始め方 | インテグレーションレコードの作成方法」と「NetSuite の始め方 | アクセストークンの作成方法：管理者向け」に従ってSOAPインテグレーションを作成する。 
3. 記事「NetSuite の始め方 | SOAP Web ServicesでTBAを使用してヘッダーを作成する方法」を参照してSOAP Web Servicesにヘッダータグを含める。 

これで、NetSuite内のレコードを取り扱う準備ができました。SOAP Webサービスで使用可能な主要な操作の1つは、getItemAvailability操作です。これにより、ユーザーは特定のアイテムの在庫利用可能状況を取得できます。この機能は、在庫水準を監視し、様々な場所での製品の可用性を理解する場合に特に役立ちます。

主要な特徴:

最終数量変更によるフィルタ: lastQtyAvailableChangeパラメータで結果をフィルタできます。これにより、指定した日付時点の数量が変更されたアイテムのみが返されます。

複数倉庫の在庫管理サポート:「複数倉庫の在庫管理」機能が有効な場合、オペレーションはすべての場所の在庫詳細を返します。使用可能なアイテムがない場所については、場所IDと名前のみがリストされます。

レコード制限: このオペレーションでは最大10,000件のレコードを返品できます。この制限を超えると、エラーがトリガーされます。

SOAPリクエスト

特定の在庫アイテムの有効数量を取得するサンプル要求を次に示します。

<soapenv:Body> 
        <getItemAvailability xsi:type='platformMsgs:GetItemAvailabilityRequest'> 
            <itemAvailabilityFilter xsi:type='platformCore:ItemAvailabilityFilter'> 
                <item xsi:type='platformCore:RecordRefList'> 
                    <recordRef xsi:type='platformCore:RecordRef' internalId='6' type='inventoryItem'></recordRef> 
                </item> 
            </itemAvailabilityFilter> 
        </getItemAvailability> 
    </soapenv:Body> 

SOAPレスポンス

リクエストが処理されると、一般的なレスポンスは次のようになります。

<soapenv:Body> 
        <getItemAvailabilityResponse 
            xmlns=""> 
            <platformCore:getItemAvailabilityResult 
                xmlns:platformCore="urn:core_2021_1.platform.webservices.netsuite.com"> 
                <platformCore:status isSuccess="true"/> 
                <platformCore:itemAvailabilityList> 
                    <platformCore:itemAvailability> 
                        <platformCore:item internalId="6" type="inventoryItem"> 
                            <platformCore:name>Carrot Perms</platformCore:name> 
                        </platformCore:item> 
                        <platformCore:lastQtyAvailableChange>2024-01-04T08:57:40.000-08:00</platformCore:lastQtyAvailableChange> 
                        <platformCore:locationId internalId="2" type="location"> 
                            <platformCore:name>New York</platformCore:name> 
                        </platformCore:locationId> 
                        <platformCore:quantityOnHand>23.0</platformCore:quantityOnHand> 
                        <platformCore:onHandValueMli>920.0</platformCore:onHandValueMli> 
                        <platformCore:quantityOnOrder>5.0</platformCore:quantityOnOrder> 
                        <platformCore:quantityCommitted>1.0</platformCore:quantityCommitted> 
                        <platformCore:quantityAvailable>22.0</platformCore:quantityAvailable> 
                    </platformCore:itemAvailability> 
</platformCore:itemAvailabilityList> 
</platformCore:getItemAvailabilityResult> 
        </getItemAvailabilityResponse> 
    </soapenv:Body>