What are recurring expenses
Any expense can be made recurring by settingesRecurrente: true when creating or editing it. Once marked as recurring, the expense gains two additional attributes:
frecuenciaRecurrencia— how often the charge repeats (monthly, quarterly, semi-annual, or annual).proximoPago— the next date on which the payment is due.
/api/expenses/upcoming endpoint queries all recurring expenses and returns those whose proximoPago falls within the next 30 days. This powers the Upcoming expenses view and the sidebar badge count.
Setting up a recurring expense
Create a new expense
Go to Add Expense and fill in the vehicle, category, amount, description, and date as you normally would. See Expenses for the full add-expense walkthrough.
Toggle 'Is recurring'
Enable the Is recurring toggle (
esRecurrente). Two new fields appear below the toggle.Choose a frequency
Select how often this charge recurs using the Frequency dropdown (
frecuenciaRecurrencia). The four options are Mensual, Trimestral, Semestral, and Anual.Set the next payment date
Enter the date of the next upcoming payment in the Next payment date field (
proximoPago). This date is what the system uses to determine whether the expense appears in the upcoming-expenses window.Recurrence frequencies
Mensual — Monthly
Mensual — Monthly
The expense repeats every month. Use this for costs billed on a monthly cycle.Common examples:
- Monthly parking garage subscription (Estacionamiento)
- Monthly vehicle financing installment (Financiamiento)
- Monthly toll road pass (Peajes)
proximoPago to the same day next month.Trimestral — Quarterly
Trimestral — Quarterly
The expense repeats every three months. Use this for costs billed four times per year.Common examples:
- Quarterly vehicle inspection fee (Registro)
- Quarterly insurance installment when paying in four parts (Seguro)
proximoPago by three months.Semestral — Semi-annual
Semestral — Semi-annual
The expense repeats every six months. Use this for costs billed twice per year.Common examples:
- Semi-annual insurance premium payment (Seguro)
- Semi-annual registration renewal in some jurisdictions (Registro)
proximoPago by six months.Anual — Annual
Anual — Annual
The expense repeats once per year. Use this for yearly renewals and annual fees.Common examples:
- Annual vehicle insurance renewal (Seguro)
- Annual registration / road tax (Registro)
- Annual vehicle inspection (Impuestos)
proximoPago by one year.Upcoming expenses view
The Upcoming expenses page (/upcoming-expenses) shows all recurring expenses whose proximoPago is within the next 30 days, across all vehicles.
Each row in the list shows:
| Field | Description |
|---|---|
| Vehicle | The vehicle alias this expense belongs to (vehicleAlias). |
| Category | The expense category (categoria). |
| Description | The short description entered when the expense was created (descripcion). |
| Amount | The recurring amount (monto). |
| Due date | The next payment date (proximoPago). |
| Frequency | How often the expense recurs (frecuenciaRecurrencia). |
The upcoming expenses window is fixed at 30 days from today. An expense only appears in this view if its
proximoPago date is between today and 30 days from now. Expenses with a proximoPago further in the future are not shown until they enter the window.Navigation badges
The sidebar navigation item Gastos recurrentes (Recurring expenses) displays a numeric badge when you have expenses due soon. The badge count comes from theuseUpcomingCounts hook, which polls /api/expenses/upcoming every five minutes and returns the count of recurring expenses due within the next 30 days.
If the count is zero, no badge is shown. If the API call fails, the badge gracefully disappears rather than showing an error.
Editing the next payment date
After you pay a recurring expense, update itsproximoPago to the next scheduled due date so the expense stays accurate:
- Open Expenses history (
/expenses-history). - Find the expense and click the edit button.
- Update the Next payment date (
proximoPago) to the next billing cycle date. - Save the changes.
proximoPago enters the 30-day window.
Related pages
Expenses
Learn how to add, filter, and manage all vehicle expenses.
Maintenance
Track scheduled maintenance with its own upcoming-service reminder system.