Pular para o conteúdo

Analisar as finanças do NetSuite — da ligação à demonstração de resultados

~45 minutos · uma ligação NetSuite ativa, um razão geral carregado, uma demonstração de resultados mensal, uma antiguidade de contas a receber e uma atualização agendada

Este é o percurso do primeiro dia para um controller ou analista de FP&A: no final, terá extraído o seu razão geral diretamente do NetSuite, transformado-o numa demonstração de resultados mensal que se lê como um relatório financeiro, criado uma antiguidade de contas a receber, colocado ambos num painel de controlo e configurado o conjunto para se atualizar sozinho. Sem exportação para folha de cálculo, sem reintrodução manual — os números vêm do NetSuite e mantêm-se atuais.

Liga-se uma vez, extrai uma vez e depois faz a parte que realmente importa: transformar as linhas em bruto do razão geral nos resumos que um gestor lê na manhã de segunda-feira.

NetSuiteExtração SuiteQLTabela do RGAgrupar e somarDR
Ligue, extraia o razão geral uma vez e transforme-o em relatórios que pode ler — tudo reexecutável de forma agendada.
  • Uma área de trabalho PlaidCloud e um projeto onde trabalhar (inicie um período experimental se precisar de um).
  • Uma ligação NetSuite funcional. Siga primeiro Ligar ao NetSuite — precisa de ter o OAuth 2.0 e os serviços Web REST ativados no NetSuite, o ID de cliente da integração, um ID de certificado, o ID da sua conta e o PEM da chave privada. Confirme que Enviar pedido de teste fica verde antes de começar aqui.
  • Não é necessário SQL para transformar os dados — fá-lo com passos de transformação padrão. O único texto de consulta é a extração do NetSuite, e todas as consultas de extração são fornecidas. Mantenha Exemplos de consultas SuiteQL do NetSuite aberto num separador; este tutorial recorre a ele.

O fluxo de trabalho é o pipeline que extrai e transforma os dados.

  1. Abra o seu projeto e mude para o separador Fluxos de trabalho.
  2. Clique em Novo fluxo de trabalho, dê-lhe um nome como NetSuite Financials e abra-o.

Uma única consulta SuiteQL devolve um ano de movimentos contabilísticos — todas as contas, todos os meses — o que chega para construir uma demonstração de resultados e, mais tarde, outros relatórios.

  1. Adicione um passo Pedido REST. No separador Pedido, defina Ligação como a sua ligação NetSuite, Método como POST e Endpoint como /services/rest/query/v1/suiteql.

  2. No Corpo, coloque este SuiteQL envolvido como {"q": "…"}:

    SELECT
    TO_CHAR(t.trandate, 'YYYY-MM') AS period,
    a.accttype AS account_type,
    a.acctnumber AS account_number,
    BUILTIN.DF(a.id) AS account_name,
    tal.amount AS amount
    FROM transactionaccountingline tal
    JOIN transaction t ON t.id = tal.transaction
    JOIN account a ON a.id = tal.account
    WHERE tal.posting = 'T'
    AND tal.accountingbook = 1
    AND t.trandate BETWEEN TO_DATE('2026-01-01', 'YYYY-MM-DD')
    AND TO_DATE('2026-12-31', 'YYYY-MM-DD')
    ORDER BY period, a.acctnumber
  3. No separador Resposta, defina o destino como Tabela — chame-lhe netsuite_gl — e defina os tipos de coluna: amount → Moeda, tudo o resto → Texto. (O SuiteQL devolve números e datas como texto; é o tipo que permite somar amount.)

  4. Clique em Enviar pedido de teste para confirmar que funciona e, depois, execute o passo. Passa a ter uma tabela netsuite_gl: uma linha por conta e por mês, com um montante de lançamento com sinal.

Passo 3: transformar o razão geral numa demonstração de resultados

Seção intitulada “Passo 3: transformar o razão geral numa demonstração de resultados”

Agora a análise, feita com uma única transformação de apontar e clicar — sem SQL. Uma demonstração de resultados é apenas o razão geral agregado: contas de rendimentos e gastos, agrupadas em poucas linhas, com o sinal invertido para que a receita surja positiva. Um passo Table Extract faz tudo isto nos separadores Seleção de dados da tabela e Filtros.

  1. Adicione um passo Table Extract. Defina a sua Origem como netsuite_gl e o seu Destino como uma nova tabela, netsuite_pnl.

  2. No separador Filtros, mantenha apenas as contas de rendimentos e gastos (deixe de fora as contas de balanço): adicione um filtro em que account_type é um de Income, OthIncome, COGS, Expense, OthExpense.

  3. No separador Colunas, clique em Resumir para ativar a agregação e depois configure três colunas de destino:

    • period — mapeada diretamente da origem. Resumir Agrupar por.
    • pnl_line — uma expressão (abaixo) que transforma cada tipo de conta numa linha do relatório. Resumir Agrupar por.
    • amount — uma expressão netsuite_gl.amount * -1 (a inversão de sinal). Resumir Soma.

    Para pnl_line, faça duplo clique na respetiva célula de expressão e introduza (o editor permite apontar e clicar nas colunas e na função case do grupo Condições):

    case(
    (netsuite_gl.account_type.in_(['Income', 'OthIncome']), '1 - Revenue'),
    (netsuite_gl.account_type == 'COGS', '2 - Cost of Goods Sold'),
    (netsuite_gl.account_type.in_(['Expense', 'OthExpense']), '3 - Operating Expenses'),
    )
  4. Execute o passo.

