Pola obowiązkowe w feedzie produktowym Kaufland.de
Według strony o atrybutach obowiązkowych w Seller University plik danych produktowych musi zawierać co najmniej sześć atrybutów dla wszystkich kategorii. Bez nich dane produktowe są nieprawidłowe i produkt nie wyświetla się na marketplace'ach (stan na październik 2026 - sprawdź aktualne zasady Kaufland).
| Atrybut | Co zawiera | Na co uważać |
|---|
| ean | Kod EAN (GTIN) produktu | Bez spacji i liter, jeden kod dla jednego produktu |
| category | Kategoria z drzewa Kaufland.de | Najbardziej szczegółowa kategoria - od niej zależą atrybuty prawne |
| title | Tytuł po niemiecku | Zalecane 50-80 znaków, bez haseł promocyjnych |
| description | Opis po niemiecku | Zalecane 150-5 000 znaków, bez cen, wysyłki i danych kontaktowych |
| manufacturer | Producent | Ta sama nazwa co w danych GPSR |
| picture | Zdjęcia produktu | Link do pliku, zalecane 5-10 zdjęć, maks. 10 MB, z tekstem alternatywnym |
Uwaga na kolumnę category. Dokumentacja Seller API dopuszcza w pliku pustą kategorię, a Seller University wymienia ją wśród atrybutów obowiązkowych dla nowych produktów. Bezpieczna praktyka: zawsze podawaj kategorię dla produktów, których nie ma w katalogu Kaufland.de. Jak dobrać kategorię z drzewa Kauflandu do polskiego katalogu, opisujemy we wpisie Kategorie na Kaufland.de - mapowanie produktów z polskiego katalogu na niemieckie.
Atrybuty kategorii i dane bezpieczeństwa w feedzie
Poza sześcioma polami ogólnymi w wielu kategoriach obowiązkowe są atrybuty wymagane prawem: material_composition dla tekstyliów, safety_guidelines z ostrzeżeniami zaczynającymi się od „Achtung!” dla zabawek, energy_efficiency_class i energylabel dla lamp i dużego AGD, a dla żywności m.in. składniki i wartości odżywcze. Przy produktach sprzedawanych na wagę, objętość lub długość dochodzą weight, content_volume lub length, z których Kaufland wylicza cenę jednostkową. Plik z atrybutami obowiązkowymi dla każdej kategorii udostępnia Seller University. Pełne zestawienie znajdziesz też w naszym wpisie Atrybuty i dane produktowe na Kaufland.de - co jest wymagane w niemieckich kategoriach.
Feed to także droga do przekazania danych GPSR. Według Seller University informacje o bezpieczeństwie (safety_guidelines), kartę charakterystyki (safety_data_sheet) i certyfikat CE (ce_certificate) możesz przesłać przez API, CSV albo ręcznie. Kontakty producenta i osoby odpowiedzialnej w UE Kaufland zaleca natomiast wpisywać jako reguły producenta na stronie GPSR w Seller Portalu, bo wtedy obejmują także przyszłe produkty.
Jak zbudować feed z eksportu polskiego sklepu
Najczęściej punktem wyjścia jest eksport produktów ze sklepu, hurtowni lub systemu magazynowego. Taki plik ma zwykle polskie nazwy kolumn, ceny w złotych i opisy z informacjami o wysyłce, których w danych produktowych Kaufland umieszczać nie wolno. Zamiast poprawiać go ręcznie przy każdej aktualizacji, zbuduj arkusz mapowania: kolumna ze sklepu, nazwa atrybutu Kaufland, reguła przekształcenia i źródło niemieckiego tekstu. Osobno przygotuj tabelę kategorii, w której każdej kategorii sklepu przypisujesz kategorię Kaufland.de. Dzięki temu kolejny eksport zamieniasz na feed według tych samych reguł, a błędy poprawiasz raz, w regule, a nie w setkach wierszy.
Ustal też, jak często feed ma się aktualizować. Dane produktowe zmieniają się rzadziej niż ceny i stany, więc plik produktowy możesz pobierać np. raz dziennie, a oferty aktualizować częściej przez plik ofert lub integrację. Przy każdej zmianie w szablonie kategorii po stronie Kaufland sprawdź, czy feed nadal zawiera wszystkie wymagane kolumny.
Jak wgrać feed produktowy na Kaufland.de
Seller University opisuje dwie drogi przesłania pliku danych produktowych przez Seller Portal (stan na październik 2026 - sprawdź aktualne zasady Kaufland). Trzecią jest Seller API, z którego korzystają integracje i systemy wielokanałowe.
Ręczny import. W zarządzaniu ofertami otwórz zarządzanie importami, przejdź do poprzednich importów i zakładki importów danych produktowych, wybierz wgranie pliku danych produktowych i potwierdź.
Automatyczne pobieranie z URL. W zarządzaniu importami wybierz automatyczne przesyłanie danych produktowych, podaj adres URL pliku i godzinę, o której Kaufland ma go pobierać, a potem zapisz zmiany. Plik musi być dostępny pod stałym adresem.
Seller API. Dane produktowe możesz przesyłać przez Kaufland Seller API - tak działają integracje, np. moduł Kaufland w Base, w którym kategorie i parametry mapujesz w panelu zamiast w pliku.
Pamiętaj o pliku ofert. Kaufland przyjmuje dwa typy plików ofertowych w formacie CSV lub XML. Inventory Feed zastępuje wszystkie istniejące oferty na danym kanale - oferty, których nie ma w pliku, są usuwane. Inventory Command uzupełnia lub aktualizuje oferty poleceniami UPSERT, DELETE i FLUSH. W plikach ofert SKU zapisujesz w polu id_offer i musisz je nadać przed utworzeniem oferty, bo do istniejącej oferty nie dodasz go później. Plik ofert zawiera też czas realizacji, cenę minimalną dla Smart Pricing i stan produktu, np. kod 100 dla nowego.
[#chart:kde20b]
Walidacja feedu produktowego dla Kaufland.de
Walidacja to sprawdzenie pliku przed wysłaniem i kontrola wyniku po imporcie. Pierwsza część oszczędza czas, bo błąd w strukturze pliku potrafi zablokować całą partię. Druga pokazuje błędy, których nie wyłapiesz w arkuszu, np. EAN-y bez danych w katalogu. Przed wysłaniem sprawdź:
Kodowanie i separator. Zapisz plik jako CSV UTF-8 z separatorem średnik. Arkusz w polskich ustawieniach regionalnych potrafi zapisać średnik lub przecinek inaczej, niż zakładasz - otwórz plik w edytorze tekstu i sprawdź.
Nazwy kolumn. Porównaj nagłówek z szablonem kategorii z Seller Portalu. Literówka w nazwie atrybutu oznacza, że kolumna zostanie pominięta.
EAN-y. Bez spacji, liter i zgubionych zer na początku, które arkusz lubi usuwać przy formacie liczbowym.
Locale i język. Każdy wiersz ma locale dla Niemiec, a teksty są po niemiecku i sprawdzone przez człowieka.
Zdjęcia. Każdy link do zdjęcia działa i prowadzi bezpośrednio do pliku. Brak linku przy wypełnionym tekście alternatywnym kończy się błędem.
Atrybuty kategorii. Dla każdej kategorii w pliku wypełnione są atrybuty obowiązkowe.
Po imporcie zajrzyj do raportów o danych produktowych w Seller Portalu. Raport błędów importu pokazuje dane odrzucone przy wczytaniu pliku, raport nieznalezionych EAN-ów - kody bez danych produktowych, które możesz uzupełnić i zaimportować ponownie, a raport nieprawidłowych produktów - produkty, których nie możesz oferować z powodu braków. Eksport poprawy danych produktowych daje przegląd jakości danych według kategorii i kanałów sprzedaży. Prostą miarą jakości feedu jest odsetek odrzuconych wierszy. Licz go po każdym imporcie i porównuj między partiami - rosnący odsetek zwykle oznacza zmianę w eksporcie ze sklepu albo w szablonie kategorii.
[#chart:kde20c]
[#tip] Zanim wyślesz pełny katalog, zaimportuj plik z kilkunastoma produktami z każdej kategorii. Błąd w nagłówku albo w kodowaniu wyjdzie wtedy na małej próbce, a poprawiony szablon wykorzystasz do całego feedu. Przy zdjęciach sprawdź też, czy grafiki z polskimi napisami z innych kanałów nie trafiły do pliku - zasady dotyczące zdjęć na rynku polskim opisujemy w poradniku Zdjęcia produktów na Kaufland.pl - wymagania techniczne i błędy blokujące ofertę.
Feed z pliku czy integracja przez Base?
Plik CSV sprawdza się przy jednorazowym wystawieniu katalogu albo rzadkich zmianach. Przy sprzedaży na kilku kanałach, zmiennych stanach i cenach wygodniejsza jest integracja przez API. W Base dane produktowe trzymasz w jednym katalogu, kategorie i parametry mapujesz w module Kaufland, a stany i ceny synchronizują się automatycznie. Według pomocy Base najczęstszy błąd przy wystawianiu, „400: Nieznany błąd”, wynika z błędnego EAN-u, np. ze spacją - te same zasady czystości danych obowiązują więc niezależnie od drogi. Integracja nie zwalnia też z niemieckich tekstów i atrybutów kategorii - zmienia tylko miejsce, w którym je utrzymujesz.
Jak Vinson pomaga z feedem produktowym na Kaufland.de
W Vinson przygotowujemy dane produktowe polskich sprzedawców na Kaufland.de. Mapujemy kategorie, uzupełniamy atrybuty obowiązkowe i dane GPSR, tworzymy oferty po niemiecku, które zawsze sprawdza człowiek, i konfigurujemy przesyłanie danych - przez feed lub przez integrację w Base, z synchronizacją stanów, cen i zamówień. Pomagamy też odczytać raporty błędów importu i poprawić dane u źródła. 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
W jakim formacie musi być feed dla Kaufland.de?
Plik danych produktowych to CSV z separatorem średnik i kodowaniem UTF-8, z wierszem nagłówka zawierającym nazwy atrybutów. Każdy wiersz opisuje jeden produkt i ma EAN oraz locale. Pliki ofert, np. Inventory Feed i Inventory Command, przyjmowane są w formacie CSV lub XML.
Jakie pola są obowiązkowe w pliku produktowym Kaufland?
Dla wszystkich kategorii obowiązkowe są ean, category, title, description, manufacturer i picture. W wielu kategoriach dochodzą atrybuty wymagane prawem, np. skład materiałowy, ostrzeżenia dla zabawek czy klasa energetyczna. Bez atrybutów obowiązkowych produkt nie wyświetla się na marketplace'ach.
Jak ustawić automatyczne pobieranie feedu na Kaufland.de?
W Seller Portalu, w zarządzaniu importami, wybierz automatyczne przesyłanie danych produktowych, podaj adres URL pliku i godzinę pobierania, a potem zapisz zmiany. Plik musi być dostępny na serwerze pod stałym adresem. Wynik importu sprawdzisz w raportach o danych produktowych.
Czym różni się feed produktowy od pliku ofert na Kaufland.de?
Feed produktowy opisuje produkt: tytuł, opis, zdjęcia, kategorię i atrybuty. Plik ofert zawiera dane handlowe: cenę, stan, czas realizacji, cenę minimalną i SKU w polu id_offer. Dane produktowe muszą istnieć przed utworzeniem oferty, a dla produktów już obecnych w katalogu wystarczy sam plik ofert.
Dlaczego produkty z feedu nie pojawiły się na Kaufland.de?
Najczęstsze przyczyny to błąd struktury pliku, np. złe kodowanie lub separator, brakujące atrybuty obowiązkowe albo błędny EAN. Sprawdź w Seller Portalu raport błędów importu, raport nieznalezionych EAN-ów i raport nieprawidłowych produktów. Oferta może też zostać wykluczona z powodu brakujących danych GPSR.
Chcesz wystawić katalog na Kaufland.de jednym poprawnym feedem, zamiast poprawiać setki odrzuconych produktów? Zobacz, jak prowadzimy sprzedaż na Kaufland.de z Vinson - od danych produktowych po niemiecku po integrację z Base.
