Endpoint do conector NetSuite no Jitterbit Design Studio

Introdução

Antes de criar operações do NetSuite no Jitterbit usando o Conector NetSuite, é necessário configurar pelo menos um endpoint do NetSuite.

Cada endpoint representa a URL e as credenciais de login para uma conta específica do NetSuite. Criar o endpoint permite que o Jitterbit acesse a conta para realizar as operações solicitadas. Se sua organização usar várias contas do NetSuite, será necessário criar um endpoint para cada conta.

Outras maneiras de conectar-se ao NetSuite usando o Jitterbit Studio incluem chamar um RESTlet, usar um método de serviço da web ou usar o driver JDBC do Oracle NetSuite:

• Chamar um RESTlet de uma fonte de arquivo local
• Chamar um RESTlet de uma fonte ou destino HTTP
• Usar um método de serviço da web
• Usar o driver JDBC do Oracle NetSuite com uma fonte ou destino de banco de dados

Pré-requisitos

Para usar com sucesso o Conector NetSuite do Jitterbit para integrações com o NetSuite, os seguintes critérios devem ser atendidos:

• 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 use uma dessas versões do WSDL:

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

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

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

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

• Para usar a autenticação baseada em token (TBA):

  • É necessário estar usando a versão SuiteTalk 2015.2 ou posterior.

  • É necessário ter a TBA habilitada para sua conta do NetSuite.

  • Para configurar um novo endpoint TBA, é necessário estar usando as versões Jitterbit Design Studio e Agent 9.2 ou posterior.

  • Para converter um endpoint SSO existente para usar TBA, é necessário estar usando a versão Jitterbit Design Studio 9.3.1 ou posterior e as versões Agent 9.2 ou posterior.

• NetSuite – Integração SuiteTalk (Serviços Web)
• NetSuite – Gerenciando Usuários e Funções
• NetSuite – Introdução à Autenticação Baseada em Token

Criar um endpoint

Dentro do seu projeto no Jitterbit Studio, existem várias maneiras de iniciar um novo endpoint do NetSuite:

• Vá para Arquivo > Novo > Conectores > Novo Endpoint NetSuite.
• Na árvore à esquerda, sob Conectores, clique com o botão direito na categoria NetSuite e selecione Novo Endpoint NetSuite.
• Na árvore à esquerda, sob Conectores, clique duas vezes na categoria NetSuite, depois clique com o botão direito em Novo Endpoint NetSuite e selecione Novo Endpoint NetSuite.
• Na barra de ferramentas superior, clique no ícone do conector (peça de quebra-cabeça laranja) . Na janela pop-up, selecione NetSuite e, em seguida, selecione Endpoint NetSuite.

Selecionar tipo de autenticação

Na primeira tela do assistente de endpoint NetSuite, escolha como você gostaria que o Jitterbit se autenticase com sua instância NetSuite usando as credenciais fornecidas na próxima tela. Cada opção é explicada abaixo.

• SSO: SSO (Single Sign-on) é o método tradicional usado pelo Jitterbit para autenticar com o NetSuite e está disponível em todas as versões do Harmony onde o conector NetSuite está disponível. O tipo de autenticação SSO foi descontinuado pelo NetSuite e não é mais suportado com versões WSDL do NetSuite 2020.1 e posteriores. Agora é recomendado que todos os usuários utilizem TBA.

  Cuidado

  Com o tipo de autenticação SSO, usuários do Jitterbit cuja assinatura do NetSuite é limitada a um único thread de processamento podem enfrentar problemas de throughput. Esses usuários devem usar TBA. Usuários do NetSuite com uma licença SuiteCloud Plus podem usar qualquer tipo de autenticação, pois esse tipo de licença permite maior concorrência de threads.

  Aviso

  Aqueles que usam autenticação de dois fatores do NetSuite (TFA ou 2FA) não devem usar o tipo de autenticação SSO. Fazer isso pode causar a falha do seu endpoint NetSuite. Em vez disso, use TBA.

