O Chains possui três conectores diferentes para o NetSuite, cada um deles funcionando de maneira distinta. Elas não são tão simples nem tão flexíveis quanto outras plataformas; por isso, é muito importante conhecer as diferenças para tomar a decisão certa para o seu negócio e para a sua solução.
Pré-requisitos e requisitos
Antes de configurar qualquer integração com o NetSuite, certifique-se de ter os seguintes componentes à disposição. A omissão desses elementos é a causa mais comum de falhas na conexão.
- SuiteAnalytics Connect: Se estiver usando os conectores JDBC ou Analytics, esse recurso deve estar habilitado na sua conta do NetSuite. Observe que, muitas vezes, esse é um módulo complementar pago; verifique seu contrato com a NetSuite.
- Serviços Web REST do SuiteTalk: Necessário para o conector moderno do NetSuite Analytics e para as operações do SuiteQL.
- Usuário dedicado à integração: A Workiva recomenda enfaticamente a criação de uma “Função de integração” e de um “Usuário de integração” específicos no NetSuite, em vez de utilizar um login pessoal. Isso ajuda a evitar que a cadeia seja interrompida caso haja alterações no acesso de um funcionário.
NetSuite® Analytics (Recomendado)
Essa abordagem recomendada utiliza o SuiteAnalytics (especificamente a fonte de dados `NetSuite2.com`) e o SuiteQL. Esse é o método moderno e permite uma solução mais sustentável e com melhor desempenho. Você precisará organizar seus dados para uso no SuiteAnalytics, o que pode valer a pena como investimento para evitar os problemas de desempenho observados nos conectores antigos.
Usos típicos da exportação
Use o comando “ ” Execute SuiteQL Query para executar sua consulta SuiteQL e recuperar registros do NetSuite.
Outros usos
Você também pode listar e executar conjuntos de dados usando este conector.
Autenticação por token do NetSuite® (versão antiga)
Atualmente, o conector de autenticação por token utiliza a versão mais recente dos serviços Web SOAP “ ” da NetSuite. Embora isso garanta a estabilidade atual, o SOAP está sendo gradualmente descontinuado pela NetSuite em favor de protocolos mais recentes.
Atualização do roteiro: A Workiva planeja migrar esse conector para utilizar a versão da API REST do em 2026, a fim de se alinhar ao cronograma de descontinuação da NetSuite. Até lá, o conector continua sendo totalmente compatível com a versão mais recente do SOAP, embora seja geralmente recomendável usar o conector NetSuite Analytics para novos projetos, sempre que possível.
Usos típicos da exportação
- Método do arquivo: No NetSuite, automatize a transferência de seus arquivos para o arquivo e, em seguida, no Chains, use o comando “ Get file ” para recuperá-los.
- Método de pesquisa salva: Crie as pesquisas salvas necessárias no NetSuite e, em seguida, no Chains, use o comando “ ” (Listar pesquisas salvas) para obter uma lista de todas as pesquisas disponíveis, seguido pelo comando “ ” (Obter dados da pesquisa salva) para extrair os dados.
Observação: A API do NetSuite não permite a obtenção de dados de uma pesquisa salva que contenha resultados resumidos (agrupamento).
Outros usos
Você também pode pesquisar registros por tipo ou ID e recuperar dados em JSON para um registro padrão.
NetSuite® JDBC
Este conector requer o SuiteAnalytics Connect no NetSuite e oferece suporte à conectividade JDBC, permitindo que você consulte o banco de dados usando SQL padrão. Recomenda-se, em geral, o uso do conector mais recente do NetSuite Analytics (que utiliza SuiteQL), já que o gerenciamento de drivers JDBC e cadeias de conexão pode ser mais complexo.
Comparação de conectores
| Conector | Tecnologia subjacente | Melhor caso de uso |
|---|---|---|
| Análise do NetSuite | SuiteQL / REST | Na maioria dos casos. O padrão moderno para consultar grandes conjuntos de dados de forma organizada. |
| Autenticação por token | SOAP (versão antiga) | Apenas compatibilidade com versões antigas. Use essa opção se você tiver Pesquisas Salvas que ainda não possam ser migradas para o SuiteQL. |
| NetSuite JDBC | Conectividade de Banco de Dados em Java | Se sua equipe prefere escrever consultas SQL diretas em vez de utilizar interações padrão com a API. Requer o módulo “Connect”. |