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.

emitir-factura.ts
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.