Einrichtung des eBay-Konnektors

Übersicht

Mit dem eBay-Konnektor von Odoo können Sie eBay-Angebote mit Odoo-Produkten verbinden. Sobald die Verbindung hergestellt ist, können Aktualisierungen der Angebote in Odoo oder in eBay vorgenommen werden. Wenn ein Artikel bei eBay verkauft wird, werden in Odoo Entwürfe für Verkaufsaufträge erstellt, die der Benutzer überprüfen und bestätigen kann. Sobald der Verkaufsauftrag bestätigt ist, funktionieren die Apps Lager und Verkauf von Odoo standardmäßig, um Produkte aus dem Inventar zu nehmen und dem Benutzer die Möglichkeit zu geben, Rechnungen zu erstellen.

Siehe auch

Um mehr über den eBay-Konnektor zu erfahren, sehen Sie sich folgende Seiten an:

Verbunden Felder zwischen eBay - Odoo

Im Folgenden finden Sie eBay-Produktdetails. Jedes dieser eBay-Felder aktualisiert die entsprechenden Felder in Odoo.

  • eBay-URL

  • eBay-Status

  • Verkaufte Menge

  • Startdatum

  • Titel

  • Unterbezeichnung

  • Zustand des Artikels

  • Kategorie

  • Kategorie 2

  • Lagerkategorie

  • Lagerkategorie 2

  • Zahlungsrichtlinie

  • Verkäuferprofile

  • Postleitzahl

  • Versandbedingungen

  • Art des Angebots (Festpreis oder Auktion)

    • Startpreis für Auktion

    • Sofortkaufpreis

    • Fester Betrag

  • Lagerbestand verwenden

  • Anzahl auf Ebay

  • Dauer

  • „Bestes Gebot“ aktivieren

  • Privates Angebot

  • eBay-Beschreibung

  • eBay-Produktbilder

  • Land

eBay-Bedingungen

Variationen fassen mehrere Produkte zu einem einzigen zusammen, mit Optionen für Variationen (oder Varianten). Variationen können mit den Attributen und Werten von Odoo synchronisiert werden. Variationen erscheinen in Dropdown-Menüs am oberen Rand der Seite, wenn Sie ein eBay-Angebot anzeigen. Sie sind vergleichbar mit den Produktvarianten in Odoo.

Ein Beispiel auf eBay für die Variationen, die zu einem Produkt hinzugefügt werden können.

Die Artikelspezifikationen, die sich am Ende des Angebots befinden, enthalten produktspezifische Informationen. Diese Angaben werden nicht standardmäßig mit Odoo-Feldern synchronisiert. Um diese Felder zu verknüpfen, ist eine Entwicklung erforderlich.

Artikelspezifikationen zu einem eBay-Produkt.

Die Begriffe Sandbox und Produktion werden verwendet, um die eBay-Umgebungen entweder als noch in der Entwicklung/Testphase befindlich (Sandbox) oder zur Verwendung in der echten Instanz der Datenbank mit echten Kundeninformationen/Datensätzen (Produktion) zu kategorisieren. Es wird empfohlen, zunächst mit der Sandbox zu beginnen, um zu testen, und dann wie unten beschrieben eine Produktions-Instanz zu erstellen.

Tipp

Sie können auf die Sandbox-Umgebung von eBay zugreifen, indem Sie zum Sandbox-Portal von eBay oder https://sandbox.ebay.com/ navigieren. Auf die Produktionsumgebung von eBay können Sie zugreifen, indem Sie zum Portal von eBay.com oder https://www.ebay.com/ navigieren.

Wichtig

Die Auswahl der Umgebung muss für alle Umgebungseinstellungen bei eBay und bei Odoo während dieser Einrichtung gleich bleiben.

eBay-Aktionen in Odoo verfügbar