• TBA: TBA (Token-Based Authentication) está disponível para aqueles que usam o Jitterbit Design Studio e Agent versões 9.2 e posteriores. No Jitterbit, usar TBA facilita o uso de múltiplos threads de processamento, resolvendo assim problemas de throughput que podem ser experimentados por usuários do NetSuite limitados por sua assinatura do NetSuite.

  Nota

  Aqueles que utilizam a autenticação de dois fatores (TFA ou 2FA) do NetSuite são obrigados a usar TBA com o Harmony.

Inserir credenciais

Clique em Próximo para continuar. As próximas telas dependem de você ter selecionado SSO ou TBA.

SSO

Insira as credenciais SSO para seu novo endpoint do NetSuite. Um exemplo é fornecido abaixo. Cada opção configurável é explicada a seguir.

• Nome: Insira um nome apropriado para seu novo endpoint do NetSuite. Se você estiver criando endpoints para várias contas do NetSuite, é uma boa ideia distingui-los aqui pelo nome.

• Conta: Insira o ID da conta do NetSuite associado à sua conta do NetSuite.

  Nota

  Se você estiver usando o ambiente sandbox do NetSuite, isso agora é indicado pelo ID da conta do NetSuite. Por exemplo, o ID da conta pode ser acrescido de _SB1, _SB2, etc.

  Como o NetSuite não utiliza mais uma URL de sandbox separada e o sandbox agora é indicado pelo ID da conta, a caixa de seleção Sandbox foi removida no Design Studio versões 9.2 e posteriores.

  Mais informações podem ser encontradas na documentação do NetSuite Sobre Contas Sandbox no Domínio do NetSuite.

• Email: Insira o endereço de email que você usa para fazer login na sua conta do NetSuite.

• Função do Centro de Clientes: Marque esta caixa se você estiver usando a função do Centro de Clientes do NetSuite para controlar permissões.

• Senha: Insira a senha que você usa para fazer login na sua conta do NetSuite.

• Url de Download do Wsdl: Insira a URL específica da conta do WSDL do NetSuite usada pela instância do NetSuite. O Jitterbit suporta as versões do WSDL listadas em Pré-requisitos anteriormente nesta página. Instruções para obter a URL do WSDL específica da conta são fornecidas em URL do WSDL específica da conta do NetSuite.

• ID do Aplicativo: Opcionalmente, insira seu ID do Aplicativo, se você tiver recebido um da NetSuite. Caso contrário, deixe este campo em branco.

  Dica

  Para gerar um novo ID do Aplicativo para o Jitterbit ou localizar um que já exista, consulte Obtendo um ID de aplicativo NetSuite.

• Tempo Limite da Chamada: Opcionalmente, insira o valor do tempo limite da chamada em segundos, se você quiser que o valor do tempo limite seja menor do que a configuração do agente.

  Nota

  A configuração padrão do agente para o tempo limite das chamadas da NetSuite é de 300 segundos.

TBA

Para obter os valores necessários para esta tela, você deve ter ativado o TBA para sua conta NetSuite. Após configurar o TBA na NetSuite, insira as credenciais TBA para seu novo endpoint NetSuite. Um exemplo é fornecido abaixo. Cada opção configurável é explicada a seguir.

• Nome: Insira um nome apropriado para seu novo endpoint NetSuite. Se você estiver criando endpoints para várias contas NetSuite, é uma boa ideia distingui-los aqui pelo nome.

• Conta: Insira o ID da conta NetSuite associado à sua conta NetSuite.

  Nota

  Se você estiver usando o ambiente sandbox da NetSuite, isso agora é indicado pelo ID da conta NetSuite. Por exemplo, o ID da conta pode ser acrescido de _SB1, _SB2, etc.

  Como a NetSuite não usa mais uma URL sandbox separada e o sandbox agora é indicado pelo ID da conta, a caixa de seleção Sandbox foi removida no Design Studio versões 9.2 e posteriores.

  Mais informações podem ser encontradas na documentação da NetSuite Sobre Contas Sandbox no Domínio NetSuite.

