Datentransport

SFTP-Konfiguration, Dateinamenskonventionen und Monitoring-Hinweise.

Übersicht

Der Datentransport ist das Bindeglied zwischen SAP und Bilendo. Dateien werden in beide Richtungen übertragen:

Richtung	Quelle	Ziel	Protokoll	Inhalt
Export	SAP Applikationsserver	Bilendo SFTP	SFTP (Push)	Stammdaten, Offene/Ausgeglichene Posten
Import	Bilendo SFTP	SAP Applikationsserver	SFTP (Pull)	Kreditlimits, Mahnstufe, Rating etc.

1. SFTP-Zugangsdaten

Bilendo stellt je Umgebung (Staging/Produktion) einen SFTP-Zugang bereit:

Parameter	Beschreibung	Beispiel
Host	SFTP-Server	`sftp.bilendo.de`
Port	SFTP-Port	`22`
Username	Kundenspezifischer Benutzer	`customer_xyz`
Authentifizierung	SSH-Key (empfohlen) oder Passwort	RSA 4096-bit
Eingangsverzeichnis	Pfad für Export-Dateien	`/inbound/`
Ausgangsverzeichnis	Pfad für Rückschreibe-Dateien	`/outbound/`

Die genauen Zugangsdaten werden im Bilendo-Onboarding bereitgestellt. Für Testzwecke gibt es eine Staging-Umgebung.

2. Verzeichnisstruktur

SAP-Applikationsserver

Verzeichnis	Richtung	Beschreibung
`/usr/sap/<SID>/Bilendo_OUT/`	Export	Extractor-Report schreibt TXT-Dateien hierher
`/usr/sap/<SID>/COMM/Bilendo_IN/`	Import	Middleware legt Rückschreibe-CSVs hier ab

Hinweis: Die Pfade im D01-Include des Extractor-Reports und im Import-Report müssen exakt auf diese Verzeichnisse zeigen. Verzeichnisse müssen von SAP-Basis mit korrekten Berechtigungen (Lesen/Schreiben für den SAP-Systembenutzer) angelegt werden.

Bilendo SFTP

/
├── inbound/              ← SAP legt Dateien hier ab
│   ├── CC_Customers_...txt
│   ├── CC_open_...txt
│   └── CC_cleared_...txt
└── outbound/             ← Bilendo legt Rückschreibe-Dateien hier ab
    ├── bilendo_credit_limits
    ├── bilendo_credit_informations
    ├── bilendo_securities
    ├── bilendo_customers
    └── bilendo_journal_entries

3. Dateinamen-Konventionen

Export (SAP → Bilendo)

Der Extractor-Report generiert Dateinamen automatisch:

CC_<Typ>_<TT-MM-JJJJ>_[INITIAL_]V2.txt

Datei	Typ	Beispiel
Kundenstamm	Customers	`CC_Customers_09-04-2026_V2.txt`
Offene Posten	open	`CC_open_09-04-2026_V2.txt`
Ausgeglichene Posten	cleared	`CC_cleared_09-04-2026_V2.txt`
Alle Posten (Initial)	all	`CC_all_09-04-2026_INITIAL_V2.txt`

Je Buchungskreis wird eine separate Datei pro Typ erzeugt.

Import (Bilendo → SAP)

Bilendo verwendet feste Dateinamen (ohne Datum):

Dateiname	Inhalt
`bilendo_credit_informations`	Bonitätsinformationen (Rating, Datum)
`bilendo_credit_limits`	Kreditlimits + Risikokategorie
`bilendo_securities`	Versicherungsobligo
`bilendo_customers`	Kundenstammänderungen
`bilendo_journal_entries`	Belegänderungen

4. Middleware-Konfiguration

Option A: SAP CPI (Cloud Platform Integration)

Typisch für S/4HANA Cloud und BTP-Umgebungen.

iFlow-Konfiguration:

Timer-basierter Trigger (z. B. 04:00 Uhr, nach dem SAP-Export-Job)
SFTP-Adapter (Sender): Dateien aus SAP-Applikationsserver lesen
- Verzeichnis: /usr/sap/<SID>/Bilendo_OUT/
- Dateifilter: CC_*.txt
- After Processing: Move to Archive / Delete
SFTP-Adapter (Receiver): Dateien auf Bilendo-SFTP ablegen
- Host: sftp.bilendo.de
- Verzeichnis: /inbound/
Rückkanalfluss: Analog in umgekehrter Richtung
- Source: Bilendo SFTP /outbound/
- Target: SAP /usr/sap/<SID>/COMM/Bilendo_IN/

Option B: Seeburger BIS

