MENU
    Интеграция с NetSuite
    • 23 Jan 2025
    • 4 Минуты для чтения
    • Авторы

    Интеграция с NetSuite


    Вводный текст

    В этой статье объясняется, как интегрировать ваш экземпляр Netsuite в Tulip с помощью предварительно созданных RESTlet-функций Tulip.

    Цель

    Цель модульного теста Netsuite Bundle - позволить пользователям проверить успешное соединение между Tulip и их платформой Netsuite, а также изучить общие производственные функции, предоставляемые предварительно созданным RESTlet-бандлом Tulip.

    Настройка

    Для этой интеграции вам понадобятся:

    • Разрешения в вашем экземпляре Netsuite для создания и развертывания сценария
    • Права в экземпляре Netsuite для создания пользователя интеграции
    • экземпляр Tulip с установленным коннектором Netsuite и приложением Netsuite Unit Test.

    Netsuite и Tulip поддерживают аутентификацию на основе токенов (обычно называемую TBA, построенную на базе спецификации OAuth1.0, а также аутентификацию OAuth2.0. Вы можете выбрать аутентификацию с помощью TBA, поскольку этот метод аутентификации обеспечивает долгоживущий токен, который можно использовать для аутентификации в Netsuite. Вариант аутентификации OAuth2.0 предоставляет обновляемый токен, который действует в течение 7 дней, и после истечения срока действия регенерация токенов должна происходить внутри Tulip, иначе ваши попытки подключиться к Netsuite будут неудачными с ошибкой INVALID_GRANT. Ниже описаны оба варианта аутентификации.

    Шаг 1 - Установите, создайте и запустите сценарий интеграционного пакета Tulip

    Чтобы использовать предварительно созданный Netsuite RESTlet Tulip, вам нужно загрузить сценарий интеграции Tulip Bundle, создать и развернуть его в вашем экземпляре Netsuite.

    Чтобы импортировать скрипт в ваш экземпляр Netsuite, создайте новый скрипт, перейдя в меню

    Персонализация -> Скрипты -> Новый

    Нажмите на "+" рядом с полем вводаimage.png{height="" width=""}.

    Заполните необходимые поля, используя файл, загруженный выше. Убедитесь, что имя файла включает расширение .js, иначе скрипт не будет работать!image.png

    Сохраните и нажмите "Создать запись скрипта", затем назовите скрипт и сохраните.

    image.png

    Разверните сценарий, затем измените статус на "Освобожден", выберите все роли и всех сотрудников и сохраните.

    image.png

    Шаг 2A - Вариант аутентификации на основе токенов Netsuite

    Следующие шаги предполагают, что у вас есть понимание того, как настроить аутентификацию на основе токенов в Netsuite, о чем вы можете прочитать здесь.

    Во-первых, найдите загруженный Tulip Netsuite Bundle Connector в вашем экземпляре Tulip, чтобы обновить коннектор с данными вашей среды Netsuite.

    image.png

    Чтобы настроить коннектор Tulip на использование Netsuite TBA, выберите OAuth 1.0 в качестве метода аутентификации для HTTP-коннектора.

    image.png

    • Для метода подписи выберите HMAC-SHA256.
    • Для версии убедитесь, что установлено значение 1.0.
    • Для ключа потребителя введите ключ потребителя, предоставленный пользователем интеграции, которого вы настроили в Netsuite.
    • Для секрета потребителя введите секрет потребителя, предоставленный Пользователем интеграции, которого вы настраиваете в Netsuite.
    • Для маркера доступа введите идентификатор маркера доступа, который вы настроили в Netsuite. Обратите внимание, что этот токен доступа должен быть назначен пользователю интеграции, которого вы настроили ранее.
    • Для секретного токена введите секретный токен токена доступа, который вы настроили в Netsuite. Обратите внимание, что этот токен доступа должен быть назначен пользователю интеграции, которого вы настроили ранее.
    • Для realm введите поддомен вашего экземпляра Netsuite в верхнем регистре (например, если для входа в Netsuite используется tstdrv123456.app.netsuite.com, ваш realm/subdomain будет TSTDRV123456). Если в поддомене вашего экземпляра Netsuite есть символ дефиса, вам нужно ввести его как символ подчеркивания (например, sb1-123456 будет введен как SB1_123456).

    После настройки нажмите кнопку Test в конфигурации коннектора и нажмите Save, если тест пройден. Теперь вы готовы интегрировать RESTlets с помощью метода TBA от Netsuite.

    Шаг 2B - Вариант аутентификации Netsuite OAuth2.0

    Сначала найдите загруженный Tulip Netsuite Bundle Connector в вашем экземпляре Tulip, чтобы обновить коннектор с данными вашей среды Netsuite.

    image.png

    На странице коннекторов для коннектора 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 разрешен код авторизации Grant, указаны область применения RESTLET, URI перенаправления, характерный для вашего сайта (скопированный в шаге 1), и установлен флажок Public Client.

    tulip-netsuite-oauth2.0-integration

    После нажатия кнопки Сохранить вам будут представлены идентификатор клиента и секрет для вашей интеграции в разделе, подобном показанному ниже

    Скопируйте и вставьте эти значения в соответствующие разделы модального окна Tulip Connector.

    На этом этапе все доступные поля в модале Tulip Connectors должны быть заполнены. Нажмите кнопку Тест, чтобы запустить процесс авторизации, а затем войдите в систему с учетными данными NetSuite.

    После успешного завершения нажмите Назад в модале Tulip Connectors, чтобы вернуться к экрану сведений о подключении, а затем нажмите Сохранить, чтобы сохранить эту авторизацию. Теперь вы готовы интегрировать RESTlets с помощью метода OAuth2.0 от Netsuite.

    Шаг 3 - Обновление сценария и развертывание идентификатора функций коннектора

    Сценарий Tulip Integration Bundle должен быть установлен и развернут на данном этапе. Netsuite RESTlets требуют уникальный идентификатор сценария и идентификатор развертывания как часть вызова функции. Дополнительную информацию об идентификаторах скриптов можно найти здесь.

    Чтобы найти уникальные идентификаторы в вашем экземпляре Netsuite, перейдите к скриптам, перейдя в раздел:

    Персонализация -> Сценарии -> Сценарии

    Найдите сценарий Tulip Integration Bundle Script и нажмите кнопку View. Перед вами откроется окно, подобное показанному ниже.

    image.png

    Перейдите на вкладку Deployments и выберите Tulip Integration Bundle Link в разделе Title. Внутренний идентификатор сценария (734 в данном случае) и идентификатор развертывания (1) показаны на изображении ниже как часть URL. Запишите эти идентификаторы и перейдите обратно к коннектору Tulip Netsuite Bundle Connector.

    image.png

    Откройте любую из функций в коннекторе и обновите сценарий и параметры запроса развертывания (выделены ниже) в соответствии с конкретными идентификаторами, которые были определены выше. Обратите внимание, что ВСЕ функции в коннекторе должны быть обновлены с вашими уникальными идентификаторами сценария и развертывания. image.png

    Теперь вы готовы к использованию Netsuite Bundle и Unit Test Application!

    Как это работает

    Приложение, функция коннектора и сценарий Tulip Integration Bundle вместе предлагают способ двунаправленной передачи основных производственных функций между Tulip и Netsuite. Приложение Unit Test демонстрирует каждый из вызовов функций, предоставляемых предварительно созданным RESTлетом Tulip.

    Для получения подробной информации о каждом соединении и их работе обратитесь к статье " Приложения и коннекторы Netsuite " в приложении "Библиотека".


    Была ли эта статья полезной?