• Url de Download do Wsdl: Insira a URL específica da conta do WSDL do NetSuite usada pela instância do NetSuite. O Jitterbit suporta as versões do WSDL listadas em Pré-requisitos anteriormente nesta página. Instruções para obter a URL do WSDL específica da conta estão disponíveis em URL do WSDL específica da conta do NetSuite.

• Chave do Consumidor e Segredo do Consumidor: Insira os valores da Chave do Consumidor e do Segredo do Consumidor do NetSuite obtidos do NetSuite. Para instruções sobre como obter esses valores, consulte Ativar TBA no NetSuite.

• Chave do Token e Segredo do Token: Insira os valores do ID do Token e do Segredo do Token do NetSuite obtidos do NetSuite. Para instruções sobre como obter esses valores, consulte Ativar TBA no NetSuite.

  Cuidado

  Se você estiver usando uma conta sandbox do NetSuite, cada vez que a sandbox for atualizada, será necessário criar novos tokens.

• Algoritmo de Assinatura: Use o menu suspenso para selecionar o algoritmo de assinatura a ser usado para assinar a solicitação, um dos HMAC-SHA1 ou HMAC-SHA256. O algoritmo de assinatura determina como a carga útil é criptografada.

  Nota

  O NetSuite descontinuou o HMAC-SHA1 como um método de assinatura válido em favor do HMAC-SHA256 a partir das seguintes versões:

  • Contas Não-Produção: versão 2021.2 do NetSuite e posteriores.
  • Contas de Produção: versão 2023.1 do NetSuite e posteriores.

  A descontinuação do HMAC-SHA1 é independente da versão do WSDL que você especifica na configuração do endpoint do NetSuite.

  Aviso

  Se você estiver atualmente usando HMAC-SHA1, recomendamos mudar o algoritmo de assinatura para HMAC-SHA256 o mais rápido possível para evitar problemas com suas integrações. Para mais informações e etapas para mudar o algoritmo de assinatura, consulte Descontinuação do HMAC-SHA1 no NetSuite.

• Tempo de Chamada Limite: Opcionalmente, insira o valor do tempo limite da chamada em segundos, se você quiser que o valor do tempo limite seja menor do que a configuração do agente.

  Nota

  A configuração padrão do agente para o tempo limite das chamadas do NetSuite é de 300 segundos.

• Tentar Novamente em Exceção Recuperável (rotulado Habilitar Opção de Tentativa nas versões 10.36 e 10.37): Esta opção está presente nas versões do Design Studio 10.36 e posteriores, e é funcional apenas quando se utiliza um ambiente associado a um grupo de agentes privado cujos agentes são da versão 10.24 ou posterior. Seu comportamento depende da versão do agente privado. Quando selecionada, esta configuração é usada para tentar novamente uma solicitação rejeitada ao NetSuite quando um dos seguintes critérios é atendido:

  • Agentes privados 10.24 e posteriores: O limite de governança do NetSuite para solicitações simultâneas é atingido e o erro WS_REQUEST_BLOCKED é retornado.
  • Agentes privados 10.36 e posteriores: O NetSuite não retorna uma resposta no prazo esperado e ocorre uma exceção de tempo limite.

  Para verificar os limites de concorrência da sua conta do NetSuite, na interface do usuário do NetSuite, vá para Configuração > Integração > Governança de Integração. Para mais informações, consulte a documentação do NetSuite sobre Limites de Governança de Concorrência Baseados em Níveis de Serviço e Licenças SuiteCloud Plus.

  Para que esta configuração tenha efeito, a variável Jitterbit jitterbit.netsuite.async não deve ser definida como true antes da operação.

  Com agentes privados da versão 10.23 ou anterior, em agentes em nuvem, ou se a variável assíncrona do Jitterbit estiver habilitada, esta configuração será ignorada.

  Selecione a caixa de seleção Tentar Novamente em Exceção Recuperável para habilitar opções de configuração adicionais:

  

  • Número Máximo de Tentativas (rotulado Máx Tentativa nas versões 10.36 e 10.37): Insira o número de vezes (máximo de 5 tentativas) que uma solicitação rejeitada será reenviada ao NetSuite. Se a solicitação ainda for rejeitada após o número máximo de tentativas, uma exceção com uma mensagem de erro será retornada no log da operação. Além disso, o agente privado registrará cada tentativa no arquivo de log jitterbit-agent.log.

