beel_create_corrective_invoice

es.beel/mcp · Verify this server

Issues a corrective invoice that amends the invoice in the path. It is a new fiscal document with its own number, not an edit of the original. - **`rectification_type`:** `TOTAL` leaves the original `VOIDED` and copies its lines negated when `lines` is omitted. `PARTIAL` leaves the original `RECTIFIED` and requires the adjustment `lines`. - **What can be rectified:** an ordinary or simplified invoice in `ISSUED`, `SENT`, `PAID`, `OVERDUE` or `RECTIFIED`. Rectifying a corrective fails with `422 CORRECTIVE_NOT_RECTIFIABLE` — to fix an erroneous corrective, issue another one against the original invoice. - **Repeat rectifications:** several `PARTIAL` correctives are allowed, but a `VOIDED` invoice is no longer rectifiable, so a second `TOTAL` against the same invoice fails with `422 INVOICE_NOT_CORRECTIBLE_IN_CURRENT_STATUS`. - **`series_id`:** when omitted, the document is numbered in the company's default corrective series, never in the series of the original. That default is never created for you: if the company has none the request fails with `422 SERIES_DEFAULT_NOT_FOUND`, and `GET /v1/configuration/series/defaults-status` reports which default is missing. Endpoint: POST /v1/companies/{company_id}/invoices/{invoice_id}/corrective ⚠️ Fiscal guardrails — read before calling: - Choosing wrong here misreports to AEAT. The 30-second decision. (resource: beel://guardrails/cancel-vs-rectify) - How BeeL derives the AEAT invoice type, and the rules each type imposes. (resource: beel://guardrails/invoice-types) - How a line states its price, and which field combinations are rejected. (resource: beel://guardrails/invoice-lines) - When an invoice can still be changed, and what to do once it cannot. (resource: beel://guardrails/invoice-state-machine) - How invoice numbers are formed, and why numbering can never be rewritten. (resource: beel://guardrails/series-and-numbering) For the exhaustive rules and worked examples, call beel_docs_search.