# Integracja Kaufland.pl: wymagania i podłączenie

- Adres: https://commerceos.pl/blog/integracja-kaufland
- Autor: Zespół Fide-Soft (FIDE-SOFT prosta spółka akcyjna)
- Opublikowano: 2026-10-26
- Kategoria: [Sprzedaż wielokanałowa](https://commerceos.pl/blog/kategoria/sprzedaz-wielokanalowa)

Kaufland.pl to jeden z kanałów Kaufland Global Marketplace. Jedno konto sprzedawcy obejmuje wszystkie kraje platformy, oferty łączą się z produktami po kodzie EAN, a zamówienie składa się z jednostek, z których każda ma własny status. Opisujemy wymagania, opłaty, zasady dla ofert, zamówień i zwrotów oraz to, co integrator wymienia z Kauflandem przez Seller API. Stan na 26.10.2026.

## W skrócie

Na Kaufland.pl sprzedaje zarejestrowana firma z numerem VAT i oficjalnymi kodami EAN, a opłata podstawowa wynosi 175 zł (Basic) albo 260 zł (Plus) netto miesięcznie za wszystkie kanały Kauflandu. Prowizja na Kaufland.pl to od 4% do 12% zależnie od kategorii, liczona od ceny brutto z wysyłką i VAT. Integrator łączy się z Seller API kluczami z portalu sprzedawcy i podpisuje każde zapytanie, a każda sztuka w zamówieniu to osobna jednostka z własnym statusem.

## Wymagania dla sprzedawcy

Strona rejestracji Kaufland Global Marketplace wymienia warunki, które musisz spełnić przed startem:

- zarejestrowana działalność gospodarcza,
- numer VAT właściwy dla siedziby firmy, podany dla każdego kanału sprzedaży, a przy sprzedaży internetowej w Unii także numer OSS,
- oficjalne kody EAN (GTIN) dla oferowanego asortymentu,
- adres zwrotny w jednym z krajów Unii Europejskiej,
- kontakt z klientami w języku urzędowym kraju danego kanału i dane produktów w tym języku,
- dobra dostępność telefoniczna i mailowa oraz brak produktów z kategorii zabronionych.

Do rejestracji dołączasz dokumenty: przy jednoosobowej działalności dowód osobisty albo paszport, weryfikowany przez IDnow, i zaświadczenie z rejestru, przy spółkach dokumenty wszystkich reprezentantów, odpis z rejestru i strukturę własności. Wskazujesz też beneficjentów rzeczywistych, czyli osoby z co najmniej 25% udziałów.

## Opłaty: plan i prowizja

| Opłata | Ile wynosi | Uwagi |
|---|---|---|
| Plan Basic | 175 zł netto miesięcznie | jedna opłata za wszystkie kanały Kauflandu |
| Plan Plus | 260 zł netto miesięcznie | jak Basic, do tego link do Twojego sklepu i środki na kampanie ofert sponsorowanych |
| Prowizja na Kaufland.pl | od 4% do 12%, zależnie od kategorii | od ceny sprzedaży brutto obejmującej koszty wysyłki i VAT |
| Kategoria Nośniki | 9% plus 3 zł za każdy sprzedany produkt | stała część prowizji obok procentowej |

Przykładowe stawki z tabeli Kauflandu dla Kaufland.pl: komputery i elektronika użytkowa 4%, duże AGD 7%, perfumy 8%, większość kategorii 10%, biżuteria 12%. Opłatę podstawową dla Kaufland.pl Kaufland pobiera w złotych, a po rejestracji sam decydujesz, w których krajach publikujesz oferty. Przejście z Basic na Plus działa od razu, a powrót do Basic po czterech tygodniach. Współpracę możesz zakończyć w każdej chwili.

## Oferty: EAN i katalog Kauflandu

W Seller API oferta nazywa się jednostką (unit). To Twoja oferta jednego produktu w określonym stanie, z określonego magazynu i w określonej cenie. Jednostkę łączysz z produktem przez EAN albo identyfikator produktu Kauflandu. Jeśli produktu nie ma jeszcze w katalogu, najpierw przesyłasz jego dane produktowe, a ofertę dodajesz, gdy produkt jest już na platformie.

| Pole oferty | Co oznacza |
|---|---|
| ean albo id_product | produkt z katalogu Kauflandu, co najmniej jedno z dwóch |
| id_offer | Twój numer oferty, unikalny w całym asortymencie, najlepiej równy SKU |
| condition | stan towaru, np. nowy |
| listing_price | cena w groszach waluty danego sklepu, większa od zera |
| amount | liczba sztuk, najwyżej 99999 |
| handling_time | dni robocze do przekazania paczki przewoźnikowi |
| id_shipping_group | grupa wysyłkowa z czasem dostawy |
| storefront | sklep Kauflandu, w którym oferta ma się pokazać, np. Kaufland.pl |

Ten sam id_offer możesz użyć w kilku krajach. Wtedy magazyn i liczba sztuk są wspólne, a cena, grupa wysyłkowa i czas realizacji mogą się różnić między krajami.

## Zamówienia w jednostkach

Kaufland dzieli koszyk klienta na zamówienia, osobno dla każdego sprzedawcy. Zamówienie składa się z jednostek, a każda jednostka to jedna sztuka towaru. Trzy takie same produkty w koszyku to trzy jednostki z własnym statusem.

1. Nowe jednostki mają status open. Przez pierwsze 15 minut klient może anulować zakup, a adres dostawy jest ukryty.
2. Po 15 minutach jednostki przechodzą w status need_to_be_sent i dopiero wtedy możesz je wysłać.
3. Po nadaniu oznaczasz jednostki jako wysłane, z kodem przewoźnika i numerem przesyłki. Kilka numerów rozdzielasz przecinkiem.
4. Jeśli musisz anulować sprzedaż, anulujesz jednostkę z powodem z listy Kauflandu.
5. Zwrot części pieniędzy zlecasz na jednostce, z kwotą i powodem.

Integrator powinien składać jednostki z powrotem w pozycje zamówienia, bo w panelu zamówień wygodniej widzieć trzy sztuki jednego produktu niż trzy osobne wiersze. Kod przewoźnika wybierasz z listy kodów, którą Kaufland publikuje w dokumentacji API.

## Zwroty

Zwroty przez API obsłużysz, gdy korzystasz z etykiet zwrotnych DHL albo DPD lub z Kaufland Shipment Solutions. Zwrot ma jednostki zwrotu, po jednej na każdą jednostkę zamówienia, a sprzedawca wybiera dla każdej akcję:

| Akcja | Kiedy |
|---|---|
| accept | paczka dotarła i zwrot jest w porządku |
| reject | paczka jest niewłaściwa, z opisem powodu; Kaufland otwiera zgłoszenie przy zamówieniu |
| repair | towar na gwarancji po terminie zwrotu, naprawiony wraca do klienta |
| clarify | zwrotu nie da się rozpatrzyć bez informacji od klienta |

## Jak podłączyć Kaufland do integratora

1. Zarejestruj konto sprzedawcy, wybierz plan i kanały, w których chcesz sprzedawać.
2. Ustaw magazyn, grupy wysyłkowe i adres zwrotny w Unii.
3. W portalu sprzedawcy, w ustawieniach API, wygeneruj Client Key i Secret Key.
4. Wklej klucze w panelu integratora i wybierz sklep Kauflandu, np. Kaufland.pl.
5. Powiąż oferty z produktami po id_offer i SKU, zanim włączysz wysyłanie stanów.
6. Przejdź zamówienie testowe: status need_to_be_sent, wysyłka z numerem, ewentualny zwrot.

Seller API działa pod adresem https://sellerapi.kaufland.com/v2/. Każde zapytanie ma nagłówki Shop-Client-Key, Shop-Timestamp i Shop-Signature, czyli podpis HMAC SHA-256 liczony kluczem Secret Key z metody, adresu, treści zapytania i znacznika czasu. Znacznik czasu może różnić się od czasu serwera najwyżej o 5 minut, więc zegar serwera integratora musi być zsynchronizowany.

**Ile zaoszczędzisz, przechodząc z BaseLinkera?** [Policz zwrot z migracji](https://commerceos.pl/integrator#zwrot) albo [umów rozmowę o wdrożeniu](https://commerceos.pl/integrator#wdrozenie).

## Kaufland w Commerce OS Integrator

Kaufland jest w tabeli funkcji [Commerce OS Integrator](https://commerceos.pl/integrator) razem z Erli, Empik, Amazon i eBay. Na wdrożeniu podłączamy Twoje konto sprzedawcy i klucze API i testujemy połączenie na Twoim koncie. Zamówienia z Kauflandu trafiają na wspólną listę z zamówieniami z Allegro, sklepu i innych kanałów, z tymi samymi folderami statusów. Sprzedaż w jednym kanale zmniejsza stan, a nowy stan wraca do pozostałych kanałów. Numer przesyłki wraca do kanału, w którym klient kupił, a etykietę i fakturę tworzysz z tego samego zamówienia.

Jak wygląda praca z kilkoma kanałami na jednej liście, opisujemy w artykule [Jedna lista zamówień z Allegro, sklepu i Erli](https://commerceos.pl/blog/jedna-lista-zamowien-allegro-sklep-erli). W planie Integrator Start podłączysz do 3 kanałów sprzedaży, w wyższych planach bez limitu, a ceny są w [cenniku Integratora](https://commerceos.pl/integrator/cennik). Jeśli dziś obsługujesz Kaufland przez BaseLinkera, zakres przejścia opisujemy na stronie [Migracja z BaseLinkera](https://commerceos.pl/integrator/migracja-z-baselinkera), a oszczędność policzysz w [kalkulatorze zwrotu z migracji](https://commerceos.pl/integrator#zwrot).

## Na co uważać

- **Brak EAN w katalogu.** Oferta nie powstanie, dopóki produktu nie ma w katalogu Kauflandu, więc dane produktowe przesyłasz wcześniej.
- **Pierwsze 15 minut.** Zamówienia w statusie open nie wyślesz, bo adres jest ukryty, a klient może jeszcze anulować zakup.
- **Kody przewoźników.** Numer przesyłki wysyłasz z kodem z listy Kauflandu.
- **Prowizja od wysyłki.** Prowizja liczy się od ceny brutto z kosztami wysyłki, więc cena dostawy też ją podnosi.
- **Kilka krajów.** Wspólny id_offer oznacza wspólny stan we wszystkich krajach, a ceny ustawiasz osobno.

## Najczęstsze pytania

### Ile kosztuje sprzedaż na Kaufland.pl?

Opłata podstawowa wynosi 175 zł (Basic) albo 260 zł (Plus) netto miesięcznie, jedna za wszystkie kanały Kauflandu. Do tego prowizja od 4% do 12% zależnie od kategorii, liczona od ceny brutto z wysyłką i VAT.

### Czy na Kaufland potrzebuję kodów EAN?

Tak. Kaufland wymaga oficjalnych kodów EAN (GTIN) dla oferowanego asortymentu, a oferta w API łączy się z produktem po EAN albo identyfikatorze produktu Kauflandu.

### Dlaczego zamówienie z Kauflandu ma kilka pozycji z tym samym produktem?

Kaufland zapisuje każdą sztukę jako osobną jednostkę zamówienia z własnym statusem. Integrator powinien składać je w jedną pozycję z ilością, a wysyłkę i anulowanie zgłaszać dla każdej jednostki.

### Kiedy mogę wysłać zamówienie z Kauflandu?

Po 15 minutach od zakupu, gdy jednostki przejdą w status need_to_be_sent. Wcześniej adres dostawy jest ukryty, a klient może anulować zamówienie.

### Gdzie wygenerować klucze API Kauflandu?

W portalu sprzedawcy, w ustawieniach API, gdzie tworzysz Client Key i Secret Key. Każde zapytanie do Seller API jest podpisane kluczem Secret Key.

### Czy Commerce OS Integrator obsługuje Kaufland?

Tak. Kaufland jest w tabeli funkcji Integratora, a konto sprzedawcy i klucze API podłączamy na wdrożeniu. Zamówienia z Kauflandu są na wspólnej liście, a stany i numery przesyłek wracają do Kauflandu.

## Źródła

- [Kaufland Global Marketplace: warunki współpracy i prowizje](https://www.kauflandglobalmarketplace.com/pl/conditions/), stan na 26.10.2026
- [Kaufland Global Marketplace: rejestracja sprzedawcy](https://www.kauflandglobalmarketplace.com/pl/seller-registration/), stan na 26.10.2026
- [Kaufland Seller API: uwierzytelnianie i podpis żądań](https://sellerapi.kaufland.com/?page=rest-api), stan na 26.10.2026
- [Kaufland Seller API: oferty (units)](https://sellerapi.kaufland.com/?page=inventory), stan na 26.10.2026
- [Kaufland Seller API: zamówienia](https://sellerapi.kaufland.com/?page=orders), stan na 26.10.2026
- [Kaufland Seller API: zwroty](https://sellerapi.kaufland.com/?page=returns), stan na 26.10.2026
- [Commerce OS Integrator: kanały sprzedaży i wdrożenie](https://commerceos.pl/integrator), stan na 26.10.2026