ALaltoviz
SalesInvoices

Finalize a draft invoice

Changed on
post/v1/salesinvoices/finalize/{id}

Request

Path parameters

idinteger required

Draft invoice ID

Query parameters

finalizationDatestring date

Date the invoice is finalized on. Defaults to the invoice's own date.

dateAdjustment'None' | 'MinimumDate' | 'Today'

How the invoice date is recalculated when it prevents finalization, i.e. when it is earlier than the last finalized invoice or too far in the future. None (default): keep the date, finalization fails. MinimumDate: use the date of the last finalized invoice. Today: use today's date. When finalizationDate is also supplied, it is used first and this only applies if that date cannot be finalized on. Due dates are recalculated from the resulting date.

Response

OK

balancenumber double

Balance

cancellationCreditIdinteger nullable

Credit ID which cancel this invoice

cancellationCreditNumberstring nullable

Credit number which cancel this invoice

cancelledCreditIdinteger nullable

ID of the credit that THIS invoice cancels (set when the invoice was issued to offset a credit)

cancelledCreditNumberstring nullable

Number of the credit that THIS invoice cancels

customerElectronicAddressstring nullable

Customer electronic address

customerIdinteger nullable

Customer ID

customerNamestring nullable

Customer name

customerNumberstring nullable

Customer number

customerOrderReferencestring nullable

Customer order reference

customerSiretstring nullable

Customer SIRET

customerType'Business' | 'Consumer' | 'Government'
customerVatNumberstring nullable

Customer VAT number

datestring date nullable

Date

eInvoicingInvoiceIdstring nullable

E-invoicing identifier assigned by the platform

eInvoicingProviderIdstring nullable

E-invoicing platform (PDP) identifier

eInvoicingStatus'api:uploaded' | 'api:invalid' | 'api:validated' | 'api:sent' | 'api:rejected' | 'api:received' | 'api:acknowledged' | 'api:accepted' | 'fr:200' | 'fr:201' | 'fr:202' | 'fr:203' | 'fr:204' | 'fr:205' | 'fr:206' | 'fr:207' | 'fr:208' | 'fr:209' | 'fr:210' | 'fr:211' | 'fr:212' | 'fr:213' | 'fr:501' | 'fr:214' | 'fr:220' | 'fr:221' | 'fr:224' | 'fr:225' | 'fr:226' | 'fr:227' | 'fr:228' | 'aoz:autherror' | 'aoz:error' | 'aoz:invalid' | 'aoz:importerror' | 'aoz:processed' | 'ppf:validated' | 'ppf:validated-ack' | 'ppf:validated-ack-error' | 'ppf:validated-rejected' | 'ppf:refused' | 'ppf:refused-ack' | 'ppf:refused-ack-error' | 'ppf:refused-rejected' | 'ppf:payment-received' | 'ppf:payment-received-ack' | 'ppf:payment-received-ack-error' | 'ppf:payment-received-rejected' | 'ppf:rejected' | 'ppf:rejected-ack' | 'ppf:rejected-ack-error' | 'ppf:rejected-rejected' | 'ppf:flow-1' | 'ppf:flow-1-ack' | 'ppf:flow-1-ack-error' | 'ppf:flow-1-response-ok' | 'ppf:flow-1-rejected'
footerNotesstring nullable

Footer notes to be print

grossTaxExcludedAmountnumber double

Gross tax excluded amount

headerNotesstring nullable

Header notes to be print

idinteger

Invoice ID

internalIdstring nullable

ID used in your system

internalNotesstring nullable

Internal notes

isCancelledboolean

Indicates whether invoice is cancelled

isDraftboolean

Indicates whether invoice is draft. Otherwise invoice cannot be modified

isPaidboolean

Indicates whether invoice is paid

isProformaboolean

Indicates whether invoice is proforma

liableToVatboolean nullable

Indicates whether the document is liable to VAT

metadataobject nullable

Metadata: free-form key/value pairs carried with the document, for an integration to keep its own identifiers and flags against it.

Sent as a PATCH, not a replacement: keys you send are added or updated, keys you leave out keep whatever they held, and a key is removed only when you send it as null. Omitting the property entirely leaves the whole bag untouched, and "" stores an empty value rather than removing the key.

numberstring nullable

Number

overduenumber double

Overdue

pdfUrlstring nullable

Pdf url

publicLinkstring nullable

Public link

region'FR' | 'EU' | 'IE' | 'DOM' | 'Corse' | 'Monaco'
replacedByinteger nullable

Replacement invoice ID

sentAtstring date-time nullable

Sent at

shippingAmountnumber double

Shipping amount

subjectstring nullable

Subject

taxAmountnumber double

Total tax amount

taxExcludedAmountnumber double

Tax excluded amount (discount included)

taxIncludedAmountnumber double

Tax included amount

useTaxIncludedPricesboolean

Indicates whether invoice prices and amount are tax included

vatMode'Auto' | 'Debit' | 'Collection'
vatNotestring nullable

VAT note to print

vatReverseChargeboolean

VAT reverse charge

vendorReferencestring nullable

Vendor reference to be print

Changes