This page collects the most common questions from vacation rental hosts using FiscalHost Inteligente CR. Questions are grouped by topic so you can quickly find what you need — whether you’re wondering about a specific tax calculation, troubleshooting a CSV import, or trying to understand how the alert system works. If your question isn’t answered here, open a GitHub Issue with the labelDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/Acevedo26/FiscalHost-Inteligente-CR-/llms.txt
Use this file to discover all available pages before exploring further.
documentation so the team can address it.
Cálculos Fiscales
¿FiscalHost Inteligente CR reemplaza a un contador?
¿FiscalHost Inteligente CR reemplaza a un contador?
No. FiscalHost Inteligente CR es una herramienta de organización, cálculo y seguimiento fiscal diseñada para simplificar el trabajo diario de un anfitrión de alquiler vacacional. El sistema automatiza los cálculos de IVA y renta, rastrea vencimientos y genera reportes estructurados, pero no constituye asesoría legal ni contable.Se recomienda que un contador público autorizado (CPA) revise los reportes generados por el sistema antes de presentar cualquier declaración ante el Ministerio de Hacienda, especialmente en situaciones complejas como deducciones de gastos, copropiedad de inmuebles, o ingresos provenientes de múltiples plataformas y monedas. FiscalHost Inteligente CR facilita y acelera el trabajo del contador al entregarle información ya organizada y calculada, pero la responsabilidad de la declaración ante Hacienda recae siempre en el contribuyente.
¿Qué pasa si tengo ingresos en USD?
¿Qué pasa si tengo ingresos en USD?
FiscalHost Inteligente CR convierte automáticamente las transacciones en dólares estadounidenses (USD) a colones costarricenses (CRC) usando el tipo de cambio de referencia de venta publicado por el Banco Central de Costa Rica (BCCR) vigente en la fecha de la transacción (es decir, la fecha en que el ingreso fue acreditado o recibido).El tipo de cambio aplicado queda registrado en el detalle de cada transacción para efectos de auditoría. Esto garantiza que el cálculo del IVA y de la renta se realice sobre el valor en colones que Hacienda espera ver en la declaración. Si en algún momento el BCCR modifica la metodología de su tipo de cambio de referencia, el equipo de desarrollo actualizará la fuente de datos correspondiente.
¿Cómo se calculan las deducciones permitidas para Renta?
¿Cómo se calculan las deducciones permitidas para Renta?
Para contribuyentes bajo el Régimen Tradicional, la base imponible del Impuesto sobre la Renta se determina restando los gastos deducibles autorizados de los ingresos brutos del período. FiscalHost Inteligente CR reconoce las siguientes categorías de deducciones:
- Mantenimiento y reparaciones: gastos necesarios para conservar la propiedad en condiciones de uso (pintura, plomería, electricidad, etc.).
- Depreciación: desgaste del inmueble y de los bienes muebles utilizados en la actividad, calculada según las tasas establecidas por la DGT.
- Seguros: primas de pólizas que cubran la propiedad utilizada para el alquiler vacacional.
- Comisiones de plataformas: cargos cobrados por Airbnb, Booking.com, VRBO u otras plataformas de distribución por intermediar la reserva.
- Gastos de administración: honorarios pagados a administradores o gestores de la propiedad.
¿Debo declarar IVA si estoy en Régimen Simplificado?
¿Debo declarar IVA si estoy en Régimen Simplificado?
Sí, pero con diferencias importantes respecto al Régimen Tradicional. Los contribuyentes acogidos al Régimen Simplificado también están sujetos al IVA en sus actividades de alquiler vacacional, sin embargo, el mecanismo de liquidación es distinto: en lugar de declarar el IVA débito y acreditar el IVA crédito mes a mes, los contribuyentes del Régimen Simplificado aplican factores de estimación objetiva establecidos por la Dirección General de Tributación para determinar el impuesto a pagar.Además, bajo el Régimen Simplificado, el Impuesto sobre la Renta se maneja mediante una retención definitiva del 15 % sobre los ingresos brutos, sin posibilidad de deducir gastos. Esto simplifica la carga administrativa, pero puede resultar más oneroso si los gastos de la propiedad son significativos. FiscalHost Inteligente CR adapta sus cálculos al régimen que hayas configurado en el ajuste Régimen tributario dentro de tu perfil fiscal.
Importación de Datos
¿Qué formato debe tener el archivo CSV de importación?
¿Qué formato debe tener el archivo CSV de importación?
El archivo CSV de importación debe estar codificado en UTF-8 y usar coma (
Ejemplo de una fila válida:Las filas con valores faltantes en columnas obligatorias (
,) como separador. Se requieren las siguientes columnas en el encabezado (el orden no importa, pero los nombres deben coincidir exactamente):| Columna | Tipo | Formato | Descripción |
|---|---|---|---|
fecha | Fecha | YYYY-MM-DD | Fecha en que se acreditó el ingreso. |
monto | Número | Decimal con punto | Monto de la transacción en la moneda indicada. |
moneda | Texto | CRC o USD | Moneda de la transacción. |
plataforma | Texto | airbnb, booking, vrbo, directo | Plataforma de origen de la reserva. |
propiedad_id | Texto | — | ID de la propiedad configurada en el sistema. |
descripcion | Texto | — | Descripción libre de la transacción (opcional pero recomendado). |
fecha, monto, moneda, plataforma, propiedad_id) serán marcadas como errores durante la importación.¿Puedo importar datos directamente desde Airbnb?
¿Puedo importar datos directamente desde Airbnb?
FiscalHost Inteligente CR no se conecta directamente a la API de Airbnb en esta versión. Sin embargo, puedes exportar tus datos desde la plataforma y luego importarlos al sistema siguiendo estos pasos:
- Inicia sesión en tu cuenta de Airbnb en airbnb.com.
- Ve a Cuenta → Historial de transacciones.
- Selecciona el rango de fechas que deseas exportar y descarga el archivo CSV.
- Revisa que el CSV exportado por Airbnb tenga las columnas requeridas por FiscalHost (es posible que necesites renombrar o agregar algunas columnas antes de importarlo).
- Sube el archivo ajustado desde la pantalla de importación de FiscalHost Inteligente CR.
¿Qué sucede si una fila del CSV tiene errores?
¿Qué sucede si una fila del CSV tiene errores?
FiscalHost Inteligente CR utiliza un proceso de importación tolerante a errores por fila: cuando el sistema detecta un problema en una fila específica (valor faltante en columna obligatoria, formato de fecha incorrecto, moneda no reconocida, ID de propiedad inexistente), esa fila es marcada como error y excluida del procesamiento, pero el resto del archivo continúa importándose normalmente.Al finalizar la importación, el sistema muestra un resumen de resultados que indica:
- Número de filas importadas exitosamente.
- Número de filas con errores.
- Detalle de cada error: número de fila, columna afectada y descripción del problema.
Alertas y Vencimientos
¿Con cuánta anticipación envía alertas el sistema?
¿Con cuánta anticipación envía alertas el sistema?
El sistema de alertas es completamente configurable. Por defecto, FiscalHost Inteligente CR envía notificaciones con 15, 7, 3 y 1 días de antelación antes de cada vencimiento fiscal (declaración D-104 mensual, pagos a cuenta D-150, declaración D-101 anual).Puedes personalizar estos intervalos desde la sección Alertas de la configuración del sistema, estableciendo los días de anticipación que prefieras. Por ejemplo, si quieres recibir solo dos recordatorios por vencimiento, puedes configurar únicamente los valores 7 y 1. Las notificaciones pueden entregarse por notificación in-app (dentro del sistema), por correo electrónico, o por ambos canales simultáneamente. También puedes desactivar las alertas por completo desde la misma sección si lo necesitas temporalmente.
¿Las fechas de vencimiento se actualizan automáticamente cada año?
¿Las fechas de vencimiento se actualizan automáticamente cada año?
Sí, para las fechas de vencimiento conocidas y recurrentes — como el día 15 de cada mes para la declaración D-104, o el 15 de diciembre para la declaración D-101 anual — el sistema genera y actualiza automáticamente el calendario de obligaciones al inicio de cada período fiscal.Sin embargo, el Ministerio de Hacienda puede emitir resoluciones de prórroga o modificar vencimientos específicos en respuesta a situaciones excepcionales (feriados extendidos, emergencias nacionales, reformas reglamentarias). En esos casos, FiscalHost Inteligente CR no puede garantizar la actualización automática en tiempo real.
Técnico / Sistema
¿Cómo reporto un error de cálculo en el sistema?
¿Cómo reporto un error de cálculo en el sistema?
Si detectas un resultado incorrecto en un cálculo de IVA, renta, retención o cualquier otro módulo, sigue este proceso para reportarlo al equipo de desarrollo:
- Abre un Issue en el repositorio privado de GitHub
FiscalHost-Inteligente-CR. - Asigna la etiqueta de tipo
bug. - Asigna la etiqueta del módulo correspondiente:
M2para errores de IVA,M3para errores de renta,M4para errores de importación, o el módulo que corresponda. - En la descripción del Issue, incluye:
- Pasos exactos para reproducir el error.
- El resultado obtenido por el sistema.
- El resultado esperado y cómo lo calculaste manualmente.
- Capturas de pantalla o fragmentos de datos de ejemplo (sin información personal sensible).
- El equipo priorizará el Issue y, si es un error crítico en producción, lo atenderá mediante el proceso de
hotfix/*.
¿El sistema está disponible para su uso fuera de Costa Rica?
¿El sistema está disponible para su uso fuera de Costa Rica?
FiscalHost Inteligente CR fue diseñado específicamente para el marco fiscal costarricense: las tasas de IVA, los formularios de declaración (D-104, D-101, D-150, D-151), las fechas de vencimiento y los enlaces al portal ATV son propios de Costa Rica y no aplican a otros países. El año fiscal (octubre–septiembre) y los tipos de contribuyente (físico/jurídico bajo el sistema de Hacienda CR) también son particulares del sistema costarricense.El uso del sistema fuera de Costa Rica no está oficialmente soportado y los cálculos producidos no serán válidos para cumplir obligaciones fiscales en otras jurisdicciones. Si tienes propiedades en Costa Rica pero resides en el extranjero como no residente fiscal, el sistema sí es aplicable — en ese caso, revisa la configuración de Tasa de retención (15 % para no residentes) con tu asesor contable.