Integración Haulmer con tu sistema: OpenFactura, TUU y Open Banking

La integración con Haulmer se hace a través de su API REST oficial (api.haulmer.com) y de los webhooks que el SaaS expone para notificar eventos en tiempo real. El flujo típico es: tu sistema (Shopify, WooCommerce, POS propio, ERP, marketplace, CRM) genera la venta o el evento de cobro, llama vía HTTPS a la API de Haulmer enviando el detalle del documento a emitir (boleta electrónica DTE 39, factura 33, nota crédito 61), Haulmer firma el XML, genera el TED y lo envía al SII, y devuelve el folio, PDF y código de seguimiento. En paralelo, Haulmer dispara un webhook a tu endpoint público con el cambio de estado (aceptado, rechazado, anulado) para que tu sistema actualice la orden, descuente stock, gatille el envío y notifique al cliente final. Cuando la venta es vía Haulmer Open Banking (Khipu, Fintoc) el webhook llega además con el evento de pago confirmado. Una integración Haulmer bien hecha tiene autenticación con API tokens rotados periódicamente, capa anti-corruption entre el modelo de tu sistema y el modelo Haulmer, cola persistente para reintentos cuando la API no responde y reconciliación nocturna automática contra los reportes Haulmer para asegurar que ningún documento quedó perdido entre los dos lados.

Una integración Haulmer punto a punto con tu sistema (e-commerce, POS, ERP, CRM, BI) parte desde $3.000.000 CLP y se ubica típicamente entre $4.500.000 y $9.000.000 CLP, dependiendo del alcance. El piso bajo corresponde a una integración unidireccional con un solo producto Haulmer (por ejemplo, ecommerce Shopify → OpenFactura para emisión de boleta 39) con webhook básico de confirmación. El rango medio cubre integración bidireccional con dos o tres productos Haulmer (OpenFactura + TUU + Open Banking) con sincronización de catálogo, manejo de errores, dashboard de monitoreo y reconciliación nocturna. Por sobre $9.000.000 entramos en integraciones multi-sucursal, multi-empresa o con flujos de checkout completos que usan Haulmer Open Banking para cobro y emisión simultánea. A esto se suma el costo recurrente: licencia Haulmer (depende del plan y volumen, entre $30.000 y $300.000+ CLP/mes) y mantención evolutiva entre 15% y 20% anual del costo inicial. Comparado con migrar a una integración SII a medida directa, Haulmer queda barato hasta los 5.000-8.000 documentos/mes; sobre ese volumen empieza a tener sentido evaluar prescindir del intermediario.

Usar Haulmer directo significa que tu equipo administrativo entra al portal web de Haulmer y emite boletas o facturas manualmente cargando cliente, monto y detalle. Funciona bien para emisión esporádica o cuando el volumen es bajo. La integración Haulmer custom significa que tu sistema (e-commerce, POS, ERP, app móvil) llama a la API de Haulmer automáticamente sin intervención humana: al confirmarse una venta, el DTE se emite en segundos y vuelve el folio al sistema de origen para guardarlo, enviarlo al cliente y dejarlo en el flujo contable. La diferencia operativa es enorme: cero digitación, cero errores de tipeo, reconciliación automática, y la posibilidad de que tu lógica de negocio (descuentos, programas de fidelización, multimoneda, marketplace con split de pagos) viva en tu sistema y no quede limitada al flujo del portal Haulmer. Adicionalmente, una integración custom permite mantener tu UX al cliente final: el cliente recibe la boleta con tu marca, en tu correo, dentro de tu app, sin nunca pasar por un dominio Haulmer. Esta es la diferencia clave para retailers y plataformas que quieren ownership total de la experiencia.

Sí, y es uno de los escenarios donde más sentido tiene la integración Haulmer. OpenFactura es la suite DTE de Haulmer e incluye boleta electrónica, factura electrónica, nota de crédito, nota de débito, guía de despacho y libros de compraventa. Expone API REST con endpoints para emitir, consultar, anular y descargar cada documento, además de webhooks para los eventos de aprobación o rechazo del SII. Para integrar con un ERP custom el patrón habitual es: el ERP modela su propia entidad Documento con los campos del negocio, una capa anti-corruption mapea esa entidad al esquema OpenFactura al momento de emitir, la respuesta de OpenFactura (folio, TED, PDF, código QR) se persiste en el ERP, y un proceso programado descarga los reportes diarios para conciliar contra el libro contable. Ventajas frente a integrar directo con el SII: certificado digital, firma XML-DSig, TED, PDF417, set de pruebas y contingencia los maneja Haulmer; tú solo te preocupas de mapear bien tu modelo de negocio. La contraparte es la dependencia: si Haulmer cambia precios, deprecia un endpoint o tiene un incidente, tu ERP queda afectado. Por eso siempre construimos la integración con interfaces internas que permiten cambiar de proveedor (OpenFactura, LibreDTE, Bsale, integración SII directa) sin reescribir el ERP completo.

