Ir para o conteúdo

Conexão NetSuite

Introdução

Uma conexão NetSuite, criada usando o conector NetSuite, estabelece acesso ao NetSuite. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades do NetSuite associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

Nota

Este conector suporta a política de Habilitar Re-autenticação em Mudanças política organizacional. Se habilitado, uma mudança na Conta, Chave do Consumidor ou Chave do Token nesta conexão requer que os usuários reentrem o Segredo do Consumidor e o Segredo do Token para a conexão.

Criar ou editar uma conexão NetSuite

Uma nova conexão NetSuite é criada usando o conector NetSuite a partir de uma dessas localizações:

Uma conexão NetSuite existente pode ser editada a partir dessas localizações:

Configurar uma conexão NetSuite

Cada elemento da interface do usuário da tela de configuração da conexão NetSuite é descrito abaixo.

Dica

Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir um menu com as variáveis existentes para escolher.

  • Nome da conexão: Insira um nome 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 NetSuite, que se refere tanto a uma conexão específica quanto às suas atividades.

  • Conta: Insira o ID da conta NetSuite associada à conta NetSuite que você deseja usar. Contas associadas a um ambiente sandbox do 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. Instruções para obter a URL do WSDL específica da conta estão disponíveis em Usar uma URL de 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. Se você usou o pacote de registro de integração fornecido pelo Jitterbit (veja 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 forma, siga os passos descritos em Coletar valores para usar o NetSuite TBA para obter os valores a serem utilizados.

  • Chave do token e Segredo do token: Insira o ID do Token e os valores de Segredo do token obtidos do NetSuite. Para instruções sobre como obter esses valores, consulte Coletar valores para usar o NetSuite TBA.

    Atenção

    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: O algoritmo de assinatura HMAC-SHA256 é utilizado para assinar a solicitação e não pode ser alterado. 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 da conexão do NetSuite.

  • Tempo limite da chamada: 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 padrão do agente.

    Nota

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

  • Tentar novamente em Exceção Recuperável: Esta configuração é funcional apenas 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 tentar novamente uma solicitação rejeitada ao NetSuite quando um desses critérios for atendido:

    • Agentes privados 10.24 e posteriores: O limite de governança de solicitações simultâneas do NetSuite é 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 timeout.

    Para verificar os limites de concorrência da sua conta do NetSuite, na interface 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 do Jitterbit jitterbit.netsuite.async não deve ser definida como true antes da operação.

    Com agentes privados na 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 expandir opções de configuração adicionais.

    • Número máximo 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 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 log da operação. Qualquer ação de operação configurada para executar operações a montante é acionada com base no status final da operação após tentar até o número máximo de tentativas.

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

  • Configurações opcionais: Clique para expandir configurações opcionais adicionais:

  • Habilitar Paginação do NetSuite: Selecione para habilitar o suporte para tipos de registro do NetSuite com mais de 1.000 campos personalizados. Esta opção requer agentes na versão 11.52 ou posterior.

    -   **Limite de Paginação do NetSuite:** Insira o número de campos personalizados a serem suportados, até um máximo de `2000`. O valor padrão é `1000`.

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

    Atenção

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

  • Salvar Alterações: Clique para salvar e fechar a configuração da 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 (veja Dependências de componentes, exclusão e remoção). Uma mensagem pede para você confirmar que deseja excluir a conexão.

Próximas etapas

As ações do menu para uma conexão e seus tipos de atividade estão acessíveis no painel do projeto e na paleta de componentes de design. Para detalhes, veja Menus de ações em Fundamentos do conector.

Após configurar uma conexão do NetSuite, você pode configurar uma ou mais atividades do 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, ou você pode usar a conexão do NetSuite dentro de um script.

Configurar atividades

Esses tipos de atividade estão disponíveis:

  • Pesquisar: Recupera registros existentes do NetSuite e é destinado a ser usado como uma fonte para fornecer dados em uma operação.

  • Criar: Cria novos registros no NetSuite e é destinado a ser usado como um destino em uma operação.

  • Atualizar: Atualiza registros existentes no NetSuite e é destinado a ser usado como um destino em uma operação.

  • Obter Lista: Recupera uma lista de registros existentes com base no ID do NetSuite e é destinado a ser usado como um destino em uma operação.

  • Upsert: Tanto atualiza registros existentes quanto cria novos registros no NetSuite e é destinado a ser usado como um destino em uma operação.

  • Excluir: Exclui registros no NetSuite e é destinado a ser usado como um destino em uma operação.

Use conexões do NetSuite em scripts

As conexões do NetSuite podem ser referenciadas em um script usando funções de script que utilizam um netSuiteOrg como parâmetro. Para mais informações, veja Usar funções do NetSuite.