API OTTO Market - kiedy warto je wdrożyć zamiast gotowego integratora

API OTTO Market to publiczny interfejs, przez który sprzedawca lub dostawca usług łączy własny system bezpośrednio z kontem na OTTO - bez pośrednictwa gotowego integratora. Własną integrację przez API warto wdrożyć wtedy, gdy firma ma rozwijany przez siebie ERP lub WMS, duży i często zmieniający się katalog albo procesy, których integrator nie obsługuje. W pozostałych przypadkach gotowy integrator jest zwykle tańszy na starcie i szybciej uruchamia sprzedaż.

Pytanie o API pojawia się w wielu polskich firmach, które przygotowują się do sprzedaży na otto.de. Zespół IT mówi, że „to tylko kilka endpointów”, a dział sprzedaży chce wystartować w ciągu kilku tygodni. Obie strony mają trochę racji. Dokumentacja OTTO jest publiczna i dobrze opisana, ale integracja z marketplace to nie jednorazowy projekt, tylko połączenie, które trzeba utrzymywać latami. W tym wpisie pokazujemy, co daje API OTTO Market, jak wygląda dostęp do niego i według jakich kryteriów zdecydować, czy budować własne połączenie, czy wybrać gotowe narzędzie.

[#wazne] W skrócie: API OTTO Market pozwala zarządzać produktami, stanami, zamówieniami, wysyłkami, zwrotami i reklamą Sponsored Product Ads z własnego systemu. Sprzedawca tworzy aplikację w OTTO Partner Connect, wybiera zakresy uprawnień i testuje połączenie w środowisku sandbox. Własna integracja ma sens przy własnym ERP, dużym katalogu lub nietypowych procesach - w innych przypadkach szybciej i taniej zadziała integrator. W Vinson pomagamy wybrać drogę i wdrażamy OTTO przez Base.

Czym jest API OTTO Market i co można przez nie zrobić

API OTTO Market to zestaw interfejsów REST opisanych w dokumentacji na api.otto.market. Korzystają z niego dwie grupy: sprzedawcy, którzy łączą się z platformą we własnym imieniu, oraz dostawcy usług (Service Partners), którzy budują integracje dla wielu sprzedawców - to z tej drugiej drogi korzystają integratory. Technicznie oba połączenia działają na tych samych interfejsach, różni się sposób autoryzacji i odpowiedzialność za utrzymanie.

Według dokumentacji API dzieli się na obszary funkcjonalne odpowiadające kolejnym etapom sprzedaży (stan na lipiec 2026 - sprawdź aktualną dokumentację API OTTO):

Produkty - wysyłanie wariantów z danymi, atrybutami, zdjęciami i kodami GTIN, sprawdzanie wyniku walidacji oraz włączanie i wyłączanie widoczności na otto.de.
Profile wysyłki i dostępność - tworzenie profili wysyłki, przypisywanie ich do SKU oraz aktualizacja liczby sztuk dostępnych do sprzedaży.
Zamówienia - pobieranie zamówień i ich pozycji oraz anulowanie pozycji, których nie możesz zrealizować.
Wysyłki - zgłaszanie przekazania paczki przewoźnikowi z numerem przesyłki, także dla przesyłek wielopaczkowych.
Zwroty i magazyn zwrotów - lista zapowiedzianych zwrotów, ich akceptacja lub odrzucenie oraz adresy zwrotów.
Dokumenty i korekty - pobieranie dokumentów sprzedaży oraz częściowe obniżki ceny po wysyłce.
Sponsored Product Ads - zarządzanie kampaniami reklamowymi i pobieranie raportów.

Te same obszary obsługują dobre integratory. Różnica polega na tym, kto pisze kod, kto pilnuje zmian w API i kto naprawia błędy, gdy coś przestaje działać. Najważniejsze bloki, które musisz pokryć przy własnym połączeniu:

[#chart:ott31a]

Jak wygląda dostęp do API OTTO dla sprzedawcy

Dostęp do API dostajesz dopiero po założeniu konta sprzedawcy i podpisaniu umowy. Kolejność formalności opisujemy we wpisie rejestracja na OTTO Market krok po kroku. Według przewodnika dla sprzedawców w dokumentacji API użytkownik w OTTO Partner Connect potrzebuje uprawnienia „API-Zugriff”. Potem w sekcji dostępu do API tworzy aplikację w środowisku testowym (sandbox) albo produkcyjnym, nadaje jej nazwę i wybiera co najmniej jeden zakres uprawnień, np. produkty, zamówienia, wysyłki czy zwroty.

Sekret aplikacji jest pokazywany tylko raz - jeśli go zgubisz, trzeba wygenerować nowy. Token dostępu pobierasz w modelu client credentials, czyli z identyfikatorem i sekretem aplikacji, bez logowania użytkownika. Według dokumentacji token jest ważny przez określony czas, a po jego upływie system musi pobrać nowy, bo w tym modelu nie ma tokenu odświeżającego (stan na lipiec 2026 - sprawdź aktualną dokumentację API OTTO). Liczba aplikacji na konto jest ograniczona, więc stare, nieużywane aplikacje warto usuwać.

Środowisko sandbox jest całkowicie oddzielone od produkcji - ma osobne logowanie i osobne klucze. Według dokumentacji można w nim wygenerować zamówienia testowe według gotowych scenariuszy, wysłać produkty przez walidację techniczną i symulowaną walidację sklepu oraz przetestować raporty reklamowe. Sandbox ma też ograniczenia: zamówienia i dane dynamiczne są co miesiąc czyszczone, a zwrotów nie da się w nim zapowiedzieć, bo nie ma prawdziwych klientów. Ścieżkę zwrotów i tak trzeba więc sprawdzić na pierwszych prawdziwych zamówieniach.

API OTTO Market czy gotowy integrator - główne różnice

Decyzja rzadko sprowadza się do techniki. Chodzi o koszty, czas i to, kto w firmie weźmie odpowiedzialność za połączenie. Porównanie najważniejszych kryteriów:

Kryterium	Gotowy integrator	Własna integracja przez API
Czas startu	Konfiguracja i mapowanie w panelu narzędzia	Projekt, programowanie, testy w sandbox i na produkcji
Koszt na start	Zwykle niski, czasem opłata za wdrożenie	Godziny pracy programistów i analityka
Koszt stały	Abonament zależny od zamówień, kanałów lub produktów	Utrzymanie, monitoring, poprawki i zmiany wersji API
Elastyczność	W granicach funkcji przewidzianych przez producenta	Dowolna logika: ceny, magazyny, priorytety zamówień
Zmiany w API OTTO	Po stronie producenta narzędzia	Po stronie Twojego zespołu, w terminie wyznaczonym przez OTTO
Inne kanały sprzedaży	Często w tym samym panelu (np. Allegro, sklep)	Każdy kanał to osobna integracja
Wsparcie przy błędach	Pomoc techniczna producenta	Własny zespół i Partner Helpdesk OTTO

API OTTO Market to publiczny interfejs, przez który sprzedawca lub dostawca usług łączy własny system bezpośrednio z kontem na OTTO - bez pośrednictwa gotowego integratora. Własną integrację przez API warto wdrożyć wtedy, gdy firma ma rozwijany przez siebie ERP lub WMS, duży i często zmieniający się katalog albo procesy, których integrator nie obsługuje. W pozostałych przypadkach gotowy integrator jest zwykle tańszy na starcie i szybciej uruchamia sprzedaż.

Pytanie o API pojawia się w wielu polskich firmach, które przygotowują się do sprzedaży na otto.de. Zespół IT mówi, że „to tylko kilka endpointów”, a dział sprzedaży chce wystartować w ciągu kilku tygodni. Obie strony mają trochę racji. Dokumentacja OTTO jest publiczna i dobrze opisana, ale integracja z marketplace to nie jednorazowy projekt, tylko połączenie, które trzeba utrzymywać latami. W tym wpisie pokazujemy, co daje API OTTO Market, jak wygląda dostęp do niego i według jakich kryteriów zdecydować, czy budować własne połączenie, czy wybrać gotowe narzędzie.

[#wazne] W skrócie: API OTTO Market pozwala zarządzać produktami, stanami, zamówieniami, wysyłkami, zwrotami i reklamą Sponsored Product Ads z własnego systemu. Sprzedawca tworzy aplikację w OTTO Partner Connect, wybiera zakresy uprawnień i testuje połączenie w środowisku sandbox. Własna integracja ma sens przy własnym ERP, dużym katalogu lub nietypowych procesach - w innych przypadkach szybciej i taniej zadziała integrator. W Vinson pomagamy wybrać drogę i wdrażamy OTTO przez Base.

Czym jest API OTTO Market i co można przez nie zrobić

API OTTO Market to zestaw interfejsów REST opisanych w dokumentacji na api.otto.market. Korzystają z niego dwie grupy: sprzedawcy, którzy łączą się z platformą we własnym imieniu, oraz dostawcy usług (Service Partners), którzy budują integracje dla wielu sprzedawców - to z tej drugiej drogi korzystają integratory. Technicznie oba połączenia działają na tych samych interfejsach, różni się sposób autoryzacji i odpowiedzialność za utrzymanie.

Według dokumentacji API dzieli się na obszary funkcjonalne odpowiadające kolejnym etapom sprzedaży (stan na lipiec 2026 - sprawdź aktualną dokumentację API OTTO):

Produkty - wysyłanie wariantów z danymi, atrybutami, zdjęciami i kodami GTIN, sprawdzanie wyniku walidacji oraz włączanie i wyłączanie widoczności na otto.de.
Profile wysyłki i dostępność - tworzenie profili wysyłki, przypisywanie ich do SKU oraz aktualizacja liczby sztuk dostępnych do sprzedaży.
Zamówienia - pobieranie zamówień i ich pozycji oraz anulowanie pozycji, których nie możesz zrealizować.
Wysyłki - zgłaszanie przekazania paczki przewoźnikowi z numerem przesyłki, także dla przesyłek wielopaczkowych.
Zwroty i magazyn zwrotów - lista zapowiedzianych zwrotów, ich akceptacja lub odrzucenie oraz adresy zwrotów.
Dokumenty i korekty - pobieranie dokumentów sprzedaży oraz częściowe obniżki ceny po wysyłce.
Sponsored Product Ads - zarządzanie kampaniami reklamowymi i pobieranie raportów.

Te same obszary obsługują dobre integratory. Różnica polega na tym, kto pisze kod, kto pilnuje zmian w API i kto naprawia błędy, gdy coś przestaje działać. Najważniejsze bloki, które musisz pokryć przy własnym połączeniu:

[#chart:ott31a]

Jak wygląda dostęp do API OTTO dla sprzedawcy

Dostęp do API dostajesz dopiero po założeniu konta sprzedawcy i podpisaniu umowy. Kolejność formalności opisujemy we wpisie rejestracja na OTTO Market krok po kroku. Według przewodnika dla sprzedawców w dokumentacji API użytkownik w OTTO Partner Connect potrzebuje uprawnienia „API-Zugriff”. Potem w sekcji dostępu do API tworzy aplikację w środowisku testowym (sandbox) albo produkcyjnym, nadaje jej nazwę i wybiera co najmniej jeden zakres uprawnień, np. produkty, zamówienia, wysyłki czy zwroty.

Sekret aplikacji jest pokazywany tylko raz - jeśli go zgubisz, trzeba wygenerować nowy. Token dostępu pobierasz w modelu client credentials, czyli z identyfikatorem i sekretem aplikacji, bez logowania użytkownika. Według dokumentacji token jest ważny przez określony czas, a po jego upływie system musi pobrać nowy, bo w tym modelu nie ma tokenu odświeżającego (stan na lipiec 2026 - sprawdź aktualną dokumentację API OTTO). Liczba aplikacji na konto jest ograniczona, więc stare, nieużywane aplikacje warto usuwać.

Środowisko sandbox jest całkowicie oddzielone od produkcji - ma osobne logowanie i osobne klucze. Według dokumentacji można w nim wygenerować zamówienia testowe według gotowych scenariuszy, wysłać produkty przez walidację techniczną i symulowaną walidację sklepu oraz przetestować raporty reklamowe. Sandbox ma też ograniczenia: zamówienia i dane dynamiczne są co miesiąc czyszczone, a zwrotów nie da się w nim zapowiedzieć, bo nie ma prawdziwych klientów. Ścieżkę zwrotów i tak trzeba więc sprawdzić na pierwszych prawdziwych zamówieniach.

API OTTO Market czy gotowy integrator - główne różnice

Decyzja rzadko sprowadza się do techniki. Chodzi o koszty, czas i to, kto w firmie weźmie odpowiedzialność za połączenie. Porównanie najważniejszych kryteriów:

Kryterium	Gotowy integrator	Własna integracja przez API
Czas startu	Konfiguracja i mapowanie w panelu narzędzia	Projekt, programowanie, testy w sandbox i na produkcji
Koszt na start	Zwykle niski, czasem opłata za wdrożenie	Godziny pracy programistów i analityka
Koszt stały	Abonament zależny od zamówień, kanałów lub produktów	Utrzymanie, monitoring, poprawki i zmiany wersji API
Elastyczność	W granicach funkcji przewidzianych przez producenta	Dowolna logika: ceny, magazyny, priorytety zamówień
Zmiany w API OTTO	Po stronie producenta narzędzia	Po stronie Twojego zespołu, w terminie wyznaczonym przez OTTO
Inne kanały sprzedaży	Często w tym samym panelu (np. Allegro, sklep)	Każdy kanał to osobna integracja
Wsparcie przy błędach	Pomoc techniczna producenta	Własny zespół i Partner Helpdesk OTTO

Kiedy warto wdrożyć własną integrację z API OTTO

Własne połączenie z API OTTO Market opłaca się w kilku konkretnych sytuacjach. Wspólny mianownik jest jeden: firma ma już zespół IT i system, który i tak trzeba utrzymywać, a integrator dokładałby kolejną warstwę zamiast ją upraszczać. Szybki test dla Twojej firmy:

[#chart:ott31b]

Własny ERP lub WMS rozwijany przez firmę

Jeśli stany, ceny i zamówienia żyją w systemie, który Twój zespół sam rozwija, dołożenie integratora oznacza dwie synchronizacje zamiast jednej: ERP z integratorem i integrator z OTTO. Każde ogniwo to dodatkowe opóźnienie i dodatkowe miejsce, w którym może pojawić się błąd. Bezpośrednie połączenie ERP z API OTTO skraca drogę danych i pozwala obsłużyć zamówienia w tych samych procesach co inne kanały.

Duży katalog i częste zmiany cen lub stanów

Przy tysiącach wariantów i częstych zmianach cen abonament części integratorów rośnie razem ze skalą. Własna integracja może wysyłać tylko zmienione dane, w paczkach i w kolejności, która odpowiada Twoim priorytetom. Według dokumentacji OTTO stany aktualizuje się osobnym interfejsem dostępności, partiami po wiele SKU w jednym zapytaniu, niezależnie od pełnych danych produktu (stan na lipiec 2026 - sprawdź aktualną dokumentację API OTTO).

Nietypowe procesy logistyczne lub reklamowe

Meble wysyłane w kilku paczkach, towar spedycyjny, kilka magazynów albo własne reguły rezerwacji to obszary, w których integratory różnią się najbardziej. API OTTO przewiduje m.in. przesyłki wielopaczkowe dla jednej pozycji i osobne profile wysyłki dla grup produktów. Podobnie z reklamą: jeśli chcesz automatycznie zmieniać kampanie Sponsored Product Ads na podstawie marży z ERP, potrzebujesz dostępu do interfejsu reklamowego i raportów.

Kiedy lepiej zostać przy gotowym integratorze

Dla większości polskich sprzedawców wchodzących na OTTO gotowy integrator jest rozsądniejszym wyborem. Dotyczy to zwłaszcza firm, które już pracują w systemie multichannel przy Allegro i sklepie, mają katalog liczony w setkach, a nie dziesiątkach tysięcy wariantów, i nie mają programisty, który mógłby zająć się połączeniem także za rok. Integrator rozwiązuje też problem, o którym łatwo zapomnieć: zmiany wersji API. Według wytycznych w dokumentacji OTTO starsza wersja interfejsu jest wspierana przez określony czas od ogłoszenia nowej, a potem trzeba przejść na nową (stan na lipiec 2026 - sprawdź aktualną dokumentację API OTTO). Przy integratorze ten obowiązek spoczywa na producencie. Przegląd narzędzi z gotowym połączeniem znajdziesz we wpisie integratory do OTTO Market - porównanie narzędzi.

Model mieszany - integrator i własne uzupełnienia

Wybór nie musi być zero-jedynkowy. Część firm wystawia produkty i obsługuje zamówienia przez integrator, a własną aplikację z wąskim zakresem uprawnień tworzy tylko do jednego zadania, np. pobierania raportów reklamowych do arkusza z marżami. Przed takim rozwiązaniem ustal z producentem integratora, które dane może zmieniać Twoja aplikacja, żeby dwa systemy nie nadpisywały sobie nawzajem tych samych pól.

Ile kosztuje własna integracja z API OTTO - jak to policzyć

Nie da się podać jednej kwoty, bo koszt zależy od systemu źródłowego, liczby procesów i stawek zespołu. Da się za to policzyć go uczciwie. Zsumuj godziny potrzebne na analizę, programowanie, testy w sandbox i pierwsze tygodnie na produkcji. Dodaj stały czas na utrzymanie: monitoring błędów, obsługę limitów zapytań, aktualizacje słowników kategorii i marek oraz migracje na nowe wersje interfejsów. Wynik porównaj z abonamentem integratora w perspektywie dwóch lub trzech lat, przeliczonym na zamówienie przy skali, której spodziewasz się na wszystkich kanałach.

[#przyklad] Przykład rachunku: firma z własnym ERP i jednym programistą planuje sprzedaż kilku tysięcy wariantów na OTTO. Integracja zajmie zespołowi kilka tygodni, a utrzymanie kilka godzin miesięcznie. Ten sam czas programisty mógłby pójść na inne projekty, więc w rachunku liczy się nie tylko wynagrodzenie, ale też to, czego zespół w tym czasie nie zrobi. Jeśli porównanie wychodzi na remis, zwykle wygrywa integrator, bo ryzyko zmian w API bierze na siebie producent.

Jak przebiega wdrożenie integracji z API OTTO krok po kroku

Własną integrację najlepiej budować etapami, tak żeby każdy obszar przetestować osobno, zanim zaczniesz przyjmować prawdziwe zamówienia. Kolejność, która sprawdza się w praktyce:

[#chart:ott31c]

Przy pierwszym imporcie produktów zacznij od jednej kategorii. Dane produktowe dla OTTO wymagają mapowania kategorii, marek i atrybutów oraz kodu GTIN dla każdego wariantu - szczegóły opisujemy we wpisie integracja z OTTO Market - jak połączyć sklep i feed produktowy. Przy własnym API cała ta logika mapowania jest po Twojej stronie.

Na co uważać przy własnej integracji z API OTTO Market

Dokumentacja OTTO zawiera zbiór dobrych praktyk, które warto przeczytać przed pierwszą linijką kodu. Najczęstsze pułapki:

Limity zapytań. Każdy interfejs ma własne limity, a ich przekroczenie kończy się błędem HTTP 429. Integracja musi wtedy zwolnić i ponowić zapytanie, inaczej część danych o stanach nie dotrze do OTTO.
Asynchroniczne przetwarzanie produktów. Odpowiedź 202 oznacza tylko przyjęcie danych. Wynik walidacji trzeba pobrać z zadania aktualizacji, a status na otto.de sprawdzić osobno.
Zamówienia zapowiedziane. Według dokumentacji zamówienie przez pewien czas ma status zapowiedzianego (ANNOUNCED), zanim stanie się gotowe do realizacji. Warto już wtedy rezerwować towar, żeby nie sprzedać go w innym kanale.
Słowniki kategorii i marek. OTTO zaleca regularne, najlepiej codzienne odświeżanie list kategorii i marek, bo wymagania w kategoriach się zmieniają.
Wysyłki i zwroty. Przy paczkach potrzebujesz numeru przesyłki do klienta i numeru przesyłki zwrotnej, a zwroty do Polski wracają przez DHL eCommerce. Zaakceptowanego zwrotu nie da się później odrzucić.
Stałe identyfikatory. Po utworzeniu produktu para referencji produktu i SKU nie powinna się zmieniać - zmiany wymagają wcześniejszego wyłączenia wariantu.

[#uwaga] Ustal jedno źródło prawdy dla produktów, stanów i cen. Jeśli część zespołu poprawia dane ręcznie w OTTO Partner Connect, a integracja wysyła swoje wartości z ERP, kolejna synchronizacja nadpisze zmiany i nikt nie będzie wiedział, która wersja jest właściwa.

Jak Vinson pomaga wybrać między API OTTO a integratorem

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 pomagamy zdecydować, czy połączenie przez integrator wystarczy, i wdrażamy je tak, żeby nie trzeba było go poprawiać po pierwszych zamówieniach.

Analiza systemów i procesów: skąd pochodzą produkty, stany i zamówienia oraz czego potrzebuje OTTO.
Porównanie kosztu integratora i własnego połączenia przy Twojej skali sprzedaży.
Integracja OTTO z Base razem z Allegro, sklepem i innymi kanałami.
Mapowanie kategorii i atrybutów, dane po niemiecku i zamówienie testowe przed startem.

Najczęściej zadawane pytania

Czy każdy sprzedawca może korzystać z API OTTO Market?

Tak, dostęp do API ma sprzedawca z aktywnym kontem w OTTO Partner Connect. Użytkownik potrzebuje uprawnienia do dostępu do API, a potem tworzy w panelu aplikację w środowisku testowym lub produkcyjnym i wybiera jej zakresy uprawnień.

Czym różni się integracja przez API od integratora?

Integrator to gotowe narzędzie, które korzysta z API OTTO w Twoim imieniu i jest utrzymywane przez producenta. Własna integracja to połączenie zbudowane przez Twój zespół - daje pełną kontrolę nad logiką, ale wymaga stałego utrzymania i dostosowania do zmian w API.

Czy API OTTO ma środowisko testowe?

Tak, OTTO udostępnia sandbox oddzielony od produkcji, z osobnymi kluczami. Można w nim tworzyć zamówienia testowe według gotowych scenariuszy i testować wysyłanie produktów, ale nie da się zasymulować zwrotów od klientów, a dane są okresowo czyszczone.

Jak długo trwa wdrożenie własnej integracji z OTTO?

To zależy od systemu źródłowego i zakresu procesów. Integracja produktów, stanów, zamówień, wysyłek i zwrotów to zwykle projekt na wiele tygodni, licząc testy w sandbox i pierwsze zamówienia na produkcji. Gotowy integrator da się zwykle skonfigurować znacznie szybciej.

Czy przez API OTTO można prowadzić reklamy?

Tak, dokumentacja API obejmuje interfejs Sponsored Product Ads do zarządzania kampaniami oraz osobny interfejs raportów. Pozwala to np. łączyć dane o kampaniach z marżą z własnego systemu, ale wymaga dodatkowego zakresu uprawnień w aplikacji.

Zastanawiasz się, czy zespół IT powinien budować połączenie z OTTO, czy wystarczy gotowe narzędzie? Zobacz, jak prowadzimy sprzedaż na OTTO z Vinson - od analizy systemów po pierwsze zamówienia z Niemiec.

Kiedy warto wdrożyć własną integrację z API OTTO

Własne połączenie z API OTTO Market opłaca się w kilku konkretnych sytuacjach. Wspólny mianownik jest jeden: firma ma już zespół IT i system, który i tak trzeba utrzymywać, a integrator dokładałby kolejną warstwę zamiast ją upraszczać. Szybki test dla Twojej firmy:

[#chart:ott31b]

Własny ERP lub WMS rozwijany przez firmę

Jeśli stany, ceny i zamówienia żyją w systemie, który Twój zespół sam rozwija, dołożenie integratora oznacza dwie synchronizacje zamiast jednej: ERP z integratorem i integrator z OTTO. Każde ogniwo to dodatkowe opóźnienie i dodatkowe miejsce, w którym może pojawić się błąd. Bezpośrednie połączenie ERP z API OTTO skraca drogę danych i pozwala obsłużyć zamówienia w tych samych procesach co inne kanały.

Duży katalog i częste zmiany cen lub stanów

Przy tysiącach wariantów i częstych zmianach cen abonament części integratorów rośnie razem ze skalą. Własna integracja może wysyłać tylko zmienione dane, w paczkach i w kolejności, która odpowiada Twoim priorytetom. Według dokumentacji OTTO stany aktualizuje się osobnym interfejsem dostępności, partiami po wiele SKU w jednym zapytaniu, niezależnie od pełnych danych produktu (stan na lipiec 2026 - sprawdź aktualną dokumentację API OTTO).

Nietypowe procesy logistyczne lub reklamowe

Meble wysyłane w kilku paczkach, towar spedycyjny, kilka magazynów albo własne reguły rezerwacji to obszary, w których integratory różnią się najbardziej. API OTTO przewiduje m.in. przesyłki wielopaczkowe dla jednej pozycji i osobne profile wysyłki dla grup produktów. Podobnie z reklamą: jeśli chcesz automatycznie zmieniać kampanie Sponsored Product Ads na podstawie marży z ERP, potrzebujesz dostępu do interfejsu reklamowego i raportów.

Kiedy lepiej zostać przy gotowym integratorze

Dla większości polskich sprzedawców wchodzących na OTTO gotowy integrator jest rozsądniejszym wyborem. Dotyczy to zwłaszcza firm, które już pracują w systemie multichannel przy Allegro i sklepie, mają katalog liczony w setkach, a nie dziesiątkach tysięcy wariantów, i nie mają programisty, który mógłby zająć się połączeniem także za rok. Integrator rozwiązuje też problem, o którym łatwo zapomnieć: zmiany wersji API. Według wytycznych w dokumentacji OTTO starsza wersja interfejsu jest wspierana przez określony czas od ogłoszenia nowej, a potem trzeba przejść na nową (stan na lipiec 2026 - sprawdź aktualną dokumentację API OTTO). Przy integratorze ten obowiązek spoczywa na producencie. Przegląd narzędzi z gotowym połączeniem znajdziesz we wpisie integratory do OTTO Market - porównanie narzędzi.

Model mieszany - integrator i własne uzupełnienia

Wybór nie musi być zero-jedynkowy. Część firm wystawia produkty i obsługuje zamówienia przez integrator, a własną aplikację z wąskim zakresem uprawnień tworzy tylko do jednego zadania, np. pobierania raportów reklamowych do arkusza z marżami. Przed takim rozwiązaniem ustal z producentem integratora, które dane może zmieniać Twoja aplikacja, żeby dwa systemy nie nadpisywały sobie nawzajem tych samych pól.

Ile kosztuje własna integracja z API OTTO - jak to policzyć

Nie da się podać jednej kwoty, bo koszt zależy od systemu źródłowego, liczby procesów i stawek zespołu. Da się za to policzyć go uczciwie. Zsumuj godziny potrzebne na analizę, programowanie, testy w sandbox i pierwsze tygodnie na produkcji. Dodaj stały czas na utrzymanie: monitoring błędów, obsługę limitów zapytań, aktualizacje słowników kategorii i marek oraz migracje na nowe wersje interfejsów. Wynik porównaj z abonamentem integratora w perspektywie dwóch lub trzech lat, przeliczonym na zamówienie przy skali, której spodziewasz się na wszystkich kanałach.

[#przyklad] Przykład rachunku: firma z własnym ERP i jednym programistą planuje sprzedaż kilku tysięcy wariantów na OTTO. Integracja zajmie zespołowi kilka tygodni, a utrzymanie kilka godzin miesięcznie. Ten sam czas programisty mógłby pójść na inne projekty, więc w rachunku liczy się nie tylko wynagrodzenie, ale też to, czego zespół w tym czasie nie zrobi. Jeśli porównanie wychodzi na remis, zwykle wygrywa integrator, bo ryzyko zmian w API bierze na siebie producent.

Jak przebiega wdrożenie integracji z API OTTO krok po kroku

Własną integrację najlepiej budować etapami, tak żeby każdy obszar przetestować osobno, zanim zaczniesz przyjmować prawdziwe zamówienia. Kolejność, która sprawdza się w praktyce:

[#chart:ott31c]

Przy pierwszym imporcie produktów zacznij od jednej kategorii. Dane produktowe dla OTTO wymagają mapowania kategorii, marek i atrybutów oraz kodu GTIN dla każdego wariantu - szczegóły opisujemy we wpisie integracja z OTTO Market - jak połączyć sklep i feed produktowy. Przy własnym API cała ta logika mapowania jest po Twojej stronie.

Na co uważać przy własnej integracji z API OTTO Market

Dokumentacja OTTO zawiera zbiór dobrych praktyk, które warto przeczytać przed pierwszą linijką kodu. Najczęstsze pułapki:

Limity zapytań. Każdy interfejs ma własne limity, a ich przekroczenie kończy się błędem HTTP 429. Integracja musi wtedy zwolnić i ponowić zapytanie, inaczej część danych o stanach nie dotrze do OTTO.
Asynchroniczne przetwarzanie produktów. Odpowiedź 202 oznacza tylko przyjęcie danych. Wynik walidacji trzeba pobrać z zadania aktualizacji, a status na otto.de sprawdzić osobno.
Zamówienia zapowiedziane. Według dokumentacji zamówienie przez pewien czas ma status zapowiedzianego (ANNOUNCED), zanim stanie się gotowe do realizacji. Warto już wtedy rezerwować towar, żeby nie sprzedać go w innym kanale.
Słowniki kategorii i marek. OTTO zaleca regularne, najlepiej codzienne odświeżanie list kategorii i marek, bo wymagania w kategoriach się zmieniają.
Wysyłki i zwroty. Przy paczkach potrzebujesz numeru przesyłki do klienta i numeru przesyłki zwrotnej, a zwroty do Polski wracają przez DHL eCommerce. Zaakceptowanego zwrotu nie da się później odrzucić.
Stałe identyfikatory. Po utworzeniu produktu para referencji produktu i SKU nie powinna się zmieniać - zmiany wymagają wcześniejszego wyłączenia wariantu.

[#uwaga] Ustal jedno źródło prawdy dla produktów, stanów i cen. Jeśli część zespołu poprawia dane ręcznie w OTTO Partner Connect, a integracja wysyła swoje wartości z ERP, kolejna synchronizacja nadpisze zmiany i nikt nie będzie wiedział, która wersja jest właściwa.

Jak Vinson pomaga wybrać między API OTTO a integratorem

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 pomagamy zdecydować, czy połączenie przez integrator wystarczy, i wdrażamy je tak, żeby nie trzeba było go poprawiać po pierwszych zamówieniach.

Analiza systemów i procesów: skąd pochodzą produkty, stany i zamówienia oraz czego potrzebuje OTTO.
Porównanie kosztu integratora i własnego połączenia przy Twojej skali sprzedaży.
Integracja OTTO z Base razem z Allegro, sklepem i innymi kanałami.
Mapowanie kategorii i atrybutów, dane po niemiecku i zamówienie testowe przed startem.

Najczęściej zadawane pytania

Czy każdy sprzedawca może korzystać z API OTTO Market?

Tak, dostęp do API ma sprzedawca z aktywnym kontem w OTTO Partner Connect. Użytkownik potrzebuje uprawnienia do dostępu do API, a potem tworzy w panelu aplikację w środowisku testowym lub produkcyjnym i wybiera jej zakresy uprawnień.

Czym różni się integracja przez API od integratora?

Integrator to gotowe narzędzie, które korzysta z API OTTO w Twoim imieniu i jest utrzymywane przez producenta. Własna integracja to połączenie zbudowane przez Twój zespół - daje pełną kontrolę nad logiką, ale wymaga stałego utrzymania i dostosowania do zmian w API.

Czy API OTTO ma środowisko testowe?

Tak, OTTO udostępnia sandbox oddzielony od produkcji, z osobnymi kluczami. Można w nim tworzyć zamówienia testowe według gotowych scenariuszy i testować wysyłanie produktów, ale nie da się zasymulować zwrotów od klientów, a dane są okresowo czyszczone.

Jak długo trwa wdrożenie własnej integracji z OTTO?

To zależy od systemu źródłowego i zakresu procesów. Integracja produktów, stanów, zamówień, wysyłek i zwrotów to zwykle projekt na wiele tygodni, licząc testy w sandbox i pierwsze zamówienia na produkcji. Gotowy integrator da się zwykle skonfigurować znacznie szybciej.

Czy przez API OTTO można prowadzić reklamy?

Tak, dokumentacja API obejmuje interfejs Sponsored Product Ads do zarządzania kampaniami oraz osobny interfejs raportów. Pozwala to np. łączyć dane o kampaniach z marżą z własnego systemu, ale wymaga dodatkowego zakresu uprawnień w aplikacji.

Zastanawiasz się, czy zespół IT powinien budować połączenie z OTTO, czy wystarczy gotowe narzędzie? Zobacz, jak prowadzimy sprzedaż na OTTO z Vinson - od analizy systemów po pierwsze zamówienia z Niemiec.

API OTTO Market - kiedy warto je wdrożyć zamiast gotowego integratora