beel_create_recurring_invoice

es.beel/mcp · Verify this server

Creates a recurring invoice template under this company: the invoice data it repeats (lines, recipient, series, payment) plus the recurrence that drives it. - **Cadence:** generation runs monthly on `day_of_month`, from `start_date` until `end_date` if one is given. `frequency` only accepts `MONTHLY`. - **`start_date` in the past:** accepted and stored as sent, but it never anchors generation backwards. `next_generation` moves to the first upcoming `day_of_month`, and the missed periods are not generated. - **`preview_days`:** how many days before the emission date the invoice is created as a draft for review. `0`, the default, means immediate emission. - **VeriFactu:** omitting `verifactu_enabled` applies the company's declared preference (`apply_by_default`, resolving to `false` when the company has no VeriFactu configuration). The resolved value is frozen into the template at creation time, so changing that preference later does not alter templates that already exist. Endpoint: POST /v1/companies/{company_id}/recurring-invoices ⚠️ Fiscal guardrails — read before calling: - How BeeL derives the AEAT invoice type, and the rules each type imposes. (resource: beel://guardrails/invoice-types) - What regime_key means, where it lives, and which combinations are rejected. (resource: beel://guardrails/regime-keys) For the exhaustive rules and worked examples, call beel_docs_search.