Kaufland-Schnittstelle: technische Dokumentation

Verbindung Schlüssel, Signatur, Marktplätze und Abgleich.
Bestellungen Versand, Storno, Erstattung, Retouren und Rechnungen.
Angebote Anlegen, ändern, löschen und Preisregeln.
Produktdaten Je Sprache, mit Kategorien, Merkmalen und Bildern.
Tickets Lesen, antworten, eröffnen und schließen.
Reports Zehn Kaufland-Reports, täglich gelesen.
Sellgrip-API Bestand und Produktdaten aus Ihrem System.
Neben anderer Software Was Sellgrip nur liest, was es schreibt, Notaus und Protokoll.

Verbindung

Jede Änderung, die Sellgrip vornimmt, ist eine API-Anfrage.

Zugang	Ihre eigenen Schlüssel für die Kaufland Seller API: Client-Key und Secret-Key aus dem Seller Portal. Sie geben sie im Sellgrip-Dashboard ein.
Authentifizierung	Jede Anfrage wird mit dem Secret-Key per HMAC signiert.
User-Agent	`Sellgrip/1.0.0 (+https://sellgrip.com)`
Marktplätze	DE, AT, CZ, SK, PL, FR, IT, ES und NL. Siehe alle neun Länder.
Währungen	Preise in der Währung des jeweiligen Marktplatzes: EUR, CZK oder PLN. Umgerechnet wird mit den Wechselkursen der Europäischen Zentralbank.
Synchronisierung	Eine neue Bestellung, sobald die Push-Benachrichtigung von Kaufland eintrifft. Alle Bestellungen je Marktplatz zur Sicherheit alle 15 Minuten. Lager, Versandgruppen und Reports täglich, der Kategoriebaum wöchentlich.
Push-Benachrichtigungen	Sellgrip meldet sie beim Verbinden automatisch an: `order_new`, `order_unit_new`, `order_unit_status_changed`, `return_new`, `return_status_changed`, `return_unit_status_changed`, `item_unit_out_of_stock`, `item_unit_not_available`, `item_unit_available`, `item_unit_deleted`.
Schreibzugriffe	Jede Änderung läuft über die API. Sellgrip nutzt keine ORDER-Command-Dateien.
API-Schlüssel	Mit AES-256-GCM verschlüsselt. Nach der Eingabe nicht mehr angezeigt und gelöscht, sobald Sie die Verbindung trennen oder Ihr Konto löschen.
Speicherort	Nur in Rechenzentren in der Europäischen Union. Die Verarbeitung regelt der Auftragsverarbeitungsvertrag nach Art. 28 DSGVO.

Bestellungen

Sellgrip liest Ihre Bestellungen je Marktplatz und schreibt jede Änderung über die API zurück.

Was Sellgrip tut	Kaufland Seller API
Eine neue Bestellung lesen, sobald die Push-Benachrichtigung von Kaufland eintrifft. Alle Bestellungen und Bestellpositionen je Marktplatz zur Sicherheit alle 15 Minuten lesen.	`GET /order-units` `GET /orders`
Als versendet melden, mit Versanddienstleister und Sendungsnummer. Die Versanddienstleister kommen aus Kauflands Liste.	`PATCH /order-units/{id}/send` `GET /carriers`
Mehrere Pakete je Bestellposition.	`POST /shipments`
Viele Bestellpositionen in einem Schritt als versendet melden.	`PATCH /order-units/{id}/send`
GLS-Versandetiketten.	`POST /shipping-labels`
Stornieren je Artikel, mit allen Stornogründen von Kaufland.	`PATCH /order-units/{id}/cancel`
Teilerstattung je Artikel.	`PATCH /order-units/{id}/refund`
Retouren lesen, anlegen und ändern.	`GET /returns` `POST /returns` `PUT /returns/{id}`
Retourenpositionen annehmen, ablehnen, reparieren oder klären.	`PATCH /return-units/{id}/accept` `PATCH /return-units/{id}/reject` `PATCH /return-units/{id}/repair` `PATCH /return-units/{id}/clarify`
Rechnungen selbst hochladen oder nach dem Versand automatisch hochladen lassen.	`POST /order-invoices/{id_order}`
Fulfillment by Kaufland: Sellgrip liest auch diese Bestellpositionen, Retouren und Tickets und markiert sie. Versand, Storno, Etiketten und Retourenentscheidungen bleiben bei Kaufland.	`GET /order-units` `GET /returns` `GET /return-units` `GET /tickets` `fulfillment_type`

