Schnittstelle: Odoo ERP

Grundsätzliches

Die nextPIM-Software ermöglicht es, Katalogdaten an ein Odoo 18-System zu übertragen. Über die XML-RPC-API werden dabei Produkte, Kategorien und alle relevanten Zusatzinformationen automatisiert an Odoo gesendet.

Mit Hilfe der Odoo Schnittstelle können Sie mit einem Klick die in nextPIM verwalteten Daten an Odoo übertragen und sowohl in der Warenwirtschaft, als auch in einem Odoo-Shop nutzen. Es handelt sich dabei um eine Push-Übertragung. Das heißt, sie wird in nextPIM gestartet und sendet die aktuellen Daten zu Ihrem Odoo-Server. Ein Abrufen der Daten aus Odoo ist derzeit nicht möglich.

Voraussetzungen

Die Odoo-Schnittstelle wurde speziell für Odoo Version 18 entwickelt und getestet. Zur Einrichtung eines Odoo-Systems in nextPIM wird ein Odoo-Addon benötigt. Sollte dieses Addon nicht vorhanden sein, wenden Sie sich bitte an unseren Vertrieb.

Einrichtung/ Katalogeinstellungen

Nach der Installation des Addons erscheint in den Katalogeinstellungen ein neuer Reiter „Odoo“. Dort kann pro Katalog ein Zielsystem eingerichtet und konfiguriert werden. So ist es möglich, mehrere Odoo-Systeme anzusprechen wie zum Beispiel ein Test- und ein Echt-System.

Wählen Sie die Katalogebene (roter Pfeil) im gewünschten Katalog aus und gehen Sie in den Reiter Odoo:

1. Verbindungsdaten eingeben. Folgende Felder stehen zur Verfügung:
   
   Shop-URL: URL, unter der das Odoo-System erreichbar ist
   
   Benutzer: Name des Benutzers im Odoo-System (wichtig für Rechteverwaltung und Protokolle)
   
   API Key: Der API-Schlüssel des Benutzers (oft identisch mit dem Passwort)
   
   Datenbank: Name der zu verwendenden Odoo-Datenbank
2. Über den Button „Verbindung testen“ kann geprüft werden, ob die Angaben korrekt sind. Das System gibt eine Rückmeldung, ob die Verbindung erfolgreich hergestellt werden konnte.
3. Nach gelungenem Test laden Sie die Kategorie aus Odoo über den Button Kategorien Laden.
4. Wählen Sie die Kategorie aus, in welche die Produktdaten dieses Katalogs übertragen werden sollen.
5. Nun können Sie jederzeit den Katalog senden
   
   

Zusätzliche Einstellungen

Produktkategorie – Neue Produkte:

Hier stehen alle im Odoo-System vorhandenen Kategorien zur Auswahl. Neue Produkte, die aus nextPIM exportiert werden, werden automatisch dieser Kategorie zugewiesen. Die Kategorien werden beim Öffnen der SelectBox automatisch aus Odoo geladen und können bei Bedarf über den Button Kategorien laden nochmal neu geladen werden.

Marken E-Commerce Kategorie:

Auswahl einer Kategorie aus nextPIM. Die ausgewählte Kategorie und alle ihre Unterkategorien werden in Odoo als Marke gekennzeichnet. Zudem erhalten sie GPSR-Informationen aus dem ersten Produkt dieser Kategorie.

Export-Job

Aus den Katalogeinstellungen heraus kann ein Export gestartet werden. Dieser startet einen Job, in dem der Fortschritt und der aktuelle Status der Übertragung angezeigt werden.

Ist der Job wie im obigen Screenshot bereits abgeschlossen, wird entweder die Status-Meldung Finish ausgegeben, oder, sofern Fehler auftraten, ein Error angezeigt mit der Möglichkeit, eine Fehlerliste herunterzuladen:

Die in der Fehlerliste enthaltenen Artikel konnten nicht übertragen werden. Sind die verursachenden Datenprobleme anhand der Liste behoben worden, kann eine erneute Übertragung gestartet werden. 

In dem obigen Beispiel ist der eingetragene Barcode nicht eindeutig und muss bei einer Variante geändert werden.

Übertragene Daten

Folgende Datentypen werden von nextPIM an Odoo übertragen, dort erstellt oder aktualisiert: 

Eine detaillierte Excel-Tabelle mit Feldzuordnungen (Mappings), die beschreibt, welche Felder wohin übertragen werden, finden sie hier:

Feldzuordnungen

Kategorien (product.public.category)

• nextPIM-Kategorien werden in Odoo als E-Commerce-Kategorien angelegt bzw. aktualisiert.
• Der Abgleich erfolgt anhand von Name und Pfad.

• Kategorien, die als Marken-Kategorien gekennzeichnet sind, werden gemäß der Katalogeinstellung markiert.

