Moloni ON Logo WhiteGuidesAPI ReferenceExplorer
API Reference

CustomerReturnNoteUpdate

input

Updates a CustomerReturnNote.

Updates the selected CustomerReturnNote with the inserted data.

Fields

NameTypeDescription
documentIdInt!
fiscalZoneString
documentCalculationsModeInt
documentSetIdInt

Document set to which this document belongs

countryIdInt

Country identifier of the entity

globalDiscountFloat

Global discount percentage applied to the entire document

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

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

products[DocumentProductInput]

Line items (products/services) included in this document

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

retentionsValueFloat

Withholding tax value applied to this document

yourReferenceString

Customer's own reference for this document (e.g., purchase order number)

ourReferenceString

Internal reference for this document (e.g., contract number, project code)

currencyExchangeExchangeFloat

Exchange rate value applied when document uses a foreign currency

deliveryMethodIdInt

Delivery/shipping method identifier

vehicleIdInt

Vehicle identifier used for goods transportation

deliveryLoadDateDateTime

Date and time when goods are loaded for transport. Required for AT transport documents

deliveryLoadAddressString

Loading address for goods transport. Required by AT for transport documents in Portugal

deliveryLoadCityString

Loading city for goods transport

deliveryLoadZipCodeString

Loading postal code for goods transport

deliveryLoadCountryIdInt

Loading country for goods transport

deliveryUnloadAddressString

Unloading/delivery address for goods transport. Required by AT for transport documents in Portugal

deliveryUnloadCityString

Unloading/delivery city for goods transport

deliveryUnloadZipCodeString

Unloading/delivery postal code for goods transport

deliveryUnloadCountryIdInt

Unloading/delivery country for goods transport

economicActivityClassificationCodeIdInt

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

paymentGateways[DocumentPaymentGatewayAutomaticInput!]

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

© 2026 Moloni ON

Tax Authority Certificate No. 3075