↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Jak podłączyć ukraińskie marketplace’y: co się importuje z każdego

    Jak importować zamówienia z EVA.UA do Elbuz

    11 min czytaniaZaktualizowano

    Elbuz sam pobiera zamówienia z konta sprzedawcy EVA.UA przez API EVA (Merchant Center API) i zapisuje je jako dokumenty we wspólnej kolejce z innymi kanałami. Połączenie wymaga loginu i hasła do konta, a status i list przewozowy mogą wracać na EVA.

    Kiedy to się przyda:

    • Katalog na EVA idzie feedem z Elbuz — pozycje zamówień trafiają na Twoje karty produktów.
    • Menedżerowie nie chcą dwa razy zmieniać statusu — potwierdzenie i anulowanie same docierają do EVA.
    • EVA wymaga listu przewozowego przy potwierdzeniu — numer z dokumentu idzie razem ze statusem.
    • Klient anulował na EVA — dokument sam przechodzi w „Anulowano”, nawet zatwierdzony.

    Od czego zacząć: „Import danych” → „Dodaj” → typ „EVA.UA”, potem login i hasło do konta.

    Co potrafi połączenie z EVA

    • Zamówienia — klient, odbiorca, dostawa, list przewozowy, płatność i komentarz trafiają do dokumentu.
    • Dopasowanie do katalogu — pozycje znajdują karty po kodzie oferty z Twojego feedu albo po kodzie produktu i nazwie.
    • Statusy EVA — zamieniają się na Twoje bez konfiguracji.
    • Status z powrotem na EVA — potwierdzenie, list przewozowy i anulowanie z powodem.
    • Harmonogram — co 5 minut, tylko zmienione zamówienia.

    Produktów, cen i stanów to połączenie nie przekazuje: API EVA obsługuje tylko zamówienia. Asortyment trafia na marketplace feedem XML.

    Jak połączyć EVA loginem i hasłem

    W koncie EVA nie ma osobnych kluczy ani tokenów. Elbuz loguje się do API tym samym loginem i hasłem, którymi wchodzisz na konto sprzedawcy EVA.

    1. W oknie „Import danych” kliknij „Dodaj” i wybierz typ „EVA.UA”. Przełączników „Co importować” w formularzu nie ma: połączenie obsługuje tylko zamówienia.
    2. W karcie „Połączenie” wpisz „Login” i „Hasło” do konta sprzedawcy EVA. Formularz zapisuje się sam, przycisku zapisu nie ma.
    3. Kliknij „Sprawdź połączenie”. Sukces — „Połączenie działa. EVA (Twój login)”. Niepowodzenie — „Połączenie nie powiodło się:” i odpowiedź EVA, na przykład o błędnym loginie lub haśle.
    4. Szablon z plakietką „Aktywny” w ciągu 5 minut zacznie sam pobierać zamówienia, za pierwszym razem — z 30 dni. Nie chcesz czekać — kliknij „Importuj”.
    5. Otwórz kilka zamówień i sprawdź pozycje, kwoty, klienta i status.

    Hasło w szablonie jest tym samym hasłem do konta. Po jego zmianie na EVA kolejny import dostanie odmowę, a w dzienniku pojawi się „EVA: błąd zapytania do API.” z przyczyną. Wpisz nowe hasło w szablonie i sprawdź połączenie.

    Co trafia do zamówienia

    Zamówienie zapisuje się jako dokument „Zamówienie klienta”. EVA zwraca listę bez szczegółów, więc każde zamówienie Elbuz doczytuje osobnym zapytaniem — tak wymaga też dokumentacja EVA.

    Dane EVACo z nich powstaje w Elbuz
    numer zamówienianumer zewnętrzny i klucz, po którym zamówienie jest rozpoznawane ponownie
    klient: imię, imię odojcowskie, nazwisko, telefon, e-mailkontrahent i kontakty dokumentu
    odbiorca: imię, nazwisko, telefonodbiorca dostawy
    sposób dostawyprzewoźnik i sposób: «Нова пошта (Відділення)» (Nova Poshta, oddział), «Нова пошта (Поштомат)» (Nova Poshta, paczkomat), «Нова пошта (Кур'єр)» (Nova Poshta, kurier), «Укрпошта» (Ukrposhta), «Meest (Відділення)», «Meest (Поштомат)», «Meest (Кур'єр)»
    adres dostawyw jednym wierszu: miasto, oddział lub ulica
    koszt dostawyosobno od produktów; kwota dokumentu = produkty + dostawa
    numer przesyłkilist przewozowy dokumentu
    sposób płatnościkod EVA bez zmian: CASH_ON_DELIVERY (płatność przy odbiorze) lub LIQPAY
    status płatnościauthorized — „Opłacono”, pozostałe — „Oczekiwanie”
    komentarz klientaopis zamówienia
    status zamówieniastatus dokumentu (tabela)

    Waluta — hrywna (UAH). Daty utworzenia i zmiany zamówienia na EVA są zapisywane w dokumencie.

    Jak pozycje znajdują karty w katalogu

    Wiersz zamówienia EVA zawiera kod oferty — ten offer id, który EVA dostała z Twojego feedu — a także kod produktu, nazwę, cenę i ilość. Kolejność wyszukiwania jest wspólna dla wszystkich marketplace’ów (jak pozycje znajdują produkt), dla EVA działa tak:

    • Najpierw — karta, którą Elbuz już założył dla tej oferty EVA przy wcześniejszych importach.
    • Dalej — po kodzie produktu razem z nazwą, potem po samej nazwie. W szablonie EVA z Elbuz kod produktu to kod producenta z karty.
    • Na końcu — po kodzie oferty jako numerze produktu w Elbuz: w szablonie EVA offer id to właśnie ten numer. Jeśli feed nie powstał w Elbuz i kody są w nim liczbowe, pozycja może trafić na cudzą kartę z tym samym numerem.
    • Nic się nie znalazło — Elbuz zakłada kartę w kategorii technicznej „Produkty - eva - ‹nazwa szablonu›”. Kategoria powstaje wyłączona, więc takie karty same nie trafią do feedów.

    Karty z kategorii technicznej możesz przenosić do własnych kategorii: wiersz dokumentu wskazuje produkt, a nie kategorię. Samą kategorię techniczną usuń na końcu — razem z nią usuwane są produkty, dla których jest kategorią główną.

    Jak statusy EVA stają się Twoimi

    Dopasowanie jest wbudowane w połączenie, nie trzeba go konfigurować:

    Status na EVAKodStatus dokumentu w Elbuz
    Нове замовлення (Nowe zamówienie)1Nowy
    Підтверджене продавцем (Potwierdzone przez sprzedawcę)11Potwierdzenie
    Підтверджене покупцем (Potwierdzone przez kupującego)12Skompletowano
    Відправлено (Wysłane)5Wysłano
    Скасовано покупцем (Anulowane przez kupującego)9Anulowano
    Скасовано продавцем (Anulowane przez sprzedawcę)10Anulowano

    Status „Wysłane” ustawia sama EVA, gdy po liście przewozowym widzi, że paczka trafiła do przewoźnika. Innych kodów wbudowana tabela nie zna: dla nich Elbuz bierze wiersz z tabeli „Statusy zamówienia” szablonu, a bez niego dokument dostaje „Nowy”.

    Okno statusów zamówienia ze statusami marketplace’u znalezionymi w zaimportowanych zamówieniach
    1Kolumna statusu marketplace’u
    2Kolumna Twojego statusu
    3Wiersz dopasowany z tabeli
    1. Status marketplace’u — nazwa statusu w takiej postaci, w jakiej wysyła ją EVA.
    2. Twój status — status Elbuz, który dostaje zamówienie.
    3. Wiersze z oznaczeniem „z tabeli” korzystają z wbudowanego dopasowania.
    Droga zamówienia na EVA. Strzałki „Elbuz przekazuje” działają, gdy przekazywanie statusu jest włączone, a anulowanie przez wsparcie AI — zawsze; w „Wysłane” zamówienie przenosi tylko EVA, a z anulowanego nie da się już nigdzie przejść
    kupujący złożył zamówieniena EVAElbuz przekazuje statusElbuz przekazuje status zlistem przewozowymEVA sama, wg śledzeniaprzesyłkiz powodemz powodemz powodem1 Nowe zamówienie — w Elbuz„Nowy”11 Potwierdzone przez sprzedawcę— „Potwierdzenie”12 Potwierdzone przez kupującego— „Skompletowano”5 Wysłane — „Wysłano”9 lub 10 Anulowane — „Anulowano”
    • Початок
    • Стан
    • Кінець

    Jak status i list przewozowy wracają na EVA

    Zmieniasz status zamówienia EVA w Elbuz — nowy status idzie na EVA. Działa to od razu, wystarczy dopasować statusy; anulowanie zamówienia przez wsparcie AI trafia na EVA niezależnie od przełącznika, jeśli przy „Anulowano” w tabeli jest kod. Co jest potrzebne:

    1. Sprawdź przełącznik „Przekazywać status zamówienia do marketplace’u”: „Zgłoszenia” → koło zębate → „Wsparcie AI: zasady i kontrola” → karta „Kanały i działania proaktywne”. Domyślnie jest włączony; wyłącz go, jeśli status na EVA zmieniasz tylko w koncie EVA.
    2. Otwórz szablon EVA, przycisk „Statusy zamówienia”, i wpisz kody EVA przy swoich statusach: „Potwierdzenie” — 11, „Skompletowano” — 12, „Anulowano” — 10. Na EVA idzie kod stojący przy statusie dokumentu.
    3. Sprawdź, czy login i hasło w szablonie działają: tymi samymi danymi Elbuz zmienia status.

    EVA przyjmuje nie każde przejście, tylko takie:

    Teraz na EVAMożna zmienić naWarunek
    1 Nowe zamówienie11, 9, 10—
    11 Potwierdzone przez sprzedawcę12, 9, 10dla 12 — list przewozowy w dokumencie
    12 Potwierdzone przez kupującego9, 10—
    9, 10 Anulowane—status końcowy
    • List przewozowy. API EVA nie ma osobnego sposobu na przekazanie listu przewozowego: numer idzie razem ze statusem 12. Jeśli w dokumencie list przewozowy jest pusty, Elbuz nie wysyła statusu i zapisuje to w historii dokumentu. Wpisz numer i ustaw status ponownie.
    • „Wysłane” (5) nie jest przekazywane — EVA ustawia je sama. Nie wpisuj 5 w tabeli statusów szablonu: marketplace odpowie błędem.
    • Anulowanie idzie z powodem. Menedżer ustawił „Anulowano” ręcznie — 1012 «Інше» (Inne). Jeśli anuluje wsparcie AI na podstawie zgłoszenia klienta — powód wynika z powodu zgłoszenia:
      • prośba klienta, zmiana zdania lub brak powodu — 1001 «Передумав» (Zmiana zdania);
      • „znalazł taniej” — 1003 «Купив в іншому місці» (Kupił gdzie indziej);
      • duplikat — 1008 «Дубль замовлення» (Duplikat zamówienia);
      • każdy inny powód — 1012 «Інше» (Inne).
    • Wynik widać w historii dokumentu: „Status przekazano do marketplace’u: 11” albo przyczyna, dlaczego nie — status niedopasowany, brak dostępów w szablonie, błąd od EVA (omówienie komunikatów).

    Tabela „Statusy zamówienia” działa w obie strony. Jeśli w wierszu „Anulowano” jest lista „9,10”, na EVA pójdzie pierwszy kod. Sprzedawca anuluje kodem 10, więc ustaw go jako pierwszy albo jedyny.

    Co dzieje się z już zaimportowanym zamówieniem

    Zamówienie jest rozpoznawane po numerze na EVA, więc kopia się nie pojawia. Zasady są takie same jak przy innych marketplace’ach (dwa statusy jednego zamówienia):

    • Dokument zatwierdzony — status zmienia się tylko na anulowanie: EVA przysłała 9 lub 10 — dokument przechodzi w „Anulowano”, a rezerwacja jest przeliczana. Reszty zatwierdzonego dokumentu import nie zmienia.
    • Niezatwierdzony, kod EVA ten sam — Twój status zostaje, zmiana menedżera nie jest nadpisywana.
    • Niezatwierdzony, kod EVA się zmienił — status jest nadpisywany według tabeli.

    Po udanym przekazaniu statusu na EVA Elbuz zapamiętuje wysłany kod. Dlatego kolejny import, który przyniesie ten sam kod, nie nadpisze Twojego statusu.

    Kwota, ilość i cena w wierszach przy ponownym imporcie się nie zmieniają, wiersze nie są usuwane. W niezatwierdzonym dokumencie uzupełniane są tylko puste kontakty i adres, a status płatności jest aktualizowany.

    Automatyczny import

    EVA nie wysyła natychmiastowych powiadomień, więc Elbuz odpytuje ją sam: zadanie systemowe „Zamówienia z marketplace’ów” co 5 minut pobiera zamówienia ze wszystkich aktywnych szablonów EVA z loginem i hasłem. Harmonogram szablonu nie jest potrzebny. Szczegóły — automatyczny import zamówień.

    • Pierwsze uruchomienie pobiera zamówienia z ostatnich 30 dni.
    • Kolejne — tylko zmienione po najświeższym już zaimportowanym.
    • Zakres przebiegu — strony po 100 zamówień, do 500 stron. Co 200 zamówień zapisuje się osobna porcja: przerwanie zostawia zapisane wszystko do ostatniej porcji.
    • Awarie sieci — na zapytanie 30 sekund na połączenie i 120 na odpowiedź. Przy „za dużo zapytań” (429) i błędzie serwera — do trzech prób z przerwą, potem wiersz dziennika z przyczyną.

    Wiersze dziennika: „EVA: strona N, pobrano zamówień: M” i na końcu „EVA: import zamówień zakończony, łącznie: N”.

    Jak wstrzymać import

    Przełącz plakietkę „Aktywny” / „Wyłączony” w kolumnie „Stan” listy importów. Wyłączony szablon automatyczny import pomija, a ręczne „Importuj” działa. Dokumenty, karty, login i hasło zostają, a po włączeniu przebieg pobierze wszystko, co zmieniło się na EVA w czasie przerwy.

    Przekazywanie statusu na EVA szuka aktywnego szablonu EVA. Gdy wyłączysz jedyny, statusy przestają trafiać na marketplace, a w historii dokumentu pojawia się „brak dostępów w szablonie importu platformy”.

    Scenariusze

    Zamówienia mają przychodzić same

    Wpisz login i hasło do konta EVA, kliknij „Sprawdź połączenie” i upewnij się, że szablon jest „Aktywny”. Co 5 minut przebieg pobiera zmienione zamówienia, pierwszy — z 30 dni. Nowe zamówienia trafiają jako niezatwierdzone, a stan magazynowy nie zmieni się do zatwierdzenia.

    Menedżer potwierdza w Elbuz, EVA dowiaduje się sama

    Wpisz w „Statusy zamówienia” szablonu 11 przy „Potwierdzenie”, 12 przy „Skompletowano” — przekazywanie statusu jest domyślnie włączone. Menedżer ustawia „Potwierdzenie” — na EVA zamówienie staje się „Potwierdzone przez sprzedawcę”. Gdy paczka jest nadana, wpisz list przewozowy i ustaw „Skompletowano”: EVA dostanie status 12 razem z numerem i dalej sama przeniesie zamówienie w „Wysłane”.

    Klient zmienił zdanie — anulować po obu stronach

    Ustaw w dokumencie „Anulowano”: przy włączonym przekazywaniu i kodzie 10 w tabeli na EVA pójdzie „Anulowane przez sprzedawcę” z powodem „Inne”. Jeśli klient anulował sam na EVA, kolejny import przeniesie niezatwierdzony dokument w „Anulowano” bez Twojego udziału.

    Pozycje mają trafiać na istniejące karty

    Eksportuj katalog na EVA szablonem Elbuz i nie zmieniaj w nim offer id. Kod oferty w zamówieniu jest wtedy równy numerowi produktu, a pozycja znajdzie swoją kartę, nawet jeśli EVA zmieniła nazwę podczas moderacji. Pozycja bez odpowiednika dostanie kartę w kategorii technicznej, a kolejne zamówienie z tą samą ofertą trafi na nią.

    Co zrobić, gdy zamówienia nie przychodzą albo status nie dociera

    Co widziszDlaczego tak jestCo zrobić
    „EVA: nie podano loginu lub hasła konta sprzedawcy” W szablonie brakuje loginu lub hasła — do EVA nawet nie było zapytania Wpisz login i hasło do konta (jak połączyć)
    „Połączenie nie powiodło się: …” z kodem 401 EVA nie przyjęła loginu lub hasła — często po zmianie hasła w koncie Wpisz aktualne hasło i sprawdź połączenie ponownie
    „EVA: błąd zapytania do API.” w dzienniku EVA odpowiedziała błędem; przyczyna jest w tym samym wierszu. Przy „za dużo zapytań” (429) i awarii serwera Elbuz wcześniej próbuje trzy razy, inny błąd zapisuje od razu Jednorazowa awaria sieci lub serwera EVA — kolejny przebieg za 5 minut pobierze resztę. Błąd powtarza się za każdym razem — przeczytaj przyczynę: najczęściej chodzi o login i hasło
    „Status 12 nie został przekazany do marketplace’u: platforma wymaga dla niego listu przewozowego” W dokumencie nie ma listu przewozowego, a EVA bez niego nie przyjmuje potwierdzenia przez kupującego Wpisz list przewozowy w dokumencie i ustaw status ponownie (status z powrotem)
    „Status nie został przekazany do marketplace’u: „…” nie jest powiązany ze statusem platformy” W tabeli „Statusy zamówienia” szablonu przy tym statusie nie ma kodu EVA Wpisz kod, jeśli ten status ma coś znaczyć na EVA; w przeciwnym razie nic nie trzeba robić
    „Status 11 nie został przekazany do marketplace’u: …” z odpowiedzią EVA o niedozwolonym przejściu EVA nie pozwala na takie przejście — zamówienie jest tam już anulowane albo dalej w łańcuchu Porównaj status na EVA z tabelą przejść; anulowanego zamówienia nie da się już przywrócić
    Pozycje trafiają do kategorii technicznej, a nie na Twoje karty Kod oferty w feedzie nie jest numerem produktu Elbuz, a kod produktu i nazwa nie pasują do katalogu Eksportuj katalog szablonem EVA z Elbuz (dopasowanie)

    Najczęstsze pytania

    Czy tym połączeniem można importować produkty albo aktualizować ceny na EVA?

    Nie. API EVA obsługuje tylko zamówienia, więc produkty, ceny i stany trafiają na marketplace feedem XML — eksport na EVA.UA.

    Gdzie w koncie EVA znaleźć token?

    Nigdzie: w koncie nie ma osobnych tokenów. Elbuz loguje się do API loginem i hasłem do konta sprzedawcy i sam dostaje tymczasowy klucz dostępu.

    Z jakiego okresu pobiorą się zamówienia przy pierwszym uruchomieniu?

    Z ostatnich 30 dni. Dalej pobierane są tylko zamówienia zmienione po najświeższym już zaimportowanym. Potrzebujesz innego okresu — wpisz datę w polu „Import zamówień począwszy od daty (RRRR-MM-DD)” w sekcji „Zaawansowane” formularza szablonu.

    Dlaczego nie da się ustawić na EVA statusu „Wysłane”?

    Ten status ustawia sama EVA, gdy paczka z danym listem przewozowym wyruszy. Twoje zadanie — przekazać list przewozowy razem ze statusem 12 (status z powrotem).

    Czy EVA przeszkadza w połączeniu Epicentr albo Prom?

    Nie. Każdy marketplace to osobny szablon, zamówienia mają własne źródło, a tabele statusów prowadzone są dla każdego szablonu osobno.

    Gdzie to jest i kto ma dostęp

    Menu
    Słowniki → Operacje → Import danych → szablon typu „EVA.UA”
    Uprawnienia
    okno „Import” w „Uprawnieniach grup”
    Przygotuj
    login i hasło do konta sprzedawcy EVA

    Jeden szablon — jedno połączenie z jednym kontem sprzedawcy.

    Karta połączenia EVA.UA z polami Login i Hasło oraz przyciskiem Sprawdź połączenie
    1Pole Login
    2Pole Hasło
    3Przycisk Sprawdź połączenie
    1. Login — login do konta sprzedawcy EVA.
    2. Hasło — hasło do konta sprzedawcy EVA.
    3. Sprawdź połączenie — sprawdza dane logowania w EVA.

    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