# Tecnología: facturación electrónica con motor propio

Contadito no depende de un proveedor externo de facturación electrónica. Se conecta a SIFEN con KilaSifen, una API fiscal que desarrollamos nosotros y que publicamos como software libre para que cualquiera la pueda usar.

## Por qué un motor propio y no un proveedor externo

- **Sin intermediarios**: Tus facturas se firman y se envían a SIFEN desde nuestra propia infraestructura, sin pasar por un proveedor de facturación de terceros.
- **Nunca duplica una factura**: La numeración fiscal se asigna de forma atómica y cada operación es idempotente: si algo se repite, el resultado es el mismo documento.
- **Resiste las caídas de SIFEN**: Si SIFEN no responde, reintenta solo y, antes de reenviar, consulta por CDC si el documento ya había llegado.
- **Tus claves, cifradas**: El certificado digital, su contraseña y el CSC se guardan cifrados.
- **Al día con la normativa**: Sigue el Manual Técnico v150 de SIFEN y sus notas técnicas, y valida cada documento antes de enviarlo.
- **Código auditable**: El código es público: cualquiera puede revisar cómo se arma, se firma y se envía cada factura.

## KilaSifen

KilaSifen es una API fiscal de código abierto (licencia MIT) para conectar sistemas de gestión con SIFEN, la facturación electrónica de Paraguay: recibe la operación, arma y firma el XML, lo transmite a SIFEN y conserva el resultado.

- **Facturas, notas de crédito y de débito**: Contratos tipados que validan receptor, montos, IVA y fechas antes de crear el documento.
- **Numeración atómica e idempotencia**: El servidor asigna el número fiscal; repetir la misma intención devuelve el mismo documento.
- **XML v150, firma y mTLS**: Arma el XML con clases generadas desde los XSD oficiales, lo firma con XMLDSig y lo transmite por SOAP con certificado.
- **Consulta y reconciliación por CDC**: Recupera el resultado de un documento sin reenviarlo a ciegas, y consulta el RUC de un receptor.
- **KuDE en PDF y datos en JSON**: El KuDE lleva el código QR, y el XML firmado también se puede descargar.
- **Cancelación e inutilización**: Eventos asíncronos que se siguen por API y por webhooks.
- **Webhooks firmados**: Firmados con HMAC y timestamp, con reintentos y reenvío manual.
- **Sandbox determinístico**: Simula aprobaciones, rechazos, timeouts y respuestas perdidas sin transmitir a SIFEN.
- **Aislamiento por consumidor**: Cada API key ve solo sus emisores, con permisos por scopes.
- **SDK TypeScript y motor Python**: Un cliente tipado sin dependencias para el backend, y un motor Python para leer, validar, firmar y transmitir XML de SIFEN.
- **Lo instalás donde quieras**: Se despliega en tu propia infraestructura con Docker Compose: API, worker, outbox, PostgreSQL y Redis.

## Open source, para todos

KilaSifen es software libre con licencia MIT. Se instala en la infraestructura de cada uno y se integra por su API HTTP o su SDK TypeScript. Tecnologías: Python 3.10+, FastAPI, PostgreSQL, Redis, Docker, SDK TypeScript. Está en versión alpha: conviene probar cada flujo en el ambiente de pruebas de SIFEN antes de producción.

- Documentación: https://docs-swart-psi-77.vercel.app/
- Inicio rápido: https://docs-swart-psi-77.vercel.app/docs/inicio-rapido
- Código fuente: https://github.com/ras272/kilasifen

## Preguntas frecuentes

### ¿Contadito usa un proveedor externo para la factura electrónica?

No. Contadito se conecta a SIFEN con KilaSifen, una API fiscal propia y de código abierto. Las facturas se firman y se envían desde nuestra infraestructura, sin intermediarios.

### ¿Qué es KilaSifen?

KilaSifen es una API fiscal de código abierto (licencia MIT) para conectar sistemas de gestión con SIFEN, la facturación electrónica de Paraguay: recibe la operación, arma y firma el XML, lo transmite a SIFEN y conserva el resultado.

### ¿Puedo usar KilaSifen en mi propio sistema?

Sí. Es software libre con licencia MIT: lo instalás en tu infraestructura y lo integrás desde tu ERP por su API HTTP o su SDK TypeScript. Todavía está en versión alpha, así que conviene probar cada flujo en el ambiente de pruebas de SIFEN antes de producción.
