Conector NetSuite no Jitterbit Studio
Resumo
O conector NetSuite estabelece acesso ao NetSuite.
O conector NetSuite fornece uma interface para criar uma conexão NetSuite, a base usada para gerar instâncias de atividades NetSuite. Essas atividades, uma vez configuradas, interagem com o NetSuite através da conexão.
O conector NetSuite é acessado a partir da aba Endpoints de projeto e conectores da paleta de componentes de design (consulte Paleta de componentes de design).
Dica
Receitas de integração e modelos de processo estão disponíveis para este conector através do Jitterbit Marketplace.
Importante
A Oracle está descontinuando gradualmente os endpoints de serviço web SOAP do NetSuite. A última versão de serviço web SOAP planejada (2025.2) é suportada até a versão 2028.2.
A partir da versão 2027.1 do NetSuite, novas integrações não podem mais ser criadas usando serviços web SOAP. Isso ocorre porque o NetSuite restringe a autenticação baseada em token (TBA), que este conector requer, a integrações existentes a partir dessa versão. Os endpoints NetSuite existentes criados com este conector antes da versão 2027.1 podem continuar sendo usados e modificados.
Embora nenhuma ação imediata seja necessária se você estiver usando o endpoint da versão 2025.2, é possível conectar aos serviços web REST SuiteTalk com o conector HTTP v2 para fazer upgrade antes do cronograma da Oracle.
Para mais informações, consulte Perguntas sobre o cronograma de remoção do SOAP do NetSuite e o Guia de upgrade de serviços web SOAP para serviços web REST do NetSuite.
Visão geral do conector
Este conector é usado para primeiro configurar uma conexão NetSuite. Os tipos de atividade associados a essa conexão são então usados para criar instâncias de atividades que se destinam a ser usadas como fontes (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).
Juntos, uma conexão NetSuite específica e suas atividades são chamados de endpoint NetSuite:

