Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In this article

Table of Contents
maxLevel2
excludeOlder Versions|Additional Resources|Related Links|Related Information

Overview

NetSuite Create is a Write-type Snap that allows you to create records in NetSuite by defining an object. The fields that can be set on the object are provided on the input view of the Snap and can be mapped using an upstream Mapper or Structure Snap.

Prerequisites

  • A valid NetSuite account with the required permissions.

  • The composite/tree resource should be enabled for your NetSuite account credential.

Support for Ultra Pipelines  

Works in Ultra Pipelines.

Limitations

Supports only NetSuite Web Services-supported objects. For information on the supported objects, see https://www.netsuite.com/help/helpcenter/en_US/srbrowser/Browser2019_2/schema/record/account.html.

Known Issues

None.

Snap Views

View TypeView FormatNumber of ViewsExamples of Upstream and Downstream SnapsDescription
InputDocument
Min: 1
Max: 1
Mapper or Structure or a JSON Generator Snap. This Snap provides schema on its input view for the selected object that can then be used in a Mapper Snap to map the required fields.
OutputDocument
Min: 0
Max: 1
Filter or Mapper or JSON Formatter.This Snap provides the result of the create operation for each record on the output view. Errors can be routed to the error view if enabled or cause the Snap to fail during execution.

Snap Settings

Field

Field Type

Description

Label*


String

The name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your Pipeline.

Default ValueNetSuite Create
ExampleNetSuite Create

Object*


Dropdown list

The NetSuite Object type to update. For example, to search for records of a custom record type, select Custom Record from the available options.

Example: Customer





Default value: Account


Note

NetSuite's application requires the Oneworld extension for utilizing these subsidiary relationships, and Snap integration should use WSDL 2019_1 or later versions.


Custom record


String/Expression/Suggestion

Conditional. This is applicable and required only if CustomRecord is selected for an Object from the suggestible list.

Default Value: N/A
ExampleInvoice

Request timeout*



Integer

The timeout for the web service call (in seconds). 0 indicates no timeout.

Example: 0
Default value: 0

Maximum request attempts*


Integer

Specifies the maximum number of attempts to be made to receive a response. The request is terminated if the attempts do not result in a response. 

Default Value: 3

Retry request interval*



Integer

Specifies the interval (in seconds) between two successive requests. A retry happens only when the previous attempt resulted in an exception. 

Default Value: 2

Snap Execution

Dropdown list

Multiexcerpt include macro
nameExecution_Detail_Write
pageSOAP Execute

Troubleshooting

Multiexcerpt include macro
macro_uuid6d26af9d-7083-476f-ba7d-462c738a6840
nameNetsuite_Troubleshooting
templateDataeJyLjgUAARUAuQ==
pageNetSuite Async Get List
addpanelfalse

Examples


Creating an Employee Record Using the NetSuite Create Snap

The following example illustrates the usage of the Create Snap. In this example, we create an employee record. The sample Pipeline looks as shown below:  

 


Expand
titleUnderstanding the pipeline

Mapper (Data) Snap maps the employee details to the input fields of NetSuite Create Snap:

NetSuite Create Snap creates an employee record using the Employee object:

After the pipeline executes, it creates a new employee record. The following is the data preview of the NetSuite Create Snap that shows the newly added employee record details:

 



Excerpt

Creating and Updating Customer Records in NetSuite Using Custom Objects

NetSuite enables you to create custom objects, and you can use the NetSuite Create Snap to update these records. This example demonstrates how you can do so.

Download this pipeline.

Expand
titleUnderstanding the pipeline

We design the pipeline as shown above.

Mapper

The Mapper Snap retrieves the NetSuite object's schema from the NetSuite Create Snap and maps the data to be uploaded to the appropriate custom fields in the target schema.

The Mapper offers the following output:

As you can see, the Mapper has mapped custom fields in the NetSuite object schema to values that we listed in the Expression field in the Mapper Snap Settings screen, above. We now need to update a NetSuite record using these custom values.

NetSuite Create

We configure the NetSuite Create Snap as shown below. We select Job as the object that we want to update. This is the schema from which the Mapper Snap picks the custom fields that must be updated.

The NetSuite Create Snap now updates the concerned record based on the object that we selected in the NetSuite Create Settings screen above, and lists out the internal ID of the updated record.

Mapper 1

We can now check whether the record was updated. To do so, we extract the internal ID of the record that was updated from the output of the NetSuite Create Snap using a Mapper Snap:

The Mapper Snap captures the internal ID of the concerned record and makes it available to the NetSuite Get Snap.

NetSuite Get

We now use the internal ID received from the Mapper Snap to check whether the record concerned is actually updated.

We review the output of the NetSuite Get Snap and check whether the new data reflects the latest updates, and find that it does.



Download

Multiexcerpt include macro
namedownload_instructions
pageOpenAPI

Attachments
patterns*.zip, *.slp


Insert excerpt
NetSuite SOAP Snap Pack
NetSuite SOAP Snap Pack
nopaneltrue