Schnittstellen

Warum ERP-Anbindungen nie so einfach sind, wie die Dokumentation suggeriert

SAP, Dynamics 365, Navision und proAlpha haben gewachsene Datenmodelle mit vielen Jahren Historie.

Was in der API-Dokumentation einfach aussieht, hat in der Praxis Nuancen: Mandanten, Buchungskreise, Nummernkreise, belegartspezifische Logik. Wer zum ersten Mal eine ERP-Anbindung baut, unterschaetzt sie fast immer.

Stammdaten synchronisieren

Kunden, Lieferanten, Artikel und Preislisten werden klassischerweise aus dem ERP in andere Systeme synchronisiert. Die Herausforderungen dabei: Primaerschluessel-Mapping zwischen ERP-Nummern und System-IDs, Aenderungserkennung fuer die Frage, was sich seit wann geaendert hat, und eine klare Strategie fuer bidirektionale Synchronisation im Konfliktfall.

Belege als eigene Komplexitaetsebene

Bestellungen, Rechnungen und Lieferscheine bringen Positionsdaten, Steuerlogik, Lagerorte und Kostenstellen mit, jeder Belegtyp mit eigenen Fehlercodes und Buchungsregeln. Ein fehlerhaft uebertragener Beleg kann im schlimmsten Fall eine ganze Buchungskette durcheinanderbringen.

Typische Fehlerbilder

Fehlende Zuordnung bei Stammdaten, etwa wenn ein Artikel im ERP zum Zeitpunkt der Bestellung noch nicht existiert, Timeouts bei grossen Batch-Transfers, Aenderungen im ERP-Datenmodell durch Updates, die die Schnittstelle brechen, sowie Zeichenkodierungsprobleme bei Sonderzeichen.

Checkliste: Datenmodell beider Systeme vollstaendig verstanden, Mapping-Konzept fuer alle Felder dokumentiert, Fehlerbehandlung und Retry fuer fehlgeschlagene Transfers, Monitoring fuer Sync-Status und Fehlerquote, Test mit produktionsnahen Daten, Rollback-Strategie fuer fehlerhafte Importe.

Ein Beispiel aus der Praxis

Bei der ersten Anbindung eines ERP-Systems wurde angenommen, jede Artikelnummer sei im gesamten System eindeutig. Tatsaechlich stellte sich heraus, dass dieselbe Nummer in verschiedenen Buchungskreisen fuer unterschiedliche Artikel stehen konnte, eine Altlast aus der langen Historie des Systems. Diese Erkenntnis kam erst nach mehreren fehlerhaften Bestellungen im Testbetrieb ans Licht. Die Anpassung des Mappings auf eine Kombination aus Artikelnummer und Buchungskreis loeste das Problem, zeigte aber deutlich, wie wichtig es ist, Annahmen ueber gewachsene Systeme fruehzeitig zu hinterfragen.

ERP-Schnittstelle planen oder debuggen? markom.digital hat Erfahrung mit ERP-Integrationen und hilft bei Design, Implementierung und Troubleshooting.

Weitere Beiträge