beel_skip_recurring_invoice
Skips the next scheduled invoice generation for a recurring invoice and advances its generation date to the following period, issuing nothing.
Instructions
Skips the next scheduled invoice generation and advances the generation date to the following period. Nothing is issued.
BeeL API endpoint: POST /v1/companies/{company_id}/recurring-invoices/{recurring_invoice_id}/skip (reference: https://docs.beel.es)
⚠️ Read before calling:
Fiscal rules, domains simplified, taxes: beel_rules_list with domain, or resource beel://guardrails/.
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": {
"company_id": "<company_id>",
"recurring_invoice_id": "<recurring_invoice_id>"
},
"name": "beel_skip_recurring_invoice"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| company_id | Yes | Unique identifier (UUID) of the company the operation acts on — its identifier, not its NIF. It is the only source of context: the account that owns it is derived from it, and the `BeeL-Active-Company` header plays no part. A company you do not reach answers `403`, and so does a company that does not exist, so the existence of a company in another account is never disclosed. | |
| idempotency_key | No | Optional idempotency key for this operation. Omit it and one is derived from the request itself, which makes a blind retry safe but also collapses a SECOND, deliberately identical operation into the first for 24 hours. Set it — to an order id, or anything unique per intended operation — whenever you mean to create something that may look identical to what you just created. | |
| recurring_invoice_id | Yes | Unique identifier (UUID) of the recurring invoice template, as returned when it is created or listed. A template of another company answers `404` with `RECURRING_NOT_FOUND`, exactly like one that does not exist. |