Dieses System stellt eine vollständige bidirektionale Synchronisation zwischen Odoo ERP und mehreren Marktplätzen (eBay, Amazon, Shopify usw.) über AdlerDo her. Produkte fließen von Odoo zu den Marktplätzen, Bestandsaktualisierungen werden synchronisiert und Bestellungen fließen automatisch zurück nach Odoo.

Systemarchitektur

Odoo ERP (Master-Datenquelle) → AdlerDo (Integrations-Hub) → Marktplätze (eBay, Amazon, Shopify usw.)

Vollständiger Integrationszyklus

• Produkte aus Odoo: Alle Produkte werden aus dem Odoo ERP abgerufen und in der AdlerDo-Datenbank gespeichert. Dazu gehören Produktdetails, SKUs, Beschreibungen, Preise und Spezifikationen.
• Bestandsaktualisierungen zu den Marktplätzen: Bestandsmengen werden aus Odoo abgerufen und automatisch auf alle verbundenen Marktplätze (eBay, Amazon, Shopify usw.) hochgeladen, um den Bestand synchron zu halten.
• Bestellungen von den Marktplätzen: Kundenbestellungen werden von allen Marktplätzen erfasst und in AdlerDo gespeichert und anschließend automatisch zur Abwicklung und Verarbeitung an Odoo gesendet.
• Produkte an Odoo gesendet: Produktaktualisierungen und neue Produkte aus AdlerDo werden zurück an Odoo gesendet und schließen so den vollständigen Synchronisationszyklus ab.

Vier Haupt-Synchronisationsschritte

Schritt 1: Produkte von Odoo zu AdlerDo

Was es bewirkt: Das System ruft alle Produkte aus Ihrem Odoo ERP-System ab und speichert sie in der Datenbank von AdlerDo. Dadurch entsteht ein synchronisierter Produktkatalog, der an mehrere Marktplätze verteilt werden kann.

Welche Informationen werden übertragen?

1. Produktinformationen

• Produktname & Titel
• Produktbeschreibung
• SKU (Stock Keeping Unit)
• Barcode / EAN
• Produktkategorie

2. Preise & Kosten

• Verkaufspreis
• Einstandspreis
• Listenpreis
• Währung
• Steuerinformationen

3. Produktdetails

• Produktbilder
• Produktvarianten
• Gewicht & Abmessungen
• Attribute & Spezifikationen
• Produkttyp

Schritt 2: Bestandsaktualisierungen zu den Marktplätzen

Was es bewirkt: Das System ruft die aktuellen Bestandsmengen aus Odoo ab und aktualisiert automatisch alle verbundenen Marktplätze (eBay, Amazon, Shopify usw.), um den Bestand in Echtzeit synchron zu halten.

Welche Informationen werden übertragen?

1. Bestandsinformationen

• Verfügbare Menge
• Reservierter Bestand
• Zuordnung der Produkt-SKU
• Bestandsstandort
• Lagerinformationen

2. Marktplatzaktualisierungen

• eBay-Bestandsaktualisierungen
• Amazon FBA/FBM-Bestand
• Shopify-Bestandsmengen
• Bestände weiterer Marktplätze
• Unterstützung mehrerer Standorte

3. Intelligente Funktionen

• Sicherheitsbestand-Puffer
• Verhinderung von Überverkäufen
• Echtzeit-Synchronisation
• Automatische Berechnungen
• Warnungen bei geringem Bestand

Schritt 3: Bestellungen von den Marktplätzen zu Odoo

Was es bewirkt: Das System erfasst alle Kundenbestellungen von den verbundenen Marktplätzen, speichert sie in AdlerDo und erstellt automatisch entsprechende Verkaufsaufträge in Odoo zur Abwicklung.

Welche Informationen werden übertragen?

1. Bestellinformationen

• Bestellnummer & ID
• Bestelldatum & Uhrzeit
• Bestellpositionen & Mengen
• Produkt-SKUs
• Bestellgesamtbetrag

2. Kundendetails

• Kundenname
• E-Mail-Adresse
• Telefonnummer
• Lieferadresse
• Rechnungsadresse

3. Zusätzliche Daten

• Zahlungsmethode
• Versandmethode
• Bestellhinweise
• Marktplatzquelle
• Sendungsverfolgungsinformationen

Schritt 4: Produkte an Odoo gesendet

Was es bewirkt: Produktaktualisierungen, neue Produkte und in AdlerDo gespeicherte Produktinformationen werden zurück an Odoo gesendet, um die Master-Datenbank synchron zu halten und den Integrationszyklus abzuschließen.

Welche Informationen werden übertragen?

1. Produktaktualisierungen

• Aktualisierte Produktdetails
• Preisänderungen
• Beschreibungsänderungen
• Attributaktualisierungen
• Bildaktualisierungen

2. Neue Produkte

• Erstellung neuer Produkte in Odoo
• Produktvarianten
• Produktkategorien
• Anfangsbestände
• Preisinformationen

3. Synchronisationsfunktionen

• Duplikatvermeidung
• Konfliktlösung
• Datenvalidierung
• Fehlerbehandlung
• Audit-Protokollierung

Zusammenfassung des vollständigen Zyklus

Dieser vollständige Synchronisationszyklus gewährleistet einen nahtlosen Datenfluss in alle Richtungen. Produkte fließen von Odoo zu den Marktplätzen, der Bestand wird kontinuierlich synchronisiert, Bestellungen fließen zurück nach Odoo und Produktaktualisierungen schließen den Zyklus ab. Alles geschieht automatisch und schafft ein einheitliches Ökosystem über alle Ihre Vertriebskanäle hinweg!

Warum dieser vollständige Zyklus wichtig ist

1. Vollständige Automatisierung Die vollständige bidirektionale Synchronisation eliminiert jede manuelle Dateneingabe

2. Einzige Quelle der Wahrheit Odoo bleibt die Master-Datenbank für alle Produktinformationen

3. Echtzeit-Synchronisation Alle Änderungen werden sofort über alle Plattformen hinweg übernommen

4. Einfache Skalierung Fügen Sie weitere Marktplätze ohne zusätzliche Komplexität hinzu

AdlerDo

Hier herunterladen

Systemanforderungen

• RAM: 4 GB oder mehr
• CPU: 2 vCPUs oder mehr
• Speicher: 40 GB SSD oder mehr

Schritt 1: ASP.NET Core 8.0

Download-Link

https://builds.dotnet.microsoft.com/dotnet/aspnetcore/Runtime/8.0.22/aspnetcore-runtime8.0.22-win-x64.exe

Projektstruktur / Anwendungsdateien

• Backend-Modul – Name: marketplace_api
• Frontend-Modul – Name: coresystem_wbf

Schritt 2: AdlerDo installieren

• Installieren Sie zuerst die Marketplace Setup Api

Aktivieren Sie das Kontrollkästchen, um den Lizenzbedingungen zuzustimmen, und klicken Sie dann auf Install. Warten Sie anschließend, bis die Installation abgeschlossen ist.

• Drücken Sie nach Abschluss der Installation auf Finish.

Es ist unerlässlich, nach der Installation sicherzustellen, dass der Dienst im Hintergrund läuft.

Schritt 3: Die AdlerDo-App öffnen

• Die Installation ist abgeschlossen. Sie können nun Ihren Benutzernamen und Ihr Passwort eingeben.

Dokumentation zur Einrichtung der Marktplatzintegration

Kontenintegration (Verbinden und verwalten Sie Ihre Marktplatz- und ERP-Konten für nahtlosen Verkauf über mehrere Kanäle)

AdlerDo-Integration:

• Verbinden Sie Marktplatzkonten (Kaufland, Shopify, PrestaShop, JTL usw.)
• Synchronisieren Sie Produkte, Bestände und Bestellungen automatisch
• Bieten Sie eine zentrale Verwaltung für alle Vertriebskanäle an einem Ort
• Sparen Sie Zeit und reduzieren Sie manuelle Fehler

Integrationsschritte

Schritt 1: Zugriff auf die Kontenseite

• Klicken Sie im linken Seitenleistenmenü auf " Accounts ".
• Die Seite " Accounts Integration " wird geöffnet.

Schritt 2: Kontotyp / Marktplatz auswählen

Wählen Sie im Dropdown-Menü " Select " die Plattform aus, die Sie aus den verfügbaren Marktplätzen integrieren möchten.

Schritt 3: Anmeldedaten eingeben

Sie müssen die folgenden Informationen eingeben (diese können je nach Plattform leicht variieren)

Schritt 4: Ein neues Konto hinzufügen

• Klicken Sie auf der Seite Accounts Integration auf die Schaltfläche " Add New Account " (die grüne Schaltfläche oben rechts auf der Seite).
• Ein Popup-Fenster oder eine neue Seite zur Eingabe der Kontodetails wird angezeigt.

Konto löschen

Mit dieser Funktion können Sie die Verbindung zu Ihrem Marktplatzkonto trennen.

Nachdem Sie sich bei Ihrem Konto angemeldet haben, wird die Adlerdo-Seite angezeigt.

Was ist die Produktverwaltung?

Diese Oberfläche ist Ihre Steuerzentrale für die Verwaltung Ihres Produktkatalogs und Bestands innerhalb des Adlerdo-Systems. Sie ermöglicht es Ihnen, Produkte hinzuzufügen, zu bearbeiten, zu importieren und zu exportieren und sie dann direkt an die mit Ihrem Konto verbundenen Online-Marktplätze zu senden.

1- Suchleiste

Suchen Sie nach einem bestimmten Produkt anhand seines Namens, seiner SKU oder anderer Informationen.

2- Bereich zur Auswahl von Marktplatz und Konto

• Marktplatz auswählen: Dropdown-Menü zur Auswahl des Online-Marktplatzes, auf dem Sie arbeiten möchten (z. B. Amazon, Shopify, eBay usw.).
• Konto auswählen: Dropdown-Menü zur Auswahl des mit diesem Marktplatz verknüpften Kontos (nützlich, wenn Sie mehrere Konten auf demselben Marktplatz haben).
• Schaltfläche An Marktplatz senden: Klicken Sie nach der Auswahl von Marktplatz und Konto auf diese Schaltfläche, um die ausgewählten Produkte an den gewählten Marktplatz zu senden.

3- Haupt-Aktionsschaltflächen

• Hinzufügen: Zum manuellen Hinzufügen eines neuen Produkts
• Bearbeiten: Zum Bearbeiten der Details ausgewählter Produkte (es muss mindestens ein Produkt ausgewählt sein).
• Dynamischer Produktimport: Zum dynamischen Importieren von Produkten aus einer externen Quelle (z. B. Excel-Datei oder API).
• Dynamischer Variantenimport: Zum dynamischen Importieren von Produktvarianten (wie Größe, Farbe usw.).
• Exportieren: Zum Exportieren der aktuellen Produktliste in eine Datei (Excel oder CSV) zur externen Verwendung oder Sicherung

4- Beschreibung der Spalten der Produkttabelle

• Name: Produktname (z. B. "Desk Combination", "headcall")
• SKU: Eindeutige Produktkennung (Stock Keeping Unit) — für die Synchronisation erforderlich
• Preis: Produktpreis (wird bei Bearbeitung automatisch auf den Marktplätzen aktualisiert).
• GTIN / MPN / ASIN / UPC: Globale Produktklassifizierungscodes (wichtig für Marktplätze wie Amazon und eBay).
• TaricCoc: Europäischer Zollcode (falls zutreffend — wichtig für den internationalen Versand).
• OriginCountry: Ursprungsland — von einigen Marktplätzen erforderlich
• Varianten: Grüne Schaltfläche für jedes Produkt zum Anzeigen oder Verwalten seiner Varianten (z. B. Farben, Größen …).
• Galerie: Grüne Schaltfläche zum Anzeigen oder Hinzufügen von Produktbildern (in der Regel für die Anzeige auf dem Marktplatz).

Das System bietet leistungsstarke Werkzeuge für den dynamischen Import und Export, mit denen Sie Ihre Produktdaten mit maximaler Flexibilität verwalten können. Diese Funktionen unterstützen den mühelosen Import und Export von Produktinformationen zu und von jedem Marktplatz.

Dynamischer Produktimport

Die Funktion Dynamischer Produktimport ermöglicht es Ihnen, Produktdaten aus jedem Dateiformat oder jeder Struktur hochzuladen, ohne dass eine vordefinierte Vorlage erforderlich ist.

Wichtige Funktionen

• Unterstützt jedes Tabellenlayout und jede Spaltenreihenfolge (Excel, CSV usw.).
• Erkennt und ordnet Ihre Spalten automatisch den Systemfeldern zu.
• Ermöglicht den Import großer Produktkataloge in Sekunden.
• Geeignet für die Datensynchronisation von Lieferanten oder externen Systemen.

So verwenden Sie den dynamischen Produktimport

Schritt 1 — Die Importseite öffnen

Gehen Sie zu:

Produkte → Import → Dynamischer Produktimport

Schritt 2 — Ihre Datei hochladen

• Klicken Sie auf Excel-Datei importieren
• Wählen Sie Ihre Datei aus (Excel / CSV / beliebiges Format)

Das System unterstützt jede Spaltenstruktur – Sie müssen nichts umsortieren.

