invoices_update
Idempotent
Update draft invoices by UUID before issuance, including line items, dates, and payment terms. Replaces the entire lines array, so include all lines you want to keep.
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
| 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 |