与 NetSuite 集成

本文介绍如何使用 Tulip 预建的捆绑 RESTlet 功能将 Netsuite 实例集成到 Tulip。

测试目的

Netsuite 捆绑单元测试的目的是让用户验证 Tulip 和 Netsuite 平台之间的成功连接，同时能够探索 Tulip 预建RESTlet捆绑提供的通用制造功能。

设置

对于此集成，您需要

• 在 Netsuite 实例中创建和部署脚本的权限
• 在 Netsuite 实例中创建集成用户的权限
• 安装了 Netsuite 连接器和 Netsuite 单元测试应用程序的 Tulip 实例

Netsuite 和 Tulip 都支持基于令牌的身份验证（通常称为 TBA，建立在 OAuth1.0 和 OAuth2.0 身份验证规范之上）。您可以选择使用 TBA 进行身份验证，因为这种身份验证方法提供了一个长期有效的令牌，可用于对 Netsuite 进行身份验证。OAuth2.0 身份验证选项提供一个有效期为 7 天的刷新令牌，一旦过期，必须在 Tulip 内重新生成令牌，否则尝试连接 Netsuite 时将出现 INVALID_GRANT 错误。以下步骤概述了这两种身份验证选项。

步骤 1 - 安装、创建和部署 Tulip 集成捆绑脚本

要使用 Tulip 预构建的 Netsuite RESTlet，您需要下载Tulip Bundle 集成脚本，并在 Netsuite 实例中创建和部署该脚本。

要在 Netsuite 实例中导入脚本，请导航至

自定义 -> 脚本 -> 新建

单击输入字段{height="" width="" } 旁边的 "+"号

使用上面下载的文件填写必填字段。确保文件名包含 .js 扩展名，否则脚本将无法运行！

保存后按 "创建脚本记录"，然后命名脚本并保存。

{height="" width="""}

部署脚本，然后将状态更改为已发布，选择所有角色和所有员工并保存

{height="" width="""}

步骤 2A - Netsuite 基于令牌的身份验证选项

以下步骤假定您已了解如何在 Netsuite 中配置基于令牌的身份验证，您可以在此处阅读更多相关信息。

首先，在你的 Tulip 实例中找到下载的 Tulip Netsuite 捆绑连接器，用你的 Netsuite 环境细节更新连接器。

要配置 Tulip 连接器以使用 Netsuite TBA，请选择 OAuth 1.0 作为 HTTP 连接器的验证方法。

{height="" width="""}

• 签名方法请选择 HMAC-SHA256
• 对于版本，确保设置为 1.0
• 对于消费者密钥，请输入您在 Netsuite 中设置的集成用户提供的消费者密钥
• 对于消费者密文，输入您在网石中设置的集成用户提供的消费者密文
• 对于访问令牌， 输入您在 Netsuite 中设置的访问令牌的令牌 ID。请注意，此访问令牌必须分配给之前设置的集成用户。
• 对于令牌秘密，请输入您在 Netsuite 中设置的访问令牌的令牌秘密。请注意，此访问令牌需要分配给您之前设置的集成用户。
• 对于域，请输入大写的 Netsuite 实例子域（例如，如果使用 tstdrv123456.app.netsuite.com 登录 Netsuite，您的域/子域将是 TSTDRV123456）。如果 Netsuite 实例子域中有连字符，则需要输入下划线符号（例如，sb1-123456 将输入为 SB1_123456）

设置完成后，按下连接器配置中的测试按钮，如果测试通过，点击保存。现在就可以使用 Netsuite 的 TBA 方法集成 RESTlet 了。

步骤 2B - Netsuite OAuth2.0 身份验证选项

首先，在你的 Tulip 实例中找到下载的 Tulip Netsuite 捆绑连接器，用你的 Netsuite 环境细节更新连接器。

在 NetSuite连接器的 "连接器"页面上，点击 "环境设置 "打开连接信息模式。

然后在出现的模式上选择 "编辑标头"。

最后，选择**OAuth 2 (Admin)**验证。

提供以下值：

授权码 URL

https://<YOUR_SITE_ID>.app.netsuite.com/app/login/oauth2/authorize.nl

访问令牌 URL

https://<YOUR_SITE_ID>.suitetalk.api.netsuite.com/services/rest/auth/oauth2/v1/token

范围

重定向子节点

最后，复制您网站的重定向 url 值（如上图所示，https://prodgroup.tulip.co/oauth-redirect-handler），并将其记录下来，以便在稍后的指南中使用。现在我们进入 NetSuite 添加集成记录，请不要关闭此窗口。

首先在 NetSuite 中创建一个新的集成记录，方法如下

设置 > 集成 > 管理集成 > 新建

您将看到如下所示的屏幕。确保 OAuth 2.0 部分允许授权码授予、RESTLET 范围、特定于您网站的重定向 URI（在步骤 1 中复制），并启用公共客户端复选框。

单击 "**保存 "**后，您将在类似下图所示的部分看到集成的客户端 ID 和密文

将这些值复制并粘贴到 Tulip Connector Modal 的相应部分。

此时，Tulip 连接器模块中的所有可用字段都应填写完毕。单击 "**测试 "**启动授权流程，然后使用 NetSuite 凭据登录。

成功完成后，单击 Tulip Connectors 模式窗中的 "返回"，返回连接详细信息屏幕，然后按 "保存 "保存此验证。现在，您已准备好使用 Netsuite 的 OAuth2.0 方法集成 RESTlet。

第 3 步 - 更新脚本并部署连接器功能 ID

此时应安装和部署 Tulip Integration Bundle 脚本。Netsuite RESTlet 需要唯一的脚本 ID 和部署 ID 作为函数调用的一部分。有关脚本 id 的更多信息，请点击此处。

要在 Netsuite 实例中找到唯一标识符，请转到脚本：

自定义 -> 脚本 -> 脚本

找到 "郁金香集成捆绑脚本 "并单击 "查看"。您将看到类似下图所示的屏幕。

{height="" width="""}

单击 "部署 "选项卡，然后在 "标题 "下选择 "郁金香集成捆绑链接"。内部脚本 id（本例中为 734）和部署 id（1）作为 URL 的一部分显示在下图中。记下这些 id 并导航回 Tulip Netsuite 捆绑连接器。

{height="" width="""}

打开捆绑包内的任何函数，更新脚本并将查询参数（如下所示）部署到上面确定的特定 ID。请注意，连接器中的所有函数都需要用您唯一的脚本和部署 ID 进行更新。{height="" width="""}

现在，您已准备好使用 Netsuite 捆绑程序和单元测试应用程序！

如何运行

应用程序、连接器功能和 Tulip 集成捆绑包脚本共同提供了一种在 Tulip 和 Netsuite 之间双向通信基本制造功能的方法。单元测试应用程序演示了 Tulip 预建 RESTlet 提供的每个功能调用。

有关每个连接的具体细节及其操作方法，请参阅库应用程序以及Netsuite 应用程序和连接器文章。