Schritt 3 — Automatische Spaltenzuordnung

Nach dem Hochladen:

• Das System erkennt automatisch die Spaltennamen
• Es ordnet jede Spalte dem richtigen Feld zu (Name, SKU, Preis, GTIN usw.)

Wenn sich das System bei einer Spalte nicht sicher ist, werden Sie aufgefordert, das richtige Feld manuell auszuwählen.

Schritt 4 — Überprüfen & Bestätigen

Überprüfen Sie die Vorschau der Zuordnung:

• Stellen Sie sicher, dass die Spalten korrekt zugeordnet sind
• Nehmen Sie bei Bedarf Anpassungen vor

Klicken Sie dann auf Bestätigen.

Schritt 5 — Hochladen

• Drücken Sie auf Hochladen.
• Ihre Produkte werden sofort erstellt oder aktualisiert.

Ideal für Lieferantentabellen, benutzerdefinierte Formate oder Marktplatzexporte.

Importvorlage herunterladen

Wenn Sie auf die grüne Schaltfläche Importvorlage herunterladen klicken → lädt das System sofort eine gebrauchsfertige Excel-Datei mit dem Namen Product_Import_Template.xlsx herunter

Wo möchten Sie die importierten Produkte veröffentlichen?

Nach dem Import von Produkten (ob aus einer Excel-Datei oder über den dynamischen Import) ist dieser Bereich dafür verantwortlich, genau festzulegen, auf welchen Marktplätzen und Verkäuferkonten die Produkte automatisch veröffentlicht werden, sobald der Import abgeschlossen ist. Wenn hier kein Marktplatz oder Konto ausgewählt wird → werden die Produkte nur zu Ihrem Katalog hinzugefügt und NICHT auf einem Marktplatz veröffentlicht.

Schritt-für-Schritt-Anleitung

Schritt 1

• Aktion: Wählen Sie aus dem ersten Dropdown "Marktplatz auswählen" den gewünschten Marktplatz aus.
• Erwartetes Ergebnis: Das zweite Dropdown "Konto auswählen" wird aktualisiert und zeigt nur die mit diesem Marktplatz verknüpften Konten an.

Schritt 2

• Aktion: Wählen Sie aus dem zweiten Dropdown das spezifische Verkäuferkonto aus, auf dem Sie veröffentlichen möchten.

Schritt 3

• Aktion: Klicken Sie auf die orangefarbene Schaltfläche Zur Liste hinzufügen.
• Erwartetes Ergebnis: Der Marktplatz + das Konto erscheinen in der Tabelle darunter.

Schritt 4

• Aktion: Wiederholen Sie die Schritte 1–3, um weitere Marktplätze/Konten hinzuzufügen (wenn Sie an mehreren Orten veröffentlichen möchten).
• Erwartetes Ergebnis: Jede neue Hinzufügung = die importierten Produkte werden auch auf diesem Konto automatisch veröffentlicht.

Schritt 5

• Aktion: Um einen Marktplatz/ein Konto aus der Liste zu entfernen → klicken Sie in der Tabelle auf Löschen.
• Erwartetes Ergebnis: Dieser Marktplatz/dieses Konto erhält die importierten Produkte nicht mehr.

Schritt 6

• Aktion: Wenn Sie fertig sind → klicken Sie unten auf Ausgewählte hochladen oder Importieren.
• Erwartetes Ergebnis: Die Produkte werden importiert + sofort auf jedem in der Tabelle aufgeführten Marktplatz und Konto veröffentlicht.

Wichtiger Hinweis

Wenn Sie die Tabelle leer lassen (kein Marktplatz oder Konto hinzugefügt), werden die Produkte nur in Ihrem System gespeichert und auf keinem Marktplatz veröffentlicht, bis Sie sie später manuell über die individuelle Produktseite hinzufügen.

Dynamischer Variantenimport

Die Funktion Dynamischer Variantenimport ermöglicht es Benutzern, Variantendaten für Produkte aus jedem Dateiformat oder jeder Struktur hochzuladen – ohne dass eine vordefinierte Vorlage erforderlich ist.

Dieses Werkzeug wurde entwickelt, um den Import variantenreicher Kataloge zu vereinfachen.

Wichtige Merkmale

• Keine feste Vorlage erforderlich
• Erkennt und ordnet Dateispalten automatisch zu
• Intelligentes System verknüpft Varianten mit ihren übergeordneten Produkten
• Unterstützt unbegrenzte Variantenattribute
• Ideal für Lieferanten, Marktplatzexporte oder externe Systeme

Wie es funktioniert

Erstens: Ihre Datei hochladen

1. Navigieren Sie zu: Produkte → Import → Dynamischer Variantenimport
2. Klicken Sie auf Datei zum Hochladen auswählen

Das System akzeptiert jede Struktur – die Spalten können in beliebiger Reihenfolge sein.

Zweitens: Automatische Spaltenerkennung

Nach dem Hochladen:

• Das System durchsucht die Tabelle
• Erkennt relevante Spalten (SKU, übergeordnete SKU, Größe, Farbe, Preis usw.)
• Schlägt automatisch Feldzuordnungen vor

Wenn eine Spalte unklar ist, zeigt das System ein Dropdown an, damit Sie das richtige Feld manuell auswählen können.

Komponente Produktattribute

Mit dieser Komponente kann der Benutzer einem Produkt Attribute zuweisen, indem er einen Attributnamen und einen entsprechenden Wert auswählt und diese dann zu einer Liste hinzufügt.

Zweck der Komponente

1. Der Bereich Produktattribute ermöglicht es dem Benutzer: Einen Attributnamen auszuwählen, Einen zu diesem Namen gehörenden Attributwert auszuwählen.
2. Das ausgewählte Paar zur Attributliste hinzuzufügen
3. Attributeinträge aus einer Tabelle zu verwalten (bearbeiten/löschen)

Dies stellt sicher, dass jedes Produkt ein oder mehrere Attribut-/Wertpaare haben kann, die seine Variationen beschreiben.

Schaltfläche Varianten herunterladen

Mit der Schaltfläche Varianten herunterladen kann der Benutzer eine fertige Excel-Datei herunterladen, die eine Vorlage zur Eingabe der Variantendaten des Produkts enthält.

Diese Vorlage hilft dem Benutzer, die Daten im richtigen Format vorzubereiten, bevor sie in das System hochgeladen werden.

Schaltfläche Exportieren

Mit der Schaltfläche Exportieren können Benutzer alle derzeit im Bildschirm Produktverwaltung angezeigten Produkte – oder nur die ausgewählten Produkte – in einer sauberen und strukturierten Excel-Datei herunterladen.

Diese Datei wird sofort generiert und enthält die vollständigen Produktdaten genau so, wie sie in der Produkttabelle des Systems angezeigt werden.

Wenn der Benutzer auf Exportieren klickt, führt das System Folgendes aus:

Sammelt entweder:

• Nur die ausgewählten Produkte (wenn der Benutzer bestimmte Zeilen markiert hat).
• Generiert eine Excel-Datei mit strukturierten Produktinformationen.
• Lädt die Datei sofort auf das Gerät des Benutzers herunter.

Format der exportierten Datei

Die exportierte Excel-Datei enthält alle Standard-Produktfelder wie:

• Produktname
• SKU
• Preis
• GTIN
• MPN
• ASIN
• UPC
• Taric-Code
• Ursprungsland
• Varianten (falls verfügbar)
• Alle zusätzlichen benutzerdefinierten Attribute, die in der Tabelle angezeigt werden

Die Datei verwendet dieselbe Struktur und dieselben Spalten wie Ihre Produktliste innerhalb des Systems und gewährleistet so:

• Einfache Bearbeitung
• Einfaches erneutes Importieren mit dem dynamischen Import
• Kompatibilität mit allen verbundenen Marktplätzen

Auf der Seite „Neues Produkt hinzufügen“ können Sie Produkte über verschiedene Marktplätze hinweg problemlos anlegen und verwalten. Durch die Eingabe der wesentlichen Produktdetails und die Auswahl Ihrer Marktplatzkonten können Sie Produkte schnell auf mehreren Plattformen von einem einzigen Ort aus einstellen und aktualisieren. Diese Funktion sorgt für reibungslose Produkt-Uploads, eine komfortable Variantenverwaltung sowie die Echtzeit-Synchronisierung mit Ihren Marktplatzkonten.

1- Klicken Sie oben links in der Hauptaktionsleiste auf die grüne Schaltfläche + Hinzufügen

2- Es öffnet sich ein Formular zur Produkterstellung

3- Marktplatzkonten bei der Produkterstellung

Marktplatzkonten

Schritt 1:

Wählen Sie im Dropdown-Menü „Marktplatz auswählen“ den gewünschten Marktplatz aus (z. B. Amazon)

Schritt 2:

Das Dropdown-Menü „Konto auswählen“ wird automatisch aktualisiert und zeigt nur die Konten an, die mit dem ausgewählten Marktplatz verknüpft sind

Schritt 3:

Wählen Sie im Dropdown-Menü „Konto auswählen“ das gewünschte Verkäuferkonto aus

Schritt 4:

Marktplatz und Konto sind nun ausgewählt

Schritt 5:

Klicken Sie auf die orangefarbene Schaltfläche „Zur Liste hinzufügen“

Schritt 6:

In der Tabelle „Ausgewählte Marktplatzkonten“ erscheint sofort eine neue Zeile

4- Schrittweise Anleitung (Neue Varianten hinzufügen und Attribut hinzufügen)

Schritt 1:

Klicken Sie auf + Neue Variante (grüne Schaltfläche oben)

Schritt 2:

Geben Sie den Variantennamen ein

Schritt 3:

Geben Sie eine eindeutige SKU ein

Schritt 4:

Legen Sie den Preis und die verfügbare Menge für diese Variante fest

Schritt 5:

Klicken Sie auf + Attribut hinzufügen → Wählen Sie den Attributtyp aus

Schritt 6:

Klicken Sie auf „Produkt speichern“

Leitfaden zur Kategorieverwaltung

Im Bereich Kategorieverwaltung können Sie die Produkte in Ihrem Shop organisieren, indem Sie Kategorien erstellen, bearbeiten und löschen.

Zugriff auf die Seite „Kategorieverwaltung“

Klicken Sie in der linken Seitenleiste auf Kategorien, wie in der Abbildung dargestellt.

Sie werden zur Seite „Kategorieverwaltung“ weitergeleitet, die Folgendes enthält:

1. Eine Schaltfläche „Hinzufügen“, um eine neue Kategorie zu erstellen
2. Eine Schaltfläche „Bearbeiten“, um eine ausgewählte Kategorie zu ändern
3. Eine Schaltfläche „Löschen“, um eine ausgewählte Kategorie zu entfernen
4. Eine Tabelle mit den Namen der vorhandenen Kategorien

Schritt 1: Eine neue Kategorie hinzufügen (Kategorie hinzufügen)

1. Klicken Sie auf die Schaltfläche Hinzufügen (die grüne Schaltfläche).
2. Es erscheint ein Formular, in dem Sie die Kategoriedetails eingeben können:
   Name: der Name der Kategorie
3. Nachdem Sie die Informationen eingegeben haben, klicken Sie auf Speichern.
4. Die neue Kategorie erscheint sofort in der Tabelle.

Schritt 2: Eine Kategorie bearbeiten (Kategorie bearbeiten)

Wählen Sie in der Kategorietabelle die Kategorie aus, die Sie bearbeiten möchten (durch Anklicken).

1. Klicken Sie auf die Schaltfläche Bearbeiten (die orangefarbene Schaltfläche).
2. Es erscheint ein Formular mit den aktuellen Kategoriedetails.
3. Nehmen Sie die erforderlichen Änderungen vor.
4. Klicken Sie auf Speichern, um die Änderungen zu sichern.

Schritt 3: Eine Kategorie löschen (Kategorie löschen)

Wählen Sie in der Kategorietabelle die Kategorie aus, die Sie löschen möchten.

1. Klicken Sie auf die Schaltfläche Löschen (die rote Schaltfläche).
2. Es erscheint eine Bestätigungsmeldung zum Löschen.
3. Klicken Sie auf Bestätigen, um den Vorgang abzuschließen.
4. Die Kategorie wird aus der Liste entfernt.

Kundenbestellungen verfolgen und verwalten.

Auf der Seite „Auftragsverwaltung“ können Sie alle Kundenbestellungen einsehen, den Zahlungsstatus prüfen, die Erstellungs- und Versandzeiten anzeigen sowie die Details jeder einzelnen Bestellung öffnen.

In der Seitenleiste auf der linken Seite:

Klicken Sie auf Bestellungen, um zur Bestellseite zu gelangen.

Nach Bestellungen suchen

• Verwenden Sie die Suchleiste oben auf der Seite, um nach einer Bestellnummer zu suchen.
• Geben Sie die Bestellnummer ein und klicken Sie anschließend auf die Suchschaltfläche (🔍).
• Das System zeigt nur die Bestellungen an, die dem Suchbegriff entsprechen.

Daten aktualisieren

• Klicken Sie auf die Schaltfläche Aktualisieren oben rechts auf der Seite.
• Diese Schaltfläche ruft die aktuellsten Bestelldaten vom Server ab.

