Elbuz łączy się z Twoim sklepem na OTTO Market (otto.de) kluczami Twojej aplikacji z OTTO Partner Connect: pobiera produkty, zamówienia i zwroty, a z powrotem wysyła karty, ceny, stany i wysyłki.
Kiedy to się przyda:
- Katalog prowadzisz w Elbuz — nowe produkty trafiają na OTTO pełną kartą z kategorią, marką i obowiązkowymi atrybutami.
- Wysyłasz z własnego magazynu — Twój status przekazuje na OTTO numer przesyłki, a dla paczek także numer zwrotu.
- Klienci zwracają towary — zwrot przychodzi jako dokument, a decyzję przekazujesz statusem.
Od czego zacząć: utwórz aplikację w OTTO Partner Connect i wklej jej Client ID oraz Client Secret do szablonu importu typu „OTTO”.
Co potrafi integracja z OTTO
- Połączenie Twoją aplikacją — Client ID i Client Secret, bez pośredników.
- Import produktów — nazwa, marka, opis, kod kreskowy, cena, stan, kategoria i zdjęcia.
- Zamówienia — z adresem, dostawą i cenami po rabacie.
- Ceny i stany — z powrotem na OTTO, wynik w dzienniku.
- Nowe karty — z kategorią OTTO, marką, obowiązkowymi atrybutami i danymi GPSR.
- Wysyłka i anulowanie — Twoim statusem zamówienia.
- Zwroty — dokumentem „Zwrot od klienta”, przyjęcie lub odrzucenie — statusem.
Co wziąć z OTTO Partner Connect
Elbuz pracuje z OTTO przez Twoją własną aplikację. Utwórz ją w OTTO Partner Connect, w sekcji API-Zugriff, i nadaj jej zakresy:
| Zakres | Do czego Elbuz go używa |
|---|---|
products | produkty, ceny, nowe karty, kategorie i marki |
orders | zamówienia i anulowania |
shipments | wysyłki z numerem przesyłki |
availability | stany, profil wysyłki i czas realizacji nowych kart |
returns | zwroty od klientów |
shipping-profiles | rodzaj dostawy produktu: paczka czy dostawa spedycyjna |
Aplikacja bez returns lub shipping-profiles działa, ale zwroty się nie importują, a wysyłka paczek nie jest przekazywana.
1
Client ID aplikacji2
Client Secret aplikacji3
Piaskownica4
ID profilu wysyłki5
Czas realizacji zamówienia- Client ID aplikacji — z OTTO Partner Connect, sekcja API-Zugriff.
- Client Secret aplikacji — sekret tej samej aplikacji.
- Piaskownica — 1 dla środowiska testowego OTTO, puste dla konta produkcyjnego.
- ID profilu wysyłki — bez niego nowych kart nie da się zamówić.
- Czas realizacji zamówienia — od 1 do 99 dni; puste — jak w profilu.
| Pole w szablonie | Co wpisać |
|---|---|
| Client ID aplikacji, Client Secret aplikacji | Klucze aplikacji z API-Zugriff. Obowiązkowe |
| Piaskownica | 1 — praca ze środowiskiem testowym OTTO; puste — z kontem produkcyjnym |
| ID profilu wysyłki (dla nowych ofert) | Profil wysyłki z panelu OTTO. Bez niego nowych kart nie będzie można zamówić |
| Czas realizacji zamówienia, dni | Od 1 do 99. Puste — jak w profilu wysyłki |
Po wklejeniu kluczy poczekaj na napis „Wszystkie zmiany zapisane” i kliknij „Sprawdź połączenie”. Odpowiedź „Połączenie działa. OTTO Market” (z dopiskiem „sandbox” dla piaskownicy) oznacza, że klucze są poprawne.
„Aktywny” i „Zamówienia” są w nowym szablonie już włączone: 5 minut po zapisaniu kluczy Elbuz zacznie pobierać zamówienia z 30 dni. Statusy platformy Elbuz dopasowuje do Twoich sam, po nazwie; co przyszło i jak zostało dopasowane, widać w oknie „Statusy zamówienia” szablonu. Chcesz najpierw sprawdzić — odznacz „Zamówienia”.
Opis interfejsów, z których korzysta Elbuz: OTTO Market API.
Co trafia do karty
Elbuz pobiera Twoje produkty z OTTO razem ze stanami i nazwami marek i zapisuje każdy wariant w katalogu bazowym jako kartę produktu.
| Dane OTTO | Pole produktu w Elbuz |
|---|---|
| nazwa (productLine), bez niej — SKU | Nazwa |
| opis | Opis |
| marka | Producent |
| SKU wariantu | Kod (SKU) |
| EAN | Kod kreskowy |
| cena | Cena |
| stan | Ilość |
| kategoria OTTO | Kategoria — znaleziona po nazwie lub utworzona |
| zdjęcia | Zdjęcia |
Ponowny import znajduje kartę po powiązaniu z SKU. Żeby przebieg w ogóle nie ruszał karty, włącz w niej przełącznik „Nie aktualizuj” (sekcja „Ochrona podczas importu”); żeby nie ruszał tylko cen — „Stała cena”.
Jak przychodzą zamówienia
Zamówienie zapisuje się jako dokument „Zamówienie klienta”, niezatwierdzony. Pierwszy import pobiera zamówienia z ostatnich 30 dni, kolejne — zmienione od daty ostatniego importu, z zapasem 12 godzin. Istniejące zamówienie jest rozpoznawane po numerze i aktualizowane.
Zamówienia na OTTO nie trzeba przyjmować: platforma przekazuje je sprzedawcy już do realizacji. Przez mniej więcej pierwsze pół godziny nowe zamówienie jest w stanie „zapowiedziane” i nie ma adresu — takie Elbuz pomija i pobiera w następnym przebiegu, gdy adres się pojawi.
- Pozycje. OTTO liczy każdą sztukę jako osobną pozycję; Elbuz łączy jednakowe produkty z jednakową ceną w jeden wiersz z ilością.
- Cena — z VAT, już po rabacie.
- Dostawa — kwota dostawy zamówienia; suma dokumentu — pozycje razem z dostawą.
- Anulowane pozycje nie trafiają do dokumentu, jeśli w zamówieniu są inne.
Statusy zamówienia
Status platformy Elbuz dopasowuje do Twojego sam — po kodzie lub nazwie, a nierozpoznany zapisuje jako „Nowy”. Doprecyzujesz to przyciskiem „Statusy zamówienia” w karcie „Powiązane ustawienia” szablonu importu: w kolumnie „Kod (nazwa) na stronie (API)” obok swojego statusu wpisz kod OTTO.
| Kod OTTO | Co oznacza |
|---|---|
PROCESSABLE | Gotowe do realizacji — trzeba je wysłać |
SENT | Wysłane |
RETURNED | Zwrócone |
CANCELLED_BY_PARTNER | Anulowane przez Ciebie |
CANCELLED_BY_MARKETPLACE | Anulowane przez platformę |
Status, przy którym stoi SENT lub CANCELLED_BY_PARTNER, eksport wysyła na OTTO (wysyłka). Co dzieje się z zatwierdzonym zamówieniem i rezerwacją, opisano w artykule import zamówień przez API.
Jak ceny i stany wracają na OTTO
Duże wolumeny idą partiami: do 500 wariantów w partii cen i danych, do 200 produktów w partii stanów. Dostęp program odnawia sam. Opis nowej karty jest obcinany do 5 000 znaków. Stan produktu na platformie zapisuje się w powiązaniu produktu: PENDING, ONLINE, RESTRICTED, REJECTED, INACTIVE.
Kierunek odwrotny to osobny szablon eksportu typu „OTTO”. Ma trzy pola:
- Client ID aplikacji i Client Secret aplikacji — te same co w szablonie importu. Piaskownicę, profil wysyłki i czas realizacji eksport bierze stamtąd.
- Wersja API (parametry platformy) — adres, z którego wysyłasz:
kraj|kod|miasto, np.DE|10115|Berlin. Bez niego wysyłki nie są przekazywane.
1
Client ID aplikacji2
Client Secret aplikacji3
Adres nadania- Client ID aplikacji — ten sam co w szablonie importu.
- Client Secret aplikacji — ten sam sekret.
- Wersja API (parametry platformy) — adres nadania: kraj|kod|miasto.
Aktualizowane są produkty powiązane z kartami OTTO. Cena idzie w euro z VAT — Elbuz nie przelicza waluty, więc ceny w wyniku filtrowania muszą być w euro. Stan — ilość produktu, nie mniej niż zero.
Dlaczego cena nie aktualizuje się od razu
Ceny i nowe karty OTTO przyjmuje jako zadanie i przetwarza je po swojej stronie. Elbuz czeka na wynik około minuty. Jeśli się nie doczeka — w dzienniku jest „OTTO: zadanie ‹numer› jest jeszcze przetwarzane, wynik — przy następnym uruchomieniu”, a następne uruchomienie odbierze wynik. Stany platforma przyjmuje od razu.
| Co jest w dzienniku | Co to oznacza |
|---|---|
| „OTTO: ceny — sukces: N, błędów: M” | Podsumowanie uruchomienia |
| „OTTO: «‹nazwa›» (‹SKU›) odrzucono: ‹powód›” | Platforma nie przyjęła ceny lub karty |
| „OTTO: produkt ‹SKU› odrzucony przez platformę: ‹powód›” | Produkt jest już na OTTO, ale platforma zdjęła go ze sprzedaży (status REJECTED) |
| „OTTO: ‹pole› — ‹błąd›” | Platforma nie przyjęła stanu konkretnego produktu |
Harmonogram i limit zapytań
OTTO nie wysyła natychmiastowych powiadomień, więc zamówienia i zwroty Elbuz pobiera sam co 5 minut, jeśli w szablonie zaznaczono „Zamówienia” i wypełniono klucze. Robi to wspólne zadanie „Zamówienia z marketplace’ów” w oknie „Harmonogram zadań”, tam też zmienia się interwał. Katalog w tym przebiegu się nie importuje, a zamówienia pobrane także przez harmonogram szablonu się nie dublują.
Katalog aktualizuje harmonogram samego szablonu — przycisk „Ustawienia harmonogramu” w karcie „Powiązane ustawienia”. Ustaw go rzadko, np. na noc: dopóki trwa import katalogu, przebieg zamówień jest pomijany do następnego. Ceny i stany na OTTO wysyła szablon eksportu według własnego harmonogramu — od kilku razy dziennie do co godzinę.
OTTO ogranicza częstotliwość zapytań. Elbuz sam utrzymuje tempo poniżej limitu, a po odmowie z powodu limitu czeka i ponawia. Jeśli to nie pomoże — w dzienniku jest „OTTO: przekroczono limit zapytań, spróbuj później”. Przerwany przebieg można bezpiecznie powtórzyć: jeśli przebieg się przerwał.
Nowe karty na OTTO
OTTO nie pozwala wystawić oferty na cudzej karcie: każdy produkt sprzedawca opisuje sam. Dlatego z zaznaczonym „Publikuj nowe produkty” produkt bez powiązania trafia na OTTO pełną kartą. Przed wysłaniem Elbuz sprawdza, czy jest wszystko, co potrzebne:
| Co jest potrzebne | Skąd Elbuz to bierze |
|---|---|
| Kod kreskowy od 8 cyfr | pole „Kod kreskowy” produktu |
| Kategoria OTTO | kategoria produktu dopasowana do kategorii OTTO (karta OTTO w oknie dopasowania) |
| Marka z listy OTTO | producent produktu; nazwa musi się zgadzać z marką dostępną dla Ciebie na OTTO |
| Co najmniej jedno zdjęcie | zdjęcia produktu, do 20 sztuk |
| Obowiązkowe atrybuty kategorii | atrybuty produktu o dokładnie takiej samej nazwie jak w OTTO — zwykle po niemiecku |
Nazwa (do 100 znaków) i opis są brane w języku z pola „Język opisów” szablonu eksportu — dla OTTO wybierz niemiecki. Stawka VAT — z klasy podatkowej produktu: do 10% — obniżona (7%), powyżej i bez klasy — podstawowa (19%). Kod karty — kod (SKU) produktu; bez niego lub z kodem dłuższym niż 50 znaków — ID produktu w Elbuz.
Jeśli czegoś brakuje, karta nie jest wysyłana, a w dzienniku pojawia się lista: „OTTO: karta «‹nazwa›» nie została wysłana — brak zdjęć; nie wypełniono obowiązkowych atrybutów kategorii OTTO: ‹atrybuty›”. Wartości, których nie ma w produkcie, Elbuz nie wymyśla: dodaj atrybuty o nazwach z listy.
Dane GPSR
Rozporządzenie UE w sprawie ogólnego bezpieczeństwa produktów wymaga w karcie danych producenta i osoby odpowiedzialnej w UE. Elbuz bierze je z okna „Bezpieczeństwo produktów (GPSR) — eMAG, OTTO” — otwiera się ono przyciskiem w formularzu szablonu importu OTTO (lub eMAG), dane są wspólne. Wymagana jest co najmniej osoba odpowiedzialna w UE. Jeśli dane nie są wypełnione, Elbuz wysyła kartę bez nich, a OTTO decyduje samo — zwykle odrzuca.
Co się dzieje po wysłaniu
- Dziennik: „OTTO: wysłano kart: N, zadanie ‹numer›”. Dopóki OTTO przetwarza zadanie, kolejne uruchomienia pomijają te produkty: „OTTO: nowe karty są jeszcze przetwarzane: N”.
- Karta przyjęta — „OTTO: karta «‹nazwa›» (‹SKU›) przyjęta”, produkt zostaje powiązany. Elbuz od razu wysyła dla niego profil wysyłki i czas realizacji z szablonu importu.
- Odrzucona — „OTTO: «‹nazwa›» (‹SKU›) odrzucono: ‹powód›”, powiązanie jest usuwane, następne uruchomienie spróbuje ponownie.
Jeśli w szablonie importu pole „ID profilu wysyłki” jest puste, karta pojawi się na OTTO, ale nie da się jej zamówić. Dziennik ostrzeże: „OTTO: w szablonie importu nie podano ID profilu wysyłki — nowych kart nie będzie można zamówić”.
Wysyłka, numer zwrotu i anulowanie
Opcja „Zamówienia” w szablonie eksportu przekazuje na OTTO dwa zdarzenia z Twoich zamówień:
| Twój status dopasowany do | Co wysyła Elbuz |
|---|---|
SENT | Wysyłkę wszystkich pozycji gotowych do wysłania, z przewoźnikiem i numerem przesyłki |
CANCELLED_BY_PARTNER | Anulowanie zamówienia |
Do wysyłki OTTO wymaga trzech rzeczy i bez którejkolwiek z nich zdarzenie nie idzie:
- Numer przesyłki — pole „Numer listu przewozowego” w karcie „Dostawa” dokumentu (rozwiń „Więcej pól”).
- Przewoźnik z listy OTTO — DHL, DPD, GLS, HERMES, UPS i inni. Elbuz bierze kod z przycisku „Rodzaje dostawy” szablonu importu, a bez dopasowania — nazwę usługi dostawy z dokumentu.
- Adres nadania — z pola „Wersja API (parametry platformy)” szablonu eksportu.
Numer zwrotu dla paczek
Dla produktów wysyłanych paczką (profil wysyłki typu PARCEL) OTTO przyjmuje wysyłkę tylko razem z numerem paczki, którą klient odeśle towar. Wpisz go w pole „Numer przesyłki zwrotnej” w karcie „Dostawa” dokumentu, pod „Więcej pól”:
numer— przewoźnik zwrotu ten sam co przy wysyłce;GLS:numer,DHL:numerlubHERMES:numer— inny przewoźnik zwrotu.
Zwroty OTTO przyjmuje tylko przez DHL, GLS i Hermes. Przy dostawie spedycyjnej pole nie jest potrzebne.
1
Numer listu przewozowego2
Numer przesyłki zwrotnej- Numer listu przewozowego — numer przesyłki wysyłkowej.
- Numer przesyłki zwrotnej — numer paczki do zwrotu; inny przewoźnik — z prefiksem, np. GLS:…
Każde zdarzenie jest wysyłane raz: po wysłaniu Elbuz zapamiętuje nowy status platformy. W dzienniku są wiersze „OTTO: zamówienie ‹numer› → SENT” i podsumowanie „OTTO: przekazano statusów zamówień: N, błędów: M”. Odmowę widać w wierszu „OTTO: zamówienie ‹numer› → SENT nie zostało przekazane — ‹powód›”.
Zwroty od klientów
Zwrot zgłoszony przez klienta i zwrot omyłkowo dostarczony do magazynu OTTO przychodzą razem z zamówieniami — jako dokument „Zwrot od klienta” na podstawie zamówienia. Każda zwrócona pozycja to osobny dokument: OTTO liczy sztuki osobno.
W dokumencie są produkt, cena i klient z zamówienia, numer przesyłki i przewoźnik zwróconej paczki. Numer dokumentu — numer zamówienia z końcówką -R…. Ponowny import aktualizuje ten sam dokument, a nie tworzy nowego.
Jak przyjąć lub odrzucić zwrot
Decyzję przekazuje się statusem dokumentu zwrotu dopasowanym w oknie „Statusy zamówienia” szablonu importu. Wysyła go eksport z zaznaczoną opcją „Zamówienia”.
| Co wpisać w „Kod (nazwa) na stronie (API)” | Co dostanie OTTO |
|---|---|
ACCEPTED | Zwrot przyjęty |
ACCEPTED:powód lub ACCEPTED:powód:stan | Przyjęty z powodem i stanem produktu według kodów OTTO |
REJECTED:powód | Zwrot odrzucony, np. REJECTED:ITEM_DAMAGED lub REJECTED:WRONG_ITEM |
Powód odmowy jest obowiązkowy. Status z samym REJECTED nie jest wysyłany: w dzienniku pojawia się „OTTO: zwrot ‹numer› nie został odrzucony — w mapowaniu statusów podaj powód, np. REJECTED:ITEM_DAMAGED”. Dla zwrotów wygodnie jest założyć osobne statusy „Zwrot przyjęty” i „Zwrot odrzucony (uszkodzony)”.
Scenariusze
Wystawić na OTTO katalog prowadzony w Elbuz
Co włączyć. Dopasuj swoje kategorie do kategorii OTTO (karta OTTO, przycisk „Pobierz słownik platformy”), wypełnij dane GPSR, a w szablonie importu — ID profilu wysyłki. Dodaj produktom atrybuty o nazwach obowiązkowych atrybutów OTTO. W szablonie eksportu — „Język opisów” niemiecki, zaznacz „Produkty” i „Publikuj nowe produkty”.
Efekt. Produkty, które mają wszystko, co potrzebne, trafią na OTTO jako karty; pozostałe — z listą braków w dzienniku. Opublikowane aktualizują potem cenę i stan przy każdym uruchomieniu.
Wysyłać zamówienia OTTO z Elbuz
Co włączyć. W szablonie importu — opcję „Zamówienia”, dopasowanie statusów do wysyłki na OTTO (SENT, CANCELLED_BY_PARTNER) i kodów przewoźników przyciskiem „Rodzaje dostawy”; harmonogram dla zamówień nie jest potrzebny — przychodzą same co 5 minut. W szablonie eksportu — adres nadania i opcję „Zamówienia”.
Efekt. Menedżer wpisuje numer przesyłki i, dla paczki, numer zwrotu, ustawia status dopasowany do SENT — najbliższy eksport przekaże wysyłkę na OTTO.
Co zrobić, gdy OTTO nie przyjmuje danych
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „OTTO: podaj Client ID i Client Secret aplikacji” | Puste klucze w szablonie | Wklej klucze aplikacji (co wziąć z OTTO Partner Connect) |
| „…marki «‹nazwa›» nie ma wśród dostępnych marek OTTO” | Producent produktu nie zgadza się z marką dostępną dla Ciebie na OTTO | Popraw nazwę producenta lub poproś o markę w panelu OTTO |
| „…nie wypełniono obowiązkowych atrybutów kategorii OTTO: …” | Produkt nie ma atrybutów o takich nazwach | Dodaj atrybuty o nazwach z listy, dokładnie jak w OTTO (nowe karty) |
| „…kategoria nie jest zmapowana na kategorię OTTO” | Kategoria produktu nie jest powiązana z OTTO | Dopasuj ją na karcie OTTO w oknie dopasowania kategorii |
| „…brak numeru przesyłki (wymagany)” | Puste „Numer listu przewozowego” | Wpisz numer przesyłki w dokumencie (wysyłka) |
| „…przewoźnika «‹nazwa›» nie ma na liście OTTO…” | Usługa dostawy dokumentu nie zgadza się z kodem przewoźnika OTTO | Dopasuj usługę dostawy do kodu OTTO przyciskiem „Rodzaje dostawy” szablonu importu |
| „…w parametrach platformy brak adresu nadania «kraj|kod|miasto»” | Puste pole adresu w szablonie eksportu | Wpisz adres, np. DE|10115|Berlin (eksport) |
| „…dla paczki (PARCEL) OTTO wymaga numeru zwrotu…” | Produkt jedzie paczką, a pole „Numer przesyłki zwrotnej” jest puste | Wypełnij „Numer przesyłki zwrotnej” w dostawie dokumentu (numer zwrotu) |
| „…OTTO nie przyjmuje przewoźnika zwrotu «‹nazwa›»…” | Zwroty OTTO przyjmuje tylko przez DHL, GLS i Hermes | Wpisz numer z prefiksem: DHL:…, GLS:… lub HERMES:… |
| „…na platformie nie ma pozycji gotowych do wysyłki” | Wszystkie pozycje są już wysłane lub anulowane | Sprawdź zamówienie w panelu OTTO |
Najczęstsze pytania
Czy można sprzedawać na cudzej karcie OTTO, jak na Amazonie?
Nie, OTTO na to nie pozwala: każdy sprzedawca opisuje produkt sam, dlatego Elbuz wysyła pełną kartę (nowe karty).
Zamówienie jest w panelu OTTO, a w Elbuz go nie ma — dlaczego?
Przez pierwsze pół godziny nowe zamówienie nie ma adresu i Elbuz je pomija. Pobierze je następny import (zamówienia).
Moje atrybuty są po polsku — czy nadadzą się dla OTTO?
Nie, nazwa atrybutu musi dokładnie odpowiadać nazwie atrybutu OTTO, zwykle niemieckiej. Dodaj atrybuty o takich nazwach (nowe karty).
Jak najpierw wszystko sprawdzić bez prawdziwych zamówień?
Wpisz 1 w pole „Piaskownica” szablonu importu — Elbuz będzie pracować ze środowiskiem testowym OTTO (pola szablonu).
Zwrot przyszedł jako kilka dokumentów — czy to błąd?
Nie, OTTO liczy każdą sztukę jako osobną pozycję, dlatego każda zwrócona pozycja to osobny dokument (zwroty).
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Import danych → nowy szablon typu „OTTO”
- Inne wejścia
- Słowniki → Operacje → Eksport danych — szablon tego samego typu; kategorie — okno dopasowania do marketplace’ów
- Uprawnienia
- okno „Import danych” w „Uprawnieniach grup”
- Przygotuj
- aplikację w OTTO Partner Connect, ID profilu wysyłki
Powiązane tematy
- Jeśli produkty nie trafiają na OTTO z powodu kategorii: dopasowanie kategorii do marketplace’ów.
- Jeśli menedżer prowadzi zamówienia w Elbuz i ważne jest, co nadpisze przebieg: import zamówień przez API.
- Jeśli sprzedajesz też na Kauflandzie lub ManoMano: integracja z Kauflandem, integracja z ManoMano.