Cada tentativa é tratada como parte da mesma execução da operação, onde apenas um único registro aparece no registro da operação. Quaisquer condições de On Success ou On Failure configuradas para executar operações subsequentes são acionadas com base no status final da operação após tentar até o número máximo de tentativas.

• Intervalo de Tentativa: Insira o número de segundos (máximo de 5 segundos) a esperar entre o reenvio de uma solicitação rejeitada para o NetSuite.

Verificar credenciais (sso)

Para o tipo de autenticação SSO apenas, ao clicar em Finish, o Jitterbit verificará as credenciais fornecidas.

• Se for bem-sucedido, seu novo endpoint do NetSuite será criado. A tela de configuração do endpoint será aberta na visualização principal do Studio. Você pode retornar à tela de configuração a qualquer momento clicando duas vezes no endpoint na árvore à esquerda em Connectors > NetSuite > NetSuite Endpoints.
• Se não for bem-sucedido, uma mensagem aparecerá indicando um problema com as credenciais. Você ainda pode optar por criar o endpoint e modificar as credenciais mais tarde.

Editar ou testar um endpoint

Após a criação do seu endpoint, você pode retornar à tela de configuração a qualquer momento clicando duas vezes no endpoint na árvore à esquerda em Connectors > NetSuite > NetSuite Endpoints.

SSO

Para o tipo de autenticação SSO, a tela de configuração será semelhante à abaixo.

• Nome: Renomeie seu endpoint existente do NetSuite. Se você estiver criando endpoints para várias contas do NetSuite, é uma boa ideia distingui-los aqui pelo nome.

• Passaporte: Esta seção contém as informações inseridas quando o endpoint foi criado. A Conta e o Email estão listados aqui. Você também pode editar o Wsdl Download Url e os campos opcionais Application ID e Call Time Out aqui. Esses campos são os mesmos descritos acima nesta página.

• Converter para TBA: Esta opção está disponível no Design Studio versão 9.3.1 e versões posteriores.

  Clique no botão Converter para TBA para abrir uma janela pop-up para inserir as credenciais para mudar o tipo de autenticação de SSO para TBA. O valor usado para cada campo está documentado anteriormente nesta página em Inserir credenciais na seção TBA.

  

• Editar Credenciais: Clique no botão Editar Credenciais para editar as configurações de Conta, Email, Senha ou Função do Centro do Cliente. Essas opções são as mesmas descritas acima nesta página.

• Testar Conexão: Clique no botão Testar Conexão para verificar a conexão com sua conta do NetSuite. Uma mensagem indicará se a conexão foi bem-sucedida. Se a conexão não for bem-sucedida, certifique-se de atender aos pré-requisitos e verifique novamente os valores que você forneceu nesta tela. Se você receber um erro ao testar a conexão, consulte as informações de solução de problemas.

TBA

Para o tipo de autenticação TBA, a configuração será semelhante à abaixo.

• Nome: Renomeie seu endpoint do NetSuite existente. Se você estiver criando endpoints para várias contas do NetSuite, é uma boa ideia distingui-los aqui pelo nome.
• Passaporte TBA: Esta seção contém as informações inseridas quando o endpoint foi criado. Você pode editar qualquer um dos campos disponíveis na configuração original, conforme descrito acima nesta página.
• Testar Conexão: Clique no botão Testar Conexão para verificar a conexão com sua conta do NetSuite. Uma mensagem indicará se a conexão foi bem-sucedida. Se a conexão não for bem-sucedida, certifique-se de atender aos pré-requisitos e verifique novamente os valores que você forneceu nesta tela. Se você receber um erro ao testar a conexão, consulte as informações de solução de problemas.