Zum Hauptinhalt springen

Dokumentation

Vom Grundbegriff bis zur letzten Preisregel — der Distributionsmarkt in Odoo, verständlich erklärt.

Produktbeschreibung​

Der EGIS-Connector ist eine Erweiterung für Odoo, die den Artikelstamm eines IT-Fachhändlers automatisiert mit der Handelsplattform SYNAXON EGIS abgleicht. Über den EGIS Business Connector ruft das Modul je Artikel die Angebote aller gelisteten Distributoren ab — Einkaufspreis, verfügbare Menge, Verfügbarkeitsstatus, Liefertermin, Frachtkosten, Lieferzeit, Distributor-Artikelnummer, unverbindliche Preisempfehlung und Abkündigungskennzeichen — und schreibt sie in die Lieferantenpreisliste des jeweiligen Artikels. Ergänzend werden technische Datenblattangaben (Gewicht, Beschreibungstext) ausgelesen, Preisänderungen dauerhaft historisiert, abgekündigte Artikel im Webshop gekennzeichnet und Verkaufspreise auf Wunsch regelbasiert aus der Einkaufsbasis gebildet. Sämtliche Schreibziele sind über eine Feldzuordnung und Regeln je Produktkategorie steuerbar; die Datenrichtung ist ausschließlich EGIS → Odoo.

Zweckbestimmung: Bestimmungsgemäße Verwendung ist die automatisierte Pflege von Einkaufs-, Verfügbarkeits- und Stammdaten des eigenen Artikelbestands in einer Odoo-Installation auf Grundlage eines vom Betreiber selbst lizenzierten SYNAXON-EGIS-Zugangs, konfiguriert durch autorisierte Einkaufs-Administratoren im gewerblichen Umfeld. In dieser Version arbeitet der EGIS-Connector ausschließlich lesend gegenüber EGIS; es werden weder Bestellungen ausgelöst noch personenbezogene Daten übermittelt.

Produkt-, Hersteller- und Sicherheitsinformationen sowie Angaben zur jeweiligen Modulversion finden Sie in den Release Notes.

Technische Eigenschaften​

  • Anbindung über den EGIS Business Connector (EBC): XML-Abfragen an den SYNAXON-Endpunkt mit Zugangsdaten aus der Odoo-Konfiguration. Genutzt werden die Preis- und Verfügbarkeitsabfrage (bis zu zehn Artikel je Aufruf, optional mit Live-Rückfrage beim Distributor), die Datenblattabfrage, die Distributorenliste, die Katalogsuche sowie der Abruf von EGIS-Bestellungen und -Angeboten.
  • Artikel-Auflösung in drei Stufen: PCS-Nummer → EAN → Hersteller-Artikelnummer mit unscharfem Herstellerabgleich. Gefundene Schlüssel werden am Artikel gespeichert, sodass Folgeläufe den direkten Weg nehmen.
  • Lieferantenpreisliste je Variante: Einkaufspreis, Bestand, Verfügbarkeitsstatus, Liefertermin, Frachtkosten, Lieferzeit in Stunden, Distributor-Artikelnummer und Zeitpunkt des letzten Abgleichs — als eigene, vom Abgleich verwaltete Zeilen hinter Ihren manuell gepflegten.
  • Preisbildung aus einer Einkaufsbasis nach Match-First-Kaskade (lieferbar → im Zulauf → übrige) mit drei Modi (Cost-Plus, Preiskorridor, Totband), zwei Zielpreis-Formeln (EK + Aufschlag, UVP − Rabatt), Mindestmargen-Floor, optionalem UVP-Deckel, optionaler Frachteinrechnung und kombinierbarer psychologischer Rundung.
  • Preislistenregel-Wächter: prüft bei jeder Verkaufspreisänderung sämtliche Preislisten über Odoos eigene Preisberechnung — je anwendbarer Regel und Mengenstaffel — und erzeugt bei Unterschreitung der Mindestmarge eine Aktivität am Artikel.
  • Preis-Historie als eigenes Datenmodell: eine Zeile je Änderung mit Typ (Einkauf, UVP, Verkauf), Lieferant, altem und neuem Wert, prozentualer Abweichung und Verweis auf den Lauf.
  • Feldzuordnungen je EGIS-Attribut, getrennt nach Artikeln ohne und mit Varianten, sowie eigene Zuordnungen für Distributor-Stammdaten auf Kontaktfelder.
  • Regeln je Produktkategorie (inklusive Unterkategorien, die spezifischste gewinnt) übersteuern sämtliche globalen Modi.
  • Lauf-Protokolle mit Zählern, Volltext-Protokoll, verknüpften Preisänderungen und Chatter — für jeden Lauf, gleich welcher Auslöser.
  • Zwei Datenquellen: der EGIS Business Connector für den Live-Betrieb und ein CSV-Import als Rückfallebene; beide füttern dieselbe Verarbeitungslogik.

