Si tu empresa factura e inventaría en Defontana y vende en una tienda online o un marketplace, tarde o temprano quieres que ambos lados lean el mismo stock y los mismos precios. Hay tres caminos: el plugin de ecommerce que Defontana ya incluye, un desarrollo propio sobre su API o una integración lista de un tercero. Este artículo explica qué trae la API, cómo se obtiene el acceso y cuándo conviene cada opción.
Qué es la API de Integraciones de Defontana
Defontana la presenta en su sitio API Integraciones como un puente entre tus sistemas externos, propios o de terceros, y el ERP. Sirve para automatizar y sincronizar datos sin digitación manual.
Hay dos sitios oficiales que conviene distinguir:
- apiintegraciones.defontana.com: explica qué módulos existen, cómo es el proceso de contratación, las buenas prácticas y un registro de novedades con cada liberación.
- api-doc.defontana.com: la referencia técnica llamada “Main API v1”, con cada endpoint, sus parámetros y la especificación OpenAPI descargable.
La documentación es pública. Lo que no es público es el acceso: para llamar a la API necesitas tener contratado el módulo correspondiente.
Cómo se solicita y habilita
Según la página ¿Cómo funciona?, cada empresa y cada módulo se contratan de manera independiente. Si tienes dos empresas en Defontana, o necesitas Ventas e Inventario, cada combinación se habilita por separado.
El proceso que describe Defontana tiene cuatro etapas:
- Pre-factibilidad técnica. Defontana evalúa si la API cubre lo que tu empresa necesita.
- Proceso comercial. Con la factibilidad confirmada, se acuerdan los términos del servicio.
- Ambiente de pruebas. Se habilita un ambiente de pruebas y un grupo de trabajo para apoyar a tu equipo técnico.
- Producción. Terminadas las pruebas, la integración pasa a producción con soporte durante el traspaso.
El requisito explícito es contar con un equipo de TI o una persona con conocimientos de TI que conecte el sistema externo con la API. Defontana no publica el precio de los módulos en ese sitio.
Algunos datos útiles de su sección de ayuda:
| Tema | Lo que dice Defontana |
|---|---|
| Soporte | Grupo de trabajo en Slack, de 08:30 a 18:00 horas |
| Formato | JSON |
| Ambiente de pruebas | 3 usuarios, se actualiza cada fin de semana contra producción |
| Horario de pruebas | 08:30 a 19:00 horas |
| Límite | Hasta 30 solicitudes por segundo |
| Documentos de prueba | Conectado al ambiente de pruebas del SII |
| Duración del proyecto | Depende del equipo técnico del sistema externo |
Autenticación
La API usa autenticación por token. El token se envía como Bearer en la cabecera Authorization de cada solicitud a un módulo contratado.
En la referencia técnica, el grupo Auth tiene cuatro métodos:
GET /api/Auth: entrega un token nuevo a partir del Id de cliente, Id de empresa, Id de usuario y contraseña.GET /api/Auth/EmailLogin: entrega un token con el correo y la contraseña de acceso al ERP.GET /api/Auth/RegainToken: recupera un token desde una sesión vigente.GET /api/Auth/check: indica si la sesión sigue vigente.
Entre sus buenas prácticas, Defontana recomienda renovar el token todos los días, una vez al inicio de la jornada, con una tarea programada antes de que empiece la operación.
Módulos y recursos disponibles
La página de funcionalidades lista siete módulos:
| Módulo | Qué permite, según Defontana |
|---|---|
| Contabilidad | Plan de cuentas, ingreso y consulta de comprobantes, registro de pagos de facturas o boletas |
| Inventario | Documentos de entrada y salida de stock, stock actual por producto, historial de documentos |
| Ventas | Emitir facturas, boletas y notas de crédito que se envían al SII; clientes, vendedores y artículos |
| Pedidos | Crear pedidos, aprobarlos, facturarlos y despacharlos; consultar detalle y PDF |
| Guías de Despacho | Generar y gestionar guías de despacho |
| Órdenes de Compra | Proveedores, creación, aprobación y recepción de órdenes; historial y PDF |
| Compras | Ingreso y centralización de facturas de compra, XML y PDF, aceptar o rechazar ante el SII |
El registro de novedades agrega un módulo de Asistencia, liberado el 4 de septiembre de 2026, con un método para obtener los movimientos de asistencia.
En la referencia técnica los recursos se agrupan así: Accounting, Auth, Company, Dispatch, Environment, Inventory, Order, PaySheet, Pricing, Purchase, PurchaseOrder, Sale, Subscription y User. Para una tienda online, lo que más se usa está en estos grupos:
- Sale: es el grupo más grande. Incluye productos (
Getproducts,SaveProduct,UpdateProduct), bodegas (GetStorages), stock por bodega (GetStorageStock), listas de precios (GetPriceList,GetPriceListDetail,SavePriceList), clientes y documentos de venta. - Order: crear y modificar pedidos, aprobarlos comercial y financieramente, generar su guía de despacho (
DispatchOrder) y facturarlos (InvoiceOrder). - Inventory: documentos de inventario, lotes y stock futuro.
- Subscription: suscripciones a notificaciones. Indicas una URL y Defontana avisa cuando cambia el stock, un producto, un pedido o un documento de inventario.
Un detalle que confunde: el grupo Pricing no es de listas de precios. Sus métodos guardan y consultan cotizaciones. Las listas de precios están en Sale.
El plugin de ecommerce que Defontana ya trae
Antes de programar contra la API, revisa el panel Ecommerce. Según el artículo Configuración y uso Plugin Ecommerce del centro de ayuda, este panel de Defontana ERP y Tivendo conecta una plataforma externa con la facturación e inventario de Defontana, en base a órdenes con estado pagadas. En el ERP está en Ventas > Ecommerce.
Los canales disponibles son Shopify, Jumpseller, WooCommerce, Mercado Libre, PrestaShop, Multivende, VTEX, Falabella, Ripley, Anymarket, Cencosud, Walmart y TiendaNube. Puedes conectar más de uno.
Lo que hace, según ese artículo:
- Stock: el ERP envía el stock de la bodega configurada a los productos relacionados en cada canal.
- Precios: toma el precio de venta del maestro de artículos o de una lista de precios, con opción de una lista distinta por canal.
- Facturación: puede generar el documento de venta de las órdenes pagadas en forma automática, en un proceso que corre cada 30 minutos.
- Pagos: puede registrar contablemente el pago de las ventas generadas, también cada 30 minutos.
Cada plugin se adquiere desde el mismo módulo, con un valor en UF que se suma al contrato. El monto no aparece en el artículo.
Defontana también tiene una tienda propia, Ecommerce Defontana, integrada con el ERP y con Defontana Pay, con demo de 14 días. Es otra cosa: no conecta una tienda que ya tienes.
Cuándo usar la API, el plugin o una integración lista
El plugin conviene si tu canal está en la lista y tus reglas son simples: una bodega, el precio del maestro o una lista, y facturación automática de lo pagado. No necesitas programar.
La API conviene cuando el caso no cabe en el plugin: un sistema propio, un portal B2B, una app de vendedores, reportes o BI, o reglas que el plugin no contempla. Ten presente el costo real: un equipo técnico, el ciclo de evaluación y pruebas, el límite de 30 solicitudes por segundo y el mantenimiento del código cuando cambian la API o el canal. Para extraer datos con fines de informes, Defontana recomienda hacerlo en lotes y de noche.
Una integración lista de un tercero conviene cuando quieres reglas a la medida de tu operación sin mantener código propio. Usa la misma API, pero el desarrollo y el mantenimiento quedan del lado del proveedor. Es el mismo razonamiento que explicamos para Softland en API Softland: conecta tu ERP con WooCommerce.
Dónde entra ERPSync
ERPSync conecta el ERP con tiendas y marketplaces: WooCommerce, Shopify, VTEX, Magento, PrestaShop, Jumpseller, Mercado Libre, Falabella, Ripley, Paris y Walmart. Nuestra especialidad es Softland, y también trabajamos con Defontana previa revisión técnica, usando su API. Un ejemplo es la integración Defontana con Shopify.
Cuesta 0,80 UF al mes por integración, el mismo precio con cualquier ERP y sin límite de pedidos. Puede haber un costo inicial que se cotiza después de revisar tu caso, y cada contratación pasa por una evaluación. Puedes probarlo 14 días sin tarjeta.
Preguntas frecuentes
¿La documentación de la API de Defontana es pública?
Sí. La descripción de módulos y el proceso están en apiintegraciones.defontana.com, y la referencia de endpoints en api-doc.defontana.com. Para usarla en producción necesitas contratar los módulos.
¿Cómo me autentico en la API de Defontana?
Pides un token con el método Auth (Id de cliente, empresa, usuario y contraseña, o correo y contraseña) y lo envías como Bearer en la cabecera de cada solicitud. Defontana recomienda renovarlo una vez al día.
¿Se contrata toda la API de una vez?
No. Cada empresa y cada módulo se contratan por separado, después de una evaluación de pre-factibilidad técnica y un proceso comercial.
¿Hay ambiente de pruebas?
Sí. Defontana habilita 3 usuarios en un ambiente de pruebas que se actualiza cada fin de semana contra producción y funciona de 08:30 a 19:00 horas. Está conectado al ambiente de pruebas del SII.
¿Cuántas solicitudes por segundo acepta?
Hasta 30 solicitudes por segundo, según la sección de ayuda del sitio de la API.
¿Con qué canales funciona el plugin de ecommerce?
Shopify, Jumpseller, WooCommerce, Mercado Libre, PrestaShop, Multivende, VTEX, Falabella, Ripley, Anymarket, Cencosud, Walmart y TiendaNube, según el centro de ayuda de Defontana.
Fuentes
Consultadas el 8 de noviembre de 2026.
- API Integraciones de Defontana: ¿Qué es?
- API Integraciones de Defontana: Funcionalidades
- API Integraciones de Defontana: ¿Cómo funciona?
- API Integraciones de Defontana: Ayuda
- API Integraciones de Defontana: Novedades
- Main API v1, referencia técnica de Defontana
- Configuración y uso Plugin Ecommerce, centro de ayuda de Defontana
- Ecommerce Defontana, centro de ayuda de Defontana
Escrito por el equipo de ERPSync, especialistas en integraciones con Softland. Quiénes somos
