Moloni ON Logo WhiteGuidesAPI ReferenceExplorer
API Reference

CreditNoteInsert

input

Creates a new CreditNotes

Fields

NameTypeDescription
documentCalculationsModeInt
sourceDocumentSource

Origin of the document (where it was created from). Defaults to api when omitted.

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

salespersonIdInt

Salesperson assigned to this document for commission tracking

salespersonCommissionFloat

Commission percentage for the salesperson on this document

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

economicActivityClassificationCodeIdInt

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

paymentGateways[DocumentPaymentGatewayAutomaticInput!]

Payment gateways to automatically create after document is closed (canGeneratePayment must be true for this document type). Failures are reported via notification and do not affect document creation.

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