Prepojenie s Kaufland API: technická dokumentácia

Prepojenie Kľúče, podpis, trhoviská a synchronizácia.
Objednávky Odoslanie, storno, vrátenie peňazí, vrátenia tovaru a faktúry.
Ponuky Založenie, zmeny, vymazanie a cenové pravidlá.
Produktové údaje Podľa jazyka, s kategóriami, atribútmi a obrázkami.
Tikety Čítanie, odpovede, založenie a uzavretie.
Reporty Desať reportov Kauflandu, načítaných denne.
API Sellgripu Zásoby a produktové údaje z vášho systému.
Popri inom softvéri Čo Sellgrip len číta, čo zapisuje, núdzové zastavenie a protokol.

Prepojenie

Sellgrip pracuje s vašimi vlastnými kľúčmi pre Kaufland Seller API. Každá zmena, ktorú Sellgrip urobí, je volanie API.

Prístup	Vaše vlastné kľúče pre Kaufland Seller API: Client Key a Secret Key zo Seller Portalu. Zadáte ich v dashboarde Sellgripu.
Overenie	Každá požiadavka je podpísaná pomocou HMAC so Secret Key.
User agent	`Sellgrip/1.0.0 (+https://sellgrip.com)`
Trhoviská	DE, AT, CZ, SK, PL, FR, IT, ES a NL. Pozrite všetkých deväť krajín.
Meny	Ceny v mene daného trhoviska: EUR, CZK alebo PLN. Na prepočty sa používajú kurzy Európskej centrálnej banky.
Synchronizácia	Nová objednávka hneď, ako príde push notifikácia od Kauflandu. Všetky objednávky z každého trhoviska pre istotu každých 15 minút. Sklady, skupiny dopravy a reporty denne, strom kategórií týždenne.
Push notifikácie	Sellgrip ich prihlási pri prepojení: `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á zmena ide cez API. Sellgrip nepoužíva súbory ORDER-Command.
API kľúče	Zašifrované pomocou AES-256-GCM. Po zadaní sa už nezobrazujú a vymažeme ich, keď prepojenie zrušíte alebo vymažete svoj účet.
Umiestnenie údajov	Iba v dátových centrách v Európskej únii. Spracúvanie upravuje sprostredkovateľská zmluva podľa čl. 28 GDPR.

Objednávky

Sellgrip číta vaše objednávky z každého trhoviska a každú zmenu zapisuje späť cez API.

Čo Sellgrip robí	Kaufland Seller API
Čítanie novej objednávky hneď, ako príde push notifikácia od Kauflandu. Čítanie všetkých objednávok a položiek objednávok z každého trhoviska pre istotu každých 15 minút.	`GET /order-units` `GET /orders`
Označenie ako odoslané s prepravcom a číslom zásielky. Prepravcovia pochádzajú zo zoznamu Kauflandu.	`PATCH /order-units/{id}/send` `GET /carriers`
Viac balíkov na jednu položku objednávky.	`POST /shipments`
Označenie mnohých položiek objednávok ako odoslaných v jednom kroku.	`PATCH /order-units/{id}/send`
Prepravné štítky GLS.	`POST /shipping-labels`
Storno po položkách so všetkými dôvodmi storna od Kauflandu.	`PATCH /order-units/{id}/cancel`
Čiastočné vrátenie peňazí po položkách.	`PATCH /order-units/{id}/refund`
Čítanie, založenie a úprava vrátení tovaru.	`GET /returns` `POST /returns` `PUT /returns/{id}`
Prijatie, odmietnutie, oprava alebo objasnenie položiek vrátení.	`PATCH /return-units/{id}/accept` `PATCH /return-units/{id}/reject` `PATCH /return-units/{id}/repair` `PATCH /return-units/{id}/clarify`
Faktúry nahráte sami, alebo sa nahrajú automaticky po odoslaní.	`POST /order-invoices/{id_order}`
Fulfillment by Kaufland: Sellgrip číta aj tieto položky objednávok, vrátenia tovaru a tikety a označí ich. Odoslanie, storno, štítky a rozhodnutia o vráteniach zostávajú na Kauflande.	`GET /order-units` `GET /returns` `GET /return-units` `GET /tickets` `fulfillment_type`

Ponuky

Sellgrip posiela zmeny ponúk po jednotlivých poliach: do Kauflandu ide len to, čo sa zmenilo.

Čo Sellgrip robí	Kaufland Seller API
Založenie ponuky v každom stave tovaru, ktorý Kaufland pozná.	`POST /units`
Zmena ceny, zásoby, doby spracovania, stavu, skladu, skupiny dopravy a minimálnej ceny.	`PATCH /units/{id}` `POST /units/bulk`
Vymazanie ponuky.	`DELETE /units/{id}`
Stav ponuky s dôvodmi od Kauflandu.	`POST /units/status`
Jedna zmena pre ten istý produkt na všetkých vašich trhoviskách, s prepočtom meny.	`PATCH /units/{id}`
Cenové pravidlá: ako návrh alebo automaticky, nikdy pod vaším bodom zvratu.	`PATCH /units/{id}`
Synchronizácia zásob z nahraného CSV alebo z https feedu, v intervale od 15 minút do 24 hodín, s rezervou pre celý účet alebo pre jednotlivé položky.	`PATCH /units/{id}` `POST /units/bulk`
Sklady a skupiny dopravy, načítané denne.	`GET /warehouses` `GET /shipping-groups`

Produktové údaje

Sellgrip zapisuje produktové údaje podľa jazyka a trhoviska a vedľa nich ukazuje spätnú väzbu Kauflandu.

Čo Sellgrip robí	Kaufland Seller API
Zápis produktových údajov podľa jazyka a trhoviska.	`PUT /product-data` `PATCH /product-data`
Stav a spätná väzba Kauflandu pre každý EAN, aj z reportov `invalid-items` a `product-data-changes`.	`GET /product-data/status/{ean}`
Výber kategórie z kategórií Kauflandu. Strom kategórií sa načítava týždenne.	`POST /categories/decide` `GET /categories` `GET /categories/tree`
Povinné atribúty sú označené. Ďalšie atribúty Kauflandu pridáte podľa názvu.	`GET /attributes/search` `GET /attributes/by-name/{name}`
Viac obrázkov na produkt a na trhovisko.	`PATCH /product-data`
Voliteľne: automatické prevzatie jazykovo neutrálnych hodnôt do vašich ďalších jazykov.	`PATCH /product-data`
Import z CSV alebo z feedu, každú hodinu alebo denne, s priradením stĺpcov k atribútom. Odosielajú sa len zmenené riadky.	`PATCH /product-data`
Nový EAN: najprv založenie produktových údajov, potom vystavenie ponuky.	`PUT /product-data` `POST /units`

Tikety

Zákaznícky servis na Kauflande beží cez tikety. Sellgrip ich číta a vybavuje cez API.

Čo Sellgrip robí	Kaufland Seller API
Čítanie tiketov a správ s dôvodom a témou. Prílohy od Kauflandu si môžete stiahnuť.	`GET /tickets` `GET /tickets/{id}`
Odpoveď s prílohami.	`POST /tickets/{id}/messages`
Založenie tiketu z objednávky.	`POST /tickets`
Uzavretie tiketu.	`PATCH /tickets/{id}/close`

Reporty

Tieto reporty Kauflandu Sellgrip načítava raz denne:

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 alebo ERP posiela zásoby a produktové údaje do Sellgripu, len čo sa zmenia. Sellgrip ich hneď odovzdá Kauflandu; API Sellgripu je súčasťou tarifu Business.

Čo urobíte	API Sellgripu
Kľúč vytvoríte v Nastaveniach › Kľúče API: iba vlastník, s potvrdením heslom. Oprávnenia `stock:write` a `product-data:write`, platnosť do zrušenia, 90 dní alebo jeden rok. Sellgrip kľúč ukáže iba raz; každé volanie ho posiela v hlavičke.	`Authorization: Bearer sgk_…`
Test kľúča: odpoveď uvedie váš účet a oprávnenia kľúča.	`GET /api/v1/ping`
Odoslanie zásob ako JSON alebo CSV, až 1 000 položiek na volanie. Sellgrip ich ešte pred odpoveďou zapíše do Kauflandu cez `POST /units/bulk` a podrží vašu rezervu.	`POST /api/v1/stock`
Odoslanie produktových údajov podľa EAN a jazyka, až 100 položiek na volanie, kontrolovaných podľa rovnakých pravidiel ako formulár Produktové údaje. Prvých 20 ide do Kauflandu pred odpoveďou, zvyšok v ďalších kolách po 15 minútach.	`POST /api/v1/product-data`
Stav položky: vo fronte, odoslané alebo odmietnuté s hlásením Kauflandu, k tomu posledný stav, ktorý Kaufland nahlásil.	`GET /api/v1/product-data/{ean}`
Čítanie pre AI asistentov: s kľúčom s oprávnením `read` si Claude Desktop, Claude Code a ďalší klienti MCP zistia úlohy, zisk, objednávky, Buy Box a príležitosti. Prístup iba číta. Viac na stránke AI asistenti.	`POST /api/v1/mcp`

Kľúče API v Sellgripe: kľúče s oprávneniami, posledným použitím a platnosťou.

Popri inom softvéri

Ak už používate integrátor alebo repricer, zvoľte pre každé pole jeden zdroj. Tu vidíte, čo Sellgrip len číta a kedy zapisuje.

Len čítanie	Reporty, zaúčtovania, výplaty, sklady, skupiny dopravy, kategórie a príležitosti od Kauflandu. Na nich Sellgrip nič nemení.
Na vaše kliknutie	Odoslanie, storno, refundácia, vrátenia, tikety, zľavové kupóny, ponuky a produktové údaje. Sellgrip odošle až po vašom potvrdení v dashboarde.
Ceny automaticky	Len keď zapnete automatický režim cenových pravidiel a produkt nastavíte na Automaticky. Ak cenu zmenil iný nástroj alebo Smart Pricing, Sellgrip nič neodošle a vráti produkt na Kliknutím.
Cenové limity	Nikdy pod bodom zvratu, najviac 5 % na zmenu a 15 % za deň, oboje sa dá nastaviť. Po troch chybách za sebou sa automatický režim vypne.
Zásoby automaticky	Len keď zapnete synchronizáciu zásob so svojím zoznamom alebo feedom. Ak zoznam vyzerá chybne, napríklad priveľa núl alebo priveľa zmien naraz, Sellgrip nič neodošle.
Produktové údaje automaticky	Len keď zapnete importný feed. Sellgrip potom odošle len riadky, ktoré sa zmenili.
Faktúry automaticky	Len keď zapnete automatické nahrávanie, pre objednávky od tej chvíle. Ak už Kaufland k objednávke faktúru má, od kohokoľvek, Sellgrip žiadnu nenahrá.
API Sellgripu	Váš vlastný systém posiela zásoby a produktové údaje s kľúčom, ktorý si sami vytvoríte. Bez platného kľúča nič neprejde.
Jedno pole, jeden zdroj	Ak ceny alebo zásoby už nastavuje iný nástroj, nechajte túto automatiku v Sellgripe vypnutú. Bez automatiky Sellgrip zapisuje len na váš pokyn.
Núdzové zastavenie	Dole na stránke Cenové pravidlá. Okamžite zastaví cenové pravidlá, synchronizáciu zásob, import produktových údajov a zmeny cez API Sellgripu, kým ho nezrušíte. Čo sami zmeníte v Ponukách, akcie pri objednávkach a tiketoch a automatické faktúry bežia ďalej.
Protokol	V Nastaveniach › Protokol je všetko, čo váš účet odoslal Kauflandu, s časom a výsledkom. Automatické ceny sú navyše v histórii cenových pravidiel.

Prepojte svoj obchod na Kauflande

Obchod prepojíte sami v dashboarde dvoma kľúčmi zo Seller Portalu. Potom sa spustí prvá synchronizácia, zadarmo v každom tarife.

Vytvoriť účet zadarmo Kontaktujte nás

Prepojenie s Kaufland Seller API