X-ERP Hilfe

06. Artikel und Partner synchronisieren

Synchronisieren Sie Stammdaten über stabile externe Schlüssel, klare Feldführerschaft und getrennte Regeln für Anlegen, Aktualisieren, Inaktivieren und Konflikt.

Stammdaten wirken harmlos, doch jede falsche Zusammenführung pflanzt sich in Belege, Lager, Preise und Auswertungen fort.

Die Schnittstelle als Produkt

Artikel und Partner besitzen viele fachliche Unterbereiche. Die Integration sollte nur freigegebene Felder führen, vorhandene Werte vor Updates prüfen und nicht automatisch löschen, nur weil ein Quellsatz fehlt.

So wird die Anbindung robust

  1. Definieren Sie externen Schlüssel und Suchweg wie GetByValue oder dokumentierte Filter.
  2. Legen Sie pro Feld die Führungsrichtung fest.
  3. Suchen Sie vor dem Anlegen exakt nach Schlüssel; behandeln Sie 0, 1 oder mehrere Treffer unterschiedlich.
  4. Übertragen Sie Pflicht- und Standardwerte bewusst.
  5. Aktualisieren Sie nur geänderte, freigegebene Felder und prüfen Sie Version/Konflikt.
  6. Behandeln Sie Deaktivierung und Löschung als eigenen fachlichen Prozess.

Produktionsreife nachweisen

  • Kein Retry erzeugt zweiten Partner oder Artikel.
  • Manuelle X-ERP-Werte werden nur nach Führungsregel überschrieben.
  • Referenzen auf inaktive Stammdaten bleiben verständlich.
  • Konflikte landen in einer bearbeitbaren Klärungsliste.

Fehler, die erst im Betrieb teuer werden

  • Unscharfe Namenssuche entscheidet automatisch.
  • Fehlender Quellsatz führt sofort zur Löschung.
  • Gesamtes Objekt wird geschrieben und überschreibt fremd geführte Felder.

Das nehmen Sie mit

Stammdaten bleiben über Systemgrenzen eindeutig und fachlich beherrscht.

Weiterführender Link / Quelle

Weiterführende Themen

  1. Für Integrationsspezialisten – APIs und externe Systeme anbinden › 04. Endpunkte, Datenverträge und Antworten
  2. Für Integrationsspezialisten – APIs und externe Systeme anbinden › 07. Belege und Lager kontrolliert anbinden
  3. Für Integrationsspezialisten – APIs und externe Systeme anbinden › 08. Schreiben, Idempotenz und Parallelität

Häufige Fragen

**Wie erkenne ich bestehende Datensätze?**

Über einen stabilen externen Schlüssel oder eine ausdrücklich definierte eindeutige X-ERP-Kennung – nicht über Ähnlichkeit.

**Soll die Integration löschen?**

Nur wenn Löschung fachlich und technisch ausdrücklich freigegeben ist. Häufig ist ein kontrolliertes Inaktivieren sicherer.