Update Invoice
update_invoiceIdempotent
Update an existing invoice by providing only the fields to change. Mark invoices as paid, modify line items, or adjust client details.
Instructions
Update an existing invoice using PATCH semantics. Only the provided fields will be changed. Example: id='abc123', status='paid' to mark an invoice as paid. / Actualiza una factura existente. Solo se modifican los campos proporcionados.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Invoice ID / ID de la factura | |
| items | No | Line items / Conceptos | |
| notes | No | Notes / Notas | |
| status | No | Invoice status / Estado | |
| dueDate | No | Due date (YYYY-MM-DD) / Fecha de vencimiento | |
| taxRate | No | Tax rate % / IVA % | |
| clientId | No | Existing client ID — server back-fills taxId/address / ID de cliente existente | |
| irpfRate | No | IRPF withholding % (retencion autonomo ES, e.g. 15 or 7) / Retencion IRPF % | |
| poNumber | No | Client purchase-order reference / Numero de pedido del cliente | |
| seriesId | No | Invoice numbering series ID / ID de serie de numeracion | |
| issueDate | No | Issue date (YYYY-MM-DD) / Fecha de emision | |
| clientName | No | Client name / Nombre del cliente | |
| prepayment | No | Prepaid/advance amount already collected in EUR / Anticipo cobrado en EUR | |
| clientTaxId | No | Client tax ID (NIF/CIF/VAT) shown on the invoice / NIF/CIF del cliente | |
| discountRate | No | Global discount % applied to the invoice / Descuento global % | |
| clientAddress | No | Client billing address shown on the invoice / Direccion fiscal del cliente | |
| operationType | No | Operation type (service or goods) / Tipo de operacion | |
| clientLocation | No | Fiscal zone driving IVA vs IGIC vs exempt / Zona fiscal (IVA/IGIC/exento) | |
| documentNumber | No | Externally-issued number for import (honored verbatim) / Numero externo para importacion | |
| equivalenceSurchargeRate | No | Recargo de equivalencia % (ES retail regime) / Recargo de equivalencia % |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| items | No | ||
| notes | No | ||
| total | No | ||
| status | No | ||
| dueDate | No | ||
| taxRate | No | ||
| createdAt | No | ||
| issueDate | No | ||
| updatedAt | No | ||
| clientName | No |