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.
Pré-requisitos
Seção intitulada “Pré-requisitos”- 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.
Passo 1: criar um fluxo de trabalho
Seção intitulada “Passo 1: criar um fluxo de trabalho”O fluxo de trabalho é o pipeline que extrai e transforma os dados.
- Abra o seu projeto e mude para o separador Fluxos de trabalho.
- Clique em Novo fluxo de trabalho, dê-lhe um nome como
NetSuite Financialse abra-o.
Passo 2: extrair o razão geral
Seção intitulada “Passo 2: extrair o razão geral”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.
-
Adicione um passo Pedido REST. No separador Pedido, defina Ligação como a sua ligação NetSuite, Método como
POSTe Endpoint como/services/rest/query/v1/suiteql. -
No Corpo, coloque este SuiteQL envolvido como
{"q": "…"}:SELECTTO_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 amountFROM transactionaccountingline talJOIN transaction t ON t.id = tal.transactionJOIN account a ON a.id = tal.accountWHERE tal.posting = 'T'AND tal.accountingbook = 1AND 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 -
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 somaramount.) -
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.
-
Adicione um passo Table Extract. Defina a sua Origem como
netsuite_gle o seu Destino como uma nova tabela,netsuite_pnl. -
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 deIncome,OthIncome,COGS,Expense,OthExpense. -
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ãonetsuite_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çãocasedo 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'),) -
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.
Passo 4: leia-a como um profissional de finanças
Seção intitulada “Passo 4: leia-a como um profissional de finanças”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.
-
Adicione outro passo Pedido REST (mesma ligação,
POST, o endpoint suiteql) com este corpo:SELECTt.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_unpaidFROM transaction tWHERE t.type = 'CustInvc'AND t.foreignamountunpaid <> 0ORDER BY t.tranidCarregue-o como
netsuite_open_ar, cominvoice_totaleamount_unpaid→ Moeda,invoice_dateedue_date→ Data, e o resto → Texto. -
Adicione um passo Table Extract que leia
netsuite_open_arpara uma nova tabelanetsuite_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 exemploinvoice_number. Resumir Contagem.balance— mapeada a partir deamount_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',) -
Execute-o.
netsuite_ar_agingindica-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_datetem de estar com o tipo Data para a subtração de datas funcionar — definiu isso no separador Resposta do passo Pedido REST acima.)
Passo 6: colocá-la num painel de controlo
Seção intitulada “Passo 6: colocá-la num painel de controlo”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
balancedas contas a receber poraging_bucket.
Fica com um painel de controlo financeiro do NetSuite em tempo real — sem exportação, atualizado sempre que o fluxo de trabalho é executado.
Passo 7: agendar a atualização
Seção intitulada “Passo 7: agendar a atualização”- Execute o fluxo de trabalho completo uma vez, de cima para baixo, para confirmar que todos os passos ficam verdes.
- 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.
O que construiu
Seção intitulada “O que construiu”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.
Próximos passos
Seção intitulada “Próximos passos”- Exemplos de consultas SuiteQL do NetSuite — balancete, balanço, encomendas de venda em aberto, encomendas de compra e inventário para adicionar ao mesmo fluxo de trabalho.
- Passo Table Extract e Utilização avançada do Data Mapper — agrupamento, filtragem e colunas calculadas para uma análise mais profunda.
- Conceber uma hierarquia da dimensão — agregue o seu plano de contas em grupos de relato que controla.
- Criar um painel de controlo — o guia completo do painel de controlo.