Integracja z Kaufland marketplace dla Kaufland.pl i innych rynków
Integracja z Kaufland łączy Twoje konto Kaufland Global Marketplace dwoma kluczami API: oferty i zamówienia trafiają do Elbuz, zatwierdzone zamówienia rezerwują towar, a ceny i stany wracają na każdy rynek — także na Kaufland.pl.
Kaufland marketplace to platforma, na której sprzedajesz w Polsce na Kaufland.pl, a przez Kaufland Global Marketplace także w Niemczech, Austrii, Czechach, na Słowacji, we Francji, Włoszech, Hiszpanii i Holandii. Integracja w Elbuz przejmuje sześć zadań, które dziś robisz ręcznie na koncie sprzedawcy Kaufland.
Oferty z Twojego katalogu
Oferty trafiają do katalogu z nazwą, opisem, producentem, EAN, ceną, stanem, kategorią i zdjęciami ze strony produktu na Kaufland. Dane produktów przechowujesz raz w katalogu produktów (PIM) i trafiają one do każdego kanału.
Kategorie, atrybuty i nowe oferty
Swoje kategorie raz łączysz z drzewem Kaufland, a atrybuty z polami wymaganymi danej kategorii. Nowe oferty łączą się po EAN z istniejącą stroną produktu Kaufland; potrzebują kodu kreskowego z co najmniej 8 cyframi i grupy wysyłkowej, a stawkę VAT ustawiasz w szablonie eksportu. Jeśli strony dla tego EAN jeszcze nie ma, a kategoria jest połączona, Elbuz wysyła do weryfikacji nazwę, opis, producenta, do 12 zdjęć i połączone atrybuty, a oferta powstaje przy następnym uruchomieniu. Gdy brakuje wartości wymaganej, dane nie wychodzą, a dziennik podaje pole; „Gotowość do publikacji” pokazuje przed eksportem pola wymagane bez połączonego atrybutu. Teksty idą w języku wybranym w „Języku opisów” szablonu.
Ceny według reguł
Każdy szablon eksportu bierze własną cenę albo liczy ją według formuły — na przykład cena bazowa plus narzut, który pokrywa prowizję Kaufland. Katalog i Twój sklep zachowują swoje ceny. Reguły narzutu.
Synchronizacja stanów
Ceny i stany wracają paczkami do 150 pozycji, a dziennik pokazuje, ile z nich przyjęto. Produkt z pustą lub zerową ceną nie jest wysyłany, a dziennik uruchomienia to odnotowuje. Stany pochodzą z Twoich magazynów i cenników hurtowni.
Zamówienia na Twojej liście
Pierwsze uruchomienie pobiera historię zamówień, kolejne — tylko zmiany. Zamówienie rezerwuje towar, gdy zatwierdzisz je w Elbuz, i zwalnia rezerwację przy statusie końcowym. Dalej obsługujesz je jak każde inne zamówienie — zobacz obsługę zamówień.
Statusy, kraje i konta
Statusy zamówień z marketplace’u łączysz z własnymi statusami w Elbuz, a dane wysyłki zostają przy zamówieniu. Rynki: Polska, Niemcy, Austria, Czechy, Słowacja, Francja, Włochy, Hiszpania i Holandia — listę podaje Twoje konto sprzedawcy. Jeden szablon na rynek, wszystkie w jednym katalogu. Stan towaru z karty produktu, nowy lub używany, trafia do oferty.
2
Kaufland API: co inaczej trzeba by zaprogramować samemu
Kaufland udostępnia sprzedawcom Seller API v2. Własna integracja wymaga programisty; w Elbuz jest gotowa, wpisujesz tylko klucze.
Podpiskażde zapytaniekażde zapytanie do Seller API jest podpisywane kluczem Secret metodą HMAC-SHA256 i ma okno czasowe — Elbuz robi to sam
Ofertyoferty i dane produktówoferta łączy się ze stroną produktu po EAN; ceny idą w groszach, zmiany paczkami do 150 pozycji
Zamówieniapozycje zamówieńAPI zwraca pozycje zamówień; Elbuz łączy je w jedno zamówienie, a po pierwszym uruchomieniu pobiera tylko zmiany
Dla programistów: Kaufland sam dokumentuje API. Sprzedawcy wystarczy szablon w Elbuz — zobacz Jak podłączyć Kaufland.
3
Jak to działa: jeden katalog, Kaufland jako kolejny kanał
Kaufland nie potrzebuje osobnej bazy produktów: bierze je z katalogu, który już prowadzisz.
Katalogprodukty, ceny i stany od dostawców i z Twojego magazynu
Szablon Kauflandwłasny wybór produktów, reguła cen i harmonogram
Synchronizacjaoferty, ceny i stany wychodzą według harmonogramu
Zamówienia wracająna tę samą listę co zamówienia ze sklepu
Demonstracja: zamówienie z Kaufland trafia do Elbuz, nowy stan sam wychodzi do innych kanałów, a etykietę tworzysz z zamówienia.
AI · Marketplace’y
AI · Magazyn
AI · Logistyka
Kaufland.pl ⇄ Elbuz ⇄ Twoje kanały
KauflandSeller PortalZamówienia
MMF7X2QMłynek do kawy ręczny Mlyn M2 · 1 szt.279,00 zł Do wysłania
MK2R9TDWysłane
Elbuz · Zamówieniawszystkie kanały
Nr 1187 Kaufland.plMłynek do kawy Mlyn M2 · 279,00 zł
StatusNowe · opłacone
Produkt
Rezerwa
Wolne
Młynek Mlyn M2
0 szt.
5 szt.
Kawiarka 6 filiżanek
0 szt.
12 szt.
Etykieta przewoźnikaNr przesyłki 4417 8531 1803
Stan w kanałach
Twój sklep5 szt.
Kaufland.pl5 szt.
Ceneo5 szt.
Efekt: zamówienie z Kaufland jest na wspólnej liście, stan jest taki sam w sklepie i na Kaufland, a etykieta gotowa.
Ekrany Elbuz: katalog, szablony eksportu i zamówienia
Te same okna obsługują każdy marketplace: karta produktu, szablony eksportu i lista zamówień.
Jedna karta produktu zasila każdy marketplaceSzablony eksportu: osobny dla każdego marketplace’u i feeduZamówienia z marketplace’ów i sklepu na jednej liście
5
Jak podłączyć Kaufland do Elbuz
Ścieżka jest taka jak w każdej integracji Elbuz: szablon, dostęp do konta sprzedawcy, sprawdzenie i harmonogram.
Kluczekopiujesz Client key i Secret key z ustawień API konta sprzedawcy Kaufland
Szablontworzysz szablon Kaufland, wklejasz oba klucze i wybierasz rynek dostępny na koncie: pl, de, at, cz, sk, fr, it, es lub nl
Sprawdzenie„Sprawdź połączenie” wysyła jedno podpisane zapytanie i zwraca nazwę rynku
Najpierw importraz pobierasz katalog z Kaufland — Elbuz zapamiętuje klucz każdej oferty
Eksportustawiasz szablon eksportu z grupą wysyłkową i stawką VAT, a potem planujesz oba szablony
Programowanie nie jest potrzebne. Zespół wsparcia bezpłatnie przeniesie dane z innego programu lub sklepu. Wszystkie marketplace’y — integracje z marketplace’ami.
6
Czego Kaufland wymaga od sprzedawców
Co serwis sprawdza, zanim Twoja pierwsza oferta zostanie opublikowana.
Przedsiębiorcapodstawowe warunkikontakt telefoniczny i e-mailowy, brak kategorii zakazanych i oficjalny kod EAN (GTIN) dla każdego produktu
VATdla każdego kanału sprzedażynumer VAT siedziby firmy plus numer OSS albo numer VAT w każdym kraju sprzedaży
Dokumentyi zwrotydokument tożsamości i wpis do CEIDG lub odpis z KRS, beneficjenci rzeczywiści, adres zwrotów w UE i numery rejestrowe opakowań, jeśli są wymagane
Wymagania ustala Kaufland i zmieniają się one z czasem — przed założeniem konta sprawdź aktualne zasady. Sprawdzone ze stroną oficjalną 30 października 2026: Kaufland Global Marketplace — rejestracja sprzedawcy.
7
Automatyzacja: co działa bez Ciebie
Szablon konfigurujesz raz, a eksport i kontrole działają dalej same. Wkraczasz tylko tam, gdzie potrzebna jest decyzja.
Kontrola przed eksportem
Przed każdym uruchomieniem Elbuz liczy, ile produktów wyjdzie i ile z nich jest dostępnych, i porównuje to z poprzednim razem. Spadek dostępności o ponad 30 %, liczby produktów o ponad 50 % albo pusty wybór dają ostrzeżenie lub zatrzymują eksport — jak ustawisz, dla wszystkich szablonów albo dla jednego.
Tylko zmienione produkty
Opcja w szablonie wysyła tylko nowe i zaktualizowane produkty: te zmienione w karcie, przez cennik lub API od ostatniej udanej wysyłki, a nie cały katalog za każdym razem.
Stan wolny
Jeśli prowadzisz ewidencję magazynową, w ustawieniach włączasz eksport stanu wolnego: platforma dostaje ilość pomniejszoną o rezerwację zatwierdzonych zamówień i towar zablokowany. Stan fizyczny w bazie się nie zmienia.
Harmonogram i Flows
Każdy szablon działa według własnego harmonogramu. Proces (Flows) łączy kroki w łańcuch: wczytaj cenniki, zaktualizuj katalog, wyeksportuj na platformy i wyślij powiadomienie z wynikiem. Automatyzacja procesów (po angielsku).
Reguły automatyczne
Nowe zamówienie albo jego zmiana podczas importu uruchamia regułę: zdarzenie, warunek, działanie. Klient dostaje e-mail lub SMS, menedżer zadanie, a dokument tworzy się sam. Zamówienia z platformy podlegają tym samym regułom co zamówienia ze sklepu.
Automatyczne dobieranie kategorii
Przycisk w oknie mapowania dobiera kategorię platformy o tej samej nazwie, jeśli na jej liście jest tylko jedna taka. Pozostałe mapujesz ręcznie raz.
Te same zadania możesz zlecić agentowi AI zwykłymi słowami: wczytać cenniki, zaktualizować katalog, uruchomić eksport, uzupełnić karty produktów. Agenci AI (po angielsku).
8
Integracja z Kaufland: najczęstsze pytania
Czym jest Kaufland marketplace i czy działa w Polsce?
To platforma, na której sprzedawcy zewnętrzni wystawiają oferty w serwisach Kaufland. W Polsce działa jako Kaufland.pl, a w ramach Kaufland Global Marketplace także w Niemczech, Austrii, Czechach, na Słowacji, we Francji, Włoszech, Hiszpanii i Holandii. Konektor Elbuz obejmuje wszystkie dziewięć rynków — listę bierze z Twojego konta sprzedawcy.
Co to jest Kaufland API?
Seller API v2 to oficjalny interfejs Kaufland Global Marketplace do ofert, danych produktów i zamówień. Elbuz już z niego korzysta: wpisujesz dwa klucze, kod nie jest potrzebny.
Czy dodam produkt, którego nie ma jeszcze na Kaufland?
Tak. Gdy kategoria jest połączona, Elbuz wysyła dane produktu z atrybutami wymaganymi do weryfikacji Kaufland, a oferta powstaje przy następnym uruchomieniu.
Jak podłączyć Kaufland do Elbuz?
Wystarczą dwa klucze z konta sprzedawcy Kaufland — Client key i Secret key — oraz kod rynku, np. pl. Zatwierdzanie aplikacji nie jest potrzebne, a „Sprawdź połączenie” potwierdza klucze i rynek. Kroki opisuje sekcja Jak podłączyć.
Które rynki Kaufland obsługuje Elbuz?
Polskę, Niemcy, Austrię, Czechy, Słowację, Francję, Włochy, Hiszpanię i Holandię — listę rynków konektor bierze z Twojego konta sprzedawcy; jeden szablon na rynek, wszystkie pracują na jednym katalogu.
Jak działa rezerwacja towaru dla zamówień z Kaufland?
Zamówienie przychodzi niezatwierdzone i nie zmienia stanów. Gdy je zatwierdzisz, towar zostaje zarezerwowany; status końcowy — zrealizowane, anulowane, zwrócone — zwalnia rezerwację, a faktura zdejmuje towar ze stanu.
Czy Elbuz usunie ofertę z Kaufland?
Nie. Aby wstrzymać sprzedaż, wyślij stan zero albo dezaktywuj ofertę na koncie Kaufland. Produkt, który wypadnie z wyboru eksportu, po prostu przestaje dostawać aktualizacje.
Dlaczego Kaufland wymaga kodu EAN?
Kaufland wymaga oficjalnego kodu EAN dla każdego produktu, a nowe oferty dołączają do istniejących stron produktów właśnie po EAN.
Czy cena na Kaufland może być inna niż w moim sklepie?
Tak. Szablon eksportu Kaufland liczy cenę własną formułą, np. z narzutem pokrywającym prowizję, a katalog i sklep zachowują swoje ceny. Zobacz reguły narzutu.
Dział strony i marketplace’ów działa w Twojej firmie AI razem ze wszystkimi innymi działami. Po rejestracji dostajesz 50 € (ok. 220 zł) na saldzie i 14 dni na sprawdzenie katalogu, sklepu i feedów na własnych produktach.