Angebote

Sellgrip sendet Änderungen an Angeboten feldweise: Nur was sich geändert hat, geht an Kaufland.

Was Sellgrip tut	Kaufland Seller API
Angebot anlegen, in jedem Artikelzustand, den Kaufland kennt.	`POST /units`
Preis, Bestand, Bearbeitungszeit, Status, Lager, Versandgruppe und Mindestpreis ändern.	`PATCH /units/{id}` `POST /units/bulk`
Angebot löschen.	`DELETE /units/{id}`
Angebotsstatus mit Kauflands Gründen.	`POST /units/status`
Eine Änderung für dasselbe Produkt auf allen Ihren Marktplätzen übernehmen, mit Währungsumrechnung.	`PATCH /units/{id}`
Preisregeln: als Vorschlag oder automatisch, nie unter Ihrem Break-even.	`PATCH /units/{id}`
Bestandsabgleich aus einem CSV-Upload oder einem https-Feed, alle 15 Minuten bis einmal am Tag, mit Sicherheitsbestand für das ganze Konto oder je Artikel.	`PATCH /units/{id}` `POST /units/bulk`
Lager und Versandgruppen, täglich gelesen.	`GET /warehouses` `GET /shipping-groups`

Produktdaten

Sellgrip schreibt Produktdaten je Sprache und Marktplatz und zeigt Kauflands Rückmeldung daneben.

Was Sellgrip tut	Kaufland Seller API
Produktdaten je Sprache und Marktplatz schreiben.	`PUT /product-data` `PATCH /product-data`
Status und Kauflands Rückmeldung je EAN, auch aus den Reports `invalid-items` und `product-data-changes`.	`GET /product-data/status/{ean}`
Kategorie aus Kauflands Kategorien wählen. Der Kategoriebaum wird wöchentlich gelesen.	`POST /categories/decide` `GET /categories` `GET /categories/tree`
Pflichtmerkmale sind markiert. Weitere Merkmale von Kaufland fügen Sie nach Namen hinzu.	`GET /attributes/search` `GET /attributes/by-name/{name}`
Mehrere Bilder je Produkt und je Marktplatz.	`PATCH /product-data`
Optional: sprachneutrale Werte automatisch in Ihre anderen Sprachen übernehmen.	`PATCH /product-data`
Import aus CSV oder einem Feed, stündlich oder täglich, mit Zuordnung der Spalten zu Merkmalen. Nur geänderte Zeilen werden gesendet.	`PATCH /product-data`
Neue EAN: erst Produktdaten anlegen, dann das Angebot einstellen.	`PUT /product-data` `POST /units`

Tickets

Kundenservice auf Kaufland läuft über Tickets. Sellgrip liest und bearbeitet sie über die API.

Was Sellgrip tut	Kaufland Seller API
Tickets und Nachrichten lesen, mit Grund und Thema. Anhänge von Kaufland lassen sich herunterladen.	`GET /tickets` `GET /tickets/{id}`
Antworten, mit Anhängen.	`POST /tickets/{id}/messages`
Ein Ticket aus einer Bestellung eröffnen.	`POST /tickets`
Ein Ticket schließen.	`PATCH /tickets/{id}/close`

Reports

Diese Reports von Kaufland liest Sellgrip einmal am Tag:

lost-buybox
buybox-opportunity
price-competitiveness
competitors-comparer
account-listing
invalid-items
product-data-changes
bookings-new
sales-new
cancellations

Sellgrip-API

Ihr Shop, Ihre Warenwirtschaft oder Ihr ERP sendet Bestand und Produktdaten an Sellgrip, sobald sie sich ändern. Sellgrip gibt sie sofort an Kaufland weiter; die Sellgrip-API ist in Business enthalten.

