NetSuite の始め方 | SOAP Webサービス: getBudgetExchangeRate操作

以下の記事で説明されている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つは、getBudgetExchangeRate操作です。この操作では、ルート親子会社と子子会社間の為替レートの維持に役立つ「予算為替レート」表が提供されます。これらのレートは、NetSuite OneWorldアカウント内の正確な財務計画と予算策定に不可欠です。

NetSuite OneWorldでは、子会社が異なる通貨で動作するため、複数のエンティティ間で財務データを調整するために予算為替レートが必要です。SOAP WebサービスのgetBudgetExchangeRate操作を使用すると、ユーザーはこの表に関連するデータを取得およびフィルタできます。ただし、この表はSOAP Webサービスでは読取り専用であることに注意することが重要です。

SOAPリクエスト

    <soapenv:Body>
        <getBudgetExchangeRate xsi:type='platformMsgs:GetBudgetExchangeRateRequest'>
            <budgetExchangeRateFilter xsi:type='platformCore:BudgetExchangeRateFilter'>
                <period xsi:type='platformCore:RecordRef' internalId='3'></period>
                <fromSubsidiary xsi:type='platformCore:RecordRef' internalId='109'></fromSubsidiary>
                <toSubsidiary xsi:type='platformCore:RecordRef' internalId='94'></toSubsidiary>
            </budgetExchangeRateFilter>
        </getBudgetExchangeRate>
    </soapenv:Body>

SOAPリクエストの内訳

本文(<soapenv:Body>)

• <platformCore:getBudgetExchangeRate>という主な操作が含まれます。
• これは予算換算レートを取得する要求です。

予算為替レート・フィルタ(<platformCore:budgetExchangeRateFilter>)

• この項では、次のものに基づいて正しい為替レートを取得するためのフィルタを適用します。
  • 予算期間(<platformCore:period> internalId="XXX")→ 予算期間(期間の内部ID)を指定します。
  • 元子会社(<platformCore:fromSubsidiary> internalId="YYY")→ 親子会社を指定します。
  • 取引先子会社(<platformCore:toSubsidiary> internalId="ZZZ")→ 子子会社を指定します。

重要: 提供されているサンプルコードは、「現状のまま」提供されており、法の最大限の範囲で、いかなる保証もありません。Oracle + NetSuite Inc.は、開発者が自身の開発プラットフォームでサンプルコードを実装する際の成功を保証しません。また、サンプルコードの使用、結果の使用、データまたは情報の正確性、適時性、または完全性に関して、いかなる保証も行いません。