-
Search: Recupera registros existentes do NetSuite e se destina a ser usado como uma fonte para fornecer dados em uma operação.
-
Create: Cria novos registros no NetSuite e se destina a ser usado como um destino em uma operação.
-
Update: Atualiza registros existentes no NetSuite e se destina a ser usado como um destino em uma operação.
-
Get List: Recupera uma lista de registros existentes com base no ID do NetSuite e se destina a ser usado como um destino em uma operação.
-
Upsert: Atualiza registros existentes e cria novos registros no NetSuite e se destina a ser usado como um destino em uma operação.
-
Excluir: Exclui registros no NetSuite e destina-se a ser usado como destino em uma operação.
Este conector é um conector nativo: suas atualizações são lançadas com o aplicativo Studio ou o agente, em vez de separadamente. Consulte Atualizações de conector do Studio.
Os endpoints criados com este conector estão incluídos no relatório de uso de endpoints e contam para sua licença.
Pré-requisitos e versões de API suportadas
Este conector pode ser usado com agentes em nuvem e agentes privados.
Certos pré-requisitos devem ser atendidos para usar este conector, incluindo ter autenticação baseada em token (TBA) habilitada, usar uma versão WSDL do NetSuite suportada e usar agentes Harmony em nuvem ou privados que suportem a versão WSDL do NetSuite.
O conector NetSuite usa a API de serviços web SOAP da versão do WSDL do NetSuite que você configurou. O conector NetSuite pode ser configurado com os WSDLs suportados listados nos pré-requisitos.
Importante
A Oracle está descontinuando gradualmente os endpoints de serviços web SOAP do NetSuite. A última versão de serviço web SOAP planejada (2025.2) é suportada até o lançamento 2028.2.
A partir do lançamento 2027.1 do NetSuite, novas integrações não podem mais ser criadas usando serviços web SOAP. Isso ocorre porque o NetSuite restringe a autenticação baseada em token (TBA), que este conector requer, a integrações existentes a partir desse lançamento. Os endpoints NetSuite existentes criados com este conector antes do lançamento 2027.1 podem continuar sendo usados e modificados.
A Jitterbit fornecerá orientação sobre os serviços web REST do NetSuite no futuro. Para mais informações, consulte Perguntas sobre a linha do tempo de remoção do SOAP do NetSuite.
A opção Saved Search with result fields as output em uma atividade NetSuite Search requer um script Suitelet implantado para buscar os metadados necessários para limitar os campos do esquema de resposta às colunas de uma pesquisa salva.
Nota
A opção Saved Search with result fields as output requer agentes versão 11.49 ou posterior.
Consulte a documentação fornecida no NetSuite Help Center para informações sobre os campos de esquema.
Limitações
O conector NetSuite não suporta serviços web attach / detach. Para usar esses serviços web, use o conector SOAP da Jitterbit.
Solução de problemas e guias práticos
Solução de problemas
Se você tiver problemas com o conector NetSuite, recomenda-se seguir estas etapas de solução de problemas:
-
Verifique se a conexão NetSuite foi bem-sucedida usando o botão Test na tela de configuração. Se a conexão não for bem-sucedida, o erro retornado pode fornecer uma indicação do problema.
-
Verifique os logs de operação para qualquer informação registrada durante a execução da operação.
-
Ative o log de depuração de operação (para agentes na nuvem ou para agentes privados) para gerar arquivos de log e dados adicionais.
-
Se estiver usando agentes privados, certifique-se de que está usando a versão do agente 11.30 ou posterior e verifique os logs do agente para obter mais informações.
-
Revise as limitações do conector NetSuite.
Se ainda estiver enfrentando problemas, há considerações gerais de solução de problemas em Solução de problemas de operação. Informações adicionais de solução de problemas específicas do conector NetSuite estão disponíveis na página Solução de problemas do NetSuite e no guia Solução de problemas do conector, incluindo:
-
Governança de concorrência: O que fazer se você vir erros causados por muitas solicitações simultâneas.
-
Campos personalizados: Como expor campos personalizados de um objeto ao usar um agente privado.
-
Segmentos personalizados: O que verificar se os segmentos personalizados não forem exibidos conforme esperado.
-
Erro de data center: Uma solução alternativa para um erro relacionado a um data center incorreto.
-
Erro de permissões: Uma solução alternativa para um erro relacionado a permissões insuficientes.
-
Limites de registros: Recomendações sobre como ativar o chunking se você encontrar limites de registros da API NetSuite.
-
NetSuite Create, Update ou Upsert falha com "is not a legal value for Country": O que verificar quando o NetSuite rejeita um valor enumerado, como um país.
Guias práticos
Além das informações de solução de problemas acima, as seguintes páginas de guias práticos fornecem instruções detalhadas sobre como realizar tarefas específicas com projetos de integração que usam o conector NetSuite:
-
Ativar multi-moeda no NetSuite: Como ativar o recurso de multi-moeda no NetSuite.
-
Ativar solicitações assíncronas do NetSuite: Como definir a variável Jitterbit
jitterbit.netsuite.asyncpara usar polling periódico. -
Ativar TBA no NetSuite: Como ativar autenticação baseada em token no NetSuite antes de configurar uma conexão NetSuite.
-
Coletar valores para usar TBA do NetSuite: Como coletar valores necessários para configurar uma conexão NetSuite.
-
Passar valores NULL para campos personalizados do NetSuite: Como definir campos personalizados como NULL em uma transformação.
-
Pesquisar por status no NetSuite: Como especificar o valor de filtro de pesquisa correto ao configurar uma atividade NetSuite Search.
-
Usar uma URL WSDL específica da conta do NetSuite: Como obter uma URL WSDL específica da conta necessária para configurar uma conexão NetSuite.
-
Usar funções do NetSuite: Como usar uma conexão do NetSuite com funções do NetSuite.
-
Usar formulários padrão no NetSuite: Como usar formulários padrão para objetos personalizados no NetSuite.
Recursos adicionais
Um tutorial de microaprendizado do Jitterbit está disponível através da nossa série de vídeos de conceitos básicos do Jitterbit: