Propojení s Kaufland API: technická dokumentace

Propojení Klíče, podpis, tržiště a synchronizace.
Objednávky Odeslání, storno, vrácení peněz, vratky a faktury.
Nabídky Založení, změny, smazání a cenová pravidla.
Produktová data Podle jazyka, s kategoriemi, atributy a obrázky.
Tikety Čtení, odpovědi, založení a uzavření.
Reporty Deset reportů Kauflandu, načítaných denně.
API Sellgripu Zásoby a produktová data z vašeho systému.
Vedle jiného softwaru Co Sellgrip jen čte, co zapisuje, nouzový stop a protokol.

Propojení

Sellgrip pracuje s vašimi vlastními klíči pro Kaufland Seller API. Každá změna, kterou Sellgrip provede, je volání API.

Přístup	Vaše vlastní klíče pro Kaufland Seller API: Client Key a Secret Key ze Seller Portalu. Zadáte je v dashboardu Sellgripu.
Ověření	Každý požadavek je podepsán pomocí HMAC se Secret Key.
User agent	`Sellgrip/1.0.0 (+https://sellgrip.com)`
Tržiště	DE, AT, CZ, SK, PL, FR, IT, ES a NL. Viz všech devět zemí.
Měny	Ceny v měně daného tržiště: EUR, CZK nebo PLN. Pro převody se používají kurzy Evropské centrální banky.
Synchronizace	Nová objednávka hned, jak dorazí push notifikace od Kauflandu. Všechny objednávky z každého tržiště pro jistotu každých 15 minut. Sklady, skupiny dopravy a reporty denně, strom kategorií týdně.
Push notifikace	Sellgrip je přihlásí při propojení: `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`.
Zápis	Každá změna jde přes API. Sellgrip nepoužívá soubory ORDER-Command.
API klíče	Zašifrované pomocí AES-256-GCM. Po zadání se už nezobrazují a smažeme je, jakmile propojení zrušíte nebo smažete svůj účet.
Umístění dat	Pouze v datových centrech v Evropské unii. Zpracování upravuje zpracovatelská smlouva podle čl. 28 GDPR.

Objednávky

Sellgrip čte vaše objednávky z každého tržiště a každou změnu zapisuje zpět přes API.

Co Sellgrip dělá	Kaufland Seller API
Čtení nové objednávky hned, jak dorazí push notifikace od Kauflandu. Čtení všech objednávek a položek objednávek z každého tržiště pro jistotu každých 15 minut.	`GET /order-units` `GET /orders`
Označení jako odeslané s dopravcem a číslem zásilky. Dopravci pocházejí ze seznamu Kauflandu.	`PATCH /order-units/{id}/send` `GET /carriers`
Více balíků na jednu položku objednávky.	`POST /shipments`
Označení mnoha položek objednávek jako odeslaných v jednom kroku.	`PATCH /order-units/{id}/send`
Přepravní štítky GLS.	`POST /shipping-labels`
Storno po položkách se všemi důvody storna od Kauflandu.	`PATCH /order-units/{id}/cancel`
Částečné vrácení peněz po položkách.	`PATCH /order-units/{id}/refund`
Čtení, založení a úprava vratek.	`GET /returns` `POST /returns` `PUT /returns/{id}`
Přijetí, odmítnutí, oprava nebo vyjasnění položek vratek.	`PATCH /return-units/{id}/accept` `PATCH /return-units/{id}/reject` `PATCH /return-units/{id}/repair` `PATCH /return-units/{id}/clarify`
Faktury nahrajete sami, nebo se nahrají automaticky po odeslání.	`POST /order-invoices/{id_order}`
Fulfillment by Kaufland: Sellgrip čte i tyto položky objednávek, vratky a tikety a označí je. Odeslání, storno, štítky a rozhodnutí o vratkách zůstávají na Kauflandu.	`GET /order-units` `GET /returns` `GET /return-units` `GET /tickets` `fulfillment_type`

Nabídky

Sellgrip posílá změny nabídek po jednotlivých polích: do Kauflandu jde jen to, co se změnilo.

Co Sellgrip dělá	Kaufland Seller API
Založení nabídky v každém stavu zboží, který Kaufland zná.	`POST /units`
Změna ceny, zásob, doby zpracování, stavu, skladu, skupiny dopravy a minimální ceny.	`PATCH /units/{id}` `POST /units/bulk`
Smazání nabídky.	`DELETE /units/{id}`
Stav nabídky s důvody od Kauflandu.	`POST /units/status`
Jedna změna pro tentýž produkt na všech vašich tržištích, s převodem měny.	`PATCH /units/{id}`
Cenová pravidla: jako návrh nebo automaticky, nikdy pod vaším bodem zvratu.	`PATCH /units/{id}`
Synchronizace zásob z nahraného CSV nebo z https feedu, v intervalu od 15 minut do 24 hodin, s rezervou pro celý účet nebo pro jednotlivé položky.	`PATCH /units/{id}` `POST /units/bulk`
Sklady a skupiny dopravy, načítané denně.	`GET /warehouses` `GET /shipping-groups`

Produktová data

Sellgrip zapisuje produktová data podle jazyka a tržiště a vedle nich ukazuje zpětnou vazbu Kauflandu.

Co Sellgrip dělá	Kaufland Seller API
Zápis produktových dat podle jazyka a tržiště.	`PUT /product-data` `PATCH /product-data`
Stav a zpětná vazba Kauflandu pro každý EAN, také z reportů `invalid-items` a `product-data-changes`.	`GET /product-data/status/{ean}`
Výběr kategorie z kategorií Kauflandu. Strom kategorií se načítá týdně.	`POST /categories/decide` `GET /categories` `GET /categories/tree`
Povinné atributy jsou označené. Další atributy Kauflandu přidáte podle názvu.	`GET /attributes/search` `GET /attributes/by-name/{name}`
Více obrázků na produkt a na tržiště.	`PATCH /product-data`
Volitelně: automatické převzetí jazykově neutrálních hodnot do vašich dalších jazyků.	`PATCH /product-data`
Import z CSV nebo z feedu, každou hodinu nebo denně, s přiřazením sloupců k atributům. Odesílají se jen změněné řádky.	`PATCH /product-data`
Nový EAN: nejdřív založení produktových dat, pak vystavení nabídky.	`PUT /product-data` `POST /units`

Tikety

Zákaznický servis na Kauflandu běží přes tikety. Sellgrip je čte a vyřizuje přes API.

Co Sellgrip dělá	Kaufland Seller API
Čtení tiketů a zpráv s důvodem a tématem. Přílohy od Kauflandu si můžete stáhnout.	`GET /tickets` `GET /tickets/{id}`
Odpověď s přílohami.	`POST /tickets/{id}/messages`
Založení tiketu z objednávky.	`POST /tickets`
Uzavření tiketu.	`PATCH /tickets/{id}/close`

Reporty

Tyto reporty Kauflandu Sellgrip načítá jednou denně:

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

API Sellgripu

Váš e-shop, skladový systém nebo ERP posílá zásoby a produktová data do Sellgripu, jakmile se změní. Sellgrip je hned předá Kauflandu; API Sellgripu je součástí tarifu Business.

