↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Jak przenieść katalog ze strony do Elbuz: Elbuz Tunnel dla CMS

    Jak przekazywać zamówienia z OpenCart 3 do Elbuz gotowym modułem

    12 min czytaniaZaktualizowano

    Moduł Elbuz API Sync na stronie OpenCart 3 sam przekazuje zamówienia do Elbuz: nowe — zaraz po złożeniu, istniejące — po każdej zmianie statusu. Stają się dokumentami „Zamówienie klienta” bez ręcznego przenoszenia.

    Kiedy to się przyda:

    • Menedżer ma widzieć zamówienie w Elbuz od razu — przychodzi w kilka sekund, bez harmonogramu.
    • Klient zapłacił na stronie — moduł płatności zmienia status, a zamówienie w Elbuz przechodzi na „Opłacono”.
    • Elbuz jest chwilowo niedostępny — składanie zamówień na stronie działa dalej, zamówienie czeka w kolejce modułu i dociera później.
    • Zamówienia wciąż pobiera Elbuz Tunnel — moduł kontynuuje te same dokumenty, duplikatów nie będzie.

    Od czego zacząć: pobierz i zainstaluj moduł, a potem wydaj mu klucz w Elbuz.

    Co potrafi moduł

    Jak zainstalować moduł na stronie

    1. Pobierz archiwum elbuz_api_sync.ocmod.zip.
    2. W panelu OpenCart otwórz „Extensions → Installer” i prześlij archiwum przyciskiem „Upload”. Bez dostępu do instalatora skopiuj zawartość folderu upload z archiwum do katalogu głównego strony.
    3. Otwórz „Extensions → Extensions” i na liście typów wybierz „Modules”.
    4. W wierszu „Elbuz: order sync” kliknij „Install” (zielony plus), a potem „Edit” (ołówek).

    Po instalacji moduł jest wyłączony i nic nie wysyła, dopóki nie wypełnisz połączenia i nie zapiszesz go ze „Status” ustawionym na „Enabled”. Usunięcie modułu przyciskiem „Uninstall” usuwa jego kolejkę i dziennik.

    Jak wydać modułowi klucz w Elbuz

    Moduł potrzebuje osobnego klucza API v2. Jego nazwa stanie się źródłem zamówień na liście, a po kluczu Elbuz rozpoznaje już zaimportowane zamówienia.

    1. W Elbuz otwórz „API i tokeny dostępu” i kliknij „+”.
    2. W polu „Użytkownik” wpisz nazwę sklepu, na przykład site_opencart.
    3. W „W imieniu pracownika” wybierz pracownika, który ma dostęp do okna zamówień i uprawnienie do przycisku „Dodaj”.
    4. Odznacz „Tylko do odczytu”.
    5. Przełącz „Zmiany danych” na „Wykonuj samodzielnie”. Może to zrobić tylko grupa „Zarząd”.
    6. W „Bezpiecznik: zmian na godzinę” ustaw liczbę z zapasem: każda wysyłka modułu to jedna zmiana, nawet gdy zawiera 100 zamówień.
    7. Zapisz i skopiuj klucz — zaczyna się od elbz_.
    Karta klucza API: nazwa użytkownika, tryb zmian danych, godzinowy bezpiecznik i przełącznik „Tylko do odczytu”
    1Użytkownik = nazwa klucza
    2Zmiany danych: Wykonuj samodzielnie
    3Bezpiecznik: zmian na godzinę
    4Tylko do odczytu (wyłączone)
    1. Użytkownik — nazwa klucza, która staje się też źródłem przywożonych przez niego zamówień.
    2. Zmiany danych — ustawione na „Wykonuj samodzielnie”, więc klucz sam zapisuje zmiany.
    3. Bezpiecznik — ten klucz może wykonać najwyżej 1000 zmian na godzinę.
    4. Tylko do odczytu — wyłączone, więc klucz może tworzyć i aktualizować zamówienia.

    Jeśli zostawisz „Zmiany danych” w trybie „Pytaj” albo klucz przekroczy bezpiecznik, każda wysyłka będzie czekać, aż ktoś ją zatwierdzi w „Pulsie”. W dzienniku modułu takie zamówienia mają wynik „waiting for confirmation in Elbuz”, a na liście zamówień Elbuz ich nie ma.

    Jeden klucz — jedna strona. Takie same numery zamówień z dwóch stron pod jednym kluczem połączą się w jeden dokument. Ogólne zasady kluczy — w artykule API v2.

    Jak połączyć moduł z Elbuz

    Gdzie: moduł „Elbuz: order sync” → zakładka „Connection”.

    1. „Status” — „Enabled”.
    2. „Elbuz API address” — adres Twojego konta z /api/v2 na końcu: https://twoja-domena.elbuz.com/api/v2; konto na app.elbuz.com — https://app.elbuz.com/api/v2?user_domain=<numer konta> (numer jest w wierszu „Opis metod (OpenAPI)” karty klucza). Adres bez https:// lub http:// się nie zapisze: „The API address must start with https:// or http://”.
    3. „API key” — klucz skopiowany w Elbuz.
    4. „Elbuz template ID” zostaw puste. Jest potrzebne tylko przy przejściu z Elbuz Tunnel.
    5. Kliknij „Check connection”. Odpowiedź „Connected. Document statuses received: N, payment statuses: M.” oznacza, że adres i klucz są poprawne, a statusy Elbuz pojawiły się na zakładce „Statuses”.
    6. Zapisz moduł niebieskim przyciskiem z dyskietką w prawym górnym rogu.
    Zakładka „Connection” modułu „Elbuz: order sync” w panelu OpenCart 3 po sprawdzeniu połączenia
    1Status
    2Elbuz API address — adres API
    3API key — klucz API
    4Elbuz template ID — ID szablonu
    5Check connection — sprawdzenie połączenia
    6Zapisz
    1. Status — „Enabled”: bez tego moduł nic nie wysyła.
    2. Elbuz API address — adres Twojego konta zakończony na /api/v2.
    3. API key — klucz z okna „API i tokeny dostępu”, wyświetlany jako kropki.
    4. Elbuz template ID — puste; wypełnia się je tylko przy przejściu z Elbuz Tunnel.
    5. Check connection — zielony komunikat u góry pokazuje, ile statusów Elbuz pobrano.
    6. Zapisz — bez zapisania moduł nie zacznie wysyłać zamówień.

    „Check connection” bierze adres i klucz prosto z formularza, bez zapisywania. Wysyłać zamówienia moduł zacznie dopiero po zapisaniu. Błąd sprawdzenia wygląda jak „No connection to Elbuz: …” z przyczyną — wyjaśnienie w tabeli poniżej.

    Jak dopasować statusy strony do statusów Elbuz

    Gdzie: zakładka „Statuses”. Dla każdego statusu OpenCart wybierz „Elbuz document status” (status dokumentu) i „Elbuz payment status” (status płatności). Lista statusów Elbuz pojawia się po „Check connection”.

    Status na stronieStatus dokumentu w ElbuzStatus płatności w Elbuz
    Pending (oczekujące)NowyOczekiwanie
    Processing (w realizacji), opłaconeOpłaconoOpłacono
    Canceled (anulowane)Anulowano— do not change —

    OpenCart nie ma osobnego statusu płatności: płatność pokazuje ten sam status zamówienia. Dlatego dla statusów, na które strona przełącza opłacone zamówienia, wybierz „Opłacono” w kolumnie płatności.

    „— do not change —” oznacza, że ten status strony nie zmienia odpowiedniego statusu w Elbuz. Nowe zamówienie bez dopasowania dostanie status domyślny, „Nowy”. Jeśli wypełniono „Elbuz template ID”, dla pustych wierszy działa dopasowanie statusów szablonu.

    Zakładka „Statuses” modułu: statusy OpenCart dopasowane do statusów dokumentu i płatności w Elbuz
    1Processing → Opłacono
    2Pending → Nowy
    3Canceled: płatność bez zmian
    1. Processing — tu strona przełącza opłacone zamówienie, więc w obu kolumnach jest „Opłacono”.
    2. Pending — nowe zamówienie: status „Nowy”, płatność „Oczekiwanie”.
    3. Canceled — status dokumentu „Anulowano”, status płatności zostaje bez zmian („— do not change —”).

    Moduł wysyła zamówienie za każdym razem, gdy zmienia się jego status. Czy nowy status strony nadpisze ten, który ustawił menedżer w Elbuz, decydują ogólne zasady: kto kogo nadpisuje. Pozycje zapisują się tylko przy tworzeniu dokumentu.

    Jak wysłać zamówienia, które już są na stronie

    Nowe zamówienia moduł wysyła sam. Te, które były na stronie przed instalacją, wyślij ręcznie.

    Gdzie: zakładka „Send”.

    1. W „Orders changed since” wybierz datę. Domyślnie — 30 dni temu.
    2. Kliknij „Send”. Moduł bierze wszystkie zamówienia zmienione od tej daty, z wyjątkiem niedokończonych koszyków bez statusu, i wysyła je paczkami po 100.
    3. Nie zamykaj strony, dopóki obok przycisku nie pojawi się „left in queue: 0”. Wiersz pokazuje „Sent: N, errors: M, left in queue: K”.

    Ponowna wysyłka tych samych zamówień nie tworzy duplikatów: aktualizują się one w już utworzonych dokumentach. Tym samym przyciskiem nadrabia się zamówienia po awarii — wybierz datę, od której nie dotarły.

    Link dla cron

    Pod przyciskiem jest „Cron URL”. Dodaj go do harmonogramu na hostingu z uruchamianiem co 5–15 minut, na przykład:

    */10 * * * * curl -s "https://twoja-strona/index.php?route=extension/module/elbuz_api_sync/cron&key=…" >/dev/null

    Cron wysyła to, co nie przeszło od razu — do 1000 zamówień na uruchomienie. Bez niego kolejka idzie razem z kolejnym zamówieniem ze strony: jeśli w nocy nie ma zamówień, zamówienie zatrzymane wczoraj dotrze dopiero rano. Link bez poprawnego key odpowiada 403 i niczego nie wysyła.

    Zakładka „Send” modułu: data, przycisk „Send” i link dla cron
    1Orders changed since — data
    2Send — wysyłka
    3Cron URL — link dla cron
    1. Orders changed since — domyślnie 30 dni temu.
    2. Send — wysyła wszystkie zamówienia zmienione od tej daty, paczkami po 100.
    3. Cron URL — dla harmonogramu na hostingu, co 5–15 minut; każdy sklep ma w linku własny klucz.

    Jak sprawdzić, czy zamówienia docierają

    1. Złóż na stronie testowe zamówienie.
    2. W module otwórz zakładkę „Journal”. Zamówienie powinno mieć stan „sent” z wynikiem „created”. W kolumnie „Elbuz document” — ID dokumentu w Elbuz, a nie jego numer na liście zamówień.
    3. W Elbuz otwórz okno „Zamówienia”. Zamówienie jest na górze ze źródłem „API: nazwa klucza”; jego numer ze strony jest zapisany w dokumencie w osobnym polu.
    4. Zmień status zamówienia w panelu OpenCart. W dzienniku pojawi się „updated”, a w Elbuz — status według Twojej tabeli dopasowania.
    Zakładka „Journal” modułu: zamówienia ze strony wysłane do Elbuz, utworzone i zaktualizowane dokumenty
    1Numer zamówienia na stronie
    2Result — wynik
    3Elbuz document — dokument
    1. Order — numer na stronie; link otwiera zamówienie w OpenCart.
    2. Result — „created” dla nowego dokumentu, „updated”, gdy zamówienie było już w Elbuz.
    3. Elbuz document — wewnętrzny ID dokumentu w Elbuz, a nie numer zamówienia na liście.

    Dziennik pokazuje 30 ostatnich zamówień. Żółte wiersze są jeszcze w kolejce, czerwone — niewysłane; przyczyna jest w kolumnie „Message”. Numer w kolumnie „Order” otwiera zamówienie w OpenCart.

    Okno „Zamówienia” odfiltrowane do trzech zamówień, które przyszły przez klucz API: statusy płatności, dostawy i zamówienia
    1Zamówienie opłacone na stronie
    2Status dostawy „W drodze”
    3Nowe zamówienie, jeszcze nieopłacone
    1. Zamówienie opłacone na stronie przychodzi do Elbuz ze statusem płatności „Opłacono” i statusem zamówienia „Opłacono”.
    2. Status dostawy ze strony, „W drodze”, przenosi się do zamówienia.
    3. Nowe, jeszcze nieopłacone zamówienie zostaje „Nowe” ze statusem płatności „Oczekiwanie”.

    Co się stanie, jeśli Elbuz nie odpowie

    Moduł nie spowalnia ani nie psuje składania zamówienia na stronie. Na odpowiedź Elbuz czeka do 5 sekund, a błąd zapisuje w dzienniku i zostawia zamówienie w kolejce.

    Droga zamówienia ze strony do Elbuz: każda wysyłka bierze bieżące dane zamówienia, więc powtórka nie wysyła nieaktualnego statusu
    przyjąłklucz w trybie „Pytaj”422 w danych zamówieniabrak połączenia, klucz,uprawnienia, limitnietakZamówienie złożone albo zmienił sięjego statusModuł stawia zamówienie w kolejcei od razu je wysyła, czeka do 5sekundCo odpowiedział Elbuz?„sent”: „created” albo „updated”„sent”: „waiting for confirmation inElbuz”propozycja w „Pulsie”„not sent”: czeka na zmianę statusualbo przycisk „Send”„queued”: powtórka po 1, 4, 9 …minutachz kolejnym zamówieniem, przezcron albo przyciskiem30 prób bez powodzenia?
    • Початок або кінець
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді
    Co się stałoCo robi modułStan w dzienniku
    Elbuz przyjął zamówienieZapisuje numer dokumentu„sent”, „created” albo „updated”
    Klucz w trybie „Pytaj”Nie ponawia już: propozycja jest w „Pulsie”„sent”, „waiting for confirmation in Elbuz”
    Elbuz odrzucił dane konkretnego zamówienia (422 z polem orders[…])Zatrzymuje tylko to zamówienie, reszta paczki idzie dalej„not sent”, „error”
    Brak połączenia, błąd klucza lub uprawnień, limit zapytań, inna odpowiedź 422 (na przykład nie znaleziono szablonu)Ponawia po 1, 4, 9 … minutach, najdłuższa przerwa — 12 godzin„queued”, „error”
    30 nieudanych prób z rzęduPrzestaje ponawiać„not sent”, „error”

    Zamówienie ze stanem „not sent” pójdzie ponownie, gdy zmieni się jego status na stronie albo gdy klikniesz „Send” z datą, która je obejmuje. Wszystkie powtórki biorą bieżące dane zamówienia.

    Jak przejść z Elbuz Tunnel bez duplikatów

    Zamówienia, które już pobrał tunel, są zapisane ze źródłem jego szablonu. Aby moduł aktualizował właśnie je, zamiast zakładać nowe dokumenty, podaj numer tego szablonu.

    1. W Elbuz otwórz Słowniki → Operacje → Import danych. Numer szablonu tunelu jest w ostatniej kolumnie listy szablonów, „ID”.
    2. W module na zakładce „Connection” wpisz go w „Elbuz template ID” i zapisz.
    3. Zmień status jednego starego zamówienia na stronie. W dzienniku modułu powinno być „updated”, a nie „created”.
    4. W szablonie tunelu odznacz pole „Zamówienia”, aby zamówienia nie przychodziły dwiema drogami. Katalog tunel pobiera dalej.

    Z „Elbuz template ID” działa dopasowanie statusów szablonu: jego przyciski „Statusy zamówienia” i „Statusy płatności”. Wiersz wypełniony na zakładce „Statuses” modułu ma pierwszeństwo przed szablonem. Szablon musi być widoczny dla pracownika klucza, inaczej wysyłka zwróci 422 z "template_id": "not found".

    Scenariusze

    Nowy sklep: zamówienia mają pojawiać się w Elbuz od razu

    Zadanie: menedżer pracuje w Elbuz i nie powinien czekać na harmonogram, żeby zobaczyć zamówienia ze strony.

    Co zrobić: osobny klucz w trybie „Wykonuj samodzielnie”; w module — „Status” „Enabled”, adres, klucz, „Check connection”, dopasowanie statusów, zapis; „Send” z datą startu strony; link dla cron w harmonogramie co 10 minut.

    Efekt: każde nowe zamówienie w kilka sekund staje się dokumentem „Zamówienie klienta” ze źródłem „API: nazwa klucza”, a zmiana statusu na stronie aktualizuje ten sam dokument.

    Płatność kartą na stronie ma być widoczna w Elbuz

    Zadanie: menedżer nie powinien ręcznie porównywać płatności z systemem płatności.

    Co zrobić: na zakładce „Statuses” dla statusu, który moduł płatności ustawia po opłaceniu, wybierz „Opłacono” w obu kolumnach.

    Efekt: gdy tylko moduł płatności zmieni status, zamówienie w Elbuz dostanie status płatności „Opłacono”. Stan magazynowy i rezerwacja się nie zmienią, dopóki dokument nie zostanie zatwierdzony.

    Katalog idzie tunelem, zamówienia — modułem

    Zadanie: tunel latami pobierał i katalog, i zamówienia; zamówienia mają przychodzić od razu, a nie z kolejnym przebiegiem.

    Co zrobić: przejście z tunelu: „Elbuz template ID” szablonu tunelu, sprawdzenie na starym zamówieniu, a potem odznaczenie w szablonie pola „Zamówienia”.

    Efekt: stare zamówienia aktualizują się w tych samych dokumentach, nowe trafiają tam samo. Tunel nadal aktualizuje katalog według własnego harmonogramu.

    Co zrobić, gdy zamówienia nie przychodzą

    Najczęstsze problemy
    Co widziszDlaczego tak jestCo zrobić
    „No connection to Elbuz: HTTP 401 invalid, disabled or expired key”klucz skopiowano niecały, wyłączono go albo zastąpiono nowymskopiuj klucz ponownie z „API i tokeny dostępu”, sprawdź „Aktywność” klucza
    „No connection to Elbuz: HTTP 404” albo błąd połączeniaw adresie brakuje /api/v2 albo jest błąd w domenieadres musi mieć postać https://twoja-domena.elbuz.com/api/v2 albo https://app.elbuz.com/api/v2?user_domain=<numer konta>
    W dzienniku „HTTP 403 read-only key”klucz ma zaznaczone „Tylko do odczytu”odznacz pole w kluczu; moduł sam ponowi wysyłkę
    W dzienniku „HTTP 403 no right for sync”pracownik klucza nie ma uprawnienia do przycisku „Dodaj” w oknie zamówieńnadaj uprawnienie albo wybierz w kluczu innego pracownika
    W dzienniku „HTTP 403 IP … is not allowed for this key”klucz ma listę dozwolonych IP i nie ma na niej serwera stronydodaj IP serwera strony do klucza
    Wynik „waiting for confirmation in Elbuz”, a w Elbuz nie ma zamówieniaklucz jest w trybie „Pytaj” albo przekroczył bezpiecznikzatwierdź propozycje w „Pulsie”, przełącz klucz na „Wykonuj samodzielnie”, podnieś bezpiecznik (klucz)
    „not sent”, w „Message” HTTP 422 i pole orders[…]Elbuz nie przyjął danych zamówienia, na przykład status z dopasowania usunięto w Elbuzkliknij „Check connection”, wybierz statusy od nowa, zapisz i wyślij zamówienie przyciskiem „Send”
    Zamówienie długo stoi „queued”Elbuz nie odpowiadał, a cron nie jest skonfigurowanydodaj link dla cron albo kliknij „Send”
    To samo zamówienie dwa razy w Elbuzzaimportował je tunel, a moduł działa bez „Elbuz template ID”; albo klucz zmieniono na innyprzejście z tunelu; nie zmieniaj klucza modułu na inny, tylko wydawaj ponownie ten sam
    Dziennik jest pusty po nowym zamówieniumoduł jest wyłączony albo ustawienia nie zostały zapisane„Status” — „Enabled”, zapisz; bez tego „Send” odpowie „Enable the module and save the settings.”

    Najczęstsze pytania

    Czy moduł przekazuje do Elbuz produkty i ceny?

    Nie, tylko zamówienia. Katalog ze strony pobiera Elbuz Tunnel, a z Elbuz na stronę — eksport przez tunel.

    W jakiej walucie przychodzą kwoty?

    W walucie zamówienia, czyli tak, jak płacił klient. Cena pozycji — z podatkiem, dostawa — osobną kwotą.

    Klient dodał produkt do zamówienia na stronie — czy dokument się zmieni?

    Nie. Pozycje zapisują się tylko przy tworzeniu dokumentu; zmieniony skład przenosi się do dokumentu ręcznie. Kolejne wysyłki, dopóki dokument nie jest zatwierdzony, aktualizują status, płatność i sposób dostawy; adres, kwoty i klient zostają z pierwszej wysyłki.

    Czy moduł działa na OpenCart 2 lub 4?

    Nie, moduł jest dla OpenCart 3.0.x. Ze strony na OpenCart 2 zamówienia pobiera tunel.

    Czy zamówienie z modułu zdejmie stan magazynowy?

    Nie. Dokument powstaje jako niezatwierdzony, a stan i rezerwację Elbuz liczy tylko według zatwierdzonych dokumentów.

    Co się stanie, jeśli usunę zamówienie na stronie?

    Dokument w Elbuz zostanie: moduł nie usuwa dokumentów. Przed usunięciem przełącz zamówienie na stronie na status dopasowany do „Anulowano” albo usuń dokument w Elbuz.

    Gdzie to jest i kto ma dostęp

    Pobierz
    elbuz_api_sync.ocmod.zip — OpenCart 3.0.x, PHP 7.1+ z curl
    Moduł na stronie
    Extensions → Extensions → Modules → „Elbuz: order sync”
    Klucz w Elbuz
    Panel klienta → Ustawienia systemu → „Inne ustawienia” → „API i tokeny dostępu”
    Uprawnienia
    pracownik klucza — okno zamówień i przycisk „Dodaj” w nim
    Gdzie widać zamówienia
    okno „Zamówienia”, źródło „API: nazwa klucza”

    Moduł przekazuje tylko zamówienia. Katalogu nie przekazuje: produkty ze strony do Elbuz przenosi Elbuz Tunnel.

    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