Authenticate with NetSuite 2016 ERP

You can authenticate with NetSuite 2016 ERP to create your own instance of the NetSuite 2016 ERP element through the UI or through APIs. Once authenticated, you can use the element instance to access the different functionality offered by the NetSuite 2016 ERP platform.

Authenticate Through the UI

Use the UI to authenticate with NetSuite 2016 ERP and create an element instance. NetSuite 2016 ERP authentication uses either Custom (Netsuite's Token-Based) or Basic authentication, and you'll need to sign in to NetSuite 2016 ERP as part of the process. See the setup page for more details on how to obtain the authentication information you'll need.

If you are configuring events, see the Events section.

To authenticate an element instance:

1. Sign in to Cloud Elements, and then search for NetSuite 2016 ERP in our Elements Catalog.
2. Hover over the element card, and then click Authenticate.
3. Enter a name for the element instance.
4. Choose if you are connecting to a NetSuite sandbox.
5. Enter the Account ID that you identified in the API Provider Setup section.
6. Select the Authentication Type for the element instance. Choose Basic or Custom, based on the type of authentication you are using.

7. Complete the fields required for your selected authentication type:

   Basic	Custom
   Email	Consumer Key
   User Password	Consumer Secret
   App ID	Access Token ID
   	Access Token Secret

8. Click Show Optional Fields.

9. Choose whether to enforce single sessions:

   • Select true to you ensure that Cloud Elements does not send multiple requests to your NetSuite 2016 ERP at one time. This may be necessary for certain trial NetSuite accounts.
   • Select false to allow multiple requests. You must also provide a Single Session Lock Key which can be any alphanumeric value that is unique within the Cloud Elements environment.

10. Optionally type or select one or more Element Instance Tags to add to the authenticated element instance.

11. Click Create Instance.

12. Provide your NetSuite 2016 ERP credentials, and then allow the connection.

After successfully authenticating, we give you several options for next steps. Make requests using the API docs associated with the instance, map the instance to a virtual resource, or use it in a formula template.

Authenticate Through the API

Authenticating through API is similar to authenticating via the UI. Instead of clicking and typing through a series of buttons, text boxes, and menus, you will instead send API calls to our /instances endpoint. The end result is the same, though: an authenticated element instance with a token and id for future API calls.

If you are configuring events, see the Events section.

To create an element instance:

1. Construct a JSON body based on your authentication type, either Basic or Custom. See Parameters for detailed descriptions.

   Basic Authentication

   {
     "element": {
       "key": "netsuiteerpv2"
     },
     "configuration": {
       "netsuite.sandbox": false,
       "netsuite.accountId": "my_account_id",
       "netsuite.single.session": true,
       "netsuite.single.session.key": "my_unique_key",
       "authentication.type": "Basic",
       "user.username": "my@somewhere.com",
       "user.password": "my_secret_password",
       "netsuite.appId": "my_app_id",
       "event.notification.enabled": false
     },
     "tags": [
       "<Add_Your_Tag>"
     ],
     "name": "<INSTANCE_NAME>"
   }
   

   Custom Authentication

    {
      "element": {
        "key": "netsuiteerpv2"
      },
      "configuration": {
         "netsuite.sandbox": false,
         "netsuite.accountId": "my_account_id",
         "netsuite.single.session": true,
         "netsuite.single.session.key": "my_unique_key",
         "authentication.type": "custom",
         "consumer_key": "consumer_key_1234567",
         "consumer_secret": "secret_1234567",
         "token_id": "token_1234",
         "token_secret": "token_secret_1234",
         "filter.response.nulls": true,
         "event.notification.enabled": false
      },
      "tags": [
        "<Add_Your_Tag>"
      ],
      "name": "<INSTANCE_NAME>"
    }
   

2. Call the following, including the JSON body you constructed in the previous step:

   POST /instances
   

   Note: Make sure that you include your User and Organization keys in the header. See the Overview for details.

3. Locate the token and id in the response and save them for all future requests using the element instance.

Example cURL

Basic Authentication

curl -X POST \
  https://api.cloud-elements.com/elements/api-v2/instances \
  -H 'authorization: User <USER_SECRET>, Organization <ORGANIZATION_SECRET>' \
  -H 'content-type: application/json' \
  -d '{
  "element": {
    "key": "netsuiteerpv2"
  },
  "configuration": {
    "netsuite.sandbox": false,
    "netsuite.accountId": "my_account_id",
    "netsuite.single.session": true,
    "netsuite.single.session.key": "my_unique_key",
    "authentication.type": "Basic",
    "user.username": "my@somewhere.com",
    "user.password": "my_secret_password",
    "netsuite.appId": "my_app_id",
    "event.notification.enabled": false
  },
  "tags": [
    "Accounting"
  ],
  "name": "NetSuite Instance 1"
}'

Custom Authentication

curl -X POST \
  https://api.cloud-elements.com/elements/api-v2/instances \
  -H 'authorization: User <USER_SECRET>, Organization <ORGANIZATION_SECRET>' \
  -H 'content-type: application/json' \
  -d '{
  "element": {
    "key": "netsuiteerpv2"
  },
  "configuration": {
    "netsuite.sandbox": false,
    "netsuite.accountId": "my_account_id",
    "netsuite.single.session": true,
    "netsuite.single.session.key": "my_unique_key",
    "authentication.type": "custom",
    "consumer_key": "consumer_key_1234567",
    "consumer_secret": "secret_1234567",
    "token_id": "token_1234",
    "token_secret": "token_secret_1234",
    "filter.response.nulls": true,
    "event.notification.enabled": false
  },
  "tags": [
    "Accounting"
  ],
  "name": "NetSuite Instance 1"
}'

Parameters

See setting up the NetSuite service for information on how to obtain authentication parameters.

Example Response

In this example, the authenticated element instance ID is 12345 and token starts with ABC/D.... Your values will be different. Make sure that you save the id and token for future requests.

{
    "id": 12345,
    "name": "NetSuite Instance 1",
    "token": "ABC/D/efgHIJK1234lmnopQRS+1tuVWx+yz98765",
    "element": {
        "id": 988,
        "name": "NetSuite Instance 1",
        "key": "netsuiteerpv2",
        "description": "NetSuite 2016 ERP.",
        "active": true,
        "deleted": false,
        "typeOauth": true,
        "trialAccount": false,
        "configDescription": "NetSuite 2016 ERP",
        "signupURL": ""
    },
    "provisionInteractions": [],
    "valid": true,
    "eventsEnabled": true,
    "disabled": false,
    "maxCacheSize": 0,
    "cacheTimeToLive": 0,
    "cachingEnabled": false
}