Endpoint do conector NetSuite
Introdução
Antes de poder criar operações do NetSuite no Jitterbit usando o NetSuite Connector, você deve configurar pelo menos um endpoint do NetSuite.
Cada endpoint representa a URL e as credenciais de login para uma conta específica do NetSuite. A criação do endpoint permite que o Jitterbit acesse a conta para executar as operações solicitadas. Se sua organização usa várias contas do NetSuite, você precisará criar um endpoint para cada conta.
Outras maneiras de se conectar ao NetSuite usando o Jitterbit Studio incluem chamar um RESTlet, usar um método de serviço web ou usar o driver Oracle NetSuite JDBC:
- Chamar um RESTlet de uma fonte de arquivo local
- Chamando um RESTlet de uma fonte ou destino HTTP
- Usando um método de serviço da Web
- Usando o driver Oracle NetSuite JDBC com uma origem ou destino do banco de dados
Pré-requisitos
Para usar com sucesso o Jitterbit NetSuite Connector para integrações NetSuite, estes critérios devem ser atendidos:
-
O Jitterbit verificou o suporte até a versão 2023.2 do NetSuite WSDL. O NetSuite suporta as seis versões mais recentes de seu WSDL a qualquer momento. Portanto, recomendamos que a instância NetSuite use uma dessas versões de WSDL:
- 2024.2
- 2024.1
- 2023.2
- 2023.1
- 2022.2
- 2022.1
O Jitterbit verificou o suporte anterior para versões mais antigas do WSDL disponíveis, de 2017.1 a 2021.2, que não são mais suportadas pelo NetSuite. Versões mais antigas do WSDL estão listados 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ê atualize para uma versão de WSDL suportada.
-
A URL WSDL deve ser fornecida no formato de uma URL WSDL específica da conta. As instruções para obter a URL WSDL são fornecidas em NetSuite account-specific WSDL URL.
- NetSuite WSDL 2021.2, 2022.1, 2022.2, 2023.1, 2023.2, 2024.1 e 2024.2 exigem Harmony Cloud ou agentes privados versão 10.33 ou posterior.
- O NetSuite WSDL 2020.2 e 2021.1 exigem o Harmony Cloud ou agentes privados versão 10.26 ou posterior.
- O NetSuite WSDL 2020.1 requer o Harmony Cloud ou agentes privados versão 10.18 ou posterior.
- O NetSuite WSDL 2019.1 e 2019.2 exigem o Harmony Cloud ou agentes privados versão 10.4 ou posterior.
- Os WSDLs do NetSuite até 2018.2 exigem o Harmony Cloud ou agentes privados versão 9.9 ou posterior.
-
Para usar autenticação baseada em token (TBA):
-
Você deve estar usando o SuiteTalk versão 2015.2 ou posterior.
-
Você deve ter o TBA habilitado para sua conta NetSuite.
-
Para configurar um novo endpoint TBA, você deve usar o Jitterbit Design Studio e o Agente versões 9.2 ou posteriores.
-
Para converter um endpoint SSO existente para usar o TBA, você deve usar o Jitterbit Design Studio versão 9.3.1 ou posterior e o Agents versão 9.2 ou posterior.
-
Dica
Para obter informações adicionais, consulte a seguinte documentação do NetSuite:
- Integração NetSuite – SuiteTalk (Serviços Web)
- NetSuite – Gerenciando usuários e funções
- NetSuite – Introdução à autenticação baseada em token
Criar um endpoint
Nota
Se você ainda não estiver familiarizado com o Jitterbit, consulte Começar ou Design Studio para obter informações detalhadas sobre como usar o produto.
Dentro do seu projeto no Jitterbit Studio, há várias maneiras de iniciar um novo endpoint NetSuite:
- Vá para Arquivo > Novo > Conectores > Novo Endpoint NetSuite.
- Na árvore à esquerda, em Conectores, clique com o botão direito do mouse na categoria NetSuite e selecione Novo Endpoint NetSuite.
- Na árvore à esquerda, em Conectores, clique duas vezes na categoria NetSuite, depois clique com o botão direito do mouse 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) . No pop-up, selecione NetSuite e, em seguida, selecione NetSuite Endpoint.
Selecione o tipo de autenticação
Na primeira tela do assistente de endpoint do NetSuite, escolha como você gostaria que o Jitterbit autenticasse com sua instância do 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 autenticação 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 as versões 2020.1 e posteriores do NetSuite WSDL. Agora é recomendado que todos os usuários usem o TBA.
Cuidado
Com o tipo de autenticação SSO, os usuários do Jitterbit cuja assinatura do NetSuite é limitada a um único thread de processamento podem ter problemas com a taxa de transferência. Esses usuários devem usar o TBA. Os 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 simultaneidade 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. Isso pode fazer com que seu endpoint do NetSuite falhe. Em vez disso, use TBA.
-
TBA: TBA (Autenticação Baseada em Token) está disponível para aqueles que usam o Jitterbit Design Studio e o Agente versões 9.2 e posterior. 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 usam autenticação de dois fatores do NetSuite (TFA ou 2FA) no NetSuite são obrigados a usar o TBA com o Harmony. Saiba mais em Autenticação baseada em token do NetSuite 2018.2.
Insira as credenciais
Clique em Next para continuar. As próximas telas dependem se você selecionou SSO ou TBA.
SSO
Insira as credenciais SSO para seu novo endpoint NetSuite. Um exemplo é fornecido abaixo. Cada opção configurável é explicada da seguinte forma.
-
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 do NetSuite, isso agora é indicado pelo ID da conta do NetSuite. Por exemplo, o ID da conta pode ser anexado com _SB1, _SB2, etc.
Como o NetSuite não usa mais URL de sandbox separada e o sandbox agora é indicado pela ID da conta, a caixa de seleção Sandbox foi removida no Design Studio versões 9.2 e depois.
Mais informações podem ser encontradas na documentação do NetSuite Sobre contas de sandbox no domínio NetSuite.
-
E-Email: Insira o endereço de email que você usa para fazer login na sua conta NetSuite.
-
Função do Centro de Atendimento ao Cliente: Marque esta caixa se estiver usando a papel do Centro de Atendimento ao Cliente do NetSuite para controlar permissões.
-
Senha: Digite a senha que você usa para fazer login na sua conta NetSuite.
-
URL de download do WSDL: Insira a URL específica da conta do WSDL do NetSuite usado pela instância do NetSuite. O Jitterbit suporta as versões do WSDL listadas em Pré-requisitos anteriormente nesta página. As instruções para obter a URL WSDL específica da conta são fornecidas em URL WSDL específica da conta 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 de aplicativo para o Jitterbit ou localizar um que já exista, consulte Obtendo um ID de aplicativo NetSuite.
-
Tempo limite de chamada: Opcionalmente, insira o valor do tempo limite de chamada em segundos, se quiser que o valor do tempo limite seja menor que a configuração do agente.
Nota
A configuração padrão do agente para tempo limite de chamadas do NetSuite é de 300 segundos.
A confirmar
Para obter os valores necessários para esta tela, você deve ter habilitado o TBA para sua conta NetSuite. Após configurar o TBA no NetSuite, insira as credenciais do 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 do NetSuite, isso agora é indicado pelo ID da conta do NetSuite. Por exemplo, o ID da conta pode ser anexado com _SB1, _SB2, etc.
Como o NetSuite não usa mais URL de sandbox separada e o sandbox agora é indicado pela ID da conta, a caixa de seleção Sandbox foi removida no Design Studio versões 9.2 e depois.
Mais informações podem ser encontradas na documentação do NetSuite Sobre contas de sandbox no domínio NetSuite.
-
URL de download do WSDL: Insira a URL específica da conta do WSDL do NetSuite usado pela instância do NetSuite. O Jitterbit suporta as versões do WSDL listadas em Pré-requisitos anteriormente nesta página. As instruções para obter a URL WSDL específica da conta são fornecidas em URL WSDL específica da conta NetSuite.
-
Consumer Key e Consumer Secret: Insira os valores NetSuite Consumer Key e Consumer Secret obtidos do NetSuite. Para obter instruções sobre como obter esses valores, consulte Enable TBA in NetSuite.
-
Token Key e Token Secret: Insira os valores NetSuite Token ID e Token Secret obtidos do NetSuite. Para obter instruções sobre como obter esses valores, consulte Enable TBA in NetSuite.
Cuidado
Se você estiver usando uma conta sandbox do NetSuite, cada vez que o sandbox for atualizado, você precisará 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 de HMAC-SHA1 ou HMAC-SHA256. O algoritmo de assinatura determina como a payload é criptografada.
Nota
O NetSuite descontinuou o HMAC-SHA1 como um método de assinatura válido em favor do HMAC-SHA256 a partir destas versões:
- Contas de não produção: NetSuite versão 2021.2 e posterior.
- Contas de produção: NetSuite versão 2023.1 e posterior.
A descontinuação do HMAC-SHA1 é independente da versão do WSDL que você especificar na configuração do endpoint do NetSuite.
-
Tempo limite de chamada: Opcionalmente, insira o valor do tempo limite da chamada em segundos, se quiser que o valor do tempo limite seja menor que a configuração do agente.
Nota
A configuração padrão do agente para tempo limite de chamadas do NetSuite é de 300 segundos.
-
Repetir em Exceção Recuperável (rotulado Habilitar Opção de Repetição nas versões 10.36 e 10.37): Esta opção está presente nas versões 10.36 e posteriores do Design Studio e é funcional somente ao usar um ambiente associado a um grupo de agentes privados 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 repetir uma solicitação rejeitada para o NetSuite quando qualquer um destes critérios for atendido:
- Agentes privados 10.24 e posteriores: O limite de governança do NetSuite para solicitações simultâneas foi 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 simultaneidade da sua conta NetSuite, na IU do NetSuite, vá para Configuração > Integração > Governança de integração. Para obter mais informações, consulte a documentação do NetSuite em Limites de governança de simultaneidade com base em níveis de serviço e licenças do SuiteCloud Plus.
Para que esta configuração tenha efeito, a variável Jitterbit
jitterbit.netsuite.async
não deve ser definido comotrue
a acima na cadeia da operação.Com agentes privados versão 10.23 ou anterior, em agentes de nuvem, ou se a variável assíncrona Jitterbit estiver habilitada, esta configuração será ignorada.
Selecione a caixa de seleção Repetir em exceção recuperável para habilitar opções de configuração adicionais:
-
Número Máximo de Tentativas (rotulado como Máx. Tentativas 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 de operação. Além disso, o agente privado registrará cada tentativa no
jitterbit-agent.log
arquivo de log.Cada nova tentativa é tratada como parte da mesma execução de operação, onde apenas um único registro aparece no log de operação. Quaisquer condições Em caso de sucesso ou Em caso de falha configuradas para executar operações abaixo são acionadas com base no status final da operação após novas tentativas até o número máximo de tentativas.
-
Intervalo de nova tentativa: Insira o número de segundos (máximo de 5 segundos) para aguardar entre o reenvio de uma solicitação rejeitada ao NetSuite.
- Agentes privados 10.24 e posteriores: O limite de governança do NetSuite para solicitações simultâneas foi atingido e o erro
Verificar credenciais (sso)
Nota
Esta etapa não está presente para TBA. Em vez disso, aqueles que usam TBA podem verificar credenciais usando o botão Testar conexão conforme descrito na próxima seção, Editar ou testar um endpoint.
Somente para o tipo de autenticação SSO, ao clicar em Concluir, o Jitterbit verificará as credenciais fornecidas.
- Se bem-sucedido, seu novo endpoint NetSuite será criado. A tela de configuração do endpoint será aberta na visualização principal do Studio. Você pode voltar para a 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 escolher 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 Conectores > NetSuite > Endpoints NetSuite.
SSO
Para o tipo de autenticação SSO, a tela de configuração será semelhante à abaixo.
-
Nome: Renomeie seu endpoint NetSuite existente. Se você estiver criando endpoints para várias contas 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 E-Email estão listados aqui. Você também pode editar os campos URL de download do Wsdl e ID do aplicativo e Tempo limite da chamada opcionais 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 depois.
Clique no botão Converter para TBA para abrir uma janela pop-up para inserir credenciais para alterar o tipo de autenticação de SSO para TBA. O valor usado para cada campo é documentado anteriormente nesta página em Inserir credenciais no TBA seção.
-
Editar credenciais: Clique no botão Editar credenciais para editar as configurações de Conta, E-Email, Senha ou Função do Customer Center. 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 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 testando a conexão, consulte informações de solução de problemas.
A confirmar
Para o tipo de autenticação TBA, a configuração será semelhante à abaixo.
- Nome: Renomeie seu endpoint NetSuite existente. Se você estiver criando endpoints para várias contas NetSuite, é uma boa ideia distingui-los aqui pelo nome.
- TBA Passport: 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 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 testando a conexão, consulte informações de solução de problemas.