Moloni ON Logo WhiteGuidesAPI ReferenceExplorer
API Reference

SettlementNoteUpdate

input

Updates a SettlementNote.

Updates the selected SettlementNote with the inserted data.

Fields

NameTypeDescription
documentIdInt!
documentCalculationsModeInt
numberInt

Sequential document number within its document set. Assigned automatically on creation

documentSetIdInt

Document set to which this document belongs

countryIdInt

Country identifier of the entity

dateDateTime

Issue date of the document. Must follow sequential numbering rules per AT regulations

timezoneIdInt

Timezone identifier for the document issue date

customerIdInt

Customer to whom this document is issued

alternateAddressIdInt

Alternate delivery/billing address for the entity

economicActivityClassificationCodeIdInt

Economic activity classification code (CAE) identifier, per AT SAF-T requirements

relatedIn[RelatedDocumentInput]

Documents originated from this document (e.g., receipts created from this invoice)

relatedWith[RelatedDocumentInput]

Source documents that originated this document (e.g., invoice referenced by a credit note)

notesRelatedDocsString

Notes regarding related documents

currencyExchangeIdInt

Currency exchange rate identifier when document uses a foreign currency

notesString

Free-text observations or notes for this document

statusInt

Document status: 0 = draft, 1 = closed/finalized

suspendedBoolean

Whether the document is suspended (temporarily on hold)

nullifiedBoolean

Whether the document has been voided/cancelled. Nullified documents remain for audit but have no fiscal effect

payments[DocumentPaymentMethodInput]

Payment methods and amounts used to settle this document

financialDiscountFloat

Financial discount as a monetary amount applied for early payment

totalValueFloat

Total monetary value of this settlement document

fileUpload

Attached file (e.g., scanned supplier invoice). Stored as a file path in reads. Sent as a multipart request, see the file upload guide

fileOriginalString

Original file name of the uploaded attachment. Send it alongside file, see the file upload guide

currencyExchangeExchangeFloat

Exchange rate value applied when document uses a foreign currency

paymentGateways[DocumentPaymentGatewayAutomaticInput!]

Payment gateways materialized when the document is closed. Accepted for input compatibility with SettlementNoteInsert; the gateway rows are persisted on draft creation and materialized on close, so this field is not applied on update.

Deprecated fields (1)
NameTypeDescription
fiscalZoneStringIgnored. A document always takes the fiscal zone of the issuing company; taxes from other fiscal zones (e.g. OSS) can still be used on its lines.

© 2026 Moloni ON

Tax Authority Certificate No. 3075