What are Recurring Transactions?
The Recurring Transactions module lets you automate any financial event that happens on a regular schedule. Instead of manually adding your salary credit every month, your Netflix debit each month, or your SIP investment each cycle, you define a schedule once â and Wevanta creates the actual transaction entries in your account automatically, on the correct date, every cycle, forever.
This is different from the Reminders module. Reminders alert you to take action (you still pay and record it manually). Recurring Transactions actually create the transaction entries for you with zero manual intervention.
Step 1: Creating a Recurring Schedule
Go to Transactions â Recurring and click + Add Recurring. A modal opens with the following fields:
| Field | What to Enter | Required? |
|---|---|---|
| Title | A clear name that will appear on every auto-created transaction. Examples: Monthly Salary, Netflix âš649, HDFC SIP, Home Loan EMI, Office Rent Collection. This becomes the transaction description â keep it precise so your accounts stay clean. | â Required |
| Type | Expense â money going out (rent, subscriptions, utility bills, EMIs). Income â money coming in (salary, rental income collected, dividend). SIP / Investment â recurring investment debit. EMI / Loan â loan repayment outflow. The type drives the green/red colouring and the income vs. expense classification in your reports. | â Required |
| Category | A free-text label for grouping (e.g., Entertainment, Salary, Utilities). This appears as the category on every auto-generated transaction â used for filtering and reporting. | Optional |
| Amount (âš) | The fixed amount for each occurrence. Must be a positive number. If the amount varies month to month (e.g., electricity bills), use Reminders instead â Recurring Transactions are best for fixed amounts only. | â Required |
| Account | Which of your accounts this transaction applies to. The auto-created transaction will be posted to this account â affecting its running balance. Examples: link salary to your HDFC Savings account; link SIP to your Zerodha account; link Netflix to your credit card account. | â Required |
| Frequency | Daily â runs every day (pocket money, daily wage income). Weekly â runs every 7 days (weekly pocket money, web scraping subscription). Monthly â runs every month (the most common: salary, rent, EMI, SIP, Netflix). Quarterly â runs every 3 months (insurance premium, school fees). Yearly â runs once per year (annual subscription, property tax, renewal). | â Required |
| Next Run Date | The date of the very first occurrence (or the next upcoming occurrence, if this is an existing schedule you are migrating). Wevanta uses this date to create the first transaction and then auto-advances it after each run. Set this to the next calendar date this event is due â e.g., if your salary comes on the 1st, set this to the 1st of next month. | â Required |
Step 2: The Automatic Processing Engine
This is the core of the module. Wevanta runs a background scheduler (Wevanta:process-recurring) every day. Here is exactly what it does:
- It queries all Active recurring schedules where
next_run_atis on or before today. - For each one, it creates a real Transaction entry in your account with the exact date, amount, type, category, and title from the schedule.
- It records
last_run_at = todayon the schedule. - It advances
next_run_atby the correct interval (Daily: +1 day, Weekly: +7 days, Monthly: +1 month, Quarterly: +3 months, Yearly: +1 year). - If the scheduler missed several cycles (e.g., a server was down for 3 days), it catches up â it loops and creates one transaction per missed cycle, correctly backdated.
Step 3: The Recurring Schedule List
The Recurring Transactions page shows all your active and paused schedules as cards. Each card shows:
- đ Green background for income / đ Red background for expenses.
- The Title, Type badge (INCOME / EXPENSE / SIP / EMI), Frequency, Linked Account name, and Next Run Date.
- The Amount in green (+) for income or red (-) for expenses.
- Action buttons: ⸠Pause / âļ Resume, Edit, and Delete.
Paused schedules are shown at reduced opacity (60%) so you can see them but know they are inactive.
Step 4: Pausing and Resuming a Schedule
Click ⸠Pause on any active schedule. The schedule is immediately marked inactive â the scheduler will skip it on its next run. No transactions are deleted or reversed. Click âļ Resume to re-activate it. On resume, the Next Run Date remains what it was when you paused â so if you paused a monthly schedule and resume it 2 weeks later, it will run on the originally set date.
Step 5: Editing a Schedule
Click Edit on any schedule. The same modal reopens with all current values pre-filled. You can change any field â including the Next Run Date (to skip an already-missed cycle), the amount (e.g., salary increment), or the account (if you change banks). Changes take effect from the very next scheduler run.
Step 6: What Gets Created in Your Accounts
Every auto-created transaction has these exact fields populated from your schedule:
- Date: The
next_run_atdate at the time of processing (accurately backdated if missed). - Amount: Exactly as defined in the schedule.
- Type: Income / Expense / SIP / EMI.
- Category: Exactly as defined in the schedule.
- Description: "Auto-generated" (or your custom description if you filled it).
These transactions appear in your Account Ledger, Cash Flow Report, and Budget Actuals just like any manually entered transaction.