Default API

Die RELion Default API ist eine Standard-API für die Kommunikation zwischen Systemen.

Was ist die RELion Default API?

Die RELion Default API ist eine vorgefertigte, standardisierte Programmierschnittstelle, die speziell für RELion ONE entwickelt wurde. Sie fungiert als Brücke zwischen RELion ONE und externen Systemen, Anwendungen oder Diensten und ermöglicht es, bestimmte Funktionen des Systems einfach zu nutzen. Die klar definierten Methoden, Datenformate und Kommunikationsprotokolle machen die Integration effizient und benutzerfreundlich, ohne dass tiefgehende Systemkenntnisse erforderlich sind.

Installation

Die RELion Default API ermöglicht den Entwicklern, bestimmte Funktionen eines Systems, einer Anwendung oder eines Dienstes auf eine vorher festgelegte und standardisierte Weise zu nutzen. Die Default API definiert Methoden, Datenformate und Kommunikationsprotokolle, die Entwickler verwenden können, um auf Funktionen zuzugreifen und mit ihnen zu interagieren, ohne tiefergehende Kenntnisse über die interne Funktionsweise des zugrunde liegenden Systems zu benötigen.

In den AppSource von Microsoft wird die RELion Default API bereitgestellt.

Wir unterstützen Sie gerne bei der Integration. Kontaktieren Sie dazu unseren Support.

GetFileContent – Dateien einfach und zentral abrufen

Mit der Funktion GetFileContent können Dateien direkt abgerufen werden. Die Dateien liegen entweder in RELion oder im Archivsystem Archiv kompakt. Der Zugriff erfolgt über eine einheitliche Schnittstelle (API).

Was bringt das für Anwender?

  • Dokumente sind leicht und schnell erreichbar.
  • Es ist kein Wechsel zwischen verschiedenen Systemen nötig.
  • Prozesse laufen einfacher und schneller, besonders bei Portalen oder automatischen Abläufen.

Vorteile im Überblick

Ein Zugriff für alle Dateien: Egal, ob die Datei in RELion oder im Archiv liegt. Weniger manueller Aufwand: Systeme rufen Dateien automatisch ab. Einfachere Nutzung für Drittsysteme: Externe Portale können Dokumente direkt anzeigen.

Wichtiger Hinweis bei Archiv kompakt

Wenn Dateien aus Archiv kompakt abgerufen werden, sind technische Vorbereitungen nötig:

  • Für den Drittanbieter muss ein technischer Benutzer in Archiv kompakt eingerichtet werden.
  • Dieser Benutzer
  • benötigt kein Passwort
  • hat Administratorrechte
  • darf auf alle Archive und Dokumente zugreifen

Außerdem muss der Drittanbieter die Berechtigung RelAAK Basic erhalten, wenn auch RELion‑Dokumente über die API abgerufen werden.

Technische Dokumentation für Requests

relApiTabApiAllocGroupParticip


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiAllocGroupParticip
Entity (Plural/Endpunkt)relApiTabApiAllocGroupParticip
Quell-TabelleRelC Unit Allocation
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiAllocGroupParticip

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
ownerTenantCodeOwner / TenantEigentümer/Mieter-Kennung
objectNoCodeObject No.Objektnummer
unitNoCodeUnit No.Einheitennummer
allocationCodeCodeAllocation CodeUmlageschlüssel-Code
startDateDateStart DateGültig ab
endDateDateEnd DateGültig bis
descriptionTextDescriptionBeschreibung
reasonChangeTextReason for ChangeÄnderungsgrund
factorDecimalFactorFaktor
accountingBooleanAccountingBuchhaltungsrelevanz
entryGrossNetEnumEntry Gross NetBrutto/Netto-Buchung
entryFactorDecimalEntry FactorBuchungsfaktor
noObjectTotalingBooleanNo object totalingKein Objektsummenbildung
tradeUnitTaxBooleanTrade unit taxGewerbesteuer Einheit
vatRateDecimalVAT RateMwSt.-Satz
recordIdRecordIdRecordIdDatensatz-ID
Verknüpfte Ressource (SubPage)
NavigationBeschreibung
RelApiTabApiUnitAllocationZugehörige Einheitenzuweisungen

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiBudgetDebitPos


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiBudgetDebitPos
Entity (Plural/Endpunkt)relApiTabApiBudgetDebitPos
Quell-TabelleRelC Budget Debit Position
SchlüsselfeldSystemId (GUID)
SchreibschutzJa — nur Lesezugriff (GET)

Basis-URL

GET /api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiBudgetDebitPos

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemCreatedAtDateTimeSystemCreatedAtErstellungsdatum
systemCreatedByGUIDSystemCreatedByErstellt von (Benutzer-GUID)
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
systemModifiedByGUIDSystemModifiedByZuletzt geändert von (Benutzer-GUID)
ownerTenantCodeOwner / TenantEigentümer/Mieter-Kennung
objectNoCodeObject No.Objektnummer
unitNoCodeUnit No.Einheitennummer
accountNoCodeAccount No.Kontonummer
startDateDateStart dateStartdatum
contractNoCodeContract No.Vertragsnummer
contractCategoryCodeContract CategoryVertragskategorie
descriptionTextDescriptionBeschreibung
amountDecimalAmountBetrag

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiCompanyInformation


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiCompanyInformation
Entity (Plural/Endpunkt)relApiTabApiCompanyInformation
Quell-TabelleCompany Information (Business Central Standard)
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiCompanyInformation

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key), nur lesbar
displayNameTextNameFirmenname
addressLine1TextAddressAdresszeile 1
addressLine2TextAddress 2Adresszeile 2
cityTextCityStadt
stateTextCountyBundesland / Kanton
countryCodeCountry/Region CodeLändercode
postalCodeCodePost CodePostleitzahl
phoneNumberTextPhone No.Telefonnummer
faxNumberTextFax No.Faxnummer
emailTextE-MailE-Mail-Adresse
websiteTextHome PageWebseite
taxRegistrationNumberTextVAT Registration No.Steuernummer / USt-IdNr. (berechnet)
currencyCodeCodeBerechnetWährungscode der Landeswährung (nur lesbar)
currentFiscalYearStartDateDateBerechnetBeginn des aktuellen Geschäftsjahres (nur lesbar)
industryTextIndustrial ClassificationBranche
pictureBlobPictureFirmenlogo (nur lesbar)
lastModifiedDateTimeDateTimeSystemModifiedAtLetztes Änderungsdatum

Hinweise für Entwickler

taxRegistrationNumber (berechnet)

Das Feld liefert je nach BC-Lokalisierung entweder die VAT Registration No. oder die belgische Enterprise No. (Feld 11310). Beim PATCH wird das Feld entsprechend zurückgeschrieben.

currencyCode und currentFiscalYearStartDate

Beide Felder sind schreibgeschützt und werden über OnAfterGetRecord befüllt.


Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiContact


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiContact
Entity (Plural/Endpunkt)relApiTabApiContact
Quell-TabelleContact (Business Central Standard)
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiContact

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
contactNoCodeNo.Kontaktnummer
satuationCodeCodeSalutation CodeAnredecode
jobTitleTextJob TitleBerufsbezeichnung
firstNameTextFirst NameVorname
firstName2TextMiddle NameZweiter Vorname
surNameTextSurnameNachname
nameTextNameVollständiger Name
name2TextName 2Namenszusatz
addressTextAddressAdresse
address2TextAddress 2Adresszusatz
postCodeCodePost CodePostleitzahl
cityTextCityStadt
phoneNoTextPhone No.Telefonnummer
mobileNoTextMobile Phone No.Mobilnummer
emailTextE-MailE-Mail-Adresse
partnerJobTitleTextRelC Partner TitleBerufsbezeichnung Partner
partnerFirstNameTextRelC Partner first nameVorname Partner
partnerFirstName2TextRelC Partner first name 2Zweiter Vorname Partner
partnerSurNameTextRelC Partner last nameNachname Partner
dateOfBirthDateRelC Date of birthGeburtsdatum
nameAtBirthTextRelC Name at birthGeburtsname
partnerDateOfBirthDateRelC Partner Date of birthGeburtsdatum Partner
recordIdRecordIdRecordIdDatensatz-ID

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiCustomer


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiCustomer
Entity (Plural/Endpunkt)relApiTabApiCustomer
Quell-TabelleCustomer (Business Central Standard)
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiCustomer

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
customerNoCodeNo.Kundennummer
nameTextNameName
name2TextName 2Namenszusatz
addressTextAddressAdresse
address2TextAddress 2Adresszusatz
postCodeCodePost CodePostleitzahl
cityTextCityStadt
phoneNoTextPhone No.Telefonnummer
mobileNoTextMobile Phone No.Mobilnummer
emailTextE-MailE-Mail-Adresse
vatBusPostingGroupCodeVAT Bus. Posting GroupMwSt.-Geschäftsbuchungsgruppe
recordIdRecordIdRecordIdDatensatz-ID

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiDebitPosition


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiDebitPosition
Entity (Plural/Endpunkt)relApiTabApiDebitPosition
Quell-TabelleRelC Debit Position
SchlüsselfeldSystemId (GUID)
SchreibschutzJa — nur Lesezugriff (GET)

Basis-URL

GET /api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiDebitPosition

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemCreatedAtDateTimeSystemCreatedAtErstellungsdatum
systemCreatedByGUIDSystemCreatedByErstellt von
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
systemModifiedByGUIDSystemModifiedByZuletzt geändert von
ownerTenantCodeOwner / TenantEigentümer/Mieter-Kennung
objectNoCodeObject No.Objektnummer
unitNoCodeUnit No.Einheitennummer
unitHistoryIntegerUnit historyEinheitenhistorie
accountNoCodeAccount No.Kontonummer
startDateDateStart dateStartdatum
contractCategoryCodeContract CategoryVertragskategorie
contractNoCodeContract No.Vertragsnummer
amountDecimalAmountBetrag
descriptionTextDescriptionBeschreibung

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiDocument


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiDocument
Entity (Plural/Endpunkt)relApiTabApiDocument
Quell-TabelleRelC Document
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH
Change TrackingAktiviert

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiDocument

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema) — Auswahl der wichtigsten Felder

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
archiveFileNameTextArchiveFileNameDateiname im Archiv
archiveFileExtensionTextArchiveFileExtensionDateiendung
archiveFileSizeIntegerArchiveFileSizeDateigröße
attachmentBlobAttachmentAnhang (Dateiinhalt)
archivIDCodeArchivIDArchiv-ID
archivenameTextArchivename_Archivname
archiveSystemCodeArchive SystemArchivsystem
archivedAtDateTimeArchived atArchivierungsdatum
archivedByUserIDCodeArchived by User IDArchiviert von
archivingProcessCodeArchiving processArchivierungsprozess
contactNoCodeContact No.Kontaktnummer
contactNameTextContactName_Kontaktname
customerNoCodeCustomer No.Kundennummer
customerNameTextCustomerName_Kundenname
createdAtDateTimeCreated atErstellt am
createdByUserIDCodeCreated by User IDErstellt von
deleteAtDateTimeDelete atLöschzeitpunkt
deletePlannedAtDateTimeDelete planned atGeplanter Löschzeitpunkt
aakDocumentIDTextAAK_DocumentIDAAK-Dokument-ID
aakFileIDTextAAK_FileIDAAK-Datei-ID
aakFileVersionTextAAK_FileVersionAAK-Versionsnummer
aakFileVersionIDTextAAK_FileVersionIDAAK-Versions-ID
aakCatchwordTextAAK_CatchwordAAK-Stichwort
aakCreationDateDateAAK_CreationDateAAK-Erstellungsdatum
aakCreatorTextAAK_CreatorAAK-Ersteller
aakArcRetentionDateDateAAKArcRetentionDateAAK-Aufbewahrungsfrist
aakIndexValuesTextAAKIndexValues_AAK-Indexwerte
accountHolderTextAccount holderKontoinhaber
accountingCodeCodeAccounting codeBuchhaltungscode
accountingNoCodeAccounting No.Buchhaltungsnummer
accountingFromDateAccounting fromAbrechnungszeitraum von
accountingUntilDateAccounting untilAbrechnungszeitraum bis
accountingYearIntegerAccounting yearAbrechnungsjahr
bankAccountCodeBank AccountBankkonto
banknameTextBanknameBankname
barcodeIDTextBarcode IDBarcode-ID
bicTextBICBIC
cancellationNoCodeCancellation No.Stornierungsnummer

Hinweis Die Tabelle zeigt eine Auswahl. Das vollständige Feldset ist umfangreich – bitte $select für minimale Datenmengen nutzen.


Hinweise für Entwickler

attachment (Blob)

Enthält den binären Dateiinhalt. Wird nur bei expliziter Anforderung übertragen. $select verwenden, um unnötige Datenmengen zu vermeiden.

Change Tracking

ChangeTrackingAllowed = true — OData $deltatoken wird unterstützt für inkrementellen Datenabruf.


Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiDocumentArchiv


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiDocumentArchiv
Entity (Plural/Endpunkt)relApiTabApiDocumentArchiv
Quell-TabelleRelC Document AAK-Archive
SchlüsselfeldSystemId (GUID)
SchreibschutzJa — nur Lesezugriff (GET)
Change TrackingAktiviert

Basis-URL

GET /api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiDocumentArchiv

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
aakTBStructIndexTextAAK-TBStructIndex_AAK-Strukturindex
archivIDCodeArchivIDArchiv-Code
archivnameTextArchivnameArchivname
systemCreatedAtDateTimeSystemCreatedAtErstellungsdatum
systemCreatedByGUIDSystemCreatedByErstellt von
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
systemModifiedByGUIDSystemModifiedByZuletzt geändert von
recordIdRecordIdRecordIdDatensatz-ID

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiDocumentIndexValue


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiDocumentIndexValue
Entity (Plural/Endpunkt)relApiTabApiDocumentIndexValue
Quell-TabelleRelC AAK-IndexValues
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH
Change TrackingAktiviert

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiDocumentIndexValue

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
entryNoIntegerEntry No.Laufende Nummer
lineNoIntegerLine No.Zeilennummer
fieldNoIntegerFieldNoFeldnummer
indexValueTextIndexValueIndexwert
dataTypeTextDataType_Datentyp
positionNoIntegerPosition No.Positionsnummer
multipleIndexNoIntegerMultiple Index No.Mehrfachindex-Nr.
aakIndexExistsBooleanAAK-IndexExistsAAK-Index vorhanden
aakTBStructCatchwordListNameTextAAK-TBStructCatchwordListName_Name der Stichwortliste
aakTBStructCatchwordsTextAAK-TBStructCatchwords_Stichwörter
numArchivIDIntegernum_archivIDArchiv-ID (numerisch)
numIndexIDIntegernum_indexIDIndex-ID
numListIDIntegernum_listID_Listen-ID
strIndexNameTextstr_indexNameIndexname
strDefaultTextstr_default_Standardwert
boolMandatoryBooleanbool_mandatory_Pflichtfeld
boolHiddenBooleanbool_hidden_Ausgeblendet
boolAutoDateBooleanbool_autoDate_Automatisches Datum
boolCatchWordsOnlyBooleanbool_catchWordsOnly_Nur Stichwörter
numDecimalPlacesIntegernum_decimalPlaces_Dezimalstellen
numMaxLengthIntegernum_maxLength_Maximale Länge
systemCreatedAtDateTimeSystemCreatedAtErstellungsdatum
systemCreatedByGUIDSystemCreatedByErstellt von
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
systemModifiedByGUIDSystemModifiedByZuletzt geändert von
recordIdRecordIdRecordIdDatensatz-ID

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiEditor


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiEditor
Entity (Plural/Endpunkt)relApiTabApiEditor
Quell-TabelleRelC Editor
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiEditor

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemCreatedAtDateTimeSystemCreatedAtErstellungsdatum
systemCreatedByGUIDSystemCreatedByErstellt von
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
systemModifiedByGUIDSystemModifiedByZuletzt geändert von
ownerTenantCodeOwner / TenantEigentümer/Mieter-Kennung
objectNoCodeObject No.Objektnummer
partCodeCodePart codeTeilcode
nameTextName_Name des Bearbeiters
descriptionTextDescription_Beschreibung
competenceUnitCodeCodeCompetence unit codeZuständigkeitseinheitscode
mainAgentCodeMain agentHauptverantwortlicher
personResponsibleCodePerson responsibleVerantwortliche Person
recordIdRecordIdRecordIdDatensatz-ID
Verknüpfte Ressourcen (SubPages)
NavigationBeschreibung
RelApiTabApiSalespersonPurchVerknüpfter Verkäufer/Einkäufer (via partCode)
RelApiTabApiEditorPartEditor-Teile (via partCode)

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiEditorPart


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiEditorPart
Entity (Plural/Endpunkt)relApiTabApiEditorPart
Quell-TabelleRelC Editor Part
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiEditorPart

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemCreatedAtDateTimeSystemCreatedAtErstellungsdatum
systemCreatedByGUIDSystemCreatedByErstellt von
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
systemModifiedByGUIDSystemModifiedByZuletzt geändert von
partCodeCodePart codeTeilcode
descriptionTextDescriptionBeschreibung
recordIdRecordIdRecordIdDatensatz-ID

Hinweise für Entwickler

Diese Ressource wird in der Regel als SubPage von relApiTabApiEditor konsumiert. Ein Direktabruf ist ebenfalls möglich.


Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiExploitationMethod


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiExploitationMethod
Entity (Plural/Endpunkt)relApiTabApiExploitationMethod
Quell-TabelleRelC Exploitation Method
SchlüsselfeldSystemId (GUID)
SchreibzugriffLesend (GET) — keine expliziten Schreibrechte gesetzt
Change TrackingAktiviert

Basis-URL

GET /api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiExploitationMethod

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
exploitationMethodCodeCodeExploitation method codeNutzungsart-Code
exploitationMethodTypeEnumExploitation method typeNutzungsart-Typ (z. B. Einheit, Objekt)
exploitationMethodClassCodeExploitation Method ClassNutzungsart-Kategorie
descriptionTextDescriptionBeschreibung
standardAllocationCodeFAreaCodeStandardAllocationCode f. areaStandard-Umlageschlüssel für Fläche
recordIdRecordIdRecordIdDatensatz-ID

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiRelCIFOContractLine


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiRelCIFOContractLine
Entity (Plural/Endpunkt)relApiTabApiRelCIFOContractLine
Quell-TabelleRelC IFO Contract Line
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiRelCIFOContractLine

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
contractNoCodeContract No.Vertragsnummer
supplementNoIntegerSupplement No.Nachtragnummer
startDateDateStart DateStartdatum
completionDateDateCompletion dateAbschlussdatum
ownersAssociationCompanyCodeOwners Association CompanyGesellschaft WEG
ownersAssocOwnerTenantCodeOwners Assoc. Owner/TenantWEG Eigentümer/Mieter
ownersAssocObjectNoCodeOwners Assoc. Object No.WEG Objektnummer
ownersAssocUnitNoCodeOwners Assoc. Unit No.WEG Einheitennummer
iFOCompanyCodeIFO CompanyIFO-Gesellschaft
iFOOwnerTenantCodeIFO Owner/TenantIFO Eigentümer/Mieter
iFOObjectNoCodeIFO Object No.IFO Objektnummer
iFOUnitNoCodeIFO Unit No.IFO Einheitennummer
recordIdRecordIdRecordIdDatensatz-ID
Verknüpfte Ressource (SubPage)
NavigationBeschreibung
RelApiTabApiReObjectVerknüpftes Objekt (IFO Eigentümer/Mieter + Objektnr.)

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiIssuedReminders


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiIssuedReminder
Entity (Plural/Endpunkt)relApiTabApiIssuedReminders
Quell-TabelleIssued Reminder Header (Business Central Standard)
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiIssuedReminders

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
noCodeNo.Mahnnummer
customerNoCodeCustomer No.Kundennummer
nameTextNameName
name2TextName 2Namenszusatz
addressTextAddressAdresse
address2TextAddress 2Adresszusatz
postCodeCodePost CodePostleitzahl
cityTextCityStadt
countyTextCountyBundesland
countryRegionCodeCodeCountry/Region CodeLändercode
contactTextContactAnsprechpartner
documentDateDateDocument DateBelegdatum
dueDateDateDue DateFälligkeitsdatum
reminderTermsCodeCodeReminder Terms CodeMahnbedingungscode
reminderLevelIntegerReminder LevelMahnstufe
remainingAmountDecimalRemaining AmountRestbetrag
interestAmountDecimalInterest AmountZinsbetrag
vatAmountDecimalVAT AmountMwSt.-Betrag
relCMemberNoCodeRelC Member No.Mitgliedsnummer
relCGroupingCodeRelC GroupingGruppierung
relCObjectBankAccountCodeRelC Object Bank AccountObjekt-Bankkonto
relCReminderProcessNoCodeRelC Reminder Process No.Mahnprozessnummer
relCContractNoCodeRelC Contract No.Vertragsnummer
relCPersonResponsibleCodeRelC Person ResponsibleVerantwortliche Person
relCInstallmentPayerCodeRelC Installment PayerRatenzahler
relCCancellationReasonTextRelC Cancellation ReasonStornierungsgrund
relCReminderDescriptionTextRelC Reminder DescriptionMahnbeschreibung
recordIdRecordIdRecordIdDatensatz-ID
Verknüpfte Ressource (SubPage)
NavigationBeschreibung
RelApiTabApiReminderTermsMahnbedingungen (via reminderTermsCode)

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiLocationFloor


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiLocationFloor
Entity (Plural/Endpunkt)relApiTabApiLocationFloor
Quell-TabelleRelC Location / Floor
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiLocationFloor

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
kindEnumKindArt (Lage oder Etage)
codeCodeCodeCode
descriptionTextDescriptionBeschreibung
recordIdRecordIdRecordIdDatensatz-ID

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiMeterMasterData


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiMeterMasterData
Entity (Plural/Endpunkt)relApiTabApiMeterMasterData
Quell-TabelleRelC Meter Master Data
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiMeterMasterData

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
meterNoCodeMeter no.Zählernummer
meterSerialNoCodeMaster Data No.Seriennummer / Stammdatennummer
kindOfMeterCodeKind of MeterZählerart
unitOfConsumptionCodeUnit of consumptionVerbrauchseinheit
ownerTenantCodeOwner / TenantEigentümer/Mieter
objectNoCodeObject No.Objektnummer
buildingCodeBuildingGebäude
houseCodeHouseHaus
unitNoCodeUnit No.Einheitennummer
unitLocationCodeUnit LocationEinheitenlage
unitFloorCodeUnit FloorEinheitenetage
meterLocationTextMeter LocationZählerstandort
installationDateDateDate of installationInstallationsdatum
calibrationDateDateYear of calibrationEichjahr
initialReadingDecimalOpening ScoreAnfangsstand
manufacturerTextManufacturerHersteller
recordIdRecordIdRecordIdDatensatz-ID

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiMeterReading


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiMeterReading
Entity (Plural/Endpunkt)relApiTabApiMeterReading
Quell-TabelleRelC Meter Reading
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiMeterReading

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
meterSerialNoCodeMaster Data No.Seriennummer / Stammdatennummer
lineNoIntegerLine No.Zeilennummer
ownerTenantCodeOwner / TenantEigentümer/Mieter
objectNoCodeObject No.Objektnummer
unitNoCodeUnit No.Einheitennummer
unitHistoryIntegerUnit historyEinheitenhistorie
readingDateDateReading dateAblesedatum
openingReadingDecimalOpening ScoreAnfangsstand
finalReadingDecimalFinal ScoreEndstand
recordIdRecordIdRecordIdDatensatz-ID

Typischer Anwendungsfall

// Alle Ablesungen für einen bestimmten Zähler
GET .../relApiTabApiMeterReading?$filter=meterSerialNo eq 'Z-0001'&$orderby=readingDate desc

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiObjectBuilding


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiObjectBuilding
Entity (Plural/Endpunkt)relApiTabApiObjectBuilding
Quell-TabelleRelC Object Building
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiObjectBuilding

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
ownerTenantCodeOwner / TenantEigentümer/Mieter
objectNoCodeObject No.Objektnummer
codeCodeCodeGebäudecode
descriptionTextDescriptionBeschreibung
typeEnumTypeGebäudetyp
buildingCodeCodeBuilding CodeGebäudeclassifizierungscode
addressTextAddressStraße
houseEntranceTextTextAddress NumberHausnummer (Text)
houseNumberIntIntegerHouse numberHausnummer (Zahl)
houseNumberTextTextHouse number letterHausnummernzusatz
postCodeCodePost CodePostleitzahl
cityTextCityStadt
districtCodeCodeDistrict departmentcodeBezirkscode
geoCodeTextGeo CodeGeokoordinate
exploitationMethodCodeCodeExploitation Method CodeNutzungsart-Code
numberOfFloorsIntegerNumber of floorsAnzahl Stockwerke
startOfUsageDateStart Of UsageNutzungsbeginn
endOfUsageDateEnd Of UsageNutzungsende
completionDateDateFinish DateFertigstellungsdatum
recordIdRecordIdRecordIdDatensatz-ID

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiObjectTax


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiObjectTax
Entity (Plural/Endpunkt)relApiTabApiObjectTax
Quell-TabelleRelC Object tax
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiObjectTax

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
ownerTenantCodeOwner / TenantEigentümer/Mieter
objectNoCodeObject No.Objektnummer
asOfDateDateAs of dateGültig ab
accountingGroupCodeAccounting GroupBuchhaltungsgruppe
inputTaxShareDecimalInput Tax ShareVorsteueranteil %
calculatedInputTaxShareDecimalCalculated Input Tax ShareBerechneter Vorsteueranteil %
descriptionTextDescriptionBeschreibung
vatBusPostingGroupTaxCodeVAT Bus. Posting Group TaxMwSt.-Geschäftsbuchungsgruppe (Steuer)
vatBusPostingGroupUnrealCodeVAT Bus. Posting Group UnrealMwSt.-Buchungsgruppe (unecht steuerfrei)
modifiedCreatedOnDateTimeModified/created onErstellt/Geändert am
modifiedCreatedByUserIDCodeModified/created by User IDErstellt/Geändert von
apartmentShareDecimalApartment share %Wohnungsanteil %
tradeQuotaDecimalTrade quota %Gewerbeanteil %
parkingShareDecimalParking share %Stellplatzanteil %
quotaUnrealTaxExemptDecimalQuota unreal tax-exempt %Anteil unecht steuerfrei %
recordIdRecordIdRecordIdDatensatz-ID

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiPurchaseCreditMemos


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiPurchaseCreditMemo
Entity (Plural/Endpunkt)relApiTabApiPurchaseCreditMemos
Quell-TabellePurch. Cr. Memo Entity Buffer (Business Central Standard)
SchlüsselfeldId (GUID)
SchreibzugriffJa — GET, POST, PATCH
Change TrackingAktiviert

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiPurchaseCreditMemos

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema) — Wichtigste Felder

FeldnameTypQuelleBeschreibung
idGUIDIdEindeutiger Schlüssel (OData-Key)
numberCodeNo.Belegnummer (nur lesbar)
creditMemoDateDateDocument DateGutschriftsdatum
postingDateDatePosting DateBuchungsdatum
dueDateDateDue DateFälligkeitsdatum
vendorIdGUIDVendor IdLieferanten-ID
vendorNumberCodeBuy-from Vendor No.Lieferantennummer
vendorNameTextBuy-from Vendor NameLieferantenname (nur lesbar)
vendorCreditMemoNumberTextVendor Cr. Memo No.Lieferanten-Gutschriftsnummer
payToVendorIdGUIDPay-to Vendor IdZahlung-an-Lieferanten-ID
payToVendorNumberCodePay-to Vendor No.Zahlung-an-Lieferantennummer
payToNameTextPay-to NameZahlung-an-Name (nur lesbar)
buyFromAddressLine1TextBuy-from AddressLieferantenadresse Zeile 1
buyFromAddressLine2TextBuy-from Address 2Lieferantenadresse Zeile 2
buyFromCityTextBuy-from CityStadt (Lieferant)
buyFromCountryCodeBuy-from Country/Region CodeLand (Lieferant)

Das vollständige Feldset ist umfangreich (BC Standard-API). Bitte $select für optimierte Abfragen verwenden.


Hinweise für Entwickler

Vendor-Verlinkung

Beim Anlegen per POST kann entweder vendorId (GUID) oder vendorNumber (Code) angegeben werden. Beide Felder werden automatisch synchronisiert.

Verknüpfte Positionen

Zeilenpositionen werden über die API relApiTabApiPurchaseCreditMemoLines abgerufen (separate Ressource).


Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiPurchaseInvoices


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiPurchaseInvoice
Entity (Plural/Endpunkt)relApiTabApiPurchaseInvoices
Quell-TabellePurch. Inv. Entity Aggregate (Business Central Standard)
SchlüsselfeldId (GUID)
SchreibzugriffJa — GET, POST, PATCH
Change TrackingAktiviert

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiPurchaseInvoices

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema) — Wichtigste Felder

FeldnameTypQuelleBeschreibung
idGUIDIdEindeutiger Schlüssel (OData-Key)
numberCodeNo.Rechnungsnummer (nur lesbar)
postingDateDatePosting DateBuchungsdatum
invoiceDateDateDocument DateRechnungsdatum
dueDateDateDue DateFälligkeitsdatum
vendorInvoiceNumberTextVendor Invoice No.Lieferantenrechnungsnummer
vendorIdGUIDVendor IdLieferanten-ID
vendorNumberCodeBuy-from Vendor No.Lieferantennummer
vendorNameTextBuy-from Vendor NameLieferantenname (nur lesbar)
payToNameTextPay-to NameZahlung-an-Name (nur lesbar)
payToContactTextPay-to ContactZahlung-an-Ansprechpartner
payToVendorIdGUIDPay-to Vendor IdZahlung-an-Lieferanten-ID
payToVendorNumberCodePay-to Vendor No.Zahlung-an-Lieferantennummer
shipToNameTextShip-to NameLieferadresse Name
buyFromAddressLine1TextBuy-from AddressLieferantenadresse Zeile 1
buyFromAddressLine2TextBuy-from Address 2Lieferantenadresse Zeile 2
buyFromCityTextBuy-from CityStadt (Lieferant)
buyFromCountryCodeBuy-from Country/Region CodeLand (Lieferant)
buyFromPostCodeCodeBuy-from Post CodePLZ (Lieferant)

Das vollständige Feldset entspricht dem BC-Standard-API. Bitte $select für optimierte Abfragen verwenden.


Verknüpfte Ressource

Rechnungszeilen werden über relApiTabApiPurchaseInvoiceLines abgerufen (separate Ressource, verknüpft via documentId).


Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiPurchaseOrder


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiPurchaseOrder
Entity (Plural/Endpunkt)relApiTabApiPurchaseOrder
Quell-TabellePurchase Order Entity Buffer (Business Central Standard)
SchlüsselfeldId (GUID)
SchreibzugriffJa — GET, POST, PATCH
Change TrackingAktiviert

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiPurchaseOrder

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema) — Wichtigste Felder

FeldnameTypQuelleBeschreibung
idGUIDIdEindeutiger Schlüssel (OData-Key)
numberCodeNo.Bestellnummer (nur lesbar)
orderDateDateDocument DateBestelldatum
postingDateDatePosting DateBuchungsdatum
vendorIdGUIDVendor IdLieferanten-ID
vendorNumberCodeBuy-from Vendor No.Lieferantennummer
vendorNameTextBuy-from Vendor NameLieferantenname (nur lesbar)
payToNameTextPay-to NameZahlung-an-Name (nur lesbar)
payToVendorIdGUIDPay-to Vendor IdZahlung-an-Lieferanten-ID
payToVendorNumberCodePay-to Vendor No.Zahlung-an-Lieferantennummer
shipToNameTextShip-to NameLieferadresse Name
shipToContactTextShip-to ContactLieferadresse Ansprechpartner
buyFromAddressLine1TextBuy-from AddressLieferantenadresse Zeile 1
buyFromAddressLine2TextBuy-from Address 2Lieferantenadresse Zeile 2
buyFromCityTextBuy-from CityStadt (Lieferant)

Das vollständige Feldset entspricht dem BC-Standard-API. Bitte $select für optimierte Abfragen verwenden.


Verknüpfte Ressource

Bestellpositionen werden über relApiTabApiPurchaseOrderLine abgerufen (separate Ressource, verknüpft via documentId).


Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiPurchaseOrderLine


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiPurchaseOrderLine
Entity (Plural/Endpunkt)relApiTabApiPurchaseOrderLine
Quell-TabellePurch. Inv. Line Aggregate (Business Central Standard)
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH
Change TrackingAktiviert

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiPurchaseOrderLine

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Schlüssel (OData-Key)
documentIdGUIDDocument IdVerknüpfung zum Bestellkopf
sequenceIntegerLine No.Positionsnummer
itemIdGUIDItem IdArtikel-ID
accountIdGUIDAccount IdSachkonto-ID
lineTypeEnumAPI TypePositionstyp (Item / Account)
lineObjectNumberCodeNo.Artikel- oder Kontonummer
descriptionTextDescriptionBeschreibung
description2TextDescription 2Beschreibung 2
unitOfMeasureIdGUIDUnit of Measure IdMaßeinheit-ID
unitOfMeasureCodeCodeUnit of Measure CodeMaßeinheitscode
quantityDecimalQuantityMenge
directUnitCostDecimalDirect Unit CostEinstandspreis
discountAmountDecimalLine Discount AmountRabattbetrag
discountPercentDecimalLine Discount %Rabattprozent

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiPurchaseCreditMemoLines


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiPurchaseCreditMemoLine
Entity (Plural/Endpunkt)relApiTabApiPurchaseCreditMemoLines
Quell-TabellePurch. Inv. Line Aggregate (temporär, Business Central Standard)
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH
Change TrackingAktiviert
Erlaubte

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiPurchaseCreditMemoLines

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Schlüssel (OData-Key)
documentIdGUIDDocument IdVerknüpfung zum Gutschriftskopf
sequenceIntegerLine No.Positionsnummer
itemIdGUIDItem IdArtikel-ID
accountIdGUIDAccount IdSachkonto-ID
lineTypeEnumAPI TypePositionstyp (Item / Account)
lineObjectNumberCodeNo.Artikel- oder Kontonummer
descriptionTextDescriptionBeschreibung
unitOfMeasureIdGUIDUnit of Measure IdMaßeinheit-ID
unitOfMeasureCodeCodeUnit of Measure CodeMaßeinheitscode
unitCostDecimalDirect Unit CostStückkosten
quantityDecimalQuantityMenge
discountAmountDecimalLine Discount AmountRabattbetrag
discountPercentDecimalLine Discount %Rabattprozent
discountAppliedBeforeTaxBooleanDiscount Applied Before TaxRabatt vor Steuer (nur lesbar)
amountExcludingTaxDecimalLine Amount Excluding TaxBetrag ohne Steuer (nur lesbar)

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiPurchaseInvoiceLines


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiPurchaseInvoiceLine
Entity (Plural/Endpunkt)relApiTabApiPurchaseInvoiceLines
Quell-TabellePurch. Inv. Line Aggregate (temporär, Business Central Standard)
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH
Change TrackingAktiviert

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiPurchaseInvoiceLines

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Schlüssel (OData-Key)
documentIdGUIDDocument IdVerknüpfung zum Rechnungskopf
sequenceIntegerLine No.Positionsnummer
itemIdGUIDItem IdArtikel-ID
accountIdGUIDAccount IdSachkonto-ID
lineTypeEnumAPI TypePositionstyp (Item / Account)
lineObjectNumberCodeNo.Artikel- oder Kontonummer
descriptionTextDescriptionBeschreibung
description2TextDescription 2Beschreibung 2
unitOfMeasureIdGUIDUnit of Measure IdMaßeinheit-ID
unitOfMeasureCodeCodeUnit of Measure CodeMaßeinheitscode
unitCostDecimalDirect Unit CostStückkosten
quantityDecimalQuantityMenge
discountAmountDecimalLine Discount AmountRabattbetrag
discountPercentDecimalLine Discount %Rabattprozent

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiReContactBusinessRelation


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiReContactBusinessRelation
Entity (Plural/Endpunkt)relApiTabApiReContactBusinessRelation
Quell-TabelleRelC Contact Business Relation
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiReContactBusinessRelation

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
ownerTenantCodeOwner / TenantEigentümer/Mieter
objectNoCodeObject No.Objektnummer
unitNoCodeUnit No.Einheitennummer
unitHistoryIntegerUnit historyEinheitenhistorie
businessRelationCodeBusiness RelationGeschäftsbeziehungsart
contactNoCodeContact No.Kontaktnummer
contractNoCodeContract No.Vertragsnummer
sectorMemberCodeSector/MemberSektor/Mitglied
recordIdRecordIdRecordIdDatensatz-ID

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiReContract


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiReContract
Entity (Plural/Endpunkt)relApiTabApiReContract
Quell-TabelleRelC Contract
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiReContract

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
noCodeNo.Vertragsnummer
supplementNoIntegerSupplement No.Nachtragnummer
supplementDateDateSupplement DateNachtragsdatum
contractCategoryCodeContract CategoryVertragskategorie
tenancyAgreementTypeEnumTenancy agreement typeMietvertragsart
customerVendorNoCodeCustomer/Vendor No.Kunden-/Lieferantennummer
contactTypeEnumContact TypeKontaktart
contactNoCodeContact No.Kontaktnummer
contractStartDateBeginning of contractVertragsbeginn
contractEndDateExpiration date of contractVertragsablauf
terminatedOnDateTerminated onGekündigt am
terminatedAsOfDateTerminated as ofKündigung zum
terminationReceiptDateDateDate receipt of terminationEingang Kündigung
terminationConfirmDateDateDate termination confirmationKündigungsbestätigung
signatureTenantDateSignature tenantUnterschrift Mieter
signatureLandlordDateSignature landlordUnterschrift Vermieter
moveInDateDateDelivery dateEinzugsdatum
moveOutDateDateTaking back dateAuszugsdatum
externalContractNoCodeExternal contract no.Externe Vertragsnummer
preferredMoveOutDateDateDesired return dateGewünschter Auszugstermin
preferredInspectionDateDateDesired date of acceptanceGewünschter Abnahmedatum
acceptedByCodeAccepted byAbgenommen von
actualInspectionDateDateDate of acceptanceTatsächliches Abnahmedatum
plannedInspectionDateDateAcceptance deadlineGeplantes Abnahmedatum
plannedInspectionTimeTimeTime of acceptanceAbnahmezeit
recordIdRecordIdRecordIdDatensatz-ID

Typische Anwendungsfälle

// Aktive Verträge
GET .../relApiTabApiReContract?$filter=contractEnd eq null or contractEnd gt 2026-01-01

// Verträge eines bestimmten Kontakts
GET .../relApiTabApiReContract?$filter=contactNo eq 'K-0001'

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiRelCMEXARecord


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiRelCMEXARecord
Entity (Plural/Endpunkt)relApiTabApiRelCMEXARecord
Quell-TabelleRelC MEX A-Record
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiRelCMEXARecord

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
mexAKeyBillingCompanyCodeMexAKey Billing CompanyMEX-Schlüssel Abrechnungsgesellschaft
serviceCompNameTextService Comp. Name$Name der Servicegesellschaft
mexAOurAccountNoCodeMexAOur Account No.Unser MEX-Kontonummer
externalIDTextExternal IDExterne ID (Auftragsterm Abrechnungsgesellschaft)
versionTextVersion$Version
ownerTenantCodeOwner / TenantEigentümer/Mieter
objectNoCodeObject No.Objektnummer
unitNoCodeUnit No.Einheitennummer
recordIdRecordIdRecordIdDatensatz-ID

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiReminderLevels


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiReminderLevel
Entity (Plural/Endpunkt)relApiTabApiReminderLevels
Quell-TabelleReminder Level (Business Central Standard)
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiReminderLevels

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
reminderTermsCodeCodeReminder Terms CodeMahnbedingungscode (Verknüpfung zu relApiTabApiReminderTerms)
noIntegerNo.Mahnstufe (1, 2, 3, …)
gracePeriodDateFormulaGrace PeriodKarenzzeit
dueDateCalculationDateFormulaDue Date CalculationFälligkeitsberechnung
relCReminderTitle1TextRelC Reminder Title 1Mahntitel 1
relCReminderTitle2TextRelC Reminder Title 2Mahntitel 2
relCAddFeeDescriptionTextRelC Add. Fee DescriptionBeschreibung Zusatzgebühr

Hinweise für Entwickler

Diese Ressource wird in der Regel als SubPage von relApiTabApiReminderTerms konsumiert. Ein Direktabruf ist ebenfalls möglich.


Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiReminderTerms


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiReminderTerms
Entity (Plural/Endpunkt)relApiTabApiReminderTerms
Quell-TabelleReminder Terms (Business Central Standard)
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiReminderTerms

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
codeCodeCodeMahnbedingungscode
descriptionTextDescriptionBeschreibung
maxNoOfRemindersIntegerMax. No. of RemindersMaximale Anzahl Mahnungen
postAdditionalFeeBooleanPost Additional FeeZusatzgebühr buchen
Verknüpfte Ressource (SubPage)
NavigationBeschreibung
RelApiTabApiReminderLevel (EntitySet: relApiTabApiReminderLevels)Zugehörige Mahnstufen (via code)

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiReObject


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiReObject
Entity (Plural/Endpunkt)relApiTabApiReObject
Quell-TabelleRelC Object
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiReObject

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
ownerTenantCodeOwner / TenantEigentümer/Mieter
objectNoCodeNo.Objektnummer
descriptionTextDescriptionObjektbeschreibung
addressTextAddressAdresse
postCodeCodePost CodePostleitzahl
cityTextCityStadt
countryRegionCodeCountry/Region CodeLändercode
countyCodeCodeCounty CodeKreis-/Bezirkscode
yearOfConstructionIntegerYear Of ConstructionBaujahr
completionDateDateFinish DateFertigstellungsdatum
responsibilityCenterOwnerNoCodeResponsibility Center OwnerZuständigkeitscenter Eigentümer (Code)
responsibilityCenterOwnerIdGUIDOwnerRespIDZuständigkeitscenter Eigentümer (GUID)
responsibilityCenterManagerNoCodeResponsibility Center ManagerZuständigkeitscenter Verwalter (Code)
responsibilityCenterManagerIdGUIDManagerRespIDZuständigkeitscenter Verwalter (GUID)
managementStartDateDateManagement Start DateVerwaltungsbeginn
managementEndDateDateManagement End DateVerwaltungsende
recordIdRecordIdRecordIdDatensatz-ID
Verknüpfte Ressourcen (SubPages)
NavigationBeschreibung
RelApiTabApiUnitMasterDataEinheitenstammdaten des Objekts
RelApiTabApiEditorBearbeiter/Verwalter des Objekts

Typische Anwendungsfälle

// Alle Objekte eines Eigentümers
GET .../relApiTabApiReObject?$filter=ownerTenant eq 'OT-001'

// Einzelnes Objekt per ID
GET .../relApiTabApiReObject({id})

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiReportInboxes


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiReportInbox
Entity (Plural/Endpunkt)relApiTabApiReportInboxes
Quell-TabelleReport Inbox (Business Central Standard)
SchlüsselfeldSystemId (GUID)
SchreibschutzJa — nur Lesezugriff (GET)

Basis-URL

GET /api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiReportInboxes

Erlaubte HTTP-Methoden

MethodeErlaubtBeschreibung
GETEinträge abrufen (Liste oder einzeln)
POSTNicht erlaubt
PATCHNicht erlaubt
DELETENicht erlaubt

Endpunkte

Alle Einträge abrufen
GET /api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiReportInboxes
Einzelnen Eintrag abrufen (via SystemId)
GET /api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiReportInboxes({id})

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel des Datensatzes (OData-Key)
reportIdIntegerReport IDID des Reports in Business Central
reportNameTextReport NameName des Reports
descriptionTextDescriptionBeschreibung des Berichtseintrags
createdDateTimeDateTimeCreated Date-TimeZeitstempel der Erstellung des Eintrags
entryNoIntegerEntry No.Fortlaufende Eintragsnummer
jobQueueLogEntryIDGUIDJob Queue Log Entry IDVerknüpfung zum Job-Queue-Logeintrag
outputTypeEnumOutput TypeAusgabeformat (z. B. PDF, Word, Excel)
readBooleanReadGibt an, ob der Eintrag bereits gelesen wurde
reportOutputBlobReport OutputBinärer Inhalt des generierten Reports
fileNameTextBerechnetDateiname: reportName + . + outputType (Kleinbuchstaben), z. B. Rechnung.pdf
userIDTextUser IDBC-Benutzer, dem der Bericht zugeordnet ist
systemCreatedAtDateTimeSystemfeldZeitstempel der Datensatzerstellung (BC intern)
systemCreatedByGUIDSystemfeldBenutzer-GUID, der den Datensatz erstellt hat
systemModifiedAtDateTimeSystemfeldZeitstempel der letzten Änderung
systemModifiedByGUIDSystemfeldBenutzer-GUID, der zuletzt geändert hat

Hinweise für Entwickler

reportOutput (Blob)

Das Feld enthält die binären Rohdaten des Reports. Es wird per CalcFields auf Anfrage befüllt (OnAfterGetRecord-Trigger). Beim Abrufen über OData wird dieses Feld standardmäßig nicht mitgeliefert — es muss explizit per $expand oder direktem Abruf angefordert werden, sofern die BC-Version dies unterstützt. Alternativ kann der Blob-Inhalt über einen separaten Stream-Endpunkt abgerufen werden.

fileName (berechnet)

Dieses Feld ist nicht in der Datenbank gespeichert. Es wird zur Laufzeit zusammengesetzt:

FileNameTxt := Rec."Report Name" + '.' + LowerCase(Format(Rec."Output Type"));

Beispiel: Report Name = "Jahresabrechnung", Output Type = PDFfileName = "Jahresabrechnung.pdf"


OData-Filterung

Typische Filter-Beispiele:

// Nur ungelesene Einträge
GET .../relApiTabApiReportInboxes?$filter=read eq false

// Berichte eines bestimmten Benutzers
GET .../relApiTabApiReportInboxes?$filter=userID eq 'MUSTER'

// PDF-Berichte nach Erstellungsdatum sortiert
GET .../relApiTabApiReportInboxes?$filter=outputType eq 'PDF'&$orderby=createdDateTime desc

// Felder einschränken
GET .../relApiTabApiReportInboxes?$select=id,fileName,createdDateTime,read

Beispiel-Response (JSON)

{
  "@odata.context": "...",
  "value": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "reportId": 1306,
      "reportName": "Jahresabrechnung",
      "description": "Jahresabrechnung 2025 - Objekt 0815",
      "createdDateTime": "2026-01-15T08:30:00Z",
      "entryNo": 42,
      "jobQueueLogEntryID": "8e3f1a2b-0000-0000-0000-000000000000",
      "outputType": "PDF",
      "read": false,
      "fileName": "Jahresabrechnung.pdf",
      "userID": "MUSTER",
      "reportOutput": "<base64-encoded-blob>",
      "systemCreatedAt": "2026-01-15T08:30:00Z",
      "systemCreatedBy": "00000000-0000-0000-0000-000000000001",
      "systemModifiedAt": "2026-01-15T08:30:00Z",
      "systemModifiedBy": "00000000-0000-0000-0000-000000000001"
    }
  ]
}

Für Frontend-Entwickler: Typische Anwendungsfälle

SzenarioEmpfehlung
Posteingang anzeigen$filter=read eq false, $orderby=createdDateTime desc
Report herunterladenreportOutput (Blob) dekodieren, fileName als Dateinamen verwenden
Benutzer-spezifische Berichte$filter=userID eq '{BC-Username}'
Paginierung$top und $skip verwenden
Minimale Datenmenge laden$select verwenden, reportOutput nur bei Bedarf laden

Authentifizierung

Die API folgt dem Standard-Authentifizierungsverfahren von Business Central:

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud-Umgebungen
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiResponsabilityCenter


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiResponsabilityCenter
Entity (Plural/Endpunkt)relApiTabApiResponsabilityCenter
Quell-TabelleResponsibility Center (Business Central Standard)
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiResponsabilityCenter

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
codeCodeCodeZuständigkeitscenter-Code
nameTextNameName
addressTextAddressAdresse
postCodeCodePost CodePostleitzahl
cityTextCityStadt
recordIdRecordIdRecordIdDatensatz-ID

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiSalesCreditMemos


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiSalesCreditMemo
Entity (Plural/Endpunkt)relApiTabApiSalesCreditMemos
Quell-TabelleSales Cr. Memo Entity Buffer (Business Central Standard)
SchlüsselfeldId (GUID)
SchreibzugriffJa — GET, POST, PATCH
Change TrackingAktiviert

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiSalesCreditMemos

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema) — Wichtigste Felder

FeldnameTypQuelleBeschreibung
idGUIDIdEindeutiger Schlüssel (OData-Key)
numberCodeNo.Belegnummer (nur lesbar)
externalDocumentNumberTextExternal Document No.Externe Belegnummer
creditMemoDateDateDocument DateGutschriftsdatum
postingDateDatePosting DateBuchungsdatum
dueDateDateDue DateFälligkeitsdatum
customerIdGUIDCustomer IdKunden-ID
customerNumberCodeSell-to Customer No.Kundennummer
customerNameTextSell-to Customer NameKundenname (nur lesbar)
billToNameTextBill-to NameRechnungsempfänger Name (nur lesbar)
billToCustomerIdGUIDBill-to Customer IdRechnungsempfänger-ID
billToCustomerNumberCodeBill-to Customer No.Rechnungsempfängernummer
sellToAddressLine1TextSell-to AddressLieferadresse Zeile 1
sellToAddressLine2TextSell-to Address 2Lieferadresse Zeile 2
sellToCityTextSell-to CityStadt (Lieferadresse)
sellToCountryCodeSell-to Country/Region CodeLand (Lieferadresse)

Zeilenpositionen werden über relApiTabApiSalesCreditMemoLines abgerufen.


Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiSalesCreditMemoLines


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiSalesCreditMemoLine
Entity (Plural/Endpunkt)relApiTabApiSalesCreditMemoLines
Quell-TabelleSales Invoice Line Aggregate (temporär, Business Central Standard)
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiSalesCreditMemoLines

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Schlüssel (OData-Key)
documentIdGUIDDocument IdVerknüpfung zum Gutschriftskopf
sequenceIntegerLine No.Positionsnummer
itemIdGUIDItem IdArtikel-ID
accountIdGUIDAccount IdSachkonto-ID
lineTypeEnumAPI TypePositionstyp (Item / Account)
lineObjectNumberCodeNo.Artikel- oder Kontonummer
descriptionTextDescriptionBeschreibung
description2TextDescription 2Beschreibung 2
unitOfMeasureIdGUIDUnit of Measure IdMaßeinheit-ID
unitOfMeasureCodeCodeUnit of Measure CodeMaßeinheitscode
unitPriceDecimalUnit PriceEinzelpreis
quantityDecimalQuantityMenge
discountAmountDecimalLine Discount AmountRabattbetrag
discountPercentDecimalLine Discount %Rabattprozent
discountAppliedBeforeTaxBooleanDiscount Applied Before TaxRabatt vor Steuer (nur lesbar)

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiSalesInvoice


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiSalesInvoice
Entity (Plural/Endpunkt)relApiTabApiSalesInvoice
Quell-TabelleSales Invoice Entity Aggregate (Business Central Standard)
SchlüsselfeldId (GUID)
SchreibzugriffJa — GET, POST, PATCH
Change TrackingAktiviert

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiSalesInvoice

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema) — Wichtigste Felder

FeldnameTypQuelleBeschreibung
idGUIDIdEindeutiger Schlüssel (OData-Key)
numberCodeNo.Rechnungsnummer (nur lesbar)
externalDocumentNumberTextExternal Document No.Externe Belegnummer
invoiceDateDateDocument DateRechnungsdatum
postingDateDatePosting DateBuchungsdatum
dueDateDateDue DateFälligkeitsdatum
customerPurchaseOrderReferenceTextYour ReferenceBestellreferenz des Kunden
customerIdGUIDCustomer IdKunden-ID
customerNumberCodeSell-to Customer No.Kundennummer
customerNameTextSell-to Customer NameKundenname (nur lesbar)
billToNameTextBill-to NameRechnungsempfänger Name (nur lesbar)
billToCustomerIdGUIDBill-to Customer IdRechnungsempfänger-ID
billToCustomerNumberCodeBill-to Customer No.Rechnungsempfängernummer
shipToNameTextShip-to NameLieferadresse Name
shipToContactTextShip-to ContactLieferadresse Ansprechpartner
sellToAddressLine1TextSell-to AddressLieferadresse Zeile 1
sellToAddressLine2TextSell-to Address 2Lieferadresse Zeile 2
sellToCityTextSell-to CityStadt (Lieferadresse)
sellToCountryCodeSell-to Country/Region CodeLand (Lieferadresse)

Das vollständige Feldset entspricht dem BC-Standard-API. Rechnungspositionen über relApiTabApiSalesInvoiceLine.


Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiSalesInvoiceLine


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiSalesInvoiceLine
Entity (Plural/Endpunkt)relApiTabApiSalesInvoiceLine
Quell-TabelleSales Invoice Line Aggregate (temporär, Business Central Standard)
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH
Change TrackingAktiviert

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiSalesInvoiceLine

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Schlüssel (OData-Key)
documentIdGUIDDocument IdVerknüpfung zum Rechnungskopf
sequenceIntegerLine No.Positionsnummer
itemIdGUIDItem IdArtikel-ID
accountIdGUIDAccount IdSachkonto-ID
lineTypeEnumAPI TypePositionstyp (Item / Account)
lineObjectNumberCodeNo.Artikel- oder Kontonummer
descriptionTextDescriptionBeschreibung
description2TextDescription 2Beschreibung 2
unitOfMeasureIdGUIDUnit of Measure IdMaßeinheit-ID
unitOfMeasureCodeCodeUnit of Measure CodeMaßeinheitscode
quantityDecimalQuantityMenge
unitPriceDecimalUnit PriceEinzelpreis
discountAmountDecimalLine Discount AmountRabattbetrag
discountPercentDecimalLine Discount %Rabattprozent

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiSalespersonPurchaser


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiSalespersonPurchaser
Entity (Plural/Endpunkt)relApiTabApiSalespersonPurchaser
Quell-TabelleSalesperson/Purchaser (Business Central Standard)
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiSalespersonPurchaser

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemCreatedAtDateTimeSystemCreatedAtErstellungsdatum
systemCreatedByGUIDSystemCreatedByErstellt von
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
systemModifiedByGUIDSystemModifiedByZuletzt geändert von
codeCodeCodeVerkäufer/Einkäufer-Code
nameTextNameName
jobTitleTextJob TitleBerufsbezeichnung
eMailTextE-MailE-Mail
eMail2TextE-Mail 2E-Mail 2
phoneNoTextPhone No.Telefon
blockedBooleanBlockedGesperrt
commissionDecimalCommission %Provision %
relCContactNoCodeRelC Contact No.Kontaktnummer (RELion)
relCFaxNoTextRelC Fax No.Faxnummer (RELion)
relCMobilePhoneNoTextRelC Mobile Phone No.Mobilnummer (RELion)
relCRepresentativeBooleanRelC RepresentativeVertreter
relCSignatureTextRelC SignatureUnterschrift
globalDimension1CodeCodeGlobal Dimension 1 CodeGlobale Dimension 1
globalDimension2CodeCodeGlobal Dimension 2 CodeGlobale Dimension 2
recordIdRecordIdRecordIdDatensatz-ID

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiSecurityForRent


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv1.0
Entity (Singular)relApiTabApiSecurityForRent
Entity (Plural/Endpunkt)relApiTabApiSecurityForRent
Quell-TabelleRelC Security For Rent
SchlüsselfeldSystemId (GUID)
SchreibschutzJa — nur Lesezugriff (GET)

Hinweis: Diese API verwendet Version v1.0 (abweichend von den meisten anderen Endpunkten mit v2.0).


Basis-URL

GET /api/aareon/relionBaseApi/v1.0/companies({companyId})/relApiTabApiSecurityForRent

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemCreatedAtDateTimeSystemCreatedAtErstellungsdatum
systemCreatedByGUIDSystemCreatedByErstellt von
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
systemModifiedByGUIDSystemModifiedByZuletzt geändert von
ownerTenantCodeOwner / TenantEigentümer/Mieter
objectNoCodeObject No.Objektnummer
unitNoCodeUnit No.Einheitennummer
unitHistoryIntegerUnit historyEinheitenhistorie
noCodeNo.Mietkautionsnummer
contractNoCodeContract No.Vertragsnummer
kindOfSecurityForRentCodeKind of security for rentArt der Mietkaution
rentSecurityAmountUpdatedDecimalRent security amount updatedAktualisierter Kautionsbetrag

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiSpaceAndSurface


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiSpaceAndSurface
Entity (Plural/Endpunkt)relApiTabApiSpaceAndSurface
Quell-TabelleRelC Space and surface
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiSpaceAndSurface

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
ownerTenantCodeOwner / TenantEigentümer/Mieter
objectNoCodeObject No.Objektnummer
unitNoCodeUnit No.Einheitennummer
codeCodeArea codeFlächencode
startDateDateValid as ofGültig ab
endDateDateValid toGültig bis
roomNoCodeRoom no.Raumnummer
roomNameTextRoom nameRaumname
buildingCodeBuildingGebäude
houseCodeHouseHaus
quantityDecimalQuantityAnzahl
areaSqmDecimalArea in sqmFläche in m²
unitCodeCodeUnit codeEinheitencode
exploitationMethodCodeExploitation methodNutzungsart
recordIdRecordIdRecordIdDatensatz-ID

Typische Anwendungsfälle

// Flächen einer bestimmten Einheit
GET .../relApiTabApiSpaceAndSurface?$filter=ownerTenant eq 'OT-001' and objectNo eq 'OBJ-001' and unitNo eq 'E-001'

// Aktuelle Flächen (Gültigkeitsprüfung)
GET .../relApiTabApiSpaceAndSurface?$filter=startDate le 2026-04-24 and (endDate eq null or endDate ge 2026-04-24)

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiTenantContractDraft


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiTenantContractDraft
Entity (Plural/Endpunkt)relApiTabApiTenantContractDraft
Quell-TabelleRelC Tenant Contract Draft
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiTenantContractDraft

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
ownerTenantCodeOwner / TenantEigentümer/Mieter
objectNoCodeObject No.Objektnummer
unitNoCodeUnit No.Einheitennummer
addressTextAddressAdresse
postCodeCodePost CodePostleitzahl
cityTextCityStadt
importDateTimeDateTimeImport DateTimeImport-Zeitstempel
importSourceTextImport SourceImportquelle
beginningOfContractDateBeginning of ContractVertragsbeginn
salutationCodeCodeSalutation CodeAnredecode
jobTitleTextJob TitleBerufsbezeichnung
firstNameTextFirst NameVorname
surnameTextSurnameNachname
phoneNoTextPhone No.Telefon
remarkPhoneNoTextRemark Phone No.Bemerkung Telefon
phoneCompanyTextPhone CompanyFirmentelefon
mobilePhoneNoTextMobile Phone No.Mobilnummer
remarkMobilePhoneNoTextRemark Mobile Phone No.Bemerkung Mobilnummer
faxNoTextFax No.Faxnummer
eMailTextE-MailE-Mail-Adresse
dateOfBirthDateDate of BirthGeburtsdatum
nameAtBirthTextName at BirthGeburtsname
occupationTextOccupationBeruf
recordIdRecordIdRecordIdDatensatz-ID

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiRelCTicketInput


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiRelCTicketInput
Entity (Plural/Endpunkt)relApiTabApiRelCTicketInput
Quell-TabelleRelC Ticket Input
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiRelCTicketInput

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
systemCreatedByGUIDSystemCreatedByErstellt von
statusEnumStatusTicketstatus
issueTextIssueProblem/Störung
descriptionTextDescriptionBeschreibung
priorityEnumPriorityPriorität
contactNoCodeContact No.Kontaktnummer
contactNameTextContact NameKontaktname
contractNoCodeContract No.Vertragsnummer
completedDateDateCompleted DateErledigungsdatum
ticketReportedByNameCodeTicket Reported By NameGemeldet von (Kontakt)
ticketTypeCodeCodeTicket Type CodeTickettyp-Code
ticketTypeTextTicket TypeTickettyp
assignedPersonCodeAssigned PersonZugewiesene Person
ticketProcessorPersonCodeTicket processor PersonBearbeitender Benutzer
recordIdRecordIdRecordIdDatensatz-ID
Verknüpfte Ressourcen (SubPages)
NavigationBeschreibung
RelApiTabApiSalespersonPurchVerknüpfter Sachbearbeiter (via assignedPerson)
RelApiTabApiTicketInputMessageNachrichten/Kommentare zum Ticket

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiRelCTicketInputMessage


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiRelCTicketInputMessage
Entity (Plural/Endpunkt)relApiTabApiRelCTicketInputMessage
Quell-TabelleRelC Ticket Input Message
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiRelCTicketInputMessage

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
ticketInputNoCodeTicket Input No.Ticket-Nummer (Verknüpfung)
noticeNoIntegerNotice No.Hinweisnummer
lineNoIntegerLine No.Zeilennummer
headLineTextHeadlineBetreff/Überschrift
commentTextCommentKommentartext

Hinweise für Entwickler

Diese Ressource wird in der Regel als SubPage von relApiTabApiRelCTicketInput konsumiert. Ein Direktabruf mit Filter auf ticketInputNo ist ebenfalls möglich.

// Alle Nachrichten zu einem Ticket
GET .../relApiTabApiRelCTicketInputMessage?$filter=ticketInputNo eq 'TICKET-0001'

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiRelCTicketType


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiRelCTicketType
Entity (Plural/Endpunkt)relApiTabApiRelCTicketType
Quell-TabelleRelC Ticket Type
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiRelCTicketType

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
codeCodeCodeTickettyp-Code
typeEnumTypeTyp
levelIntegerLevelHierarchieebene
codeFaultCodeCode FaultFehlercode
belongsToCodeCodeBelongs to CodeÜbergeordneter Code
descriptionTextDescriptionBeschreibung
recordIdRecordIdRecordIdDatensatz-ID

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiUnitAllocation


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiUnitAllocation
Entity (Plural/Endpunkt)relApiTabApiUnitAllocation
Quell-TabelleRelC Unit Allocation
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiUnitAllocation

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
ownerTenantCodeOwner / TenantEigentümer/Mieter
objectNoCodeObject No.Objektnummer
unitNoCodeUnit No.Einheitennummer
allocationCodeCodeAllocation CodeUmlageschlüssel-Code
startDateDateStart DateGültig ab
endDateDateEnd DateGültig bis
descriptionTextDescriptionBeschreibung
reasonChangeTextReason for ChangeÄnderungsgrund
factorDecimalFactorFaktor
recordIdRecordIdRecordIdDatensatz-ID

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiUnitEquipment


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiUnitEquipment
Entity (Plural/Endpunkt)relApiTabApiUnitEquipment
Quell-TabelleRelC Unit Equipment
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiUnitEquipment

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
unitEquipmentSerialNoCodeUnit Equipment Serial No.Seriennummer der Ausstattung
ownerTenantCodeOwner / TenantEigentümer/Mieter
objectNoCodeObject No.Objektnummer
buildingCodeBuildingGebäude
houseCodeHouseHaus
unitNoCodeUnit No.Einheitennummer
roomCodeRoomRaum
codeCodeCodeAusstattungscode
equipmentCategoryCodeEquipment categoryAusstattungskategorie
typeOfDesignTextType of designDesigntyp
materialTextMaterialMaterial
colourTextColorFarbe
descriptionTextDescriptionBeschreibung
description2KeyIdTextDescription 2Beschreibung 2 / Schlüssel-ID
installationDateDateInstallation dateInstallationsdatum
removeDateDateAddition dateHinzufügungsdatum
isKeyBooleanKeyIst Schlüssel (Hinweis: Feldname key ist AL-Keyword)
numberOfKeysIntegerNumberAnzahl Schlüssel
quantityDecimalQuantityMenge
quantityUnitCodeQuantity unitMengeneinheit
inventoryNoCodeInventory NoInventarnummer
attribute1TextAttribute1Attribut 1
attribute2TextAttribute2Attribut 2
attribute3TextAttribute3Attribut 3
lastTestDateDateLast test dateLetztes Prüfdatum
nextTestDateDateNext test dateNächstes Prüfdatum
lengthDecimalLengthLänge
widthDecimalWidthBreite
heightDecimalHeightHöhe
areaSquareMetersDecimalAreaFläche m² (Feldname area ist AL-Keyword)
propertyOfCodePropertyOfEigentum von
costTakeoverDecimalCost TakeoverKostenübernahme
manufacturingDateDateManufacturing dateHerstellungsdatum
recordIdRecordIdRecordIdDatensatz-ID

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiUnitMasterData


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiUnitMasterData
Entity (Plural/Endpunkt)relApiTabApiUnitMasterData
Quell-TabelleRelC Unit Master Data
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiUnitMasterData

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
ownerTenantCodeOwner / TenantEigentümer/Mieter
objectNoCodeObject No.Objektnummer
unitNoCodeUnit No.Einheitennummer
addressTextAddressAdresse
address2TextAddress 2Adresszusatz
postCodeCodePost CodePostleitzahl
cityTextCityStadt
descriptionTextDescriptionBeschreibung
buildingCodeBuildingGebäude
houseCodeHouseHaus
locationCodeLocationLage
floorCodeFloorEtage
mgtStartDateDateManagement StartVerwaltungsbeginn
mgtEndDateDateManagement EndVerwaltungsende
exploitationMethodCodeExploitation MethodNutzungsart
vatBusinessPostingGroupCodeVat business posting groupMwSt.-Geschäftsbuchungsgruppe
numberOfRoomsTextTextNumber rooms (text)Anzahl Zimmer (Text)
numberOfWholeRoomsDecimalNumber whole roomsAnzahl ganze Zimmer
numberOfHalfRoomsDecimalNumber half roomsAnzahl halbe Zimmer
areaAllocationCodeCodeArea allocation codeFlächenverteilungscode
recordIdRecordIdRecordIdDatensatz-ID
Verknüpfte Ressourcen (SubPages)
NavigationBeschreibung
RelApiTabApiExploitationMethodNutzungsart-Details (via exploitationMethod)
RelApiTabApiUnitAllocationEinheitenzuweisungen (via areaAllocationCode)
Service-Prozedur
ProzedurRückgabeBeschreibung
VacanciesExportXml()TextGibt OpenImmo-konformes XML für Leerstandsexporte zurück

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiUnitsContract


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiUnitsContract
Entity (Plural/Endpunkt)relApiTabApiUnitsContract
Quell-TabelleRelC Unit Contract
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiUnitsContract

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
systemModifiedAtDateTimeSystemModifiedAtLetztes Änderungsdatum
ownerTenantCodeOwner / TenantEigentümer/Mieter
objectNoCodeObject No.Objektnummer
unitNoCodeUnit No.Einheitennummer
historyIntegerHistoryHistoriennummer
serialNoIntegerSerial No.Laufende Nummer
contractNoCodeContract No.Vertragsnummer
descriptionTextDescriptionBeschreibung
customerNoCodeCustomer No.Kundennummer
unitContractStartDateBeginning of contractVertragsbeginn
unitContractEndDateExp. date of contr.Vertragsablauf
dateMoveInDateDate move-inEinzugsdatum
dateMoveOutDateDate excerptAuszugsdatum
vacancyBooleanVacancyLeerstand
externalUnitNoCodeExternal Unit No.Externe Einheitennummer
vatBusinessPostingGroupCodeVAT business posting groupMwSt.-Buchungsgruppe
reasonForTerminationCodeReason for terminationKündigungsgrund
reasonForVacancyCodeReason for vacancyLeerstandsgrund
areaAllocationCodeCodeArea Allocation CodeFlächenverteilungscode
areaAllocationSqmDecimalArea Allocation SqmFlächenverteilung m²
recordIdRecordIdRecordIdDatensatz-ID
Verknüpfte Ressourcen (SubPages)
NavigationBeschreibung
RelApiTabApiRelCMexARecordMEX A-Records der Einheit
RelApiTabApiAllocGroupParticipUmlagegruppenverteilungen (via areaAllocationCode)

Typische Anwendungsfälle

// Leerstände abrufen
GET .../relApiTabApiUnitsContract?$filter=vacancy eq true

// Aktive Verträge einer Einheit
GET .../relApiTabApiUnitsContract?$filter=ownerTenant eq 'OT-001' and objectNo eq 'OBJ-001' and unitContractEnd eq null

Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises

relApiTabApiVendor


Übersicht

EigenschaftWert
Publisheraareon
API-GrupperelionBaseApi
Versionv2.0
Entity (Singular)relApiTabApiVendor
Entity (Plural/Endpunkt)relApiTabApiVendor
Quell-TabelleVendor (Business Central Standard)
SchlüsselfeldSystemId (GUID)
SchreibzugriffJa — GET, POST, PATCH
Change TrackingAktiviert

Basis-URL

/api/aareon/relionBaseApi/v2.0/companies({companyId})/relApiTabApiVendor

Erlaubte HTTP-Methoden

MethodeErlaubt
GET
POST
PATCH
DELETE

Felder (Response-Schema)

FeldnameTypQuelleBeschreibung
idGUIDSystemIdEindeutiger Systemschlüssel (OData-Key)
numberCodeNo.Lieferantennummer
displayNameTextNameName
addressLine1TextAddressAdresse Zeile 1
addressLine2TextAddress 2Adresse Zeile 2
cityTextCityStadt
stateTextCountyBundesland
countryCodeCountry/Region CodeLändercode
postalCodeCodePost CodePostleitzahl
phoneNumberTextPhone No.Telefon
emailTextE-MailE-Mail
websiteTextHome PageWebseite
taxRegistrationNumberTextVAT Registration No.Steuernummer / USt-IdNr. (berechnet)
currencyIdGUIDCurrency IdWährungs-ID
currencyCodeCodeBerechnetWährungscode

Das vollständige Feldset ist umfangreich (BC Standard-API). Bitte $select für optimierte Abfragen verwenden.


Hinweise für Entwickler

taxRegistrationNumber (berechnet)

Je nach Lokalisierung wird entweder VAT Registration No. oder die belgische Enterprise No. zurückgeliefert. Beim PATCH wird das Feld entsprechend zurückgeschrieben.

currencyCode

Beim PATCH kann entweder currencyId (GUID) oder currencyCode (Code) angegeben werden. Beide Felder werden synchronisiert. Ein leeres currencyId setzt die Währung auf Leer (Landeswährung).


Authentifizierung

  • OAuth 2.0 (Azure AD / Entra ID) für Cloud
  • Basic Auth / Windows Auth für On-Premises
Zuletzt geändert June 17, 2026: Merged PR 7462: Release-Tabellen12.36 (7403740)