Sí. Haulmer Open Banking es el componente fintech del SaaS y agrega capacidades de cobro vía cuenta bancaria (Khipu, Fintoc y proveedores propios) y consulta de información financiera bajo el marco de la Ley Fintech 21.521. Para integraciones de cobro automatizado el caso típico es: tu plataforma genera una orden, llama al endpoint de Haulmer Open Banking para iniciar el cobro con un monto y un identificador interno, el cliente final completa la autenticación en su banco (web o app), el banco confirma el pago, Haulmer recibe la notificación bancaria y dispara un webhook a tu sistema con el estado final del cobro. En el mismo flujo puedes pedirle a Haulmer que emita la boleta electrónica del cobro confirmado, integrando pago + DTE en una sola interacción técnica. Es útil para suscripciones recurrentes (membresía, software, servicios profesionales), marketplaces con split de pagos a proveedores, e-commerce con preferencia de pago directo desde cuenta bancaria (sin pasar por tarjeta), y plataformas B2B que cobran a empresas con cuentas corrientes. La integración requiere atención especial al manejo de webhooks (idempotencia, firmas HMAC, reintentos) y a la conciliación bancaria al cierre del día.

Una integración Haulmer seria nunca confía en que el webhook llegue una sola vez ni en que llegue en orden. Implementamos cuatro capas de protección. Primero, un endpoint público dedicado en tu sistema valida la firma HMAC del webhook contra el secreto compartido por Haulmer para confirmar autenticidad, rechazando cualquier llamada no firmada. Segundo, idempotencia: cada webhook trae un identificador único (eventId), y tu sistema lo guarda con un constraint de unicidad, ignorando duplicados que Haulmer envíe por reintentos. Tercero, persistencia inmediata: el webhook se persiste en una tabla de eventos crudos antes de ejecutar lógica, para tener un audit log completo y poder reprocesar manualmente si algo falla. Cuarto, reconciliación nocturna: un job consulta diariamente la API de Haulmer pidiendo el listado de documentos del día y lo compara contra los eventos recibidos por webhook, detectando cualquier evento que no llegó por la cola y disparando la actualización correspondiente. Adicionalmente monitoreamos la latencia y tasa de error del endpoint con alertas Datadog/Sentry: si el webhook se demora más de lo esperado o devuelve 5xx, el equipo recibe alerta antes de que el cliente reclame. Con estas cuatro capas, una caída del endpoint de hasta varias horas no genera pérdida de datos.

Sí, siempre que la integración se construya con los controles correctos. Los componentes de cobro y datos financieros de Haulmer (Open Banking, Khipu, Fintoc) caen bajo el ámbito de la Ley Fintech 21.521, que entró en vigencia gradualmente desde 2023 y cuyos cuerpos normativos sobre prestadores de servicios financieros y open finance se consolidan en el período 2025-2026. Las obligaciones principales que cumplimos en una integración son: (1) consentimiento explícito del usuario antes de invocar cualquier endpoint que mueva información financiera, registrado en log inmutable, (2) cifrado en tránsito TLS 1.3 y en reposo AES-256 para credenciales y tokens bancarios, (3) almacenamiento de secrets en vault dedicado (AWS Secrets Manager, HashiCorp Vault) y nunca en código ni variables de entorno planas, (4) trazabilidad completa de cada llamada con identificación del usuario y el propósito de negocio, (5) controles de acceso por rol y separación de ambientes (producción, staging, dev) sin datos reales en no-producción, y (6) plan de respuesta a incidentes con notificación a la CMF dentro de los plazos legales si hay vulneración de datos. Adicionalmente, la Ley 21.719 de Datos Personales agrega obligaciones de minimización, propósito específico y plazo de retención que aplican a cualquier información del cliente que pase por la integración. Recomendamos pen testing previo y revisión de cumplimiento documentada para integraciones bancarias con producción.

Una integración Haulmer punto a punto con un solo producto (por ejemplo, boleta electrónica desde Shopify) toma entre 3 y 6 semanas, contando discovery, credenciales, ambiente sandbox de Haulmer, desarrollo del cliente API, manejo de webhooks, QA y puesta en producción. Una integración de dos o tres productos Haulmer (OpenFactura + TUU + Open Banking) con flujo de checkout completo y reconciliación se ubica entre 8 y 14 semanas. Integraciones más complejas con multi-empresa, multi-sucursal, split de pagos en marketplace o sincronización bidireccional con un ERP custom toman 12 a 20 semanas. La variable que más mueve el plazo no es el código sino el acceso: tiempo en obtener credenciales sandbox, tiempo en habilitar webhooks de prueba, tiempo en validar el flujo en certificación con un set acotado y tiempo en pasar a producción con folios reales. En equipos con experiencia previa en API Haulmer reducimos discovery y arrancamos desarrollo desde la primera semana, lo que adelanta el go-live entre 2 y 4 semanas frente a un equipo que parte de cero. Mantenemos backlog ágil con releases incrementales (no big-bang) para que el primer DTE en producción salga lo antes posible y el resto del scope crezca sobre cimientos ya validados.