Installation & Ersteinrichtung
Diese Seite führt Sie einmal komplett durch: Voraussetzungen prüfen, Modul installieren, Verbindung herstellen, Distributoren zuordnen, Feldzuordnungen setzen, Probelauf, scharfschalten. Nehmen Sie sich die Schritte der Reihe nach vor — jeder baut auf dem vorherigen auf.
Voraussetzungen
Der EGIS-Zugang
EGIS ist eine Plattform der SYNAXON AG. Um sie technisch anzusprechen, brauchen Sie über die Mitgliedschaft hinaus zwei gebuchte Bausteine:
| Baustein | Wozu |
|---|---|
| DataPack | Zugriff auf die Artikel- und Preisdaten der angeschlossenen Distributoren |
| EGIS Business Connector (EBC) | Die maschinelle Schnittstelle — ohne sie gibt es keinen automatisierten Abruf |
Von SYNAXON erhalten Sie daraufhin drei Angaben, die Sie gleich brauchen: die Basis-URL des Connectors, einen Benutzernamen und ein Passwort.
Ein reiner EGIS-Portal-Zugang ohne gebuchten Business Connector reicht für den automatischen Abgleich nicht aus. Für diesen Fall gibt es als Rückfallebene den CSV-Import — er nutzt dieselbe Verarbeitungslogik, verlangt die Daten aber als Datei.
Die Odoo-Seite
- Odoo 19.0
- Installierte Anwendungen: Einkauf, Website-Verkauf, Dialog
- Ein Benutzerkonto mit der Rolle Einkauf: Administrator — Konfiguration, Läufe und Import sind dieser Rolle vorbehalten
- Erreichbarkeit des EBC-Endpunkts vom Odoo-Server aus (HTTPS, 443/TCP)
Der Artikelstamm
Prüfen Sie vorab, wie viele Ihrer Artikel überhaupt einen Schlüssel haben. Eine EAN im Feld Barcode ist der Normalfall; für Softwarelizenzen genügen Hersteller und Hersteller-Artikelnummer. Artikel ohne beides — Eigenprodukte, Dienstleistungen, Konfigurationen — bleiben außen vor und brauchen keine Vorbereitung.
Schritt für Schritt
1. Modul installieren
Installieren Sie das Modul EGIS-Connector über die Odoo-Apps. Es bringt vier neue Datenmodelle, ein neues Menü, mehrere Felderweiterungen und eine geplante Aktion mit; bestehende Ansichten werden nur ergänzt, nie ersetzt.
Nach der Installation finden Sie unter ein neues Menü mit sechs Einträgen: Abgleich, Sync-Läufe, Preis-Historie, Distributoren, Kategorie-Regeln und CSV-Import.
2. Verbindung eintragen
Öffnen Sie → → und suchen Sie den Abschnitt EGIS-Artikelsync. In der Karte EGIS-Verbindung:
- Stellen Sie das Backend auf EGIS Business Connector um.
- Tragen Sie die Basis-URL ein — es genügt die reine Basis, den technischen Pfad ergänzt der Connector selbst.
- Tragen Sie Benutzername und Passwort ein.
Denselben Einstellungsblock finden Sie auch unter → → . Es sind zwei Ansichten auf eine Konfiguration — Sie können also arbeiten, wo Sie gerade sind. Alle Felder im Detail: Einstellungen.
3. Nächtlichen Abgleich vorerst aus lassen
Lassen Sie den Schalter Nächtlicher Abgleich zunächst aus. Sie schalten ihn in Schritt 12 ein, wenn alles steht. Bis dahin arbeiten Sie kontrolliert über die Abgleich-Seite.
4. Erster Abruf zur Kontrolle
Öffnen Sie → → . Die Seite ist sofort bedienbar; die Lieferantenliste lädt im Hintergrund automatisch.
Klicken Sie im Unterreiter Angelegte Artikel auf . Ein Fortschrittsbalken zeigt, wie weit der Abruf ist.
Wichtig: Dieser Vorgang lädt nur — er pflegt weder Preise noch Felder und erzeugt keinen Lauf-Datensatz. Danach zeigen die drei Kacheln im Kopf angefragte Varianten, Treffer und Angebote.
Prüfen Sie an dieser Stelle nur zweierlei:
- Kommen überhaupt Daten an? Wenn nicht, stimmt die Verbindung nicht.
- Wie hoch ist die Trefferquote? Ein Teil „nicht gefunden" ist normal — betroffen sind typischerweise Eigenprodukte, Lizenzen und Zubehör ohne EGIS-Listung.
Alles zur Bedienung dieser Seite: Die Abgleich-Seite.
5. Distributoren zuordnen
Wechseln Sie auf den Reiter . Dort steht jeder bei EGIS gelistete Distributor mit seiner Kennung, Ihrer Kundennummer, seinen Fähigkeiten und einem Mapping-Status.
Ordnen Sie zumindest die Distributoren zu, mit denen Sie tatsächlich arbeiten — solange ein Distributor keinem Odoo-Lieferanten zugeordnet ist, landen seine Angebote nirgends. Drei Wege:
- Auto-Zuordnung konfigurieren (empfohlen bei vielen Distributoren): In den Einstellungen ein EGIS-Feld und ein Kontaktfeld gegeneinander stellen; zugeordnet wird nur bei genau einem Treffer.
- Zeilen markieren und synchronisieren: Markierte Distributoren ohne Zuordnung legt der Connector als Lieferanten-Kontakt an und befüllt ihn gemäß Lieferanten-Feldzuordnung.
- Von Hand zuordnen: In der Spalte Odoo-Lieferant je Zeile den passenden Kontakt wählen.
Ausführlich: Distributoren & Lieferanten.
6. Feldzuordnungen setzen
Klicken Sie im Kopf der Abgleich-Seite auf . Hier entscheiden Sie, welches EGIS-Attribut in welches Odoo-Feld geschrieben wird — leer heißt: gar nicht.
Für den Anfang genügt eine schmale Auswahl. Bewährt hat sich:
| EGIS-Feld | Empfehlung für den Start |
|---|---|
| PCS-Nummer | zuordnen, wenn Sie ein freies Referenzfeld haben — beschleunigt alle Folgeläufe |
| Hersteller / Hersteller-ArtNr. | zuordnen, wenn Sie diese Felder pflegen |
| UVP | auf Mit Preis vergleichen zuordnen, wenn Sie im Shop mit Streichpreisen arbeiten |
| Gewicht | zuordnen — die Versandkostenberechnung dankt es |
| Beschreibung (Datenblatt) | zuordnen, wenn Ihre Artikel noch keine Shop-Texte haben |
| Eigener VK | zunächst leer lassen |
| EOL-Kennzeichnung | ein Shop-Band wählen, etwa Restposten |
Ausführlich: Feldzuordnungen.
7. Einen einzelnen Artikel testen
Suchen Sie sich einen unkritischen Artikel und klicken Sie in seinem Formular unter auf . Sie bekommen eine Tabelle Datensatz · Attribut · Alt · Neu — inklusive der Lieferantenzeilen, die neu entstehen würden.
Prüfen Sie diese Liste gründlich. Sie ist die ehrlichste Kontrolle, die es gibt: Sie entsteht aus einem echten, anschließend zurückgerollten Lauf und kann deshalb nichts anderes anzeigen, als die Übernahme schreiben würde.
Stimmt alles: . Stimmt etwas nicht: zurück zu Schritt 6.
8. Preistoleranz und Gewichts-Modus festlegen
Zurück in die Einstellungen, Karte Preispflege & Feldschutz:
- Preistoleranz: Ab welcher Abweichung in Euro soll ein Einkaufspreis überhaupt aktualisiert
werden?
0übernimmt jede Änderung. Ein kleiner Betrag unterdrückt Cent-Rauschen und hält die Preis-Historie lesbar. - Gewicht: Nur leere Felder füllen ist der sichere Standard.
9. Eine Teilmenge übernehmen
Zurück auf die Abgleich-Seite. Markieren Sie im Unterreiter Angelegte Artikel eine überschaubare Zahl von Artikeln über die Auswahl-Kästchen. Im Kopf erscheint und verarbeitet ausschließlich diese Zeilen.
Sehen Sie sich anschließend das Ergebnis an: Der Reiter der betroffenen Artikel sollte jetzt EGIS-Zeilen mit Bestand und Verfügbarkeit zeigen.
10. Lauf-Protokoll lesen
→ → . Öffnen Sie den eben erzeugten Lauf und lesen Sie den Reiter Protokoll. Hier stehen alle Hinweise, die während des Laufs aufgelaufen sind — nicht zugeordnete Distributoren, uneindeutige Hersteller, widersprüchliche Gewichte, übersprungene Verkaufspreise.
Arbeiten Sie diese Hinweise ab, bevor Sie weitermachen. Danach ist der Zeitpunkt, an dem sich entscheidet, ob der Regelbetrieb ruhig läuft.
11. Optional: Preisbildung einrichten
Wenn Ihre Verkaufspreise künftig automatisch mitlaufen sollen, ist jetzt der Moment. Nehmen Sie sich dafür das eigene Kapitel Preisbildung vor — es lohnt sich, die Modi zu verstehen, bevor Sie den Schalter umlegen.
Ist die Preisbildung aktiv, bewegen sich Shop- und Listenpreise der betroffenen Kategorien mit dem Einkaufsmarkt — in beide Richtungen. Preislisten-Regeln wie Partnerrabatte rechnen dann auf einer beweglichen Basis. Entscheiden Sie das bewusst und am besten zuerst für eine einzelne Produktkategorie. Jede Änderung steht in der Preis-Historie, und der Preislistenwächter meldet Ihnen, wenn eine Regel unter die Mindestmarge rutscht.
12. Nächtlichen Abgleich einschalten
Zurück in die Einstellungen, Karte Nächtlicher Abgleich — Schalter an. Ab jetzt läuft der Abgleich täglich in der Nacht über alle Artikel im Geltungsbereich.
Zeitpunkt und Intervall ändern Sie bei Bedarf unter → → beim Eintrag EGIS-Artikelsync (nächtlich).
13. Optional: KI-Produktbeschreibungen einrichten
Fehlen Ihren Artikeln Shop-Texte, lassen Sie sie erzeugen. Voraussetzung ist die Odoo-App KI mit angebundenem Modell. Danach in den Einstellungen die Karte KI-Produktbeschreibungen einschalten und in den Feldzuordnungen das Zielfeld setzen.
Ausführlich: KI-Produktbeschreibungen.
14. Optional: Konditionen für die Beschaffung pflegen
Wenn Sie Aufträge über die Beschaffungsoptimierung verteilen wollen, lohnt ein Blick auf → → : Frachtkosten, Frachtfreigrenzen und Mindestbestellwerte je Distributor machen die Optimierung deutlich treffsicherer. EGIS-Connector lernt diese Werte auch selbst, aber gepflegt sind sie von Anfang an wirksam.
15. Optional: Hochleistungs-Optimierer aktivieren
Verteilen Sie große Aufträge auf viele Distributoren, lohnt sich das Python-Paket ortools von Google in Ihrer Odoo-Umgebung. Damit findet die Beschaffungsoptimierung auch bei 40 und mehr Positionen die nachweislich günstigste Verteilung, und zwar in Sekundenbruchteilen. EGIS-Connector erkennt das Paket beim Start von selbst.
docker compose exec -u root odoo pip3 install --break-system-packages --ignore-installed typing_extensions
docker compose exec -u root odoo pip3 install --break-system-packages ortools
docker compose restart odoo
Ohne das Paket rechnet EGIS-Connector weiter — kleine und mittlere Aufträge ebenfalls bewiesen optimal. Damit die Installation einen Neuaufbau des Containers übersteht, gehören die beiden Zeilen in Ihr Odoo-Image.
Abschluss-Checkliste
| Schritt | Erledigt, wenn … |
|---|---|
| Modul installiert | Das Menü → existiert |
| Verbindung | liefert Treffer statt einer Fehlermeldung |
| Distributoren | Ihre Hauptlieferanten stehen im Reiter Lieferanten auf zugeordnet |
| Feldzuordnungen | Jedes gewünschte Attribut hat ein Zielfeld; alles Übrige ist leer |
| Einzeltest | Die Vorschau am Artikel zeigt nur Änderungen, die Sie erwartet haben |
| Teilübernahme | Der Reiter Einkauf betroffener Artikel zeigt EGIS-Zeilen mit Verfügbarkeit |
| Protokoll | Der letzte Lauf steht auf Fertig, alle Hinweise sind abgearbeitet |
| Preisbildung | Bewusst entschieden — eingeschaltet oder bewusst aus |
| Nachtlauf | Der Schalter steht auf an |
| KI-Beschreibungen | Bewusst entschieden; bei Nutzung ist ein Zielfeld gesetzt |
| Optimierer | Bei großen Aufträgen: ortools installiert und im Image hinterlegt |
Weiter mit der Konfiguration — dort ist jede Einstellung im Detail beschrieben.