Kaufland-API-Protokoll
Protokoll der API-Aufrufe an die Kaufland Seller API. Jeder Eintrag zeigt Methode, Endpunkt, Statuscode und Dauer, dazu Anfrage und Antwort. Gedacht für die Fehlersuche.
Die Protokollierung muss in der Kaufland-Einrichtung über API-Anfragen protokollieren eingeschaltet werden.
Die Einträge sind schreibgeschützt und nach laufender Nummer absteigend sortiert (neueste zuerst). Einträge, die älter als 30 Tage sind, löschen die geplanten Aufgaben bei ihrem nächsten Lauf und der nächtliche Datenschutzlauf von merchantCENTRAL.
Nur für Administratoren: Anfragen und Antworten enthalten Käuferdaten. Lesen dürfen das Protokoll nur Benutzer mit dem Berechtigungssatz ALN MCK Admin (merchantCENTRAL Kaufland-Admin); mit ALN MCK User schreiben die Kaufland-Abläufe es weiter, die Aktion API-Protokoll ist dann aber ausgeblendet.
Was nicht im Protokoll steht:
- Dateien in einer Anfrage oder Antwort – eine hochgeladene Rechnung, ein Versandetikett. An ihrer Stelle steht
(file content left out of the log). - Der Abfrageteil von Links – alles ab dem
?eines Links in Anfrage oder Antwort. Der Link einer Importdatei und der Download-Link eines Versandetiketts tragen dort ihren Zugangsschlüssel; im Protokoll steht stattdessen?(query left out of the log).
Seite öffnen
- Über die Suche: Kaufland-API-Protokoll
- Über die Kaufland-Einrichtung auf der Marktplatzkarte → Aktion Kaufland-API-Protokoll
- Über das Kaufland-Dashboard → Erweitert → API-Protokoll
Felder
| Feld | Beschreibung |
|---|---|
| Lfd. Nr. | Laufende Nummer des Protokolleintrags. |
| Protokoll-Zeitstempel | Zeitstempel des API-Aufrufs. |
| HTTP-Methode | HTTP-Methode: GET liest, POST legt an, PATCH und PUT ändern, DELETE entfernt. |
| Endpunkt | Aufgerufener API-Endpunkt (z. B. orders/…, units/…). |
| Statuscode | HTTP-Statuscode der Antwort (200 = OK, 4xx/5xx = Fehler). Grün bei Erfolg, rot sonst. |
| Erfolgreich | Ob der Aufruf erfolgreich war. Bei einer Abfrage, deren Antwort auch „gibt es nicht“ lauten kann – EAN-Suche im Katalog, Produktdatenstatus –, zählt der Status 404 als erfolgreich: Kaufland kennt die EAN bzw. die Produktdaten (noch) nicht. Solche Aufrufe setzen den Marktplatz nicht auf „Fehler“. |
| Dauer (ms) | Dauer des Aufrufs in Millisekunden. |
| Fehlermeldung | Warum der Aufruf fehlgeschlagen ist: die lesbare Meldung von Kaufland samt Feldfehlern, sonst dass keine Antwort kam, die Antwort kein JSON war oder der HTTP-Status ohne lesbare Meldung. Leer bei einem erfolgreichen Aufruf. Die vollständige Antwort zeigt Antwort anzeigen. |
Aktionen
| Aktion | Beschreibung |
|---|---|
| Anforderung anzeigen | Zeigt den gesendeten Anfragetext (JSON) des ausgewählten Eintrags, ohne darin enthaltene Dateien. |
| Antwort anzeigen | Zeigt den erhaltenen Antworttext des ausgewählten Eintrags. |
| Protokoll löschen | Löscht alle Protokolleinträge. Fragt zuerst mit ihrer Anzahl nach, Vorgabe Nein, und nennt am Ende die Anzahl der gelöschten; ist das Protokoll leer, sagt eine Meldung das. Einträge, die älter als 30 Tage sind, verschwinden auch ohne diese Aktion. |
Alle drei Aktionen stehen auch oben in der Aktionsleiste.
Fehlermeldungen von Kaufland
Lehnt Kaufland eine Anfrage ab, nennt der Titel der Meldung die Anfrage in Worten („Kaufland-Anfrage“), der Text Kauflands Antwort. Methode und Endpunkt stehen als Anfrage bei den Details – dieselben Werte wie in HTTP-Methode und Endpunkt des Protokolls. Hat Kaufland keine lesbare Meldung geschickt, verweist die Meldung auf das API-Protokoll; diesen Hinweis bekommen nur Benutzer, die das Protokoll lesen dürfen. Weitere Hinweise: Fehlerbehebung.
API-Protokoll und Aktivitätsprotokoll
Das API-Protokoll ist das technische Protokoll jeder einzelnen Anfrage und wird nur mit API-Anfragen protokollieren geschrieben. Das Aktivitätsprotokoll von merchantCENTRAL bekommt unabhängig davon einen Eintrag je Lauf:
| Lauf | Eintrag |
|---|---|
| Auftragsimport | je Storefront: importierte Aufträge und Aufträge, deren Details beim nächsten Lauf erneut gelesen werden |
| Bestandsabgleich | je Verkaufskanal: gesendete, abgelehnte und nicht mehr bei Kaufland geführte Angebote |
| Preisabgleich | je Verkaufskanal: gesendete, abgelehnte und Angebote ohne Preis |
| Versandbestätigungen | gesendete, abgelehnte und aus anderen Gründen fehlgeschlagene Versandbestätigungen |
| Rechnungsupload (UPLOAD-INVOICES) | hochgeladene und fehlgeschlagene Rechnungen, mit der letzten Fehlermeldung |
| Retouren-, Ticket- und Angebotsimport | nur bei Fehlern, je Storefront: eine Liste, die Kaufland nicht geliefert hat, oder einzelne Datensätze, die beim nächsten Lauf erneut gelesen werden |
Ein Lauf ohne Neuigkeiten hinterlässt keinen Eintrag: wenn er nichts zu tun hatte, einen Auftrag nur ein zweites Mal gelesen hat oder Kaufland ein Angebot aus demselben Grund erneut ablehnt. Lehnt Kaufland einzelne Angebote oder Versandbestätigungen ab, ist der Eintrag fehlgeschlagen, der Marktplatz bleibt aber in Ordnung. Nur ein Lauf, der Kaufland nicht erreicht, die Auftragsliste einer Storefront nicht lesen kann oder Versandbestätigungen ohne Antwort lässt, setzt den Marktplatz auf „Fehler“; der Verkaufskanal behält dann seinen letzten erfolgreichen Abgleich. Ein Lauf für einen Verkaufskanal, dessen Code keine Kaufland-Storefront ist, gilt ebenfalls nicht als erfolgreich, siehe Storefront und Verkaufskanal.