🛒 Kaufland.pl i rynki zagraniczne w jednym panelu
Integracja Kaufland z Base (BaseLinker)
Zamówienia z Kauflanda trafiają do Base (dawniej BaseLinker) obok Allegro i sklepu. Konfigurujemy integrację, dane produktów, stany, ceny i wysyłki, także dla Kaufland.de i pozostałych rynków.
Zaufali nam
Integracja Kaufland z Base w skrócie
Integracja Kaufland z Base (BaseLinker) to połączenie konta sprzedawcy Kaufland Global Marketplace z panelem Base, dzięki któremu zamówienia, oferty, stany, ceny i numery przesyłek przechodzą między systemami bez przepisywania. Base ma gotową, dwukierunkową integrację z Kauflandem, osobną dla każdego rynku. My ją konfigurujemy, przygotowujemy dane produktów pod wymagania Kauflanda i dokładamy automatyzacje tam, gdzie gotowa integracja nie wystarcza.
Gotowa integracja Base.
Bez limitu kont Kaufland i bez dopłat do abonamentu.
Jeden magazyn dla wszystkich kanałów.
Stany i ceny z Base trafiają na Kaufland, Allegro i do sklepu.
Dane pod wymagania Kauflanda.
EAN, SKU, kategorie, GPSR i zdjęcia przed pierwszym wystawieniem.
Numer przesyłki przy każdej paczce.
Od niego zależą wskaźniki sprzedawcy i termin wypłaty.
Kaufland bez osobnego okna do pilnowania
Dziś: Zamówienia z Kauflanda sprawdzane w Portalu sprzedawcy
Po wdrożeniu: Zamówienia z Kauflanda w Base, obok Allegro i sklepu
Dziś: Stany poprawiane ręcznie po każdej sprzedaży
Po wdrożeniu: Stany i ceny synchronizowane z magazynu Base
Dziś: Oferty dodawane w Portalu sprzedawcy EAN po EAN
Po wdrożeniu: Oferty wystawiane z magazynu Base, także masowo
Dziś: Numer przesyłki wpisywany ręcznie albo wcale
Po wdrożeniu: Numer nadania przekazywany do Kauflanda po zmapowaniu kuriera
Dziś: Oferty wykluczone ze sprzedaży przez brak danych GPSR
Po wdrożeniu: Dane producenta uzupełnione przed wystawieniem
Gotowa integracja w Base to dobry start. My ustawiamy ją tak, żeby pasowała do Twojego magazynu, kurierów i rynków.
Co integrujemy między Kauflandem a Base
Zakres ustalamy na konsultacji. Najczęściej obejmuje te elementy.
Połączenie kont Kaufland z Base.
Client Key i Secret Key z Portalu sprzedawcy, osobna integracja dla każdego rynku, pobieranie zamówień i zwrotów.
Kategorie, parametry i szablony.
Ulubione kategorie, mapowanie parametrów, szablony ofert i powiązania kategorii magazynu z kategoriami Kauflanda.
Stany, ceny i cena minimalna.
Magazyn źródłowy, mnożnik ceny, grupa cenowa z ceną minimalną i jeden mechanizm zmiany cen zamiast dwóch.
Wysyłka i numery nadania.
Mapowanie kurierów, numer nadania przekazywany do Kauflanda, czas wysyłki liczony z pola produktu.
Automatyzacje wokół zamówień.
Akcje automatyczne w Base, przekazanie zamówień do sklepu albo ERP, faktury z numerem BDO i wysyłka do KSeF jednym kanałem.
Sprzedaż na kolejnych rynkach.
Kaufland.de, .cz, .sk i inne rynki jako osobne integracje, z walutą, językiem i tekstami prawnymi kraju.
Jak pracujemy
Konsultacja
Sprawdzamy asortyment, rynki, magazyny, kurierów i to, jak dziś obsługujesz zamówienia.
Przygotowanie danych
EAN, SKU, kategorie, zdjęcia i dane GPSR w Base, grupy dostaw w Portalu sprzedawcy.
Konfiguracja i automatyzacje
Integracja dla każdego rynku, mapowanie parametrów i kurierów, stany, ceny i akcje automatyczne.
Test i uruchomienie
Zamówienie testowe przed startem, potem poprawki i szkolenie zespołu.
Czego nie robimy
- Nie budujemy własnej integracji, gdy wystarcza gotowa integracja Base. Kod przez API dopisujemy tylko tam, gdzie jej brakuje.
- Nie uruchamiamy sprzedaży bez zamówienia testowego.
- Nie zostawiamy dwóch mechanizmów zmiany cen naraz. Ceną steruje repricing w Base albo korekta cen Kauflanda.
- Nie obiecujemy wyników sprzedaży. Odpowiadamy za to, żeby zamówienia, stany i wysyłki działały.
Narzędzia
BaseLinker (Base)
Zamówienia, magazyn, oferty Kaufland i akcje automatyczne.
Portal sprzedawcy Kaufland
Konto, grupy dostaw, zwroty, teksty prawne i klucze API.
Baselinker API
Logika, której nie obsługuje gotowa integracja.
n8n lub Make
Raporty, powiadomienia i połączenia z programami spoza Base.
KSeF
Faktury z Base wysyłane jednym kanałem, bez duplikatów.
Opisz, jak sprzedajesz i co chcesz podłączyć
Napisz, czym zajmuje się Twoja firma i co chcesz usprawnić.
Wrócimy z konkretną propozycją, a nie z ogólną prezentacją.
Co dzieje się dalej
- Odpisujemy w ciągu 1 dnia roboczego.
- Umawiamy 30-minutową rozmowę.
- Przygotowujemy propozycję i wycenę.
Najczęstsze pytania
Czy Base (BaseLinker) ma integrację z Kauflandem?
Tak. Base ma gotową, dwukierunkową integrację z Kauflandem. Pobiera zamówienia i zwroty, wystawia oferty z magazynu Base, synchronizuje stany i ceny oraz przekazuje numery przesyłek. Dodajesz ją w panelu: Integracje → Dodaj integrację → Marketplace → Kaufland. Liczba podłączonych kont nie zmienia abonamentu.
Jak podłączyć Kaufland do BaseLinkera?
W Portalu sprzedawcy Kaufland, w ustawieniach API, generujesz Client Key i Secret Key. W Base dodajesz integrację Kaufland, wpisujesz oba klucze i wybierasz region. Każdy rynek, na przykład Kaufland.pl i Kaufland.de, to osobna integracja. Potem ustawiasz pobieranie zamówień, stany, ceny i mapowanie kurierów.
W jakich krajach działa Kaufland Marketplace?
Kaufland Global Marketplace działa w 9 krajach: w Niemczech, Austrii, Czechach, Słowacji, Polsce, Francji, Włoszech, Hiszpanii i Holandii (stan na październik 2026). Jedna rejestracja daje dostęp do wszystkich kanałów sprzedaży. W Base każdy rynek dodajesz jako osobną integrację, a region wybierasz przy dodawaniu.
Ile kosztuje sprzedaż na Kaufland.pl?
Kaufland pobiera abonament i prowizję. Plan Basic kosztuje 175 zł, a Plus 260 zł miesięcznie plus VAT, jedna opłata za wszystkie rynki. Prowizja zależy od kategorii: na Kaufland.pl od 4% do 12%, na pozostałych rynkach od 7% do 16%. Kaufland liczy ją od ceny brutto z wysyłką, tylko od produktów niezwróconych i nieanulowanych. Stan na październik 2026.
Czy stany i ceny z Base aktualizują się na Kauflandzie automatycznie?
Tak, gdy oferty są powiązane z produktami w magazynie Base. Synchronizację ustawiasz w Integracje → Kaufland, w zakładkach Stany i Ceny, z mnożnikiem ceny. Z wybranej grupy cenowej Base wysyła też cenę minimalną, której Kaufland używa tylko do swojej automatycznej korekty cen.
Czy z Base wystawię na Kauflandzie ofertę wielowariantową?
Nie. Base nie wystawia na Kauflandzie ofert wielowariantowych. Kaufland sam łączy produkty w grupy wariantów na podstawie tytułu i atrybutów, więc kolor, rozmiar czy materiał muszą być uzupełnione w parametrach każdego produktu.
Czy zmiana statusu na Kauflandzie zmienia status zamówienia w Base?
Nie. Statusy idą w jedną stronę: z Base do Kauflanda. API Kauflanda obsługuje dwa statusy, Kompletowanie i Anulowanie zamówienia. Status Wysłane Kaufland dostaje po dodaniu numeru przesyłki, dlatego mapowanie kurierów ustawiamy przed startem.
Co oznacza błąd „400: Nieznany błąd” przy wystawianiu na Kaufland?
Według pomocy Base zwykle chodzi o błędnie przesłany kod EAN, na przykład ze spacją. Komunikat „ean: Field ean is missing or has wrong value” też wskazuje zły EAN, najczęściej złą liczbę cyfr. Błędy „Internal Server Error” i „0: Nieznany błąd” to chwilowe problemy API Kauflanda: wystarczy ponowić operację.
Kiedy Kaufland wypłaca pieniądze ze sprzedaży?
Przy przesyłce z numerem śledzenia Kaufland przekazuje środki w ciągu 14 dni od potwierdzenia doręczenia. Bez numeru śledzenia czekasz 21 dni od oznaczenia zamówienia jako wysłane, a otwarte zgłoszenia klientów opóźniają wypłatę. Dlatego numer nadania z Base musi trafiać do Kauflanda przy każdej paczce.
Co daje integracja Kaufland z Base (BaseLinker)?
Integracja Kaufland z Base sprawia, że zamówienia z Kauflanda obsługujesz w tym samym panelu co Allegro i sklep internetowy. Oferty wystawiasz z magazynu Base, stany i ceny synchronizują się według ustawionych reguł, a numer przesyłki wraca do Kauflanda po zmapowaniu kuriera. Zespół pakuje zamówienia z jednej kolejki.
Base (dawniej BaseLinker) ma gotową, dwukierunkową integrację z Kauflandem i nie dolicza nic za kolejne konta. Wymaga jednak konfiguracji: grup dostaw po stronie Kauflanda, danych produktów z EAN i GPSR, mapowania parametrów, kurierów i reguł cen. To robimy w ramach wdrożenia. Tam, gdzie gotowa integracja nie wystarcza, dokładamy automatyzacje przez API Base, n8n albo Make.
Kaufland Global Marketplace: rynki, abonament i prowizje
Kaufland Global Marketplace to marketplace’y w 9 krajach: Kaufland.de, .at, .cz, .sk, .pl, .fr, .it, .es i .nl. Jedna rejestracja daje dostęp do wszystkich, a kolejne kanały dodajesz w Portalu sprzedawcy bez opłat. Ofertę zakładasz na kodzie EAN. Jeśli produkt jest już w katalogu, podajesz tylko dane oferty: cenę, stan i czas dostawy. Wysyłkę i fakturę dla klienta zapewnia sprzedawca, płatności obsługuje Kaufland.
Abonament kosztuje 175 zł (Basic) albo 260 zł (Plus) miesięcznie plus VAT. Płacisz go raz, za wszystkie rynki, w walucie kanału, który wskażesz. Prowizję Kaufland liczy od ceny brutto razem z kosztem wysyłki i tylko od produktów, które nie zostały zwrócone ani anulowane.
| Kategoria | Kaufland.pl | DE, AT, CZ, SK, FR, IT, ES, NL |
|---|---|---|
| Komputery, elektronika użytkowa, opony i felgi | 4% | 7% |
| Duże AGD | 7% | 7% |
| Małe AGD, akcesoria komputerowe, rowery | 7% | 13% |
| Narzędzia i sprzęt ogrodowy | 7% | 10% |
| Perfumy | 8% | 10% |
| Pielęgnacja ciała i zdrowie, motoryzacja | 8% | 13% |
| Artykuły budowlane | 9% | 13% |
| Ogród, np. meble ogrodowe i nawadnianie | 9% | 14% |
| Meble, oświetlenie, sport, zabawki, żywność | 10% | 13% |
| Odzież, obuwie, kuchnia i dom, artykuły dla zwierząt | 10% | 14% |
| Książki, płyty i filmy | 9% + 3 zł za sztukę | 13% + 0,70 € za sztukę |
| Biżuteria | 12% | 16% |
| Pozostałe kategorie | 10% | 13% |
Każdy rynek ma swoje wymagania: dane produktu w języku kraju, ceny w lokalnej walucie, teksty prawne i numery EPR. Opisujemy je niżej, w części o sprzedaży za granicę.
Co synchronizuje integracja Kaufland z BaseLinkerem?
Integracja Base z Kauflandem ma 11 zakładek ustawień. W menu po lewej stronie jest też moduł Kaufland: wystawianie, zarządzanie ofertami, cenniki wysyłek, kategorie i parametry, szablony ofert, powiązania i wiadomości. Poniżej zestawienie na podstawie pomocy Base.
| Obszar | Co robi integracja | Na co uważać |
|---|---|---|
| Zamówienia | pobiera zamówienia ze wszystkich kont Kaufland, może przekazać je do sklepu | pobieranie włączasz po skonfigurowaniu Managera Zamówień |
| Zwroty | pobiera zwroty z Kauflanda, zmiana statusu zwrotu w Base może zmienić status na Kauflandzie | statusy zwrotów mapujesz w osobnej zakładce |
| Statusy zamówień | przekazuje zmiany statusu z Base do Kauflanda | tylko w jedną stronę; API obsługuje Kompletowanie i Anulowanie, Wysłane idzie z numerem przesyłki |
| Oferty | wystawia produkty z magazynu formularzem albo przez Agenta AI, importuje oferty założone poza Base | oferta musi być powiązana z produktem w magazynie |
| Warianty | nie wystawia ofert wielowariantowych | Kaufland łączy warianty sam, po tytule i atrybutach |
| Stany | synchronizuje stan oferty ze stanem produktu w magazynie | jest opcja aktywacji ofert, które Base widzi jako nieaktywne |
| Ceny | synchronizuje ceny z mnożnikiem, wysyła cenę minimalną z wybranej grupy cenowej | cena minimalna działa tylko w automatycznej korekcie cen Kauflanda |
| Czas wysyłki | ustawia czas wysyłki z pola dodatkowego produktu (liczba dni) | tylko dla ofert powiązanych z katalogiem Base |
| Konkurencja | sprawdza ceny konkurencji i zmienia ceny (repricing) | nie łączymy go z korektą cen Kauflanda |
| Wysyłka | przekazuje numery nadania do Kauflanda | mapowanie kurierów jest w Zaawansowanych ustawieniach |
| Wiadomości | korespondencja z klientami przez moduł Responso | Kaufland oczekuje odpowiedzi na zgłoszenia w 48 godzin |
Konfigurację zaczynamy od kategorii: ulubione kategorie w Kaufland → Kategorie i parametry, mapowanie parametrów, ustawienia wystawiania i powiązania kategorii magazynu z kategoriami Kauflanda. Dzięki temu parametry uzupełniają się na formularzu same, a oferty wystawiasz masowo.
EAN, SKU i GPSR: dane, bez których oferta na Kauflandzie nie ruszy
Kaufland buduje katalog na kodach EAN. Każdy nowy produkt musi mieć co najmniej EAN, kategorię, nazwę, opis, zdjęcia i producenta. Jeśli produkt jest już w katalogu, wystarczy EAN i dane oferty. Kaufland nie pozwala bez uzasadnienia sprzedawać tego samego produktu pod kilkoma EAN: takie oferty usuwa bez uprzedzenia.
SKU (w plikach Kauflanda pole „id_offer”) trzeba podać przed publikacją oferty, bo później nie da się go dodać. Jeden SKU może mieć tylko jeden EAN, a powiązanie EAN z SKU obowiązuje na wszystkich rynkach. Dlatego SKU w Base porządkujemy przed pierwszym wystawieniem.
- Zdjęcia. Co najmniej 1024 px na dłuższym boku, do powiększenia 2048 px, plik do 10 MB. Zdjęcie główne na białym tle, bez napisów, logo i ramek.
- Nazwa i opis. Kaufland zaleca nazwę o długości 50-80 znaków i opis 150-5000 znaków, bez haseł reklamowych, linków i informacji o wysyłce.
- Krótki opis. W Base ustawiasz go mapowaniem parametru „Kurze Beschreibung”: do 1024 znaków, bez HTML, linków i zdjęć. Kaufland traktuje krótki opis jako słowa kluczowe dla wyszukiwarki i zaleca najwyżej 10 fraz.
- GPSR. Na formularzu wystawiania w Base uzupełniasz nazwę, e-mail, adres i telefon producenta oraz certyfikat CE. Przy producencie spoza UE Kaufland wymaga też osoby odpowiedzialnej w UE. Oferty bez tych danych system Kauflanda wyklucza ze sprzedaży.
- Tekstylia. Na Kaufland.pl skład materiału podajesz w atrybucie „material_composition”, po polsku, od największego udziału, np. „80% bawełna, 20% poliester”.
- Warianty. Kaufland łączy warianty automatycznie, gdy atrybuty takie jak kolor czy rozmiar są uzupełnione.
Wysyłka, zwroty i wypłaty: zasady Kauflanda, które ustawiamy w Base
Zanim wystawisz pierwszą ofertę, w Portalu sprzedawcy musisz utworzyć grupę dostaw: kraje, koszty, metodę (paczka albo spedycja) i czas przewozu. Base importuje takie cenniki w Kaufland → Cenniki wysyłek. Czas dostawy widoczny dla klienta to suma czasu przetwarzania z oferty i czasu przewozu z grupy dostaw, liczona w dniach roboczych, bez sobót.
Na Kaufland.pl do automatów paczkowych i punktów odbioru dowożą InPost, DHL, DPD i GLS. Dostawa do automatu działa tylko wtedy, gdy klient ma w koszyku jeden produkt.
| Zasada | Wymóg Kauflanda | Co ustawiamy w Base |
|---|---|---|
| Anulowania z winy sprzedawcy | poniżej 1% w miesiącu; od 1% do 2,99% opłata 7%, powyżej 3% opłata 15% wartości anulowanych zamówień | synchronizacja stanów z jednego magazynu |
| Przesyłki ze śledzeniem | co najmniej 80% pozycji z prawidłowym numerem | mapowanie kurierów i automatyczne przekazanie numeru |
| Zamówienia nieoznaczone jako wysłane | powiadomienie 14 dni po najpóźniejszym terminie dostawy, anulowanie po kolejnych 7 dniach | akcja automatyczna, która przekazuje numer po nadaniu paczki |
| Wypłata środków | 14 dni od doręczenia przy numerze śledzenia, 21 dni od oznaczenia wysyłki bez numeru | numer nadania przy każdej paczce |
| Zwroty | domyślnie 14 dni na odstąpienie, zwrot zamówienia powyżej 175 zł na koszt sprzedawcy | pobieranie zwrotów do Base i mapowanie statusów zwrotów |
Od 1 lutego 2026 r. pierwsza odpowiedź na prośbę o zwrot musi zawierać opcję zwrotu, na przykład etykietę zwrotną, link do niej albo, przy zamówieniach do 175 zł, adres zwrotny. Jeśli jej zabraknie, Kaufland anuluje zamówienie i zwraca klientowi pełną kwotę na koszt sprzedawcy. Szablony odpowiedzi przygotowujemy z tym wymogiem.
Jak wygląda wdrożenie integracji Kaufland z Base krok po kroku?
Wdrożenie zaczyna się od konta w Portalu sprzedawcy, a kończy zamówieniem testowym. Kolejność ma znaczenie, bo grupy dostaw i klucze API muszą najpierw powstać po stronie Kauflanda.
- Konto i onboarding w Portalu sprzedawcy. Rejestracja, weryfikacja firmy, numer VAT, teksty prawne, adres zwrotów i magazyn. Przy kompletnych danych Kaufland aktywuje konto w ciągu 3 dni roboczych.
- Grupy dostaw i klucze API. Grupy dostaw w Ustawieniach wysyłki, Client Key i Secret Key w ustawieniach API.
- Połączenie w Base. Integracje → Dodaj integrację → Marketplace → Kaufland, osobno dla każdego rynku.
- Kategorie, parametry i powiązania. Ulubione kategorie, mapowanie parametrów, szablony ofert, import cenników wysyłek.
- Stany, ceny i kurierzy. Magazyn źródłowy, grupa cenowa, cena minimalna, czas wysyłki i mapowanie kurierów.
- Pierwsze oferty i zamówienie testowe. Sprawdzamy całą ścieżkę: zamówienie, etykieta, numer nadania, status, faktura.
Gdy gotowa integracja nie pasuje do procesu, na przykład zamówienia z kilku rynków mają trafiać do ERP z osobnym oznaczeniem, dokładamy akcje automatyczne Base albo kod przez API. Więcej o tym, jak pracujemy z Base, przeczytasz na stronie wsparcia BaseLinkera.
Najczęstsze błędy przy integracji Kaufland z BaseLinkerem
Większość błędów dotyczy EAN, powiązań ofert i chwilowych problemów API Kauflanda. Opis na podstawie pomocy Base.
- „400: Nieznany błąd” przy wystawianiu. Zwykle błędny EAN, na przykład ze spacją.
- „ean: Field ean is missing or has wrong value”. Zła liczba cyfr EAN. Jeśli EAN jest poprawny, sprawę wyjaśnia obsługa Kauflanda.
- „Product Data not found”. Komunikat API Kauflanda, który może oznaczać na przykład brak długiego opisu.
- „ItemUnit: Field IdemUnit is missing or has wrong value”. Automatyczna korekta cen po stronie Kauflanda obniżyłaby cenę poniżej minimalnej.
- „Unit not found” albo „Resource not found” przy synchronizacji. Oferty albo produktu nie ma już na Kauflandzie. Usuń ofertę z Base i zaimportuj ją ponownie.
- Oferta aktywna na Kauflandzie, a w Base w zakładce Nieaktywne. W ustawieniach stanów włącz zwiększanie ilości do stanu magazynowego z aktywacją oferty.
Kaufland.de i inne rynki: sprzedaż za granicę z Base
Z polskiego konta Kaufland sprzedasz także na pozostałych rynkach Kaufland Global Marketplace. Kaufland wymaga przy tym danych produktu w języku kraju, cen w lokalnej walucie i tekstów prawnych w języku kanału: regulaminu, pouczenia o odstąpieniu i polityki prywatności. Sprzedawca z UE podaje numer VAT OSS albo lokalny numer VAT dla każdego kraju.
Każdy rynek ma też obowiązki EPR. Na Kaufland.de podajesz m.in. numery WEEE, LUCID i rejestracji baterii, na Kaufland.pl numer BDO, który musi być także na fakturach. We Francji, we Włoszech i w Hiszpanii Kaufland oferuje płatną usługę EPR Service: 1,90 € miesięcznie za kategorię.
Jedno źródło cen dla każdego rynku
W Base każdy rynek to osobna integracja z własnymi ustawieniami cen i stanów. Kaufland ma też własną synchronizację ofert między kanałami. Gdy cenę, czas przetwarzania albo grupę dostaw oferty docelowej zmieni API, Kaufland wyłącza tę ofertę ze swojej synchronizacji. Dlatego dla każdego rynku ustalamy jedno źródło cen: Base albo Portal sprzedawcy.
Zamówienia z Kauflanda, Allegro i sklepu internetowego trafiają do jednego panelu Base. Przy fakturach uważaj na KSeF: integracja KSeF w Base wysyła wyłącznie faktury wystawione w Base, więc gdy fakturujesz też w ERP, wybieramy jeden kanał. Ile czasu oszczędza automatyzacja obsługi zamówień, policzysz w kalkulatorze opłacalności.
Pracujesz w Apilo zamiast w Base? Zobacz integrację Kaufland z Apilo. Pozostałe marketplace’y znajdziesz w integracjach.