eBay Benachrichtigungen (Webhooks)
Der Connector kann eBay-Ereignisse per Webhook in nahezu Echtzeit empfangen (Commerce Notification API) — statt ausschließlich per zeitgesteuertem Abruf. Verkäufe, Retouren, Stornos und Disputes erscheinen damit sofort in Business Central.
Zwei Seiten verwalten die Webhooks:
- eBay Notification Subscriptions — welche Ereignis-Topics abonniert sind
- eBay Notification Log — welche Benachrichtigungen empfangen und wie sie verarbeitet wurden
Seiten öffnen
- Über die Suche: eBay-Benachrichtigungsabonnements bzw. eBay-Benachrichtigungsprotokoll
- Über das eBay Dashboard → Abonnements / Benachrichtigungsprotokoll
Subscriptions
| Feld |
Beschreibung |
| Thema |
Das eBay-Ereignis (z. B. ITEM_SOLD, RETURN_CREATED, CANCELLATION_REQUESTED, PAYMENT_DISPUTE_CREATED). |
| Aktiviert |
Ob das Topic abonniert werden soll. |
| Bei eBay registriert |
Ob die Subscription bei eBay registriert ist. |
| Letzte Benachrichtigung empfangen / Anzahl Benachrichtigungen |
Letzter Eingang und Gesamtzahl empfangener Benachrichtigungen. |
| Aktion |
Beschreibung |
| Themen initialisieren |
Legt Subscription-Zeilen für alle verfügbaren Topics an. |
| Abonnements registrieren |
Registriert alle aktivierten Topics bei eBay. |
| Alle abmelden |
Entfernt alle Subscriptions bei eBay. |
Notification Log
| Feld |
Beschreibung |
| Thema / Status |
Ereignis und Verarbeitungsstatus — Grün (Processed), Rot (Failed), Grau (Ignored). |
| Empfangen am / Verarbeitet am |
Eingangs- und Verarbeitungszeitpunkt. |
| Ressourcen-ID |
eBay-Ressource (z. B. Order-ID), auf die sich das Ereignis bezieht. |
| Verarbeitungsdauer (ms) |
Verarbeitungsdauer. |
| Fehlermeldung |
Fehlermeldung bei fehlgeschlagener Verarbeitung. |
| Aktion |
Beschreibung |
| Wiederholen |
Verarbeitet eine fehlgeschlagene Benachrichtigung erneut. |
| Payload anzeigen |
Zeigt das empfangene JSON-Payload. |
| Bereinigung (>30 Tage) |
Löscht verarbeitete Log-Einträge, die älter als 30 Tage sind. |
Was lösen die Topics aus?
| Topic |
Wirkung |
ITEM_SOLD, ORDER_PAYMENT_COMPLETED |
Sofortiger Import der Bestellung. |
RETURN_CREATED, RETURN_CLOSED |
Abruf des Retourenantrags. |
CANCELLATION_REQUESTED |
Abruf des Stornierungsantrags. |
PAYMENT_DISPUTE_CREATED |
Abruf des Zahlungsstreitfalls. |
ITEM_SHIPPED |
Aktualisierung der Bestellung. |
ITEM_LISTING_STATUS_CHANGE |
Statusabgleich des betroffenen Listings. |
Einrichtung
- Im eBay Setup die Webhook-URL hinterlegen (Azure-Function-Relay, das eBay-Notifications an Business Central weiterreicht) und Webhooks aktiviert aktivieren.
- Themen initialisieren ausführen, nicht benötigte Topics deaktivieren.
- Abonnements registrieren ausführen — die Spalte Bei eBay registriert bestätigt die Registrierung.
Tipps
Webhooks und Job Queue ergänzen sich
Die zeitgesteuerten Job-Queue-Synchronisationen bleiben aktiv und dienen als Sicherheitsnetz — Webhooks beschleunigen nur den Erstabruf. Ausgefallene Benachrichtigungen holt der nächste geplante Lauf nach.