invoices_update
Update an existing draft invoice by modifying details or replacing its line items. Only draft invoices can be updated; issued invoices must be canceled instead.
Instructions
Update an existing draft invoice. Only invoices with status "draft" can be updated. When updating the lines array, the entire array is replaced — include all lines you want to keep. Once issued, use invoices_cancel instead.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uuid | Yes | Invoice UUID to update | |
| lines | No | Invoice line items. WARNING: replaces all existing lines — include every line you want to keep. | |
| notes | No | Public notes visible to the client | |
| dueDate | No | Payment due date (YYYY-MM-DD) | |
| clientId | No | Client UUID | |
| currency | No | ISO 4217 currency code | |
| issuerId | No | Issuer ID number | |
| language | No | Document language for PDF generation (default: ro) | |
| mentions | No | Additional legal mentions | |
| seriesId | No | Invoice series UUID | |
| companyId | No | Company UUID override (uses active company if not set) | |
| issueDate | No | Invoice issue date (YYYY-MM-DD) | |
| deputyAuto | No | Deputy vehicle registration | |
| deputyName | No | Deputy/representative name | |
| issuerName | No | Name of person issuing the invoice | |
| salesAgent | No | Sales agent name | |
| orderNumber | No | Purchase order number | |
| plataOnline | No | Enable online payment via Stripe | |
| platitorTva | No | Whether sender is VAT payer | |
| receiverCif | No | Receiver tax ID / CIF | |
| vatIncluded | No | When used with autoApplyVatRules, sets whether unit prices include VAT on all lines. Ensures correct totals after VAT rules change rates. | |
| documentType | No | Document type | |
| exchangeRate | No | Exchange rate relative to RON | |
| internalNote | No | Internal note (not visible to client) | |
| paymentTerms | No | Payment terms description | |
| receiverName | No | Receiver name (when no client entity exists) | |
| taxPointDate | No | Tax point date (YYYY-MM-DD) | |
| paymentMethod | No | Payment method: bank_transfer, cash, card, cheque, other | |
| tvaLaIncasare | No | VAT on collection / TVA la încasare | |
| ublExtensions | No | UBL extension fields for advanced e-Factura compliance. These map directly to UBL XML elements not covered by the standard invoice fields. | |
| buyerReference | No | Buyer reference identifier | |
| contractNumber | No | Contract reference number | |
| penaltyEnabled | No | Enable late payment penalty | |
| invoiceTypeCode | No | Tax regime / invoice type code | |
| deliveryLocation | No | Delivery address | |
| parentDocumentId | No | Parent document UUID (for credit notes) | |
| penaltyGraceDays | No | Grace period before penalty applies | |
| projectReference | No | Project reference number | |
| taxPointDateCode | No | Tax point date code | |
| autoApplyVatRules | No | Auto-apply VAT rules (reverse charge for VIES-valid EU clients, OSS destination rate for non-VIES EU clients). Default: false. | |
| showClientBalance | No | Show client balance on invoice | |
| deputyIdentityCard | No | Deputy ID card number | |
| businessProcessType | No | Business process type | |
| penaltyPercentPerDay | No | Daily penalty percentage | |
| tenderOrLotReference | No | Tender or lot reference | |
| despatchAdviceReference | No | Despatch advice reference | |
| buyerAccountingReference | No | Buyer accounting reference | |
| invoicedObjectIdentifier | No | Invoiced object identifier | |
| receivingAdviceReference | No | Receiving advice reference |