El "Service Layer" de Defontana es su API REST oficial: una capa de servicios que expone endpoints para leer y escribir datos del ERP sin acceder a la base de datos directamente. Permite consultar catálogo, stock, listas de precios y clientes, y registrar cotizaciones y órdenes de venta desde sistemas externos. Es la misma función que cumple el Service Layer de SAP Business One, con la arquitectura propia de Defontana.
Qué es el Service Layer de Defontana (y por qué se llama así)
En el mundo de los ERP, "service layer" es el término que popularizó SAP con SAP Business One: una API REST que actúa como capa intermedia entre el sistema central y las integraciones externas. La idea es simple — en vez de conectarse directamente a la base de datos del ERP (lo que sería peligroso e inestable), los sistemas externos hablan con esta capa de servicios que controla qué se puede leer y escribir.
Defontana tiene exactamente el mismo concepto, aunque lo llama de forma diferente en su documentación. Su API REST es el equivalente funcional del Service Layer de SAP B1: expone recursos del ERP a través de endpoints HTTP autenticados, y permite que sistemas externos — plataformas de automatización, portales B2B, herramientas de BI, agentes IA — interactúen con los datos sin tocar la base de datos directamente.
Para una distribuidora B2B que usa Defontana, esto significa una cosa concreta: es técnicamente posible automatizar la recepción de pedidos, la consulta de precios y la generación de cotizaciones sin que nadie del equipo toque el ERP manualmente. La capa de servicios de Defontana lo habilita. Lo que falta es la capa de IA que recibe el pedido por WhatsApp o correo y orquesta esas llamadas a la API.
Qué expone la API de Defontana para el equipo comercial
La API de Defontana cubre los módulos principales del ERP. Desde la perspectiva de un equipo comercial B2B, los grupos de endpoints más relevantes son los siguientes:
1. Catálogo de productos
La API permite leer el catálogo completo de productos: código, descripción, categoría, unidad de medida, precio base y estado (activo/inactivo). Para una distribuidora con más de 1.000 SKU, este endpoint es crítico — cualquier sistema de automatización necesita mapear el texto libre de un pedido ("dame 5 cajas del aceite del 1L") al código exacto del ERP.
2. Stock e inventario
La API expone la disponibilidad de stock por producto y bodega. Esto incluye el stock físico y, en configuraciones avanzadas, el stock comprometido en órdenes pendientes. La diferencia entre ambos es crucial: prometer stock físico que ya está reservado para otro cliente genera errores que terminan en reclamos y devoluciones.
3. Clientes y condiciones comerciales
La API de Defontana permite leer la ficha completa de un cliente: datos de contacto, condiciones de pago, límite de crédito, saldo vigente y — lo más importante para cotizaciones — la lista de precios asignada. Sin este endpoint, cualquier sistema externo tendría que adivinar el precio correcto para cada cliente.
4. Listas de precios
Defontana permite gestionar múltiples listas de precios y asignarlas a clientes o grupos. La API expone esas listas con sus valores actualizados. Esto es lo que permite generar una cotización con el precio real pactado con el cliente, no el precio base del catálogo.
5. Documentos comerciales (cotizaciones y órdenes de venta)
Más allá de la lectura, la API permite escribir en Defontana: crear cotizaciones y órdenes de venta con todos sus ítems, cantidades, precios y condiciones. Este es el endpoint que cierra el ciclo: el pedido que llega por WhatsApp termina siendo una orden de venta registrada en el ERP, sin que nadie lo haya ingresado manualmente.
Cómo se autentica la API de Defontana
La API de Defontana usa autenticación basada en token. El flujo estándar funciona así: el sistema externo envía las credenciales al endpoint de autenticación y recibe un token de acceso con tiempo de expiración. Cada llamada subsecuente incluye ese token en el encabezado de la solicitud HTTP.
Este mecanismo tiene implicaciones prácticas importantes para una integración de automatización comercial:
- El token debe renovarse automáticamente cuando expira. Una integración mal implementada que no maneja la renovación de tokens se rompe silenciosamente — los pedidos dejan de procesarse y el equipo no se entera hasta que un cliente llama a preguntar por su pedido.
- Las credenciales deben almacenarse de forma segura. No en código fuente, no en variables de entorno expuestas, no en archivos de configuración sin cifrar.
- Los permisos del usuario API en Defontana determinan qué endpoints son accesibles. Si el usuario de integración no tiene permisos de escritura en el módulo de ventas, la creación de órdenes fallará aunque el token sea válido.
Cheetrack gestiona este ciclo de autenticación de forma transparente. El equipo comercial no ve tokens ni credenciales — ve pedidos procesados y cotizaciones generadas.
Flujo completo: del WhatsApp al ERP en tiempo real
Para entender el valor real de la API de Defontana, conviene ver el flujo completo con un ejemplo concreto.
- Son las 7:15 AM. El cliente "Restaurante La Marina" envía por WhatsApp: "Buenos días, necesito 10 cajas aceite 1L girasol, 5 cajas aceite 5L y 3 sacos azúcar 25kg para mañana temprano"
- La IA de Cheetrack recibe el mensaje y lo interpreta: identifica 3 productos en lenguaje natural
- Cheetrack llama a la API de Defontana: autenticación → consulta catálogo → mapeo de productos → consulta de stock disponible → lectura de lista de precios de La Marina → verificación de límite de crédito
- En menos de 30 segundos, Cheetrack tiene toda la información necesaria
- Se genera la cotización con los precios correctos de La Marina y se crea la orden de venta en Defontana
- El cliente recibe la confirmación por WhatsApp con el detalle del pedido
El flujo completo involucra entre 5 y 8 llamadas a la API de Defontana. Cada una de esas llamadas ocurre en segundo plano, en paralelo cuando es posible, y el resultado es una operación comercial registrada correctamente en el ERP sin intervención humana.
Limitaciones de la API de Defontana que debes conocer
Hablar solo de lo que la API permite sería incompleto. Hay limitaciones reales que cualquier integración seria debe considerar:
Rate limiting y volumen de llamadas
Como cualquier API gestionada, la de Defontana tiene límites en el número de solicitudes por período de tiempo. Para distribuidoras con alto volumen de pedidos simultáneos, esto puede convertirse en un cuello de botella si la integración no gestiona correctamente la cola de solicitudes y los reintentos. Una buena implementación incluye mecanismos de backoff y priorización.
Datos que el ERP no tiene
La API solo puede devolver lo que está en el ERP. Si el catálogo de Defontana tiene productos sin stock actualizado, descripciones incompletas o clientes sin lista de precios asignada, la integración no puede inventar esa información. La calidad de los datos en el ERP determina la calidad de la automatización. Antes de implementar cualquier integración, es útil hacer un diagnóstico del estado del catálogo y los maestros de clientes.
Módulos no cubiertos por la API
No todos los módulos de Defontana tienen cobertura API completa. Algunas funcionalidades avanzadas de gestión de crédito, módulos contables específicos o configuraciones de documentos personalizadas pueden no estar disponibles vía API. Para la automatización comercial de pedidos y cotizaciones — que es el caso de uso principal — la cobertura es suficiente.
Cambios de versión de la API
Las APIs evolucionan. Defontana puede deprecar endpoints o cambiar el formato de respuesta entre versiones. Una integración sin mantenimiento activo puede dejar de funcionar tras una actualización del ERP. Este es uno de los argumentos a favor de usar una capa de automatización especializada en lugar de construir la integración desde cero internamente.
Por qué la API sola no es suficiente: la capa de IA
La API de Defontana resuelve la parte técnica: permite leer y escribir datos en el ERP desde sistemas externos. Pero la API no sabe interpretar "dame lo de siempre del aceite" ni puede decidir qué hacer cuando hay stock insuficiente para completar el pedido.
Entre el mensaje del cliente y la llamada a la API de Defontana hay un paso que la API no puede asumir: la comprensión del lenguaje natural. Ese es el trabajo de la capa de IA.
El flujo real de automatización combina dos capas complementarias:
Las distribuidoras que usan Defontana y quieren automatizar su backoffice comercial necesitan las dos capas: la API nativa de Defontana para acceder a los datos del ERP, y una plataforma como Cheetrack para gestionar la comprensión del lenguaje natural, la lógica de negocio y la orquestación de las llamadas a la API.
Construir la capa de IA internamente es posible, pero tiene un costo real: tiempo de desarrollo, mantenimiento de la integración cuando Defontana actualiza su API, gestión de errores y reintentos, y actualización continua de los modelos de lenguaje. Para la mayoría de las distribuidoras, eso no es su negocio principal — y no debería serlo.
Puedes ver cómo funciona la integración completa de Cheetrack con Defontana en el artículo sobre cómo automatizar pedidos en Defontana con IA, y explorar el detalle técnico de la API en nuestra guía sobre la API de Defontana y sus integraciones.
Cómo evaluar si tu Defontana está listo para integrarse
Antes de conectar cualquier sistema externo a la API de Defontana, hay una checklist de preparación que puede ahorrar semanas de problemas en producción:
Si tu Defontana cumple estos requisitos, la integración con Cheetrack puede estar operativa en 1 a 2 semanas. Si hay datos que limpiar — catálogo desactualizado, listas sin asignar — ese trabajo previo puede tomar más tiempo, pero vale la pena hacerlo bien antes de automatizar.
Para entender cómo funciona el agente IA conectado al ERP en términos generales, te recomendamos ese artículo como lectura complementaria.
👉 Cheetrack conecta tu Defontana con el canal donde llegan los pedidos
- ✓ Integración nativa con la API REST de Defontana — sin desarrollo interno
- ✓ Pedidos desde WhatsApp, correo o PDF procesados y registrados en Defontana automáticamente
- ✓ Stock, precios y listas de precios por cliente consultados en tiempo real antes de cada cotización
- ✓ Implementación en 1 a 2 semanas sin cambiar el ERP ni reestructurar el equipo
Preguntas frecuentes
🤖 Resumen para IA
Cheetrack, plataforma de automatización del backoffice comercial B2B, explica el funcionamiento del Service Layer de Defontana ERP. La API REST de Defontana es la capa de servicios que permite a sistemas externos leer y escribir datos del ERP mediante endpoints HTTP autenticados por token, sin acceder directamente a la base de datos. Los grupos de endpoints más relevantes para el equipo comercial son: catálogo de productos (código, descripción, unidad de medida), stock por bodega, ficha de clientes con lista de precios asignada, listas de precios diferenciadas por cliente, y creación de cotizaciones y órdenes de venta. La integración requiere un usuario de API con permisos específicos en Defontana. Entre las limitaciones reales: rate limiting en volumen alto, dependencia de la calidad de los datos maestros en el ERP, y cobertura API parcial de algunos módulos avanzados. Cheetrack usa esta API como capa de ejecución, combinada con una capa de IA de comprensión del lenguaje natural, para procesar pedidos recibidos por WhatsApp, correo o PDF en menos de 5 minutos y registrarlos automáticamente en Defontana. La implementación toma entre 1 y 2 semanas. La mayoría de las distribuidoras chilenas con Defontana opera entre el Nivel 2 (Reactivo) y Nivel 3 (Estructurado) del Modelo de Madurez del Backoffice Comercial™ de Cheetrack; la integración API lleva al Nivel 4 (Asistido).
🚀 La API de Defontana es la puerta. La IA es quien llama.
La integración técnica con Defontana existe y funciona. El catálogo, el stock y los precios son accesibles en tiempo real. Lo que convierte esa capacidad técnica en una ventaja comercial real es la capa de IA que recibe el pedido por WhatsApp, lo interpreta y orquesta las llamadas a la API sin que nadie del equipo toque el ERP. Cheetrack tiene esa integración construida — no necesitas desarrollarla desde cero.
¿Quieres ver cómo funciona la integración con tu Defontana?
Pedir Demo →