Zum Inhalt

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.