Tecnología
Facturación electrónica con motor propio. Sin intermediarios entre tu negocio y SIFEN.
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.
- 01
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.
- 02
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.
- 03
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.
- 04
Tus claves, cifradas
El certificado digital, su contraseña y el CSC se guardan cifrados.
- 05
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.
- 06
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 por dentro. Todo lo que hace entre tu sistema y SIFEN.
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.
Para desarrolladores
Open source, para todos. Usalo en tu propio sistema.
KilaSifen es software libre con licencia MIT. Si estás construyendo un ERP, un punto de venta o un comercio en línea y necesitás facturar con SIFEN, lo instalás en tu infraestructura y lo integrás por su API HTTP o su SDK TypeScript.
- Python 3.10+
- FastAPI
- PostgreSQL
- Redis
- Docker
- SDK TypeScript
Versión alpha: probá cada flujo en el ambiente de pruebas de SIFEN antes de emitir en producción.
import { KilaSifen } from "@kilasifen/sdk";
const kila = new KilaSifen({ apiKey, baseUrl });
const result = await kila.facturas.create(
emitterId,
{
external_id: "venta_987",
factura: {
cliente: {
ruc: "88899990-9",
razon_social: "CLIENTE FICTICIO SA",
tipo_contribuyente: 2,
},
items: [
{
descripcion: "Producto",
cantidad: 1,
precio_unitario: 100_000,
tasa: 10,
},
],
},
},
{ idempotencyKey: "venta_987" },
);Preguntas frecuentes
Preguntas sobre la tecnología.
¿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.
Hacé tu primera venta hoy. Sin tarjeta y sin instalar nada.
Creás la cuenta en minutos, importás tus productos desde Excel y empezás a vender.