VantegrateIntegración nativa por APIIntegrá TOTVS Protheus con agentes de IApara conversar con los datos de tu ERP
Los agentes de IA de Vantegrate se conectan a tu Protheus por su API REST y leen los datos de tu ERP (clientes, productos, pedidos de venta y financiero) para responder en lenguaje natural. En vez de exportar a Excel o esperar un tablero, le preguntás a tus datos y el agente trae el dato vigente. La información sigue viviendo en tu instancia de Protheus.
Cómo fluye el dato
¿Qué significa integrar TOTVS Protheus con los agentes de IA de Vantegrate?
Integrar TOTVS Protheus con los agentes de IA de Vantegrate significa que un agente de datos se conecta a tu ERP por su API REST y consulta tu información real (clientes, productos, pedidos de venta y lanzamientos financieros) para responder preguntas en lenguaje natural. En vez de exportar a Excel o abrir el ERP, le preguntás cuánto tenés por cobrar este mes y el agente trae el dato vigente.
Es distinto de un reporte estático o una exportación manual a un tablero. Acá el agente consulta el dato vigente de tu instancia con el método GET de la API y lo explica en una conversación, sobre la misma base que usa tu equipo. La información de tu negocio queda en tu Protheus, el agente la consulta, no se la lleva a otro lado.
¿Qué querés conectar con tu TOTVS Protheus?
Marcá lo que te interesa y armamos el mensaje por vos.
1 · Elegí qué resolver
2 · Esto le llega al equipo
Vantegrate
en línea
Qué datos lee el agente de tu Protheus
El agente trabaja sobre las tablas estándar de Protheus, de solo lectura para el caso de datos: consulta clientes, productos, pedidos y financiero para responder, sin tocar tu operación contable.
Clientes y vista 360
El agente lee la tabla SA1 (Clientes) y la cruza con pedidos y financiero para responder todo sobre un cliente: saldo, últimos pedidos y situación de pago, consolidado en una respuesta.
Productos y pedidos de venta
Lee SB1 (Productos) y SC5/SC9 (Pedidos de venta) para responder qué pedidos entraron hoy, cuánto se facturó por cliente o qué productos no tienen movimiento, sin abrir el ERP.
Financiero, cobranzas y pagos
Consulta los lanzamientos financieros (cuentas a cobrar y a pagar) para responder cuánto hay por cobrar este mes o qué clientes están vencidos, en lenguaje natural y al instante.
Cómo se integra, paso a paso
Vantegrate se encarga de la configuración y la puesta en marcha. Tu equipo de TI autoriza, valida y empieza a usar.
Habilitar la API REST
Tu equipo habilita el servicio REST en el .ini del Protheus (sección [HTTPREST], con SECURITY=1 para exigir autenticación). En las versiones recientes de la LIB la seguridad ya viene activa por defecto.
Autenticación por token
El agente se autentica con un token Bearer: primero solicita el JWT y luego envía ese token en cada request. Se recomienda HTTPS, OAuth2, IPs restringidas y rate limiting.
Mapear las consultas
Definimos qué tablas y campos consulta el agente (SA1, SB1, SC5/SC9, financiero) con el método GET. Si una consulta no la cubre una API estándar de TOTVS, se evalúa un endpoint custom en ADVPL.
Validación con datos reales
Probamos con tu instancia y tus datos reales, validamos las respuestas con tu equipo de finanzas y de TI, y habilitamos las consultas de forma progresiva.
Conversar con tu Protheus frente a un tablero estático
Protheus expone su integración por una API REST (JSON) nativa y, para casos legados, Web Services SOAP/XML. El catálogo oficial vive en TOTVS Developers (api.totvs.com.br). Vantegrate trabaja con la REST, que es el camino recomendado para una integración moderna: el método GET trae clientes, productos, pedidos de venta y lanzamientos financieros para que el agente los explique en una conversación.
La diferencia con un tablero estático o una exportación manual a Power BI se nota en el día a día. En vez de armar un reporte, exportarlo y leerlo, le preguntás al agente y consulta el dato vigente en el momento. El patrón Power BI sobre Protheus es conocido y válido; lo que cambia acá es la interfaz: en lugar de un panel que hay que abrir e interpretar, una respuesta en español sobre el dato que necesitás.
| Dimensión | Tablero o export manual | Agente de datos de Vantegrate |
|---|---|---|
| Interfaz | Panel que hay que abrir e interpretar | Pregunta en español, respuesta directa |
| Conexión | Export por lotes o copia a un BI | API REST de Protheus, método GET |
| Frescura del dato | Hasta la última actualización del panel | Estado vigente de tu instancia, al consultar |
| Acceso al dato | Depende de TI o de saber el reporte | El equipo pregunta, sin saber dónde mirar |
| Datos | Salen a una herramienta externa | Quedan en tu Protheus, el agente los consulta |
Comparación de patrones de consulta; el alcance exacto se define con tu equipo según tu versión de Protheus y tus tablas habilitadas.
Tus datos quedan en tu instancia: el agente consulta tu Protheus por la API, no copia tu base a otro lado. La conexión usa un token de acceso acotado y cada consulta queda registrada. Para el caso de datos, el agente lee y explica; no modifica tu operación contable.
Qué cubre la API y qué tener en cuenta
La API REST de Protheus devuelve lotes limitados de filas: es ideal para responder una pregunta puntual en el momento, pero no es la vía más eficiente para extraer grandes volúmenes como lo haría una consulta SQL directa. Por eso el agente de datos brilla en la consulta conversacional (un cliente, un saldo, los pedidos de hoy) más que en mover millones de filas a un data warehouse, que es otro tipo de proyecto.
Dos puntos más de transparencia. Primero, las APIs estándar de TOTVS pueden no cubrir todas las necesidades específicas; cuando hace falta, se desarrolla un endpoint REST custom en ADVPL dentro del Protheus, lo que requiere conocimiento técnico del ERP. Segundo, el valor fiscal diferencial de Protheus (eSocial, SPED, Bloco K) está atado a las obligaciones de Brasil; en otros países de la región el ERP existe, pero no afirmamos paridad de esos módulos fiscales.
Sobre el mantenimiento: configurar y mantener la API requiere conocimiento técnico de Protheus, y los cambios en el ERP (actualizaciones, cambios de estructura de datos) pueden afectar los endpoints. La integración se diseña con eso en cuenta, con consultas acotadas y monitoreo.
Ya viste cómo se conecta. ¿Lo vemos con tu caso?
Contanos cómo está armado tu TOTVS Protheus y te decimos qué datos necesitamos y por dónde se conecta el agente.
Un agente conectado a tu TOTVS Protheus vs. una herramienta suelta
| Herramienta de IA aislada | Agente integrado a tu TOTVS Protheus | |
|---|---|---|
| Fuente del dato | Copia que se desfasa | Tu fuente de verdad, en vivo |
| Dónde quedan tus datos | En un sistema de terceros | En tu entorno, cifrados de extremo a extremo |
| Resultado de cada operación | Atrapado en otra app | Vuelve a tu TOTVS Protheus |
| Permisos y trazabilidad | Genéricos, poco auditables | Scope mínimo y registro auditable |
| Llega a producción | Suele quedar en piloto | Activación progresiva validada |
Por qué conversar con los datos en vez de exportarlos
Cifra de terceros, con fuente publicada, para dimensionar el contexto. No es un resultado propio de Vantegrate.
95%
De los pilotos de IA generativa, la mayoría no llega a producción con impacto medible en el negocio
Fuente: MIT NANDA, The GenAI Divide (2025)
El dato de MIT NANDA refleja la brecha entre experimentar y operar agentes de IA en producción. La forma de cruzar esa brecha es conectar el agente a una fuente de datos real, como tu Protheus, en lugar de un piloto aislado.
Qué agentes corren sobre tu Protheus
Cada producto de la Suite usa la misma integración por la API REST: trabaja con los datos de tu instancia y deja la información en tu ERP.
Metrix
Agente de datos: tu equipo pregunta en español por clientes, pedidos, stock o saldos financieros y obtiene respuestas sobre los datos reales de tu Protheus, sin reportes estáticos ni depender de TI.
Conocer Metrix
Sellium
Agente de ventas por WhatsApp: cuando el cliente escribe, consulta tu Protheus por estado de un pedido, disponibilidad o precio vigente, y responde con el dato real sin que tu equipo abra el ERP.
Conocer SelliumLa integración no se lleva tus datos a ningún lado
El principio es simple: la IA viene a tu dato, no tu dato a la IA. El agente consulta tu Protheus por su API REST, con un token de acceso acotado, y corre sobre infraestructura cloud certificada.
- Conexión por la API REST de Protheus con token Bearer (JWT), con HTTPS, OAuth2 e IPs restringidas como práctica recomendada.
- El agente consulta clientes, productos, pedidos y financiero; para el caso de datos lee y explica, sin tocar tu operación contable.
- Acceso acotado por token y permisos mínimos, con cada consulta registrada; tu base queda en tu instancia de Protheus.
- Los agentes corren sobre infraestructura certificada SOC 2 e ISO 27001 (la de la infraestructura sobre la que corre Vantegrate, no la de TOTVS).
Agentes de IA seguros
Los agentes de Vantegrate corren sobre infraestructura cloud certificada SOC 2 Type II e ISO 27001. Esas certificaciones cubren la tecnología de Vantegrate, no tu propio entorno: vos operás y certificás tu plataforma, con permisos mínimos y trazabilidad completa.
Conocé el modelo de seguridadPreguntas frecuentes sobre la integración con TOTVS Protheus
Lo que suelen preguntar los equipos de finanzas y de TI antes de conectar un agente de IA a su ERP.
¿TOTVS Protheus tiene API para integrar?
¿TOTVS Protheus tiene API para integrar?
Sí. Protheus expone una API REST (JSON) nativa para integraciones modernas y también Web Services SOAP/XML para casos legados. El catálogo oficial de APIs está en TOTVS Developers (api.totvs.com.br). Vantegrate trabaja con la REST, que es el camino recomendado para conectar un agente de datos a tu ERP. Conocé el agente en Metrix.
¿Cómo se autentica la integración con Protheus?
¿Cómo se autentica la integración con Protheus?
Con un token Bearer: el agente primero solicita un JWT y luego lo envía en el header de cada request. La seguridad se habilita en el archivo .ini del Protheus, en la sección [HTTPREST] con SECURITY=1 (en las versiones recientes de la LIB ya viene activa por defecto). Se recomienda HTTPS, OAuth2, IPs restringidas y rate limiting.
¿Puedo sacar todos mis datos por la API para un tablero?
¿Puedo sacar todos mis datos por la API para un tablero?
Con matices. La API REST devuelve lotes limitados de filas, así que es ideal para responder una pregunta puntual en el momento, pero no es la vía más eficiente para extraer grandes volúmenes como lo haría una consulta SQL directa. Para un data warehouse o BI de mucho volumen se suelen combinar otros métodos; el agente de datos brilla en la consulta conversacional.
¿Las APIs estándar de TOTVS alcanzan para mi caso?
¿Las APIs estándar de TOTVS alcanzan para mi caso?
A veces sí, a veces no. Las APIs estándar de TOTVS cubren los datos centrales (clientes, productos, pedidos, financiero), pero pueden no alcanzar para necesidades muy específicas. En ese caso se desarrolla un endpoint REST custom en ADVPL dentro del Protheus, lo que requiere conocimiento técnico del ERP. Lo evaluamos en el análisis inicial con tu equipo.
Metrix, agente de datos
Cómo tu equipo pregunta en español y obtiene respuestas sobre los datos reales de tu ERP, sin reportes estáticos.
Ver másTodas las integraciones
El mapa completo: con qué ERP, CRM y herramientas se conectan los agentes de IA.
Ver másAgentes de IA para empresas
El mapa de la Suite Vantegrate: ventas, marketing, documentos, datos y logística.
Ver másConectemos los agentes de IA a tu TOTVS Protheus
Contanos qué datos de tu Protheus querés consultar y te mostramos cómo se conecta el agente por la API REST, qué token y permisos pedimos y cómo queda la consulta en lenguaje natural. Una conversación de 30 minutos, sin compromiso.