Import ofert na Kaufland.pl z pliku CSV - jak przygotować i wgrać produkty

Plik ofert na Kaufland.pl - Inventory Feed czy Inventory Command

Pliki ofert występują w dwóch typach i to rozróżnienie jest najważniejsze w całym imporcie. Inventory Feed zastępuje istniejące oferty: oferty, których nie ma w pliku, zostaną w danym kanale usunięte. Inventory Command uzupełnia lub aktualizuje istniejące oferty poleceniami. UPSERT dodaje nową ofertę albo aktualizuje istniejącą, DELETE usuwa ofertę po EAN (z opcjonalnym id_offer, żeby usunąć tylko jedną ofertę), a FLUSH usuwa wszystkie oferty z kanału, przez który wysłano plik (stan na sierpień 2026 - sprawdź aktualne zasady w Seller University).

[#chart:kpl19b]

Bez względu na typ pliku kilka kolumn wymaga szczególnej uwagi. Kaufland opisuje je w materiałach o danych oferty, a pełną specyfikację znajdziesz w plikach przykładowych i schemacie udostępnianym w Seller University:

• id_offer (SKU) - Twój numer oferty. Wpisz go przed sfinalizowaniem oferty, bo do istniejących ofert nie da się go dodać. Kombinacja EAN i SKU obowiązuje we wszystkich krajach i kanałach.

• condition - stan towaru jako liczba, np. 100 dla nowego, 200-500 dla używanego i 110-140 dla odnowionego.

• handling_time - czas realizacji, czyli czas potrzebny na skompletowanie i spakowanie zamówienia, w dniach roboczych.

• vat_indicator - wskaźnik stawki VAT; bez niego Kaufland przyjmie standardową, najwyższą stawkę dla kanału.

• cena i stan - format ceny sprawdź w pliku przykładowym; w Seller API ceny podaje się jako liczbę całkowitą w groszach.

Jeśli nie podasz czasu realizacji w pliku, możesz ustawić wartość domyślną w konfiguracji pliku ofert w zarządzaniu importami. Działa ona tylko wtedy, gdy w pliku brakuje tej informacji. Pamiętaj, że czas dostawy widoczny dla klienta to suma czasu realizacji i czasu transportu z grupy wysyłkowej, liczona w dniach roboczych.

[#uwaga] Inventory Feed usuwa z kanału wszystkie oferty, których nie ma w pliku. Jeśli wgrasz plik z jedną kategorią produktów, oferty z pozostałych kategorii znikną. Do aktualizacji części katalogu używaj Inventory Command z poleceniem UPSERT, a Inventory Feed tylko wtedy, gdy plik zawiera pełną, aktualną listę ofert.

Jak wgrać plik CSV na Kaufland.pl krok po kroku

Pliki wgrywasz w Seller Portal, w zarządzaniu ofertami. Według Seller University ścieżka dla danych produktu wygląda następująco (stan na sierpień 2026 - sprawdź aktualny wygląd panelu):

1. Otwórz zarządzanie ofertami i zarządzanie importami - tam znajdziesz historię importów.

2. Przejdź do poprzednich importów i zakładki importów danych produktu - dla plików z kartami produktów.

3. Wybierz wgranie pliku z danymi produktu - wskaż plik CSV i potwierdź.

4. Wgraj plik ofert - po przetworzeniu danych produktu, żeby oferty miały karty, do których się połączą.

5. Sprawdź raporty - nieznalezione EAN, nieprawidłowe artykuły i błędy importu pliku danych produktu.

Zamiast ręcznego wgrywania możesz ustawić automatyczny import. W zarządzaniu importami podajesz adres URL, pod którym system Kaufland znajdzie plik CSV, i określasz godzinę, o której ma go pobierać. To dobre rozwiązanie, gdy Twój sklep lub hurtownia generuje plik produktowy automatycznie, ale wymaga pilnowania, żeby plik pod adresem był zawsze kompletny.

Typowe błędy importu ofert na Kaufland.pl

Import bez komunikatu błędu nie oznacza jeszcze, że oferty są widoczne dla klientów. Kaufland ocenia dane po przetworzeniu, dlatego zawsze zaglądaj do raportów z informacjami o danych produktu. Najczęstsze kłopoty i ich rozwiązania zebraliśmy poniżej.

[#chart:kpl19c]

• Pusty atrybut obowiązkowy - produkt trafia do nieprawidłowych artykułów i nie jest widoczny w sklepie.

• EAN bez karty w katalogu - oferta nie powstaje, a kod pojawia się w raporcie nieznalezionych EAN.

• Tekst alternatywny bez linku do zdjęcia - wywołuje błąd importu pliku danych produktu.

• SKU już użyte z innym EAN - ta sama kombinacja EAN i SKU obowiązuje we wszystkich kanałach.

• Zła kategoria - brakuje atrybutów wymaganych w kategorii, a produkt nie pojawia się w filtrach.

Przy zdjęciach najczęściej zawodzą linki: plik wskazuje adres, który wymaga logowania, wygasł albo prowadzi do miniatury. Wymagania techniczne zdjęć i błędy, które blokują oferty, opisujemy we wpisie zdjęcia produktów na Kaufland.pl - wymagania techniczne.

Arkusz kalkulacyjny a plik CSV - pułapki przy zapisie

Wiele błędów importu nie wynika z danych, tylko z programu, w którym przygotowujesz plik. Arkusze kalkulacyjne potrafią zamienić 13-cyfrowy EAN na zapis naukowy albo usunąć zera z początku kodu. Polskie znaki w tytułach i opisach mogą się zepsuć, jeśli plik zapiszesz w innym kodowaniu niż oczekiwane. Separator kolumn bywa zamieniany zależnie od ustawień regionalnych systemu. Dlatego kolumnę z EAN ustaw jako tekst, a przed wgraniem porównaj swój plik z plikiem przykładowym Kaufland: kodowanie, separator i format liczb powinny być takie same.

Dobrą praktyką jest też próbny import kilku produktów przed wgraniem całego katalogu. Jeśli w pięciu wierszach pojawi się błąd, poprawisz go w kilka minut. Jeśli ten sam błąd powtórzy się w pięciu tysiącach wierszy, stracisz dzień na analizę raportu.

Aktualizacja istniejących ofert z raportu

Gdy oferty są już na Kaufland.pl, nie musisz budować pliku od zera. Raport z Twoimi oferowanymi artykułami zawiera wszystkie aktualne oferty z danymi oferty i według Seller University może posłużyć do ich aktualizacji przez ponowne wgranie pliku CSV. Pobierz raport, zmień ceny lub stany i wgraj plik z powrotem jako Inventory Command.

Import CSV czy integracja - co wybrać na Kaufland.pl

Plik CSV świetnie sprawdza się przy starcie i przy jednorazowych zmianach: założeniu kart, pierwszym wystawieniu ofert, zmianie cen przed sezonem. Gorzej radzi sobie ze stanami magazynowymi, które zmieniają się po każdej sprzedaży na innych kanałach. Jeśli sprzedajesz ten sam towar na Allegro, w sklepie i na Kaufland.pl, ręczne wgrywanie plików ze stanami raz dziennie prędzej czy później skończy się sprzedażą produktu, którego już nie ma. Wtedy lepsza jest integracja przez system do obsługi sprzedaży, która aktualizuje stany automatycznie.

W praktyce te podejścia się uzupełniają. Wielu sprzedawców zakłada karty produktów plikiem CSV, bo tak najszybciej przygotować i sprawdzić duży katalog, a bieżące oferty, ceny i stany przekazuje już przez integrację. Ważne, żeby po starcie integracji nie wgrywać ręcznie plików ofert, które nadpiszą dane przesyłane automatycznie - wtedy dwa źródła zaczynają ze sobą konkurować.

Ile kosztuje wystawienie ofert na Kaufland.pl

Import plików CSV nie jest dodatkowo płatny. Płacisz standardowe opłaty sprzedawcy: plan Basic za 175 zł lub Plus za 260 zł netto miesięcznie, oba z kredytem 130 zł na Sponsored Product Ads, oraz prowizję od sprzedaży od 4% do 12% zależnie od kategorii, w większości kategorii 10%. Prowizja jest liczona od ceny brutto razem z kosztem dostawy, a do niej doliczany jest VAT (stan na sierpień 2026 - sprawdź aktualny cennik Kaufland). Uwzględnij to w cenach, zanim wpiszesz je do pliku ofert.

Jak Vinson pomaga z importem ofert na Kaufland.pl

W Vinson przygotowujemy katalog produktów do wejścia na Kaufland.pl: mapujemy kategorie, uzupełniamy atrybuty, sprawdzamy EAN-y i zdjęcia, a potem wystawiamy oferty - plikiem przy jednorazowym imporcie albo przez integrację z Base, gdy stany i ceny mają się aktualizować same. Po imporcie przeglądamy raporty Kaufland i poprawiamy dane u źródła, żeby błędy nie wracały przy kolejnym wgraniu. 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. Szczegóły znajdziesz na stronie sprzedaż na Kaufland.pl z Vinson, a o integracji przeczytasz na stronie wdrożenie Base.

Najczęściej zadawane pytania

Jak wgrać produkty na Kaufland.pl z pliku CSV?

Przygotuj plik z danymi produktu na szablonie kategorii z Seller Portal i wgraj go w zarządzaniu importami, w zakładce importów danych produktu. Następnie wgraj plik ofert z ceną, stanem, stanem towaru, czasem realizacji i SKU. Na koniec sprawdź raporty nieznalezionych EAN i nieprawidłowych artykułów.

Czym różni się Inventory Feed od Inventory Command?

Inventory Feed zastępuje wszystkie istniejące oferty w kanale - oferty spoza pliku zostaną usunięte. Inventory Command tylko dodaje, aktualizuje lub usuwa oferty wskazane w pliku poleceniami UPSERT, DELETE lub FLUSH. Do częściowych zmian bezpieczniejszy jest Inventory Command.

Czy muszę wgrywać plik z danymi produktu, jeśli produkt jest już na Kaufland.pl?

Nie. Jeśli EAN jest już w katalogu, wystarczy plik ofert - Kaufland połączy Twoją ofertę z istniejącą kartą. Przed tym porównaj dane na karcie ze swoim produktem, bo odpowiadasz za zgodność tego, co sprzedajesz, z tym, co widzi klient.

Dlaczego po imporcie CSV nie widzę ofert na Kaufland.pl?

Najczęściej brakuje atrybutu obowiązkowego lub wymaganego w kategorii, EAN nie ma karty w katalogu albo stan magazynowy wynosi zero. Sprawdź raporty z informacjami o danych produktu w Seller Portal, popraw dane w pliku i wgraj go ponownie.

Czy Kaufland.pl może sam pobierać plik z produktami?

Tak. W zarządzaniu importami możesz ustawić automatyczny import danych produktu: podajesz adres URL pliku CSV i godzinę, o której system Kaufland ma go pobierać. Plik pod tym adresem musi być zawsze kompletny i aktualny (stan na sierpień 2026).

Chcesz wgrać katalog na Kaufland.pl bez tygodni poprawiania błędów importu? Zobacz, jak prowadzimy sprzedaż na Kaufland.pl z Vinson. Przed przygotowaniem pliku sprawdź też, jak katalog Kaufland.pl łączy oferty z kartami po EAN.