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
- Połączenie kluczem API — bez powiązywania aplikacji, jeden szablon na kontrakt.
- Import ofert — kod produktu, cena, stan i znacznik sprzedaży.
- Zamówienia z automatyczną akceptacją — nowe zamówienia są akceptowane na platformie podczas importu.
- Ceny i stany z powrotem na platformę — paczkami, wynik w dzienniku.
- Nowe oferty po kodzie kreskowym — na kartach, które już są na ManoMano.
- Wysyłka, odmowa, zwrot pieniędzy — statusem Twojego zamówienia.
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.
1
Klucz API2
Seller contract ID3
Język wyszukiwania kart po EAN4
Siatka dostawy nowych ofert- Klucz API — z Toolbox: Settings → API keys, pokazywany tylko raz.
- Seller contract ID — numer kontraktu: kraj i sposób dostawy.
- Język wyszukiwania kart po EAN — katalog którego kraju jest sprawdzany przed nowymi ofertami.
- Siatka dostawy nowych ofert — nazwa siatki z Toolbox i czas dostawy w dniach.
| Pole w szablonie | Co wpisać |
|---|---|
| Klucz API (Toolbox → Settings → API keys) | Klucz z Toolbox. Wymagane |
| Seller contract ID | Numer kontraktu. Wymagane |
| Język wyszukiwania kart po EAN | fr_FR, es_ES, it_IT, de_DE lub en_GB — katalog którego kraju sprawdzać przed nową ofertą. Puste — fr_FR |
| Siatka dostawy nowych ofert | Nazwa 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 ManoMano | Pole produktu w Elbuz |
|---|---|
| Twój kod oferty (SKU) | Kod (SKU); w nowej karcie — także Nazwa |
| cena z VAT | Cena |
| stan | Ilość |
| w sprzedaży lub wycofana | Status: 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 ManoMano | Jak trafia do dokumentu |
|---|---|
| cena pozycji | z VAT, jak na platformie |
| Twój rabat sprzedawcy | rozkłada się na ceny pozycji proporcjonalnie do kwoty |
| rabat ManoMano | nie jest odejmowany: płaci za niego platforma, Ty dostajesz pełną cenę |
| dostawa | koszt 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 ManoMano | Co oznacza |
|---|---|
PENDING | Czeka na akceptację sprzedawcy |
PREPARATION | Zaakceptowane, przygotowywane do wysyłki |
SHIPPED | Wysłane |
REFUSED | Odmówiłeś realizacji zamówienia |
REFUNDING | Pieniądze są zwracane klientowi |
REFUNDED | Pienią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.
1
Seller contract ID2
Klucz API- Seller contract ID — zostaw puste: zostanie wzięty z szablonu importu z tym samym kluczem.
- 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 ManoMano | Co robi Elbuz | Wiersz w dzienniku |
|---|---|---|
| karta z takim EAN | wystawia ofertę i wiąże produkt | „ManoMano: oferta «‹nazwa›» (‹kod›) opublikowana” |
| brak karty | nie 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 kreskowego | pomija 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 do | Co wysyła Elbuz |
|---|---|
SHIPPED | Wysyłkę z przewoźnikiem i numerem przesyłki |
REFUSED | Odmowę realizacji zamówienia |
REFUNDED | Zwrot 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
| Co widzisz | Dlaczego tak jest | Co 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
- Jeśli potrzebujesz ogólnej mechaniki importu — harmonogram, przerwanie, kategorie techniczne: przegląd importu danych.
- 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 Leroy Merlin, Cdiscount lub OTTO: integracja z Mirakl, integracja z Cdiscount, integracja z OTTO.
