← Volver al portafolio
Caso 01 · Facturación electrónica

Un motor de facturación que no puede duplicar un folio

Microservicio de Documentos Tributarios Electrónicos ante el SII: genera, firma, envía y consulta facturas, notas, guías y boletas. La integridad la impone el motor, no la disciplina de quien lo usa.

El desafío

En facturación electrónica un error no es una molestia: es una contingencia tributaria. Un folio duplicado, una firma mal armada o un reintento que emite dos veces el mismo documento se convierten en un problema con el SII que después hay que ir a corregir a mano, documento por documento.

El patrón habitual es dejar esa responsabilidad en la aplicación que consume el servicio, o peor, en el criterio del usuario. Nosotros partimos del supuesto contrario: si el motor permite el error, el error va a ocurrir. La única arquitectura que resiste es la que hace imposible la operación incorrecta.

Lo que construimos

Un microservicio autónomo que es la autoridad única de la facturación. Ningún sistema que lo consume puede saltarse sus validaciones.

  • Firma XMLDSig SHA1+RSA sobre formato DTE v2.2, con encoding ISO-8859-1 — los detalles exactos que exige el SII y donde fallan la mayoría de las integraciones caseras.
  • Gestión de folios CAF con control de rangos: el motor lleva la cuenta y rechaza cualquier intento de emitir fuera del rango asignado.
  • Idempotencia obligatoria en emisión real: cada solicitud lleva su clave. Un reintento por corte de red devuelve el documento ya emitido, no uno nuevo.
  • Cesión de facturas Ley 19.983 con generación de AEC y registro ante el RPETC.
  • Boleta electrónica por canal REST separado, con ambientes de certificación y producción aislados entre sí.
  • Representación gráfica en PDF con timbre PDF417 válido.
  • Multi-tenant real: certificado digital y folios completamente aislados por RUT emisor.
5
Tipos de documento
v2.2
Formato DTE del SII
100%
Emisiones idempotentes

Control de calidad antes de producción

El motor viene con un banco de pruebas que compara su salida contra la de los sistemas que lo consumen, para garantizar que ambos emiten exactamente lo mismo antes de tocar producción. Incluye modo de simulación en seco: se puede correr el flujo completo sin emitir un solo documento real.

Es la aplicación directa de uno de nuestros principios: producción es sagrada. Ningún cambio en un sistema que emite documentos tributarios sale sin haber sido comparado contra el comportamiento anterior.

Stack

Node.js TypeScript Express XMLDSig Docker VPS Ubuntu SII Chile

Dónde aplica esto

Cualquier empresa o software que necesite emitir documentos tributarios sin depender de un proveedor externo por documento: ERPs propios, sistemas de gestión, e-commerce con volumen, o plataformas que facturan a nombre de terceros y necesitan aislamiento entre emisores.

Si estás evaluando integrar facturación electrónica en tu sistema, conversemos sobre el alcance.

¿Cuánto tiempo y dinero estás dejando en la mesa cada mes?

En 30 minutos analizamos tu operación y te mostramos exactamente qué se puede automatizar, cuánto cuesta y qué retorno puedes esperar. Sin costo, sin compromiso.

30 minutos · 100% gratuita · Diagnóstico concreto