Pular para o conteúdo

Conectar ao NetSuite

Extraia dados financeiros e operacionais do NetSuite para tabelas do PlaidCloud com SuiteQL. Este guia leva você de uma integração vazia do NetSuite até uma extração agendada e tipada. Para a referência campo a campo por trás dele, consulte o Conector REST do NetSuite.

Você precisa, no NetSuite:

  • OAuth 2.0 e REST Web Services ativados (Setup > Company > Enable Features > SuiteCloud).
  • Um par de chaves RSA — o certificado público enviado ao NetSuite e a chave privada guardada para o PlaidCloud.
  • Um ID do certificado (o kid do JWT, obtido ao enviar o certificado público), um ID do cliente (do registro de integração) e o ID da sua conta (produção 1234567 ou sandbox 1234567_SB1).
  • Uma função com REST Web Services, Log in using OAuth 2.0 Access Tokens, SuiteAnalytics Workbook (se as suas consultas usarem recursos de análise) e acesso de visualização aos registros que você vai ler.

As etapas completas do lado do NetSuite — gerar o par de chaves, enviar o certificado e criar a integração — estão em Configuração no lado do NetSuite na referência. Conclua-as primeiro; este guia pressupõe que você já tem os quatro valores em mãos.

  1. Abra Tools > Connections e clique em New Connection.

  2. Escolha NetSuite no menu.

  3. Preencha os campos:

    Campo Valor
    Nome Um nome amigável, por exemplo NetSuite Prod.
    ID do cliente O ID do cliente do registro de integração.
    ID do certificado O ID do certificado (kid) do envio do certificado público.
    ID da conta do NetSuite O ID da sua conta, por exemplo 1234567 ou 1234567_SB1.
    Certificado privado do NetSuite O bloco PEM completo da chave privada, colado em várias linhas.
  4. Clique em Create.

As conexões do NetSuite são salvas como conexões REST. Clique com o botão direito na conexão e escolha Edit REST settings para alterar os cabeçalhos, a autenticação ou a paginação dela. Depois de salva, você também pode verificar a conexão com Testar conexão no editor.

Confirme que as credenciais funcionam antes de construir qualquer coisa sobre elas.

  1. Adicione uma etapa Solicitação REST a um fluxo de trabalho.

  2. Na guia Solicitação, defina Conexão como a sua conexão do NetSuite, Método como POST e Endpoint como /services/rest/query/v1/suiteql.

  3. No Corpo, coloque uma consulta pequena e delimitada:

    {"q": "SELECT id FROM account WHERE ROWNUM <= 1"}
  4. Clique em Enviar solicitação de teste.

Com o teste rápido verde, transforme a etapa em uma extração real.

  1. No Corpo, escreva sua consulta SuiteQL com um ORDER BY determinístico. Para pontos de partida prontos para copiar e colar — lançamentos contábeis, balancete, DRE, balanço patrimonial, contas a receber em aberto, pedidos de venda, pedidos de compra, estoque —, consulte Exemplos de consultas SuiteQL do NetSuite.

    Financeiro — linhas de transação do razão geral de um período:

    {"q": "SELECT tl.transaction AS transaction_id, TO_CHAR(t.trandate, 'YYYY-MM-DD') AS tran_date, a.acctnumber AS account_number, tl.subsidiary AS subsidiary_id, tl.foreignamount AS amount FROM transactionline tl JOIN transaction t ON t.id = tl.transaction JOIN account a ON a.id = tl.expenseaccount WHERE t.trandate BETWEEN TO_DATE('2026-01-01','YYYY-MM-DD') AND TO_DATE('2026-01-31','YYYY-MM-DD') ORDER BY tl.transaction, tl.id"}

    Operacional — pedidos de venda em aberto por cliente:

    {"q": "SELECT so.tranid AS order_number, so.entity AS customer_id, TO_CHAR(so.trandate, 'YYYY-MM-DD') AS order_date, so.status AS order_status FROM transaction so WHERE so.type = 'SalesOrd' AND so.status = 'SalesOrd:B' ORDER BY so.id"}
  2. Não altere os controles de Paginação e análise nem os cabeçalhos Prefer/Content-Type — a conexão do NetSuite os injeta.

  3. Na guia Resposta, mantenha o destino como Tabela e defina as colunas com tipos reais: Currency/Decimal para valores, Date/Datetime para datas e Boolean para os indicadores T/F. O SuiteQL retorna tudo como strings; as colunas tipadas dizem ao PlaidCloud como convertê-las.

  1. Execute a etapa (consulte Executar uma única etapa em um fluxo de trabalho) e verifique a tabela de destino — as contagens de linhas e se as colunas de valor e de data chegaram tipadas, não como texto.

  2. Para um fluxo contínuo, agende o fluxo de trabalho.

Sintoma Causa provável
Solicitação de teste com erro 400 e uma mensagem de escopo ou função A função não tem REST Web Services / login OAuth 2.0 / SuiteAnalytics, ou a matriz de escopos foi rejeitada — o detalhe exibido a nomeia.
A troca de token falha Forma errada do ID da conta (sem _SB1), ID do certificado (kid) errado ou uma chave privada que não corresponde ao certificado público enviado.
Erro de tipo/conversão na importação (nomeia a coluna e o valor) Uma coluna tipada recebeu um valor que não consegue analisar — com mais frequência, uma coluna Date/Datetime em que o SuiteQL retornou o formato de exibição da conta. Envolva o campo em TO_CHAR(col, 'YYYY-MM-DD') na consulta ou defina o tipo da coluna como Text.
Os totais não fecham entre subsidiárias amount está na moeda própria de cada transação — use campos consolidados/convertidos.
Linhas duplicadas ou ausentes em uma extração grande Falta um ORDER BY determinístico em uma consulta paginada por deslocamento.