API Kaufland.pl - co potrafi i kiedy warto zlecić integrację programiście

Miłosz Brzegowy

Head of Growth and Demand Generation

8.07.2026

API Kaufland.pl - co potrafi i kiedy warto zlecić integrację programiście

Wdrażamy i obsługujemy Kaufland.pl

Miłosz BrzegowyHead of Growth and Demand Generation

API Kaufland.pl, czyli Seller API, to interfejs REST, przez który Twój system może tworzyć dane produktu, zarządzać ofertami, cenami i stanami, pobierać i wysyłać zamówienia, przesyłać faktury oraz obsługiwać zgłoszenia klientów i zwroty. Własną integrację warto zlecić programiście wtedy, gdy gotowe narzędzia nie obsługują Twojego systemu ERP lub magazynowego albo Twojej logiki biznesowej. W pozostałych przypadkach szybciej i taniej wychodzi gotowa integracja, np. przez Base.

Sprzedawcy często pytają nas, czy da się „podpiąć Kaufland pod nasz system”. Odpowiedź prawie zawsze brzmi: tak, ale nie zawsze się to opłaca. API daje pełną kontrolę, tylko że każdą funkcję, którą gotowe narzędzie ma od ręki, trzeba zaprojektować, napisać, przetestować i utrzymywać. W tym wpisie pokazujemy, co dokładnie potrafi API Kaufland, jak wygląda dostęp i uwierzytelnianie, jakie zasady obowiązują przy ofertach i zamówieniach oraz po czym poznać, że własna integracja jest lepsza od gotowej.

