↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Marketplace’y w Europie: co się importuje i jak je podłączyć

    Jak podłączyć OTTO Market do Elbuz: karty, zamówienia i zwroty

    6 min czytaniaZaktualizowano

    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

    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:

    ZakresDo czego Elbuz go używa
    productsprodukty, ceny, nowe karty, kategorie i marki
    orderszamówienia i anulowania
    shipmentswysyłki z numerem przesyłki
    availabilitystany, profil wysyłki i czas realizacji nowych kart
    returnszwroty od klientów
    shipping-profilesrodzaj 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.

    Karta „Połączenie” szablonu importu OTTO
    1Client ID aplikacji
    2Client Secret aplikacji
    3Piaskownica
    4ID profilu wysyłki
    5Czas realizacji zamówienia
    1. Client ID aplikacji — z OTTO Partner Connect, sekcja API-Zugriff.
    2. Client Secret aplikacji — sekret tej samej aplikacji.
    3. Piaskownica — 1 dla środowiska testowego OTTO, puste dla konta produkcyjnego.
    4. ID profilu wysyłki — bez niego nowych kart nie da się zamówić.
    5. Czas realizacji zamówienia — od 1 do 99 dni; puste — jak w profilu.
    Pole w szablonieCo wpisać
    Client ID aplikacji, Client Secret aplikacjiKlucze aplikacji z API-Zugriff. Obowiązkowe
    Piaskownica1 — 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, dniOd 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 OTTOPole produktu w Elbuz
    nazwa (productLine), bez niej — SKUNazwa
    opisOpis
    markaProducent
    SKU wariantuKod (SKU)
    EANKod kreskowy
    cenaCena
    stanIlość
    kategoria OTTOKategoria — znaleziona po nazwie lub utworzona
    zdjęciaZdję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 OTTOCo oznacza
    PROCESSABLEGotowe do realizacji — trzeba je wysłać
    SENTWysłane
    RETURNEDZwrócone
    CANCELLED_BY_PARTNERAnulowane przez Ciebie
    CANCELLED_BY_MARKETPLACEAnulowane 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.
    Karta „Połączenie” szablonu eksportu OTTO z adresem nadania
    1Client ID aplikacji
    2Client Secret aplikacji
    3Adres nadania
    1. Client ID aplikacji — ten sam co w szablonie importu.
    2. Client Secret aplikacji — ten sam sekret.
    3. 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 dziennikuCo 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 potrzebneSkąd Elbuz to bierze
    Kod kreskowy od 8 cyfrpole „Kod kreskowy” produktu
    Kategoria OTTOkategoria produktu dopasowana do kategorii OTTO (karta OTTO w oknie dopasowania)
    Marka z listy OTTOproducent produktu; nazwa musi się zgadzać z marką dostępną dla Ciebie na OTTO
    Co najmniej jedno zdjęciezdjęcia produktu, do 20 sztuk
    Obowiązkowe atrybuty kategoriiatrybuty 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

    1. 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”.
    2. 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.
    3. 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 doCo wysyła Elbuz
    SENTWysyłkę wszystkich pozycji gotowych do wysłania, z przewoźnikiem i numerem przesyłki
    CANCELLED_BY_PARTNERAnulowanie 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:numer lub HERMES:numer — inny przewoźnik zwrotu.

    Zwroty OTTO przyjmuje tylko przez DHL, GLS i Hermes. Przy dostawie spedycyjnej pole nie jest potrzebne.

    Pole „Numer przesyłki zwrotnej” w sekcji „Dostawa” dokumentu
    1Numer listu przewozowego
    2Numer przesyłki zwrotnej
    1. Numer listu przewozowego — numer przesyłki wysyłkowej.
    2. 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
    ACCEPTEDZwrot przyjęty
    ACCEPTED:powód lub ACCEPTED:powód:stanPrzyjęty z powodem i stanem produktu według kodów OTTO
    REJECTED:powódZwrot 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

    Najczęstsze problemy
    Co widziszDlaczego tak jestCo 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

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo