Conexão NetSuite¶

Introdução¶

Uma conexão NetSuite é configurada usando o conector NetSuite, estabelecendo acesso ao endpoint NetSuite. Depois que uma conexão é estabelecida, você pode configurar uma ou mais atividades NetSuite associadas a essa conexão para serem usadas como uma fonte para fornecer dados a uma operação ou como um destino para consumir dados em uma operação. Além disso, a conexão NetSuite pode ser usada em scripts.

Criar Ou Editar uma Conexão NetSuite¶

Uma nova conexão NetSuite é criada usando o conector NetSuite de um destes locais:

• A aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).
• A página Conexões globais (consulte Criar um endpoint global em Conexões Globais).

Uma conexão NetSuite existente pode ser editada nestes locais:

• A aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).
• A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).
• A página Conexões globais (consulte Editar um endpoint global em Conexões Globais).

Configurar uma Conexão NetSuite¶

A configuração de uma conexão NetSuite inclui estes campos:

• Nome do Endpoint: Insira um nome a ser usado para identificar a conexão NetSuite. O nome deve ser exclusivo para cada conexão NetSuite e não deve conter barras (/) ou dois pontos (:). Este nome também é usado para identificar o endpoint do NetSuite, que se refere a uma conexão específica e suas atividades.

• Conta: Insira o ID da conta NetSuite associado à conta NetSuite que você deseja usar. Contas associadas a um ambiente sandbox NetSuite podem ser indicadas com um sufixo como SB1, SB2, etc.

• 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 do NetSuite. As instruções para obter o URL WSDL específico da conta são fornecidas em Usar um URL WSDL específico da conta NetSuite.

• Consumer Key e Consumer Secret: Insira os valores NetSuite Consumer Key e Consumer Secret. Se você usou o pacote de registro de integração fornecido pelo Jitterbit (consulte Pré-requisitos do NetSuite), use os seguintes valores:

  • Chave do consumidor: 768b136f26ea98b957e7dd2e87bad89077ca2ec484a0cb72c5a8e1b003627213
  • Segredo do consumidor: 0dbf3d5e3c2d2ff72ef1a8e8d564d5786da2f60006ad97a00246d7ce924c8b51

  Se você criou o registro de integração de outra maneira, siga as etapas descritas em Coletar valores para usar o NetSuite TBA para obter valores a serem usados.

• 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 Coletar valores para usar o NetSuite TBA.

  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 especificada na configuração da conexão do NetSuite.

• Tempo limite de chamada: Insira o valor do tempo limite de chamada em segundos se quiser que ele seja menor que a configuração padrão do agente.

  Nota

  A configuração padrão do agente para o tempo limite de chamadas do NetSuite é de 300 segundos. Para agentes privados, esse padrão pode ser alterado no [Connectorsinfo] seção do arquivo de configuração do agente privado.

• Repetir em Exceção Recuperável: Esta configuração é 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 como true 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 expandir opções de configuração adicionais:

  

  • Intervalo de nova tentativa (segundos): Insira o número de segundos (máximo de 5 segundos) de espera entre o reenvio de uma solicitação rejeitada ao NetSuite.

  • Máx. de Tentativas: 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 ações de operação 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.

• Teste: Clique para verificar a conexão usando as credenciais fornecidas.

  Cuidado

  Se você receber um erro sobre o data center ao testar a conexão, pode ser necessário usar uma URL WSDL diferente. Para obter mais informações, consulte Erro do data center do NetSuite.

• Salvar alterações: Clique para salvar e fechar a configuração de conexão.

• Descartar alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede para você confirmar que deseja descartar as alterações.

• Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (consulte Dependências, exclusão e remoção de componentes). Uma mensagem pede para você confirmar que deseja excluir a conexão.

Próximos Passos¶

Após uma conexão NetSuite ter sido criada, as ações de menu para essa conexão são acessíveis na aba Componentes do painel do projeto. Veja menu de ações de conexão para mais detalhes.

Depois de configurar uma conexão NetSuite, você pode configurar uma ou mais atividades NetSuite associadas a essa conexão para serem usadas como uma origem para fornecer dados a uma operação ou como um destino para consumir dados em uma operação, ou você pode usar a conexão NetSuite dentro de um script.

Configurar Atividades¶

As atividades do NetSuite interagem com a conexão do NetSuite para atuar como origens (fornecendo dados dentro de uma operação) ou destinos (recebendo dados dentro de uma operação).

Depois de configurar uma conexão NetSuite, use o menu suspenso Mostrar para filtrar por Endpoints e, em seguida, clique no bloco de conexão NetSuite para exibir atividades que estão disponíveis para serem usadas com uma conexão NetSuite:

Para mais informações, veja estas atividades:

• Pesquisar: Recupera registros existentes de um endpoint do NetSuite e deve ser usado como uma fonte em uma operação.
• Criar: Cria novos registros em um endpoint do NetSuite e deve ser usado como um alvo em uma operação.
• Atualizar: Atualiza registros existentes em um endpoint do NetSuite e deve ser usado como um alvo em uma operação.
• Obter lista: Recupera uma lista de registros existentes com base na ID de um endpoint do NetSuite e deve ser usado como um alvo em uma operação.
• Inserir: Atualiza registros existentes e cria novos registros em um endpoint do NetSuite e deve ser usado como um alvo em uma operação.
• Excluir: Exclui registros em um endpoint do NetSuite e deve ser usado como um alvo em uma operação.

Usando Conexões NetSuite em Scripts¶

As conexões NetSuite podem ser referenciadas em um script usando funções de script que usam um netSuiteOrg como um parâmetro. Para obter mais informações, consulte Usando funções do NetSuite.