Voraussetzungen​

Odoo​

  • Odoo 19.0 mit installierten Anwendungen
    • Ja Einkauf (purchase)
    • Ja Website-Verkauf (website_sale)
    • Ja Dialog (mail) — für Chatter und Aktivitäten

SYNAXON EGIS​

  • Eine SYNAXON-Mitgliedschaft mit gebuchtem DataPack und EGIS Business Connector
  • Zugangsdaten des EBC-Zugangs: Basis-URL, Benutzername, Passwort

Netzwerk​

  • Erreichbarkeit der folgenden Hosts vom Odoo-Server aus
    • Endpunkt des EGIS Business Connectors (HTTPS, 443/TCP)
      für alle Abfragen; die Basis-URL erhalten Sie von SYNAXON
    • optional
      <Hosts Ihrer Distributoren>
      nur mittelbar relevant: Die Live-Rückfrage beim Distributor läuft über EGIS, nicht über Ihren Server

Artikelstamm​

  • Artikel mit mindestens einem der drei Schlüssel: PCS-Nummer, EAN (barcode) oder Hersteller-Artikelnummer in Verbindung mit einem Hersteller
  • Artikel ohne jeden Schlüssel — typischerweise Eigenprodukte und Dienstleistungen — bleiben bewusst außen vor

Einschränkungen der aktuellen Version​

  • Die Datenrichtung ist derzeit ausschließlich EGIS → Odoo. Übertragen werden nur Ihre Zugangsdaten und Artikel-Identifikatoren, keine Kundendaten.
  • Der Connector löst noch keine Bestellungen aus, legt keine Warenkörbe an und ruft keine Lieferscheine ab. Die Reiter Bestellungen und Angebote auf der Abgleich-Seite sind reine Ansichten.
  • Kosten (Bewertungspreis) werden nicht geändert — der Abgleich pflegt Lieferantenpreise, nicht die Lagerbewertung.
  • Eine Massenanlage von Artikeln aus EGIS gibt es noch nicht; der Katalog-Import erfolgt einzeln je Treffer.
  • Aus dem Datenblatt werden aktuell Gewicht und Beschreibungstext ausgewertet. Bilder, Abmessungen und weitere technische Daten sind vorbereitet, aber noch nicht angebunden.
  • Der Verkaufspreis wird standardmäßig nicht angefasst. Die Preisbildung ist ein Opt-in — global oder je Produktkategorie.

Geplante Ausbaustufen​

  • Warenkorb in EGIS. Aus Odoo heraus einen EGIS-Warenkorb anlegen und bestücken — der direkte Weg von der Preisrecherche zur Bestellung.
  • Kundensynchronisation. Voraussetzung für Direktlieferungen vom Distributor an Ihren Kunden: Für die Lieferadresse muss der Kunde auf der EGIS-Seite bekannt sein. Der zugehörige Schalter in den Einstellungen ist bereits angelegt, aber noch ohne Funktion.

Inhalt​

Inhaltsverzeichnis