Integracja sklepu PrestaShop z Kaufland.de - konfiguracja feedu i synchronizacja
Miłosz Brzegowy
Miłosz Brzegowy
Head of Growth and Demand Generation
Integracja sklepu PrestaShop z Kaufland.de - konfiguracja feedu i synchronizacja
Sklep PrestaShop połączysz z Kaufland.de na trzy sposoby: przez system do sprzedaży wielokanałowej, np. Base, który łączy się z PrestaShop kluczem Webservice, a z Kaufland kluczami API, przez dedykowany moduł PrestaShop od zewnętrznego dewelopera albo przez pliki - feed produktowy CSV wgrywany automatycznie z adresu URL i plik ofert. Niezależnie od drogi integracja musi przesyłać na Kaufland.de dane po niemiecku, ceny w euro i aktualne stany, a z powrotem pobierać zamówienia.
PrestaShop jest popularny wśród polskich sklepów, które mają rozbudowany katalog z kombinacjami i cechami produktów. To dobra baza do wejścia na niemiecki marketplace, bo dane produktowe są już uporządkowane. Kłopot w tym, że Kaufland.de ma własne wymagania co do formatu pliku, kategorii, atrybutów i języka, a polski sklep sprzedaje w złotych. W tym wpisie pokazujemy, jak wybrać sposób integracji, jak skonfigurować feed i synchronizację oraz na jakie błędy uważać.
[#wazne] W skrócie: integracja sklepu PrestaShop z Kaufland.de wymaga przesyłania danych produktowych po niemiecku (CSV z separatorem średnik i kodowaniem UTF-8 albo przez API), ofert z ceną w euro, stanem i czasem realizacji oraz pobierania zamówień. Najwygodniej robi się to przez Base, który synchronizuje stany, ceny i zamówienia między PrestaShop a Kaufland, albo przez dedykowany moduł (stan na wrzesień 2026 - sprawdź aktualne zasady Kaufland i pomoc dostawcy integracji). W Vinson pomagamy wejść na Kaufland.de, przygotować oferty po niemiecku i zintegrować sprzedaż z Base.
Integracja PrestaShop z Kaufland.de - trzy sposoby
Integracja sklepu z marketplace'em to automatyczna wymiana danych: produkty, ceny i stany płyną ze sklepu na marketplace, a zamówienia z marketplace'u do sklepu lub systemu obsługi. Kaufland Global Marketplace udostępnia do tego Seller API oraz import plików w Seller Portalu, a na stronach dla sprzedawców opisuje sieć partnerów technologicznych - systemów sklepowych, ERP i narzędzi pośredniczących. Dla sklepu na PrestaShop masz trzy praktyczne drogi.
| Sposób | Jak działa | Dla kogo |
|---|---|---|
| System wielokanałowy (np. Base) | PrestaShop łączy się z Base kluczem Webservice, Base z Kaufland kluczami API. Stany, ceny i zamówienia synchronizują się w jednym panelu | Sprzedawcy z kilkoma kanałami: sklep, Allegro, Kaufland.pl i Kaufland.de |
| Moduł PrestaShop | Moduł instalowany w sklepie przygotowuje dane i oferty dla Kaufland oraz importuje zamówienia do PrestaShop | Sklepy, które chcą obsługiwać wszystko w panelu PrestaShop |
| Pliki i URL | Feed produktowy CSV i plik ofert eksportowane ze sklepu, pobierane przez Kaufland z adresu URL o ustalonej godzinie | Mały katalog, rzadkie zmiany, zespół z zapleczem technicznym |
Przy module PrestaShop pamiętaj, że to rozwiązanie firmy trzeciej, a nie oficjalny moduł Kauflandu. Przykładowo producent modułu Kaufland Connector, firma silbersaiten, opisuje w nim eksport produktów, kombinacji, opisów, zdjęć i cech, mapowanie kategorii i atrybutów wymaganych, osobne feedy dla każdego rynku, synchronizację stanów i import zamówień do PrestaShop (stan na wrzesień 2026 - sprawdź aktualny opis i cenę u producenta modułu). Przed zakupem sprawdź zgodność z Twoją wersją PrestaShop i aktualizacje modułu.
[#chart:kde19a]
Co przygotować w PrestaShop przed integracją z Kaufland.de
Integracja przenosi dane, ale ich nie poprawia. Jeśli w sklepie brakuje EAN-ów albo cechy są wpisane w opisie zamiast w osobnych polach, te same braki pojawią się na Kaufland.de - tyle że tam skończą się odrzuceniem produktu. Przed połączeniem sprawdź w PrestaShop:
EAN dla każdego produktu i kombinacji. Kaufland identyfikuje produkt po EAN, a każda kombinacja, np. rozmiar czy kolor, potrzebuje własnego kodu.
Cechy w osobnych polach. Materiał, wymiary, waga czy pojemność muszą być cechami, a nie tylko zdaniem w opisie - z nich powstaną atrybuty Kaufland.
Niemiecką wersję językową. Tytuły, opisy i wartości cech po niemiecku, sprawdzone przez człowieka. Możesz je trzymać jako osobny język w sklepie lub w systemie wielokanałowym.
Zdjęcia bez napisów. Kaufland zaleca 5-10 zdjęć o boku min. 1024 px, pierwsze z całym produktem, bez kolaży i tekstu, a do zdjęć wymagany jest tekst alternatywny.
Dane producenta i GPSR. Kontakt do producenta, osoba odpowiedzialna w UE przy producencie spoza UE i informacje o bezpieczeństwie po niemiecku.
Szczegółowe wymagania dla atrybutów w niemieckich kategoriach zebraliśmy we wpisie Atrybuty i dane produktowe na Kaufland.de - co jest wymagane w niemieckich kategoriach.
Sklep PrestaShop połączysz z Kaufland.de na trzy sposoby: przez system do sprzedaży wielokanałowej, np. Base, który łączy się z PrestaShop kluczem Webservice, a z Kaufland kluczami API, przez dedykowany moduł PrestaShop od zewnętrznego dewelopera albo przez pliki - feed produktowy CSV wgrywany automatycznie z adresu URL i plik ofert. Niezależnie od drogi integracja musi przesyłać na Kaufland.de dane po niemiecku, ceny w euro i aktualne stany, a z powrotem pobierać zamówienia.
PrestaShop jest popularny wśród polskich sklepów, które mają rozbudowany katalog z kombinacjami i cechami produktów. To dobra baza do wejścia na niemiecki marketplace, bo dane produktowe są już uporządkowane. Kłopot w tym, że Kaufland.de ma własne wymagania co do formatu pliku, kategorii, atrybutów i języka, a polski sklep sprzedaje w złotych. W tym wpisie pokazujemy, jak wybrać sposób integracji, jak skonfigurować feed i synchronizację oraz na jakie błędy uważać.
[#wazne] W skrócie: integracja sklepu PrestaShop z Kaufland.de wymaga przesyłania danych produktowych po niemiecku (CSV z separatorem średnik i kodowaniem UTF-8 albo przez API), ofert z ceną w euro, stanem i czasem realizacji oraz pobierania zamówień. Najwygodniej robi się to przez Base, który synchronizuje stany, ceny i zamówienia między PrestaShop a Kaufland, albo przez dedykowany moduł (stan na wrzesień 2026 - sprawdź aktualne zasady Kaufland i pomoc dostawcy integracji). W Vinson pomagamy wejść na Kaufland.de, przygotować oferty po niemiecku i zintegrować sprzedaż z Base.
Integracja PrestaShop z Kaufland.de - trzy sposoby
Integracja sklepu z marketplace'em to automatyczna wymiana danych: produkty, ceny i stany płyną ze sklepu na marketplace, a zamówienia z marketplace'u do sklepu lub systemu obsługi. Kaufland Global Marketplace udostępnia do tego Seller API oraz import plików w Seller Portalu, a na stronach dla sprzedawców opisuje sieć partnerów technologicznych - systemów sklepowych, ERP i narzędzi pośredniczących. Dla sklepu na PrestaShop masz trzy praktyczne drogi.
| Sposób | Jak działa | Dla kogo |
|---|---|---|
| System wielokanałowy (np. Base) | PrestaShop łączy się z Base kluczem Webservice, Base z Kaufland kluczami API. Stany, ceny i zamówienia synchronizują się w jednym panelu | Sprzedawcy z kilkoma kanałami: sklep, Allegro, Kaufland.pl i Kaufland.de |
| Moduł PrestaShop | Moduł instalowany w sklepie przygotowuje dane i oferty dla Kaufland oraz importuje zamówienia do PrestaShop | Sklepy, które chcą obsługiwać wszystko w panelu PrestaShop |
| Pliki i URL | Feed produktowy CSV i plik ofert eksportowane ze sklepu, pobierane przez Kaufland z adresu URL o ustalonej godzinie | Mały katalog, rzadkie zmiany, zespół z zapleczem technicznym |
Przy module PrestaShop pamiętaj, że to rozwiązanie firmy trzeciej, a nie oficjalny moduł Kauflandu. Przykładowo producent modułu Kaufland Connector, firma silbersaiten, opisuje w nim eksport produktów, kombinacji, opisów, zdjęć i cech, mapowanie kategorii i atrybutów wymaganych, osobne feedy dla każdego rynku, synchronizację stanów i import zamówień do PrestaShop (stan na wrzesień 2026 - sprawdź aktualny opis i cenę u producenta modułu). Przed zakupem sprawdź zgodność z Twoją wersją PrestaShop i aktualizacje modułu.
[#chart:kde19a]
Co przygotować w PrestaShop przed integracją z Kaufland.de
Integracja przenosi dane, ale ich nie poprawia. Jeśli w sklepie brakuje EAN-ów albo cechy są wpisane w opisie zamiast w osobnych polach, te same braki pojawią się na Kaufland.de - tyle że tam skończą się odrzuceniem produktu. Przed połączeniem sprawdź w PrestaShop:
EAN dla każdego produktu i kombinacji. Kaufland identyfikuje produkt po EAN, a każda kombinacja, np. rozmiar czy kolor, potrzebuje własnego kodu.
Cechy w osobnych polach. Materiał, wymiary, waga czy pojemność muszą być cechami, a nie tylko zdaniem w opisie - z nich powstaną atrybuty Kaufland.
Niemiecką wersję językową. Tytuły, opisy i wartości cech po niemiecku, sprawdzone przez człowieka. Możesz je trzymać jako osobny język w sklepie lub w systemie wielokanałowym.
Zdjęcia bez napisów. Kaufland zaleca 5-10 zdjęć o boku min. 1024 px, pierwsze z całym produktem, bez kolaży i tekstu, a do zdjęć wymagany jest tekst alternatywny.
Dane producenta i GPSR. Kontakt do producenta, osoba odpowiedzialna w UE przy producencie spoza UE i informacje o bezpieczeństwie po niemiecku.
Szczegółowe wymagania dla atrybutów w niemieckich kategoriach zebraliśmy we wpisie Atrybuty i dane produktowe na Kaufland.de - co jest wymagane w niemieckich kategoriach.
- Ocena, czy Twój asortyment pasuje do platformy
- Wymagania, integracja i wystawienie ofert
- Plan startu krok po kroku
Konsultację poprowadzi Miłosz Brzegowy, Head of Growth and Demand GenerationIntegracja PrestaShop z Kaufland.de przez Base - konfiguracja
Base działa jako centrum: pobiera produkty i zamówienia ze sklepu, wystawia oferty na marketplace'ach i pilnuje, żeby stany i ceny były wszędzie takie same. Według pomocy Base konfiguracja dla PrestaShop i Kaufland.de wygląda następująco (stan na wrzesień 2026 - sprawdź aktualną pomoc Base):
Połącz PrestaShop z Base. W panelu PrestaShop wygeneruj klucz Webservice, nadaj mu odpowiednie uprawnienia i wklej go w ustawieniach integracji w Base. Przy kilku sklepach możesz połączyć konkretne identyfikatory sklepów.
Zaimportuj produkty. Integracja obsługuje import i eksport produktów i kategorii, więc katalog z PrestaShop trafia do magazynu Base.
Podłącz Kaufland.de. W panelu sprzedawcy Kaufland wygeneruj Client Key i Secret Key, a w Base dodaj integrację Kaufland dla regionu DE. Każdy rynek Kaufland to osobna integracja, co nie wpływa na wysokość abonamentu Base.
Zmapuj kategorie i parametry. W module Kaufland w zakładce kategorii i parametrów wybierz kategorie Kaufland i ustaw reguły mapowania parametrów, a w powiązaniach przypisz kategorie i szablony do kategorii z magazynu.
Ustaw ceny i stany. Stany i ceny w ofertach synchronizują się z produktami w magazynie, a cena może uwzględniać mnożnik dla konta. Cenę minimalną dla Smart Pricing wskazujesz przez grupę cenową.
Włącz zamówienia. Zamówienia z Kaufland.de trafiają do Base, a stamtąd mogą być przekazywane do sklepu PrestaShop. Numery przesyłek nadanych w Base wracają do Kaufland automatycznie.
Cały proces w skrócie, od klucza Webservice po zamówienia:
[#chart:kde19b]
Dwie rzeczy warto wiedzieć wcześniej. Według pomocy Base ofert wielowariantowych nie wystawisz bezpośrednio z Base - Kaufland łączy oferty algorytmicznie na podstawie tytułu i atrybutów, więc kombinacje z PrestaShop muszą mieć spójne nazwy i wartości cech. Druga sprawa to statusy: zmiany statusów w Base są przenoszone do Kaufland, ale nie w drugą stronę.
Kombinacje PrestaShop a warianty na Kaufland.de
Kombinacje w PrestaShop to warianty jednego produktu, np. koszulka w kilku rozmiarach i kolorach. Na Kaufland.de każdy wariant jest osobnym produktem z własnym EAN-em, a warianty łączą się na karcie dzięki spójnym atrybutom. Wytyczne Kaufland wymieniają jako typowe cechy wariantów wygląd, ilość, rozmiar i funkcję i zabraniają łączenia w warianty produktów niepowiązanych. W praktyce oznacza to, że nazwy atrybutów kombinacji w sklepie, np. „Rozmiar” i „Kolor”, muszą być zmapowane na właściwe atrybuty Kaufland, a ich wartości zapisane po niemiecku i jednakowo w całym katalogu. Każda kombinacja powinna mieć też własne zdjęcie, zwłaszcza przy wariantach kolorystycznych.
Niemiecka wersja językowa - w PrestaShop czy w Base?
Niemieckie tytuły i opisy możesz trzymać w dwóch miejscach. Jeśli planujesz niemiecką wersję własnego sklepu, dodaj język w PrestaShop i uzupełnij tłumaczenia tam - wtedy integracja pobierze gotowe teksty. Jeśli sklep zostaje tylko po polsku, wygodniej trzymać niemieckie dane w katalogu Base jako osobną wersję językową. Ważne, żeby było jedno miejsce edycji. Gdy część poprawek robisz w sklepie, a część w panelu Kaufland, kolejna synchronizacja może nadpisać poprawiony tekst. Niezależnie od miejsca tłumaczenie zawsze powinien sprawdzić człowiek znający niemiecki.
Feed produktowy z PrestaShop na Kaufland.de
Jeśli wybierasz drogę plikową albo moduł generujący feed, musisz znać wymagania Kaufland wobec pliku. Kaufland rozdziela dwa rodzaje danych: dane produktowe, czyli opis artykułu, i dane ofertowe, czyli cenę, stan, czas realizacji i koszty dostawy. Dane produktowe muszą istnieć, zanim powstanie oferta.
Format pliku produktowego. Według dokumentacji Seller API to plik CSV z separatorem średnik i kodowaniem UTF-8, z wierszem nagłówka zawierającym nazwy atrybutów.
Jeden wiersz, jeden produkt. Każdy wiersz ma EAN i locale, czyli wersję językową. Atrybut z wieloma wartościami, np. picture, zapisujesz w kilku kolumnach o tej samej nazwie.
Automatyczne pobieranie. W Seller Portalu, w zarządzaniu importami, podajesz adres URL pliku i godzinę, o której Kaufland ma go pobierać. Plik musi być dostępny pod stałym adresem.
Plik ofert. Inventory Feed zastępuje wszystkie oferty na danym kanale, a Inventory Command je uzupełnia lub aktualizuje poleceniami UPSERT, DELETE i FLUSH. SKU zapisujesz w polu id_offer.
Przy eksporcie z PrestaShop najwięcej uwagi wymagają ceny i język. Sklep sprzedaje w złotych, a Kaufland.de w euro, więc feed musi zawierać cenę przeliczoną i powiększoną o koszty specyficzne dla Niemiec: prowizję od 7% do 16% ceny brutto z dostawą, niemiecki VAT i wysyłkę z Polski (stan na wrzesień 2026 - sprawdź aktualny cennik Kaufland). Jak policzyć taką cenę, pokazujemy we wpisie Ceny na Kaufland.de - jak wycenić produkt z uwzględnieniem niemieckiej konkurencji. Uważaj też na plik Inventory Feed - produkt pominięty w eksporcie, np. przez filtr stanu, zniknie z oferty na Kaufland.de.
Synchronizacja stanów, cen i zamówień PrestaShop - Kaufland.de
Synchronizacja to serce integracji. Stan sprzedany na Kaufland.de musi od razu zmniejszyć stan w sklepie i na innych kanałach, a zmiana ceny w PrestaShop - trafić do oferty w euro. Przy wysyłce z Polski pilnuj też czasu realizacji. Kaufland ocenia sprzedawców m.in. po terminowości dostaw, obecności numerów śledzenia i odsetku anulacji, a przy tej samej cenie minimalnej Buy Box wygrywa oferta z szybszą dostawą.
Ustal z góry, który system jest źródłem prawdy dla stanów. Jeśli sprzedajesz ten sam towar w sklepie, na Allegro, Kaufland.pl i Kaufland.de, stany powinny być liczone w jednym miejscu, a wszystkie kanały powinny je tylko pobierać. Przy kilku źródłach łatwo o sprzedaż towaru, którego już nie ma, a anulacje szkodzą wskaźnikom jakości. Jeśli rozważasz magazyn w Niemczech u zewnętrznego operatora fulfillment (usługa Fulfillment by Kaufland została zakończona w lutym 2025 r.), stan towaru w tym magazynie trzeba uwzględnić osobno.
[#chart:kde19c]
[#uwaga] Zanim podłączysz cały katalog, wystaw kilkanaście produktów i przejdź pełny cykl: oferta aktywna, zamówienie testowe lub pierwsze zamówienie, numer przesyłki w Kaufland, zmiana stanu w PrestaShop. Sprawdź w Seller Portalu raporty błędów importu, nieznalezionych EAN-ów i nieprawidłowych produktów. Poprawki na małej partii kosztują mało, a na tysiącu produktów - dni pracy.
Najczęstsze błędy przy integracji PrestaShop z Kaufland.de
Pomoc Base wymienia kilka typowych komunikatów z Kaufland API. Błąd „400: Nieznany błąd” przy wystawianiu zwykle wynika z błędnych numerów EAN, np. ze spacją. „Product Data not found” może mieć kilka przyczyn, m.in. brak długiego opisu. Błąd dotyczący pola ItemUnit pojawia się, gdy automatyczna korekta ceny po stronie Kaufland zeszłaby poniżej ceny minimalnej. Przy integracji plikowej najczęstsze problemy to złe kodowanie znaków, przecinek zamiast średnika jako separator i polskie teksty w pliku przeznaczonym dla locale niemieckiego.
Po starcie zaplanuj stały przegląd. Raz w tygodniu sprawdź w Seller Portalu raporty o danych produktowych i raport GPSR, porównaj liczbę aktywnych ofert z liczbą produktów przeznaczonych na Kaufland.de i przejrzyj zamówienia anulowane z powodu braku towaru. Rozbieżności zwykle wskazują na produkty, które wypadły z eksportu, albo na kombinacje bez EAN-u. Przy zmianach w sklepie, np. nowej kategorii czy nowej cesze, od razu zaktualizuj mapowanie w integracji.
Jak Vinson pomaga zintegrować PrestaShop z Kaufland.de
W Vinson pomagamy sklepom na PrestaShop wejść na Kaufland.de. Łączymy sklep z Base, konfigurujemy moduł Kaufland dla rynku niemieckiego, mapujemy kategorie i parametry, ustawiamy ceny w euro, cenę minimalną i synchronizację stanów oraz zamówień. Przygotowujemy oferty po niemiecku, które zawsze sprawdza człowiek, i pomagamy uzupełnić dane GPSR. Jesteśmy agencją e-commerce z Bochni działającą od 2021 r., certyfikowanym partnerem Base, Allegro Ads Partner+, Google Partner i Meta Business Partner, z oceną 4,9/5 ze 171 opinii i ponad 500 firmami w portfolio. Zobacz sprzedaż na Kaufland.de z Vinson oraz wdrożenie Base.
Najczęściej zadawane pytania
Jak połączyć sklep PrestaShop z Kaufland.de?
Najprościej przez system wielokanałowy, np. Base: PrestaShop łączysz kluczem Webservice, a Kaufland kluczami Client Key i Secret Key z panelu sprzedawcy. Alternatywą jest dedykowany moduł PrestaShop od zewnętrznego dewelopera albo eksport plików CSV pobieranych przez Kaufland z adresu URL.
Czy Kaufland ma oficjalny moduł do PrestaShop?
Kaufland udostępnia Seller API i import plików oraz opisuje sieć partnerów technologicznych, ale moduły do PrestaShop, które znajdziesz na rynku, tworzą firmy trzecie. Przed wyborem sprawdź zgodność z Twoją wersją PrestaShop, obsługiwane rynki i to, czy moduł importuje zamówienia.
W jakim formacie musi być feed dla Kaufland.de?
Według dokumentacji Seller API plik danych produktowych to CSV z separatorem średnik i kodowaniem UTF-8, z wierszem nagłówka z nazwami atrybutów. Każdy wiersz ma EAN i locale. Oferty przesyłasz osobnym plikiem, np. Inventory Feed lub Inventory Command, w formacie CSV lub XML.
Czy zamówienia z Kaufland.de mogą trafiać do PrestaShop?
Tak. Przy integracji przez Base zamówienia z Kaufland.de trafiają do Base i mogą być przekazywane do sklepu internetowego. Część modułów PrestaShop importuje zamówienia bezpośrednio do sklepu. Ważne, żeby numery przesyłek wracały do Kaufland, bo wpływają na wskaźniki jakości.
Jak ustawić ceny w euro dla Kaufland.de ze sklepu w złotych?
Ceny dla Kaufland.de licz osobno, uwzględniając prowizję od ceny brutto z dostawą, niemiecki VAT i koszt wysyłki do Niemiec. W Base cenę w ofercie możesz wyliczać z ceny magazynowej z mnożnikiem dla konta. Przy zmianach kursu przeliczaj ceny minimalne okresowo.
Chcesz, żeby Twój sklep PrestaShop sprzedawał na Kaufland.de bez ręcznego przepisywania stanów i zamówień? Zobacz, jak prowadzimy sprzedaż na Kaufland.de z Vinson - od ofert po niemiecku po integrację sklepu z Base.
Integracja PrestaShop z Kaufland.de przez Base - konfiguracja
Base działa jako centrum: pobiera produkty i zamówienia ze sklepu, wystawia oferty na marketplace'ach i pilnuje, żeby stany i ceny były wszędzie takie same. Według pomocy Base konfiguracja dla PrestaShop i Kaufland.de wygląda następująco (stan na wrzesień 2026 - sprawdź aktualną pomoc Base):
Połącz PrestaShop z Base. W panelu PrestaShop wygeneruj klucz Webservice, nadaj mu odpowiednie uprawnienia i wklej go w ustawieniach integracji w Base. Przy kilku sklepach możesz połączyć konkretne identyfikatory sklepów.
Zaimportuj produkty. Integracja obsługuje import i eksport produktów i kategorii, więc katalog z PrestaShop trafia do magazynu Base.
Podłącz Kaufland.de. W panelu sprzedawcy Kaufland wygeneruj Client Key i Secret Key, a w Base dodaj integrację Kaufland dla regionu DE. Każdy rynek Kaufland to osobna integracja, co nie wpływa na wysokość abonamentu Base.
Zmapuj kategorie i parametry. W module Kaufland w zakładce kategorii i parametrów wybierz kategorie Kaufland i ustaw reguły mapowania parametrów, a w powiązaniach przypisz kategorie i szablony do kategorii z magazynu.
Ustaw ceny i stany. Stany i ceny w ofertach synchronizują się z produktami w magazynie, a cena może uwzględniać mnożnik dla konta. Cenę minimalną dla Smart Pricing wskazujesz przez grupę cenową.
Włącz zamówienia. Zamówienia z Kaufland.de trafiają do Base, a stamtąd mogą być przekazywane do sklepu PrestaShop. Numery przesyłek nadanych w Base wracają do Kaufland automatycznie.
Cały proces w skrócie, od klucza Webservice po zamówienia:
[#chart:kde19b]
Dwie rzeczy warto wiedzieć wcześniej. Według pomocy Base ofert wielowariantowych nie wystawisz bezpośrednio z Base - Kaufland łączy oferty algorytmicznie na podstawie tytułu i atrybutów, więc kombinacje z PrestaShop muszą mieć spójne nazwy i wartości cech. Druga sprawa to statusy: zmiany statusów w Base są przenoszone do Kaufland, ale nie w drugą stronę.
Kombinacje PrestaShop a warianty na Kaufland.de
Kombinacje w PrestaShop to warianty jednego produktu, np. koszulka w kilku rozmiarach i kolorach. Na Kaufland.de każdy wariant jest osobnym produktem z własnym EAN-em, a warianty łączą się na karcie dzięki spójnym atrybutom. Wytyczne Kaufland wymieniają jako typowe cechy wariantów wygląd, ilość, rozmiar i funkcję i zabraniają łączenia w warianty produktów niepowiązanych. W praktyce oznacza to, że nazwy atrybutów kombinacji w sklepie, np. „Rozmiar” i „Kolor”, muszą być zmapowane na właściwe atrybuty Kaufland, a ich wartości zapisane po niemiecku i jednakowo w całym katalogu. Każda kombinacja powinna mieć też własne zdjęcie, zwłaszcza przy wariantach kolorystycznych.
Niemiecka wersja językowa - w PrestaShop czy w Base?
Niemieckie tytuły i opisy możesz trzymać w dwóch miejscach. Jeśli planujesz niemiecką wersję własnego sklepu, dodaj język w PrestaShop i uzupełnij tłumaczenia tam - wtedy integracja pobierze gotowe teksty. Jeśli sklep zostaje tylko po polsku, wygodniej trzymać niemieckie dane w katalogu Base jako osobną wersję językową. Ważne, żeby było jedno miejsce edycji. Gdy część poprawek robisz w sklepie, a część w panelu Kaufland, kolejna synchronizacja może nadpisać poprawiony tekst. Niezależnie od miejsca tłumaczenie zawsze powinien sprawdzić człowiek znający niemiecki.
Feed produktowy z PrestaShop na Kaufland.de
Jeśli wybierasz drogę plikową albo moduł generujący feed, musisz znać wymagania Kaufland wobec pliku. Kaufland rozdziela dwa rodzaje danych: dane produktowe, czyli opis artykułu, i dane ofertowe, czyli cenę, stan, czas realizacji i koszty dostawy. Dane produktowe muszą istnieć, zanim powstanie oferta.
Format pliku produktowego. Według dokumentacji Seller API to plik CSV z separatorem średnik i kodowaniem UTF-8, z wierszem nagłówka zawierającym nazwy atrybutów.
Jeden wiersz, jeden produkt. Każdy wiersz ma EAN i locale, czyli wersję językową. Atrybut z wieloma wartościami, np. picture, zapisujesz w kilku kolumnach o tej samej nazwie.
Automatyczne pobieranie. W Seller Portalu, w zarządzaniu importami, podajesz adres URL pliku i godzinę, o której Kaufland ma go pobierać. Plik musi być dostępny pod stałym adresem.
Plik ofert. Inventory Feed zastępuje wszystkie oferty na danym kanale, a Inventory Command je uzupełnia lub aktualizuje poleceniami UPSERT, DELETE i FLUSH. SKU zapisujesz w polu id_offer.
Przy eksporcie z PrestaShop najwięcej uwagi wymagają ceny i język. Sklep sprzedaje w złotych, a Kaufland.de w euro, więc feed musi zawierać cenę przeliczoną i powiększoną o koszty specyficzne dla Niemiec: prowizję od 7% do 16% ceny brutto z dostawą, niemiecki VAT i wysyłkę z Polski (stan na wrzesień 2026 - sprawdź aktualny cennik Kaufland). Jak policzyć taką cenę, pokazujemy we wpisie Ceny na Kaufland.de - jak wycenić produkt z uwzględnieniem niemieckiej konkurencji. Uważaj też na plik Inventory Feed - produkt pominięty w eksporcie, np. przez filtr stanu, zniknie z oferty na Kaufland.de.
Synchronizacja stanów, cen i zamówień PrestaShop - Kaufland.de
Synchronizacja to serce integracji. Stan sprzedany na Kaufland.de musi od razu zmniejszyć stan w sklepie i na innych kanałach, a zmiana ceny w PrestaShop - trafić do oferty w euro. Przy wysyłce z Polski pilnuj też czasu realizacji. Kaufland ocenia sprzedawców m.in. po terminowości dostaw, obecności numerów śledzenia i odsetku anulacji, a przy tej samej cenie minimalnej Buy Box wygrywa oferta z szybszą dostawą.
Ustal z góry, który system jest źródłem prawdy dla stanów. Jeśli sprzedajesz ten sam towar w sklepie, na Allegro, Kaufland.pl i Kaufland.de, stany powinny być liczone w jednym miejscu, a wszystkie kanały powinny je tylko pobierać. Przy kilku źródłach łatwo o sprzedaż towaru, którego już nie ma, a anulacje szkodzą wskaźnikom jakości. Jeśli rozważasz magazyn w Niemczech u zewnętrznego operatora fulfillment (usługa Fulfillment by Kaufland została zakończona w lutym 2025 r.), stan towaru w tym magazynie trzeba uwzględnić osobno.
[#chart:kde19c]
[#uwaga] Zanim podłączysz cały katalog, wystaw kilkanaście produktów i przejdź pełny cykl: oferta aktywna, zamówienie testowe lub pierwsze zamówienie, numer przesyłki w Kaufland, zmiana stanu w PrestaShop. Sprawdź w Seller Portalu raporty błędów importu, nieznalezionych EAN-ów i nieprawidłowych produktów. Poprawki na małej partii kosztują mało, a na tysiącu produktów - dni pracy.
Najczęstsze błędy przy integracji PrestaShop z Kaufland.de
Pomoc Base wymienia kilka typowych komunikatów z Kaufland API. Błąd „400: Nieznany błąd” przy wystawianiu zwykle wynika z błędnych numerów EAN, np. ze spacją. „Product Data not found” może mieć kilka przyczyn, m.in. brak długiego opisu. Błąd dotyczący pola ItemUnit pojawia się, gdy automatyczna korekta ceny po stronie Kaufland zeszłaby poniżej ceny minimalnej. Przy integracji plikowej najczęstsze problemy to złe kodowanie znaków, przecinek zamiast średnika jako separator i polskie teksty w pliku przeznaczonym dla locale niemieckiego.
Po starcie zaplanuj stały przegląd. Raz w tygodniu sprawdź w Seller Portalu raporty o danych produktowych i raport GPSR, porównaj liczbę aktywnych ofert z liczbą produktów przeznaczonych na Kaufland.de i przejrzyj zamówienia anulowane z powodu braku towaru. Rozbieżności zwykle wskazują na produkty, które wypadły z eksportu, albo na kombinacje bez EAN-u. Przy zmianach w sklepie, np. nowej kategorii czy nowej cesze, od razu zaktualizuj mapowanie w integracji.
Jak Vinson pomaga zintegrować PrestaShop z Kaufland.de
W Vinson pomagamy sklepom na PrestaShop wejść na Kaufland.de. Łączymy sklep z Base, konfigurujemy moduł Kaufland dla rynku niemieckiego, mapujemy kategorie i parametry, ustawiamy ceny w euro, cenę minimalną i synchronizację stanów oraz zamówień. Przygotowujemy oferty po niemiecku, które zawsze sprawdza człowiek, i pomagamy uzupełnić dane GPSR. Jesteśmy agencją e-commerce z Bochni działającą od 2021 r., certyfikowanym partnerem Base, Allegro Ads Partner+, Google Partner i Meta Business Partner, z oceną 4,9/5 ze 171 opinii i ponad 500 firmami w portfolio. Zobacz sprzedaż na Kaufland.de z Vinson oraz wdrożenie Base.
Najczęściej zadawane pytania
Jak połączyć sklep PrestaShop z Kaufland.de?
Najprościej przez system wielokanałowy, np. Base: PrestaShop łączysz kluczem Webservice, a Kaufland kluczami Client Key i Secret Key z panelu sprzedawcy. Alternatywą jest dedykowany moduł PrestaShop od zewnętrznego dewelopera albo eksport plików CSV pobieranych przez Kaufland z adresu URL.
Czy Kaufland ma oficjalny moduł do PrestaShop?
Kaufland udostępnia Seller API i import plików oraz opisuje sieć partnerów technologicznych, ale moduły do PrestaShop, które znajdziesz na rynku, tworzą firmy trzecie. Przed wyborem sprawdź zgodność z Twoją wersją PrestaShop, obsługiwane rynki i to, czy moduł importuje zamówienia.
W jakim formacie musi być feed dla Kaufland.de?
Według dokumentacji Seller API plik danych produktowych to CSV z separatorem średnik i kodowaniem UTF-8, z wierszem nagłówka z nazwami atrybutów. Każdy wiersz ma EAN i locale. Oferty przesyłasz osobnym plikiem, np. Inventory Feed lub Inventory Command, w formacie CSV lub XML.
Czy zamówienia z Kaufland.de mogą trafiać do PrestaShop?
Tak. Przy integracji przez Base zamówienia z Kaufland.de trafiają do Base i mogą być przekazywane do sklepu internetowego. Część modułów PrestaShop importuje zamówienia bezpośrednio do sklepu. Ważne, żeby numery przesyłek wracały do Kaufland, bo wpływają na wskaźniki jakości.
Jak ustawić ceny w euro dla Kaufland.de ze sklepu w złotych?
Ceny dla Kaufland.de licz osobno, uwzględniając prowizję od ceny brutto z dostawą, niemiecki VAT i koszt wysyłki do Niemiec. W Base cenę w ofercie możesz wyliczać z ceny magazynowej z mnożnikiem dla konta. Przy zmianach kursu przeliczaj ceny minimalne okresowo.
Chcesz, żeby Twój sklep PrestaShop sprzedawał na Kaufland.de bez ręcznego przepisywania stanów i zamówień? Zobacz, jak prowadzimy sprzedaż na Kaufland.de z Vinson - od ofert po niemiecku po integrację sklepu z Base.
Miłosz Brzegowy
Head of Growth and Demand Generation
Buduje strategie wzrostu i wejścia na nowe kanały sprzedaży. Łączy dane, kanały i treści w przewidywalny system.
Buduje strategie wzrostu i wejścia na nowe kanały sprzedaży. Łączy dane, kanały i treści w przewidywalny system.
Sprzedaż na Kaufland.de z Vinson
Miłosz i nasz zespół pomogą Ci wdrożyć to na Twoim koncie - bez zobowiązań.
- Analiza Twojego konta i obecnych działań
- Konkretny plan poprawek do wdrożenia
- Bezpłatna konsultacja – bez zobowiązań
Przeczytaj także
Więcej porad z naszej bazy wiedzy - przesuń, aby zobaczyć kolejne artykuły.
Masz pytania? Chętnie porozmawiamy!
Masz pytania? Chętnie porozmawiamy!
Odpowiadamy w ciągu 24 godzin w dni robocze. Pierwsza rozmowa jest bezpłatna i do niczego nie zobowiązuje.
Masz pytania? Chętnie porozmawiamy!
Odpowiadamy w ciągu 24 godzin w dni robocze. Pierwsza rozmowa jest bezpłatna i do niczego nie zobowiązuje.
Bartłomiej Stokłosa
CEO & Founder
"Jeżeli czegoś nie da się zrobić, potrzebny jest ktoś, kto o tym nie wie - przyjdzie i to zrobi."
Bartłomiej Stokłosa
CEO & Founder
"Jeżeli czegoś nie da się zrobić, potrzebny jest ktoś, kto o tym nie wie - przyjdzie i to zrobi."
Wybierz dogodny termin w kalendarzu - bez wymiany maili w tę i z powrotem.
Napisz do nas
Opisz krótko, czego potrzebujesz - oddzwonimy lub odpiszemy w ciągu 24 godzin w dni robocze.
Na zapytanie odpowie Miłosz Brzegowy, Head of Growth and Demand GenerationNapisz do nas
Opisz krótko, czego potrzebujesz - oddzwonimy lub odpiszemy w ciągu 24 godzin w dni robocze.
Na zapytanie odpowie Miłosz Brzegowy, Head of Growth and Demand Generation