Architektur & Datenfluss
Vier Zonen, eine Steuerungsebene: SAP-System, BTP, AWS-Datenhandler, Bilendo — beschrieben im IMS.
Die vier Zonen
| Zone | Was dort steht | Aufgabe |
|---|---|---|
| SAP S/4HANA Utilities | FI-CA, Geschäftspartner, Vertragskonto, Abschlagspläne | Quelle. Wird nur gelesen. |
| SAP BTP | API-Management-Proxy je OData-Service, Destination + Cloud Connector | Die eine Tür ins Kundensystem. Der Tunnel des Cloud Connectors endet in BTP; die Fassade macht ihn von außen aufrufbar (OAuth 2.0 Client Credentials). |
| AWS · Datenhandler je Kundenprojekt | EventBridge-Zeitplan, Step Functions, Lambda (Collector, Transform, Deliver, Report), S3 Rohdaten, DynamoDB-Wasserzeichen, Secrets Manager | Liest seitenweise, transformiert nach dem Mapping aus dem IMS, liefert Delta-Batches, meldet jeden Lauf. |
| Bilendo | Loader (API-POST oder SFTP), Debitoren, Journal Entries, Mahnläufe je Mahnbereich | Ziel. Aktualisiert bekannte Posten, mahnt und klärt. |
Die Steuerungsebene
Das Bilendo-IMS beschreibt den Datenhandler (Soll-Zustand, Zeitplan, Buchungskreise, Objekte, Secret-Namen) und sieht seine Läufe; es betreibt ihn nicht. Eine Pipeline liest den Soll-Zustand und legt den Stack an; der Sammler liest zur Laufzeit das Feld-Mapping aus dem IMS und meldet jeden Lauf mit Zählern (gelesen, gespeichert, abgewiesen) zurück. Secrets stehen im IMS nur als Namen im Secret Store des Kunden.
Ein Lauf
Soll-Zustand und Wasserzeichen lesen, Lauf-Id vergeben.
Je Objekt in fester Reihenfolge — Debitoren vor Posten — mit Delta-Filter seitenweise lesen; Rohdaten unverändert nach S3.
Nach dem Mapping der Variante in die Spalten der Bilendo-Header-Vorlage transformieren; Clearing- und Abschlagsregeln anwenden; Batches zu je maximal 5 000 Zeilen.
Debitoren-Batches, dann Journal-Batches liefern; jeder Teil trägt einen Idempotenzschlüssel.
Manifest ans IMS melden; Wasserzeichen nur bei bestätigter Lieferung auf den Startzeitpunkt des Laufs vorrücken.
Ein fehlgeschlagener Lauf lässt die Wasserzeichen stehen. Der nächste Lauf liefert dasselbe Fenster erneut — Bilendo aktualisiert, es entsteht kein Duplikat.
Taktung
Ein- bis dreimal täglich. Der letzte Lauf des Tages liegt vor dem Bilendo-Mahnlauf, damit eine am Vormittag in SAP gebuchte Zahlung nicht am Nachmittag gemahnt wird.