Fehlerbehebung
Häufige Meldungen des Kaufland-Connectors, ihre Ursache und was zu tun ist. Die Meldungen stehen hier so, wie Business Central sie zeigt; … steht für Nummern, Beträge oder Texte, die die Meldung einsetzt.
Erst nachsehen, dann wiederholen
- Fehler der geplanten Aufgaben stehen in Letzte Fehlermeldung der geplanten Kaufland-Aufgabe und im Aktivitätsprotokoll von merchantCENTRAL.
- Was Kaufland genau geantwortet hat, zeigt das Kaufland-API-Protokoll. Es schreibt nur mit, solange API-Anfragen protokollieren in der Kaufland-Einrichtung eingeschaltet ist: Schalten Sie es ein, wiederholen Sie die Aktion und schalten Sie es danach wieder aus.
Verbindung und Einrichtung
| Meldung | Ursache | Was tun |
|---|---|---|
| Kaufland-API-Konfiguration fehlt – Client-Schlüssel oder Geheimschlüssel ist nicht konfiguriert. | Einer der beiden Schlüssel fehlt, etwa nach Geheimschlüssel löschen oder in einem neuen Mandanten – die Schlüssel gelten je Mandant. | In der Kaufland-Einrichtung Client-Schlüssel und Geheimschlüssel eintragen, dann Verbindung testen. |
| Kaufland-Anfrage Fehlgeschlagen – Die API hat HTTP 401 … zurückgegeben. | Kaufland hat die Schlüssel abgelehnt: Tippfehler, Schlüssel im Seller Portal neu erzeugt oder widerrufen. | Schlüssel im Kaufland Seller Portal (Einstellungen → API) prüfen und neu eintragen, dann Verbindung testen. |
| HTTP 401 mit Kauflands Text shop-timestamp header is out of sync with current time | Jede Anfrage trägt die aktuelle Uhrzeit (UTC); Kaufland lehnt sie ab, wenn die Uhr des Servers zu weit abweicht. In Business Central Online kommt das praktisch nicht vor. | Aktion wiederholen. Tritt es dauerhaft auf (etwa in einem eigenen Container), die Systemuhr des Servers prüfen. |
| Kaufland-Anfrage Fehlgeschlagen – HTTP 429 | Kauflands Anfragelimit ist erreicht. Der Connector wiederholt solche Anfragen selbst; die Meldung kommt erst, wenn auch die Wiederholungen scheitern. | Einige Minuten warten. Kommt es häufig vor, die Intervalle der geplanten Aufgaben vergrößern. |
| Kaufland-Anfrage Fehlgeschlagen – HTTP 5xx, oder Kaufland hat keine lesbare Meldung geschickt | Störung bei Kaufland oder auf dem Weg dorthin. | Später wiederholen. Die vollständige Antwort zeigt das API-Protokoll. |
| Kaufland-Basis-URL nicht zulässig | Die Basis-URL zeigt auf keine Adresse der Kaufland Seller API; es wurde nichts gesendet. | Playground verwenden in der Einrichtung einmal aus- bzw. einschalten – das setzt die Basis-URL auf die Live-API oder den Playground. |
| Sie haben keine Berechtigung, die Kaufland-Einrichtung zu ändern … | Nur Benutzer mit dem Berechtigungssatz ALN MCK Admin dürfen Schlüssel eingeben oder löschen. | Einen Administrator bitten. |
| Bitte hinterlegen Sie den Secret Key, bevor Sie fortfahren. (Assistent) | Im Schritt Authentifizierung fehlt der Geheimschlüssel. | Auf das Feld Geheimschlüssel („Nicht konfiguriert“) klicken und den Schlüssel eingeben. |
Lizenz, Aktivierung und Aufgaben
| Meldung | Ursache | Was tun |
|---|---|---|
| Kaufland ist nicht lizenziert. Aktivieren Sie eine Lizenz oder die Demo in der Kaufland-Zeile der Marktplatzkarte. | Für das Modul Kaufland gibt es in diesem Mandanten weder Lizenz noch aktive Demo. Ohne Lizenz importiert und sendet der Connector nichts. | Marktplatzkarte → Zeile KAUFLAND → Lizenz bzw. Demo aktivieren. |
| Letzte Fehlermeldung einer Aufgabe: Kaufland ist nicht lizenziert. Die Aufgabe wartet … bzw. Kaufland ist in merchantCENTRAL nicht aktiviert. Die Aufgabe wartet … | Die Aufgabe ist nicht gelaufen (Letzter Laufstatus = Wartet). Das zählt nicht als Fehler. | Lizenz aktivieren bzw. Kaufland auf der Marktplatzkarte aktivieren – die Aufgabe beginnt von selbst. |
| Die Aufgabe … läuft gerade. Versuchen Sie es erneut, wenn ihr Lauf beendet ist. | Eine Aktion von Hand (Jetzt ausführen, Versandmeldungen senden, Erneut senden …) würde gleichzeitig mit der geplanten Aufgabe an denselben Daten arbeiten. | Warten, bis der Lauf beendet ist, dann erneut. |
| Eine Aufgabe läuft nicht mehr von selbst; die Spalte Aufgabenwarteschlange ist rot | Ihr Aufgabenwarteschlangenposten ist nach drei Fehlversuchen gestoppt. | Ursache in Letzte Fehlermeldung beheben, dann den Posten über Aufgabenwarteschlangenposten neu starten. |
| Zusammenfassung des Assistenten: Kaufland ist noch nicht eingeschaltet: Es braucht eine Lizenz oder die kostenlose Demo … | Die Lizenzprüfung hat abgelehnt, etwa weil die Demo-Registrierung abgebrochen wurde. Die übrigen Einstellungen sind gespeichert; die Aufgaben warten. | Lizenz bzw. Demo auf der Marktplatzkarte aktivieren und dort Aktiviert einschalten. |
Storefronts, Playground und Live
| Meldung oder Beobachtung | Ursache | Was tun |
|---|---|---|
| Die Storefront … ist nicht aktiviert. | Die Aktion gilt einer ausgeschalteten Storefront. | Storefront in der Kaufland-Storefront-Konfiguration einschalten. |
| Von einer Storefront kommen keine Aufträge, Retouren oder Tickets | Importiert wird nur von eingeschalteten Storefronts. | Storefront einschalten; ihr Verkaufskanal auf der Marktplatzkarte folgt. |
| Der Auftrag stammt von der Storefront …, die diese App noch nicht kennt. | Kaufland hat ein neues Land eröffnet, das diese Version des Connectors nicht kennt. Der Auftrag wird nicht importiert, damit er nicht einem anderen Land zugeordnet wird. | Auftrag im Kaufland Seller Portal bearbeiten; auf ein Update des Connectors achten. |
| Der Verkaufskanal … ist keine Storefront von Kaufland … | Auf der Marktplatzkarte steht ein Verkaufskanal, zu dem es keine Kaufland-Storefront gibt. | Kanal von der Marktplatzkarte entfernen oder die passende Storefront aktivieren. |
| Nach dem Kopieren einer Produktivumgebung in eine Sandbox kommen keine echten Aufträge mehr | Beim Kopieren in eine Sandbox schaltet der Connector die Einrichtung auf den Playground, damit die Kopie nicht mit dem Live-Shop arbeitet. | Gewollt. Nur wenn die Sandbox wirklich live arbeiten soll, Playground verwenden ausschalten. |
| Testaufträge können nur im Kaufland Playground angelegt werden. bzw. Ein Demo-Lagerort kann nur im Kaufland Playground angelegt werden. | Die Aktion ist für den Playground gedacht; die Einrichtung arbeitet live. | Für Tests Playground verwenden einschalten. |
Aufträge
| Meldung oder Beobachtung | Ursache | Was tun |
|---|---|---|
| Ein Auftrag steht auf Offen, ohne Verkaufsauftrag | In den ersten 15 Minuten nach dem Kauf hält Kaufland die Adresse zurück; der Käufer kann noch stornieren. | Abwarten – sobald er Zu versenden ist, entsteht der Verkaufsauftrag. |
| Die Auftragseinheit … ist bei Kaufland seit mehr als … Stunden offen. | Eine Position ist bei Kaufland noch nicht freigegeben; der Auftrag wartet auf sie, damit sie nicht im Verkaufsauftrag fehlt. | Auftrag im Kaufland Seller Portal prüfen. |
| merchantCENTRAL hält den Auftrag an: Ein Artikel des Auftrags ist unbekannt. | Zu einer EAN gibt es keinen Artikel, und auf der Marktplatzkarte ist Auftrag bei unbekanntem Artikel anhalten eingeschaltet. Der Auftrag wartet; er wird nicht verworfen. | SKU als Marktplatz-Angebot oder als SKU eines Marktplatz-Artikels zuordnen (oder dem Artikel die EAN als GTIN bzw. Barcode-Referenz geben), dann in den Marktplatz-Aufträgen Erneut importieren – oder Ohne unbekannte Artikel importieren. |
| Artikel nicht gefunden – Für die EAN … des Kaufland-Auftrags … wurde kein Artikel gefunden, daher wurde kein Verkaufsauftrag erstellt. | Zu der EAN gibt es weder einen Artikel noch eine bekannte SKU, und Auftrag bei unbekanntem Artikel anhalten ist aus. | EAN als GTIN oder Artikelreferenz des Artikels hinterlegen; der nächste Lauf legt den Verkaufsauftrag an. |
| Kaufland konnte … Aufträge nicht liefern. bzw. Kaufland hat den Auftrag … ohne seine Daten geliefert. | Kaufland hat die Details nicht ausgeliefert. | Nichts – die Aufträge stehen mit Importfehler in den Kaufland-Aufträgen und werden beim nächsten Import zuerst erneut gelesen. |
| Der Hub hat für den Kaufland-Auftrag … keinen Verkaufsauftrag erstellt. | Der zentrale Auftragsimport von merchantCENTRAL hat den Auftrag abgelehnt; der Grund steht im Aktivitätsprotokoll und in den Marktplatz-Aufträgen. | Grund beheben (Debitor, Artikel, Buchungsgruppen …); der nächste Lauf versucht es erneut. |
| Die Auftragseinheit … kann im Status … nicht storniert werden. | Nur noch nicht versendete Positionen lassen sich stornieren. | – |
| Die Auftragseinheit … kann nicht storniert werden: sie wurde bereits versendet, und ihre Versandmeldung wartet noch … | Die Lieferung ist gebucht, die Meldung noch nicht bei Kaufland. | Nicht stornieren; ggf. später eine Erstattung senden. |
Versandmeldungen
Abgelehnte und wartende Meldungen stehen mit ihrem Grund in Fehlermeldung der Kaufland-Versandmeldungen.
| Meldung | Ursache | Was tun |
|---|---|---|
| Kein Kaufland-Spediteur für den Zusteller … | Kaufland verlangt einen Spediteur aus seiner Liste; der Zusteller der Lieferung ist keinem zugeordnet. | Zusteller in der Kaufland-Zustelldienst-Zuordnung zuordnen oder in der Einrichtung einen Standardspediteur festlegen. Die Meldung geht im nächsten Lauf. |
| Kein Kaufland-Spediteur: Die Sendungsverfolgungsnummer kam ohne Zusteller. | Die Sendungsnummer wurde ohne Zusteller erfasst. | Standardspediteur festlegen oder die Sendungsnummer mit Zusteller neu erfassen. |
| Nicht gesendet: Die gebuchte Lieferung … hat keine eigene Sendungsverfolgungsnummer. | Die Nummer gehört einer anderen Lieferung; sie würde sonst doppelt gemeldet. | Sendungsnummer des Pakets an der gebuchten Lieferung erfassen. |
| Nicht gesendet: Die Verkaufszeile der Auftragseinheit … wurde gelöscht … | Ohne Verkaufszeile meldet keine Lieferung die Position. | Mit Lieferung senden am Kaufland-Auftrag melden oder die Meldung löschen. |
| Nicht gesendet: Kaufland hat die Auftragseinheit … storniert. | Die Position ist storniert; es gibt nichts zu melden. | Nichts – die Meldung entfällt. |
| Die Auftragseinheit … kann nicht als versendet gemeldet werden: Ihr Status bei Kaufland ist … | Kaufland wartet nicht (mehr) auf diese Position. Ein weiteres Paket läuft über die Sendungsverfolgung ihres Verkaufsauftrags. | Sendungsnummer am Verkaufsauftrag bzw. an der gebuchten Lieferung erfassen. |
| Die Sendungsverfolgungsnummer … passt nicht mehr in die Versandmeldung … | Die Versandmeldung einer Position nimmt nur eine begrenzte Länge an Sendungsnummern auf; diese Nummer geht nicht mit ihr hinaus. Die Meldung selbst wird gesendet. | Die Nummer an Kaufland-Versandmeldungen bzw. dem Tracking-Eintrag prüfen; ein weiteres Paket einer versendeten Position läuft über die Sendungsverfolgung ihres Verkaufsauftrags. |
| Geben Sie die Sendungsverfolgungsnummer des Pakets ein … | Kaufland verlangt sie für jeden Spediteur außer Other und Other Hauler. | Nummer eintragen. |
| Kaufland meldet, die Position sei schon versendet | Sie wurde im Kaufland Seller Portal als versendet gemeldet. | Nichts – der Connector sendet die Sendungsnummern dann als zusätzliche Pakete nach. |
Rechnungen
| Meldung | Ursache | Was tun |
|---|---|---|
| Die gebuchte Verkaufsrechnung … ist bereits bei Kaufland … | Jede Rechnung geht nur einmal zu Kaufland; ein zweiter Upload gäbe dem Käufer dieselbe Rechnung doppelt. | Nichts. |
| Der Kaufland-Auftrag … hat noch keine gebuchte Verkaufsrechnung. | – | Rechnung des Verkaufsauftrags buchen. |
| Für Verkaufsrechnungen ist kein Bericht eingerichtet … | Ohne Berichtsauswahl Verwendung Rechnung entsteht kein PDF. | Unter Berichtsauswahl – Verkauf einen Rechnungsbericht hinterlegen. |
| Die Datei … ist kein PDF-Dokument. bzw. … größer als … MB | Kaufland nimmt Rechnungen nur als PDF und nur bis zu einer Höchstgröße an. | Ein PDF wählen bzw. die Datei verkleinern. |
| Die gebuchte Verkaufsrechnung … wurde nicht für den Kaufland-Auftrag … gebucht. | Die Rechnung gehört zu einem anderen Auftrag. | Die Rechnung des richtigen Auftrags wählen. |
Angebote, Preise und Bestand
| Meldung | Ursache | Was tun |
|---|---|---|
| Kaufland erwartet die Preise der Storefront … in …, der Preis des Artikels ist aber in … | Die Verkaufspreisliste des Verkaufskanals hat die falsche Währung (CZ verkauft in CZK, PL in PLN, sonst EUR). Der Preis wird nicht gesendet. | Dem Verkaufskanal auf der Marktplatzkarte eine Preisliste in der Währung der Storefront zuordnen. merchantCENTRAL rechnet nicht um. |
| Artikel … hat in der Verkaufspreisliste des Verkaufskanals … keinen Preis … | Angebote erstellen fand keinen gültigen Preis. | Preis in der Preisliste des Kanals anlegen, dann erneut. |
| Artikel … ist nicht auf dem Verkaufskanal … von Kaufland gelistet … | Der Artikel ist für diese Storefront nicht gelistet; sein Preis wird nicht gesendet. | Artikel mit Zum Marktplatz hinzufügen diesem Verkaufskanal hinzufügen. |
| Angebot … verkauft bereits den Bestand von Artikel … auf dieser Storefront und an diesem Lagerort … | Zwei Angebote desselben Artikels am selben Lagerort würden denselben Bestand doppelt verkaufen; das zweite bekommt Menge 0. | Einem Angebot einen eigenen Lagerort geben oder das überzählige löschen. |
| Die Bestandssynchronisierung zu Kaufland ist ausgeschaltet. | Bestand automatisch synchronisieren ist in der Einrichtung aus. | Einschalten, wenn Business Central den Bestand bei Kaufland führen soll. |
| Kaufland hat die Erstellung des Angebots für EAN … ohne das Angebot beantwortet. | Das Angebot ist vermutlich angelegt, aber nicht zurückgemeldet. | Angebote aktualisieren, bevor Sie es erneut anlegen. |
| Kaufland kann den Mindestpreis eines Angebots nicht mehr entfernen … | Ein einmal gesetzter Mindestpreis lässt sich nur ändern. | Einen anderen Mindestpreis eingeben. |
| Die EAN … ist bei Kaufland … bereits für Artikel … gelistet. | Kaufland führt je EAN genau eine Produktseite; nur ein Artikel kann darunter verkauft werden. | Den anderen Artikel verwenden oder dessen Listing entfernen. |
| Artikel … hat keine GTIN. / Die EAN … ist bereits die GTIN von Artikel … / Artikel … wird unter seiner GTIN … verkauft. | Kaufland listet über die GTIN des Artikels. | GTIN auf der Artikelkarte pflegen. |
| Die EAN muss 13 oder 14 Stellen haben. / … nur Ziffern enthalten. / Die Prüfziffer der EAN ist ungültig. | Ungültige EAN. | EAN korrigieren. |
| Kaufland hat für die EAN … in … (noch) keine Produktdaten. | Die Produktseite ist noch nicht angelegt; das Angebot bleibt ausstehend. | Abwarten; ändert sich nichts, die Produktdaten erneut hochladen. |
| Fehlende Attribute: … / Abgelehnte Attribute: … | Kaufland verlangt für die Kategorie weitere Attribute. Business Central sendet nur Titel, Beschreibung, Hersteller, Kategorie und Bilder. | Attribute im Kaufland Seller Portal eintragen. |
| Der Hersteller fehlt. / Der Titel fehlt. | Pflichtangaben für den Produktdaten-Upload fehlen. | Auf der Kaufland-Produkt-Karte ergänzen. |
Retouren, Erstattungen und Gutschriften
| Meldung | Ursache | Was tun |
|---|---|---|
| Die Erstattung von … übersteigt die …, die für diese Auftragseinheit noch erstattet werden können. … die … der angenommenen Retoure erstattet Kaufland selbst. | Nach einer angenommenen Retoure erstattet Kaufland den Preis der Einheit selbst; er ist vom erstattbaren Betrag abgezogen. | Nur den Rest erstatten – oder gar nichts. |
| Die Erstattung von … übersteigt die …, die … noch erstattet werden können. | Es wurde schon (teilweise) erstattet. | Betrag verringern. |
| Erstattungen in … können nicht aus Business Central gesendet werden. | Aus Business Central gehen nur Erstattungen in EUR; CZ (CZK) und PL (PLN) nicht. | Im Kaufland Seller Portal erstatten. |
| Kaufland hat die Erstattung von … nicht bestätigt … | Kaufland hat nicht bestätigt; die Erstattung bleibt als unbestätigt stehen und zählt gegen den erstattbaren Betrag. | Im Seller Portal prüfen; hat Kaufland nicht erstattet, die Erstattung in den Kaufland-Erstattungen löschen. |
| Die Kaufland-Auftragseinheit … hat den Status …, daher kann nichts erstattet werden. | Im aktuellen Status der Position ist keine Erstattung möglich. | – |
| Business Central kennt den Betrag nicht, den der Käufer … bezahlt hat. | Der Auftrag bzw. die Retoure ist nicht aktuell. | Auftrag oder Retoure aktualisieren, dann erneut. |
| Die Kaufland-Retoure … hat keine angenommene Einheit … | Gutgeschrieben werden nur angenommene Retoureneinheiten. | Einheiten zuerst annehmen. |
| Jede angenommene Einheit der Kaufland-Retoure … steht bereits auf einer Gutschrift … | Alle angenommenen Einheiten haben schon eine Gutschrift. | Weitere Einheiten annehmen, oder eine ungebuchte Gutschrift löschen, um sie neu zu erstellen. |
| Der Kaufland-Auftrag … hat keine gebuchte Verkaufsrechnung. Die Gutschrift übernimmt Debitor und Preise aus ihr … | Ohne gebuchte Rechnung keine Gutschrift. | Rechnung des Auftrags buchen. |
Tickets
| Meldung | Ursache | Was tun |
|---|---|---|
| Ticket … kann nicht geschlossen werden, sein Status ist … | Schließen lässt sich nur ein offenes oder vom Käufer geschlossenes Ticket. | Status im Kaufland Seller Portal prüfen. |
| Kaufland konnte … Tickets nicht liefern. | Kaufland hat Tickets nicht ausgeliefert. | Nichts – sie werden beim nächsten Import zuerst erneut gelesen. |
Weitere Antworten finden Sie unter Häufige Fragen; den Weg durch die Einrichtung beschreibt Erste Schritte.