Co uděláte	API Sellgripu
Klíč vytvoříte v Nastavení › Klíče API: jen vlastník, s potvrzením heslem. Oprávnění `stock:write` a `product-data:write`, platnost do zrušení, 90 dní nebo jeden rok. Sellgrip klíč ukáže jen jednou; každé volání ho posílá v hlavičce.	`Authorization: Bearer sgk_…`
Test klíče: odpověď uvede váš účet a oprávnění klíče.	`GET /api/v1/ping`
Odeslání zásob jako JSON nebo CSV, až 1 000 položek na volání. Sellgrip je ještě před odpovědí zapíše do Kauflandu přes `POST /units/bulk` a podrží vaši rezervu.	`POST /api/v1/stock`
Odeslání produktových dat podle EAN a jazyka, až 100 položek na volání, kontrolovaných podle stejných pravidel jako formulář Produktová data. Prvních 20 jde do Kauflandu před odpovědí, zbytek v dalších kolech po 15 minutách.	`POST /api/v1/product-data`
Stav položky: ve frontě, odesláno nebo odmítnuto s hlášením Kauflandu, k tomu poslední stav, který Kaufland nahlásil.	`GET /api/v1/product-data/{ean}`
Čtení pro AI asistenty: s klíčem s oprávněním `read` si Claude Desktop, Claude Code a další klienti MCP zjistí úkoly, zisk, objednávky, Buy Box a příležitosti. Přístup jen čte. Více na stránce AI asistenti.	`POST /api/v1/mcp`

Klíče API v Sellgripu: klíče s oprávněními, posledním použitím a platností.

Vedle jiného softwaru

Pokud už používáte integrátor nebo repricer, zvolte pro každé pole jeden zdroj. Zde vidíte, co Sellgrip jen čte a kdy zapisuje.

Jen čtení	Reporty, zaúčtování, výplaty, sklady, skupiny dopravy, kategorie a příležitosti od Kauflandu. Na nich Sellgrip nic nemění.
Na vaše kliknutí	Odeslání, storno, refundace, vratky, tikety, slevové kupóny, nabídky a produktová data. Sellgrip odešle až po vašem potvrzení v dashboardu.
Ceny automaticky	Jen když zapnete automatický režim cenových pravidel a produkt nastavíte na Automaticky. Pokud cenu změnil jiný nástroj nebo Smart Pricing, Sellgrip nic neodešle a vrátí produkt na Kliknutím.
Cenové limity	Nikdy pod bodem zvratu, nejvýš 5 % za změnu a 15 % za den, obojí lze nastavit. Po třech chybách za sebou se automatický režim vypne.
Zásoby automaticky	Jen když zapnete synchronizaci zásob se svým seznamem nebo feedem. Pokud seznam vypadá chybně, třeba příliš mnoho nul nebo příliš mnoho změn najednou, Sellgrip nic neodešle.
Produktová data automaticky	Jen když zapnete importní feed. Sellgrip pak odešle jen řádky, které se změnily.
Faktury automaticky	Jen když zapnete automatické nahrávání, pro objednávky od té chvíle. Pokud už Kaufland k objednávce fakturu má, od kohokoli, Sellgrip žádnou nenahraje.
API Sellgripu	Váš vlastní systém posílá zásoby a produktová data s klíčem, který si sami vytvoříte. Bez platného klíče nic neprojde.
Jedno pole, jeden zdroj	Pokud ceny nebo zásoby už nastavuje jiný nástroj, nechte tuto automatiku v Sellgripu vypnutou. Bez automatiky Sellgrip zapisuje jen na váš pokyn.
Nouzový stop	Dole na stránce Cenová pravidla. Okamžitě zastaví cenová pravidla, synchronizaci zásob, import produktových dat a změny přes API Sellgripu, dokud ho nezrušíte. Co sami změníte v Nabídkách, akce u objednávek a tiketů a automatické faktury běží dál.
Protokol	V Nastavení › Protokol je vše, co váš účet odeslal Kauflandu, s časem a výsledkem. Automatické ceny jsou navíc v historii cenových pravidel.

Propojte svůj obchod na Kauflandu

Obchod propojíte sami v dashboardu dvěma klíči ze Seller Portalu. Pak se spustí první synchronizace, zdarma v každém tarifu.

Vytvořit účet zdarma Kontaktujte nás

Propojení s Kaufland Seller API