Lo que debés pagar ahora
| Fecha | Hora | Emisor | Tipo | Monto | IVA | Total |
|---|---|---|---|---|---|---|
🧾 Emitir factura electrónica a un cliente
Datos del cliente (receptor)
Líneas de la factura
| Descripción | CABYS | Cant. | Precio unit. | Desc. | IVA | Total |
|---|
Subtotal: ₡0
IVA: ₡0
Total: ₡0
Genera la factura, la firma con tu .p12 si está configurado y la envía a Hacienda.
Facturas emitidas
| Fecha | Tipo | Consecutivo | Cliente | Total | Estado | |
|---|---|---|---|---|---|---|
D-105 · Historial trimestral
D-101 · Historial anual de renta
Centro de Notificaciones
Alertas de vencimientos por correo o WhatsApp
Contactos registrados
💬 WhatsApp — Conexión directa
¿Cómo funciona?
El sistema usa un número de WhatsApp propio para enviar notificaciones. Necesitás conectarlo escaneando un QR — igual que WhatsApp Web. El número que conectés será el que envíe todos los mensajes.
Para conectar:
- Abrí WhatsApp en tu celular
- Tocá los ⋮ tres puntos → "Dispositivos vinculados"
- Tocá "Vincular un dispositivo"
- Apuntá la cámara al QR que aparece abajo
Verificando...
Cargando estado del bot
Historial de envíos
Opciones del sistema
Configuración del negocio, cuenta, correo y preferencias
🏢 Información del negocio
Datos generales
-- Seleccioná tu actividad --
▼
Régimen Simplificado (Hacienda CR)
Restaurante, soda o comedor[5610]
Panadería o repostería[1071]
Pulpería, minisuper o abastecedor[4711]
Carnicería o pescadería[4723]
Verdulería o frutería[4721]
Ferretería[4752]
Salón de belleza o barbería[9602]
Lavandería o tintorería[9601]
Taller de mecánica automotriz[4520]
Taller de bicicletas[4540]
Taller de electrónica / reparaciones[9511]
Zapatería o talabartería[4772]
Sastrería o costura[1410]
Librería o papelería[4761]
Farmacia pequeña[4773]
Floristería[4776]
Bar o cantina[5630]
Heladería o refresquería[5610]
Taxi o transporte remunerado[4922]
Soda-cantina[5610]
Régimen Tradicional
Comercio en general / tienda[4711]
Servicios profesionales[6910]
Consultoría o asesoría[7020]
Construcción o contratismo[4100]
Tecnología / software / IT[6201]
Servicios de salud[8610]
Centro educativo o academia[8510]
Inmobiliaria o alquiler de bienes[6810]
Manufactura o producción industrial[1000]
Exportación de bienes o servicios[4610]
Servicios financieros o seguros[6419]
Actividad agropecuaria[0111]
Otra actividad no listada[9999]
⚖️
No seleccionado
Seleccioná tu actividad económica arriba
Logo del sistema
Imagen circular · Se muestra en barra y login
Estado del sistema
| Correos en buzón | — |
| Facturas procesadas | — |
| Última sync | — |
| Compras netas | — |
🎨 Personalización
#2d6e1f
#6abf45
#f4f6f4
#cc0000
📧 Configuración de correo (IMAP) Verificando...
Servidor de correo entrante
993 SSL · 143 sin SSL
⏱ Sincronización automática
Auto-sync: según intervalo
🔐 Cuenta de administrador
👤 Nombre de usuario
Actual:
📧 Correo electrónico
Actual: —
🔑 Contraseña
Cambiá tu contraseña de acceso
🔐 Verificación en dos pasos (2FA)
Al iniciar sesión, pide un código enviado a tu correo. Si el correo falla, no te bloquea.
🔓 Inicios de sesión social
Configuración técnica opcional, se hace una sola vez. Mientras no la completes, los botones "Continuar con…" no aparecen en el login. Los secretos se guardan en el servidor (no se muestran). Tocá un proveedor para configurarlo:
Google Cloud Console → APIs y servicios → Credenciales → ID de cliente OAuth → Web; en "Orígenes JavaScript" agregá
https://hacienda.laposadadelsapo.com y pegá el Client ID. Para el login nativo en el APK se crea además un cliente Android (paquete cr.laposadadelsapo.hacienda, SHA-1 0A:E4:66:BC:42:72:91:D9:1E:CE:FC:69:5E:E2:F7:19:77:D4:67:4E).developers.facebook.com → tu App → Facebook Login: agregá el dominio
hacienda.laposadadelsapo.com. Copiá App ID y App Secret acá.🔵 Microsoft
portal.azure.com → Microsoft Entra ID → Registros de aplicaciones → Nueva, plataforma SPA, URI
https://hacienda.laposadadelsapo.com. common = cualquier cuenta.🍎 Apple
developer.apple.com → Identifiers → Services IDs: activá Sign in with Apple, dominio
hacienda.laposadadelsapo.com, Return URL https://hacienda.laposadadelsapo.com/.⚫ TikTok
TikTok no entrega el correo: primero vinculás tu cuenta (estando dentro) y luego entrás con TikTok.
developers.tiktok.com → Login Kit: Redirect URI
https://hacienda.laposadadelsapo.com/api/oauth_tiktok.php?action=callback, scope user.info.basic.🛠️ Herramientas — factura electrónica, correo de envío y asistente
🧾 Factura electrónica — emisor
Datos con los que se emiten las facturas a tus clientes (pestaña Emitir). Para firmar y enviar a Hacienda necesitás subir tu certificado .p12 (llave criptográfica de ATV) y tus credenciales ATV.
Credenciales ATV (para enviar a Hacienda)
Certificado de firma (.p12)
—
El .p12 se guarda fuera del área pública del servidor. Conseguís el certificado en ATV → Comprobantes electrónicos → Obtener llave criptográfica. La firma se valida criptográficamente; el envío real a Hacienda debe probarse primero en sandbox.
✉️ Correo de envío (Gmail)
Conectá tu Gmail para enviar las facturas a tus clientes desde tu propia cuenta. Es lo más simple: tocás Conectar Gmail y autorizás — sin servidores ni contraseñas. Si no lo conectás, los correos salen igual por el servidor.
—
⚙️ Credenciales de Google (configuración única)
Para habilitar "Conectar Gmail" se necesita un cliente OAuth de Google con la API de Gmail activada.
En Google Cloud Console → APIs y servicios: activá Gmail API, creá un ID de cliente OAuth (Web) y agregá el URI de redirección
https://hacienda.laposadadelsapo.com/api/oauth_gmail.php?action=callback. Pegá el Client ID y el Secret acá. (Podés reutilizar el mismo Client ID del login con Google.)📨 O usá tu correo por SMTP
Escribí tu correo y se configura solo (Gmail, Microsoft, Yahoo, iCloud, Zoho…). Si es un dominio propio, completás los datos a mano.
🔑 Mi correo pide una "contraseña de aplicación" — ¿cómo la consigo?
Si tu cuenta tiene verificación en 2 pasos, el proveedor no acepta tu contraseña normal: hay que generar una contraseña de aplicación (una clave aparte solo para esta app). Es gratis y toma un minuto:
📧 Gmail — Lo más fácil es usar “Conectar Gmail” aquí arriba (sin contraseñas). Por SMTP: entrá a
myaccount.google.com/apppasswords → escribí un nombre (ej. “Hacienda”) → Crear → copiá los 16 caracteres y pegalos como contraseña.🔵 Microsoft / Outlook —
account.microsoft.com/security → Opciones de seguridad avanzadas → Contraseñas de aplicación → Crear una nueva. (Si no usás verificación en 2 pasos, va tu contraseña normal.)🟣 Yahoo —
login.yahoo.com → Seguridad de la cuenta → Generar contraseña de aplicación → copiá y pegá.🍎 Apple / iCloud —
appleid.apple.com → Inicia sesión → Seguridad → Contraseñas específicas de la app → Generar → pegá la clave con guiones (xxxx-xxxx-xxxx-xxxx).🟠 Zoho u otro — Probá con tu contraseña normal; si falla, generá una clave de aplicación en la sección de seguridad de tu cuenta.
Después de pegarla, tocá 🧪 Probar que funciona para confirmar.
🤖 Asistente IA (Gemini)
Activá el asistente de la pestaña Ayuda. Necesita una clave gratuita de Google AI Studio.
📋 Cómo obtener la clave (paso a paso)
1. Entrá a aistudio.google.com/app/apikey con tu cuenta de Google.
2. Tocá Create API key (Crear clave de API). Es gratis.
3. Copiá la clave (empieza con
4. Dejá el modelo en
2. Tocá Create API key (Crear clave de API). Es gratis.
3. Copiá la clave (empieza con
AIza…) y pegala acá abajo.4. Dejá el modelo en
gemini-2.5-flash y tocá Guardar. ¡Listo!
El asistente solo lee facturas e impuestos (modo solo-lectura); nunca usuarios, contraseñas ni configuración. La clave se guarda en el servidor y se enmascara.
🔑 Licencia y suscripción
Licenciado por BBS Comunicaciones · suscripción Hacienda APP ₡29.000/mes (cobro mensual recurrente).
Gestioná el pago mensual de Hacienda APP.
📊 App móvil, reportes y bitácora
📱 App para celular (Android)
Instalá Hacienda en tu teléfono. Funciona sin conexión y se actualiza sola.
En el celular: tocá Descargar → abrí el archivo → permití "Orígenes desconocidos" → Instalar. ¿iPhone? Abrí el sitio en Safari y "Agregar a pantalla de inicio".
📊 Reportes y respaldo
Libro de compras y resumen para tu contador (abren en Excel). El respaldo descarga toda la base de datos.
📋 Bitácora de actividad
Inicios de sesión, sincronizaciones, cambios de configuración, licencia, respaldos y exportaciones.
Suscripción
Hacienda APP by BBS Comunicaciones
₡29.000 / mes
cobro mensual recurrente · o su equivalente
- ✅ Factura electrónica ilimitada
- ✅ Impuestos automáticos (D-104 / D-105 / D-101)
- ✅ Asistente, correo, multiusuario y app móvil
- ✅ Soporte y actualizaciones de BBS Comunicaciones
La tarjeta se ingresa en la página segura de Tilopay (BBS Comunicaciones). El cobro se renueva automáticamente cada mes; podés cancelar cuando quieras escribiendo a info@bbscomunicaciones.com.
Pago procesado por BBS Comunicaciones vía Tilopay · Hacienda APP
🤖 Asistente IA
Consulta tus facturas e impuestos en modo solo lectura. Nunca accede a contraseñas ni configuración.
❓ Preguntas frecuentes
¿Cómo entran las facturas de compra?
Llegan por correo electrónico (IMAP). Al tocar Sincronizar se descargan los XML del buzón y se procesan automáticamente. Aparecen en la pestaña Facturas.
¿Qué régimen tributario uso?
Se define por la actividad económica en Opciones. Simplificado declara IVA trimestral (D-105 = compras × factor). Tradicional declara IVA mensual (D-104 = IVA de ventas − IVA de compras) y renta anual (D-101).
¿Cómo le emito una factura electrónica a un cliente?
Pestaña Emitir: completá los datos del cliente y las líneas, y tocá Generar factura. Para firmarla y enviarla a Hacienda subí tu certificado .p12 y las credenciales ATV en Opciones → Factura electrónica. Sin el .p12 igual se genera un documento imprimible.
¿Cómo obtengo mi certificado .p12?
En el portal ATV de Hacienda: Comprobantes electrónicos → Obtener llave criptográfica. Descargás el archivo .p12 y te dan un PIN. Probá siempre primero en ambiente Pruebas (sandbox).
¿Funciona sin internet?
Sí. La app guarda tus datos y funciona offline (PWA y APK de Android). Las facturas que emitís sin conexión se sincronizan cuando vuelve internet.
¿Cómo hago un respaldo de mis datos?
Opciones → Reportes y respaldo → Descargar respaldo. También podés exportar el libro de compras y el resumen mensual en CSV para tu contador.
¿Cómo cambio mi contraseña o activo la verificación en 2 pasos?
Opciones → Cuenta. Ahí cambiás la contraseña y activás el código por correo (2FA).
¿Cómo configuro el correo para enviar facturas?
En Opciones → Correo de envío. Lo más simple es Conectar Gmail (un clic, sin contraseñas). O escribí tu correo y se configura solo (Gmail, Microsoft, Yahoo, iCloud, Zoho). Tocá Probar para confirmar que llega.
Mi correo pide una "contraseña de aplicación", ¿qué es?
Si tu cuenta tiene verificación en 2 pasos, el proveedor no acepta tu contraseña normal por SMTP: hay que generar una contraseña de aplicación (una clave aparte solo para esta app). Gmail: myaccount.google.com/apppasswords. Microsoft: account.microsoft.com/security → Contraseñas de aplicación. Yahoo: Seguridad de la cuenta → Generar contraseña de aplicación. Apple/iCloud: appleid.apple.com → Seguridad → Contraseñas específicas de la app. En Gmail, "Conectar Gmail" evita este paso. La guía detallada está en Opciones → Correo de envío.
¿El asistente IA ve mis contraseñas?
No. Solo consulta facturas, impuestos y bitácora en modo lectura; nunca accede a las tablas de usuarios, sesiones ni configuración, y las columnas sensibles se ocultan.
📖 Documentación
Facturas (compras)
Lista de las facturas de compra recibidas por correo. Buscá por emisor, consecutivo o fecha y ordená por columna. Cada factura guarda monto, IVA, total, moneda y tipo de cambio (convertido a colones).
Impuestos (D-104 / D-105 / D-101)
D-105 (simplificado, trimestral): IVA estimado = compras × factor de actividad. D-104 (tradicional, mensual): IVA a pagar = IVA débito de tus ventas − IVA crédito de tus compras; registrá las ventas del mes en esta pestaña. D-101 (renta anual): se calcula por tramos sobre ingresos menos gastos.
Emitir factura electrónica
Genera comprobantes v4.4 (factura o tiquete) para tus clientes: clave de 50 dígitos, consecutivo, XML, firma XAdES con tu .p12 y envío a Hacienda. Podés imprimir/guardar el PDF, descargar el XML y consultar el estado del comprobante.
Opciones y configuración
Datos del negocio y actividad, emisor y certificado de factura electrónica, credenciales ATV, reportes y respaldo, bitácora de actividad, notificaciones (WhatsApp/correo), inicios de sesión social, licencia y este asistente IA.
Seguridad
Sesiones con expiración, verificación en 2 pasos opcional, bitácora de toda la actividad y certificados/contraseñas guardados fuera del área pública del servidor. La base de datos no es accesible directamente desde la web.
App móvil y actualizaciones
Instalá el APK desde Opciones → App para celular o desde la página de descargas. Se actualiza sola por aire (OTA); la versión actual se muestra en el pie de página.