Bestelltabelle

Die Tabelle zeigt alle Bestellungen mit den folgenden Spalten an:

1- Bestellnummer

Zeigt die eindeutige Bestellnummer an (z. B. #1057).

2- Status

Zeigt den Status der Bestellung an (z. B. Bezahlt).

3- Zahlungsmethode

Gibt die vom Kunden verwendete Zahlungsmethode an (z. B. Kreditkarte).

4- Erstellungszeit

Zeigt das Datum und die Uhrzeit an, zu der die Bestellung erstellt wurde.

5- Versandzeit

Zeigt die Versandzeit der Bestellung an (sofern verfügbar).

6- Bestelldetails

Jede Zeile enthält eine Schaltfläche „Details“. Durch Anklicken können Sie die vollständigen Details der Bestellung einsehen.

Kundenverwaltung

Im Bereich Kundenverwaltung können Sie Kundeninformationen und Kundenbeziehungen auf strukturierte und einfache Weise verwalten.

Klicken Sie in der linken Seitenleiste auf „Kunden“, wie durch den roten Pfeil in der Abbildung angezeigt.

Sie werden zur Seite Kundenverwaltung weitergeleitet, die Folgendes enthält:

• Ein Suchfeld, um Kunden nach Namen oder Nummer zu finden
• Die Schaltflächen Hinzufügen, Bearbeiten und Löschen zur Verwaltung der Kundeninformationen
• Eine Tabelle mit den aktuellen Kunden samt Namen und Nummern sowie einer Schaltfläche, um die Adresse jedes Kunden anzuzeigen

Schritt 1: Einen neuen Kunden hinzufügen (Kunde hinzufügen)

1. Klicken Sie auf die Schaltfläche „Hinzufügen“ (die grüne Schaltfläche).
2. Es erscheint ein Fenster bzw. Formular zur Eingabe der Kundendaten:
   • Kundenname: der Name des Kunden
   • Kundennummer: die Nummer des Kunden
   • Weitere vom System benötigte Informationen (z. B. Adresse, E-Mail, Telefon …)
3. Nachdem Sie die Daten eingegeben haben, klicken Sie auf „Speichern“, um den Kunden hinzuzufügen.
4. Der neue Kunde erscheint in der Kundentabelle.

Schritt 2: Kundeninformationen bearbeiten (Kunde bearbeiten)

1. Wählen Sie in der Kundentabelle den Kunden aus, dessen Informationen Sie bearbeiten möchten (durch Anklicken des Namens).
2. Klicken Sie auf die Schaltfläche Bearbeiten (die orangefarbene Schaltfläche).
3. Es erscheint ein Fenster mit den Informationen des Kunden.
4. Nehmen Sie die erforderlichen Änderungen vor.
5. Klicken Sie auf Speichern, um die Änderungen zu sichern.

Schritt 3: Einen Kunden löschen (Kunde löschen)

1. Wählen Sie in der Tabelle den Kunden aus, den Sie löschen möchten.
2. Klicken Sie auf die Schaltfläche Löschen (die rote Schaltfläche).
3. Es erscheint ein Bestätigungsfenster zum Löschen.
4. Klicken Sie auf Bestätigen, um den Löschvorgang abzuschließen.
5. Der Kunde wird aus der Liste entfernt.

Das Modul zur Verwaltung von Protokolleinträgen ermöglicht es Systemadministratoren, die Systemaktivität zu überwachen und Probleme zu beheben, indem sie detaillierte Protokolleinträge einsehen.

Zugriff auf die Seite „Systemprotokoll“

Sie können auf die Seite „Systemprotokoll“ über die Seitenleiste zugreifen:

Seitenleiste → Protokolleinträge

(In der Abbildung durch einen roten Rahmen hervorgehoben)

Tabelle der Protokolleinträge

Die Tabelle zeigt alle Systemprotokolleinträge mit den folgenden Spalten an:

• Protokollmeldung:

  • Der Text oder die Art des protokollierten Ereignisses (z. B. Produktvarianten).
  • Stellt die Art der Aktivität oder das mit dem Protokolleintrag verbundene Element dar.

• Zeitstempel:

  • Das Datum und die Uhrzeit, zu der das Ereignis protokolliert wurde.
  • Zeigt den genauen Zeitpunkt an (z. B. 19.11.2025 13:10:40).

• Aktionsname:

  • Die Art der im System durchgeführten Aktion (z. B. bedeutet „Geändert“, dass etwas bearbeitet wurde).

• Benutzer:

  • Der Name des Benutzers oder Administrators, der die Aktion durchgeführt hat.

Die Registerkarte "Benutzer" dient der Verwaltung von Systembenutzern, indem Sie neue Benutzer hinzufügen, die Informationen bestehender Benutzer bearbeiten oder diese löschen.

Aufrufen der Registerkarte "Benutzer"

Um mit der Benutzerverwaltung zu beginnen, wählen Sie Benutzer in der Seitenleiste aus. Dadurch wird die Benutzerseite geöffnet, auf der alle Systembenutzer aufgelistet sind.

Am oberen Rand der Seite befinden sich drei Schaltflächen zur Verwaltung der Benutzerdaten:

Einen neuen Benutzer hinzufügen

Klicken Sie am oberen Rand der Seite auf die Schaltfläche Benutzer hinzufügen. Es öffnet sich ein Fenster mit auszufüllenden Feldern, darunter:

• Anzeigename
• Benutzername
• E-Mail
• Telefonnummer
• Passwort

Nachdem Sie die Felder ausgefüllt haben, klicken Sie auf Speichern, um den neuen Benutzer zum System hinzuzufügen.

Einen bestehenden Benutzer bearbeiten

Wählen Sie den zu bearbeitenden Benutzer aus der Tabelle aus und klicken Sie auf Benutzer bearbeiten. Aktualisieren Sie die erforderlichen Informationen und klicken Sie anschließend auf Änderungen speichern, um die Aktualisierungen zu übernehmen.

Einen Benutzer löschen

Um einen Benutzer zu löschen, wählen Sie ihn aus der Tabelle aus und klicken Sie auf Benutzer löschen. Bestätigen Sie den Löschvorgang, um das Konto dauerhaft zu entfernen.

Tipps zur Benutzerverwaltung

• Überprüfen Sie die Benutzerinformationen stets sorgfältig, bevor Sie Änderungen speichern.
• Verwenden Sie für alle Konten starke, sichere Passwörter.
• Überprüfen und entfernen Sie regelmäßig inaktive oder nicht benötigte Benutzer, um das System übersichtlich zu halten.

Diese Seite dient der Verwaltung von Kundenauftragssendungen, der Verfolgung ihres Status, der Identifizierung des Versandunternehmens sowie der Anzeige der zu jeder Sendung gehörenden Daten.

Schritt 1: Aufrufen der Sendungsseite

Scrollen Sie in der linken Seitenleiste nach unten, bis Sie "Versand" finden.

Klicken Sie darauf, und die Seite Sendungsverwaltung wird geöffnet, wie in der Abbildung dargestellt.

Versandstatus – Schritt-für-Schritt-Anleitung

Zunächst: Wo die Sendungsstatus im System erscheinen

Die Sendungsstatus erscheinen auf der Seite Sendungsverwaltung an folgender Stelle:

Aus dem linken Menü:

• Scrollen Sie nach unten, bis Sie Versand finden
• Klicken Sie darauf

Die Seite Sendungsverwaltung wird geöffnet.

Am oberen Rand der Seite finden Sie einen Bereich namens Filter.

Innerhalb der Filter befindet sich ein Dropdown-Menü mit dem Namen: Versandstatus

Wenn Sie auf das Dropdown-Menü klicken, erscheinen die folgenden Status:

• Ausstehend – Klicken Sie hier, um Sendungen anzuzeigen, die sich noch in Vorbereitung befinden.
• Abgeschlossen – Klicken Sie hier, um Sendungen anzuzeigen, die zugestellt oder abgeschlossen wurden.
• Storniert – Klicken Sie hier, um Sendungen anzuzeigen, die storniert wurden.

Schritt 2: Klicken Sie auf die Schaltfläche "Filter"

Nachdem Sie den Status ausgewählt haben, klicken Sie auf die grüne Schaltfläche "Filter".

Schritt 3: Ergebnisse anzeigen

Die darunterliegende Tabelle wird aktualisiert und zeigt nur die Sendungen an, die dem von Ihnen ausgewählten Status entsprechen.

Wo die Liste der Versandunternehmen erscheint

Auf der Seite Sendungsverwaltung finden Sie oberhalb der Sendungstabelle den Bereich Filter.

Innerhalb der Filter befindet sich ein Dropdown-Menü mit dem Titel Versandunternehmen.

Funktion der Liste der Versandunternehmen

Sie dient dazu, das Versandunternehmen auszuwählen, für das Sie ausschließlich die Sendungen anzeigen möchten.

So verwenden Sie die Liste der Versandunternehmen

Klicken Sie auf das Dropdown-Menü neben Versandunternehmen.

Es wird eine Liste verfügbarer Versandunternehmen angezeigt, wie zum Beispiel:

• Alle (zur Anzeige aller Unternehmen)
• DHL Internetmarke
• DB Schenker Land
• DB Schenker Air
• DB Schenker Ocean FCL
• DB Schenker Ocean LCL

Wählen Sie das Versandunternehmen aus, dessen Sendungen Sie ausschließlich anzeigen möchten.

Sendungen nach Versandunternehmen filtern

Nachdem Sie ein Versandunternehmen ausgewählt haben, klicken Sie auf die grüne Schaltfläche Filter neben den Dropdown-Menüs.

Die Sendungstabelle wird aktualisiert und zeigt nur Sendungen an, die das ausgewählte Versandunternehmen verwenden.

Wichtige Hinweise

• Die Auswahl von Alle im Dropdown-Menü zeigt Sendungen aller Versandunternehmen ohne Filterung an.
• Diese Funktion hilft Ihnen, sich schnell und einfach auf die Sendungen eines bestimmten Unternehmens zu konzentrieren.

Tabelle mit Sendungsinformationen

Unterhalb der Filter finden Sie eine Tabelle mit Sendungsinformationen, die die folgenden Spalten enthält:

Über diese Oberfläche können Sie verschiedene Versandunternehmenskonten innerhalb des Systems verwalten und verknüpfen, wie zum Beispiel DHL und DB Schenker. Sie können darüber neue Konten hinzufügen, diese bearbeiten, löschen oder das mit dem Konto verbundene Versand-Wallet-Guthaben aufladen.

1. Aufrufen der Seite "Versandunternehmenskonten"

In der linken Seitenleiste:

Wählen Sie Versandunternehmenskonten aus (in der Abbildung rot hervorgehoben).

Anschließend sehen Sie unter Verbundene Konten eine Liste der verfügbaren Versandunternehmen.

2. Verfügbare Versandunternehmen

Im Beispiel erscheinen die folgenden:

• DHL Internetmarke (rot hervorgehoben)
• DB Schenker

Wenn Sie auf ein Versandunternehmen klicken, werden dessen Verwaltungseinstellungen angezeigt.

3. Seite zur DHL-Kontoverwaltung

Bei Auswahl von DHL Internetmarke erscheint die Seite zur DHL-Kontoverwaltung, die Folgendes umfasst:

• Konto hinzufügen (Grün) – Ein neues DHL-Konto zum System hinzufügen
• Konto bearbeiten (Gelb) – Ein bestehendes Konto bearbeiten
• Löschen (Rot) – Ein Konto aus dem System löschen
• Konto-Wallet aufladen (Orange) – Das Wallet-Guthaben des DHL-Kontos aufladen

4. Kontentabelle

Unterhalb der Schaltflächen erscheint eine Tabelle mit den registrierten DHL-Konten.

Verfügbare Spalten:

• Username: Der Benutzername des DHL-Kontos
• Create Shipping List: Gibt an, ob für dieses Konto eine Versandliste erstellt werden kann
• DPI: Die erforderliche Auflösung des Versandetiketts
• Voucher Layout: Das Layout des Versandetiketts/-scheins

Derzeit ist die Tabelle leer, da noch kein Konto hinzugefügt wurde.

Überblick über den Arbeitsablauf

➤ So fügen Sie ein neues Konto hinzu:

Wenn Sie in der DHL-Kontoverwaltungsoberfläche auf die Schaltfläche "Konto hinzufügen" klicken, erscheint ein neues Fenster, in dem Sie die Informationen des neuen DHL-Kontos zusammen mit den Einstellungen zum Drucken und Versand eingeben können.

Beschreibung der wichtigsten Felder

• Email und Password: Die grundlegenden Anmeldedaten für das Konto. Sie müssen korrekt eingegeben werden, damit das System eine Verbindung zum DHL-Konto herstellen kann.
• Create Shipping List: Legt fest, wie viele Versandlisten erstellt werden, was bei mehreren Sendungen nützlich ist.
• DPI: Druckauflösung, die die Qualität und Schärfe der Etiketten bestimmt.
• Voucher Layout: Das Design oder die Vorlage des zu druckenden Versandetiketts.
• Page Format, Width, Height, Page Type, Orientation: Detaillierte Einstellungen zur Steuerung von Größe und Layout der Druckseite.
• Space X, Space Y: Der Abstand zwischen den Etiketten auf der Seite.
• Count X, Count Y: Die Anzahl der Etiketten horizontal und vertikal.
• Margin Top, Margin Left: Legt den oberen und linken Seitenrand fest, um die Druckposition zu steuern.

Anwendung

1. Öffnen Sie das Fenster Neues DHL-Konto hinzufügen, indem Sie auf die Schaltfläche Konto hinzufügen klicken.
2. Füllen Sie die grundlegenden Felder aus (Email und Password).
3. Passen Sie die Druckeinstellungen nach Ihren Bedürfnissen an (DPI, Voucher Layout, Seitengröße, Ränder usw.).
4. Klicken Sie auf Speichern oder Bestätigen (die Schaltfläche ist in der Abbildung nicht dargestellt, befindet sich aber üblicherweise am unteren Rand des Formulars), um das neue Konto zu speichern.
5. Nach dem Speichern erscheint das neue Konto in der DHL-Kontenliste im Hauptfenster.

➤ So bearbeiten Sie ein Konto:

1. Wählen Sie das Konto aus der Tabelle aus
2. Klicken Sie auf Konto bearbeiten
3. Ändern Sie die erforderlichen Informationen
4. Klicken Sie auf Speichern

➤ So löschen Sie ein Konto:

1. Wählen Sie das Konto aus der Tabelle aus
2. Klicken Sie auf Löschen

➤ So laden Sie das Kontoguthaben auf:

1. Klicken Sie auf Konto-Wallet aufladen
2. Geben Sie den Aufladebetrag ein
3. Bestätigen Sie die Transaktion

Schritte zur Erstellung eines DHL-Kontos (das Konto, das Email + Password bereitstellt)

Schritt 1 — Rufen Sie die offizielle DHL-Website auf

https://express-resources.dhl.com/mena-eng-sme-account-request.html

Schritt 2 — Klicken Sie auf "Sign Up / Register"

Sie finden eine Schaltfläche wie:

• Register
• Create Account
• Oder Business Login → Register

Schritt 3 — Wählen Sie den Kontotyp

DHL bietet zwei Arten von Konten an:

1. Personal Account (nicht für die API-Integration geeignet)
2. Business Account (erforderlich für die Systemintegration)

Sie sollten auswählen: Business Account

Schritt 4 — Geben Sie die erforderlichen Informationen ein

Sie werden aufgefordert, Folgendes anzugeben:

• Email
• Create a Password
• Company Information
• Mobile Number
• Your Address

Schritt 5 — Aktivieren Sie das Konto

DHL sendet Ihnen eine E-Mail zur Bestätigung Ihres Kontos.

Schritt 6 — Melden Sie sich mit dem neuen Konto an

Nach der Aktivierung können Sie sich im DHL-Portal anmelden.

Das DB Schenker System bietet Versanddienstleistungen und ermöglicht es Benutzern, DB Schenker Versandkonten hinzuzufügen und zu verwalten, um ihre Versandvorgänge zu erleichtern.

Aufrufen des Bereichs "Versandkonten"

Klicken Sie im linken Menü auf Versandunternehmenskonten. Dadurch wird die Seite Integration der Versandunternehmenskonten geöffnet.

Aufrufen des DB Schenker Kontos

Suchen Sie unter den verbundenen Konten nach DB Schenker. Klicken Sie darauf, um die Seite zur Kontoverwaltung zu öffnen.

Funktion "Konto hinzufügen"

Mit der Funktion "Konto hinzufügen" können Sie ein neues DB Schenker Konto hinzufügen, um Ihre Versandvorgänge effizient zu verwalten.

Schritte zum Hinzufügen eines neuen Kontos

• Rufen Sie die Seite zur Kontoverwaltung auf: Wählen Sie im Seitenmenü Versandunternehmenskonten aus.
• Klicken Sie auf "Konto hinzufügen": Klicken Sie am oberen Rand der Seite zur DB Schenker Kontoverwaltung auf die grüne Schaltfläche Konto hinzufügen.

• Füllen Sie die Kontoinformationen aus:
  • Access Key: Pflichtfeld, das von DB Schenker bereitgestellt wird
  • Maßeinheitstyp: Metrisch oder Imperial
  • Maßeinheit: Kilogramm, Meter, Kubikmeter, Stück

Hinzufügen einer Versandart

Klicken Sie auf Methode hinzufügen und wählen Sie eine Versandart aus:

• Seefracht
• Luftfracht
• Landfracht

Klicken Sie auf Änderungen speichern, um zu bestätigen, oder auf Abbrechen, um den Vorgang abzubrechen.

Konto bearbeiten

Nach dem Hinzufügen klicken Sie auf die orangefarbene Schaltfläche Konto bearbeiten neben dem DB Schenker Konto, um die Details zu aktualisieren.

Konto löschen

Klicken Sie auf Konto löschen und bestätigen Sie, um das Konto und alle zugehörigen Daten dauerhaft zu entfernen.

Wo die Konten erscheinen

Die Konten werden in der Tabelle zur DB Schenker Kontoverwaltung angezeigt und enthalten:

• Account ID
• Access Key
• Maßeinheitstyp
• Maßeinheit
• Anzahl der Methoden
• Aktionen

Derzeit ist die Tabelle leer, da noch keine Konten hinzugefügt wurden.

Nahtlose Verbindung zwischen Ihrem Marktplatz, AdlerDo und Odoo

Willkommen bei Ihrer Marktplatz-Integration

Dieses System verbindet Ihren Marktplatz-Shop automatisch über AdlerDo mit dem Odoo ERP. Produkte, Bestellungen und Lagerbestände werden automatisch synchronisiert, wodurch Sie Zeit sparen und Fehler reduzieren.

Systemarchitektur

Marktplatz: Ihr Online-Shop → AdlerDo: Integrationsplattform → Odoo: ERP-System

Drei Hauptfunktionen

1-Produktsynchronisation

Marktplatz → AdlerDo → Odoo

Was sie bewirkt: Wenn Sie ein Produkt in Ihrem Marktplatz erstellen oder aktualisieren, erstellt oder aktualisiert das System automatisch dasselbe Produkt in Odoo mit allen Details wie Name, Beschreibung, Preis, SKU, Bildern und Varianten.

Funktionsweise

Marktplatz-Produkt → AdlerDo → Odoo-Produkt

Welche Informationen werden übertragen?

Grundlegende Informationen

• Produktname & Titel
• Produktbeschreibung
• SKU (Stock Keeping Unit)
• Barcode / UPC
• Produkttyp & Kategorie

Preise & Finanzen

• Verkaufspreis
• Vergleichspreis
• Kosten pro Artikel
• Steuerinformationen
• Währung

Produktdetails

• Produktbilder
• Produktvarianten (Größe, Farbe usw.)
• Gewicht & Abmessungen
• Tags & Kollektionen
• Lieferanteninformationen

Prozessschritte

1. Produkt in Ihrem Marktplatz erstellen oder aktualisieren
2. AdlerDo erfasst und speichert die Produktdaten
3. Produkt wird automatisch in Odoo erstellt

2- Bestellsynchronisation

Marktplatz → AdlerDo → Odoo

Was sie bewirkt: Wenn ein Kunde eine Bestellung in Ihrem Marktplatz-Shop aufgibt, erstellt das System automatisch dieselbe Bestellung in Odoo mit allen Kundendaten, bestellten Artikeln, der Lieferadresse und den Zahlungsinformationen.

Funktionsweise

Marktplatz-Bestellung → AdlerDo → Odoo-Bestellung

Welche Informationen werden übertragen?

Kundeninformationen

• Kundenname
• E-Mail-Adresse
• Telefonnummer
• Kunden-ID
• Kundenanmerkungen

Bestelldetails

• Bestellnummer
• Bestellartikel & Mengen
• Produkt-SKUs
• Gesamtbetrag der Bestellung
• Bestelldatum & -uhrzeit

Prozessschritte

1. Kunde gibt eine Bestellung in Ihrem Marktplatz auf
2. AdlerDo erfasst und verarbeitet die Bestellung
3. Bestellung wird automatisch in Odoo erstellt

3- Bestandsaktualisierung

Odoo → AdlerDo → Marktplatz

Was sie bewirkt: Wenn sich Ihr Lagerbestand in Odoo ändert (durch Verkäufe, Einkäufe oder Anpassungen), aktualisiert das System automatisch die Bestandsmengen für Ihre Produkte auf dem Marktplatz.

Funktionsweise

Odoo-Bestand → AdlerDo → Marktplatz-Produkt

Welche Informationen werden übertragen?

Bestandsinformationen

• Verfügbare Menge
• Reservierter Bestand
• Produkt-SKU
• Lagerort
• Lagerverfolgung

Bestandsaktualisierungen

• Menge auf Ihrem Marktplatz aktualisieren
• Als "Auf Lager" anzeigen
• Als "Nicht auf Lager" anzeigen
• Bestandsstatus verfolgen
• Unterstützung mehrerer Standorte

Intelligente Funktionen

• Sicherheitsbestandspuffer
• Überverkäufe verhindern
• Echtzeit-Aktualisierungen
• Automatische Berechnungen
• Warnmeldungen bei niedrigem Bestand

Prozessschritte

1. Bestand ändert sich in Odoo
2. AdlerDo speichert und berechnet die neue Menge
3. Marktplatz-Bestand wird automatisch aktualisiert

Zusammenfassung

Diese drei Funktionen wirken zusammen, um ein vollständiges Automatisierungssystem zu schaffen. Ihre Produkte und Bestände fließen von Ihrem Marktplatz zu Odoo, Ihre Bestellungen fließen von Ihrem Marktplatz zu Odoo, und Ihre Bestandsaktualisierungen fließen von Odoo zurück zu Ihrem Marktplatz. Alles geschieht automatisch ohne jegliche manuelle Arbeit!

Warum Ihnen das hilft

• Zeit sparen: Keine manuelle Dateneingabe oder das Kopieren von Informationen zwischen Systemen mehr
• Fehler reduzieren: Automatische Synchronisation bedeutet keine menschlichen Fehler oder Irrtümer
• Echtzeit-Daten: Verfügen Sie stets über genaue, aktuelle Informationen auf allen Plattformen
• Schneller wachsen: Verarbeiten Sie mehr Bestellungen und Produkte ohne zusätzlichen Aufwand

Marktplatz-Integrationssystem – powered by AdlerDo

Automatische Synchronisation zwischen Marktplatz und Odoo

© 2024 AdlerDo Integration Platform

AdlerDoo- und Odoo-Testumgebung

Diese Anleitung zeigt Ihnen, wie Sie Ihr Amazon-Seller-Central-Konto verbinden. Kundenspezifische Informationen wie Server-URLs, Benutzernamen, E-Mail-Adressen oder Firmennamen wurden in den Screenshots absichtlich unkenntlich gemacht.

Wichtig: Verwenden Sie stets die Zugangsdaten, die Ihnen separat und auf sicherem Wege zugesandt wurden. Bitte senden Sie keine Passwörter oder 2FA-Codes per gewöhnlicher E-Mail.

Teil A – Amazon in AdlerDoo verbinden

Voraussetzungen

• Remotedesktop-Zugang zur bereitgestellten virtuellen Maschine
• AdlerDoo-Benutzername und -Passwort
• Amazon-Seller-Central-Zugangsdaten
• Zugriff auf die Amazon-Zwei-Faktor-Authentifizierung / OTP, falls erforderlich

Schritt 1: Nach der Remotedesktopverbindung suchen

Öffnen Sie die Windows-Suche und suchen Sie nach "Remotedesktopverbindung". Starten Sie anschließend die App.

Schritt 2: Remotedesktop öffnen und Zugangsdaten eingeben

Geben Sie im Feld "Computer" die VM-URL ein, die Ihnen separat zugesandt wurde. Geben Sie anschließend den Benutzernamen ein. Klicken Sie danach auf "Verbinden".

Schritt 3: Passwort eingeben

Geben Sie das Passwort für die virtuelle Maschine ein und bestätigen Sie mit "OK". Die virtuelle Maschine wird daraufhin geöffnet.

Schritt 4: Das AdlerDoo-Programm öffnen

Klicken Sie auf dem Desktop der virtuellen Maschine auf die Programmverknüpfung von AdlerDoo. Bitte öffnen Sie hier nicht den Browser, sondern die AdlerDoo-Anwendung.

Schritt 5: Bei AdlerDoo anmelden

Melden Sie sich mit den AdlerDoo-Zugangsdaten an, die Ihnen separat zugesandt wurden.

Schritt 6: Apps Management öffnen

Öffnen Sie nach der Anmeldung im Menü auf der linken Seite den Bereich "Integrations" und anschließend "Apps Management".

Schritt 7: Ein Amazon-Konto anlegen

Klicken Sie im Bereich "Management Amazon Account" auf "Create Amazon Account".

Schritt 8: Bei Amazon Seller Central anmelden

Der Browser öffnet die Amazon-Anmeldeseite. Geben Sie die Amazon-Seller-Central-Zugangsdaten ein und bestätigen Sie die Zwei-Faktor-Authentifizierung, falls erforderlich.

Schritt 9: Berechtigungen erteilen

Folgen Sie den Anweisungen von Amazon und erteilen Sie die angeforderten Berechtigungen. Nach erfolgreicher Autorisierung werden Sie weitergeleitet oder erhalten eine Erfolgsmeldung.

Schritt 10: Die Verbindung prüfen

Prüfen Sie anschließend in AdlerDoo, ob das Amazon-Konto als verbunden angezeigt wird. Falls die Verbindung nicht angezeigt wird, aktualisieren Sie die Ansicht oder informieren Sie den Support.

Teil B – Amazon in der Odoo-Testumgebung verbinden

Dieser Abschnitt beschreibt, wie Sie Amazon direkt in der Odoo-Testumgebung verbinden. Die Odoo-Testumgebung ist in der Regel bereits im Browser innerhalb der virtuellen Maschine geöffnet.

Schritt 1: Die Odoo-Testumgebung öffnen

Öffnen Sie den Browser innerhalb der virtuellen Maschine. Die Odoo-Testumgebung sollte bereits geöffnet sein. Falls nicht, verwenden Sie die Odoo-Test-URL, die Ihnen separat bereitgestellt wurde.

Schritt 2: Sales öffnen

Klicken Sie in Odoo auf das Modul "Sales".

Schritt 3: Configuration und Accounts öffnen

Öffnen Sie in Sales oben das Menü "Configuration" und wählen Sie unter "Amazon" den Punkt "Accounts".

Schritt 4: Ein neues Amazon-Konto anlegen

Klicken Sie auf "New", um in Odoo ein neues Amazon-Konto anzulegen.

Schritt 5: Den Amazon-Marktplatz auswählen

Wählen Sie im Feld "Home Marketplace" den korrekten Amazon-Marktplatz aus, zum Beispiel "Amazon.de" für Deutschland.

Schritt 6: Die Verbindung starten

Klicken Sie auf "Connect" oder "Continue", um die Verbindung mit Amazon zu starten.

Schritt 7: Bei Amazon anmelden und Berechtigungen zulassen

Melden Sie sich mit dem Amazon-Seller-Central-Konto an und bestätigen Sie die angeforderten Berechtigungen. Falls Amazon nach einem OTP- oder 2FA-Code fragt, geben Sie diesen ein.

Schritt 8: Erfolg prüfen

Nach der Autorisierung kehren Sie zu Odoo zurück. Prüfen Sie, ob das Amazon-Konto angelegt wurde und ob der Verbindungsstatus korrekt ist.

Hinweise bei Problemen

• Wenn Amazon nach einem OTP-Code fragt, muss der Code vom Kontoinhaber bereitgestellt werden.
• Falls die Amazon-Anmeldung fehlschlägt, prüfen Sie bitte zunächst Benutzernamen, Passwort und 2FA.
• Falls die Verbindung nach dem Erteilen der Berechtigung nicht sichtbar ist, aktualisieren Sie die Seite und prüfen Sie erneut.
• Verwenden Sie stets den korrekten Marktplatz, zum Beispiel Amazon.de für Deutschland.
• Zugangsdaten sollten ausschließlich über einen sicheren Kanal weitergegeben werden.

Schritt-für-Schritt-Anleitung mit Remotedesktop und AdlerDoo Apps Management

Diese Anleitung erklärt, wie Sie ein eBay-Verkäuferkonto mit AdlerDoo verbinden. Alle Screenshots sind anonymisiert und zeigen keine kundenspezifischen Zugangsdaten.

Bevor Sie beginnen

• Verwenden Sie ausschließlich die virtuelle Maschine und die AdlerDoo-Zugangsdaten, die über den sicheren Zugangslink bereitgestellt wurden.
• Halten Sie den Zugang zum eBay-Verkäuferkonto bereit, das verbunden werden soll.
• Geben Sie die Zugangsdaten nicht an Dritte weiter.
• Falls eine Fehlermeldung erscheint, erstellen Sie einen Screenshot und senden Sie ihn uns per E-Mail zu.

Schritt 1 – Remotedesktopverbindung öffnen

Öffnen Sie auf Ihrem Windows-Computer das Startmenü, suchen Sie nach der Remotedesktopverbindung und öffnen Sie die App.

Schritt 2 – Die Daten der virtuellen Maschine eingeben

Klicken Sie bei Bedarf auf "Optionen einblenden". Geben Sie die Adresse des Remotecomputers und den Benutzernamen aus dem sicheren Zugangslink ein und klicken Sie anschließend auf "Verbinden".

Schritt 3 – Das Passwort der virtuellen Maschine eingeben

Geben Sie das Passwort aus dem sicheren Zugangslink ein und bestätigen Sie mit "OK". Bitte stellen Sie sicher, dass Sie die korrekten Zugangsdaten für die virtuelle Maschine verwenden.

Schritt 4 – AdlerDoo auf der virtuellen Maschine öffnen

Nachdem die Remotedesktop-Sitzung geöffnet wurde, starten Sie AdlerDoo auf der virtuellen Maschine.

Schritt 5 – Bei AdlerDoo anmelden

Melden Sie sich bei AdlerDoo mit dem Benutzernamen und Passwort an, die über den sicheren Zugangslink bereitgestellt wurden.

Schritt 6 – Apps Management öffnen

Gehen Sie in AdlerDoo zu "Integrations" und öffnen Sie anschließend "Apps Management" im linken Menü.

Schritt 7 – Die eBay-Verbindung erstellen

Scrollen Sie zu "Management eBay Account" und klicken Sie auf "Create eBay Account".

Schritt 8 – Bei eBay anmelden und die Verbindung bestätigen

Melden Sie sich mit dem eBay-Verkäuferkonto an, das verbunden werden soll. Folgen Sie den eBay-Autorisierungsschritten, bis die Verbindung abgeschlossen ist und Sie zurück zu AdlerDoo weitergeleitet werden.

Überblick

Diese Dokumentation beschreibt, wie Sie eine Shopify Public App im Shopify Dev Dashboard registrieren und konfigurieren und für die OAuth-Installation in AdlerDo V6.1 integrieren. Der Prozess erzeugt eine Client ID und ein Client Secret, die AdlerDo zur Authentifizierung gegenüber jedem Shopify-Store verwendet, der die App installiert.

Architektureller Kontext

AdlerDo stellt /api/shopify/install als OAuth-Einstiegspunkt bereit. Die App im Dev Dashboard leitet jede Installationsanfrage an diesen Endpunkt weiter, der den OAuth-Code-Austausch durchführt, das Zugriffstoken in der Mandantendatenbank speichert und über Hangfire-Hintergrundjobs die erforderlichen Webhooks registriert.

Voraussetzungen

Stellen Sie vor dem Beginn sicher:

• Zugriff auf die Shopify-Organisation der TecSee GmbH mit der Berechtigung zur Verwaltung von Apps
• AdlerDo-Middleware bereitgestellt und über HTTPS unter dem für die Zielumgebung konfigurierten öffentlichen Host erreichbar
• Die Endpunkte /api/shopify/install und /api/shopify/callback sind erreichbar und liefern gültige Antworten zurück
• Ein Entwicklungsstore steht für End-to-End-Tests zur Verfügung, bevor die Zugangsdaten in die Produktion überführt werden
• Die Liste der von AdlerDo benötigten OAuth-Scopes wurde finalisiert und in der Konfiguration hinterlegt

Schritt 1 — Die Seite für die App-Entwicklung öffnen

Melden Sie sich bei der Shopify-Organisation an und navigieren Sie zu Settings → Apps and sales channels → App development. Klicken Sie auf die Schaltfläche "Build apps in Dev Dashboard".

Wichtig: Verwenden Sie NICHT die Schaltfläche "Create an app" im Panel "Legacy custom apps". Legacy Custom Apps werden ab dem 1. Januar 2026 für neue Händler nicht mehr funktionieren.

Schritt 2 — Eine neue App im Dev Dashboard erstellen

Das Dev Dashboard öffnet sich unter dev.shopify.com/dashboard/{organizationId}/apps. Klicken Sie in der oberen rechten Ecke der App-Liste auf die Schaltfläche "Create app".

Schritt 3 — Einen Erstellungspfad wählen und den App-Namen festlegen

Es werden zwei Erstellungspfade angeboten:

• Start with Shopify CLI — erstellt ein Node/Remix-Projekt lokal als Gerüst. AdlerDo benötigt diesen Pfad nicht.
• Start from Dev Dashboard — registriert App-Metadaten direkt im Dashboard und erzeugt sofort eine Client ID und ein Secret. Verwenden Sie diesen Pfad für AdlerDo.

Geben Sie den App-Namen ein (zum Beispiel: AdlerDo) und klicken Sie auf "Create".

Namenskonvention

Verwenden Sie einen stabilen, für Kunden sichtbaren Namen, der auf dem Zustimmungsbildschirm bei der Installation angezeigt wird. Für TecSee bei Bedarf pro Umgebung mit Präfix: AdlerDo (Production), AdlerDo Staging, AdlerDo Dev.

Schritt 4 — URLs, Webhooks-Version und Scopes konfigurieren

Nach der Erstellung öffnet sich die App auf dem Reiter "Versions" mit einer neuen Entwurfsversion. Hier werden die Installations-URL, die Webhooks-API-Version und die Scopes definiert.

6.1 App-URL

Setzen Sie die App URL auf den öffentlichen AdlerDo-Installationsendpunkt:

https://whlvm133440.wawihost.de/api/shopify/install

Auf diese URL leitet Shopify weiter, wenn ein Händler die App installiert. Der ShopifyInstallController von AdlerDo liest die Query-Parameter shop und hmac aus, validiert den HMAC und leitet auf die OAuth-Grant-Seite von Shopify weiter.

6.2 App in Shopify-Admin einbetten

Lassen Sie das Kontrollkästchen "Embed app in Shopify admin" aktiviert. AdlerDo stellt mithilfe von App Bridge eine eingebettete Admin-Oberfläche innerhalb des Shopify-Admin-Frames bereit.

6.3 Preferences-URL

Optional. Lassen Sie das Feld leer, es sei denn, die App stellt eine separate Einstellungsseite außerhalb der eingebetteten Erfahrung bereit.

6.4 Webhooks-API-Version

Pinnen Sie die Webhooks-API-Version explizit. Das Beispiel zeigt 2026-04, was die derzeit von AdlerDo verwendete Version ist. Eine Anhebung dieses Werts erfordert die Überprüfung jedes Webhook-Payload-Mappings.

6.5 Zugriffs-Scopes

Klicken Sie auf "Select scopes" und aktivieren Sie die von AdlerDo benötigten Scopes. Halten Sie die Liste auf das Minimum, das AdlerDo tatsächlich verwendet — Händler sehen die vollständige Liste auf dem Zustimmungsbildschirm bei der Installation.

Genau dieselbe Liste muss außerdem in der AdlerDo-Konfiguration (appsettings.Shopify.json → Shopify:Scopes) hinterlegt werden, da der Installationscontroller sie als Query-Parameter scope übergibt. Eine Abweichung erzwingt Neuinstallationen.

Optionale vs. erforderliche Scopes

Optionale Scopes können zur Laufzeit nach der Installation angefordert werden. AdlerDo behandelt alle aufgeführten Scopes während der Erstinstallation als erforderlich, lassen Sie daher den Block "Optional scopes" leer.

6.6 Redirect-URLs

Fügen Sie die OAuth-Redirect-URL hinzu — die öffentliche URL des AdlerDo-OAuth-Callbacks:

https://whlvm133440.wawihost.de/api/shopify/callback

Fügen Sie pro Umgebung eine Redirect-URL hinzu. Shopify weist den OAuth-Callback zurück, wenn die im Parameter redirect_uri angegebene URL nicht auf dieser Whitelist steht.

Schritt 5 — Die Version veröffentlichen

Nachdem Sie alle Felder gespeichert haben, klicken Sie unten auf der Versionsseite auf "Release".

• Version name — eine menschenlesbare Bezeichnung. TecSee-Konvention: alderdoo-{n}, wobei n die automatisch hochzählende Release-Nummer ist
• Version message — ein kurzes Changelog (z. B. "added read_locales scope", "bumped webhooks API to 2026-04")

Klicken Sie auf "Release". Die neue Version wird sofort aktiv und ersetzt für alle Neuinstallationen die vorherige aktive Version.

Scope-Änderungen nach dem Release

Das Hinzufügen eines neuen Scopes zu einer veröffentlichten Version gewährt diesen NICHT automatisch für bereits installierte Shops. Der Shop-Inhaber muss eine erneute Autorisierung genehmigen. AdlerDo erkennt Scope-Abweichungen bei jeder Anfrage und löst bei Bedarf eine Weiterleitung zur Neuinstallation aus.

Schritt 6 — Die aktive Version überprüfen

Öffnen Sie den Reiter "Versions" über die linke Seitenleiste. Die zuletzt veröffentlichte Version ist mit dem grünen Badge "Active" gekennzeichnet. Alle vorherigen Versionen bleiben zu Prüfzwecken sichtbar.

Aus dieser Ansicht heraus können Sie jede historische Version anklicken, um ihre Konfiguration einzusehen — nützlich beim Debuggen einer Installation auf einem älteren Shop.

Schritt 7 — Client ID und Secret abrufen

Öffnen Sie den Reiter "Settings" über die linke Seitenleiste. Der Block "Credentials" oben zeigt die Client ID und das Secret an.

9.1 Client ID

Öffentlicher Bezeichner. Kann bedenkenlos in die Konfiguration übernommen werden. Kopieren Sie ihn über das Zwischenablage-Symbol und fügen Sie ihn in die AdlerDo-Konfiguration ein.

9.2 Client Secret

Vertraulich. Wie eine Zugangsberechtigung zu behandeln. Das Secret wird nur einmal bei der ersten Generierung angezeigt; danach wird nur die verschleierte Form angezeigt. Verwenden Sie das Augen-Symbol, um es einmalig zum Kopieren sichtbar zu machen, und speichern Sie es anschließend über den standardmäßigen AdlerDo-Secret-Storage-Pfad.

In AdlerDo werden Secrets für Marktplatzintegrationen AES-256-verschlüsselt in der Mandantendatenbank über den MarketplaceCredentialEncryptor gespeichert.

9.3 Das Secret rotieren

Klicken Sie auf "Rotate", um ein neues Secret zu generieren. Das vorherige Secret wird sofort ungültig. Koordinieren Sie die Rotation mit einem Deployment des neuen Secrets in AdlerDo.

9.4 API-Kontakt-E-Mail

Setzen Sie diese auf ein überwachtes Postfach (derzeit dev@tecsee.de). Shopify sendet Hinweise zu API-Veraltungen (Deprecations) und Sicherheitswarnungen an diese Adresse.

Die Zugangsdaten in AdlerDo einbinden

Sobald die Client ID und das Secret vorliegen, fügen Sie die Zugangsdaten der AdlerDo-Konfiguration hinzu.

10.1 Konfiguration

Fügen Sie den folgenden Block zur umgebungsspezifischen Konfiguration hinzu:

"Shopify": {
  "ClientId": "1d15c8413f636e7cfda6f4402d9ef552",
  "ClientSecret": "<from Settings page>",
  "Scopes": "read_products,write_products,read_orders,write_orders,…",
  "WebhooksApiVersion": "2026-04",
  "InstallRedirectUrl": "https://whlvm133440.wawihost.de/api/shopify/callback"
}

10.2 Installationsablauf

Der End-to-End-Installations-Handshake sieht wie folgt aus:

1. Der Händler klickt auf den Installationslink → Shopify leitet mit den Query-Parametern shop und hmac auf die App URL weiter
2. AdlerDo /api/shopify/install validiert den HMAC gegen das Client Secret und leitet mit der konfigurierten Scope-Liste und einer generierten State-Nonce auf https://{shop}/admin/oauth/authorize weiter
3. Der Händler genehmigt die Scopes auf dem Shopify-Zustimmungsbildschirm
4. Shopify leitet mit den Parametern code, hmac und state auf /api/shopify/callback weiter
5. AdlerDo validiert den HMAC und die State-Nonce und sendet anschließend per POST code + Client ID + Client Secret an https://{shop}/admin/oauth/access_token, um das Offline-Zugriffstoken zu erhalten
6. Das Token wird AES-256-verschlüsselt für den Mandanten gespeichert; Webhook-Abonnements und wiederkehrende Sync-Hangfire-Jobs werden registriert
7. AdlerDo leitet den Händler auf die eingebettete Admin-URL weiter

10.3 Die Installation überprüfen

Nach dem Handshake:

• Bestätigen Sie, dass eine neue ShopifyConnection-Entität in der Mandantendatenbank mit einem nicht-null EncryptedAccessToken und der gewährten Scope-Liste existiert
• Bestätigen Sie, dass die wiederkehrenden Jobs (SyncShopifyOrdersV2026, SyncShopifyProductsV2026) in Hangfire unter dem neuen Mandanten-Bezeichner registriert sind
• Lösen Sie einen Test-Webhook aus dem Shopify-Admin aus und bestätigen Sie, dass der AdlerDo-Handler ihn ohne HMAC-Fehler verarbeitet

Anhang A — Häufig von AdlerDo verwendete Scopes

Anhang B — Fehlerbehebung

Installations-Redirect gibt 401 / Invalid HMAC zurück

Ursache: Das Client Secret in der AdlerDo-Konfiguration stimmt nicht mit dem Secret in den Settings überein, oder das Secret wurde rotiert, ohne neu zu deployen.

Maßnahme: Kopieren Sie das Secret von der Settings-Seite im Dev Dashboard und deployen Sie neu.

OAuth-Callback gibt 'redirect_uri is not whitelisted' zurück

Ursache: Die Callback-URL ist nicht im Feld "Redirect URLs" der aktiven Version vorhanden.

Maßnahme: Öffnen Sie die aktive Version, fügen Sie die URL hinzu, veröffentlichen Sie eine neue Version und wiederholen Sie die Installation.

Shop wird installiert, aber es erscheinen keine Hangfire-Jobs

Ursache: Der OAuth-Code-Austausch war erfolgreich, aber der Post-Install-Bootstrap ist fehlgeschlagen (z. B. Mandanten-Provisionierung).

Maßnahme: Prüfen Sie die AdlerDo-Logs rund um den Zeitstempel der Installation; der ShopifyInstallController gibt pro Phase ein Information-Log und ein Error-Log mit dem fehlerhaften Schritt aus.

Webhook-Zustellungen schlagen mit HMAC-Fehlern fehl

Ursache: AdlerDo hat den Webhook-HMAC über einen geparsten Payload statt über den Raw-Body berechnet.

Maßnahme: Bestätigen Sie, dass die Request-Middleware den rohen Request-Body vor dem Model-Binding für die Routen /api/shopify/webhooks/* puffert.

Händler meldet fehlende Daten nach dem Hinzufügen eines Scopes

Ursache: Der Shop wurde gegen eine ältere Version installiert, die den Scope nicht enthielt.

Maßnahme: Lösen Sie eine Weiterleitung zur Neuinstallation aus — AdlerDo erkennt die Scope-Abweichung in der ShopifyConnectionMiddleware und leitet auf den Installationsendpunkt weiter, wo der Händler den neuen Scope genehmigt.

Veröffentlicht am 20. Februar 2026
Aktualisiert am 23. Februar 2026

Die Kaufland Global Marketplace API verbinden

Diese Anleitung erklärt, wie Sie AdlerDo mit der Kaufland Global Marketplace API verbinden. Nach der Verbindung kann AdlerDo Produkte, Bestände, Bestellungen und Versandinformationen zwischen Ihrem ERP (wie Odoo) und Kaufland synchronisieren.

Überblick

Durch die Verbindung von AdlerDo mit Kaufland über die offizielle API wird Ihr System in die Lage versetzt:

• Produktlistings aus Ihrem ERP mit Kaufland zu synchronisieren
• Bestände über die Systeme hinweg aktuell zu halten
• Kaufland-Bestellungen automatisch zu importieren
• Versandbestätigungen und Sendungsverfolgungsdaten an Kaufland zurückzusenden

Diese Integration gewährleistet einen stabilen, automatisierten Datenfluss und reduziert manuellen Aufwand.

Voraussetzungen

Stellen Sie vor dem Beginn sicher, dass:

• Sie über ein aktives Kaufland-Verkäuferkonto verfügen
• Sie Zugriff auf das Kaufland-Verkäuferportal haben
• Sie berechtigt sind, API-Zugangsdaten im Verkäuferkonto zu verwalten

Schritte zum Abrufen Ihrer Kaufland-API-Zugangsdaten

Um AdlerDo mit Kaufland zu verbinden, müssen Sie zunächst Ihre API-Zugangsdaten aus dem Kaufland-Verkäuferportal abrufen.

Schritt 1: Zu den API-Einstellungen navigieren

Öffnen Sie den folgenden Link in Ihrem Browser:

https://sellerportal.kaufland.de/settings/api

Navigieren Sie über das Menü auf der linken Seite zu:

Settings → Shop Settings → API

Schritt 2: Ihre aktuellen API-Schlüssel anzeigen

Im Bereich Current API key sehen Sie:

• Client key (Client ID) – aus Sicherheitsgründen maskiert
• Secret key (Client Secret) – aus Sicherheitsgründen maskiert

Diese Werte sind verborgen und können aus Sicherheitsgründen nicht erneut angezeigt werden.

Schritt 3: Neue API-Schlüssel generieren (falls erforderlich)

Wenn Sie keine gültigen Zugangsdaten besitzen oder ein neues Paar benötigen, klicken Sie auf:

Generate new API keys

Wichtig: Sobald neue Schlüssel generiert werden:

• Werden die alte Client ID und das alte Client Secret sofort ungültig
• Wird jede bestehende Integration, die die alten Schlüssel verwendet, nicht mehr funktionieren
• Müssen Sie AdlerDo mit den neuen Zugangsdaten aktualisieren

Schritt 4: Ihre neuen Zugangsdaten speichern

Nach dem Generieren neuer Schlüssel:

• Kopieren Sie die Client ID
• Kopieren Sie das Client Secret
• Speichern Sie beide Werte sicher

Nach dem Verlassen der Seite können Sie sie nicht erneut abrufen.

Kaufland mit AdlerDo verbinden

Nachdem Sie Ihre API-Zugangsdaten erhalten haben, können Sie Kaufland innerhalb von AdlerDo verbinden.

Schritt 1: Kontotyp auswählen

Wählen Sie im Dropdown-Menü neben "Select" den Eintrag: Kaufland

Schritt 2: Kontodaten eingeben

Füllen Sie die folgenden Felder aus:

Account Name

Geben Sie einen aussagekräftigen Namen für diese Verbindung ein, zum Beispiel "My Kaufland Store" oder "Kaufland DE Account"

Client ID

Geben Sie die Client ID ein, die Sie aus Ihrem Kaufland-Konto erhalten haben

Client Secret

Geben Sie das Client Secret ein, das Sie aus Ihrem Kaufland-Konto erhalten haben

Schritt 3: Das Konto speichern und verbinden

Nachdem Sie alle erforderlichen Felder ausgefüllt haben, klicken Sie auf die (grüne) Schaltfläche Add New Account.

AdlerDo versucht daraufhin, mithilfe der angegebenen Zugangsdaten eine Verbindung mit der Kaufland Global Marketplace API herzustellen.

Schritt 4: Verbundene Konten überprüfen

Sobald die Verbindung erfolgreich ist:

• Erscheint Ihr Kaufland-Konto in der Liste der Connected Accounts auf der linken Seite
• Bestätigt der Kontostatus, dass AdlerDo erfolgreich mit Kaufland verbunden ist

Zu diesem Zeitpunkt ist Ihr System bereit, Daten zu synchronisieren.

Was nach der Verbindung geschieht

Nach der Verbindung von Kaufland mit AdlerDo:

• Kann die Produkt- und Bestandssynchronisierung aktiviert werden
• Werden auf Kaufland aufgegebene Bestellungen automatisch in AdlerDo importiert
• Werden Bestellungen zur Verarbeitung an Ihr ERP weitergeleitet
• Können Versandbestätigungen und Sendungsverfolgungsnummern an Kaufland zurückgesendet werden

Die gesamte Synchronisierung folgt dem standardmäßigen AdlerDo Complete Sync Cycle.

Allgemeine Hinweise & Best Practices

Nach der Verbindung von Kaufland mit AdlerDo:

• Halten Sie SKUs zwischen Ihrem ERP und Kaufland stets konsistent
• Falls die Synchronisierung fehlschlägt, prüfen Sie, ob die API-Schlüssel neu generiert wurden
• Verwenden Sie eine sichere Speicherung für API-Zugangsdaten
• Verbinden Sie das Konto unmittelbar nach einer Änderung der API-Schlüssel neu

Diese Anleitung erklärt, wie Sie Ihren PrestaShop-Shop über die Oberfläche Accounts Integration mit AdlerDo verbinden. Nach der Verbindung kann AdlerDo Produkte, Bestände, Bestellungen und weitere Daten zwischen Ihrem PrestaShop-Shop und Ihrem ERP-System synchronisieren.

Überblick über die PrestaShop-Integration

Durch die Verbindung von PrestaShop mit AdlerDo können Sie Ihre E-Commerce-Abläufe optimieren und einen reibungslosen Datenfluss sicherstellen.

Zu den wichtigsten Vorteilen gehören:

• Automatische Synchronisierung von Produktlistings und Aktualisierungen
• Genaue Bestandsführung über alle Systeme hinweg
• Import von PrestaShop-Bestellungen in AdlerDo und Ihr ERP
• Sichere Verwaltung mehrerer PrestaShop-Konten über eine einzige Oberfläche

Diese Integration gewährleistet einen zuverlässigen und sicheren Datenfluss mit minimalem manuellem Aufwand.

• Bestandssynchronisierung
• Bestellimport
• Multi-Store-Verwaltung

Zugriff auf die Accounts-Integration

Der Reiter Accounts Integration ist über das Seitenmenü erreichbar, indem Sie Accounts auswählen.

Schritt 1: Kontotyp auswählen

Verwenden Sie oben auf der Seite das Dropdown-Menü Select, um den Typ des zu verknüpfenden oder zu verwaltenden Kontos auszuwählen, z. B.:

• PrestaShop (im Beispiel ausgewählt)

Schritt 2: Kontoaktionen

Add New Account

• Klicken Sie auf die grüne Schaltfläche, um AdlerDo ein neues PrestaShop-Konto hinzuzufügen.

Delete Account

• Klicken Sie auf die rote Schaltfläche, um das aktuell ausgewählte Konto zu löschen.

⚠️ Das Löschen eines Kontos stoppt die Synchronisierung für diese Verbindung sofort.

Schritt 3: Kontoeinstellungen

Im Bereich Account Settings können Sie eine PrestaShop-Kontoverbindung erstellen oder bearbeiten.

Feldbeschreibung:

1. Account Name

Interner Name in AdlerDo zur Unterscheidung mehrerer PrestaShop-Konten. Beispiel:

"PrestaShop – Main Store"

2. Base URL

Die Haupt-Website-URL Ihres PrestaShop-Shops. Beispiel:

https://yourshopdomain.com

3. Token

API-Token zur sicheren Authentifizierung zwischen AdlerDo und PrestaShop

Schritt 4: Verbundene Konten

Das Panel Connected Accounts befindet sich auf der linken Seite der Seite. Von hier aus können Sie:

• Ein Konto auswählen, um seine Einstellungen zu bearbeiten
• Ein Konto löschen, wenn es nicht mehr benötigt wird

Wenn keine Konten verbunden sind, erscheint die Liste leer.

Schritt 5: Base URL und API-Token aus PrestaShop abrufen

Base URL

Öffentliche URL Ihres PrestaShop-Shops. Beispiel:

https://yourshopdomain.com

API-Token:

Führen Sie die folgenden Schritte aus:

1. Melden Sie sich im PrestaShop-Back-Office an.
2. Navigieren Sie über die Seitenleiste zu Advanced Parameters → Webservice (API)
3. Wenn die Webservice-Funktion nicht aktiviert ist, schalten Sie sie ein, indem Sie Enable PrestaShop Webservice auswählen
4. Um einen neuen API-Schlüssel zu erstellen:
   • Klicken Sie auf Add new webservice key oder das Plus-Symbol (+)
   • Eine Seite zum Erstellen eines neuen Schlüssels erscheint
   • Klicken Sie auf Generate, um einen zufälligen Schlüssel zu erzeugen (dies ist der Token)
5. Kopieren Sie den generierten Schlüssel und speichern Sie ihn sicher
6. Weisen Sie die erforderlichen Berechtigungen zu, die AdlerDo benötigt (Lesen/Schreiben nach Bedarf)
7. Klicken Sie auf Save, um den Schlüssel zu aktivieren

⚠️ Wichtig: Bewahren Sie Ihren API-Token sicher auf. Falls der Token neu generiert wird, müssen Sie ihn umgehend in AdlerDo aktualisieren.

PlentyMarkets mit AdlerDoo verbinden

Verbinden Sie Ihr PlentyMarkets- (oder PlentyONE-) Konto in vier einfachen Schritten mit AdlerDoo. Sobald die Verbindung hergestellt ist, synchronisiert AdlerDoo Ihre Produkte, Kategorien, Attribute, Bestellungen und Kundenadressen automatisch zwischen PlentyMarkets und Odoo.

Bevor Sie beginnen

• Ein aktives PlentyMarkets- oder PlentyONE-Konto mit REST-API-Zugriff.
• Ihre Basis-URL (zum Beispiel: https://your-shop.plentymarkets-cloud01.com).
• Ein Benutzername und ein Passwort für einen Benutzer mit REST-API-Berechtigungen.

Tipp: Legen Sie in PlentyMarkets einen dedizierten API-Benutzer für diese Integration an. Das ist sicherer als die Verwendung Ihres Administratorkontos, und Sie können den Zugriff jederzeit widerrufen, ohne andere Benutzer zu beeinträchtigen.

Plenty in vier Schritten verbinden

SCHRITT 1: Marktplatzkonten öffnen

Gehen Sie in der AdlerDoo-Seitenleiste zu Einstellungen → Integrationen → Marktplatzkonten.

SCHRITT 2: Plenty auswählen

Wählen Sie im Dropdown-Menü Marktplatz auswählen oben auf der Seite die Option Plenty.

SCHRITT 3: Auf "Neues Konto hinzufügen" klicken

Klicken Sie oben rechts auf der Seite auf die grüne Schaltfläche Neues Konto hinzufügen.

SCHRITT 4: Zugangsdaten eingeben und speichern

Füllen Sie die vier untenstehenden Felder mit Ihren PlentyMarkets-Zugangsdaten aus und klicken Sie anschließend auf Speichern. AdlerDoo authentifiziert sich, speichert die Zugriffs- und Aktualisierungs-Token automatisch, und Ihr Konto ist verbunden.

Tipp: AdlerDoo aktualisiert den Zugriffstoken im Hintergrund, bevor er abläuft – Sie müssen Token niemals manuell verwalten.

Die Verbindung überprüfen

Sobald die Verbindung hergestellt ist, beginnt AdlerDoo automatisch mit der Datensynchronisierung im Hintergrund. Verwenden Sie die folgenden Ansichten, um zu bestätigen, dass Produkte, Bestellungen, Kategorien, Attribute und Kunden aus Ihrem PlentyMarkets-Shop übernommen wurden.

1. Synchronisierungsstatus prüfen

Öffnen Sie Einstellungen → Integrationen → Verbindungssynchronisierung. Plenty sollte in der Liste mit einer grünen Anzeige Läuft erscheinen.

2. Synchronisierte Produkte durchsuchen

Öffnen Sie Haupt → Produkte und filtern Sie nach Plenty, um alle aus Ihrem Shop synchronisierten Produkte mit ihren SKUs, Preisen und Identifikatoren (GTIN, MPN, ASIN, UPC) anzuzeigen.

3. Produktvarianten prüfen

Klicken Sie in einer beliebigen Produktzeile auf Varianten, um das Detailfenster der Varianten zu öffnen. Jede Variante zeigt ihre SKU, ihren Barcode, Preis, Bestand und ihre Abmessungen – alles, was aus PlentyMarkets übernommen wurde.

4. Synchronisierte Bestellungen durchsuchen

Öffnen Sie Haupt → Bestellungen und filtern Sie nach Plenty, um alle aus PlentyMarkets übernommenen Bestellungen einschließlich Status, Zahlungsmethode und Zeitpunkt anzuzeigen.

5. Bestelldetails prüfen

Klicken Sie in einer beliebigen Bestellzeile auf Details, um das Detailfenster der Bestellung mit Positionen, Mengen, Preisen, Mehrwertsteuer und Summen zu öffnen. Verwenden Sie die Registerkarten Geschenk und Individuell oben rechts im Popup, um Geschenkoptionen und Anpassungsdaten anzuzeigen.

6. Synchronisierte Kategorien überprüfen

Öffnen Sie Haupt → Kategorien, um den vollständigen aus PlentyMarkets importierten Kategoriebaum anzuzeigen – dieselbe Hierarchie, die Sie zur Organisation von Produkten in Ihrem Shop verwenden.

7. Synchronisierte Attribute überprüfen

Öffnen Sie Haupt → Attribute, um alle Produktattribute (Größe, Farbe, Material, Marke, Hersteller, Altersgruppe, Muster, Geschlecht usw.) anzuzeigen, die zur Beschreibung von Varianten verwendet werden.

8. Synchronisierte Kunden überprüfen

Öffnen Sie Haupt → Kunden, um die aus PlentyMarkets übernommenen Kunden anzuzeigen. Jeder Eintrag hat eine Kundennummer mit dem Präfix PLENTY, die ihn mit seiner Quelle verknüpft. Klicken Sie in einer beliebigen Zeile auf Adresse anzeigen, um die hinterlegten Liefer- und Rechnungsadressen zu prüfen.

Was automatisch synchronisiert wird

Nach der erstmaligen Verbindung hält AdlerDoo Folgendes zwischen PlentyMarkets und Odoo synchron – ohne manuelles Eingreifen:

• Produkte – einschließlich Varianten, Verkaufspreisen, Lagerbeständen und Attributwerten.
• Kategorien – der vollständige Kategoriebaum und die Hierarchie.
• Attribute – Größe, Farbe, Material und andere Variantenattribute.
• Bestellungen – werden in Odoo als Verkaufsaufträge angelegt.
• Kundenadressen – verknüpft mit den entsprechenden Bestellungen und Kontakten.

Ein verbundenes Konto entfernen

Um ein Plenty-Konto zu trennen: Wählen Sie es aus der Liste Verbundene Konten auf der linken Seite aus und klicken Sie dann oben rechts auf die rote Schaltfläche Konto löschen.

Benötigen Sie Hilfe?

Bei Problemen oder Fragen zur Integration wenden Sie sich bitte an das AdlerDoo-Support-Team.

Zur Integrationsseite navigieren

Über die Seitenleiste auf der linken Seite:

Konten → Seitenleistenmenü

(Im Bild in einem roten Rahmen dargestellt)

Das Integrationssystem auswählen

Oben auf der Seite befindet sich ein Dropdown-Menü: Auswählen

Wählen Sie JTL aus der Liste der verfügbaren Systeme.

Kontoeinstellungen (JTL-Kontokonfiguration)

Nachdem Sie JTL ausgewählt haben, erscheinen drei wichtige Felder, die ausgefüllt werden müssen

1. Kontoname

Der Name des Kontos, den Sie im System anzeigen möchten.

Dies hilft Ihnen, das Konto künftig leicht zu identifizieren.

2. Client ID

Der eindeutige Identifikator für die JTL-Integration.

Diesen Wert erhalten Sie über Ihr JTL-Bedienfeld.

3. Client Secret

Der geheime Schlüssel für das Konto.

Er sollte sicher aufbewahrt und niemals weitergegeben werden, um die Sicherheit zu gewährleisten.

Dieser Schlüssel wird zur Authentifizierung und zur Verknüpfung beider Systeme verwendet.

Verfügbare Vorgänge

Eine grüne Schaltfläche oben rechts.

Sie fügt ein neues JTL-Konto hinzu, nachdem die erforderlichen Informationen eingegeben wurden.

Konto löschen

Eine rote Schaltfläche oben rechts.

Sie löscht das ausgewählte Konto aus der Liste der verknüpften Konten.

Verbundene Konten

In diesem Bereich werden zuvor verknüpfte Konten angezeigt (sofern vorhanden).

Er erleichtert die Auswahl eines Kontos zur Überprüfung, Bearbeitung oder Löschung.

Schritte zum Abrufen der Integrationsdaten von JTL (Client ID & Client Secret)

1. Beim JTL-Bedienfeld anmelden

Öffnen Sie Ihren Webbrowser, rufen Sie die JTL-Website auf und melden Sie sich mit Ihren Kontozugangsdaten an.

2. Auf die Kontoeinstellungen oder allgemeinen Einstellungen zugreifen

Suchen Sie im Hauptbedienfeld nach einer Option wie Einstellungen oder Konfiguration und klicken Sie darauf.

3. Den Bereich API, Integrationen oder Apps finden

Suchen Sie auf der Einstellungsseite den Bereich für externe Integrationen, üblicherweise bezeichnet als:

• API-Zugriff
• Integrationen
• Apps oder Entwickler-Apps

4. Eine neue App erstellen oder neue API-Schlüssel generieren

Klicken Sie auf die Schaltfläche, um eine neue App zu erstellen oder API-Zugangsdaten zu generieren.

Möglicherweise müssen Sie Folgendes angeben:

• App-Name
• Beschreibung
• Callback-URL (falls angefordert)

5. Client ID und Client Secret erhalten

Nach der Erstellung sehen Sie:

• Client ID: Eine eindeutige Nummer oder Zeichenfolge, die die Anwendung repräsentiert.
• Client Secret: Der geheime Schlüssel, der mit der Client ID verknüpft ist.

Kopieren und speichern Sie beide sicher.

6. Die Daten auf der Integrationsseite Ihres Systems eingeben

1. Gehen Sie zur Seite Kontenintegration in Ihrem System.
2. Wählen Sie JTL aus den verfügbaren Systemen.
3. Geben Sie die Client ID und das Client Secret in die entsprechenden Felder ein.
4. Geben Sie einen Kontonamen zur einfachen Identifizierung ein.

Dieser Bereich erleichtert die Verbindung Ihres Systems mit Ihrem MediaMarkt-Marketplace-Konto, um die Synchronisierung von Produkten, Bestellungen, die Bestandsverwaltung und zugehörige Integrationsvorgänge zu ermöglichen.

Position im System

Greifen Sie über folgenden Pfad auf diese Funktion zu:

Seitenleiste → Konten → Kontenintegration

Wählen Sie anschließend MediaMarkt aus dem Dropdown-Menü Auswählen.

Kontoeinstellungen

Füllen Sie auf der rechten Seite die folgenden Felder aus, um ein MediaMarkt-Konto hinzuzufügen:

Steuerungsschaltflächen

• Neues Konto hinzufügen: Grüne Schaltfläche zum Speichern eines neuen MediaMarkt-Kontos nach Eingabe der erforderlichen Angaben.

• Konto löschen: Entfernt das ausgewählte Konto aus Ihrer Kontenliste.

Verbundene Konten

Auf der linken Seite werden alle zuvor hinzugefügten MediaMarkt-Konten angezeigt. Wählen Sie ein beliebiges Konto zur Bearbeitung oder Löschung aus.

Allgemeine Schritte zum Abrufen der Integrationsdaten

1. Beim MediaMarkt-Seller-Dashboard (Mirakl-Backend) anmelden

   • Öffnen Sie Ihren Browser und navigieren Sie zu: https://mediamarktsaturn.mirakl.net/login

2. Mit Ihren Verkäuferkonto-Zugangsdaten anmelden

   • Geben Sie Ihren Benutzernamen und Ihr Passwort ein

3. Zu den Kontoeinstellungen oder Ihrem Profil gehen

   • Suchen Sie den Bereich API oder API-Schlüssel

4. Einen neuen API-Schlüssel erstellen oder einen vorhandenen kopieren

   • Klicken Sie auf API-Schlüssel generieren, falls Sie noch keinen haben
   • Kopieren Sie einen vorhandenen Schlüssel, sofern verfügbar

5. Die Basis-URL für die MediaMarkt-Plattform notieren

   • Die Basis-URL ist üblicherweise der Mirakl-API-Endpunkt: https://mediamarktsaturn.mirakl.net/api

6. Die Basis-URL und den API-Schlüssel (Token) in Ihrem System verwenden

   • Navigieren Sie in Ihrem System zu Kontenintegration
   • Wählen Sie MediaMarkt aus dem Dropdown-Menü
   • Geben Sie einen passenden Kontonamen ein
   • Geben Sie die Basis-URL ein
   • Geben Sie den kopierten API-Schlüssel (Token) ein

7. Die Daten speichern und die Integration aktivieren

   • Klicken Sie auf Neues Konto hinzufügen, um die Einrichtung abzuschließen
   • Ihr System kann nun Bestellungen abrufen, Produkte aktualisieren und Integrationsaufgaben ausführen

Die Funktion Kontenintegration ermöglicht es Ihnen, Ihr Galaxus-Konto mit dem System zu verbinden, sodass Sie Daten verwalten, Bestellungen abrufen und Informationen automatisch aktualisieren können, indem Sie Ihre Zugangsdaten für die Kontenintegration eingeben.

Integrationsschritte

1. Auf den Bereich Kontenintegration zugreifen: Wählen Sie in der Seitenleiste Konten aus.
2. Galaxus aus dem Dropdown-Menü auswählen: Wählen Sie im Dropdown-Menü Auswählen die Option Galaxus.

Kontodetails ausfüllen

• Kontoname: Geben Sie einen Namen für das Konto ein, unter dem es im System identifiziert werden soll (z. B. Mein Galaxus-Konto).
• Client ID: Geben Sie den Client-Identifikator Ihres Galaxus-Kontos ein.
• Client Secret: Geben Sie das Client Secret ein, das mit Ihrem Galaxus-Konto verknüpft ist.

Konto speichern

Klicken Sie nach der Eingabe der Details auf die Schaltfläche Speichern oder Hinzufügen bestätigen (je nach Systemoberfläche).

• Grüne Schaltfläche zum Hinzufügen eines neuen Kontos

Konto löschen

1. Wählen Sie ein Konto im Feld Verbundene Konten aus.
2. Klicken Sie auf die Schaltfläche Konto löschen.
3. Bestätigen Sie die Löschung.

Verbundene Konten

Auf der linken Seite erscheint ein Feld, das alle Galaxus-Konten anzeigt, die zuvor mit dem System verknüpft wurden. Wenn Sie ein beliebiges Konto aus der Liste auswählen, werden seine Details im Bereich Kontoeinstellungen angezeigt.

Galaxus-API-Zugangsdaten – So erhalten Sie die Integrationsschlüssel

1. Bei Ihrem Galaxus-Konto anmelden

1. Öffnen Sie die Galaxus-Website.
2. Melden Sie sich bei dem Konto an, das Sie mit dem System verbinden möchten.
3. Gehen Sie zur Seite API-Einstellungen.

Nach der Anmeldung:

Navigieren Sie über das Hauptmenü zu: Einstellungen → Entwicklereinstellungen → API-Schlüssel / Integrationen

2. Einen neuen API-Schlüssel erstellen

Falls Sie noch keinen vorhandenen Schlüssel haben:

1. Klicken Sie auf die Schaltfläche: API-Schlüssel erstellen oder Zugangsdaten generieren
2. Es erscheint ein Formular mit:
   • App-Name / Integrationsname → Geben Sie einen Identifikator ein, wie zum Beispiel:
     • TecSee Integration
     • Store Sync
   • Berechtigungen → Wählen Sie die Berechtigungen aus, die Ihr System benötigt (z. B. Produkte – Bestellungen – Bestand).
3. Klicken Sie auf Speichern / Generieren

Odoo über die Kontenintegration verbinden

Die Seite Kontenintegration ermöglicht es Ihnen, AdlerDo mit einem oder mehreren Odoo-Konten zu verknüpfen und diese über eine einfache, übersichtliche und sichere Oberfläche zu verwalten. Sobald die Verbindung hergestellt ist, kann AdlerDo direkt mit Ihrem Odoo-System kommunizieren, um Produkte, Bestände, Bestellungen und betriebliche Daten zu synchronisieren.

Überblick über die Odoo-Integration

Die Verbindung von Odoo mit AdlerDo zentralisiert die Marktplatz- und Shop-Vorgänge innerhalb von Odoo.

Wesentliche Vorteile:

• Zentralisierung von Marktplatz- und Shop-Daten innerhalb von Odoo
• Automatisierung der Synchronisierung von Produkten, Beständen und Bestellungen
• Verwaltung mehrerer Odoo-Instanzen über eine einzige Oberfläche
• Reduzierung manueller Vorgänge und Integrationsfehler

Diese Integration gewährleistet einen stabilen und skalierbaren Datenfluss mit minimalem manuellem Eingriff.

• Datenzentralisierung
• Automatisierte Synchronisierung
• Steuerung mehrerer Instanzen

Auf die Seite Kontenintegration zugreifen

Wählen Sie im Menü der linken Seitenleiste Konten aus

Es erscheint der Bildschirm Verwaltung der Integrationskonten, der alle Kontoverbindungen und Einstellungen anzeigt.

Das zu verbindende System auswählen

Im oberen Bereich der Seite finden Sie ein Dropdown-Feld mit der Bezeichnung:

Auswählen

Verwenden Sie oben das Dropdown-Feld Auswählen, um ein System zu wählen. Wählen Sie Odoo, um mit der Einrichtung zu beginnen.

Konten verwalten

Neues Konto hinzufügen

• Wird verwendet, um ein neues Odoo-Konto hinzuzufügen.
• Klicken Sie nach dem Ausfüllen aller erforderlichen Felder auf Neues Konto hinzufügen, um die Verbindung zu speichern.
• Das Konto erscheint links unter Verbundene Konten.

Konto löschen

• Wird verwendet, um das aktuell ausgewählte Odoo-Konto zu löschen.
• Nach dem Löschen wird die Synchronisierung für dieses Konto sofort gestoppt.

⚠️ Das Löschen eines Kontos wirkt sich nicht auf die Daten innerhalb von Odoo aus, sondern nur auf die Verbindung.

Kontoeinstellungen (Odoo)

Beim Hinzufügen oder Bearbeiten eines Kontos erscheinen die folgenden Felder:

Beschreibung der Felder

a. URL

Anmelde-URL Ihrer Odoo-Instanz. Beispiel:

https://yourcompany.odoo.com

b. Kontoname

Interner Name zur Identifizierung des Odoo-Kontos. Beispiel:

"Odoo – Haupt-ERP"

c. Datenbankname

Der Name der Odoo-Datenbank, mit der Sie sich verbinden möchten. Dieser ist für die Authentifizierung und den Datenzugriff erforderlich.

d. Benutzername

Benutzername oder E-Mail-Adresse eines Odoo-Benutzers mit ausreichenden Berechtigungen

e. Passwort

Das Passwort, das mit dem ausgewählten Odoo-Benutzerkonto verknüpft ist.

🔒 Diese Informationen werden sicher behandelt und ausschließlich zur Authentifizierung verwendet.

Verbundene Konten verwalten

Verbundene Konten

Der Bereich Verbundene Konten zeigt alle zuvor hinzugefügten Odoo-Konten an. Von hier aus können Sie:

• Ein Konto auswählen, um seine Einstellungen zu bearbeiten
• Ein Konto löschen, wenn es nicht mehr benötigt wird

Dies erleichtert die Verwaltung mehrerer Odoo-Datenbanken oder -Umgebungen (z. B. Produktiv- und Staging-Umgebung).

Schritte zum Abrufen der Integrationsdaten aus Odoo

Die URL ermitteln

Kopieren Sie die Anmelde-URL Ihres Odoo-Systems. Beispiel:

https://yourcompany.odoo.com

Den Datenbanknamen ermitteln

• Finden Sie den Datenbanknamen auf der Seite zur Datenbankauswahl
• Oder erfragen Sie ihn bei Ihrem Odoo-Systemadministrator

Den Benutzernamen ermitteln

Verwenden Sie den Benutzernamen oder die E-Mail-Adresse eines Odoo-Benutzers mit API-Zugriffsberechtigungen.

Das Passwort ermitteln

Verwenden Sie das Passwort, das mit dem ausgewählten Odoo-Benutzerkonto verknüpft ist.

Die Daten eingeben und speichern

1. Geben Sie alle erforderlichen Informationen auf der Seite Kontenintegration ein
2. Überprüfen Sie die Angaben auf ihre Richtigkeit
3. Klicken Sie auf Neues Konto hinzufügen, um die Verbindung zu speichern

Nach dem Speichern erscheint das Odoo-Konto unter Verbundene Konten und ist bereit für die Synchronisierung.

Bewährte Vorgehensweisen

• Verwenden Sie einen dedizierten Odoo-Benutzer für Integrationen
• Weisen Sie aus Sicherheitsgründen nur die erforderlichen Berechtigungen zu
• Verwenden Sie eindeutige Kontonamen für mehrere Datenbanken
• Aktualisieren Sie die Zugangsdaten umgehend, wenn sie in Odoo geändert werden

Tipp zu Sicherheit & Wartung: Das Einschränken von Berechtigungen und die Verwendung dedizierter Integrationsbenutzer verringern das Risiko unbefugten Zugriffs und verhindern versehentliche Störungen.

Was ist die DATEV-Integration?

Diese Integration ermöglicht es Ihnen, Rechnungen automatisch aus Odoo an Ihr DATEV-Buchhaltungssystem zu senden. Anstatt Rechnungen manuell hochzuladen, ruft das System sie aus Odoo ab, konvertiert sie in das DATEV-Format und lädt sie automatisch hoch.

Schritt 1: Ihr DATEV-Konto verbinden

Bevor Sie Rechnungen senden, müssen Sie Ihr DATEV-Konto verbinden.

1. Rufen Sie den Anmelde-Endpunkt auf, um Ihren DATEV-Anmeldelink zu erhalten
2. Öffnen Sie den Link in Ihrem Browser
3. Melden Sie sich mit Ihren DATEV-Zugangsdaten an
4. Nach erfolgreicher Anmeldung sehen Sie eine Seite mit der Meldung "Authentication Successful!"
5. Ihr DATEV-Konto ist nun verbunden

Schritt 2: Ihr Konto überprüfen

Überprüfen Sie, ob Ihr DATEV-Konto verbunden ist.

Rechnungen an DATEV senden

Nach Datumsbereich senden

• Senden Sie alle Rechnungen innerhalb eines Datumsbereichs
• Laden Sie die Rechnungen als XML oder PDF in einen Ordner herunter, um sie manuell in DATEV hochzuladen

Rechnungsstatus prüfen

Alle Rechnungen anzeigen (seitenweise)

Bedeutung der Rechnungsstatus

Umgang mit fehlgeschlagenen Rechnungen

Fehlgeschlagene Rechnungen werden automatisch bis zu dreimal erneut versucht. Wenn eine Rechnung weiterhin fehlschlägt, kann ein manuelles Eingreifen erforderlich sein.

Ihren DATEV-Token aktualisieren

Ihr DATEV-Zugriffstoken läuft in regelmäßigen Abständen ab. Das System übernimmt dies automatisch während der Hintergrundverarbeitung. Zur manuellen Aktualisierung:

Wichtig: Wenn die Token-Aktualisierung mit einem Authentifizierungsfehler fehlschlägt, müssen Sie Ihr DATEV-Konto möglicherweise erneut verbinden, indem Sie Schritt 1 wiederholen.

Kurzreferenz

• Rechnungs-XML-Vorschau abrufen – Gibt ein Dictionary aus Rechnungs-ID und Base64-kodiertem XML zurück.
• PDFs für gespeicherte Rechnungen abrufen – Wenn Rechnungen nur mit Metadaten (ohne PDF) gespeichert wurden, rufen Sie deren PDFs ab

Szenario für den Hintergrund-Upload

Die Metadaten der Rechnungen werden in der AdlerDo-Datenbank gespeichert und anschließend automatisch im Hintergrund zu DATEV hochgeladen.