Im Folgenden finden Sie integrierte Aktionen in Odoo, mit denen Sie eBay-Angebote hinzufügen oder aktualisieren können:

  • Liste/ Link: Generieren Sie ein neues eBay-Angebot mit einem Odoo-Produkt, indem Sie auf Angebot auf eBay einstellen oder Mit bestehendem eBay-Angebot verknüpfen klicken.

  • Schaltfläche Artikel überarbeiten: Nachdem Sie Änderungen an einem eBay-Angebot in Odoo vorgenommen haben, speichern Sie den Datensatz und klicken dann in Odoo auf die Schaltfläche Artikel überarbeiten, um das eBay-Angebot zu aktualisieren.

  • Erneut einstellen: Wenn das Angebot eines Artikels vorzeitig beendet wurde oder auto-relist nicht ausgewählt wurde, kann ein Benutzer den Artikel in Odoo erneut einstellen. Das Startdatum wird zurückgesetzt.

  • Schaltfläche Artikelangebot beenden: Beenden Sie ein eBay-Angebot direkt von Odoo aus.

  • Link zu Produktangeboten aufheben: Benutzer können die Verknüpfung eines Produkts mit dem eBay-Angebot aufheben; das Angebot bleibt bei eBay erhalten.

Einrichtung in Odoo vor der eBay-Einrichtung erforderlich

Um eBay mit Odoo zu verbinden, installieren Sie das eBay-Modul, indem Sie zum Odoo-Dashboard navigieren und auf Apps klicken. Suchen Sie den Begriff eBay und installieren Sie das Modul eBay-Konnektor.

Die folgenden Punkte müssen konfiguriert werden, bevor Sie eBay einrichten können:

  • Erstellen und konfigurieren Sie in Odoo Produkte, die bei eBay gelistet werden sollen. eBay importiert keine neuen Produkte in Odoo. Alle Produkte müssen zunächst in Odoo erstellt und dann mit Angeboten verknüpft werden.

    • Odoo erlaubt es nicht, mehrere eBay-Angebote pro Produkt in Odoo zu verknüpfen. Wenn das Unternehmen dasselbe Produkt für mehrere Angebote verkauft, folgen Sie diesen Anweisungen:

      • Richten Sie ein Basis-Produkt ein (vermerkt im Feld Komponente der Stückliste), von dem alle eBay-Angebote abgeleitet werden sollen. Es handelt sich um ein lagerfähiges Produkt, sodass Sie einen Vorrat anlegen können. Dieses Produkt ist unten grün hervorgehoben und wird bei jedem weiteren „verlinkten“ Produkt in das Set aufgenommen.

      • Richten Sie 2+ verknüpfte Produkte ein (vermerkt im Feld Produkt der Stückliste), eines für jedes eBay-Angebot. Der Produkttyp wird durch die Buchhaltungseinstellungen des Unternehmens bestimmt, wie in der Odoo-Dokumentation erläutert. Jedes unten gelb markierte Produkt sollte einen Stücklistentyp gleich Bausatz haben und das Basisprodukt als Komponente des Sets. Wenn dieses verknüpfte eBay-Produkt verkauft wird, wird in dem erstellten Lieferauftrag das Basisprodukt anstelle des verknüpften Produkts aufgeführt.

      Einrichtung von Stücklisten mit Basisprodukt und verknüpften Produkten.

    Siehe auch

    Stückliste

  • eBay erstellt nicht automatisch Rechnungen für eBay-Bestellungen, die in Odoo übertragen werden. Legen Sie die Rechnungsstellungsrichtlinien für eBay-Produkte fest: Die Rechnungsstellungsrichtlinien legen fest, wann das Produkt in Rechnung gestellt werden kann. Da die meisten eBay-Benutzer die Zahlung einfordern, bevor das Produkt versandt wird, können Sie mit der Option „Rechnung bei Bestellung“ jeden Tag Rechnungen für eBay-Bestellungen erstellen.

  • Setzen Sie die Route Warenausgänge für das Lager auf Waren direkt liefern (1 Schritt).

    Warnung

    Wenn die Route Warenausgänge auf zwei oder drei Schritte eingestellt ist, tritt ein bekannter Fehler auf: eBay markiert Bestellungen fälschlicherweise als geliefert, wenn der Abholvorgang in Odoo bestätigt wird. Das erwartete Verhalten ist, Bestellungen als geliefert zu kennzeichnen, nachdem der Lieferauftrag bestätigt wurde. Diese falsche Kennzeichnung verhindert, dass die Sendungsverfolgungsnummern in eBay in den Lieferauftrag importiert werden können.

  • Wenn die Buchhaltungs-/Rechnungsstellungsapps installiert sind, üben Sie die Registrierung von Zahlungen und die Abstimmung von Rechnungen, die aus eBay-Bestellungen erstellt wurden, mit eingehenden eBay-Geldern.

    Siehe auch

    Bankabstimmung

  • Generieren Sie ein Token für die Benachrichtigung über die Löschung/Schließung eines Marketplace-Kontos. Um zu beginnen, gehen Sie zu Verkauf ‣ Konfiguration ‣ Einstellungen. Ändern Sie unter der Überschrift eBay den Modus auf Produktion und geben Sie zufällige Textwerte für den Zertifikatsschlüssel für Produktion ein. Klicken Sie dann auf die Schaltfläche Token generieren unter dem Abschnitt Benachrichtigungen über die Löschung/Schließung eines eBay-Marketplace-Kontos. Dieses Token wird bei der Einrichtung auf eBay für die Konfiguration der Löschungs-/Schließungsbenachrichtigungen verwendet.