A expressão amount * -1 é a única manobra contabilística: ao negar o montante positivo a débito, a receita fica positiva e os custos negativos, pelo que as três linhas de cada mês somam o resultado líquido. Depois, Soma com Agrupar por em period e pnl_line agrega todas as contas nessas três linhas por mês. As expressões usam o editor de apontar e clicar do PlaidCloud — veja Utilização avançada do Data Mapper e a referência de expressões.

Abra a tabela netsuite_pnl. Para cada mês, tem três números:

period pnl_line amount
2026-01 1 - Revenue 486,200.00
2026-01 2 - Cost of Goods Sold -190,540.00
2026-01 3 - Operating Expenses -212,880.00

Leia diretamente a partir dela:

  • Lucro bruto = Receita + Custo das mercadorias vendidas (o custo já é negativo) → 486,200 − 190,540 = 295,660.
  • Resultado líquido = as três linhas somadas → 82,780.
  • Margem bruta % = lucro bruto ÷ receita → ~61%.

A primeira coisa a fazer é conciliá-la: execute a demonstração de resultados do próprio NetSuite para o mesmo mês e confirme que a receita e o resultado líquido coincidem. Se não coincidirem, quase sempre é uma diferença de âmbito — um filtro de subsidiária/moeda, ou o alinhamento entre o período contabilístico e a data da transação (veja a nota sobre períodos). Só confie no pipeline depois de este conciliar.

Passo 5: criar uma antiguidade de contas a receber

Seção intitulada “Passo 5: criar uma antiguidade de contas a receber”

O segundo ganho do primeiro dia segue a mesma forma de ligar, extrair e transformar. Comece pela receita das contas a receber em aberto e, depois, distribua-as por escalões consoante o atraso de cada fatura.

  1. Adicione outro passo Pedido REST (mesma ligação, POST, o endpoint suiteql) com este corpo:

    SELECT
    t.tranid AS invoice_number,
    BUILTIN.DF(t.entity) AS customer,
    TO_CHAR(t.trandate, 'YYYY-MM-DD') AS invoice_date,
    TO_CHAR(t.duedate, 'YYYY-MM-DD') AS due_date,
    t.foreigntotal AS invoice_total,
    t.foreignamountunpaid AS amount_unpaid
    FROM transaction t
    WHERE t.type = 'CustInvc'
    AND t.foreignamountunpaid <> 0
    ORDER BY t.tranid

    Carregue-o como netsuite_open_ar, com invoice_total e amount_unpaid → Moeda, invoice_date e due_date → Data, e o resto → Texto.

  2. Adicione um passo Table Extract que leia netsuite_open_ar para uma nova tabela netsuite_ar_aging. No separador Colunas, clique em Resumir e configure três colunas de destino:

    • aging_bucket — uma expressão (abaixo) que classifica cada fatura consoante o atraso. Resumir Agrupar por.
    • invoices — qualquer coluna, por exemplo invoice_number. Resumir Contagem.
    • balance — mapeada a partir de amount_unpaid. Resumir Soma.

    Para aging_bucket, introduza esta expressão — mede os dias de atraso (uma data menos uma data dá dias) e atribui o escalão:

    case(
    ((func.today() - netsuite_open_ar.due_date) <= 0, '0 - Current'),
    ((func.today() - netsuite_open_ar.due_date) <= 30, '1 - 1-30 days'),
    ((func.today() - netsuite_open_ar.due_date) <= 60, '2 - 31-60 days'),
    ((func.today() - netsuite_open_ar.due_date) <= 90, '3 - 61-90 days'),
    else_='4 - Over 90 days',
    )
  3. Execute-o. netsuite_ar_aging indica-lhe agora, em cinco linhas, quanto está em dia e quanto está em atraso há 30/60/90+ dias — a vista de cobranças que um gestor lê primeiro. (due_date tem de estar com o tipo Data para a subtração de datas funcionar — definiu isso no separador Resposta do passo Pedido REST acima.)

Números numa tabela são aceitáveis; um gráfico é o que se envia ao diretor financeiro. Publique netsuite_pnl e netsuite_ar_aging e depois siga Criar um painel de controlo para adicionar:

  • um gráfico de barras do resultado líquido (ou da receita) por period, e
  • um gráfico circular ou de barras do balance das contas a receber por aging_bucket.

Fica com um painel de controlo financeiro do NetSuite em tempo real — sem exportação, atualizado sempre que o fluxo de trabalho é executado.

  1. Execute o fluxo de trabalho completo uma vez, de cima para baixo, para confirmar que todos os passos ficam verdes.
  2. Agende o fluxo de trabalho — mensalmente, ao ritmo do fecho, ou todas as noites se pretender a antiguidade de contas a receber atualizada em cada manhã.

Como cada extração substitui a tabela inteira, cada execução volta a extrair a fatia definida pela respetiva cláusula WHERE — limite-as à janela de que precisa (o ano corrente, apenas faturas em aberto) em vez de todo o histórico.

A partir de um fluxo de trabalho vazio, extraiu o razão geral e as contas a receber do NetSuite em tempo real, transformou-os numa demonstração de resultados mensal e numa antiguidade de contas a receber com dois passos de transformação padrão — sem SQL —, colocou-os num painel de controlo e configurou-os para se atualizarem — o ciclo de relatórios essencial que uma equipa de finanças executa, agora automatizado.