CustomerReturnNoteInsert

input

Creates a new CustomerReturnNotes

Fields

Name	Type	Description
`fiscalZone`	`String`
`documentCalculationsMode`	`Int`
`source`	`DocumentSource`	Origin of the document (where it was created from). Defaults to `api` when omitted.
`documentSetId`	`Int!`	Document set to which this document belongs
`countryId`	`Int`	Country identifier of the entity
`globalDiscount`	`Float`	Global discount percentage applied to the entire document
`date`	`DateTime!`	Issue date of the document. Must follow sequential numbering rules per AT regulations
`timezoneId`	`Int`	Timezone identifier for the document issue date
`customerId`	`Int!`	Customer to whom this document is issued
`alternateAddressId`	`Int`	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)
`notesRelatedDocs`	`String`	Notes regarding related documents
`products`	`[DocumentProductInput!]!`	Line items (products/services) included in this document
`currencyExchangeId`	`Int`	Currency exchange rate identifier when document uses a foreign currency
`notes`	`String`	Free-text observations or notes for this document
`status`	`Int`	Document status: 0 = draft, 1 = closed/finalized
`suspended`	`Boolean`	Whether the document is suspended (temporarily on hold)
`nullified`	`Boolean`	Whether the document has been voided/cancelled. Nullified documents remain for audit but have no fiscal effect
`retentionsValue`	`Float`	Withholding tax value applied to this document
`yourReference`	`String`	Customer's own reference for this document (e.g., purchase order number)
`ourReference`	`String`	Internal reference for this document (e.g., contract number, project code)
`currencyExchangeExchange`	`Float`	Exchange rate value applied when document uses a foreign currency
`deliveryMethodId`	`Int`	Delivery/shipping method identifier
`vehicleId`	`Int`	Vehicle identifier used for goods transportation
`deliveryLoadDate`	`DateTime!`	Date and time when goods are loaded for transport. Required for AT transport documents
`deliveryLoadAddress`	`String`	Loading address for goods transport. Required by AT for transport documents in Portugal
`deliveryLoadCity`	`String`	Loading city for goods transport
`deliveryLoadZipCode`	`String`	Loading postal code for goods transport
`deliveryLoadCountryId`	`Int`	Loading country for goods transport
`deliveryUnloadAddress`	`String`	Unloading/delivery address for goods transport. Required by AT for transport documents in Portugal
`deliveryUnloadCity`	`String`	Unloading/delivery city for goods transport
`deliveryUnloadZipCode`	`String`	Unloading/delivery postal code for goods transport
`deliveryUnloadCountryId`	`Int`	Unloading/delivery country for goods transport
`economicActivityClassificationCodeId`	`Int`	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.