Integración Defontana con tu sistema en Chile: API, webhooks y sincronización

Defontana expone una API REST con autenticación OAuth-like (cliente, clave, ID empresa) que permite leer y escribir las entidades centrales del ERP: clientes, productos, listas de precio, bodegas, stock, facturas, boletas, notas de crédito, recibos, libro de compras y libro de ventas. Una integración típica con e-commerce (Shopify, WooCommerce, Magento, VTEX) sigue cuatro flujos: (1) producto: catálogo y stock fluyen desde Defontana hacia la tienda online cada N minutos, evitando que vendas mercadería no disponible; (2) pedido: cuando se confirma una venta en el e-commerce, se crea automáticamente la factura o boleta electrónica en Defontana con el cliente correcto, items, precios e impuestos; (3) pago: el estado del pago de Webpay/Mercado Pago/Khipu se propaga al ERP para conciliación; (4) post-venta: notas de crédito por devoluciones, cambios de dirección y actualizaciones de cliente se reflejan en ambos lados. En Blackend construimos esta capa de sincronización con cola persistente, reintentos con back-off y dashboard de salud, de modo que cualquier caída temporal de Defontana o de la tienda no rompa el flujo: los eventos se encolan y se reprocesan automáticamente. El alcance se cierra después de un discovery de 1-2 semanas donde mapeamos campos exactos, casos borde (productos con variantes, descuentos por línea, despachos parciales) y volumen transaccional esperado.

En el mercado chileno, una integración punto a punto entre Defontana y un sistema externo estándar (Shopify, WooCommerce, HubSpot, un POS propio bien diseñado) parte desde $4.500.000 CLP y llega hasta $12.000.000 CLP según número de entidades sincronizadas, frecuencia y manejo de errores. El rango se mueve por: (1) cantidad de flujos: solo lectura de catálogo es barato; sincronización bidireccional de clientes, productos, ventas, pagos y devoluciones es más caro; (2) volumen transaccional: 500 documentos/mes es distinto a 50.000/mes en términos de paralelismo, rate-limit y arquitectura; (3) lógica de negocio: descuentos por cliente, listas de precio múltiples, IVA diferenciado, multi-bodega y multi-empresa suben el costo; (4) SLA esperado: batch nocturno es más barato que tiempo real con failover. A esto se suma un mantenimiento mensual de entre $300.000 y $900.000 CLP que cubre monitoreo, alertas, adaptaciones por cambios en la API de Defontana y bolsa de horas evolutivas. Una integración con marketplace (Mercado Libre, Falabella, Ripley) o con un sistema BI/CRM corporativo (Salesforce, Power BI, Looker) se ubica entre $8.000.000 y $20.000.000 CLP por la complejidad de mapeo y el volumen de datos.

La API de Defontana cubre las entidades centrales que necesita una operación comercial chilena: clientes (RUT, razón social, giro, dirección, contactos, límite de crédito, condición de pago), productos (SKU, nombre, descripción, costo, precio, IVA, categorías, listas alternativas), inventario (stock por bodega, movimientos, ajustes, reservas), ventas (factura 33, factura exenta 34, boleta 39, boleta exenta 41, nota de crédito 61, nota de débito 56, guía de despacho 52), compras (factura de compra recibida, pagos a proveedores), cuentas por cobrar y por pagar, recibos de pago, libros de compraventa y reportes para fiscalización SII. Esto significa que prácticamente cualquier flujo operativo se puede integrar: e-commerce, POS, marketplace, CRM, BI, conciliación bancaria, sistema de despacho, dashboard ejecutivo. Lo que no expone la API se puede resolver con exportes programados (CSV/Excel descargados desde Defontana y procesados por un ETL nuestro) o con reportes custom dentro del propio Defontana cuando el cliente tiene plan que lo permita. La pregunta clave no es qué se puede integrar, sino qué tiene sentido integrar: a veces conviene que ciertos procesos sigan en Defontana sin sincronizarse, para no duplicar fuentes de verdad ni complicar la operación.

No somos Defontana ni reseller, ni implementamos el ERP. Un implementador o partner oficial de Defontana te ayuda a configurar el ERP: parametrizar el plan de cuentas, definir centros de costo, capacitar al equipo contable, configurar reportes, migrar saldos iniciales, gestionar licencias. Esa pieza la entrega Defontana directamente o sus partners certificados, y es indispensable si recién estás partiendo con el ERP. Un partner de integración como Blackend opera en el lado opuesto: tú ya tienes Defontana funcionando (lo usaste como gestión contable, tributaria y comercial durante años) y necesitas conectarlo con otros sistemas que tu empresa también ya tiene: e-commerce, POS propio, CRM, BI, marketplace, sistema interno custom. Nosotros construimos esa capa de conectores, no tocamos la configuración del ERP. La regla práctica: si tu duda es "cómo emito una factura desde Defontana", llama al soporte de Defontana o a su partner. Si tu duda es "cómo hago que cada venta de mi Shopify se transforme automáticamente en una factura dentro de Defontana sin que el equipo administrativo copie y pegue", esa es la pregunta que resolvemos nosotros.

