Skip to main content

SuiteTalk Updates in NetSuite 2022.1

2022.1 SuiteTalk |

This release note was updated March 9, 2022.

  • Fully Supported Record Types for REST Web Services in 2022.1
  • Asynchronous Request Execution Is Generally Available
  • SOAP Web Services
    • SOAP Web Services Version 2022.1
    • Araxis Merge Diff File for the 2022.1 Endpoint
    • 2022.1 SOAP Schema Browser Fully Supported Record Types for REST Web Services in 2022.1 The following table lists the record types that are fully supported as of 2022.1.

Record Type Notes

Assembly Item An assembly item is an inventory item made up of several components but identified as a single item. Assemblies are manufactured by combining raw materials that you stock. The record ID for the assembly item REST record is assemblyItem. Credit Memo A credit memo is used to refund or credit a customer account. The record ID for the credit memo record is creditmemo.

Time Bill (Track A time transaction, also known as TimeBill, records the hours worked by an employee. This

Time) transaction is available when the Time Tracking feature is enabled. The record ID for the time bill REST record is timebill.

Record Type Notes

Vendor A vendor is a company or person you purchase goods and services from. Vendor records track

information about your vendors and enable you to view past transactions and communications with them. The record ID for the vendor REST record is vendor. Vendor Bill Vendor bills are records which you can use to track payables as they arrive from vendors. The record ID for the vendor bill REST record is vendorBill. For a list of every fully supported record, see the help topic REST Web Services Supported Records.

Except for fully supported records, all records listed in the REST API Browser are available as beta records

in REST web services if the REST Record Service (Beta) feature is enabled. For more information about working with the browser, see the help topic The REST API Browser.

Asynchronous Request Execution Is Generally Available

Besides synchronous execution, you can also execute requests asynchronously in REST web services. Asynchronous request execution is now generally available. The asynchronous execution of requests is useful for long-running requests. With asynchronous requests, when you send a request to REST web services, it is placed in a processing queue and handled asynchronously with other requests. Asynchronous execution involves an idempotent retry mechanism, which enables you to use unique keys for asynchronous request. Using unique keys helps you to avoid duplicate requests. For more information, see the help topic REST Web Services Request Processing.

SOAP Web Services Version 2022.1

SOAP web services version 2022.1 is available. When your implementation is upgraded to 2022.1, the 2022.1 WSDL becomes available in your production account. You do not need to upgrade your WSDL when the new version is generally available. NetSuite supports each endpoint for three years. For information about the supported generally available versions, see the help topic Support for Existing WSDL Versions.

Araxis Merge Diff File for the 2022.1 Endpoint

The Araxis Merge diff file highlights the schema changes between the 2021.2 and 2022.1 endpoints.

  • About the Araxis Merge Diff File
  • Using the Araxis Merge Diff File

About the Araxis Merge Diff File

NetSuite publishes an Araxis Merge diff file for every new endpoint. Depending on the scope of the release, changes described in the Araxis Merge diff file may include:

  • New record types
  • Elements (fields) that have been added, removed, or changed
  • New sublists (lists)
  • New joins
  • New search filters and search return columns
  • New platform operations Using the Araxis Merge Diff File Important: The screenshots in this section are for illustrative purposes only. They do not reflect changes related to any specific endpoint. The Araxis Merge diff file is generated using Araxis Merge. When you click the Araxis Merge diff file link (when it is available), a page appears that offers an overview of all schema changes. The following screenshot shows how this summary page looks. In this example, the highlighted rows indicate that an XSD has been modified. The integers at the center indicate the number of changed lines in the file. To see the exact differences, click the report link in the column on the right or click the name of the file in either column. When you click any of these links, the Araxis Merge diff file shows a page with two columns. The previous version of the file is displayed on the left and the new version is displayed on the right. Changed elements are highlighted. For example, the following screenshot shows an excerpt from the report on platform.commonTypes.xsd. Notice the addition of two values to the PermissionCode enumeration: _accessPaymentAuditLog and _advancedPDFHTMLTemplates. The Araxis Merge diff file also shows changes to data types. The following screenshot is a snapshot of transactions.sales.xsd. Notice that the chargeType element changed from an enumeration to a RecordRef. 2022.1 SOAP Schema Browser The 2022.1 version of the SOAP Schema Browser is now available. You can find links to the SOAP Schema

Browser in several places, including the following:

  • The help topic titled SOAP Schema Browser.
  • The reference page for each supported record in the SOAP Web Services Records Guide. The SuiteTalk SOAP Web Services Records Guide is available in the NetSuite Help Center and can be downloaded as a PDF from the User Guides topic.