↑↓ wybierzEnter otwórzEsc zamknij

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

    Jak podłączyć ManoMano do Elbuz: oferty, ceny i zamówienia kluczem API

    6 min czytaniaZaktualizowano

    Elbuz łączy się z Twoim sklepem na ManoMano kluczem API z Toolbox: pobiera oferty i zamówienia, a na platformę odsyła ceny, stany i wysyłki.

    Kiedy to się przyda:

    • Sprzedajesz w kilku krajach ManoMano — każdy kontrakt podłączasz osobnym szablonem.
    • Zamówienia trzeba akceptować na czas — Elbuz akceptuje nowe zamówienia przy każdym imporcie.
    • Ceny i stany liczysz w Elbuz — eksport je aktualizuje i wystawia oferty na istniejących kartach po kodzie kreskowym.
    • Wysyłasz z własnego magazynu — status Twojego zamówienia przekazuje na platformę numer przesyłki, odmowę lub zwrot pieniędzy.

    Od czego zacząć: utwórz klucz API w Toolbox i wklej go razem z Seller contract ID do szablonu importu typu „ManoMano”.

    Co potrafi integracja z ManoMano

    Co wziąć z Toolbox

    Klucz API tworzy użytkownik Toolbox z rolą Admin: Settings → API keys → Create API key. Toolbox pokazuje klucz tylko raz — od razu skopiuj go do szablonu. Numer kontraktu (Seller contract ID) też znajdziesz w Toolbox: jeden kontrakt oznacza jeden kraj i jeden sposób dostawy.

    Karta „Połączenie” w szablonie importu ManoMano
    1Klucz API
    2Seller contract ID
    3Język wyszukiwania kart po EAN
    4Siatka dostawy nowych ofert
    1. Klucz API — z Toolbox: Settings → API keys, pokazywany tylko raz.
    2. Seller contract ID — numer kontraktu: kraj i sposób dostawy.
    3. Język wyszukiwania kart po EAN — katalog którego kraju jest sprawdzany przed nowymi ofertami.
    4. Siatka dostawy nowych ofert — nazwa siatki z Toolbox i czas dostawy w dniach.
    Pole w szablonieCo wpisać
    Klucz API (Toolbox → Settings → API keys)Klucz z Toolbox. Wymagane
    Seller contract IDNumer kontraktu. Wymagane
    Język wyszukiwania kart po EANfr_FR, es_ES, it_IT, de_DE lub en_GB — katalog którego kraju sprawdzać przed nową ofertą. Puste — fr_FR
    Siatka dostawy nowych ofertNazwa siatki dostawy z Toolbox i czas w dniach: nazwa|min.|maks.. Puste — CARRIER_GRID_1|2|5

    Język wyszukiwania i siatkę dostawy wykorzystuje tylko eksport nowych ofert. Do katalogu i zamówień wystarczą klucz i numer kontraktu.

    Po wklejeniu klucza i numeru poczekaj na napis „Wszystkie zmiany zapisane” i kliknij „Sprawdź połączenie”. Elbuz pobierze z platformy jedno zamówienie kontraktu i odpowie „Połączenie działa. ManoMano — seller contract #‹numer›”. Błędny klucz daje „Połączenie nie powiodło się: HTTP 401: …”.

    „Aktywny” i „Zamówienia” są w nowym szablonie już włączone: 5 minut po zapisaniu klucza Elbuz zacznie pobierać zamówienia z ostatnich 30 dni i akceptować je na platformie. Statusy platformy Elbuz sam dopasowuje do Twoich po nazwie; co przyszło i jak zostało dopasowane, widać w oknie „Statusy zamówienia” szablonu. Chcesz najpierw sprawdzić — odznacz „Zamówienia”.

    Opis metod, z których korzysta Elbuz: ManoMano Partners API.

    Co trafia do karty

    Elbuz pobiera Twoje oferty z kontraktu — zarówno te w sprzedaży, jak i wycofane. API ManoMano zwraca dla oferty tylko kod, cenę i stan, więc do karty trafia niewiele:

    Dane oferty ManoManoPole produktu w Elbuz
    Twój kod oferty (SKU)Kod (SKU); w nowej karcie — także Nazwa
    cena z VATCena
    stanIlość
    w sprzedaży lub wycofanaStatus: oferta w sprzedaży — produkt włączony

    Oferta nie zawiera nazwy, kodu kreskowego, opisu ani zdjęć. Dlatego ManoMano wygodnie jest podłączać do katalogu, który już prowadzisz w Elbuz: kartę powiązaną wcześniej przez szablon przebieg znajduje po kodzie oferty i aktualizuje jej cenę, stan i status.

    Oferta bez powiązania staje się nową kartą z nazwą równą kodowi, w kategorii technicznej (kategorie techniczne). Istniejące karty łatwiej powiązać z ofertami eksportem po kodzie kreskowym — scenariusz.

    Aby przebieg w ogóle nie zmieniał karty, włącz w niej przełącznik „Nie aktualizuj” (sekcja „Ochrona podczas importu”); aby nie zmieniał tylko cen — „Stała cena”.

    Jak przychodzą i są akceptowane zamówienia

    Zamówienie zapisuje się jako niezatwierdzony dokument „Zamówienie klienta”. Pierwszy import pobiera zamówienia z ostatnich 30 dni. Kolejne — zmienione od daty ostatniego importu, z 12-godzinnym zapasem. Istniejące zamówienie jest rozpoznawane po numerze i aktualizowane, a nie dublowane.

    Do dokumentu trafiają: numer, daty utworzenia i zmiany statusu, imię i nazwisko, telefon i e-mail klienta, adresy dostawy i płatnika, przewoźnik, waluta, koszt dostawy i pozycje.

    Kwota w zamówieniu ManoManoJak trafia do dokumentu
    cena pozycjiz VAT, jak na platformie
    Twój rabat sprzedawcyrozkłada się na ceny pozycji proporcjonalnie do kwoty
    rabat ManoManonie jest odejmowany: płaci za niego platforma, Ty dostajesz pełną cenę
    dostawakoszt dostawy minus rabat na dostawę

    Kwota dokumentu to pozycje razem z dostawą.

    Automatyczna akceptacja

    Zamówienie w statusie PENDING (czeka na Twoje potwierdzenie) Elbuz sam akceptuje na platformie podczas tego samego importu. Dostępność produktu w magazynie nie jest przy tym sprawdzana. Zaakceptowane zamówienie trafia do dokumentu ze statusem PREPARATION.

    Jeśli akceptacja się nie uda, w dzienniku pojawi się czerwony wiersz „ManoMano: zamówienie ‹numer› nie zostało zaakceptowane automatycznie — ‹przyczyna›”, a zamówienie zaimportuje się ze statusem PENDING. Następny import spróbuje ponownie: zamówienia czekające na akceptację Elbuz pobiera za każdym razem, niezależnie od daty ostatniego importu.

    Zaakceptowane zamówienie platforma uznaje za potwierdzone przez Ciebie. Jeśli produktu nie ma, odmów realizacji statusem dopasowanym do REFUSED (odmowa) albo w Toolbox.

    Statusy zamówienia

    Status platformy Elbuz sam dopasowuje do Twojego — po kodzie lub nazwie, a nierozpoznany zapisuje jako „Nowy”. Możesz to doprecyzować przyciskiem „Statusy zamówienia” w karcie „Powiązane ustawienia” szablonu importu: w kolumnie „Kod (nazwa) na stronie (API)” obok swojego statusu wpisz kod ManoMano.

    Kod ManoManoCo oznacza
    PENDINGCzeka na akceptację sprzedawcy
    PREPARATIONZaakceptowane, przygotowywane do wysyłki
    SHIPPEDWysłane
    REFUSEDOdmówiłeś realizacji zamówienia
    REFUNDINGPieniądze są zwracane klientowi
    REFUNDEDPieniądze zwrócono

    To samo dopasowanie działa w drugą stronę: status, obok którego stoi SHIPPED, REFUSED lub REFUNDED, eksport wysyła na platformę. Jeśli w komórce jest kilka kodów po przecinku, na platformę trafia pierwszy. Co dzieje się z zatwierdzonym zamówieniem i rezerwacją, opisano w artykule import zamówień przez API.

    Jak ceny i stany wracają na platformę

    Kierunek odwrotny to osobny szablon eksportu typu „ManoMano”. Ma dwa pola:

    • Seller contract ID — numer kontraktu. Puste pole — kontrakt jest brany z szablonu importu z tym samym kluczem.
    • Klucz API — ten sam klucz z Toolbox.

    Język wyszukiwania po EAN i siatkę dostawy eksport bierze z szablonu importu tego kontraktu.

    Karta „Połączenie” w szablonie eksportu ManoMano
    1Seller contract ID
    2Klucz API
    1. Seller contract ID — zostaw puste: zostanie wzięty z szablonu importu z tym samym kluczem.
    2. Klucz API — ten sam klucz z Toolbox.

    Aktualizowane są produkty powiązane z ofertami kontraktu. Bez zaznaczonego pola „Publikuj nowe produkty” produkt bez powiązania jest pomijany. Co trafia na platformę:

    • Cena — z VAT, liczbą z szablonu eksportu, z dwoma miejscami po przecinku. Elbuz nie przelicza waluty: ceny w wyniku filtrowania muszą być w walucie kontraktu.
    • Stan — ilość produktu, nie mniej niż zero.
    • Które produkty — określa filtr szablonu eksportu, tak jak w innych kanałach.

    Ceny i stany wysyłane są paczkami do tysiąca ofert. Oferta, w której nie zmieniła się ani cena, ani stan, nie jest liczona jako błąd. Odrzucenie oferty platforma uzasadnia, a w dzienniku pojawia się wiersz „ManoMano: «‹kod›» odrzucono: ‹przyczyna›”. Podsumowanie uruchomienia — „ManoMano: ceny i stany — pomyślnie: N, błędów: M”.

    Limit zapytań

    ManoMano przepuszcza około 200 zapytań na godzinę dla ofert i 250 — dla zamówień. Po odmowie z powodu limitu Elbuz czeka i ponawia zapytanie. Jeśli to nie pomoże, w dzienniku pojawi się „ManoMano: przekroczono limit zapytań platformy, reszta — przy następnym uruchomieniu”, a pozostałe produkty wyśle następne uruchomienie. Dlatego eksport raz na godzinę lub rzadziej jest pewniejszy niż co kilka minut.

    Automatyczne pobieranie zamówień zużywa co najmniej 2 zapytania, czyli około 24 z 250 na godzinę.

    Nowe oferty i nowe karty

    Przy zaznaczonym polu „Publikuj nowe produkty” Elbuz wystawia ofertę dla produktu, który nie ma jeszcze Twojej oferty na ManoMano. Oferta podpina się do istniejącej karty ManoMano po EAN, więc produkt musi mieć kod kreskowy z co najmniej 8 cyfr. Najpierw Elbuz szuka kodu kreskowego w katalogu kraju z pola „Język wyszukiwania kart po EAN”.

    Co znalazło się na ManoManoCo robi ElbuzWiersz w dzienniku
    karta z takim EANwystawia ofertę i wiąże produkt„ManoMano: oferta «‹nazwa›» (‹kod›) opublikowana”
    brak kartynie tworzy oferty„ManoMano: na platformie nie ma karty «‹nazwa›» (EAN ‹numer›) — utwórz ją feedem w Toolbox”
    karta jest, ale nie można na niej sprzedawaćnie tworzy oferty„ManoMano: «‹nazwa›» odrzucono: ‹przyczyna platformy›”
    produkt nie ma kodu kreskowegopomija produkt„ManoMano: produkt «‹nazwa›» nie ma kodu kreskowego (EAN) — oferta nie została utworzona”

    Nowa oferta dostaje cenę, stan, wagę produktu do obliczenia dostawy i siatkę dostawy z szablonu importu. Kod oferty to kod produktu (SKU); bez niego — ID produktu w Elbuz.

    Jeśli dla ofert trwa akurat import feedu w Toolbox, platforma nie przyjmuje zmian: w dzienniku „ManoMano: trwa import feedu dla tych ofert, nie zmieniono: N — ponowienie przy następnym uruchomieniu”. Powiązania nie powstają, a następne uruchomienie wyśle te produkty ponownie.

    Jak utworzyć nową kartę

    Nowych kart ManoMano nie tworzy przez API: powstają one tylko z feedu, który podłączasz w Toolbox. Przygotuj w Elbuz eksport feedu z potrzebnymi produktami i podaj jego link w Toolbox. Gdy platforma utworzy karty z feedu, eksport typu „ManoMano” powiąże z nimi Twoje produkty po kodzie kreskowym i będzie dalej aktualizować ceny i stany.

    Wysyłka, odmowa i zwrot pieniędzy

    Pole „Zamówienia” w szablonie eksportu przekazuje na platformę trzy zdarzenia z Twoich zamówień ManoMano:

    Twój status dopasowany doCo wysyła Elbuz
    SHIPPEDWysyłkę z przewoźnikiem i numerem przesyłki
    REFUSEDOdmowę realizacji zamówienia
    REFUNDEDZwrot pieniędzy za wszystkie pozycje razem z dostawą, przyczyna — brak produktu

    Dopasowanie pochodzi z okna „Statusy zamówienia” szablonu importu. Eksport obsługuje zamówienia z szablonów importu tego samego kontraktu.

    Numer przesyłki to pole „Numer listu przewozowego” w karcie „Dostawa” dokumentu (rozwiń „Więcej pól”). Przewoźnik jest brany z przycisku „Rodzaje dostawy” szablonu importu, jeśli dopasowano tam kod przewoźnika ManoMano; w przeciwnym razie Elbuz przekazuje nazwę firmy kurierskiej z dokumentu, a bez niej — „Other”.

    Każde zdarzenie wysyłane jest jeden raz: po wysłaniu Elbuz zapamiętuje nowy status platformy. Zamówienia, które na platformie są już wysłane, odrzucone lub w trakcie zwrotu, nie są wysyłane. W dzienniku — wiersze „ManoMano: zamówienie ‹numer› → SHIPPED” i podsumowanie „ManoMano: przekazano statusów zamówień: N, błędów: M”. Odmowę platformy widać w wierszu „ManoMano: zamówienie ‹numer› → SHIPPED nie zostało przekazane — ‹przyczyna›”.

    Aktualizacja według harmonogramu

    ManoMano nie wysyła natychmiastowych powiadomień, więc zamówienia Elbuz sam pobiera i akceptuje co 5 minut, jeśli w szablonie zaznaczono „Zamówienia” i wpisano klucz. Robi to wspólne zadanie „Zamówienia z marketplace’ów” w oknie „Harmonogram zadań”, tam też zmienisz interwał. Katalog nie jest w tym przebiegu importowany, a zamówienia pobrane dodatkowo przez harmonogram szablonu się nie dublują.

    Katalog aktualizuje harmonogram samego szablonu — przycisk „Ustawienia harmonogramu” w karcie „Powiązane ustawienia”. Ustaw go rzadko, na przykład w nocy: dopóki importuje się katalog, pobieranie zamówień czeka na następną kolejkę. Ceny i stany eksportuj raz na godzinę lub rzadziej ze względu na limit zapytań.

    Plakietka „Aktywny” / „Wyłączony” zdejmuje szablon z harmonogramu i z automatycznego pobierania zamówień (wyłączenie szablonu).

    Przerwany przebieg można bezpiecznie powtórzyć: katalog zapisuje się paczkami po 500 ofert, a data dla następnej porcji zamówień przesuwa się dopiero po ich zapisaniu. Ogólne zasady: jeśli przebieg został przerwany.

    Scenariusze

    Akceptuj zamówienia i wysyłaj z Elbuz

    Co włączyć. W szablonie importu — klucz, Seller contract ID, pole „Zamówienia”, dopasowanie przyciskiem „Statusy zamówienia” (co najmniej PREPARATION, SHIPPED, REFUSED); harmonogram dla zamówień nie jest potrzebny — przychodzą same co 5 minut. W szablonie eksportu tego samego kontraktu — pole „Zamówienia”.

    Efekt. Nowe zamówienia akceptują się na platformie same. Menedżer wpisuje numer przesyłki w „Numer listu przewozowego” i ustawia status dopasowany do SHIPPED — najbliższy eksport przekaże wysyłkę.

    ManoMano jako kanał dla katalogu prowadzonego w Elbuz

    Co włączyć. Szablon eksportu z filtrem potrzebnych produktów, pola „Produkty” i „Publikuj nowe produkty”. Produkty muszą mieć kody kreskowe. Dla produktów, których jeszcze nie ma na ManoMano, — eksport feedu podłączony w Toolbox.

    Efekt. Produkty, których karty są już na ManoMano, dostaną Twoje oferty i powiązanie; potem każde uruchomienie aktualizuje im cenę i stan. Dla pozostałych dziennik podpowie, że kartę trzeba utworzyć feedem. W szablonie importu zostaw tylko „Zamówienia”, aby przebieg katalogu nie nadpisywał cen i stanów liczbami z platformy.

    Co zrobić, gdy platforma nie oddaje lub nie przyjmuje danych

    Najczęstsze problemy
    Co widziszDlaczego tak jestCo zrobić
    „Połączenie nie powiodło się: HTTP 401: …” Klucz skopiowano niecały lub usunięto go w Toolbox Utwórz nowy klucz w Toolbox i wklej go do szablonów importu i eksportu (co wziąć z Toolbox)
    „ManoMano: podaj klucz API i Seller contract ID” Pusty klucz lub numer kontraktu Wypełnij oba pola szablonu
    „ManoMano: przekroczono limit zapytań platformy…” Wyczerpano godzinny limit zapytań Resztę wyśle następne uruchomienie; uruchamiaj eksport rzadziej (limit zapytań)
    „ManoMano: zamówienie ‹numer› nie zostało zaakceptowane automatycznie — …” Platforma odmówiła akceptacji Następny import spróbuje ponownie. Jeśli wiersz się powtarza, zaakceptuj zamówienie w Toolbox (akceptacja)
    „ManoMano: na platformie nie ma karty «…» (EAN …) — utwórz ją feedem w Toolbox” API ManoMano nie tworzy nowych kart Podłącz eksport feedu w Toolbox (nowa karta)
    „ManoMano: trwa import feedu dla tych ofert, nie zmieniono: N…” Toolbox właśnie przetwarza Twój feed Nic: następne uruchomienie wyśle te produkty ponownie
    Status zmieniono, a na platformę nic nie poszło Status nie jest dopasowany do SHIPPED, REFUSED ani REFUNDED, w eksporcie nie zaznaczono „Zamówienia” albo eksport ma inny kontrakt Sprawdź dopasowanie w szablonie importu i pole w szablonie eksportu (wysyłka)

    Najczęstsze pytania

    Dlaczego produkty zaimportowane z ManoMano mają nazwy w postaci kodów?

    API platformy nie zwraca nazwy oferty, tylko kod, cenę i stan. Powiąż swoje karty z ofertami eksportem po kodzie kreskowym (co trafia do karty).

    Sprzedaję we Francji i Hiszpanii — ile szablonów potrzebuję?

    Parę szablonów na każdy kontrakt: import i eksport. Klucz API może być jeden (gdzie to jest).

    Czy można wyłączyć automatyczną akceptację zamówień?

    Nie, import zamówień ManoMano zawsze akceptuje te, które czekają na akceptację. Jeśli tego nie chcesz, odznacz „Zamówienia” i akceptuj w Toolbox (akceptacja).

    Czy Elbuz tworzy nowe karty na ManoMano?

    Nie, tylko oferty na istniejących kartach po kodzie kreskowym. Nowe karty platforma tworzy z feedu w Toolbox (nowa karta).

    Zgubiłem klucz API — gdzie go zobaczyć?

    Nigdzie: Toolbox pokazuje klucz tylko raz. Utwórz nowy i podmień go w szablonach (co wziąć z Toolbox).

    Gdzie to jest i kto ma dostęp

    Menu
    Słowniki → Operacje → Import danych → nowy szablon typu „ManoMano”
    Inne wejścia
    Słowniki → Operacje → Eksport danych — szablon tego samego typu
    Uprawnienia
    okno „Import danych” w „Uprawnieniach grup”
    Przygotuj
    klucz API z Toolbox i numer kontraktu (Seller contract ID)

    Jeden szablon to jeden kontrakt ManoMano. Sprzedajesz we Francji i Hiszpanii albo masz dwa sposoby dostawy — utwórz tyle szablonów, ile masz kontraktów. Powiązania produktów w kontraktach są osobne i się nie mieszają.

    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