Integración ERP: Oracle NetSuite
Oracle NetSuite es un ERP 100% en la nube, ampliamente utilizado por empresas en crecimiento. La integración se realiza a través de la REST API de NetSuite, utilizando autenticación Token-Based Authentication (TBA), el método recomendado por Oracle para integraciones.
Este artículo orienta la configuración de la credencial y detalla los informes disponibles de este conector. Para el paso a paso de uso en el flujo de preparación de datos — selección del conector, credencial, informe y parámetros — consulte el artículo Etapa ERP.
Configuración de la Credencial
La autenticación utiliza Token-Based Authentication (TBA) con OAuth 1.0.
Campo | Descripción | Obligatorio |
|---|---|---|
Account ID | ID de la cuenta de NetSuite (ej.: | Sí |
Consumer Key | Clave del consumidor generada en la integración de NetSuite | Sí |
Consumer Secret | Secreto del consumidor | Sí |
Token ID | ID del token de acceso generado para el usuario de integración | Sí |
Token Secret | Secreto del token de acceso | Sí |
Base URL | URL base personalizada, si aplica (opcional) | No |
Cómo obtener las credenciales en NetSuite: 1. Acceda a Setup → Integration → Manage Integrations y cree una nueva integración con TBA habilitado 2. Anote el Consumer Key y Consumer Secret 3. Acceda a Setup → Users/Roles → Access Tokens y genere un token para el usuario de integración 4. El Account ID está disponible en Setup → Company → Company Information
Informes disponibles
Módulo: Administración
Subsidiarias
Devuelve las subsidiarias (empresas) registradas en la cuenta NetSuite.
Parámetros de filtro: Ningún parámetro adicional.
Campos devueltos:
Campo | Descripción |
|---|---|
id | ID interno |
name | Nombre de la subsidiaria |
legalname | Razón social |
country | País |
currency | Moneda principal |
isinactive | ¿Inactiva? |
federalidnumber | CNPJ/EIN |
stateidnumber | Inscripción estatal |
Ubicaciones / Sucursales
Devuelve las ubicaciones (locations) registradas en NetSuite.
Parámetros de filtro: Ningún parámetro adicional.
Campos devueltos:
Campo | Descripción |
|---|---|
id | ID interno |
name | Nombre |
fullname | Nombre completo (con jerarquía) |
isinactive | ¿Inactiva? |
mainaddress | Dirección principal |
Módulo: Inventario
Artículos de inventario
Devuelve el registro de productos y artículos de inventario de NetSuite.
Parámetros de filtro: Ningún parámetro adicional.
Campos devueltos:
Campo | Descripción |
|---|---|
id | ID interno |
itemid | Código del artículo |
displayname | Nombre para mostrar |
itemtype | Tipo de artículo |
baseprice | Precio base |
cost | Costo |
isinactive | ¿Inactivo? |
datecreated | Fecha de creación |
lastmodifieddate | Última modificación |
Módulo: Contabilidad
Plan de cuentas
Devuelve las cuentas contables registradas en NetSuite.
Parámetros de filtro: Ningún parámetro adicional.
Campos devueltos:
Campo | Descripción |
|---|---|
id | ID interno |
acctnumber | Número de cuenta |
acctname | Nombre de la cuenta |
accttype | Tipo de cuenta |
isinactive | ¿Inactiva? |
description | Descripción |
parent | Cuenta padre (jerarquía) |
currency | Moneda |
balance | Saldo actual |
Asientos contables
Devuelve los journal entries de NetSuite.
Parámetros de filtro:
Parámetro | Descripción | Obligatorio |
|---|---|---|
q | Filtro de búsqueda textual (ej.: | No |
Campos devueltos:
Campo | Descripción |
|---|---|
id | ID interno |
tranid | Número del asiento |
trandate | Fecha del asiento |
postingperiod | Período contable |
memo | Historial |
subsidiary | Subsidiaria |
currency | Moneda |
Consulta SuiteQL
Permite ejecutar consultas SQL directamente en la base de datos de NetSuite mediante SuiteQL — formato avanzado para extracción personalizada de datos.
Parámetros:
Parámetro | Descripción | Obligatorio |
|---|---|---|
dtIni | Fecha inicial para uso en la query. Se completa automáticamente con el 1.º día del mes de referencia | No |
dtFim | Fecha final para uso en la query. Se completa automáticamente con el último día del mes de referencia | No |
q | Instrucción SQL SuiteQL. El valor predeterminado devuelve líneas de transacciones del período | Sí |
Query estándar: `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: Cuentas por Cobrar
Clientes
Devuelve el registro de clientes de NetSuite.
Parámetros de filtro: Ningún parámetro adicional.
Campos devueltos:
Campo | Descripción |
|---|---|
id | ID interno |
entityid | Código del cliente |
companyname | Razón social |
vatregnumber | CNPJ/VAT |
phone | Teléfono |
isperson | ¿Es persona física? |
isinactive | ¿Inactivo? |
creditlimit | Límite de crédito |
balance | Saldo deudor |
daysoverdue | Días de atraso |
unbilledorders | Pedidos no facturados |
currency | Moneda |
datecreated | Fecha de creación |
lastmodifieddate | Última modificación |
Facturas de venta
Devuelve las facturas emitidas a clientes.
Parámetros de filtro:
Parámetro | Descripción | Obligatorio |
|---|---|---|
q | Filtro de búsqueda (ej.: | No |
Campos devueltos:
Campo | Descripción |
|---|---|
id | ID interno |
tranid | Número de la factura |
trandate | Fecha de la transacción |
duedate | Fecha de vencimiento |
entity | Cliente |
status | Estado |
statusref | Estado (referencia) |
subtotal | Subtotal |
taxtotal | Total de impuestos |
total | Importe total |
amountremaining | Importe pendiente |
currency | Moneda |
postingperiod | Período contable |
memo | Observación |
Módulo: Cuentas por Pagar
Proveedores
Devuelve el registro de proveedores de NetSuite.
Parámetros de filtro: Ningún parámetro adicional.
Campos devueltos:
Campo | Descripción |
|---|---|
id | ID interno |
entityid | Código del proveedor |
companyname | Razón social |
vatregnumber | CNPJ/VAT |
phone | Teléfono |
balance | Saldo deudor |
currency | Moneda |
isinactive | ¿Inactivo? |
datecreated | Fecha de creación |
lastmodifieddate | Última modificación |
Facturas de compra (Vendor Bills)
Devuelve las facturas recibidas de proveedores.
Parámetros de filtro:
Parámetro | Descripción | Obligatorio |
|---|---|---|
q | Filtro de búsqueda | No |
Campos devueltos: Los mismos que en Facturas de venta (con datos del proveedor como entidad).
Parámetros fijos (gestionados automáticamente)
Parámetro | Valor predeterminado | Motivo |
|---|---|---|
| (lista de campos preconfigurada) | Define los campos devueltos por la API REST de NetSuite, evitando transferir datos innecesarios |
Artículos relacionados
Etapa ERP
Introducción a las integraciones
Integraciones personalizadas vía API Rest y conectores SQL