Technische documentatie
Koppeling met de Kaufland Seller API
Sellgrip werkt met je eigen sleutels voor de Kaufland Seller API. Hier zie je wat het in je shop doet en welk endpoint het daarvoor gebruikt.
- Koppeling Sleutels, ondertekening, marktplaatsen en synchronisatie.
- Bestellingen Verzenden, annuleren, terugbetalen, retouren en facturen.
- Aanbiedingen Aanmaken, wijzigen, verwijderen en prijsregels.
- Productgegevens Per taal, met categorieën, kenmerken en afbeeldingen.
- Tickets Lezen, beantwoorden, openen en sluiten.
- Rapporten Tien Kaufland-rapporten, dagelijks gelezen.
- Sellgrip-API Voorraad en productgegevens uit je eigen systeem.
- Naast andere software Wat Sellgrip alleen leest, wat het schrijft, noodstop en logboek.
Koppeling
Elke wijziging die Sellgrip doet, is een API-verzoek.
| Toegang | Je eigen sleutels voor de Kaufland Seller API: de client key en de secret key uit het Seller Portal. Je voert ze in het Sellgrip-dashboard in. |
|---|---|
| Authenticatie | Elk verzoek wordt met de secret key ondertekend via HMAC. |
| User agent | Sellgrip/1.0.0 (+https://sellgrip.com) |
| Marktplaatsen | DE, AT, CZ, SK, PL, FR, IT, ES en NL. Zie alle negen landen. |
| Valuta | Prijzen in de eigen valuta van elke marktplaats: EUR, CZK of PLN. Omrekenen gebeurt met de wisselkoersen van de Europese Centrale Bank. |
| Synchronisatie | Een nieuwe bestelling zodra de pushmelding van Kaufland binnenkomt. Alle bestellingen per marktplaats voor de zekerheid elke 15 minuten. Magazijnen, verzendgroepen en rapporten dagelijks, de categorieboom wekelijks. |
| Pushmeldingen | Sellgrip meldt deze aan zodra je koppelt: 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. |
| Schrijven | Elke wijziging gaat via de API. Sellgrip gebruikt geen ORDER-Command-bestanden. |
| API-sleutels | Versleuteld met AES-256-GCM. Na het invoeren niet meer getoond en verwijderd zodra je de koppeling verbreekt of je account verwijdert. |
| Opslaglocatie | Alleen in datacenters in de Europese Unie. De verwerking regelt de verwerkersovereenkomst volgens art. 28 AVG. |
Bestellingen
Sellgrip leest je bestellingen per marktplaats en schrijft elke wijziging via de API terug.
| Wat Sellgrip doet | Kaufland Seller API |
|---|---|
| Een nieuwe bestelling lezen zodra de pushmelding van Kaufland binnenkomt. Alle bestellingen en orderregels per marktplaats voor de zekerheid elke 15 minuten lezen. | GET /order-unitsGET /orders |
| Als verzonden melden met vervoerder en trackingnummer. De vervoerders komen uit de lijst van Kaufland. | PATCH /order-units/{id}/sendGET /carriers |
| Meerdere pakketten per orderregel. | POST /shipments |
| Veel orderregels in één stap als verzonden melden. | PATCH /order-units/{id}/send |
| GLS-verzendlabels. | POST /shipping-labels |
| Annuleren per artikel, met alle annuleringsredenen van Kaufland. | PATCH /order-units/{id}/cancel |
| Gedeeltelijk terugbetalen per artikel. | PATCH /order-units/{id}/refund |
| Retouren lezen, aanmaken en bijwerken. | GET /returnsPOST /returnsPUT /returns/{id} |
| Retourregels accepteren, afwijzen, laten repareren of verduidelijken. | PATCH /return-units/{id}/acceptPATCH /return-units/{id}/rejectPATCH /return-units/{id}/repairPATCH /return-units/{id}/clarify |
| Facturen zelf uploaden of na verzending automatisch laten uploaden. | POST /order-invoices/{id_order} |
| Fulfillment by Kaufland: Sellgrip leest ook deze orderregels, retouren en tickets en markeert ze. Verzending, annulering, labels en retourbeslissingen blijven bij Kaufland. | GET /order-unitsGET /returnsGET /return-unitsGET /ticketsfulfillment_type |
Aanbiedingen
Sellgrip stuurt wijzigingen aan aanbiedingen per veld: alleen wat veranderd is, gaat naar Kaufland.
| Wat Sellgrip doet | Kaufland Seller API |
|---|---|
| Aanbieding aanmaken, in elke conditie die Kaufland kent. | POST /units |
| Prijs, voorraad, verwerkingstijd, status, magazijn, verzendgroep en minimumprijs wijzigen. | PATCH /units/{id}POST /units/bulk |
| Aanbieding verwijderen. | DELETE /units/{id} |
| Status van de aanbieding, met de redenen van Kaufland. | POST /units/status |
| Eén wijziging voor hetzelfde product doorvoeren op al je marktplaatsen, met omrekening van de valuta. | PATCH /units/{id} |
| Prijsregels: als voorstel of automatisch, nooit onder je break-even. | PATCH /units/{id} |
| Voorraad bijwerken uit een CSV-upload of een https-feed, elke 15 minuten tot één keer per dag, met buffervoorraad voor het hele account of per artikel. | PATCH /units/{id}POST /units/bulk |
| Magazijnen en verzendgroepen, dagelijks gelezen. | GET /warehousesGET /shipping-groups |
Productgegevens
Sellgrip schrijft productgegevens per taal en marktplaats en toont de feedback van Kaufland ernaast.
| Wat Sellgrip doet | Kaufland Seller API |
|---|---|
| Productgegevens schrijven per taal en marktplaats. | PUT /product-dataPATCH /product-data |
Status en feedback van Kaufland per EAN, ook uit de rapporten invalid-items en product-data-changes. |
GET /product-data/status/{ean} |
| Een categorie kiezen uit die van Kaufland. De categorieboom wordt wekelijks gelezen. | POST /categories/decideGET /categoriesGET /categories/tree |
| Verplichte kenmerken zijn gemarkeerd. Extra kenmerken van Kaufland voeg je toe op naam. | GET /attributes/searchGET /attributes/by-name/{name} |
| Meerdere afbeeldingen per product en per marktplaats. | PATCH /product-data |
| Optioneel: taalneutrale waarden automatisch overnemen in je andere talen. | PATCH /product-data |
| Import uit CSV of een feed, elk uur of dagelijks, met kolommen gekoppeld aan kenmerken. Alleen gewijzigde regels worden verstuurd. | PATCH /product-data |
| Nieuwe EAN: eerst productgegevens aanmaken, daarna de aanbieding plaatsen. | PUT /product-dataPOST /units |
Tickets
Klantenservice op Kaufland loopt via tickets. Sellgrip leest en behandelt ze via de API.
| Wat Sellgrip doet | Kaufland Seller API |
|---|---|
| Tickets en berichten lezen, met reden en onderwerp. Bijlagen van Kaufland kun je downloaden. | GET /ticketsGET /tickets/{id} |
| Antwoorden, met bijlagen. | POST /tickets/{id}/messages |
| Een ticket openen vanuit een bestelling. | POST /tickets |
| Een ticket sluiten. | PATCH /tickets/{id}/close |
Rapporten
Deze rapporten van Kaufland leest Sellgrip één keer per dag:
lost-buyboxbuybox-opportunityprice-competitivenesscompetitors-compareraccount-listinginvalid-itemsproduct-data-changesbookings-newsales-newcancellations
Sellgrip-API
Je webshop, voorraadbeheer of ERP stuurt voorraad en productgegevens naar Sellgrip zodra ze veranderen. Sellgrip geeft ze meteen door aan Kaufland; de Sellgrip-API zit in Business.
| Wat je doet | Sellgrip-API |
|---|---|
Een sleutel aanmaken onder Instellingen › API-sleutels: alleen de eigenaar, bevestigd met je wachtwoord. Rechten stock:write en product-data:write, geldig tot intrekking, 90 dagen of een jaar. Sellgrip toont de sleutel één keer; elk verzoek stuurt hem mee in de header. |
Authorization: Bearer sgk_… |
| De sleutel testen: het antwoord noemt je account en de rechten van de sleutel. | GET /api/v1/ping |
Voorraad sturen als JSON of CSV, tot 1.000 artikelen per verzoek. Sellgrip zet hem nog vóór het antwoord met POST /units/bulk op Kaufland en houdt je buffervoorraad achter. |
POST /api/v1/stock |
| Productgegevens sturen per EAN en taal, tot 100 artikelen per verzoek, gecontroleerd met dezelfde regels als het formulier in Productgegevens. De eerste 20 gaan vóór het antwoord naar Kaufland, de rest in de volgende rondes van 15 minuten. | POST /api/v1/product-data |
| Opvragen hoe een artikel ervoor staat: in de wachtrij, verstuurd of afgewezen met de woorden van Kaufland, plus de laatste status die Kaufland meldde. | GET /api/v1/product-data/{ean} |
AI-assistenten laten lezen: met een sleutel met het recht read vragen Claude Desktop, Claude Code en andere MCP-clients taken, winst, bestellingen, Buy Box en kansen op. De toegang leest alleen. Meer bij AI-assistenten. |
POST /api/v1/mcp |


Naast andere software
Werk je al met een integrator of repricer, kies dan per veld één bron. Hier zie je wat Sellgrip alleen leest en wanneer het schrijft.
| Alleen lezen | Rapporten, boekingen, uitbetalingen, magazijnen, verzendgroepen, categorieën en de kansen van Kaufland. Daaraan verandert Sellgrip niets. |
|---|---|
| Op jouw klik | Verzenden, annuleren, terugbetalen, retouren, tickets, kortingsacties, aanbiedingen en productgegevens. Sellgrip stuurt pas iets als je het in het dashboard bevestigt. |
| Prijzen automatisch | Alleen als je de automatische modus van Prijsregels aanzet en een product op “Automatisch” zet. Heeft een andere tool of Smart Pricing de prijs gewijzigd, dan stuurt Sellgrip niets en zet het product terug op “Per klik”. |
| Prijsgrenzen | Nooit onder je break-even, hoogstens 5% per wijziging en 15% per dag, allebei instelbaar. Na drie fouten op rij zet de automatische modus zichzelf uit. |
| Voorraad automatisch | Alleen als je de voorraadsynchronisatie met je lijst of feed aanzet. Ziet de lijst er verkeerd uit, bijvoorbeeld te veel nullen of te veel wijzigingen tegelijk, dan stuurt Sellgrip niets. |
| Productgegevens automatisch | Alleen als je de importfeed aanzet. Sellgrip stuurt dan alleen regels die veranderd zijn. |
| Facturen automatisch | Alleen als je de automatische upload aanzet, voor bestellingen vanaf dat moment. Heeft Kaufland al een factuur bij de bestelling, van wie dan ook, dan uploadt Sellgrip er geen. |
| Sellgrip-API | Je eigen systeem stuurt voorraad en productgegevens met een sleutel die je zelf aanmaakt. Zonder geldige sleutel komt er niets door. |
| Eén veld, één bron | Zet een andere tool al prijzen of voorraad, laat die automatisering in Sellgrip dan uit. Zonder automatisering schrijft Sellgrip alleen op jouw opdracht. |
| Noodstop | Onderaan de pagina Prijsregels. Hij stopt meteen prijsregels, voorraadsynchronisatie, productimport en wijzigingen via de Sellgrip-API, tot je hem opheft. Wat je zelf onder Aanbiedingen wijzigt, order- en ticketacties en automatische facturen gaan door. |
| Logboek | Onder Instellingen › Logboek staat wat je account naar Kaufland heeft gestuurd, met tijd en resultaat. Automatische prijzen staan ook in de geschiedenis van Prijsregels. |
Koppel je Kaufland-shop
Je koppelt je shop zelf in het dashboard, met twee sleutels uit het Seller Portal. Daarna start de eerste synchronisatie, gratis in elk pakket.