Verkäuferschutz und Veröffentlichungsjournal
Bevor der merchantCENTRAL Connector for eBay ein Angebot anlegt, ändert, veröffentlicht, beendet oder löscht, prüft er, dass er für den richtigen eBay-Verkäufer arbeitet und nur Angebote berührt, die Business Central gehören. Jeder dieser Schreibzugriffe steht im eBay-Veröffentlichungsjournal. Diese Seite erklärt die Einrichtung, die Aktionen für Administratoren und was zu tun ist, wenn der Schutz einen Schreibzugriff anhält.
Nach dem Update von Version 1.19
Konten aus 1.19 haben noch keinen verifizierten Verkäufer. Bis ein Administrator ihn verifiziert, sendet der Connector für dieses Konto keine Angebots-, Preis- oder Bestandsaktualisierungen; das eBay-Dashboard zeigt dann den Hinweis Verkäuferverifizierung erforderlich. Einmalig je Konto:
- Verkäuferidentität verifizieren.
- Quellengenerationen erfassen, damit die schon zugewiesenen Angebote ausgelistet und ihre Artikel gelöscht werden können.
Wo die Aktionen stehen
Alle Aktionen liegen auf der eBay-Einrichtung im Teil eBay-Konten und gelten für das dort ausgewählte Konto. Sie brauchen das Schreibrecht auf die eBay-Konten (Berechtigungssatz mC eBay - Admin).
| Aktion | Wirkung |
|---|---|
| Verkäuferidentität verifizieren | Prüft bei eBay, welcher Verkäufer zu den Zugangsdaten gehört, und bindet das Konto an ihn. |
| Quellengenerationen erfassen | Bindet zugewiesene Angebote, die ihren Eigentümer noch nicht nachweisen können, an den verifizierten Verkäufer. |
| Verkäuferbindung zurücksetzen | Löst die Bindung, damit ein anderer Verkäufer oder die andere eBay-Umgebung verifiziert werden kann. |
| Historie nativer Identitäten | Zeigt frühere Zuordnungen und den Ablauf für Altzuordnungen. |
| Veröffentlichungsjournal | Zeigt die Schreibzugriffe dieses Kontos, siehe Veröffentlichungsjournal. |
Verkäuferidentität verifizieren
Verkäuferidentität verifizieren fragt eBay mit den gespeicherten Zugangsdaten nach der unveränderlichen Kennung des Verkäufers. Gespeichert wird nur ein Hashwert davon, zusammen mit Konto, Firma, Mandant und Umgebung. Im Dialog eBay-Abschlussnachweis tragen Sie eine Nachweisreferenz ein und setzen Nachweis geprüft. Die Referenz dokumentiert, dass ältere Programme, die für diesen Verkäufer Angebote veröffentlicht haben, abgeschaltet sind.
- Erneutes Verifizieren desselben Verkäufers ändert nichts an den bisherigen Zuordnungen.
- Antworten die Zugangsdaten für einen anderen Verkäufer, lehnt der Connector ab und lässt alles unverändert. Dann zuerst die Bindung zurücksetzen.
- Im Simulationsmodus und mit einer Basis-URL- oder Auth-URL-Überschreibung ist keine Verifizierung möglich.
Hält der Schutz einen Schreibzugriff an, weil die Verifizierung fehlt, nennt die Fehlermeldung das Konto und bietet Verkäuferidentität verifizieren direkt an.
Neue Zugangsdaten für ein verifiziertes Konto (zum Beispiel nach einer erneuten eBay-Zustimmung) speichert der Connector nur, wenn sie nachweislich zum selben Verkäufer gehören.
Quellengenerationen erfassen
Damit ein Angebot ausgelistet und sein Business Central-Artikel gelöscht werden kann, muss die Zuordnung belegen, zu welchem Verkäufer und zu welchem Artikel sie gehört. Zuordnungen aus 1.19, Zuordnungen aus der Zeit vor der Verifizierung und Zuordnungen eines anderen Verkäufers können das nicht. Für sie gilt: kein Auslisten, und der Artikel lässt sich nicht löschen.
Quellengenerationen erfassen zählt diese Zuordnungen, fragt nach und verlangt eine Nachweisreferenz. Dann:
- prüft der Connector einmal bei eBay den Verkäufer,
- liest er jedes Angebot genau bei eBay nach: Angebots-ID, SKU, Marktplatz und eBay-Angebots-ID müssen zur Zuordnung passen,
- bindet er nur die passenden Zuordnungen an den verifizierten Verkäufer und den aktuellen Business Central-Artikel.
Bei eBay wird nichts geändert. Am Ende meldet die Aktion, wie viele Zuordnungen erfasst und wie
viele nicht nachgewiesen und unverändert geblieben sind. Nicht nachgewiesen bleibt zum Beispiel
ein Angebot, das es bei eBay nicht mehr gibt oder das inzwischen eine andere SKU trägt; gleichen
Sie dann zuerst die eBay-Angebote ab. Jeder Lauf steht mit der
Nachweisreferenz im Veröffentlichungsjournal (Methode CAPTURE).
Für ein einzelnes Angebot gibt es dieselbe Aktion als Quellengeneration erfassen auf der Seite eBay-Angebote.
Verkäuferbindung zurücksetzen
Verkäuferbindung zurücksetzen löst die Bindung des Kontos, zum Beispiel beim Wechsel von der
eBay-Sandbox in die Produktivumgebung oder nachdem das eBay-Konto neu angelegt wurde. Die Aktion
verlangt einen Grund und steht danach im Veröffentlichungsjournal (Methode RESET).
Abgelehnt wird sie, solange
- das Ergebnis eines Schreibzugriffs dieses Verkäufers unbekannt ist,
- eine Auslistung läuft oder
- die Prüfung einer Altzuordnung aussteht.
Danach sind bis zur nächsten Verifizierung alle geschützten Schreibzugriffe des Kontos angehalten. Wird derselbe Verkäufer wieder verifiziert, bleiben die erfassten Zuordnungen gültig. Für einen anderen Verkäufer oder die andere eBay-Umgebung erfassen Sie die Quellengenerationen neu.
Das Veröffentlichungsjournal
Das eBay-Veröffentlichungsjournal hält jeden geschützten Schreibzugriff fest: Konto, Marktplatz, Methode, Endpunkt, Start- und Endzeit, HTTP-Status und das Ergebnis.
| Status | Bedeutung |
|---|---|
| Ergebnis unbekannt | Der Aufruf ging an eBay, aber eine Antwort fehlt — zum Beispiel nach einem Timeout. Solange ein solcher Eintrag offen ist, sendet der Connector für diesen Verkäufer keine weiteren Schreibzugriffe. |
| Abgeschlossen | eBay hat geantwortet. Auch eine Ablehnung durch eBay ist abgeschlossen. |
| Vor Versand abgelehnt | Der Schutz hat den Aufruf angehalten, bevor etwas an eBay ging. Der Grund steht in der Fehlermeldung des auslösenden Vorgangs. |
| Mit Nachweis abgeglichen | Ein Administrator hat ein unbekanntes Ergebnis mit einem Nachweis abgeschlossen, oder es ist ein Verwaltungseintrag (RESET, CAPTURE). |
Eine fehlende Antwort auf eine reine Aktualisierung — Artikeldaten, Angebot, Preis und Bestand oder eine Variantengruppe — schließt der Connector selbst ab: Dieselbe Aktualisierung erneut zu senden ergibt denselben Stand, und dabei kann kein Angebot entstehen oder verschwinden. Der Eintrag trägt dann einen entsprechenden Hinweis, und der nächste Abgleich sendet die Daten erneut. Ergebnis unbekannt bleibt nur für Anlegen, Veröffentlichen, Beenden und Löschen eines Angebots.
Ein unbekanntes Ergebnis abgleichen
Mit Nachweis abgleichen schließt einen Eintrag mit Ergebnis unbekannt ab. Nötig sind ein Beleg von eBay, dass genau dieser Vorgang ausgeführt, abgelehnt oder storniert wurde, die Bestätigte Vorgangs-ID aus dem Journal und eine Nachweisreferenz. Dass das Angebot gerade nicht im Katalog steht, reicht als Beleg nicht. Der Abgleich ist erst möglich, wenn die Sitzung, die den Aufruf gesendet hat, beendet ist.
Was der Connector vor dem Senden prüft
- Vor jedem Schreibzugriff liest der Connector bei eBay alle Angebote der betroffenen SKU, jedes angesprochene Angebot einzeln und bei Variantengruppen die Gruppe. Jedes Angebot dieser SKU muss eine Zuordnung in Business Central haben. Sonst wird nichts gesendet.
- Vor dem Anlegen und Veröffentlichen prüft er zusätzlich den gesamten Katalog des Verkäufers bei eBay, auch die über die Trading API eingestellten Angebote. Innerhalb eines Laufs (Aufgabenwarteschlangenposten oder Sitzung) gilt diese Prüfung 30 Minuten; sie wird früher wiederholt, sobald eine andere Sitzung für denselben Verkäufer schreibt.
- Vor dem Beenden und Löschen prüft er immer den gesamten Katalog.
Angebote ohne SKU, die außerhalb von Business Central angelegt wurden, halten keinen Schreibzugriff mehr an.
Antwortet eBay während einer Auslistung nicht rechtzeitig (Timeout, Drosselung, Serverfehler), wartet die Auslistung und versucht es selbst wieder. Nach 20 Läufen eines Ziels geht sie an Sie; wiederholen Sie sie dann manuell.
Altzuordnungen klären
Eine Altzuordnung ist eine frühere Zuordnung ohne nachweisbaren Eigentümer, deren Angebot es bei eBay nicht mehr gibt. Solange sie offen ist, lässt sich der Artikel nicht löschen. Ist das Angebot noch aktiv, erfassen Sie besser die Quellengeneration und listen es normal aus.
- Auf der Seite eBay-Angebote Altidentität prüfen wählen, oder die Historie nativer Identitäten öffnen.
- Altzuordnung klären: Nachweisreferenz eintragen, das Belegdokument mit Nachweisdokument hochladen anhängen und Ursprünglichen Verkäufer und Quelle geprüft setzen.
- Der Connector prüft bei eBay, dass weder das Angebot noch die SKU noch existieren. Während dieser Prüfung (Prüfung ausstehend) sendet er für den Verkäufer keine Schreibzugriffe.
- Gelingt die Prüfung, steht die Klärung auf Abwesenheit nachgewiesen, und der Artikel lässt sich löschen. Bis dahin wird die SKU nicht wieder veröffentlicht.
Auf der Seite Klärungen von Altzuordnungen:
| Aktion | Wirkung |
|---|---|
| Rein lesende Prüfung fortsetzen | Wiederholt die Prüfung mit demselben Nachweis. |
| Klärung zurückziehen | Beendet eine Klärung mit protokolliertem Grund — zum Beispiel, weil das alte Angebot doch noch aktiv ist. Die Sperre fällt weg, der Artikel bleibt aber geschützt, bis eine neue Klärung oder eine normale Auslistung gelingt. |
Liest der Connector das Angebot später doch wieder bei eBay, steht die Klärung auf Nachweis widerlegt. Dann wird nur diese SKU nicht veröffentlicht; ziehen Sie die Klärung zurück oder klären Sie neu.
Tipps
- Verifizieren Sie ein neues Konto gleich nach der ersten eBay-Zustimmung. Ohne Verifizierung sendet der Connector keine Angebote.
- Ein offener Eintrag Ergebnis unbekannt hält alle Schreibzugriffe des Verkäufers an — auch die der anderen Länder desselben eBay-Kontos. Klären Sie ihn zuerst.
- Nach einem Wechsel des eBay-Keysets (neue Client-ID) bleiben die erfassten Zuordnungen gültig, geklärte Altzuordnungen müssen Sie aber neu nachweisen.