Centro de Ayuda
Glosario fiscal, preguntas frecuentes, atajos y solución de problemas.
Por dónde empezar
- Configurá tu empresa en Configuración → Empresa (RUC + nombre + logo).
- Cargá tu primera compra tomando una foto desde Compras. La IA detecta los datos en segundos y vos confirmás.
- Generá el RG90 al final del mes — tarjeta verde abajo de Compras o Ventas.
- Declaración IVA / IRP: en Declaraciones tenés Form 120 mensual y Form 515 anual calculados.
- Compartí con tu contador generando un link read-only desde Configuración → Compartir.
Glosario fiscal
Términos que vas a leer todo el tiempo en la app y en Marangatu.
- RUC
- Registro Único del Contribuyente. Identificador fiscal del negocio (persona o empresa). Formato:
1234567-8(número + dígito verificador). Sin DV: cédula de identidad. - DV (Dígito Verificador)
- El último número después del guión en el RUC. Calculado por la SET, sirve para detectar errores de tipeo.
- Timbrado
- Autorización de la SET para emitir facturas. Número de 8 dígitos asociado a una imprenta o emisor electrónico. Tiene fecha de vencimiento.
- Comprobante / Nro. Comprobante
- Identificador de la factura. Formato
###-###-#######(sucursal-punto-correlativo). Ej:001-001-0000123. - RG90 (Resolución General 90/2021)
- Obligación de informar a la SET todas tus compras y ventas mensualmente, en formato CSV importable a Marangatu. La app lo genera con un click al cerrar el mes.
- IVA Débito / IVA Crédito
- Débito: el IVA que cobraste en tus ventas (lo que debés pagar al SET). Crédito: el IVA que pagaste en tus compras imputables (descuenta del débito). Saldo a pagar = débito − crédito.
- Imputa al IVA
- Marca esta opción si la compra te da crédito fiscal IVA (el IVA pagado se descuenta del que tenés que pagar). No todas las compras imputan: por ejemplo, gastos personales del titular en una empresa no.
- IRP (Impuesto a la Renta Personal)
- Lo pagan personas físicas residentes con ingresos superiores al mínimo no imponible. Se declara una vez por año. Tasas progresivas (Ley 6380/2019): 8% hasta 50M, 9% de 50M a 150M, 10% sobre 150M.
- IRE (Impuesto a la Renta Empresarial)
- Equivalente al IRP pero para empresas (S.A., S.R.L., etc.). Tasa fija del 10% sobre la renta neta anual.
- Imputa al IRP / IRE
- Marca si la compra es deducible de tu renta personal (IRP) o empresarial (IRE). Solo gastos relacionados con la actividad económica del contribuyente son deducibles.
- Condición de compra (Contado / Crédito)
- 1 = Contado: pagás la factura al momento. 2 = Crédito: pagás después (cuenta corriente, plazo). Aparece en la columna 13 del RG90.
- DTE / E-Kuatia / SIFEN
- DTE: Documento Tributario Electrónico. E-Kuatia: el sistema de la SET para facturación electrónica obligatoria. SIFEN: Sistema Integrado de Facturación Electrónica Nacional, la plataforma técnica detrás. Si recibís un XML de DTE, podés importarlo directo desde el botón "XML DTE".
- CDC (Código de Control)
- Identificador único de un DTE en SIFEN. 44 caracteres alfanuméricos. Aparece en el QR de las facturas electrónicas.
- Tipos de comprobante (RG90 Tabla 4)
- 109=Factura · 110=Nota Crédito · 111=Nota Débito · 101=Autofactura · 112=Ticket · 103=Boleta venta · 107=Despacho importación.
- Marangatu
- Sistema de gestión tributaria de la SET donde el contribuyente presenta declaraciones, paga impuestos y consulta sus comprobantes. Acceso con clave fiscal en marangatu.set.gov.py.
- Renta Neta
- Ingresos brutos menos egresos deducibles del año. Es la base sobre la que se calcula el impuesto IRP / IRE.
Preguntas frecuentes
¿Cómo cargo una factura si la carga manual está desactivada?
Cargá vía Foto (cámara o galería), Voz (dictado), XML DTE (si recibiste el archivo del proveedor) o Plantilla (para gastos recurrentes). En todos los casos vas a ver un preview con los datos detectados antes de confirmar.
El OCR detectó datos incorrectos. ¿Qué hago?
Tocá Cancelar en el preview y reescaneá con mejor calidad de foto (más luz, sin reflejos, factura plana). Si tenés el XML DTE del proveedor, importarlo directo es más confiable que la foto.
¿Cómo genero el reporte RG90 mensual?
Andá a Compras o Ventas, bajá hasta la tarjeta verde "Generar Reporte RG90", elegí mes y año, y tocá "Procesar RG90". Vas a recibir un ZIP con CSVs para subir a Marangatu.
¿Por qué algunas facturas no aparecen en el RG90?
Si los montos cargados no balancean (gravado + exenta ≠ total), la app las descarta y te avisa con el motivo en la respuesta del cierre. Editá la factura para corregir y volvé a generar el RG90.
¿Cómo declaro el IVA mensual desde FacturaPY?
Andá a Declaraciones → IVA Mensual, elegí mes y año, tocá Calcular. Te muestra débito (ventas) − crédito (compras imputables) − saldo. Descargá el PDF Form 120 y presentalo en Marangatu.
¿Y la declaración anual del IRP?
En Declaraciones → IRP Anual. Te calcula la renta neta anual y aplica los tramos progresivos 8/9/10%. Descargá el Form 515 PDF y presentalo en Marangatu.
¿Cómo conecto el bot de WhatsApp para cargar facturas?
Andá a Configuración → Empresa y completá tu teléfono en formato internacional +595981234567. El admin del sistema configura las credenciales Twilio. Después podés mandar fotos al número del bot y responde con preview.
¿Cómo comparto las facturas con mi contador sin darle acceso completo?
Andá a Configuración → Compartir → Crear link. Elegí scope (Dashboard / Facturas / RG90), opcionalmente fecha de expiración o password, y copiá la URL. Tu contador la abre sin cuenta y solo ve lectura.
¿Tengo varias empresas. ¿Cómo manejo cada una?
Andá a Mis empresas y creá una entrada por cada RUC. Al cargar una factura asignala a la empresa correspondiente. Al cerrar mes, indicá la empresa para generar RG90 con su RUC.
Olvidé la contraseña. ¿Cómo la recupero?
Pedile al administrador del sistema que resetee tu password desde el panel admin. No hay flujo de "olvidé contraseña" auto-server por ahora.
¿Puedo instalar la app en mi celular?
Sí. Es una PWA: en Android/iPhone, abrí la app en Chrome/Safari y elegí "Agregar a pantalla de inicio". También hay APK Android compilable desde el panel admin.
¿Qué hago si el sistema está lento o falla?
Probá hard-refresh (Ctrl+Shift+R en escritorio, force-reload en móvil). Si persiste, revisá /health. Reportá al admin con detalles del navegador y la acción que estabas haciendo.
Atajos de teclado
Solución de problemas comunes
No me dejan iniciar sesión
Verificá email/RUC y contraseña. Tras 5 intentos fallidos, el sistema bloquea por 15 min (rate-limit anti brute-force). Si seguís sin entrar, pedile al admin que resetee.
El OCR no detecta nada de la foto
Probá con foto bien iluminada, sin reflejos, factura plana en la mesa. Si tenés el XML DTE, importarlo es 100% confiable. El OCR cascade (Gemini → Groq → OpenRouter) funciona si el admin configuró las API keys.
El monto detectado está mal
Cancelá el preview y reescaneá. El sistema bloquea la edición manual a propósito para evitar errores. Si la factura tiene varios totales (subtotal, descuento, total), asegurate que se vea claro el total final.
El cierre de mes me dice "factura(s) descartada(s)"
Significa que los montos no cuadran (gravado 10% + gravado 5% + exenta ≠ total). Editá esas facturas para que la suma sea exacta. La app detalla cuáles y por qué.
El sistema dice "tenés 2 empresas, indicá empresa_id"
Cada empresa reporta a la SET con su propio RUC. El cierre de mes necesita saber para cuál empresa generar el reporte. Elegila desde el dropdown del cierre.
No veo los cambios después de un deploy
El service worker cachea assets. Hard-refresh (Ctrl+Shift+R) o eliminá el cache desde DevTools → Application → Service Workers → Unregister.
Soporte y contacto
Para reportes de bugs, sugerencias o ayuda específica, escribí a:
Incluí siempre: navegador, captura de pantalla, y los pasos para reproducir el problema.