Ambas, según el flujo. Defontana soporta llamadas API REST que permiten operar casi en tiempo real (segundos de latencia), y también acepta procesos batch programados cuando el caso de uso lo permite. La decisión técnica depende del impacto operativo del retraso: (1) tiempo real con webhooks o polling corto: pagos confirmados, emisión de boleta/factura inmediata al confirmar venta, validación de stock antes de aceptar el pedido, alertas de quiebre de stock; (2) batch cada 5-15 minutos: sincronización de catálogo de productos hacia el e-commerce, actualización de precios, reflejo de inventario en marketplace; (3) batch nocturno: consolidación contable, reporting BI, conciliación bancaria, libros de compraventa, exportes a sistemas financieros. En la mayoría de los casos diseñamos arquitecturas híbridas: lo crítico va en tiempo real con cola y reintento, lo masivo va en batch para no saturar la API de Defontana ni gastar rate-limit innecesario. Es importante saber que Defontana, como toda API empresarial, tiene límites de tasa por minuto/hora; una integración ingenua que llama la API por cada producto en bucle se cae rápido. Por eso usamos paginación inteligente, caché local y orquestación con cola.

Defontana evoluciona su API periódicamente: agrega endpoints nuevos, deprecia versiones antiguas, ajusta esquemas y a veces cambia el comportamiento de campos existentes. Una integración mal diseñada se rompe sin aviso cuando esto ocurre y el equipo recién se entera cuando un cliente reclama porque su factura no llegó. Una integración bien hecha mitiga este riesgo con varias capas: (1) contract testing automatizado contra el ambiente sandbox de Defontana, que detecta cambios antes de pasar a producción; (2) capa anti-corruption: nuestra lógica de negocio no consume directamente el JSON crudo de Defontana, sino un modelo interno traducido, de modo que un cambio en la API solo obliga a actualizar el traductor, no todo el sistema; (3) monitoreo activo con alertas: si una llamada empieza a devolver errores anómalos, recibimos aviso en minutos, no horas; (4) suscripción a los canales oficiales de Defontana para anticipar cambios anunciados; (5) bolsa de horas mensual incluida en el contrato de soporte para adaptaciones rápidas. Adicionalmente, mantenemos versionamiento explícito de la integración: cada release está documentado con qué versión de la API de Defontana se probó y qué endpoints toca. La regla de oro es que una integración sin presupuesto de mantenimiento es una integración condenada: por eso siempre cotizamos build + run, no solo build.

Sí, y es uno de los casos de uso más frecuentes. Empresas chilenas con punto de venta desarrollado a medida (porque el flujo de venta es específico de su negocio: restaurante, retail con descuentos por cliente, taller, servicios) suelen necesitar que cada venta termine como factura o boleta electrónica dentro de Defontana, sin que el cajero tenga que volver a digitar el documento. La integración típica conecta el POS propio con la API de Defontana para crear el DTE inmediatamente al cerrar la venta, marcar el pago según el método (efectivo, tarjeta, transferencia) y reflejar la salida de stock. Si el POS opera offline en contingencia, la integración encola las ventas y las despacha cuando se restablece la conexión, garantizando que el SII reciba todo en orden. Adicionalmente, si tu sistema custom no es un POS sino un CRM, un dashboard ejecutivo, una plataforma SaaS interna o un agente de IA, el patrón es el mismo: definimos qué eventos del sistema deben generar acciones en Defontana, qué datos consultar y con qué frecuencia, y construimos el conector con cola, reintentos y monitoreo. La complejidad real no está en hablar con la API de Defontana, sino en mapear correctamente la lógica de negocio de tu operación: descuentos por cliente, listas de precio múltiples, IVA diferenciado, multi-bodega, múltiples razones sociales y casos borde como devoluciones parciales o cambios de precio post-venta. Por eso un proyecto típico parte siempre con un discovery donde recorremos los flujos reales del negocio antes de tocar código.

Una integración con Defontana mueve datos sensibles: RUT, montos, información contable, datos de clientes y proveedores. La seguridad se trabaja en varias capas: (1) credenciales de la API almacenadas en vault o KMS (AWS Secrets Manager, HashiCorp Vault, Azure Key Vault), nunca en código ni en variables de entorno planas; (2) rotación periódica de la clave de la API de Defontana, con procedimiento documentado; (3) cifrado en tránsito con TLS 1.3 obligatorio y en reposo (AES-256) para cualquier dato persistido en bases intermedias; (4) principio de mínimo privilegio: la cuenta de integración tiene solo los permisos estrictamente necesarios dentro de Defontana, no es un superusuario; (5) logs inmutables con trazabilidad por evento (quién, cuándo, qué), retenidos según la política de la empresa y la Ley 21.719 de Datos Personales; (6) separación estricta de ambientes (producción, staging, dev) para que ningún test toque datos reales por error; (7) revisión por equipo de seguridad y, en clientes regulados, pen testing previo a producción. Adicionalmente, si la integración mueve datos hacia bancos, marketplaces u operadores fintech, aplicamos los controles adicionales de Ley Fintech 21.521. La seguridad no es una capa opcional: es parte de la arquitectura desde el día uno.