Artisan IMG > NetSuite SOAP (netsuite-soap) (917247fd-0fa6-4f4c-b085-3ccbdc273c4d)
Artisan IMG > NetSuite SOAP (netsuite-soap) (917247fd-0fa6-4f4c-b085-3ccbdc273c4d)

NetSuite SOAP
1.0

NetSuite SOAP enables companies to manage all key business processes within a single online system.

Overview
Copy

Companies use NetSuite for enterprise resource planning (ERP) and to manage inventory, track their financials, host e-commerce stores and maintain customer relationship management (CRM) systems. This flexible platform can be applied to a range of business applications.

PLEASE NOTE: Make sure before continuing that you are using the correct NetSuite API. We have a separate page for the NetSuite REST connector as there are several differences and they cannot be used interchangeably.

Authentication
Copy

Prerequisites
Copy

To use NetSuite SOAP web services the relevant SOAP Web Services must be enabled within your NetSuite account.

Additionally the SOAP web services user must have the required permissions assigned to said user’s role.

If you already have your features and permission setup then please move straight to Stage 3: Creation.

Stage 1: Enable Features
Copy

This accordion guides you through the process of enabling token authentication and SuiteAnalytics for NetSuite REST API authentication integration with Tray.io.

Stage 2: Enable Permissions
Copy

This accordion guides you through the process of setting the permissions required for the respective features enabled in the previous section.

Stage 3: Creation
Copy

This section begins and ends in the Tray.io builder so please have your workflow space set up before continuing.

Available Operations
Copy

The examples below show one or two of the available connector operations in use.

Please see the Full Operations Reference at the end of this page for details on all available operations for this connector.

Notes on key operations
Copy

Search records
Copy

Sometimes you may wish to only select certain fields to be returned. This is especially true if you are intent on performing a "join" in order to reduce the amount of data coming through your workflow.

With an "advanced search records" setup, you can define all the fields you want NetSuite to return as well as a criteria for said records in order to filter the results down further.

Please see the walkthrough below for a demonstration on how you could potentially set up the Tray.io properties panel, in order to use with the Contact endpoint (when using the Search records operation).

Add Record (& Custom records)
Copy

This section essentially walks you through how to reference a custom record in NetSuite.

Users need to be aware that custom records are non-standard entities in NetSuite. You need to adhere to NetSuite's non-standard entity rules when using the Add record operation.

Please see the walkthrough below for a demonstration on how you could potentially set up the Tray.io properties panel, in order to use with the Contact endpoint (when using the Add record operation).


Further Info (REST & SOAP)
Copy

The following sections are mainly relevant to SOAP users however there is some cross over for our REST customers.

Reverting XML Schema
Copy

Despite the fact that the NetSuite APIs (REST and SOAP) primarily deals in XML Tray.io has taken steps to standardise our NetSuite connectors so that they work using JSON instead.

However in order for NetSuite to process requests correctly, the input still requires a translation back to XML.

Therefore we have implemented a way to transform JSON back into XML. However this still requires the JSON object to be in a specific format in order to talk to NetSuite.

Check out the simple demo below for formatting details and example input / output schemas.

SuitTalk Guides
Copy

SuiteTalk platform help
Copy

For information on how SuiteTalk works login into your NetSuite account and head to the Help Centre -> SuiteCloud -> SuiteTalk section.

Here you can then select the following options:

  • SuiteTalk (Web Services) Platform Guide: Explains how the SuiteTalk API works and what each request requires.

  • Web Services Operations: Relevant operation

  • SuiteTalk (Web Services) Records Guide: Explains how the data is represented, constructed, and related.

SuiteTalk WSDL and Schema definitions
Copy

SuiteTalk operation / request cross-reference
Copy

BEST PRACTICES: Whenever you do decide to create your own workflow, be sure to check out some of our key articles such as:

Appendix I: Namespace to Alias Mappings
Copy

Appendix II: Further Documentation
Copy