ALaltoviz
SaleCredits

Finalize a draft credit

Changed on

Deprecated — use /v1/SalesCredits/Finalize/{id} instead. This route still works and returns the same result; only the spelling of the resource changed.

post/v1/salecredits/finalize/{id}

Request

Path parameters

idinteger required

Draft credit ID

Query parameters

finalizationDatestring date

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

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

How the credit date is recalculated when it prevents finalization, i.e. when it is earlier than the last finalized credit or too far in the future. None (default): keep the date, finalization fails. MinimumDate: use the date of the last finalized credit. 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

cancellationInvoiceIdinteger nullable

ID of the invoice that cancelled this credit

cancellationInvoiceNumberstring nullable

Number of the invoice that cancelled this credit

cancelledInvoicetIdinteger nullable

Invoice ID which this credit cancelled

cancelledInvoicetNumberstring nullable

Invoice number which this credit cancelled

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

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

True when this credit has itself been cancelled by an invoice

isDraftboolean

Indicates whether invoice is draft. Otherwise invoice cannot be modified

isPaidboolean

Indicates whether invoice is paid

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

ID of the corrected credit that replaces this one

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

  • 4f7fa64cf9e3Revision changes
    • warning

      removed the optional property // from the response with the status (media type: text/plain)

    • warning

      removed the optional property // from the response with the status (media type: application/json)

    • warning

      removed the optional property // from the response with the status (media type: text/json)

    • info

      endpoint deprecated

    • info

      added the optional property // to the response with the status (media type: text/plain)

    • info

      added the optional property // to the response with the status (media type: application/json)

    • info

      added the optional property // to the response with the status (media type: text/json)

    • info

      added the optional property /// to the response with the status (media type: text/plain)

    • info

      added the optional property /// to the response with the status (media type: application/json)

    • info

      added the optional property /// to the response with the status (media type: text/json)

    • info

      added the optional property /// to the response with the status (media type: text/plain)

    • info

      added the optional property /// to the response with the status (media type: application/json)

    • info

      added the optional property /// to the response with the status (media type: text/json)

    • info

      added the optional property /// to the response with the status (media type: text/plain)

    • info

      added the optional property /// to the response with the status (media type: application/json)

    • info

      added the optional property /// to the response with the status (media type: text/json)

    • info

      added the optional property /// to the response with the status (media type: text/plain)

    • info

      added the optional property /// to the response with the status (media type: application/json)

    • info

      added the optional property /// to the response with the status (media type: text/json)

    • info

      added the optional property /// to the response with the status (media type: text/plain)

    • info

      added the optional property /// to the response with the status (media type: application/json)

    • info

      added the optional property /// to the response with the status (media type: text/json)

    • info

      added the optional property /// to the response with the status (media type: text/plain)

    • info

      added the optional property /// to the response with the status (media type: application/json)

    • info

      added the optional property /// to the response with the status (media type: text/json)

    • info

      response property lines/items/product/isUnitPriceTaxIncluded deprecated (media type: text/plain)

    • info

      response property lines/items/product/isUnitPriceTaxIncluded deprecated (media type: application/json)

    • info

      response property lines/items/product/isUnitPriceTaxIncluded deprecated (media type: text/json)

    • info

      response property lines/items/product/unitPrice deprecated (media type: text/plain)

    • info

      response property lines/items/product/unitPrice deprecated (media type: application/json)

    • info

      response property lines/items/product/unitPrice deprecated (media type: text/json)

  • e65392ac5b5fRevision changes
    • info

      added the new optional query request parameter dateAdjustment

    • info

      added the new optional query request parameter finalizationDate

    • info

      added the optional property to the response with the status (media type: text/plain)

    • info

      added the optional property to the response with the status (media type: application/json)

    • info

      added the optional property to the response with the status (media type: text/json)

    • info

      added the optional property to the response with the status (media type: text/plain)

    • info

      added the optional property to the response with the status (media type: application/json)

    • info

      added the optional property to the response with the status (media type: text/json)

    • info

      added the optional property to the response with the status (media type: text/plain)

    • info

      added the optional property to the response with the status (media type: application/json)

    • info

      added the optional property to the response with the status (media type: text/json)

    • info

      added the optional property to the response with the status (media type: text/plain)

    • info

      added the optional property to the response with the status (media type: application/json)

    • info

      added the optional property to the response with the status (media type: text/json)