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 und die Beschaffung eines IT-Fachhändlers mit der Handelsplattform SYNAXON EGIS verbindet. Ü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 ausgelesen, Preisänderungen dauerhaft historisiert, abgekündigte Artikel im Webshop gekennzeichnet und Verkaufspreise auf Wunsch regelbasiert aus der Einkaufsbasis gebildet. Im Verkaufsauftrag führt das Modul die Bezugsquelle je Position und verteilt die Positionen auf Distributoren — wahlweise über die EGIS-Optimierung oder über eigene Verfahren, die Frachtkosten, Frachtfreigrenzen und Mindestbestellwerte einbeziehen. Produktbeschreibungen können aus technischen Merkmalen und Herstellerangaben über ein in Odoo hinterlegtes Sprachmodell erzeugt werden; lizenzpflichtige Katalogtexte bleiben dabei ausgeschlossen. Sämtliche Schreibziele sind über eine Feldzuordnung und Regeln je Produktkategorie steuerbar.

Zweckbestimmung: Bestimmungsgemäße Verwendung ist die automatisierte Pflege von Einkaufs-, Verfügbarkeits- und Stammdaten des eigenen Artikelbestands sowie die Ermittlung von Bezugsquellen für eigene Verkaufsaufträge in einer Odoo-Installation, auf Grundlage eines vom Betreiber selbst lizenzierten SYNAXON-EGIS-Zugangs, konfiguriert durch autorisierte Einkaufs-Administratoren im gewerblichen Umfeld. An EGIS übermittelt werden ausschließlich Zugangsdaten, Artikel-Identifikatoren und Bestellmengen; personenbezogene Daten werden nicht übertragen. Der EGIS-Connector löst keine Bestellungen aus und verändert keine Verkaufspreise bestehender Aufträge.

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.
  • Bezugsquelle je Auftragsposition mit Fixier-Option, Verfügbarkeits-Badges und einer Zusammenfassung je Distributor; Fracht und Zuschläge werden wertanteilig in die Zeilenkosten umgelegt. Vier Optimierungsziele: die EGIS-Optimierung sowie drei lokale Verfahren (günstigste Gesamtkosten, schnellste Lieferung, nur sofort lieferbar), die Frachtfreigrenzen und Mindestbestellwerte berücksichtigen.
  • KI-Produktbeschreibungen aus technischen Merkmalen und Herstellerangaben — lizenzpflichtige Katalogtexte bleiben ausgeschlossen. Erzeugung nachgelagert über eine geplante Aktion in Paketen; vorhandene Texte werden nie überschrieben.

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​

  • Personenbezogene Daten verlassen Odoo nicht. An EGIS gehen Zugangsdaten, Artikel-Identifikatoren und — beim Warenkorb — Artikelmengen; keine Kundendaten.
  • Der Connector löst keine Bestellung aus. Er verteilt die Positionen eines Auftrags auf Distributoren und legt den Warenkorb an; das Auslösen und der Wareneingang bleiben bei Ihnen. Lieferscheine und Bestellstatus ruft er nicht ab.
  • Kosten (Bewertungspreis) werden nicht geändert — der Abgleich pflegt Lieferantenpreise, nicht die Lagerbewertung.
  • Eine Massenanlage von Artikeln aus EGIS gibt es nicht; der Katalog-Import erfolgt einzeln je Treffer.
  • Aus dem Datenblatt werden Gewicht, technische Merkmale und Beschreibungstexte ausgewertet. Bilder, Abmessungen und Zolltarifnummern sind vorbereitet, aber noch nicht angebunden.
  • Der Verkaufspreis wird standardmäßig nicht angefasst. Die Preisbildung ist ein Opt-in — global oder je Produktkategorie.
  • Abgekündigte Artikel und Dienstleistungen sind nicht warenkorbfähig und werden von der Beschaffungsoptimierung übersprungen.

Geplante Ausbaustufe​

  • 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​

Letztes Update am
Inhaltsverzeichnis