Skip to main content

Documentation 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.

Meeting tax deadlines in Costa Rica is not optional. Hacienda applies automatic penalties for late or missing declarations — including interest charges (intereses moratorios), fixed fines (multas), and in repeated cases, suspension of your RUC registration. FiscalHost Inteligente CR’s alerts module monitors every tax obligation tied to your fiscal profile and notifies you with enough advance notice to generate your reports, verify your figures, and file without last-minute pressure.

​
Why Alerts Matter

Penalty TypeTriggerAmount
Mora (interest)Tax paid after the due dateBCCR base rate + 1% per month on unpaid amount
Multa por omisiónDeclaration not filed50% of the tax due, with a minimum of 3 base salaries (≈ ₡1.4 million)
Multa por inexactitudIncorrect figures on declaration25% of the understated tax
Cierre tributarioRepeated non-complianceTemporary business closure ordered by Hacienda
A single missed D-104 declaration can cost significantly more than the IVA itself. Configuring alerts ensures that no deadline passes unnoticed, even during busy rental seasons.

​
Types of Alerts

FiscalHost Inteligente CR generates three categories of alerts for each monitored tax obligation:

​
Pre-vencimiento

Sent in advance of the filing deadline. You can configure how many days before the deadline each alert fires — the available options are 15, 7, 3, and 1 days. Multiple pre-vencimiento alerts can be active simultaneously for the same obligation (e.g., alerts at day 15, day 7, and day 1 all enabled).

​
Vencimiento

Sent on the exact day the declaration is due. This alert serves as a final same-day reminder if no prior alert has been acted upon. It appears as a high-priority notification in the Panel de Alertas dashboard and triggers an email regardless of your other notification settings.

​
Post-vencimiento

Sent when a deadline has passed and the obligation has not been marked as filed in FiscalHost. The system sends a post-vencimiento alert at 1 day overdue, 3 days overdue, and 7 days overdue. These alerts include a direct link to the ATV portal and the corresponding report so you can file immediately.

​
Default Alert Schedule

The following table shows the default alert configuration that FiscalHost Inteligente CR applies when you first set up the alerts module. You can customize all values per obligation.
ObligationFormFrequencyDefault Pre-alerts (days before)VencimientoPost-vencimiento
IVA mensualD-104Monthly7, 3, 1✓Day 1, 3, 7
Renta anualD-101Annual15, 7, 3, 1✓Day 1, 3, 7
Pago a cuenta Q1—March15, 7, 3✓Day 1, 3
Pago a cuenta Q2—June15, 7, 3✓Day 1, 3
Pago a cuenta Q3—September15, 7, 3✓Day 1, 3
Pago a cuenta Q4—December15, 7, 3✓Day 1, 3
Resumen de retencionesD-151Annual (Feb)15, 7, 3, 1✓Day 1, 3, 7

​
Configuring Alerts

1
Go to Configuración → Alertas
2
From the Panel Principal, click Configuración in the left sidebar, then select Alertas from the submenu. The Alertas configuration screen lists every tax obligation associated with your fiscal profile.
3
Select which obligations to monitor
4
Each row in the list corresponds to a tax obligation. Toggle on the obligations you want FiscalHost to track:
5
  • ✅ IVA Mensual (D-104) — recommended for all hosts in Régimen Tradicional.
  • ✅ Renta Anual (D-101) — required for all hosts filing annual income tax.
  • ✅ Pagos a Cuenta — quarterly advance payments; highly recommended (see tip below).
  • ☑ D-151 (Resumen de retenciones) — required only if you make payments to third parties subject to withholding (e.g., employees, contractors above ₡1 million/month).
    • 6
    Obligations that are not applicable to your fiscal profile (e.g., Régimen Simplificado hosts do not file D-101 the same way) will be grayed out automatically.
    7
    Set advance notification days
    8
    For each enabled obligation, click the Editar icon to expand its configuration panel. Under Alertas previas, check the boxes for the days-in-advance you want notifications:
    9
  • 15 días — ideal for annual declarations (Renta, D-151) that require more preparation time.
  • 7 días — recommended for monthly IVA filings.
  • 3 días — a reliable second reminder for all obligations.
  • 1 día — final same-day-minus-one alert for any obligations where you want maximum lead time.
    • 10
    You may enable multiple advance alerts for a single obligation.
    11
    Choose notification channels
    12
    Under Canales de notificación, select how you want to receive each alert:
    13
  • In-app — alerts appear in the bell icon notification center (🔔) at the top of the FiscalHost dashboard. Always enabled; cannot be disabled.
  • Correo electrónico — alerts are sent to the email address registered in your fiscal profile. Toggle on/off per obligation and per advance day as needed.
    • 14
    Ensure your fiscal email address is up to date in Configuración → Perfil Fiscal before saving alert settings.
    15
    Save and test notification
    16
    Click Guardar Configuración de Alertas at the bottom of the page. To verify the configuration is working, click Enviar Alerta de Prueba next to any obligation. FiscalHost will send a test notification through all enabled channels within one minute. Check your email inbox and the in-app notification center to confirm delivery.

    ​
    Alert Status Dashboard

    Navigate to Alertas → Panel de Alertas to see a real-time summary of all your tax obligations and their current status:
    StatusDescriptionBadge Color
    PendienteDeadline is more than 15 days away; no action required yet.Gray
    PróximoDeadline is within your configured pre-alert window.Yellow
    HoyDeadline is today.Orange
    VencidoDeadline has passed and the obligation has not been marked as filed.Red
    CompletadoObligation has been marked as filed with a confirmation number.Green
    The dashboard displays obligations in chronological order by due date. Click any row to open the obligation detail view, which shows the computed tax amount, the associated report, and a direct link to the corresponding ATV declaration form.

    ​
    Marking an Obligation as Filed

    Once you have submitted your declaration on ATV and received a confirmation number, return to FiscalHost and mark the obligation as completed:
    1. In Panel de Alertas, locate the obligation row and click Marcar como Declarado.
    2. Enter the número de confirmación provided by ATV.
    3. Enter the fecha de presentación (filing date) and the monto pagado (amount paid, if a payment was required).
    4. Click Confirmar.
    The obligation status changes to Completado (green), the alert is silenced, and the record is saved to Historial de Declaraciones with full audit trail.
    FiscalHost Inteligente CR alerts are based on standard Hacienda filing calendars and the configuration in your profile. Do not rely solely on these alerts to know your actual deadlines. Hacienda occasionally modifies deadlines for specific periods (for example, extensions granted after natural disasters or system failures). Always verify the current filing calendar directly on the ATV portal or with your certified public accountant (contador público autorizado) before each filing period.
    For quarterly pagos a cuenta, set alerts at both 15 days and 7 days in advance. These payments are easy to overlook because they fall on irregular dates throughout the year and do not require uploading a formal declaration — just a bank transfer with the correct reference code. Having two advance alerts gives you enough time to calculate the correct amount and initiate the transfer before the deadline.

    Módulo de Alertas

    Full reference for the deadline alerts module, including all configurable options, notification channels, and obligation management.

    Generar Reportes

    Learn how to generate IVA and income tax reports so you are ready to file as soon as an alert fires.

    Build docs developers (and LLMs) love

    Get started for freeTalk to us