Advance a fixed cost now
recurring_advanceAdvance a recurring expense template's next due date by one interval without booking a payment; requires the current cycle to be booked and uses expectedNextDueAt to prevent double advancement.
Instructions
Skip ahead one cycle: moves ONLY nextDueAt on by intervalMonths, without creating an expense. It only works once an expense was booked for the current due date, otherwise 409 recurring_expense_not_booked, and a paused template answers 400 recurring_paused. Any member may call it. To book the due payment use expense_create with recurringExpenseId and expectedRecurringNextDueAt instead: it creates the expense and advances the template in one step. To change the schedule itself use recurring_update. expectedNextDueAt is required and prevents double advancing: if the cycle was already advanced, 409 recurring_expense_already_advanced and nothing changes. Returns the updated template as recurringExpense.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>",
"expectedNextDueAt": "<expectedNextDueAt>"
},
"name": "recurring_advance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Id of the fixed-cost template, as returned in recurringExpenses[].id by recurring_list or in recurringExpense.id by recurring_create. | |
| wgCode | No | Share code of the flat (code from wg_list). Leave it out when the account belongs to one flat. | |
| expectedNextDueAt | Yes | nextDueAt of the template as you last read it from recurring_get or recurring_list (ISO 8601 with offset). Used as a concurrency guard. |