Generierung eines Verifizierungstokens in Odoo.

Auf eBay einrichten

eBay-Entwicklerkonto einrichten

Um zu beginnen, erstellen Sie ein eBay-Entwicklerkonto über das eBay-Entwicklerportal. Diese Seite erfordert ein anderes Login und Passwort als das eBay-Konto, obwohl die gleiche E-Mail-Adresse für die Registrierung verwendet werden kann. Die Überprüfung zur Erstellung eines Entwicklerkontos dauert etwa 24 Stunden.

eBay-Keysets einrichten

Sobald das eBay-Entwicklerkonto erstellt ist, richten Sie eine Anwendung auf dem eBay-Entwicklerportal ein. Navigieren Sie dann zur Überschrift Hi [username] (Hallo [Benutzername) oben rechts auf dem Bildschirm und klicken Sie im Dropdown-Menü auf Application Keysets (App-Keysets). Daraufhin öffnet sich ein Pop-up-Fenster, in dem Sie aufgefordert werden, den Titel der App einzugeben (bis zu fünfzig Zeichen) und eine Entwicklungsumgebung auszuwählen (Sandbox oder Production). Diese beiden Felder erzeugen den ersten Keyset. Dieser Anwendungstitel wird erst gespeichert, wenn die Keyset erstellt ist. Klicken Sie auf Create a keyset (Keyset erstellen), um die Keyset zu erzeugen.

Warnung

Der neu erstellte Produktions-Keyset ist standardmäßig deaktiviert. Aktivieren Sie es, indem Sie die Benachrichtigungen über Kontolöschungen oder -schließungen auf dem eBay-Marketplaces abonnieren oder bei eBay eine Ausnahmegenehmigung beantragen. Sobald es aktiviert ist, kann die Datenbank 5000 Anrufe pro Tag über dieses Keyset tätigen.

Aktivierte Keyset nach Erstellung eines Keysets.

Einstellungen für Kontolöschung/Benachrichtigungen konfigurieren (Produktion)

Um Benachrichtigungen zu konfigurieren oder die Datenbank in einer Produktionsumgebung zu löschen, navigieren Sie zum eBay-Entwicklerportal. Konfigurieren Sie die Einstellungen für die Kontolöschung/Benachrichtigungen in eBay, indem Sie zu Hi [username] (Halllo [Benutzername]) oben rechts auf dem Bildschirm navigieren, dann Application Keysets gehen.

Als nächstes klicken Sie auf die Option marketplace deletion/account closure notification (Benachrichtigung über Marketplace-Löschung/Kontoschließung) unter der Spalte Production (Produktion) des Keysets. Geben Sie unter Email to notify if marketplace account deletion notification endpoint is down (E-Mail zur Benachrichtigung, wenn der Endpunkt für die Benachrichtigung über die Löschung eines Marktplace-Kontos ausgefallen ist) eine E-Mail ein. Klicken Sie auf Save (Speichern), um die E-Mail zu aktivieren.

Im Anschluss an diese Aktion geben Sie die von Odoo bereitgestellte URL für Marketplace account deletion notification endpoint (Endpunkt zur Benachrichtigung über die Löschung eines Marktplace-Kontos) ein. Diesen HTTP-Endpunkt finden Sie in Odoo unter Verkauf ‣ Konfiguration ‣ Einstellungen, im Feld Benachrichtigungen über die Löschung/Schließung eines eBay-Marketplace-Kontos.

Wenn Sie in Odoo auf die Schaltfläche Token generieren unterhalb dieses Feldes klicken, wird ein Verifizierungstoken für die eBay-Produktionsumgebung erstellt. Kopieren Sie in Odoo das neu erstellte Token und navigieren Sie zu eBay, um das Feld Verifizierungstoken auszufüllen. Klicken Sie auf Speichern, um die Liefermethode für Ereignisbenachrichtigungen zu aktivieren.

Konfiguration der Einstellungen für Kontolöschung/Benachrichtigungen in eBay.

Nachdem Sie die obigen Felder ausgefüllt haben, klicken Sie auf Testbenachrichtigung senden, um die neuen Benachrichtigungen zu testen. Fahren Sie mit dem nächsten Schritt fort, wenn das grüne Häkchen erscheint. Überprüfen Sie die obigen Einstellungen, wenn die Testbenachrichtigung nicht wie erwartet ausfällt.

Nachdem Sie die Benachrichtigungseinstellungen konfiguriert haben, kehren Sie zur Seite Application Keys (Anwendungsschlüssel) zurück, um Produktions-Keysets zu erzeugen.

Das Keyset erstellen

Wenn Sie die Benachrichtigungen erfolgreich eingerichtet haben, können Sie Produktions-Keysets erstellen, die für die restliche Odoo-Konfiguration benötigt werden. Navigieren Sie zurück zur Seite Application Keys (Anwendungsschlüssel), um ein Produktions-Keyset zu erstellen.

Der Administrator wird aufgefordert, Confirm the Primary Contact (Primären Kontakt bestätigen). Geben Sie den Kontoinhaber ein oder bestätigen Sie ihn (die Person, die rechtlich für den eBay-API-Lizenzvertrag verantwortlich ist). Füllen Sie First Name (Vorname), Last Name (Nachname), Email (E-Mail), Phone (Telefon) aus. Wählen Sie dann entweder die Optionen Individual (Einzelperson) oder Business (Unternehmen).

Bemerkung

Die angegebene E-Mail-Adresse oder Telefonnummer muss nicht mit der des Kontos übereinstimmen. eBay verwendet diese Informationen, um das Unternehmen oder die Person im Falle von Problemen mit den Benutzer-Tokens zu kontaktieren. Zusätzliche Kontakte können auf der Seite Profile & Contacts (Profil & Kontakte) bei eBay hinzugefügt werden.

Klicken Sie auf Continue to Create Keys (Mit Erstellung von Schlüsseln fortfahren`, um den Hauptkontakt zu bestätigen. Die Application Keys (Anwendungsschlüssel) werden in einem neuen Fenster angezeigt und eine E-Mail wird an das Entwicklerkonto gesendet. Eine App ID (Client ID), Dev ID und Cert ID (Client Secret) werden eingeblendet.

Die Anwendungsschlüssel werden nach der Erstellung der App in eBay ausgefüllt.

Notieren Sie sich diese Werte, da sie später in Odoo eingegeben werden müssen.

eBay-Benutzertoken erstellen

Erstellen Sie nun ein Benutzertoken in eBay, indem Sie zu Hi [username] (Hallo [Benutzername]) oben rechts auf dem Bildschirm navigieren, dann User Access Tokens (Benutzerzugrifftoken).

Generierung eins Benutzertokens auf der eBay-Entwicklerkonsole.

Wählen Sie die richtige Umgebung: Sandbox für Tests oder Production für die Live-Datenbank. Behalten Sie die gleiche Auswahl für alle Umgebungseinstellungen bei eBay und Odoo bei.

Wählen Sie als nächstes die Optionsschaltfläche mit der Bezeichnung Auth’n’Auth.

Wählen Sie Sign in to Production (Anmeldung in der Produktion) oder Sign in to Sandbox (Anmeldung in der Sandbox), um ein Benutzertoken in der gewählten Umgebung zu erhalten. Diese Schaltfläche variiert je nach der oben getroffenen Auswahl für Sandbox oder Production (Produktion).

Daraufhin erscheint ein Pop-up-Fenster mit der Aufforderung Confirm your Legal Address (Bestätigen Sie Ihre Adresse). Füllen Sie die erforderlichen Felder aus: First Name, Last Name (Vorname), Primary Email (Primäre E-Mail), Legal Address (Gesetzliche Adresse) and Account Type (Kontotyp). Wählen Sie für Account Type (Kontotyp) entweder Individual (Einzelperson) oder Business (Unternehmen). Um die Bestätigung abzuschließen, klicken Sie auf Sign in eBay to get a Token (Bei eBay anmelden, um Token zu erhalten).

Bemerkung

eBay wird sich mit dieser Person oder diesem Unternehmen in Verbindung setzen, wenn es Probleme mit den Anwendungsschlüsseln gibt. Weitere Kontakte können auf der eBay-Seite Profile & Contacts (Profil & Kontakte) hinzugefügt werden.

Der Administrator wird entweder zu einer Sandbox- oder Produktionsanmeldeseite für eBay weitergeleitet. Diese Anmeldung unterscheidet sich von der eBay-Entwicklerkonsole. Es handelt sich um das eBay-Konto, über das die Artikel verkauft werden sollen. Diese E-Mail und/oder diese Anmeldedaten kann von dem eBay-Entwicklerkonto abweichen.

Geben Sie die Email (E-Mail) oder Username (Benutzername) für das eBay-Konto ein und melden Sie sich bei dem eBay-Konto an.

Wichtig

Sollte ein zusätzlicher Benutzer für die Sandbox-Simulation benötigt werden, muss ein Testbenutzer angelegt werden. Besuchen Sie das Formular zur Sandbox-Registrierung von eBay. Detaillierte Anweisungen finden Sie auf den Hilfeseiten von eBay: Create a test Sandbox user (Erstellen Sie einen Test-Sandbox-Benutzer).

Anwendungszugriff gewähren

Nach der Anmeldung in der Produktions- oder Sandbox-Umgebung legt eBay dem Administrator eine Zustimmung vor, die ihm den Zugriff auf die eBay-Daten des Benutzers gewährt.

Wenn Sie auf Agree (Zustimmen) klicken, erlaubt eBay, das eBay-Konto mit der Application Programming Interface (API, Anwendungsschnittstelle) zu verknüpfen. Sie können diese Vereinbarung jederzeit ändern, indem Sie die eBay-Kontoeinstellungen aufrufen.

Warnung

Bei eBay gibt es eine zeitliche Abfolge zwischen der Anmeldung und der Zustimmung zu den Bedingungen für die Verknüpfung der API mit dem Konto. Sobald dies abgeschlossen ist, wird auf der Seite User Token (Benutzertoken) ein User Token (Benutzertoken) angezeigt.

Auf dem Bildschirm wird ein Benutzertoken eingeblendet. Kopieren Sie dieses Token unbedingt, da es in den nächsten Schritten zusammen mit dem Application Keyset (Anwendungs-Keyset) verwendet wird.

Generiertes Benutzertoken und API-Explorer-Link in der eBay-Entwicklerkonsole.

Wichtig

Um das Token zu erstellen, müssen Sie sich bei Ihrem eBay-Konto anmelden. Der eBay-Entwickler kann das Token auch widerrufen, indem er auf den Link Revoke a Token (Token widerrufen) klickt.

API-Explorer

Nachdem das Application Keyset (Anwendungs-Keyset) und das User Token (Benutzertoken) erstellt wurden, kann ein Test über den API-Explorer ausgeführt werden, um sicherzustellen, dass die API korrekt konfiguriert ist. Dieser Test führt eine einfache Suche unter Verwendung der API aus.

Um den API-Test zu beginnen, klicken Sie auf Get OAuth Application Token (OAuth-Anwendungstoken erhalten). Dadurch wird der Schlüssel in das Feld Token eingetragen.

Eine einfache Suchfunktion ist auf Ausführen eingestellt. Klicken Sie auf Execute (Ausführen), um den Test abzuschließen. Ein erfolgreicher Test wird mit einer Call Response (Aufrufantwort) von 200 OK mit einer entsprechenden Time (Zeit) beantwortet.

Anmeldedaten in Odoo eingeben

Die zuvor kopierten User Token (Benutzertoken) und Application Keyset (Anwendungs-Keyset) sind nun bereit, in die Odoo-Datenbank eingegeben zu werden.

Navigieren Sie zurück zu den eBay-Einstellungen in Odoo (Verkauf ‣ Konfiguration ‣ Einstellungen ‣ eBay) und fügen Sie die folgenden Anmeldedaten von eBay in die entsprechenden Felder in Odoo ein.

Plattform

Entwickler-Schlüssel/-ID

Token

App-Schlüssel/-ID

Zertifizierungsschlüssel/-ID

eBay

Entwickler-ID

Benutzer-Token

App-ID (Client-ID)

Zertifikats-ID (Client-Geheimnis)

Odoo

Entwickler-Schlüssel

Produktions-/Sandbox-Token

App-Schlüssel in Produktion/Sanbox

Zertifikatsschlüssel in Produktion/Sanbox

Wichtig

Auf das Application Keyset (Anwendungskeyset) können Sie zugreifen, indem Sie zu eBays Entwicklerportal gehen und zu Hi [username] ([Benutzername]) oben rechts auf dem Bildschirm navigieren, dann klicken Sie auf Application Keysets (Anwendungskeysets). Um zum Benutzertoken in eBay zu gelangen, navigieren Sie zu Hi [username] ([Benutzername]) oben rechts auf dem Bildschirm, dann zu User Access Tokens (Benutzerzugriffstoken) und klicken Sie auf Sign in to Sandbox (In Sandbox anmelden). Das User Token (Benutzertoken) können Sie auch aufrufen, indem Sie auf der Seite Application Keys (App-Schlüssel) auf User Tokens (Benutzertoken) klicken.

Vergewissern Sie sich, dass die Einrichtung korrekt ist, indem Sie die Zugriffsdaten in Odoo speichern. Sobald die Ersteinrichtung abgeschlossen ist, erscheint ein neuer Menü-Reiter in Produkte mit dem Namen eBay mit der Option Bei Ebay verkaufen. Lesen Sie in der Dokumentation zur Verwaltung nach, wie Sie Produkte auflisten können.

Tipp

Synchronisieren Sie Produktkategorien, indem Sie auf Produktkategorien klicken. Nach der Synchronisierung erscheint ein neuer Menüpunkt, eBay-Kategorie, mit dem Produkte konfiguriert werden können. Diese eBay-Kategorien werden aus der Odoo-Datenbank importiert und sind verfügbar, wenn Sie einen Artikel über Odoo bei eBay einstellen.

Wichtig

Wenn Produktkategorien über vier Pfade hinaus benötigt werden, müssen die Benutzer diese Pfade manuell hinzufügen. In der Vergangenheit haben Sie dazu eine Liste aller Produktkategorien mit mehr als vier Pfaden erstellt, sie manuell in das Produktkategorie-Modell in Odoo importiert und sie dann einzeln mit dem Produkt verknüpft.

Siehe auch

Jetzt, da die Einrichtung abgeschlossen ist, fahren Sie fort: