# Integración de Oracle NetSuite con WhatsApp y agentes de IA, a medida

> Integración a medida de Oracle NetSuite con tu agente de IA de WhatsApp vía SuiteTalk REST y OAuth 2.0: existencias por ubicación, clientes y pedidos de venta.

- URL: https://www.soyagentia.com/integraciones/oracle-netsuite-whatsapp/
- Actualizado el 20 de octubre de 2026
- Revisado por Alejandro Díaz, CEO de Agent IA SAS
- SoyAgentia (Agent IA SAS, NIT 901.976.734-4)

## En resumen

- Desarrollamos a medida el conector entre tu NetSuite y el agente de IA de SoyAgentia, para que en WhatsApp consulte existencias por ubicación, encuentre al cliente y registre cotizaciones o pedidos de venta.
- La conexión usa SuiteTalk REST Web Services, con registros en JSON y consultas SuiteQL, autenticada con OAuth 2.0, el método que Oracle recomienda.
- No usamos SOAP: Oracle anunció que desde la versión 2027.1 no se podrán crear integraciones SOAP nuevas y que SOAP se retira en la 2028.2.
- No es un conector que se activa con un clic: se define el alcance contigo, se prueba en tu sandbox y se cotiza aparte del plan.

En NetSuite ya está lo que tu cliente pregunta por WhatsApp: cuántas unidades hay disponibles en cada ubicación, su nivel de precio, el estado de su pedido y lo que tiene vencido. La integración a medida conecta el agente de IA de SoyAgentia con la API REST de tu cuenta para que responda con esos datos y registre las transacciones que acuerdes.

Aquí verás qué registros de NetSuite usa el agente, cómo se autentica, qué límites aplica Oracle y cómo trabajamos el proyecto. Si tienes otro ERP, revisa [integraciones con ERP](https://www.soyagentia.com/integraciones/erp/).

## Qué puede hacer el agente de IA conectado a Oracle NetSuite

Cada operación usa un registro que la API REST de NetSuite soporta. Con ellos, el agente puede:

- Consultar la disponibilidad de un artículo por ubicación en el registro inventoryItem, cuya sublista locations trae la cantidad disponible (quantityAvailable) y la cantidad en mano (quantityOnHand).
- Leer el precio del artículo en su sublista de precios, por nivel de precio, moneda y cantidad, si tienes activadas las funciones de monedas múltiples, precios múltiples y precios por cantidad.
- Buscar al cliente en el registro customer por su correo o su teléfono, con el filtro q o con una consulta SuiteQL, y crearlo con un POST si no existe y así lo acordamos.
- Registrar una cotización (estimate) o un pedido de venta (salesOrder) con los artículos y cantidades del chat, y devolver al cliente su número de pedido (tranId).
- Consultar el estado de un pedido o de una factura (invoice) y, si se incluye en el alcance, el saldo y el saldo vencido del cliente (balance y overdueBalance).

## Cómo se conecta: SuiteTalk REST Web Services

SuiteTalk REST Web Services es la API REST de NetSuite: permite crear, leer, actualizar y borrar registros en JSON en /services/rest/record/v1/, y ejecutar consultas SuiteQL con un POST a /services/rest/query/v1/suiteql, con hasta 100.000 resultados. A diferencia de los RESTlets, no exige escribir ni desplegar scripts en tu cuenta. El resumen está en la [documentación de REST Web Services](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/chapter_1540391670.html).

REST no admite inicio de sesión con usuario y contraseña: se autentica con OAuth 2.0 o con autenticación por token (TBA), y Oracle prefiere OAuth 2.0. Para un conector de servidor a servidor usamos el flujo client credentials (M2M): tu administrador crea un registro de integración y asocia una entidad, un rol y nuestro certificado público en la configuración de OAuth 2.0. El detalle está en [configurar la autenticación](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_0627022005.html).

Oracle está retirando SOAP: el endpoint 2025.2 es el último planeado, desde la 2027.1 no se podrán crear integraciones SOAP nuevas y en la 2028.2 dejarán de funcionar todas, según sus [preguntas sobre el retiro de SOAP](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_2104046421.html). Si algún caso no se puede resolver con REST, Oracle indica usar RESTlets de SuiteScript.

Las peticiones de web services y RESTlets comparten un límite de concurrencia por cuenta. La base depende de tu nivel de servicio (5 en Standard, 15 en Premium, 20 en Enterprise y Ultimate) y sube 10 por cada licencia SuiteCloud Plus, según la [tabla de límites de Oracle](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/bridgehead_1500275603.html). Si se supera, NetSuite devuelve un error y el conector reintenta.

## Lo que necesitas tener en Oracle NetSuite

Revisa estos puntos con tu administrador o tu partner de NetSuite:

- La función REST Web Services activada en la pestaña SuiteCloud de Enable Features, con los términos de SuiteCloud aceptados.
- Un rol propio para la integración con el permiso REST Web Services y acceso solo a los registros acordados; Oracle no recomienda usar el rol de administrador para integraciones.
- SuiteTax activado si los pedidos llevan impuestos: REST no admite las funciones de impuestos heredadas.
- Una cuenta sandbox, que se compra aparte y contiene una copia de tus datos de producción, para desarrollar y probar sin tocarlos.
- Margen en tu límite de concurrencia, que puedes ver en la página Integration Governance, porque lo comparten todas tus integraciones.

## Cómo trabajamos la integración a medida

El proyecto sigue cinco pasos:

- Diagnóstico: definimos qué consulta y qué registra el agente, con qué registros y consultas SuiteQL, qué ubicaciones y niveles de precio usa y en qué canales.
- Acceso: tu administrador crea en el sandbox el registro de integración, el rol y el mapeo del certificado para el flujo M2M.
- Desarrollo: construimos el conector y las reglas del agente: qué ubicación consulta, cuándo crea la cotización o el pedido y cuándo pasa la conversación a una persona.
- Pruebas: validamos con conversaciones reales en el sandbox hasta que las transacciones salgan como las registra tu equipo.
- Puesta en marcha: repetimos la configuración de OAuth 2.0 en producción, revisamos contigo los primeros pedidos y monitoreamos errores y concurrencia.

## Límites y decisiones de diseño

Para que no haya sorpresas:

- No es un conector listo: se desarrolla para tu NetSuite y se cotiza aparte del plan del agente. SoyAgentia no es partner de Oracle.
- El agente no toca la contabilidad: no registra pagos, notas crédito ni transforma pedidos en facturas, salvo que se defina expresamente en el alcance.
- La API REST no crea registros en bloque: el agente registra una transacción por petición.
- El mapeo del flujo client credentials no se copia al sandbox y se borra en cada actualización del sandbox, así que hay que repetirlo después de cada refresco.
- Oracle NetSuite es una marca de Oracle Corporation. SoyAgentia no está afiliada a Oracle Corporation.

## Preguntas frecuentes

### ¿Por qué la integración usa REST y no SOAP?

Porque Oracle presenta SuiteTalk REST como el reemplazo de SOAP y recomienda REST con OAuth 2.0 para toda integración nueva desde la versión 2026.1. Desde la 2027.1 ya no se podrán crear integraciones SOAP nuevas.

### ¿Tengo que darles un usuario y contraseña de NetSuite?

No. La API REST no acepta usuario y contraseña. El conector usa OAuth 2.0 con un certificado que tu administrador asocia a un rol de integración, y puede revocarlo cuando quiera.

### ¿La integración afecta a mis otras integraciones con NetSuite?

Comparte con ellas el límite de concurrencia de tu cuenta. En el diagnóstico revisamos ese límite en Integration Governance y diseñamos el conector para hacer pocas llamadas por conversación y reintentar si NetSuite rechaza una petición.

### ¿Puedo probar todo en mi sandbox antes de producción?

Sí, y es lo recomendable. El sandbox tiene el mismo límite de concurrencia que producción y una copia de tus datos. Solo hay que configurar OAuth 2.0 allí por separado.

### ¿Cómo se cotiza la integración con Oracle NetSuite?

Según los registros y operaciones que definamos en el diagnóstico, aparte del plan del agente que ves en [planes](https://www.soyagentia.com/pricing/). Las licencias de NetSuite y de SuiteCloud Plus siguen siendo tuyas con Oracle. Pídela en [cotizar](https://www.soyagentia.com/cotizar/).

## Sigue leyendo

- [Integraciones con ERP a medida](https://www.soyagentia.com/integraciones/erp/)
- [Todas las integraciones](https://www.soyagentia.com/integraciones/)
- [Agentes de IA para WhatsApp](https://www.soyagentia.com/agentes-ia-whatsapp/)
- [Integración de SAP Business One con WhatsApp](https://www.soyagentia.com/integraciones/sap-business-one-whatsapp/)
- [Integración de SAP S/4HANA con WhatsApp](https://www.soyagentia.com/integraciones/sap-s4hana-whatsapp/)
- [Cotizar una integración a medida](https://www.soyagentia.com/cotizar/)
