Proyecto · API de facturación electrónica
Proyecto 04 / 07: API de facturación electrónica
2026 · Arclo Systems · Arquitectura y desarrollo
Arclo Systems · 2026
Emite, firma y valida la factura v4.4 de Hacienda con núcleo propio, y su IA acompaña cada factura hasta la declaración.
El problema
Arclo facturaba con un proveedor externo, y cada proyecto tenía que rehacer la integración con Hacienda: la custodia de la llave, los consecutivos, los reintentos y los cambios de anexos. Esta API lo resuelve una vez para todos los sistemas de Arclo, empezando por su ERP.
Qué hice
01 / 07
Escribí un núcleo propio con las reglas de Hacienda.
Sin SDKs de terceros. La firma XAdES-EPES sigue la política de Hacienda y usa node:crypto, sin criptografía propia.
02 / 07
Genero la clave de 50 caracteres y el consecutivo.
Y valido cada XML contra los XSD oficiales v4.4 en un proceso aislado. Una sola API emite todos los comprobantes para varias empresas y recibe los de proveedores.
03 / 07
Si Hacienda no responde, una cola reintenta.
Cada comprobante sale con su PDF, avisa por webhook y correo, y queda en el archivo legal. Con el panel, las llaves de API, OpenAPI y la librería cliente, un proyecto integra la facturación en un día.
04 / 07
La llave .p12 y su PIN viven solo en memoria.
Y nunca se escriben en disco, logs ni mensajes de error. Documenté ocho decisiones de arquitectura y escribí unas 190 pruebas, y una librería independiente verifica cada firma.
05 / 07
La firma, los montos y el IVA los calcula código determinista.
Y la IA queda fuera de ese núcleo. La IA sugiere el código CABYS, explica los rechazos de Hacienda, clasifica lo recibido y detecta proveedores que dejaron de estar inscritos.
06 / 07
Con los XML emitidos y recibidos armo el borrador del formulario D-150.
Casilla por casilla. Marco cada inconsistencia antes de declarar, para que no la encuentre primero el cruce de TRIBU-CR, y la IA explica cómo corregirla.
07 / 07
Cuando Hacienda publica anexos nuevos.
Un flujo propone cada regla con su cita y sus pruebas, y una persona la aprueba. Por el servidor MCP, el agente de un cliente consulta sus comprobantes y solo emite dentro de un mandato firmado por una persona.
Resultados
- Su primer usuario es el ERP de Arclo, que deja de depender de un proveedor externo para facturar.
Stack
- TypeScript
- NestJS
- PostgreSQL
- AWS
- XAdES-EPES
- OpenAPI
- Claude
- MCP