*MCP › Referencia › Finanzas › Facturas* # Anular una factura > Anula una factura VALIDADA con un motivo, que es obligatorio y se conserva. > **No reversible:** Anular lleva el documento a `voided` y ninguna operación lo deshace. > **Requiere confirmación humana:** Pon esta herramienta en la lista de «preguntar antes de ejecutar» de tu cliente. Las anotaciones son pistas que declara el servidor, no garantías: no decidas la aprobación solo por `destructiveHint`. El servidor marca esta herramienta con `_meta["anthropic/requiresUserInteraction"]`, que los clientes que lo respetan usan para preguntar a una persona antes de cada llamada. La factura conserva su número —anular no libera la numeración, que es lo que mantiene continua la serie— y pasa a `voided`. Solo desde `validated`: un borrador se elimina desde la aplicación, no se anula. NO emite ninguna nota de crédito: si hay que devolver dinero, eso es otro documento. Devuelve la factura completa, la misma proyección que su GET. HERRAMIENTA `filmo_invoices_void` · `invoices:write` · 120/min · Anotación del servidor: Destructiva · Requiere confirmación humana · No reversible ## Argumentos | Nombre | Tipo | Obligatorio | Descripción | | --- | --- | --- | --- | | `invoiceId` | string | Sí | Identificador de la factura. | | `reason` | string | Sí | Motivo de la anulación. Se guarda en la factura y en su historial. | | `idempotencyKey` | string | No | Clave de idempotencia elegida por el cliente (se recomienda un UUID). Repetir la misma clave con los mismos argumentos en 24 h devuelve la respuesta almacenada sin volver a ejecutar; con argumentos distintos responde 422. Es la forma segura de reintentar tras un fallo de red. | | `ifMatch` | string | No | Bloqueo optimista: el meta.etag que obtuviste de la lectura de detalle de este recurso (o "*"). Si el recurso ha cambiado desde entonces, la llamada falla con 412 precondition_failed antes de escribir nada; léelo de nuevo y reintenta. Omítelo para escribir sin condiciones. | ## Resultado En un éxito el resultado lleva `structuredContent` con `data` y `meta`. Estos son los atributos de `data`. | Nombre | Tipo | Descripción | | --- | --- | --- | | `id` | string | Identificador único de la factura. | | `invoiceNumber` | string | Número de factura; null mientras es un borrador (el número se asigna al validarla). | | `status` | string | Estado del ciclo de vida del documento: draft, validated (validado y numerado) o voided. `draft`, `validated`, `voided` | | `isRectification` | boolean | Si la factura rectifica una anterior. Las facturas creadas en Filmo nunca son rectificativas, y las notas de crédito se sirven en `/api/v1/credit-notes`; pero `/api/v1/invoices` aún puede devolver documentos rectificativos importados (por ejemplo, de una importación de Rentman) con este campo en true, así que deduplícalos con las notas de crédito por número. | | `invoiceDate` | string | Fecha de emisión en ISO 8601 con desfase; null mientras es un borrador. | | `dueDate` | string | Fecha de vencimiento en ISO 8601 con desplazamiento; null si no está definida. | | `currency` | string | Moneda de la factura como código ISO 4217 (por ejemplo "EUR"). | | `contact` | object | Referencia compacta al contacto facturado; null si no hay. | | `contact.id` | string | Identificador único del contacto. | | `contact.name` | string | Nombre del contacto. | | `orderId` | string | Identificador del pedido de origen; null si la factura no procede de un pedido. | | `orderNumber` | string | Número del pedido de origen; null si la factura no procede de un pedido. | | `projectId` | string | Identificador del proyecto vinculado; null si no está vinculado. | | `subTotal` | string | Subtotal antes de descuentos e impuestos, como cadena decimal "1234.50" (ROUND_HALF_UP). | | `discountTotal` | string | Total de descuentos como cadena decimal "1234.50" (ROUND_HALF_UP). | | `taxesPrice` | string | Total de impuestos como cadena decimal "1234.50" (ROUND_HALF_UP). | | `netPrice` | string | Base imponible (neto antes de impuestos) como cadena decimal "1234.50" (ROUND_HALF_UP). | | `grossPrice` | string | Total con impuestos, como cadena decimal "1234.50" (ROUND_HALF_UP). | | `totalPaid` | string | Importe cobrado hasta la fecha como cadena decimal "1234.50" (ROUND_HALF_UP); null si no consta. | | `paymentStatus` | string | Estado del pago: unpaid (nada cobrado todavía, también para facturas sin cobro registrado), partially_paid, paid, overpaid (cobrado por encima del total), overdue (vencido y sin pagar) o voided (el documento está anulado, sea cual sea lo cobrado antes). El filtro `paymentStatus` usa los mismos valores. `unpaid`, `partially_paid`, `paid`, `overpaid`, `overdue`, `voided` | | `paymentMethod` | string | Método de pago de la factura; null si no se ha registrado. | | `tags` | object[] | Etiquetas adjuntas a la factura, con su identificador y nombre. | | `tags.id` | string | Identificador único de la etiqueta. | | `tags.name` | string | Nombre de la etiqueta. | | `createdAt` | string | Fecha de creación en ISO 8601 con desplazamiento. | | `updatedAt` | string | Fecha de la última actualización en ISO 8601 con desplazamiento. | | `projectName` | string | Nombre del proyecto vinculado; null si no está vinculado. | | `taxBreakdown` | object[] | Desglose de impuestos por tipo; null si no se ha calculado. | | `taxBreakdown.taxType` | string | Clave del tipo de impuesto (por ejemplo "IVA_21"). | | `taxBreakdown.label` | string | Etiqueta de impuesto legible. | | `taxBreakdown.rate` | number | Tipo impositivo aplicado, como porcentaje (por ejemplo 21 para el 21%). | | `taxBreakdown.baseAmount` | string | Base imponible sobre la que se aplica el impuesto, como cadena decimal "1234.50" (ROUND_HALF_UP). | | `taxBreakdown.amount` | string | Importe del impuesto como cadena decimal "1234.50" (ROUND_HALF_UP). | | `productDiscountTotal` | string | Total de descuentos aplicados a nivel de producto, como cadena decimal "1234.50" (ROUND_HALF_UP). productDiscountTotal + globalDiscountTotal = discountTotal. | | `globalDiscountTotal` | string | Total de descuento global del documento, como cadena decimal "1234.50" (ROUND_HALF_UP). productDiscountTotal + globalDiscountTotal = discountTotal. | | `insuranceTotal` | string | Total del seguro como cadena decimal "1234.50" (ROUND_HALF_UP). | | `depositTotal` | string | Total de fianzas como cadena decimal "1234.50" (ROUND_HALF_UP). | | `exchangeRate` | number | Tipo de cambio aplicado cuando la moneda difiere de la moneda base; null si no aplica. | | `billingAddress` | object | Dirección de facturación; null si no consta. | | `billingAddress.label` | string | Etiqueta descriptiva de la dirección; null si no consta. | | `billingAddress.addressLine1` | string | Primera línea de la dirección; null si no consta. | | `billingAddress.addressLine2` | string | Segunda línea de la dirección; null si no consta. | | `billingAddress.city` | string | Ciudad; null si no consta. | | `billingAddress.province` | string | Provincia o región; null si no se ha registrado. | | `billingAddress.postcode` | string | Código postal; null si no se ha registrado. | | `billingAddress.country` | string | País; null si no consta. | | `sourceQuoteIds` | string[] | Identificadores de los presupuestos de origen; null si la factura no procede de presupuestos. | | `sourceProformaIds` | string[] | Identificadores de las proformas de origen; null si la factura no procede de proformas. | *Llamada · filmo_invoices_void* ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "filmo_invoices_void", "arguments": { "invoiceId": "invo_8f2a1c", "reason": "" } } } ``` *Resultado (generado desde el esquema)* ```json { "structuredContent": { "data": { "id": "id_8f2a1c", "invoiceNumber": "", "status": "draft", "isRectification": true, "invoiceDate": "2026-09-01T08:00:00Z", "dueDate": "2026-09-01T08:00:00Z", "currency": "EUR", "contact": { "id": "id_8f2a1c", "name": "Example" }, "orderId": "orde_8f2a1c", "orderNumber": "", "projectId": "proj_8f2a1c", "subTotal": "1234.50", "discountTotal": "1234.50", "taxesPrice": "1234.50", "netPrice": "1234.50", "grossPrice": "1234.50", "totalPaid": "1234.50", "paymentStatus": "unpaid", "paymentMethod": "", "tags": [ { "id": "id_8f2a1c", "name": "Example" } ], "createdAt": "2026-09-01T08:00:00Z", "updatedAt": "2026-09-01T08:00:00Z", "projectName": "Example", "taxBreakdown": [ { "taxType": "1234.50", "label": "Example", "rate": 1, "baseAmount": "1234.50", "amount": "1234.50" } ], "productDiscountTotal": "1234.50", "globalDiscountTotal": "1234.50", "insuranceTotal": "1234.50", "depositTotal": "1234.50", "exchangeRate": 1, "billingAddress": { "label": "Example", "addressLine1": "", "addressLine2": "", "city": "", "province": "", "postcode": "", "country": "ES" }, "sourceQuoteIds": [ "sour_8f2a1c" ], "sourceProformaIds": [ "sour_8f2a1c" ] }, "meta": { "idempotencyKey": "", "rateLimit": { "limit": 120, "remaining": 119, "reset": 42 } } } } ``` ## La misma operación por REST Esta herramienta ejecuta [`POST /api/v1/invoices/{invoiceId}/void`](https://docs.filmo.io/es/rest-api/endpoint-reference/invoices/void-an-invoice). --- URL canónica: https://docs.filmo.io/es/mcp/tools/invoices/filmo-invoices-void Última actualización: 2026-10-25