On-Premise EDI/EAI-Plattform.

Mapping entfällt (Dateien werden 1:1 durchgereicht)
Partner-Profil für Bilendo SFTP anlegen
Scheduler: Nach SAP-Export-Job, z. B. 04:00
Archivierung der übertragenen Dateien konfigurieren

Option C: CLI / Cron-basierter SFTP

Minimalvariante ohne Middleware-Plattform. Geeignet für einfache Szenarien.

#!/bin/bash
# bilendo_upload.sh – Täglicher Upload der Extractor-Dateien

SFTP_HOST="sftp.bilendo.de"
SFTP_USER="customer_xyz"
SFTP_KEY="/path/to/bilendo_rsa"
LOCAL_DIR="/usr/sap/P01/Bilendo_OUT"
REMOTE_DIR="/inbound"
ARCHIVE_DIR="/usr/sap/P01/Bilendo_OUT/archive"

# Upload aller neuen Dateien
sftp -i $SFTP_KEY -b - $SFTP_USER@$SFTP_HOST <<EOF
cd $REMOTE_DIR
lcd $LOCAL_DIR
put CC_*.txt
EOF

# Archivierung
mv $LOCAL_DIR/CC_*.txt $ARCHIVE_DIR/ 2>/dev/null

# Rückkanaldownload
sftp -i $SFTP_KEY -b - $SFTP_USER@$SFTP_HOST <<EOF
cd /outbound
lcd /usr/sap/P01/COMM/Bilendo_IN
get bilendo_*
EOF

Dieses Script kann per cron zeitgesteuert aufgerufen werden:

# crontab -e
0 4 * * * /path/to/bilendo_upload.sh >> /var/log/bilendo_transfer.log 2>&1

5. Dateiformat-Anforderungen

Eigenschaft	Wert
Format	TXT oder CSV
Struktur	Flat file – 1 Zeile = 1 Datensatz
Trennzeichen	`\|` (Pipe) oder `;` oder `,` – konsistent innerhalb einer Datei
Zeichenkodierung	UTF-8
Header	Erste Zeile = Feldnamen
Escaping	Trennzeichen in Feldwerten müssen escaped werden

6. Monitoring & Fehlerbehandlung

Was überwacht werden sollte

Prüfpunkt	Methode	Frequenz
SAP-Job erfolgreich	SM37 → Jobstatus	Täglich
Dateien auf Applikationsserver	AL11 → Verzeichnis prüfen	Bei Fehler
SFTP-Transfer erfolgreich	Middleware-Log / Cron-Log	Täglich
Bilendo-Import erfolgreich	Bilendo-Plattform → Importlog	Täglich

Typische Fehlerszenarien

Fehler	Ursache	Lösung
Job abgebrochen	Timeout, Speicher, Lock	SM37 → Joblog analysieren
Keine Dateien auf Server	Pfadkonfiguration falsch	AL11 prüfen, D01-Include kontrollieren
SFTP-Verbindung fehlgeschlagen	Key abgelaufen, Port blockiert	SSH-Key erneuern, Firewall prüfen
Bilendo meldet leeren Import	Dateiformat-Fehler (Encoding, Trennzeichen)	Datei manuell inspizieren, UTF-8 prüfen
Duplikate in Bilendo	Variante-Overlap zu groß oder Job doppelt gelaufen	Variante prüfen, SM37 → doppelte Jobs?

Alerting

Die Assist-Klasse enthält eine send_email-Methode die bei Rückschreibe-Fehlern automatisch eine E-Mail versendet. Für den Export-Pfad empfiehlt sich zusätzlich:

CCMS-Monitoring (RZ20): Job-Status und Dateigröße
Solution Manager: Alert für fehlgeschlagene Bilendo-Jobs

7. Timing-Abstimmung

Die Startzeiten der verschiedenen Komponenten müssen aufeinander abgestimmt sein:

gantt
    title Bilendo Integration – Tagesablauf
    dateFormat HH:mm
    axisFormat %H:%M
    section SAP
        Extractor-Job           :a1, 03:00, 30min
    section Middleware
        SFTP Upload             :a2, after a1, 15min
    section Bilendo
        Daten-Import            :a3, after a2, 45min
        Verarbeitung            :a4, after a3, 60min
        Rückschreibe-Export     :a5, after a4, 15min
    section Middleware
        SFTP Download           :a6, after a5, 15min
    section SAP
        Import-Job              :a7, after a6, 30min

Die konkreten Zeiten sind mit dem Bilendo-Onboarding-Team abzustimmen. Das oben gezeigte Schema ist exemplarisch.