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 → → und klicken Sie . 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 stehen drei Kacheln im Kopf (angefragte Varianten, Treffer, Angebote) und vier Reiter zur Verfügung.
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 |
| 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 Reiter eine überschaubare Zahl von Artikeln über die Auswahl-Kästchen. Der Button im Kopf wechselt auf 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).
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 |
Weiter mit der Konfiguration — dort ist jede Einstellung im Detail beschrieben.