Was Sie tun	Sellgrip-API
Schlüssel unter Einstellungen › API-Schlüssel anlegen: nur der Inhaber, bestätigt mit Ihrem Passwort. Berechtigungen `stock:write` und `product-data:write`, gültig bis zum Widerruf, 90 Tage oder ein Jahr. Sellgrip zeigt den Schlüssel einmal; jede Anfrage sendet ihn im Header.	`Authorization: Bearer sgk_…`
Schlüssel testen: Die Antwort nennt Ihr Konto und die Berechtigungen des Schlüssels.	`GET /api/v1/ping`
Bestand senden, als JSON oder CSV, bis 1.000 Artikel je Anfrage. Sellgrip schreibt ihn noch vor der Antwort mit `POST /units/bulk` zu Kaufland und hält Ihren Sicherheitsbestand zurück.	`POST /api/v1/stock`
Produktdaten je EAN und Sprache senden, bis 100 Artikel je Anfrage, geprüft nach denselben Regeln wie das Formular in Produktdaten. Die ersten 20 gehen vor der Antwort an Kaufland, der Rest in den nächsten Runden im 15-Minuten-Takt.	`POST /api/v1/product-data`
Stand eines Artikels abfragen: in der Warteschlange, gesendet oder abgelehnt mit Kauflands Worten, dazu der letzte Stand, den Kaufland gemeldet hat.	`GET /api/v1/product-data/{ean}`
KI-Assistenten lesen lassen: Mit einem Schlüssel mit dem Recht `read` fragen Claude Desktop, Claude Code und andere MCP-Clients Aufgaben, Gewinn, Bestellungen, Buy Box und Chancen ab. Der Zugang liest nur. Mehr unter KI-Assistenten.	`POST /api/v1/mcp`

API-Schlüssel in Sellgrip: die Schlüssel mit Berechtigungen, letzter Nutzung und Ablauf.

Neben anderer Software

Nutzen Sie schon einen Integrator oder Repricer, legen Sie für jedes Feld eine Quelle fest. Hier sehen Sie, was Sellgrip nur liest und wann es schreibt.

Nur lesen	Reports, Buchungen, Auszahlungen, Lager, Versandgruppen, Kategorien und Kauflands Chancen. Daran ändert Sellgrip nichts.
Auf Ihren Klick	Versand, Storno, Erstattung, Retouren, Tickets, Gutscheine, Angebote und Produktdaten. Sellgrip sendet erst, wenn Sie im Dashboard bestätigen.
Preise automatisch	Nur wenn Sie die Automatik der Preisregeln einschalten und ein Produkt auf „Automatisch“ stellen. Hat ein anderes Tool oder Smart Pricing den Preis geändert, sendet Sellgrip nichts und stellt das Produkt zurück auf „Per Klick“.
Preisgrenzen	Nie unter Ihrem Break-even, höchstens 5 % je Änderung und 15 % am Tag, beides einstellbar. Nach drei Fehlern nacheinander schaltet sich die Automatik aus.
Bestand automatisch	Nur wenn Sie den Bestandsabgleich mit Ihrer Liste oder Ihrem Feed einschalten. Sieht die Liste falsch aus, etwa zu viele Nullen oder zu viele Änderungen auf einmal, sendet Sellgrip nichts.
Produktdaten automatisch	Nur wenn Sie den Import-Feed einschalten. Sellgrip sendet dann nur Zeilen, die sich geändert haben.
Rechnungen automatisch	Nur wenn Sie den automatischen Upload einschalten, für Bestellungen ab diesem Moment. Liegt bei Kaufland schon eine Rechnung vor, egal von wem, lädt Sellgrip keine hoch.
Sellgrip-API	Ihr eigenes System sendet Bestand und Produktdaten mit einem Schlüssel, den Sie anlegen. Ohne gültigen Schlüssel kommt nichts durch.
Ein Feld, eine Quelle	Setzt ein anderes Tool schon Preise oder Bestand, lassen Sie diese Automatik in Sellgrip aus. Ohne Automatik schreibt Sellgrip nur auf Ihren Auftrag.
Notaus	Unten auf der Seite Preisregeln. Er stoppt sofort Preisregeln, Bestandsabgleich, Produktdaten-Import und Änderungen über die Sellgrip-API, bis Sie ihn aufheben. Was Sie selbst unter Angebote ändern, Bestell- und Ticketaktionen sowie automatische Rechnungen laufen weiter.
Protokoll	Unter Einstellungen › Protokoll steht, was Ihr Konto an Kaufland gesendet hat, mit Zeit und Ergebnis. Automatische Preise stehen zusätzlich im Verlauf der Preisregeln.

Kaufland-Shop verbinden

Sie verbinden Ihren Shop selbst im Dashboard, mit zwei Schlüsseln aus dem Seller Portal. Danach startet der erste Abgleich, kostenlos in jedem Tarif.

Kostenloses Konto anlegen Kontakt aufnehmen

Anbindung an die Kaufland Seller API