Moloni ON Logo WhiteGuidesAPI ReferenceExplorer
API Reference

PurchaseRecurringAgreementRead

object

Reads a PurchaseRecurringAgreements

Return a PurchaseRecurringAgreements with the specified ID.

Fields

NameTypeDescription
documentIdInt!

Unique identifier of the document

fiscalZoneString

Fiscal zone code for tax calculation purposes

documentTypeIdInt!

Document type identifier (e.g., invoice, credit note, receipt)

documentTypeDocumentTypeRead!

Document type details

documentSetDocumentSetRead

Document set to which this document belongs

companyCompanyRead!

Company that owns this document

companyIdInt!

Company identifier

documentSetNameString!

Name of the document set

documentSetIdInt

Document set identifier

numberInt

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

dateDateTime

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

geographicZoneIdInt

Geographic zone identifier for regional tax rules

geographicZoneGeographicZoneRead

Geographic zone details for regional tax rules

yearInt

Fiscal year of the document

totalValueFloat!

Total monetary value of the document including taxes

documentTotalFloat

Calculated total of the document based on line items

totalRelatedAppliedValueFloat

Total value applied from related documents

reconciledValueFloat

Value already reconciled/settled against this document

remainingReconciledValueFloat

Remaining value to be reconciled

reconciliationPercentageFloat

Percentage of the document value that has been reconciled

currencyExchangeTotalValueFloat

Total value converted to the foreign currency

currencyExchangeCurrencyExchangeRead

Currency exchange rate identifier when document uses a foreign currency

currencyExchangeExchangeFloat

Exchange rate value applied when document uses a foreign currency

documentCalculationsModeInt

Calculation mode used for the document (e.g., tax-inclusive or tax-exclusive)

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

pdfExportString

Path to the PDF file at mediaAPI:

  • null = PDF generation not requested
  • empty string = PDF pending generation
deletionBlockers[DeletionBlocker!]!

Reasons why this document can't be deleted. Empty array means the document is deletable

nullifiableBoolean

Whether this document can be nullified

entityVatString

Tax identification number (VAT) of the entity, copied at document creation

entityNameString

Name of the entity (customer/supplier), copied at document creation

entityNumberString

Internal reference number of the entity, copied at document creation

entityAddressString

Address of the entity, copied at document creation

entityZipCodeString

Postal code of the entity, copied at document creation

entityCityString

City of the entity, copied at document creation

entityCountryNameString

Country name of the entity, copied at document creation

countryIdInt

Country identifier of the entity

countryCountryRead

Country identifier of the entity

lastOperationsLastOperationsRead

Last operations performed on this document (created, closed, nullified)

emailsCountInt

Number of emails sent for this document

hashString

SAF-T hash signature for document integrity validation

hashControlString

Hash control character used in the hash chain

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)

lastModifiedDateTime

Date and time of the last modification

downloadsInt

Number of times the document PDF has been downloaded

terminalIdInt
createdAtDateTime!

Timestamp when the document was created

updatedAtDateTime!

Timestamp when the document was last updated

importStatusImportStatus

Import status for migrated documents

sourceDocumentSource

Origin of the document (where it was created from)

createdLogInfo
updatedLogInfo
events[EventRead!]

Scheduled recurring events associated with this document

grossValueFloat

Gross value of the document before taxes and discounts (calculated)

globalDiscountFloat

Global discount percentage applied to the entire document

globalDiscountValueFloat

Monetary value of the global discount applied to the document (calculated)

commercialDiscountValueFloat

Monetary value of the commercial discount applied to the document (calculated)

totalDiscountValueFloat

Total discount monetary value across all discount types (calculated)

taxesValueFloat

Total tax amount applied to the document (calculated from product lines)

expirationDateDate

Due date for the document, typically derived from the maturity date

maturityDateMaturityDateRead

Maturity date preset identifier, used to calculate the expiration date

maturityDateDaysInt

Number of days for the maturity period (resolved from maturityDateId)

maturityDateNameString

Name of the maturity date preset (resolved from maturityDateId)

timezoneTimezoneRead

Timezone identifier for the document issue date

supplierSupplierRead

Supplier to whom this document is issued

alternateAddressAlternateAddressRead

Alternate delivery/billing address for the entity

salespersonSalespersonRead

Salesperson assigned to this document for commission tracking

salespersonCommissionFloat

Commission percentage for the salesperson on this document

economicActivityClassificationCodeIdInt

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

economicActivityClassificationCodeEconomicActivityClassificationCodeRead
relatedIn[RelatedDocumentRead]

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

relatedWith[RelatedDocumentRead]

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

notesRelatedDocsString

Notes regarding related documents

products[DocumentProductRead!]

Line items (products/services) included in this document

notesString

Free-text observations or notes for this document

retentionsValueFloat

Withholding tax value applied to this document

taxes[DocumentTaxRead!]!
ocrJobIdString
ocrJobOcrJobRead
Deprecated fields (16)
NameTypeDescription
deletableBoolean

Whether this document can be deleted

Use deletionBlockers instead
eventEventRead

Single recurring event. Deprecated in favor of events array

Use events instead
deliveryMethodDeliveryMethodRead

Delivery/shipping method identifier

This document should not have transportation data
deliveryMethodNameString

Delivery/shipping method name (resolved from deliveryMethodId)

This document should not have transportation data
vehicleVehicleRead

Vehicle identifier used for goods transportation

This document should not have transportation data
deliveryVehicleNameString

Name/description of the transportation vehicle (resolved from vehicleId)

This document should not have transportation data
deliveryVehicleLicensePlateString

License plate of the transportation vehicle (resolved from vehicleId)

This document should not have transportation data
deliveryLoadDateDateTime

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

This document should not have transportation data
deliveryLoadAddressString

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

This document should not have transportation data
deliveryLoadCityString

Loading city for goods transport

This document should not have transportation data
deliveryLoadZipCodeString

Loading postal code for goods transport

This document should not have transportation data
deliveryLoadCountryCountryRead

Loading country for goods transport

This document should not have transportation data
deliveryUnloadAddressString

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

This document should not have transportation data
deliveryUnloadCityString

Unloading/delivery city for goods transport

This document should not have transportation data
deliveryUnloadZipCodeString

Unloading/delivery postal code for goods transport

This document should not have transportation data
deliveryUnloadCountryCountryRead

Unloading/delivery country for goods transport

This document should not have transportation data

Implements

© 2026 Moloni ON

Tax Authority Certificate No. 3075