• Odoo-Produktkategorien selbst werden von nextPIM nicht bearbeitet. Nur die in den Katalogeinstellungen hinterlegte „Neue Produkte“-Kategorie wird neuen Produkten zugewiesen.

Produkte (product.template)

• Produkte aus nextPIM werden in Odoo erstellt, aktualisiert oder – falls nötig – archiviert.
• Der Abgleich erfolgt über den Odoo-Barcode, der sich aus der EAN oder, falls diese leer ist, aus der SupplierPID bildet. Beispiel: Ein Odoo-Produkt mit Barcode xyz wird beim Export eines nextPIM-Produkts mit EAN xyz aktualisiert, unabhängig davon, ob das Produkt ursprünglich aus nextPIM stammt.
• Es werden standardmäßig nur geänderte Produkte und Kategorien seit der letzten Übertragung exportiert, um große Datenmengen zu vermeiden. Für einen vollständigen Export kann über das Makro „Als geändert markieren“ ein Gesamtexport angestoßen werden.
• Auslauflogik:
  Das Feld purchase_ok in Odoo wird durch den Auslaufstatus des Produktes in NextPIM befüllt.
  Wenn der IsDiscontinued Schalter in NextPIM aus ist, ist purchase_ok an.
  Wenn der IsDisconrinued Schalter in NextPIM an ist und das Discontinued Datum in der Zukunft liegt, ist purchase_ok an.
  Sonst ist purchase_ok in Odoo aus.
  Wichtig ist, dass der Discontinued Status immer nur bei einer Übertragung aktualisiert wird.
• Produkt Löschung:
  Produkte in Odoo werden von NextPIM nur bei der Migration von Varianten gelöscht.
  Wenn eine Variante von NextPIM erstellt wird und es bereits eine Variante in Odoo mit gleichem Barcode an einem anderem Master gibt, löscht NextPIM diese Variante und erstellt eine neuen. Wird ein Produkt, welches bereits von NextPIM and Odoo gesendet wurde, in NextPIM gelöscht, wird dieses bei der nächsten Übertragung an Odoo in Odoo archiviert (das feld active wird auf false gesetzt).

Varianten (product.product)

• In Odoo besteht jedes Produkt-Template aus einem oder mehreren Produkten (Varianten).
• In nextPIM können Produkte einzeln stehen oder als Master mit Varianten angelegt sein.
  o    Einzelprodukte → erzeugen in Odoo ein Template und ein Produkt.
  o    Master-Produkte → werden als Template exportiert, ihre Varianten als zugehörige Odoo-Produkte.
• Die Zuordnung zwischen Master und Varianten erfolgt in Odoo über Variantenmerkmale, die in nextPIM eindeutig gepflegt sein müssen.
• Der Export-Job weist im Fehlerprotokoll auf Probleme mit Variantenmerkmalen hin.

Lieferanten (product.supplierinfo) und Kontakte (res.partner)

• Lieferanteninformationen aus nextPIM werden an Odoo übertragen,sofern sie an einem Einzelprodukt oder einer Variante gepflegt sind.
• Es werden nur Lieferanten exportiert, die:
  o    einen Preis > 0,
  o    ein „Gültig ab“-Datum und
  o    ein leeres oder zukünftiges „Gültig bis“-Datum besitzen.
• Lieferantennamen werden in Odoo als Kontakte angelegt bzw. anhand ihres Namens abgeglichen und werden dann am Produkt Lieferanten verlinkt.
• Lieferanten aus NextPIM erhalten in Odoo einen pricetype "nextpim". Bei einem Update bestehender Produkte in NextPIM werden nur Lieferanteninformationen mit diesem pricetype gesetzt oder entfernt, andere werden von NextPIM nicht bearbeitet und bleiben bestehen.

Medien (product.image, product.document)

• Produkt- und Kategoriebilder werden an Odoo übertragen. Bei der ersten Übertragung kann dies länger dauern, da alle Bilder neu gesendet werden müssen.
• Produktbilder mit den Dateiendungen oder MIME-Typen jpeg, jpg, png, gif oder url werden in Odoo als Images gespeichert.
• Alle anderen Dateitypen werden als Dokumente hinterlegt.
• Dateien, die größer als 64 MB sind, werden als Links gespeichert.
• Für Kategorien wird das erste Bild (nach Sortierreihenfolge) übertragen und als Base64-String exportiert.

Mehrere Kataloge

Dadurch, dass die Übertragungseinstellung und die Zielkategorie am Katalog vorgenommen werden, sind Sie in der Strukturierung Ihrer Daten flexibel.

Dennoch empfehlen wir ein Gesamtsortiment als sogenannten Golden Record anzulegen, um die Datenpflege in nextPIM möglichst effizient zu gestalten.