# Guarani.App

> Plataforma web y API de facturación electrónica para empresas en Paraguay, integrada al sistema SIFEN de la DNIT (Dirección Nacional de Ingresos Tributarios). Permite emitir, validar y entregar Factura, Nota de Crédito, Nota de Débito y Remisión electrónica desde una sola cuenta multiempresa y multisucursal.

Guarani.App es operada por el mismo equipo paraguayo detrás de [RUC.com.py](https://ruc.com.py), un buscador gratuito de RUC y empresas en Paraguay. Ambos sitios son productos hermanos del mismo proveedor.

## Qué hace

- Emisión de Factura Electrónica, Nota de Crédito, Nota de Débito y Remisión (Nota de Remisión) bajo normativa DNIT/SIFEN.
- Firma digital y envío automático a SIFEN para validación.
- Generación del KuDE (representación gráfica del documento electrónico) y entrega automática al cliente por correo.
- API REST+JSON con autenticación Bearer Token para integrar ERP, POS o sistemas internos.
- Panel multiempresa y multisucursal con numeración automática por punto de expedición.
- Consulta de estado en SIFEN en tiempo real (pendiente / aprobado / rechazado).
- Anulación de comprobantes vía API y panel.
- Actualizaciones de normativa DNIT incluidas sin costo adicional.

## Precio

- **Plan único**: Gs. 241.000 por mes por punto de expedición (valor referenciado al salario mínimo paraguayo, con reajuste anual automático).
- Documentos ilimitados, multiusuarios, hasta 5 GB de almacenamiento por punto de expedición (~250 mil facturas).
- Almacenamiento adicional: Gs. 20.000 / GB / mes.
- Acceso API y plataforma web incluidos en el mismo plan, sin add-ons.
- Estadía mínima: 12 meses.
- Puesta en marcha sin costo.

## Glosario (términos paraguayos de facturación electrónica)

- **SIFEN**: Sistema Integrado de Facturación Electrónica Nacional de Paraguay. Sistema oficial donde se firman, validan y almacenan los comprobantes electrónicos.
- **DNIT**: Dirección Nacional de Ingresos Tributarios. Organismo público paraguayo (sucesor de la SET) responsable de la normativa fiscal y de SIFEN.
- **CDC**: Código de Control. Identificador único de 44 dígitos asignado por SIFEN a cada Documento Electrónico (DE) aprobado.
- **DE**: Documento Electrónico. Comprobante tributario digital con validez legal (factura, nota de crédito, nota de débito, remisión).
- **KuDE**: representación gráfica (PDF) del Documento Electrónico, pensada para ser entregada al receptor humano.
- **Timbrado**: autorización numérica emitida por DNIT que habilita a un contribuyente a emitir comprobantes en un rango de numeración específico.
- **Punto de expedición**: subdivisión dentro de un establecimiento donde se emiten comprobantes (formato XXX-XXX-NNNNNNN).

## Endpoints API destacados

- `POST /simplificado/carritos` — emitir un comprobante (factura, NC, ND, remisión).
- `GET  /consultas/cdc/:cdc` — consultar el estado en SIFEN (pendiente, aprobado, rechazado).
- `POST /sifen/eventos/anular` — anular un comprobante aprobado.
- Autenticación: header `x-api-key: Bearer <API_KEY>`.

## Para quién

- Empresas paraguayas obligadas a facturación electrónica por DNIT.
- Negocios que ya facturan manualmente y quieren acelerar el proceso.
- Equipos de desarrollo que necesitan integrar emisión electrónica en su ERP/POS sin construir el conector a SIFEN desde cero.

## Diferenciadores

- Plataforma construida exclusivamente para facturación electrónica paraguaya (no es un módulo de un ERP genérico extranjero adaptado).
- API y plataforma web vienen juntas en el mismo plan, sin licenciamiento separado.
- Soporte por WhatsApp en horario comercial.
- Equipo paraguayo, infraestructura y documentación en español rioplatense.

## Enlaces

- Sitio principal: https://www.guarani.app
- Aplicación / login: https://app.guarani.app
- Registro / prueba gratis: https://app.guarani.app/bienvenido
- Producto hermano (búsqueda de RUC): https://ruc.com.py
- WhatsApp soporte: https://wa.me/595974222122

## Preguntas frecuentes

### ¿Qué es la facturación electrónica en Paraguay?
Es la emisión de comprobantes tributarios digitales con validez legal, enviados en línea bajo la normativa de la DNIT a través del sistema SIFEN. Reemplaza a la factura impresa tradicional.

### ¿Puedo operar varias empresas con una sola cuenta?
Sí. Guarani.App es multiempresa y multisucursal. Cada empresa tiene su propio panel y facturación independiente, todo desde una sola cuenta de usuario.

### ¿La API está incluida en el plan?
Sí. El acceso API y la plataforma web vienen juntos en el plan mensual, sin add-ons ni costos extras.

### ¿Cuánto tarda la implementación?
La mayoría de las empresas quedan operativas el mismo día. El equipo acompaña la puesta en marcha por WhatsApp y videollamada.

### ¿Hay permanencia obligatoria?
Sí, una estadía mínima de 12 meses para garantizar la continuidad del servicio y el soporte técnico durante el ejercicio fiscal.

### ¿Qué es un KuDE?
KuDE es la representación gráfica (en PDF) de un Documento Electrónico aprobado por SIFEN. Es lo que se le entrega al cliente humano para que pueda leer el comprobante; el documento legal en sí es el XML firmado almacenado en SIFEN.