NetSuite の始め方 | SOAP Web Services: 追加操作

以下の記事で説明されている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 Servicesで利用可能な主要な操作の1つが「追加」操作です。この操作は、NetSuiteシステム内に新しいレコードやエンティティを作成するために使用されます。 

NetSuiteのSOAP Web Servicesで「追加」操作を実行すると、サポートされているレコードタイプの1つに新しいデータエントリを作成します。これは、新しい顧客、ベンダー、注文書、購入注文、アイテムレコード、またはNetSuiteがサポートする他のエンティティのいずれかである可能性があります。「追加」操作に必要な特定の詳細とパラメータは、作成するレコードの種類によって異なります。 

以下は顧客レコードを追加するためのサンプルSOAPリクエストです： 

<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_1.platform.webservices.netsuite.com' 
    xmlns:listRel='urn:relationships_2021_1.lists.webservices.netsuite.com' 
    xmlns:platformCommon='urn:common_2021_1.platform.webservices.netsuite.com' 
    xmlns:platformMsgs='urn:messages_2021_1.platform.webservices.netsuite.com'> 
    <soapenv:Header> 
        <tokenPassport xsi:type='platformCore:TokenPassport'> 
            <account xsi:type='xsd:string'>**</account> 
            <consumerKey xsi:type='xsd:string'>**</consumerKey> 
            <token xsi:type='xsd:string'>**</token> 
            <nonce xsi:type='xsd:string'>**</nonce> 
            <timestamp xsi:type='xsd:long'>**</timestamp> 
            <signature algorithm='HMAC_SHA256' xsi:type='platformCore:TokenPassportSignature'>**</signature> 
        </tokenPassport> 
    </soapenv:Header> 
    <soapenv:Body> 
        <add xsi:type='platformMsgs:AddRequest'> 
            <record xsi:type='listRel:Customer'> 
                <companyName xsi:type='xsd:string'>N2N Employee</companyName> 
                <email xsi:type='xsd:string'>N2NEmployee@nsc.com</email> 
                <altPhone xsi:type='xsd:string'>123456789</altPhone> 
                <addressbookList replaceAll='true' xsi:type='listRel:CustomerAddressbookList'> 
                    <addressbook xsi:type='listRel:CustomerAddressbook'> 
                        <defaultShipping xsi:type='xsd:boolean'>true</defaultShipping> 
                        <addressbookAddress xsi:type='platformCommon:Address'> 
                            <country xsi:type='xsd:string'>_philippines</country> 
                            <addressee xsi:type='xsd:string'/> 
                            <addr1 xsi:type='xsd:string'>San Pablo City</addr1> 
                            <state xsi:type='xsd:string'>Laguna</state> 
                            <zip xsi:type='xsd:string'>4000</zip> 
                        </addressbookAddress> 
                    </addressbook> 
                </addressbookList> 
            </record> 
        </add> 
    </soapenv:Body> 
</soapenv:Envelope>