[#wazne] W skrócie: Seller API Kaufland obsługuje dane produktu, oferty (ceny, stany, czas realizacji), zamówienia, faktury, zgłoszenia klientów, zwroty i raporty. Dostęp uzyskasz w Seller Portal, w ustawieniach sklepu w sekcji API, a każde zapytanie podpisujesz kluczami Client Key i Secret Key. Własna integracja ma sens przy nietypowym ERP, dużej skali zmian i niestandardowej logice; przy typowej sprzedaży wielokanałowej wystarczy gotowe narzędzie. W Vinson pomagamy wejść na Kaufland.pl, przygotować oferty i zintegrować sprzedaż z Base.

Czym jest API Kaufland.pl i co potrafi

API (Application Programming Interface) to zestaw reguł, według których jeden program komunikuje się z drugim. W przypadku Kaufland.pl oznacza to, że Twój system zamiast człowieka klikającego w Seller Portal wysyła zapytania do serwera Kaufland i dostaje odpowiedzi w formacie JSON. Kaufland Global Marketplace opisuje Seller API jako interfejs REST obejmujący kilka głównych obszarów (stan na lipiec 2026 - sprawdź aktualną dokumentację Seller API).

Obszar API Kaufland	Co możesz zrobić	Przykład zastosowania
Dane produktu	Tworzyć, aktualizować i usuwać dane produktu, sprawdzać ich status, pobierać kategorie i atrybuty	Automatyczne zakładanie kart dla nowych produktów z ERP
Oferty (units)	Tworzyć, zmieniać i usuwać oferty: cenę, stan, czas realizacji, cenę minimalną	Aktualizacja stanów po każdej sprzedaży w innym kanale
Zamówienia	Pobierać nowe zamówienia, oznaczać wysyłkę, anulować pozycje	Przekazanie zamówień do systemu magazynowego
Faktury	Przesyłać faktury do zamówień i nimi zarządzać	Automatyczne dołączanie faktury z systemu księgowego
Zgłoszenia	Pobierać zgłoszenia klientów, odpowiadać, otwierać i zamykać	Obsługa wiadomości w jednym helpdesku
Zwroty	Pobierać zgłoszenia zwrotów i nimi zarządzać	Rejestrowanie zwrotów w magazynie

Dokumentacja Seller API opisuje też m.in. raporty, kupony, adresy wysyłki, sugestie wariantów, dane kontaktowe GPSR, stawki prowizji oraz Kaufland Shipment Solutions. Obok interfejsu REST Kaufland udostępnia także interfejsy plikowe CSV dla danych produktu, ofert i zamówień. To ważne przy planowaniu: część procesów, np. jednorazowy import katalogu, prościej zrobić plikiem, a API zostawić do bieżących, częstych zmian.

Poniżej najważniejsze obszary API zebrane w jednym miejscu. Przy projektowaniu integracji warto przejść przez każdy z nich i zdecydować, czy obsłuży go Twój system, gotowe narzędzie, czy zespół ręcznie w Seller Portal.

[#chart:kpl18a]

Jak uzyskać dostęp do API Kaufland.pl

Dostęp do dokumentacji API sprzedawca uzyskuje po zalogowaniu do konta, w ustawieniach sklepu w sekcji API. Tam też generuje klucze: Client Key (32 znaki) i Secret Key (64 znaki). Dokumentacja podkreśla, że kluczy nie da się odzyskać po zgubieniu. Firmy tworzące oprogramowanie dla wielu sprzedawców zakładają konto partnera technologicznego i po weryfikacji bezpieczeństwa otrzymują dostęp do dokumentacji oraz własne klucze partnerskie (stan na lipiec 2026 - sprawdź aktualne zasady Kaufland).

Adres bazowy - wszystkie zapytania idą przez HTTPS na adres zaczynający się od https://sellerapi.kaufland.com/v2/.
Podpis zapytania - każde zapytanie podpisujesz kodem HMAC SHA-256 z metody, adresu, treści i znacznika czasu, z użyciem Secret Key.
Znacznik czasu - może różnić się od czasu serwera najwyżej o 5 minut, więc zegar serwera integracji musi być zsynchronizowany.
Rynek i język - parametr storefront wskazuje kraj (dla Polski pl), a locale język danych produktu.

Te wymagania nie są trudne dla doświadczonego programisty, ale pokazują, że integracja z API Kaufland to praca dla kogoś, kto zna REST i podpisywanie zapytań, a nie zadanie do wykonania w arkuszu kalkulacyjnym. Jeśli w firmie nie ma takiej osoby, pierwszym kosztem integracji jest znalezienie wykonawcy, który weźmie odpowiedzialność także za jej późniejsze utrzymanie.

Bezpłatna konsultacja Kaufland.pl

Chcesz sprzedawać na Kaufland.pl?

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 Generation

Zobacz szczegóły usługi →

Oferty, ceny i stany przez API Kaufland.pl - zasady, które musisz znać

Oferta w API Kaufland nazywa się unit. Do jej utworzenia potrzebujesz identyfikatora produktu lub EAN, a do tego ceny, stanu, stanu towaru i czasu realizacji. Dokumentacja zawiera kilka ograniczeń, które programista musi uwzględnić od pierwszego dnia (stan na lipiec 2026 - sprawdź aktualną dokumentację Seller API):

Ceny w groszach - listing_price i minimum_price podajesz jako liczbę całkowitą w najmniejszej jednostce waluty; cena musi być większa od zera.
Stan do 99 999 sztuk - pole amount ma górny limit.
Czas realizacji w dniach roboczych - handling_time to liczba dni do przekazania paczki przewoźnikowi; czas transportu wynika z grupy wysyłkowej.
Stałe id_offer - Twój identyfikator oferty (SKU) musi być unikalny i nie da się go zmienić po utworzeniu oferty.
Cena minimalna - wpisanie minimum_price włącza Smart Pricing, który automatycznie dopasowuje cenę.
Stan wspólny między krajami - oferty połączone tym samym id_offer na różnych rynkach dzielą magazyn i ilość, a cena i wysyłka mogą się różnić.

Przy większej liczbie ofert ważna jest aktualizacja zbiorcza. Endpoint bulk przyjmuje w jednym zapytaniu do 150 ofert, a duplikat w paczce powoduje odrzucenie całego zapytania. Status widoczności sprawdzisz w polu is_live oferty, a przyczyny, dla których oferta nie jest aktywna, zapytaniem o status do 20 ofert naraz. Jeśli stan spadnie do zera, oferta przestaje być widoczna z powodem wskazującym na konieczność aktualizacji stanu. Prosty rachunek pokazuje, ile zapytań potrzeba na pełną aktualizację katalogu.

[#chart:kpl18b]

Logika cen to osobny temat. Jeśli korzystasz ze Smart Pricing, Twój system powinien wysyłać przede wszystkim cenę minimalną, a nie nadpisywać co chwilę cenę oferty. Przy wielu sprzedawcach na tej samej karcie o wyniku decyduje BuyBox, w którym liczą się cena z dostawą, czas dostawy i dostępność - więcej piszemy we wpisie BuyBox na Kaufland.pl - od czego zależy wygrana oferta.

Zamówienia przez API Kaufland.pl

W API zamówienie składa się z jednej lub kilku pozycji, nazywanych order units. Każda pozycja ma własny status. Przez pierwsze 15 minut po złożeniu pozycja jest otwarta: klient może ją anulować, a adres dostawy nie jest jeszcze udostępniany. Potem przechodzi do statusu oczekującego na wysyłkę i dopiero wtedy integracja dostaje adres. Kaufland zaleca margines jednej minuty, a jako alternatywę dla cyklicznego odpytywania udostępnia powiadomienia push o zmianie statusu pozycji (stan na lipiec 2026 - sprawdź aktualną dokumentację Seller API).

Pobierz pozycje gotowe do wysyłki - filtrując po statusie oczekującym na wysyłkę.
Przekaż je do magazynu - pozycje z tym samym numerem zamówienia trafiają do jednej paczki.
Oznacz wysyłkę - z kodem przewoźnika i numerem przesyłki.
Prześlij fakturę - jeśli wystawiasz ją w swoim systemie.
Anuluj pozycję tylko w ostateczności - z podaniem powodu, np. braku towaru.

Ostatni punkt ma znaczenie finansowe. Anulacje z winy sprzedawcy, w tym z powodu braku towaru, liczą się do wskaźnika, którego miesięczny cel na Kaufland to poniżej 1% zamówień. Powyżej tego progu Kaufland nalicza dodatkowe opłaty od anulowanych transakcji. Dobra integracja nie tylko pobiera zamówienia, ale przede wszystkim pilnuje aktualnych stanów, żeby do anulacji w ogóle nie dochodziło.

Kiedy warto zlecić integrację z API Kaufland.pl programiście

Gotowe narzędzia, takie jak Base czy Apilo, obsługują typowy proces: oferty, stany, ceny, zamówienia, przesyłki i faktury. O tym, co obejmuje jedna z takich integracji, piszemy we wpisie Apilo i Kaufland.pl - integracja ofert, zamówień i stanów. Własna integracja ma przewagę wtedy, gdy Twój proces wychodzi poza ten standard. Poniżej porównanie, które pomaga podjąć decyzję.

[#chart:kpl18c]

W praktyce najczęstsze powody do zlecenia własnej integracji to: system ERP lub WMS bez gotowego połączenia z Kaufland ani z narzędziem typu Base, bardzo częste zmiany cen liczone według własnych algorytmów, wiele magazynów z nietypowymi regułami alokacji stanów albo potrzeba połączenia danych z Kaufland z hurtownią danych firmy. Jeśli żaden z tych punktów Cię nie dotyczy, własny kod będzie prawdopodobnie droższym sposobem na zrobienie tego samego.

Ile kosztuje własna integracja z API Kaufland

Nie ma jednej stawki. Koszt zależy od zakresu (czy integracja ma obsługiwać tylko stany, czy cały cykl od karty produktu po zwroty), od tego, z jakim systemem ją łączysz, i od jakości dokumentacji po Twojej stronie. Do kosztu napisania dolicz utrzymanie: Kaufland rozwija API, dodaje pola i zmienia wymagania, np. dotyczące danych produktu, więc ktoś musi śledzić zmiany i aktualizować kod. Przy gotowym narzędziu ten koszt jest wliczony w abonament.

Jak zaplanować projekt integracji z API Kaufland.pl

Dobra integracja zaczyna się od specyfikacji, a nie od kodu. Programista, który dostanie tylko polecenie „podłącz Kaufland”, zbuduje coś, co działa w testach, ale nie obsługuje Twoich wyjątków. Zanim podpiszesz umowę, przejdź z wykonawcą przez poniższe punkty i zapisz ustalenia.

Zakres procesów - które obszary API obsługuje integracja: dane produktu, oferty, zamówienia, faktury, zwroty, zgłoszenia.
Źródło prawdy - który system jest właścicielem stanów, cen i danych produktu, a który tylko je odczytuje.
Częstotliwość - jak szybko zmiana stanu lub ceny ma trafić na Kaufland.pl i czy zamówienia mają być pobierane cyklicznie, czy po powiadomieniu push.
Wyjątki - zestawy, warianty, kilka magazynów, oferty na innych rynkach Kaufland.
Utrzymanie - kto śledzi zmiany w API, kto reaguje na błędy i w jakim czasie.

Przy testach warto pamiętać, że Kaufland pozwala firmom tworzącym oprogramowanie założyć konto testowe, a możliwości testowania integracji opisuje dokumentacja Seller API dostępna po zalogowaniu. Nigdy nie testuj nowych reguł cenowych ani anulacji na produkcyjnym koncie z aktywnymi ofertami.

[#tip] Zanim zlecisz integrację, spisz listę procesów, które ma obsłużyć, i przy każdym zaznacz, czy robi to już Twoje obecne narzędzie. Często okazuje się, że brakuje jednej lub dwóch funkcji, które da się rozwiązać konfiguracją, importem pliku CSV albo prostym skryptem zamiast pełnej integracji.

Na co uważać przy własnej integracji z API Kaufland.pl

Bezpieczeństwo kluczy - Secret Key przechowuj na serwerze, nigdy w kodzie strony ani w repozytorium.
Paginacja - listy zwracane są stronami (parametry limit i offset), a limity różnią się między endpointami.
Opóźnienia - nowe oferty mogą pojawić się w liście ofert po kilku minutach; nie zakładaj natychmiastowej spójności.
Obsługa błędów - zapytanie zbiorcze zwraca wynik dla każdej oferty osobno; zapisuj i ponawiaj tylko błędne pozycje.
Monitoring - alarm, gdy przez dłuższy czas nie spływają zamówienia lub nie wychodzą aktualizacje stanów.

Jak Vinson pomaga z integracją Kaufland.pl

W Vinson zaczynamy od sprawdzenia, czy Twoje potrzeby da się pokryć integracją Kaufland.pl w Base - dla większości sprzedawców to wystarcza i pozwala uruchomić sprzedaż bez własnego kodu. Łączymy konto, przygotowujemy dane produktu i oferty, ustawiamy synchronizację stanów i cen oraz automatyzacje zamówień. Jeśli okaże się, że potrzebna jest integracja przez API, pomożemy spisać wymagania dla programisty tak, żeby obejmowały wszystkie procesy sprzedaży na Kaufland.pl. 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

Czy Kaufland.pl ma API dla sprzedawców?

Tak. Kaufland udostępnia Seller API w wersji REST, które obsługuje dane produktu, oferty, zamówienia, faktury, zgłoszenia klientów, zwroty i raporty. Dostęp do dokumentacji i klucze API uzyskasz po zalogowaniu do Seller Portal, w ustawieniach sklepu w sekcji API (stan na lipiec 2026).

Jak wygenerować klucze API Kaufland?

Klucze Client Key i Secret Key generujesz w Seller Portal na stronie ustawień API. Nie da się ich odzyskać po zgubieniu, więc zapisz je w bezpiecznym miejscu. Jeśli klucze wyciekły, wygeneruj nowe i zaktualizuj je we wszystkich podłączonych systemach.

Czy integracja przez API Kaufland jest płatna?

Materiały Kaufland nie wymieniają osobnej opłaty za korzystanie z Seller API - płacisz standardowe opłaty sprzedawcy, czyli plan Basic 175 zł lub Plus 260 zł netto miesięcznie i prowizję od sprzedaży (stan na lipiec 2026 - sprawdź aktualny cennik Kaufland). Kosztem jest natomiast napisanie i utrzymanie integracji.

Czy przez API Kaufland można aktualizować stany wielu ofert naraz?

Tak. Seller API ma endpoint do zbiorczej aktualizacji ofert, który przyjmuje do 150 ofert w jednym zapytaniu i zwraca wynik dla każdej z nich osobno. Alternatywą przy bardzo dużych katalogach jest interfejs plikowy CSV dla ofert.

Kiedy wystarczy gotowa integracja zamiast API?

Gdy sprzedajesz w typowym modelu: jeden lub kilka magazynów, stany i ceny z jednego źródła, zamówienia obsługiwane w panelu do sprzedaży wielokanałowej. Narzędzia takie jak Base obsługują wtedy oferty, stany, ceny, zamówienia, faktury i przesyłki bez pisania kodu, a koszt utrzymania jest wliczony w abonament.

Zastanawiasz się, czy Twoja sprzedaż na Kaufland.pl potrzebuje własnej integracji, czy wystarczy Base? Zobacz, jak prowadzimy sprzedaż na Kaufland.pl z Vinson. Jeśli dopiero przygotowujesz katalog, sprawdź, jak wybrać właściwą kategorię na Kaufland.pl.