Integracja z OTTO Market - jak połączyć sklep i feed produktowy

Miłosz Brzegowy
Miłosz Brzegowy
Head of Growth and Demand Generation
Integracja z OTTO Market - jak połączyć sklep i feed produktowy

Integracja z OTTO Market to połączenie Twojego sklepu lub systemu do zarządzania sprzedażą z kontem sprzedawcy OTTO przez API OTTO Market. Sklep możesz połączyć na trzy sposoby: przez integrator (system multichannel lub ERP z gotowym połączeniem z OTTO), przez własną integrację z API albo częściowo ręcznie w panelu OTTO Partner Connect. Feed produktowy ze sklepu trzeba przy tym przekształcić do struktury OTTO - z kategorią, marką, atrybutami i kodem GTIN dla każdego wariantu.
Polskie sklepy często zakładają, że wystarczy „podpiąć feed”, tak jak przy porównywarkach cen. Na OTTO to nie działa w ten sposób. Platforma przyjmuje dane produktowe w swoim formacie, sprawdza je i dopiero wtedy publikuje ofertę na otto.de. Do tego dochodzą stany, ceny, zamówienia, numery przesyłek i zwroty, które muszą płynąć w obie strony. W tym wpisie pokazujemy, jakie są opcje połączenia sklepu z OTTO, jak przygotować dane produktowe i na czym najczęściej wykładają się pierwsze importy.
[#wazne] W skrócie: integracja z OTTO Market odbywa się przez API OTTO - bezpośrednio albo przez integrator, który już z tego API korzysta. Dane produktowe z feedu sklepu trzeba dopasować do kategorii, marek i atrybutów OTTO, a każdy wariant potrzebuje własnego SKU i kodu GTIN. Po imporcie integracja synchronizuje stany, ceny, zamówienia i numery przesyłek. W Vinson przygotowujemy dane produktowe po niemiecku i łączymy sklep z OTTO przez Base.
Integracja z OTTO Market - z czego się składa
Integracja z OTTO Market to zestaw automatycznych połączeń, przez które Twój system wymienia dane z platformą bez ręcznego przepisywania. Dokumentacja API OTTO Market na api.otto.market dzieli to połączenie na kilka obszarów funkcjonalnych. Z punktu widzenia sklepu najważniejsze są te strumienie danych:
Produkty - tworzenie i aktualizacja wariantów produktów: tytuły, opisy, atrybuty, zdjęcia, kody GTIN, marka i kategoria.
Dostępność i stany - liczba sztuk dostępnych do sprzedaży dla każdego SKU oraz przypisanie profilu wysyłki.
Zamówienia - pobieranie nowych zamówień i ich pozycji do Twojego systemu.
Wysyłki - potwierdzenie przekazania paczki przewoźnikowi razem z numerem przesyłki i numerem przesyłki zwrotnej.
Zwroty - informacje o zwrotach zapowiedzianych przez klientów i o paczkach, które do Ciebie wróciły.
Każdy z tych strumieni może działać osobno, ale w praktyce potrzebujesz wszystkich. Same produkty bez synchronizacji stanów oznaczają ryzyko sprzedaży towaru, którego już nie masz. Zamówienia bez automatycznego przekazywania numerów przesyłek oznaczają ręczne wpisywanie danych przy każdej paczce. Dlatego planując integrację, myśl o całym obiegu zamówienia, a nie tylko o wystawieniu ofert.
Zanim zaczniesz budować połączenie, upewnij się, że Twoja firma spełnia warunki wejścia na platformę i że masz dostęp do panelu OTTO Partner Connect. Bez aktywnego konta sprzedawcy żadna integracja nie przekaże danych. Warunki dla polskich firm opisujemy we wpisie OTTO Market dla sprzedawców z Polski.
Jak połączyć sklep z OTTO Market - trzy drogi
Wybór sposobu połączenia zależy od liczby produktów, tego, gdzie dziś trzymasz dane, i od zasobów technicznych w firmie. Poniżej trzy podstawowe drogi, z których korzystają sprzedawcy:
[#chart:ott28a]
Panel OTTO Partner Connect
Panel OTTO Partner Connect pozwala zarządzać kontem, zamówieniami, rozliczeniami i ustawieniami logistyki. Dodawanie i obsługa produktów wyłącznie ręcznie ma sens tylko przy bardzo małym katalogu, na przykład na etapie testu kilku produktów. Przy kilkudziesięciu wariantach zaczyna się problem: każda zmiana ceny czy stanu wymaga pracy w dwóch miejscach, a pomyłka oznacza sprzedaż bez towaru albo ofertę z nieaktualną ceną.
Integrator lub system multichannel
Najczęściej wybierana droga to system, który ma gotowe połączenie z API OTTO: system multichannel, ERP albo narzędzie typu feed manager. Sklep przekazuje do niego produkty, a integrator wysyła je na OTTO, pobiera zamówienia i odsyła numery przesyłek. Przykładem jest Base, który według swojej pomocy umożliwia wystawianie produktów na OTTO, pobieranie zamówień, synchronizację stanów i cen oraz przekazywanie numerów przesyłek (stan na czerwiec 2026 - sprawdź aktualny zakres integracji u producenta).
Własna integracja przez API OTTO Market
OTTO udostępnia publiczną dokumentację API z opisem interfejsów i środowiskiem testowym. Firmy budujące integracje dla wielu sprzedawców mogą przystąpić do programu dla dostawców usług, w którym OTTO testuje i zatwierdza połączenie. Własna integracja daje pełną kontrolę, ale wymaga programisty, utrzymania i reagowania na zmiany wersji API. Ma sens przy dużym katalogu, nietypowych procesach albo gdy firma i tak ma własny system ERP rozwijany przez zespół IT.
Którą drogę połączenia z OTTO wybrać na start
Dla większości polskich sklepów najrozsądniejszy jest integrator, z którego firma już korzysta przy Allegro, Kauflandzie czy sklepie internetowym. Produkty, stany i zamówienia są wtedy w jednym miejscu, a OTTO staje się kolejnym kanałem, a nie osobnym projektem. Jeśli dziś nie używasz żadnego systemu multichannel, wejście na OTTO jest dobrym momentem, żeby go wdrożyć - kolejne niemieckie marketplace'y podłączysz potem znacznie szybciej. Własną integrację z API rozważ dopiero wtedy, gdy integrator nie obsługuje ważnego dla Ciebie procesu albo gdy liczba produktów i zamówień uzasadnia koszt pracy programisty i stałego utrzymania połączenia.
Integracja z OTTO Market to połączenie Twojego sklepu lub systemu do zarządzania sprzedażą z kontem sprzedawcy OTTO przez API OTTO Market. Sklep możesz połączyć na trzy sposoby: przez integrator (system multichannel lub ERP z gotowym połączeniem z OTTO), przez własną integrację z API albo częściowo ręcznie w panelu OTTO Partner Connect. Feed produktowy ze sklepu trzeba przy tym przekształcić do struktury OTTO - z kategorią, marką, atrybutami i kodem GTIN dla każdego wariantu.
Polskie sklepy często zakładają, że wystarczy „podpiąć feed”, tak jak przy porównywarkach cen. Na OTTO to nie działa w ten sposób. Platforma przyjmuje dane produktowe w swoim formacie, sprawdza je i dopiero wtedy publikuje ofertę na otto.de. Do tego dochodzą stany, ceny, zamówienia, numery przesyłek i zwroty, które muszą płynąć w obie strony. W tym wpisie pokazujemy, jakie są opcje połączenia sklepu z OTTO, jak przygotować dane produktowe i na czym najczęściej wykładają się pierwsze importy.
[#wazne] W skrócie: integracja z OTTO Market odbywa się przez API OTTO - bezpośrednio albo przez integrator, który już z tego API korzysta. Dane produktowe z feedu sklepu trzeba dopasować do kategorii, marek i atrybutów OTTO, a każdy wariant potrzebuje własnego SKU i kodu GTIN. Po imporcie integracja synchronizuje stany, ceny, zamówienia i numery przesyłek. W Vinson przygotowujemy dane produktowe po niemiecku i łączymy sklep z OTTO przez Base.
Integracja z OTTO Market - z czego się składa
Integracja z OTTO Market to zestaw automatycznych połączeń, przez które Twój system wymienia dane z platformą bez ręcznego przepisywania. Dokumentacja API OTTO Market na api.otto.market dzieli to połączenie na kilka obszarów funkcjonalnych. Z punktu widzenia sklepu najważniejsze są te strumienie danych:
Produkty - tworzenie i aktualizacja wariantów produktów: tytuły, opisy, atrybuty, zdjęcia, kody GTIN, marka i kategoria.
Dostępność i stany - liczba sztuk dostępnych do sprzedaży dla każdego SKU oraz przypisanie profilu wysyłki.
Zamówienia - pobieranie nowych zamówień i ich pozycji do Twojego systemu.
Wysyłki - potwierdzenie przekazania paczki przewoźnikowi razem z numerem przesyłki i numerem przesyłki zwrotnej.
Zwroty - informacje o zwrotach zapowiedzianych przez klientów i o paczkach, które do Ciebie wróciły.
Każdy z tych strumieni może działać osobno, ale w praktyce potrzebujesz wszystkich. Same produkty bez synchronizacji stanów oznaczają ryzyko sprzedaży towaru, którego już nie masz. Zamówienia bez automatycznego przekazywania numerów przesyłek oznaczają ręczne wpisywanie danych przy każdej paczce. Dlatego planując integrację, myśl o całym obiegu zamówienia, a nie tylko o wystawieniu ofert.
Zanim zaczniesz budować połączenie, upewnij się, że Twoja firma spełnia warunki wejścia na platformę i że masz dostęp do panelu OTTO Partner Connect. Bez aktywnego konta sprzedawcy żadna integracja nie przekaże danych. Warunki dla polskich firm opisujemy we wpisie OTTO Market dla sprzedawców z Polski.
Jak połączyć sklep z OTTO Market - trzy drogi
Wybór sposobu połączenia zależy od liczby produktów, tego, gdzie dziś trzymasz dane, i od zasobów technicznych w firmie. Poniżej trzy podstawowe drogi, z których korzystają sprzedawcy:
[#chart:ott28a]
Panel OTTO Partner Connect
Panel OTTO Partner Connect pozwala zarządzać kontem, zamówieniami, rozliczeniami i ustawieniami logistyki. Dodawanie i obsługa produktów wyłącznie ręcznie ma sens tylko przy bardzo małym katalogu, na przykład na etapie testu kilku produktów. Przy kilkudziesięciu wariantach zaczyna się problem: każda zmiana ceny czy stanu wymaga pracy w dwóch miejscach, a pomyłka oznacza sprzedaż bez towaru albo ofertę z nieaktualną ceną.
Integrator lub system multichannel
Najczęściej wybierana droga to system, który ma gotowe połączenie z API OTTO: system multichannel, ERP albo narzędzie typu feed manager. Sklep przekazuje do niego produkty, a integrator wysyła je na OTTO, pobiera zamówienia i odsyła numery przesyłek. Przykładem jest Base, który według swojej pomocy umożliwia wystawianie produktów na OTTO, pobieranie zamówień, synchronizację stanów i cen oraz przekazywanie numerów przesyłek (stan na czerwiec 2026 - sprawdź aktualny zakres integracji u producenta).
Własna integracja przez API OTTO Market
OTTO udostępnia publiczną dokumentację API z opisem interfejsów i środowiskiem testowym. Firmy budujące integracje dla wielu sprzedawców mogą przystąpić do programu dla dostawców usług, w którym OTTO testuje i zatwierdza połączenie. Własna integracja daje pełną kontrolę, ale wymaga programisty, utrzymania i reagowania na zmiany wersji API. Ma sens przy dużym katalogu, nietypowych procesach albo gdy firma i tak ma własny system ERP rozwijany przez zespół IT.
Którą drogę połączenia z OTTO wybrać na start
Dla większości polskich sklepów najrozsądniejszy jest integrator, z którego firma już korzysta przy Allegro, Kauflandzie czy sklepie internetowym. Produkty, stany i zamówienia są wtedy w jednym miejscu, a OTTO staje się kolejnym kanałem, a nie osobnym projektem. Jeśli dziś nie używasz żadnego systemu multichannel, wejście na OTTO jest dobrym momentem, żeby go wdrożyć - kolejne niemieckie marketplace'y podłączysz potem znacznie szybciej. Własną integrację z API rozważ dopiero wtedy, gdy integrator nie obsługuje ważnego dla Ciebie procesu albo gdy liczba produktów i zamówień uzasadnia koszt pracy programisty i stałego utrzymania połączenia.
- 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 GenerationFeed produktowy dla OTTO - jakie dane przygotować
Feed produktowy dla OTTO to zestaw danych o produktach przekształcony do struktury, której wymaga OTTO Market. Niezależnie od tego, czy wysyłasz go przez integrator, czy przez własne API, w środku muszą znaleźć się te same informacje. Według dokumentacji API produkty przesyła się jako warianty, a marki i kategorie dopasowuje się do list udostępnianych przez OTTO. Zestawienie najważniejszych pól:
| Dane w feedzie | Co przygotować | Typowy problem |
|---|---|---|
| SKU | Unikalny identyfikator każdego wariantu w Twoim systemie | Ten sam SKU dla kilku rozmiarów lub kolorów |
| GTIN (EAN) | Własny kod dla każdego wariantu | Brak kodów przy części wariantów |
| Referencja produktu | Wspólne oznaczenie łączące warianty w jedną grupę | Warianty widoczne na otto.de jako osobne produkty |
| Marka | Nazwa zgodna z listą marek OTTO | Inna pisownia niż w katalogu OTTO |
| Kategoria i atrybuty | Kategoria OTTO i komplet atrybutów wymaganych w tej kategorii | Atrybuty z polskiego katalogu bez odpowiedników |
| Tytuł, opis, cechy | Treści po niemiecku, z wyróżnionymi najważniejszymi cechami | Tłumaczenie maszynowe bez korekty |
| Zdjęcia | Linki do zdjęć produktu w dobrej jakości | Zdjęcia z polskimi napisami lub znakiem wodnym |
| Cena i stan | Cena brutto w euro i liczba sztuk dostępnych dla OTTO | Cena przeliczona automatycznie bez zaokrągleń |
Warto zwrócić uwagę na referencję produktu. To ona mówi OTTO, które warianty należą do jednej karty - na przykład koszulka w trzech rozmiarach. Jeśli jej zabraknie albo każdy wariant dostanie inną, klient zobaczy na otto.de kilka osobnych produktów zamiast jednej karty z wyborem rozmiaru. Druga pułapka to opisy. Według dokumentacji API pola opisu i wypunktowań przyjmują tylko wybrane znaczniki formatowania, a pozostałe są usuwane, więc rozbudowany szablon HTML ze sklepu nie przejdzie na OTTO w niezmienionej formie.
Mapowanie kategorii i atrybutów
Najwięcej pracy przy pierwszym imporcie zajmuje mapowanie. Kategorie w Twoim sklepie rzadko pokrywają się z drzewem kategorii OTTO, a atrybuty bywają nazwane inaczej albo w ogóle nie istnieją w polskim katalogu. Przykład: w sklepie masz parametr „materiał”, a OTTO w danej kategorii oczekuje osobno materiału wierzchniego, materiału podszewki i wskazówek pielęgnacji. Podobne wyzwanie opisujemy na przykładzie innego niemieckiego marketplace we wpisie atrybuty i dane produktowe na Kaufland.de - wiele zasad przenosi się na OTTO.
Jak przygotować feed ze sklepu do importu na OTTO
Import na OTTO najlepiej podzielić na etapy. Zamiast wysyłać od razu cały katalog, zacznij od jednej kategorii i kilkudziesięciu produktów, na których sprawdzisz mapowanie, treści i wynik walidacji. Kolejność, którą stosujemy przy wdrożeniach:
[#chart:ott28b]
Po wysłaniu produktów OTTO przetwarza je asynchronicznie. Według dokumentacji API odpowiedź na wysyłkę zawiera link do zadania, a wynik dzieli warianty na przetworzone poprawnie, odrzucone z błędem i niezmienione. Osobno można sprawdzić status walidacji produktu na marketplace - dla poprawnie przetworzonych wariantów zawiera on link do strony produktu na otto.de. Integratory zwykle pokazują te informacje w swoim panelu jako listę błędów przy produktach.
Zanim wyślesz pierwszą paczkę produktów, przejdź przez krótką listę kontrolną:
Każdy wariant ma unikalny SKU i własny kod GTIN, a warianty jednego produktu wspólną referencję.
Marka jest zapisana tak samo jak na liście marek OTTO.
Każdy produkt ma przypisaną kategorię OTTO i komplet atrybutów obowiązkowych.
Tytuł, opis i cechy są po niemiecku i zgadzają się z produktem oraz zdjęciami.
Cena jest w euro, a stan dla OTTO uwzględnia sprzedaż w innych kanałach.
Produkt ma przypisany profil wysyłki z realnym czasem dostawy z Polski.
Stany i ceny po imporcie
Wystawienie produktów to dopiero początek. Od tej chwili najważniejsza jest synchronizacja. Stan na OTTO powinien zmieniać się po każdej sprzedaży w sklepie, na Allegro czy na Kaufland.de, a cena - po każdej zmianie w Twoim cenniku. W API OTTO dostępność i ceny aktualizuje się osobnymi wywołaniami, więc integrator może je wysyłać częściej niż pełne dane produktu. Ustal, jaki system jest źródłem prawdy dla stanów i cen, i nie zmieniaj tych wartości ręcznie w panelu OTTO, bo kolejna synchronizacja i tak je nadpisze.
Najczęstsze błędy przy integracji z OTTO Market
Większość problemów przy pierwszym imporcie powtarza się u różnych sprzedawców. Zwykle nie wynikają z samej techniki, tylko z danych, które w sklepie wystarczały, a na OTTO okazują się niekompletne. Najczęstsze objawy i sposób ich usunięcia:
[#chart:ott28c]
[#tip] Zapisuj zmiany w mapowaniu kategorii i atrybutów w jednym dokumencie. Gdy po kilku tygodniach dołożysz nową kategorię albo OTTO zmieni wymagania dla atrybutów, od razu zobaczysz, które reguły trzeba poprawić, zamiast szukać przyczyny błędów produkt po produkcie.
Pamiętaj też o zamówieniach. Przy paczkach OTTO wymaga przekazania numeru przesyłki do klienta i numeru przesyłki zwrotnej, a zwroty do magazynu w Polsce są możliwe przez DHL eCommerce. Sprawdź na zamówieniu testowym, czy integrator przekazuje oba numery i czy statusy zamówień zmieniają się poprawnie. Lepiej znaleźć błąd na jednej paczce testowej niż na pierwszych kilkudziesięciu zamówieniach od klientów.
Utrzymanie integracji z OTTO po starcie
Integracja nie kończy się na pierwszym udanym imporcie. OTTO rozwija API i publikuje zmiany w dzienniku zmian w dokumentacji, a nowe wersje interfejsów zastępują starsze. Jeśli korzystasz z integratora, aktualizacje leżą po stronie jego producenta, ale i tak warto śledzić komunikaty w panelu OTTO Partner Connect. Przy własnej integracji odpowiedzialność za dostosowanie połączenia spoczywa na Twoim zespole. Raz w tygodniu przejrzyj listę produktów z błędami, porównaj liczbę aktywnych ofert na OTTO z liczbą produktów przeznaczonych do tego kanału i sprawdź, czy wszystkie zamówienia z ostatnich dni mają przekazane numery przesyłek. Taki krótki przegląd wyłapie większość problemów, zanim odczują je klienci. Przy rozbudowie katalogu dodawaj nowe kategorie partiami i każdą sprawdzaj tak samo jak pierwszy import, bo każda kategoria OTTO ma własny zestaw wymaganych atrybutów.
Jak Vinson pomaga w integracji sklepu z OTTO Market
Jesteśmy agencją e-commerce z Bochni, działającą od 2021 roku. Pracowaliśmy z ponad 500 firmami, mamy status Allegro Ads Partner+, Google Partner i Meta Business Partner, jesteśmy certyfikowanym partnerem Base, partnerem Empik Place i autoryzowanym partnerem Shoper, a klienci oceniają nas na 4,9/5 ze 171 opinii. W ramach usługi sprzedaż na OTTO z Vinson łączymy sklep z OTTO i przygotowujemy dane tak, żeby import przeszedł bez serii poprawek.
Audyt danych produktowych: SKU, kody GTIN, warianty, marki i braki w atrybutach.
Mapowanie kategorii i atrybutów OTTO oraz treści po niemiecku dla pierwszych kategorii.
Integracja sklepu z OTTO przez Base - produkty, stany, ceny, zamówienia i numery przesyłek.
Zamówienie testowe, obsługa błędów walidacji i kontrola synchronizacji po starcie.
Najczęściej zadawane pytania
Czy OTTO Market przyjmuje feed XML ze sklepu?
OTTO przyjmuje dane produktowe w swojej strukturze przez API OTTO Market. Feed ze sklepu może być źródłem danych, ale integrator albo Twoja integracja musi przekształcić go do formatu OTTO, z kategorią, marką i atrybutami zgodnymi z wymaganiami platformy.
Jak połączyć sklep internetowy z OTTO Market?
Najprościej przez integrator, który ma gotowe połączenie z API OTTO, na przykład system multichannel lub ERP. Sklep przekazuje produkty do integratora, a ten wystawia je na OTTO, pobiera zamówienia i synchronizuje stany. Alternatywą jest własna integracja z API, wymagająca pracy programisty.
Jakie dane są potrzebne do wystawienia produktu na OTTO?
Każdy wariant potrzebuje SKU, kodu GTIN, marki, kategorii OTTO, atrybutów wymaganych w tej kategorii, treści po niemiecku, zdjęć, ceny w euro i stanu. Warianty jednego produktu łączy wspólna referencja, dzięki której klient widzi je na jednej karcie.
Dlaczego produkt nie pojawia się na otto.de po imporcie?
Najczęściej produkt nie przeszedł walidacji, na przykład z powodu brakującego atrybutu, nieznanej marki lub błędnego kodu GTIN. Sprawdź listę błędów w integratorze albo status produktu na marketplace w API. Przyczyną może też być zerowy stan albo brak przypisanego profilu wysyłki.
Czy integracja z OTTO wymaga programisty?
Nie, jeśli korzystasz z gotowego integratora - wtedy konfigurujesz połączenie i mapowania w jego panelu. Programista jest potrzebny przy własnej integracji z API OTTO albo przy nietypowym źródle danych, którego integrator nie obsługuje.
Chcesz połączyć sklep z OTTO Market bez tygodni poprawiania importu? Zobacz, jak prowadzimy sprzedaż na OTTO z Vinson - od audytu danych po synchronizację zamówień. Jeśli sprzedajesz już na innym niemieckim marketplace, przeczytaj też, jak zsynchronizować stany i terminy z magazynu w Polsce.
Feed produktowy dla OTTO - jakie dane przygotować
Feed produktowy dla OTTO to zestaw danych o produktach przekształcony do struktury, której wymaga OTTO Market. Niezależnie od tego, czy wysyłasz go przez integrator, czy przez własne API, w środku muszą znaleźć się te same informacje. Według dokumentacji API produkty przesyła się jako warianty, a marki i kategorie dopasowuje się do list udostępnianych przez OTTO. Zestawienie najważniejszych pól:
| Dane w feedzie | Co przygotować | Typowy problem |
|---|---|---|
| SKU | Unikalny identyfikator każdego wariantu w Twoim systemie | Ten sam SKU dla kilku rozmiarów lub kolorów |
| GTIN (EAN) | Własny kod dla każdego wariantu | Brak kodów przy części wariantów |
| Referencja produktu | Wspólne oznaczenie łączące warianty w jedną grupę | Warianty widoczne na otto.de jako osobne produkty |
| Marka | Nazwa zgodna z listą marek OTTO | Inna pisownia niż w katalogu OTTO |
| Kategoria i atrybuty | Kategoria OTTO i komplet atrybutów wymaganych w tej kategorii | Atrybuty z polskiego katalogu bez odpowiedników |
| Tytuł, opis, cechy | Treści po niemiecku, z wyróżnionymi najważniejszymi cechami | Tłumaczenie maszynowe bez korekty |
| Zdjęcia | Linki do zdjęć produktu w dobrej jakości | Zdjęcia z polskimi napisami lub znakiem wodnym |
| Cena i stan | Cena brutto w euro i liczba sztuk dostępnych dla OTTO | Cena przeliczona automatycznie bez zaokrągleń |
Warto zwrócić uwagę na referencję produktu. To ona mówi OTTO, które warianty należą do jednej karty - na przykład koszulka w trzech rozmiarach. Jeśli jej zabraknie albo każdy wariant dostanie inną, klient zobaczy na otto.de kilka osobnych produktów zamiast jednej karty z wyborem rozmiaru. Druga pułapka to opisy. Według dokumentacji API pola opisu i wypunktowań przyjmują tylko wybrane znaczniki formatowania, a pozostałe są usuwane, więc rozbudowany szablon HTML ze sklepu nie przejdzie na OTTO w niezmienionej formie.
Mapowanie kategorii i atrybutów
Najwięcej pracy przy pierwszym imporcie zajmuje mapowanie. Kategorie w Twoim sklepie rzadko pokrywają się z drzewem kategorii OTTO, a atrybuty bywają nazwane inaczej albo w ogóle nie istnieją w polskim katalogu. Przykład: w sklepie masz parametr „materiał”, a OTTO w danej kategorii oczekuje osobno materiału wierzchniego, materiału podszewki i wskazówek pielęgnacji. Podobne wyzwanie opisujemy na przykładzie innego niemieckiego marketplace we wpisie atrybuty i dane produktowe na Kaufland.de - wiele zasad przenosi się na OTTO.
Jak przygotować feed ze sklepu do importu na OTTO
Import na OTTO najlepiej podzielić na etapy. Zamiast wysyłać od razu cały katalog, zacznij od jednej kategorii i kilkudziesięciu produktów, na których sprawdzisz mapowanie, treści i wynik walidacji. Kolejność, którą stosujemy przy wdrożeniach:
[#chart:ott28b]
Po wysłaniu produktów OTTO przetwarza je asynchronicznie. Według dokumentacji API odpowiedź na wysyłkę zawiera link do zadania, a wynik dzieli warianty na przetworzone poprawnie, odrzucone z błędem i niezmienione. Osobno można sprawdzić status walidacji produktu na marketplace - dla poprawnie przetworzonych wariantów zawiera on link do strony produktu na otto.de. Integratory zwykle pokazują te informacje w swoim panelu jako listę błędów przy produktach.
Zanim wyślesz pierwszą paczkę produktów, przejdź przez krótką listę kontrolną:
Każdy wariant ma unikalny SKU i własny kod GTIN, a warianty jednego produktu wspólną referencję.
Marka jest zapisana tak samo jak na liście marek OTTO.
Każdy produkt ma przypisaną kategorię OTTO i komplet atrybutów obowiązkowych.
Tytuł, opis i cechy są po niemiecku i zgadzają się z produktem oraz zdjęciami.
Cena jest w euro, a stan dla OTTO uwzględnia sprzedaż w innych kanałach.
Produkt ma przypisany profil wysyłki z realnym czasem dostawy z Polski.
Stany i ceny po imporcie
Wystawienie produktów to dopiero początek. Od tej chwili najważniejsza jest synchronizacja. Stan na OTTO powinien zmieniać się po każdej sprzedaży w sklepie, na Allegro czy na Kaufland.de, a cena - po każdej zmianie w Twoim cenniku. W API OTTO dostępność i ceny aktualizuje się osobnymi wywołaniami, więc integrator może je wysyłać częściej niż pełne dane produktu. Ustal, jaki system jest źródłem prawdy dla stanów i cen, i nie zmieniaj tych wartości ręcznie w panelu OTTO, bo kolejna synchronizacja i tak je nadpisze.
Najczęstsze błędy przy integracji z OTTO Market
Większość problemów przy pierwszym imporcie powtarza się u różnych sprzedawców. Zwykle nie wynikają z samej techniki, tylko z danych, które w sklepie wystarczały, a na OTTO okazują się niekompletne. Najczęstsze objawy i sposób ich usunięcia:
[#chart:ott28c]
[#tip] Zapisuj zmiany w mapowaniu kategorii i atrybutów w jednym dokumencie. Gdy po kilku tygodniach dołożysz nową kategorię albo OTTO zmieni wymagania dla atrybutów, od razu zobaczysz, które reguły trzeba poprawić, zamiast szukać przyczyny błędów produkt po produkcie.
Pamiętaj też o zamówieniach. Przy paczkach OTTO wymaga przekazania numeru przesyłki do klienta i numeru przesyłki zwrotnej, a zwroty do magazynu w Polsce są możliwe przez DHL eCommerce. Sprawdź na zamówieniu testowym, czy integrator przekazuje oba numery i czy statusy zamówień zmieniają się poprawnie. Lepiej znaleźć błąd na jednej paczce testowej niż na pierwszych kilkudziesięciu zamówieniach od klientów.
Utrzymanie integracji z OTTO po starcie
Integracja nie kończy się na pierwszym udanym imporcie. OTTO rozwija API i publikuje zmiany w dzienniku zmian w dokumentacji, a nowe wersje interfejsów zastępują starsze. Jeśli korzystasz z integratora, aktualizacje leżą po stronie jego producenta, ale i tak warto śledzić komunikaty w panelu OTTO Partner Connect. Przy własnej integracji odpowiedzialność za dostosowanie połączenia spoczywa na Twoim zespole. Raz w tygodniu przejrzyj listę produktów z błędami, porównaj liczbę aktywnych ofert na OTTO z liczbą produktów przeznaczonych do tego kanału i sprawdź, czy wszystkie zamówienia z ostatnich dni mają przekazane numery przesyłek. Taki krótki przegląd wyłapie większość problemów, zanim odczują je klienci. Przy rozbudowie katalogu dodawaj nowe kategorie partiami i każdą sprawdzaj tak samo jak pierwszy import, bo każda kategoria OTTO ma własny zestaw wymaganych atrybutów.
Jak Vinson pomaga w integracji sklepu z OTTO Market
Jesteśmy agencją e-commerce z Bochni, działającą od 2021 roku. Pracowaliśmy z ponad 500 firmami, mamy status Allegro Ads Partner+, Google Partner i Meta Business Partner, jesteśmy certyfikowanym partnerem Base, partnerem Empik Place i autoryzowanym partnerem Shoper, a klienci oceniają nas na 4,9/5 ze 171 opinii. W ramach usługi sprzedaż na OTTO z Vinson łączymy sklep z OTTO i przygotowujemy dane tak, żeby import przeszedł bez serii poprawek.
Audyt danych produktowych: SKU, kody GTIN, warianty, marki i braki w atrybutach.
Mapowanie kategorii i atrybutów OTTO oraz treści po niemiecku dla pierwszych kategorii.
Integracja sklepu z OTTO przez Base - produkty, stany, ceny, zamówienia i numery przesyłek.
Zamówienie testowe, obsługa błędów walidacji i kontrola synchronizacji po starcie.
Najczęściej zadawane pytania
Czy OTTO Market przyjmuje feed XML ze sklepu?
OTTO przyjmuje dane produktowe w swojej strukturze przez API OTTO Market. Feed ze sklepu może być źródłem danych, ale integrator albo Twoja integracja musi przekształcić go do formatu OTTO, z kategorią, marką i atrybutami zgodnymi z wymaganiami platformy.
Jak połączyć sklep internetowy z OTTO Market?
Najprościej przez integrator, który ma gotowe połączenie z API OTTO, na przykład system multichannel lub ERP. Sklep przekazuje produkty do integratora, a ten wystawia je na OTTO, pobiera zamówienia i synchronizuje stany. Alternatywą jest własna integracja z API, wymagająca pracy programisty.
Jakie dane są potrzebne do wystawienia produktu na OTTO?
Każdy wariant potrzebuje SKU, kodu GTIN, marki, kategorii OTTO, atrybutów wymaganych w tej kategorii, treści po niemiecku, zdjęć, ceny w euro i stanu. Warianty jednego produktu łączy wspólna referencja, dzięki której klient widzi je na jednej karcie.
Dlaczego produkt nie pojawia się na otto.de po imporcie?
Najczęściej produkt nie przeszedł walidacji, na przykład z powodu brakującego atrybutu, nieznanej marki lub błędnego kodu GTIN. Sprawdź listę błędów w integratorze albo status produktu na marketplace w API. Przyczyną może też być zerowy stan albo brak przypisanego profilu wysyłki.
Czy integracja z OTTO wymaga programisty?
Nie, jeśli korzystasz z gotowego integratora - wtedy konfigurujesz połączenie i mapowania w jego panelu. Programista jest potrzebny przy własnej integracji z API OTTO albo przy nietypowym źródle danych, którego integrator nie obsługuje.
Chcesz połączyć sklep z OTTO Market bez tygodni poprawiania importu? Zobacz, jak prowadzimy sprzedaż na OTTO z Vinson - od audytu danych po synchronizację zamówień. Jeśli sprzedajesz już na innym niemieckim marketplace, przeczytaj też, jak zsynchronizować stany i terminy z magazynu w Polsce.


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 OTTO 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