Integração ERP: Oracle NetSuite
O Oracle NetSuite é um ERP 100% em nuvem, amplamente utilizado por empresas em crescimento. A integração é realizada via REST API do NetSuite, utilizando autenticação Token-Based Authentication (TBA) — o método recomendado pela Oracle para integrações.
Este artigo orienta a configuração da credencial e detalha os relatórios disponíveis deste conector. Para o passo a passo de uso no fluxo de preparação de dados — seleção do conector, credencial, relatório e parâmetros — veja o artigo Etapa ERP.
Configuração da Credencial
A autenticação utiliza Token-Based Authentication (TBA) com OAuth 1.0.
Campo | Descrição | Obrigatório |
|---|---|---|
Account ID | ID da conta NetSuite (ex: | Sim |
Consumer Key | Chave do consumidor gerada na integração do NetSuite | Sim |
Consumer Secret | Segredo do consumidor | Sim |
Token ID | ID do token de acesso gerado para o usuário de integração | Sim |
Token Secret | Segredo do token de acesso | Sim |
Base URL | URL base customizada, se aplicável (opcional) | Não |
Como obter as credenciais no NetSuite: 1. Acesse Setup → Integration → Manage Integrations e crie uma nova integração com TBA habilitado 2. Anote o Consumer Key e Consumer Secret 3. Acesse Setup → Users/Roles → Access Tokens e gere um token para o usuário de integração 4. O Account ID está disponível em Setup → Company → Company Information
Relatórios Disponíveis
Módulo: Administração
Subsidiárias
Retorna as subsidiárias (empresas) cadastradas na conta NetSuite.
Parâmetros de filtro: Nenhum parâmetro adicional.
Campos retornados:
Campo | Descrição |
|---|---|
id | ID interno |
name | Nome da subsidiária |
legalname | Razão social |
country | País |
currency | Moeda principal |
isinactive | Inativa? |
federalidnumber | CNPJ/EIN |
stateidnumber | Inscrição estadual |
Localizações / Filiais
Retorna as localizações (locations) cadastradas no NetSuite.
Parâmetros de filtro: Nenhum parâmetro adicional.
Campos retornados:
Campo | Descrição |
|---|---|
id | ID interno |
name | Nome |
fullname | Nome completo (com hierarquia) |
isinactive | Inativa? |
mainaddress | Endereço principal |
Módulo: Estoque
Itens de Estoque
Retorna o cadastro de produtos e itens de inventário do NetSuite.
Parâmetros de filtro: Nenhum parâmetro adicional.
Campos retornados:
Campo | Descrição |
|---|---|
id | ID interno |
itemid | Código do item |
displayname | Nome de exibição |
itemtype | Tipo de item |
baseprice | Preço base |
cost | Custo |
isinactive | Inativo? |
datecreated | Data de criação |
lastmodifieddate | Última modificação |
Módulo: Contabilidade
Plano de Contas
Retorna as contas contábeis cadastradas no NetSuite.
Parâmetros de filtro: Nenhum parâmetro adicional.
Campos retornados:
Campo | Descrição |
|---|---|
id | ID interno |
acctnumber | Número da conta |
acctname | Nome da conta |
accttype | Tipo de conta |
isinactive | Inativa? |
description | Descrição |
parent | Conta pai (hierarquia) |
currency | Moeda |
balance | Saldo atual |
Lançamentos Contábeis
Retorna os journal entries do NetSuite.
Parâmetros de filtro:
Parâmetro | Descrição | Obrigatório |
|---|---|---|
q | Filtro de busca textual (ex: | Não |
Campos retornados:
Campo | Descrição |
|---|---|
id | ID interno |
tranid | Número do lançamento |
trandate | Data do lançamento |
postingperiod | Período contábil |
memo | Histórico |
subsidiary | Subsidiária |
currency | Moeda |
Consulta SuiteQL
Permite executar consultas SQL diretamente no banco de dados do NetSuite via SuiteQL — formato avançado para extração customizada de dados.
Parâmetros:
Parâmetro | Descrição | Obrigatório |
|---|---|---|
dtIni | Data inicial para uso na query. Preenchido automaticamente com o 1º dia do mês de referência | Não |
dtFim | Data final para uso na query. Preenchido automaticamente com o último dia do mês de referência | Não |
q | Instrução SQL SuiteQL. Valor padrão retorna linhas de transações do período | Sim |
Query padrão: ``sql SELECT id, transaction, linesequencenumber, account, accountname, trandate, debit, credit, amount, memo, postingperiod, recordtype FROM transactionline WHERE trandate >= '{dtIni}' AND trandate <= '{dtFim}' ORDER BY trandate, linesequencenumber ``
Módulo: Contas a Receber
Clientes
Retorna o cadastro de clientes do NetSuite.
Parâmetros de filtro: Nenhum parâmetro adicional.
Campos retornados:
Campo | Descrição |
|---|---|
id | ID interno |
entityid | Código do cliente |
companyname | Razão social |
vatregnumber | CNPJ/VAT |
phone | Telefone |
isperson | É pessoa física? |
isinactive | Inativo? |
creditlimit | Limite de crédito |
balance | Saldo devedor |
daysoverdue | Dias em atraso |
unbilledorders | Pedidos não faturados |
currency | Moeda |
datecreated | Data de criação |
lastmodifieddate | Última modificação |
Faturas de Venda
Retorna as faturas emitidas para clientes.
Parâmetros de filtro:
Parâmetro | Descrição | Obrigatório |
|---|---|---|
q | Filtro de busca (ex: | Não |
Campos retornados:
Campo | Descrição |
|---|---|
id | ID interno |
tranid | Número da fatura |
trandate | Data da transação |
duedate | Data de vencimento |
entity | Cliente |
status | Status |
statusref | Status (referência) |
subtotal | Subtotal |
taxtotal | Total de impostos |
total | Valor total |
amountremaining | Valor em aberto |
currency | Moeda |
postingperiod | Período contábil |
memo | Observação |
Módulo: Contas a Pagar
Fornecedores
Retorna o cadastro de fornecedores do NetSuite.
Parâmetros de filtro: Nenhum parâmetro adicional.
Campos retornados:
Campo | Descrição |
|---|---|
id | ID interno |
entityid | Código do fornecedor |
companyname | Razão social |
vatregnumber | CNPJ/VAT |
phone | Telefone |
balance | Saldo devedor |
currency | Moeda |
isinactive | Inativo? |
datecreated | Data de criação |
lastmodifieddate | Última modificação |
Faturas de Compra (Vendor Bills)
Retorna as faturas recebidas de fornecedores.
Parâmetros de filtro:
Parâmetro | Descrição | Obrigatório |
|---|---|---|
q | Filtro de busca | Não |
Campos retornados: Mesmos de Faturas de Venda (com dados do fornecedor como entidade).
Parâmetros Fixos (gerenciados automaticamente)
Parâmetro | Valor padrão | Motivo |
|---|---|---|
| (lista de campos pré-configurada) | Define os campos retornados pela API REST do NetSuite, evitando trafegar dados desnecessários |
Artigos relacionados
Etapa ERP
Introdução às integrações
Integrações customizadas via API Rest e conectores SQL