Ir para o conteúdo

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:

attachment

  • 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:

  1. 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.

  2. Verifique os logs de operação para qualquer informação registrada durante a execução da operação.

  3. 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.

  4. 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.

  5. 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:

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:

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: