OData-Services & Datenmodell
Eine Entität trägt den offenen Posten — samt Ausgleich, Mahndaten und den Verweisen nach SD.
In der FI-AR ist der offene Posten eine Zeile eines Buchhaltungsbelegs (klassisch BSID/BSAD, heute das Universal Journal). Die freigegebene API dazu heißt API_OPLACCTGDOCITEMCUBE_SRV und liefert die Entität A_OperationalAcctgDocItemCube mit 267 Eigenschaften — darunter die Ausgleichsfelder, die Mahnfelder und die Verweise auf Auftrag und Rechnung. Genau deshalb sind die zwei optionalen Umfänge dieser Integration billig.
Die Services
| Rolle | Service | Entitäten (Schlüssel) | Umfang |
|---|---|---|---|
| Offener Posten | API_OPLACCTGDOCITEMCUBE_SRV (OData V2) | A_OperationalAcctgDocItemCube (CompanyCode, FiscalYear, AccountingDocument, AccountingDocumentItem) | Pflicht |
| Stammdaten | API_BUSINESS_PARTNER (OData V2) | A_BusinessPartner · A_BusinessPartnerAddress · A_BusinessPartnerBank · A_BusinessPartnerTaxNumber · A_Customer · A_CustomerCompany (Customer, CompanyCode) · A_CustomerDunning (Customer, CompanyCode, DunningArea) | Pflicht |
| Kreditor | dieselben zwei Services | A_Supplier · A_SupplierCompany; die Posten über FinancialAccountType = 'K' | optional (FI-AP) |
| Auftrag | API_SALES_ORDER_SRV | A_SalesOrder · A_SalesOrderItem · A_SalesOrderHeaderPartner | optional (SD) |
| Rechnung | API_BILLING_DOCUMENT_SRV | A_BillingDocument · A_BillingDocumentItem; liefert auch das Rechnungs-PDF | optional (SD) |
Als Alternative für den Posten gibt es API_JOURNALENTRYITEMBASIC_SRV. Es schlüsselt auf einer technischen ID statt auf dem Belegschlüssel — für einen Delta-Abzug, der auf demselben Schlüssel aktualisieren muss wie Bilendo, ist das der schlechtere Anker. In der Public Cloud steht zusätzlich CE_API_ACCOUNTING_DOCUMENT_0001 („Receivable Item – Read“, OData V4) bereit; im On-Premise-Paket gibt es das nicht, also ist es kein gemeinsamer Nenner.
Zwei Dinge, die es nicht gibt
Keine freigegebene FI-AR-Mahn-API.
CADUNNING_0001gehört zum Vertragskontokorrent. Gebraucht wird trotzdem keine: die Mahndaten stehen am Debitor (A_CustomerDunning: Mahnverfahren, Stufe, letztes Mahndatum, Sperre, Mahnempfänger) und am Posten (DunningLevel,LastDunningDate,DunningArea,DunningKey,DunningBlockingReason).Kein Restbetrag am Posten. Ein Posten ist offen oder ausgeglichen (
IsCleared). Was in anderen Systemen ein Feld ist, entsteht hier aus der Restpostenbildung — siehe die Mapping-Seite.
Delta-Fähigkeit
Anders als das Vertragskontokorrent trägt der FI-AR-Posten einen Änderungsstempel. Drei Filter, weil ein Ausgleich den Stempel nicht in jedem System bewegt:
| Objekt | Änderungsstempel | Folge für den Delta |
|---|---|---|
A_BusinessPartner | LastChangeDate + LastChangeTime | Filter auf den Stempel. |
A_Customer / A_CustomerDunning | keiner | Über den Geschäftspartner mitziehen; die Mahndaten sind eine kleine Menge und werden voll gelesen. |
A_OperationalAcctgDocItemCube | LastChangeDate, AccountingDocumentCreationDate + CreationTime | Neue Posten über PostingDate, Änderungen über LastChangeDate, Ausgleiche zusätzlich über ClearingDate. |
| Aufträge / Rechnungen | LastChangeDate | Nachrangig, nur zu Nummern, die ein gelieferter Posten nennt. |
Alle Fenster beginnen einen Tag vor dem Wasserzeichen. Dieselbe Zeile zweimal ist harmlos — Bilendo aktualisiert.