Skip to content

Latest commit

 

History

History
136 lines (87 loc) · 4.62 KB

authentication-+-configuration.md

File metadata and controls

136 lines (87 loc) · 4.62 KB
description
Configuration of a Netsuite Datasource

Authentication + Configuration

NetSuite supports a number of types of authentication. The auth method supported in SharpSync is OAuth 2. The configuration values in SharpSync are shown below.

Authentication

  • In SharpSync, navigate to Data Sources
  • Select the NetSuite Data Source > Add
  • Set the Server Url
https://[customerId].app.netsuite.com
  • Click Update
  • Click the Ping button to test the connection. This is optional and will not work if ICMP is disabled on the server
  • Click the 'Configure' button
  • You can now configure Authentication & Configuration

{% tabs %} {% tab title="Authentication" %} Base API path

This is the full link [including your customer id] to the NetSuite Instance. Typically something like:

https://[customerId].suitetalk.api.netsuite.com

Authentication Types

The type of authentication method to use when authenticating with NetSuite. We only support:

OAuth 2.0

OAuth Url

The URL where authentication initially happens:

https://[customerId].app.netsuite.com/app/login/oauth2/authorize.nl

OAuth Token Url

The URL where tokens are created / renewed. Typically something like:

https://[customerId].suitetalk.api.netsuite.com/services/rest/auth/oauth2/v1/token

OAuth Client Client Id

The OAuth Client Id registered for the SharpSync application. Usually generated by the integration record created:

{some long string of text}

OAuth Client Secret

The OAuth Client secret registered for the SharpSync application. Usually generated the first time the integration record is created:

{some long string of text}

OAuth Scopes

Think of this as the permissions needed by your OAuth application to send and receive data. The restlets scope is optional but highly recommended. Without it you will not be able to upload thumbnails. You should set this to:

rest_webservices,restlets

{% endtab %}

{% tab title="Configuration" %} Default item type to use when creating BOM item

When creating a new item, if the item cannot be reliably determined from SharpSync, this is the fallback type to be used (this is currently superseded by the values in the itemType property mapping), example:

inventoryitem

Item types to load properties for

When loading accessors (NetSuite Fields) and property mappings, these are the item types searched for:

{% code overflow="wrap" %}

assemblyitem|inventoryitem|noninventoryresaleitem|noninventorysaleitem|noninventorypurchaseitem|bom|bomRevision|manufacturingRouting

{% endcode %}

Servlet URL

The url of the servlet where thumbnails will be uploaded. Optional but recommended. If specified, include the folderId param at the end.**

{% code overflow="wrap" %}

https://{companyId}.restlets.api.netsuite.com/app/site/hosting/restlet.nl?script=2943&deploy=1&folderId={folderId}

{% endcode %}

Use server side scripting for items

Use the server to update custom fields for items which are not surfaced in the NetSuite api. (Only set if the defaults don't provide enough functionality)

Use advanced BOMs

Check to use the advanced BOMs module in NetSuite

Bom Naming Scheme

The scheme used to generate BOM names

Bom Revision Naming Scheme

The scheme used to generate BOM revision names {% endtab %} {% endtabs %}

**Servlet URL configuration

  • Enter the URL of the restlet, followed by &folderId= and the id of the folder in the first steps
  • Remember to update the scriptor deployid if the script or deployment status is updated
  • Enter the folder ID into the UI in the form

{{netsuite-api}}/app/site/hosting/restlet.nl?script={yourScriptId}&deploy=1&folderId={folderId}

e.g.

{{netsuite-api}}/app/site/hosting/restlet.nl?script=2743&deploy=1&folderId=19578359