Integracja Kaufland.pl: wymagania i podłączenie

Wymagania dla sprzedawcy

Strona rejestracji Kaufland Global Marketplace wymienia warunki, które musisz spełnić przed startem:

• zarejestrowana działalność gospodarcza,
• numer VAT właściwy dla siedziby firmy, podany dla każdego kanału sprzedaży, a przy sprzedaży internetowej w Unii także numer OSS,
• oficjalne kody EAN (GTIN) dla oferowanego asortymentu,
• adres zwrotny w jednym z krajów Unii Europejskiej,
• kontakt z klientami w języku urzędowym kraju danego kanału i dane produktów w tym języku,
• dobra dostępność telefoniczna i mailowa oraz brak produktów z kategorii zabronionych.

Do rejestracji dołączasz dokumenty: przy jednoosobowej działalności dowód osobisty albo paszport, weryfikowany przez IDnow, i zaświadczenie z rejestru, przy spółkach dokumenty wszystkich reprezentantów, odpis z rejestru i strukturę własności. Wskazujesz też beneficjentów rzeczywistych, czyli osoby z co najmniej 25% udziałów.

Opłaty: plan i prowizja

Przykładowe stawki z tabeli Kauflandu dla Kaufland.pl: komputery i elektronika użytkowa 4%, duże AGD 7%, perfumy 8%, większość kategorii 10%, biżuteria 12%. Opłatę podstawową dla Kaufland.pl Kaufland pobiera w złotych, a po rejestracji sam decydujesz, w których krajach publikujesz oferty. Przejście z Basic na Plus działa od razu, a powrót do Basic po czterech tygodniach. Współpracę możesz zakończyć w każdej chwili.

Oferty: EAN i katalog Kauflandu

W Seller API oferta nazywa się jednostką (unit). To Twoja oferta jednego produktu w określonym stanie, z określonego magazynu i w określonej cenie. Jednostkę łączysz z produktem przez EAN albo identyfikator produktu Kauflandu. Jeśli produktu nie ma jeszcze w katalogu, najpierw przesyłasz jego dane produktowe, a ofertę dodajesz, gdy produkt jest już na platformie.

Ten sam id_offer możesz użyć w kilku krajach. Wtedy magazyn i liczba sztuk są wspólne, a cena, grupa wysyłkowa i czas realizacji mogą się różnić między krajami.

Zamówienia w jednostkach

Kaufland dzieli koszyk klienta na zamówienia, osobno dla każdego sprzedawcy. Zamówienie składa się z jednostek, a każda jednostka to jedna sztuka towaru. Trzy takie same produkty w koszyku to trzy jednostki z własnym statusem.

1. Nowe jednostki mają status open. Przez pierwsze 15 minut klient może anulować zakup, a adres dostawy jest ukryty.
2. Po 15 minutach jednostki przechodzą w status need_to_be_sent i dopiero wtedy możesz je wysłać.
3. Po nadaniu oznaczasz jednostki jako wysłane, z kodem przewoźnika i numerem przesyłki. Kilka numerów rozdzielasz przecinkiem.
4. Jeśli musisz anulować sprzedaż, anulujesz jednostkę z powodem z listy Kauflandu.
5. Zwrot części pieniędzy zlecasz na jednostce, z kwotą i powodem.

Integrator powinien składać jednostki z powrotem w pozycje zamówienia, bo w panelu zamówień wygodniej widzieć trzy sztuki jednego produktu niż trzy osobne wiersze. Kod przewoźnika wybierasz z listy kodów, którą Kaufland publikuje w dokumentacji API.

Zwroty

Zwroty przez API obsłużysz, gdy korzystasz z etykiet zwrotnych DHL albo DPD lub z Kaufland Shipment Solutions. Zwrot ma jednostki zwrotu, po jednej na każdą jednostkę zamówienia, a sprzedawca wybiera dla każdej akcję:

Jak podłączyć Kaufland do integratora

1. Zarejestruj konto sprzedawcy, wybierz plan i kanały, w których chcesz sprzedawać.
2. Ustaw magazyn, grupy wysyłkowe i adres zwrotny w Unii.
3. W portalu sprzedawcy, w ustawieniach API, wygeneruj Client Key i Secret Key.
4. Wklej klucze w panelu integratora i wybierz sklep Kauflandu, np. Kaufland.pl.
5. Powiąż oferty z produktami po id_offer i SKU, zanim włączysz wysyłanie stanów.
6. Przejdź zamówienie testowe: status need_to_be_sent, wysyłka z numerem, ewentualny zwrot.

Seller API działa pod adresem https://sellerapi.kaufland.com/v2/. Każde zapytanie ma nagłówki Shop-Client-Key, Shop-Timestamp i Shop-Signature, czyli podpis HMAC SHA-256 liczony kluczem Secret Key z metody, adresu, treści zapytania i znacznika czasu. Znacznik czasu może różnić się od czasu serwera najwyżej o 5 minut, więc zegar serwera integratora musi być zsynchronizowany.

Kaufland w Commerce OS Integrator

Kaufland jest w tabeli funkcji Commerce OS Integrator razem z Erli, Empik, Amazon i eBay. Na wdrożeniu podłączamy Twoje konto sprzedawcy i klucze API i testujemy połączenie na Twoim koncie. Zamówienia z Kauflandu trafiają na wspólną listę z zamówieniami z Allegro, sklepu i innych kanałów, z tymi samymi folderami statusów. Sprzedaż w jednym kanale zmniejsza stan, a nowy stan wraca do pozostałych kanałów. Numer przesyłki wraca do kanału, w którym klient kupił, a etykietę i fakturę tworzysz z tego samego zamówienia.

Jak wygląda praca z kilkoma kanałami na jednej liście, opisujemy w artykule Jedna lista zamówień z Allegro, sklepu i Erli. W planie Integrator Start podłączysz do 3 kanałów sprzedaży, w wyższych planach bez limitu, a ceny są w cenniku Integratora. Jeśli dziś obsługujesz Kaufland przez BaseLinkera, zakres przejścia opisujemy na stronie Migracja z BaseLinkera, a oszczędność policzysz w kalkulatorze zwrotu z migracji.

Na co uważać

• Brak EAN w katalogu. Oferta nie powstanie, dopóki produktu nie ma w katalogu Kauflandu, więc dane produktowe przesyłasz wcześniej.
• Pierwsze 15 minut. Zamówienia w statusie open nie wyślesz, bo adres jest ukryty, a klient może jeszcze anulować zakup.
• Kody przewoźników. Numer przesyłki wysyłasz z kodem z listy Kauflandu.
• Prowizja od wysyłki. Prowizja liczy się od ceny brutto z kosztami wysyłki, więc cena dostawy też ją podnosi.
• Kilka krajów. Wspólny id_offer oznacza wspólny stan we wszystkich krajach, a ceny ustawiasz osobno.