Pré-requisitos do conector NetSuite para o Jitterbit Integration Studio

Introdução

Certos pré-requisitos devem ser atendidos para usar o conector NetSuite, conforme detalhado abaixo.

Pré-requisitos

Para configurar e usar um endpoint NetSuite, os seguintes pré-requisitos devem ser atendidos:

• É recomendada uma versão do agente 11.30 ou posterior.

  Nota

  Existem problemas ao usar o objeto CustomRecord em uma atividade de Pesquisa do NetSuite com versões anteriores do agente. Veja detalhes adicionais nas notas de versão 11.26 e 11.30.

• A autenticação baseada em token (TBA) deve estar habilitada na conta NetSuite usando a função de permissões apropriada para permitir o acesso do Harmony à instância do NetSuite. Instruções para habilitar o TBA estão disponíveis em Habilitar TBA no NetSuite.

• Um registro de integração do NetSuite deve ser criado para o Jitterbit. O Jitterbit fornece um pacote para criar o registro de integração. Para instalar o pacote, siga os passos descritos na documentação do NetSuite. Pesquise o pacote usando o nome Jitterbit BFN Integrations - CRM ou o ID 454951.

• O Jitterbit verificou suporte para até a versão 2025.2 do WSDL do NetSuite. O NetSuite suporta as seis versões mais recentes de seu WSDL a qualquer momento. Portanto, recomendamos que a instância do NetSuite utilize uma dessas versões do WSDL:

  • 2025.2
  • 2025.1
  • 2024.2
  • 2024.1
  • 2023.2
  • 2023.1

  A Jitterbit verificou suporte anterior para versões mais antigas de WSDL que não são mais suportadas pelo NetSuite. As versões legadas de WSDL estão listadas na documentação oficial do NetSuite. Embora essas versões permaneçam tecnicamente disponíveis, o uso de qualquer WSDL com mais de um ano é uma prática desencorajada, e recomendamos fortemente que você atualize para uma versão de WSDL suportada.

  Nota

  Ao atualizar o WSDL na conexão do NetSuite, observe que simplesmente alterar a URL fará com que todas as operações que utilizam as atividades do conector falhem em tempo de execução, uma vez que as transformações ainda usam o WSDL antigo. Para atualizar corretamente, siga os passos descritos em Alterar a versão do WSDL.

• A URL do WSDL deve ser fornecida no formato de uma URL de WSDL específica da conta. Instruções para obter a URL do WSDL estão disponíveis em Usar uma URL de WSDL específica da conta do NetSuite.

• As versões de WSDL do NetSuite de 2021.2 a 2025.2 requerem agentes de nuvem ou privados Harmony versão 10.33 ou posterior.
• O WSDL do NetSuite 2020.2 e 2021.1 requer agentes de nuvem ou privados Harmony versão 10.26 ou posterior.
• O WSDL do NetSuite 2020.1 requer agentes de nuvem ou privados Harmony versão 10.18 ou posterior.
• Os WSDLs do NetSuite 2019.1 e 2019.2 requerem agentes de nuvem ou privados Harmony versão 10.4 ou posterior.
• Os WSDLs do NetSuite até 2018.2 requerem agentes de nuvem ou privados Harmony versão 9.9 ou posterior.

Opcional: Limitar os campos do esquema de resposta a colunas de pesquisa salva

Para limitar os campos do esquema de resposta da atividade de pesquisa do NetSuite às colunas de uma pesquisa salva, é necessário um script Suitelet para obter metadados. Um script Suitelet válido está disponível para download na página de Downloads do Harmony, listado sob Conectores.

/**
 * @author Jitterbit
 * @version 1.0.0.0
 * @NApiVersion 2.x
 * @NScriptType Suitelet
 * This Suitelet loads a saved search by its internal ID and returns the search columns.
 */

O script Suitelet deve ser carregado e implantado para que sua URL de execução seja acessível ao conector:

1. No portal do NetSuite, navegue até Personalização > Scripting > Scripts > Novo para abrir a página Carregar Arquivo de Script:

   

2. Passe o mouse sobre o dropdown Arquivo de script e clique no ícone novo + para abrir a caixa de diálogo Arquivo:

   

   Especifique as seguintes informações:

   

   1. Anexar de: Selecione Computador se não estiver selecionado por padrão.
   2. Pasta: Selecione SuiteScripts se não estiver selecionado por padrão.
   3. Selecionar arquivo: Selecione o script Suitelet obtido na página de Downloads do Harmony, listado sob Conectores.
   4. Clique em Salvar para retornar à página Carregar Arquivo de Script.

3. Selecione o script recém-carregado, clique em Criar Registro de Script e clique em Suitelet se solicitado para abrir a página Script. Especifique as seguintes informações:

   

   1. Insira um nome para o registro no campo Nome. Embora a interface marque Tipos de Plug-In Personalizados como obrigatório, isso pode ser ignorado.
   2. Navegue até a aba Implantações do registro. Insira um título no campo Título e defina o campo Status como Liberado.
   3. Clique em Adicionar e clique em Salvar.

4. Clique em Implantar Script para abrir a página Implantação de Script. Especifique as seguintes informações:

   

   1. Selecione quaisquer funções internas necessárias para acesso à pesquisa salva em Público > Funções internas.
   2. Defina o campo Status como Liberado.
   3. Clique em Salvar.

5. Clique com o botão direito e copie a URL agora visível na página de Implantação do Script:

   

Para completar a URL de execução que você usará com uma atividade de pesquisa do NetSuite, anexe &searchid={{YourSavedSearchId}} à URL copiada. {{YourSavedSearchId}} é o ID da pesquisa salva que você deseja limitar os campos do esquema de resposta.

Por exemplo, uma URL de execução válida se parece com https://account123.app.netsuite.com/app/site/hosting/scriptlet.nl?script=123&deploy=2&searchid=456789 ao usar uma pesquisa salva com um ID de 456789 em uma instância hospedada em https://account123.app.netsuite.com.