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.
- 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.
- W karcie „Połączenie” wpisz „Login” i „Hasło” do konta sprzedawcy EVA. Formularz zapisuje się sam, przycisku zapisu nie ma.
- 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.
- 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”.
- 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 EVA | Co z nich powstaje w Elbuz |
|---|---|
| numer zamówienia | numer zewnętrzny i klucz, po którym zamówienie jest rozpoznawane ponownie |
| klient: imię, imię odojcowskie, nazwisko, telefon, e-mail | kontrahent i kontakty dokumentu |
| odbiorca: imię, nazwisko, telefon | odbiorca dostawy |
| sposób dostawy | przewoźnik i sposób: «Нова пошта (Відділення)» (Nova Poshta, oddział), «Нова пошта (Поштомат)» (Nova Poshta, paczkomat), «Нова пошта (Кур'єр)» (Nova Poshta, kurier), «Укрпошта» (Ukrposhta), «Meest (Відділення)», «Meest (Поштомат)», «Meest (Кур'єр)» |
| adres dostawy | w jednym wierszu: miasto, oddział lub ulica |
| koszt dostawy | osobno od produktów; kwota dokumentu = produkty + dostawa |
| numer przesyłki | list przewozowy dokumentu |
| sposób płatności | kod EVA bez zmian: CASH_ON_DELIVERY (płatność przy odbiorze) lub LIQPAY |
| status płatności | authorized — „Opłacono”, pozostałe — „Oczekiwanie” |
| komentarz klienta | opis zamówienia |
| status zamówienia | status 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 idto 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 EVA | Kod | Status dokumentu w Elbuz |
|---|---|---|
| Нове замовлення (Nowe zamówienie) | 1 | Nowy |
| Підтверджене продавцем (Potwierdzone przez sprzedawcę) | 11 | Potwierdzenie |
| Підтверджене покупцем (Potwierdzone przez kupującego) | 12 | Skompletowano |
| Відправлено (Wysłane) | 5 | Wysłano |
| Скасовано покупцем (Anulowane przez kupującego) | 9 | Anulowano |
| Скасовано продавцем (Anulowane przez sprzedawcę) | 10 | Anulowano |
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”.
1
Kolumna statusu marketplace’u2
Kolumna Twojego statusu3
Wiersz dopasowany z tabeli- Status marketplace’u — nazwa statusu w takiej postaci, w jakiej wysyła ją EVA.
- Twój status — status Elbuz, który dostaje zamówienie.
- Wiersze z oznaczeniem „z tabeli” korzystają z wbudowanego dopasowania.
- Початок
- Стан
- Кінець
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:
- 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.
- 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.
- 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 EVA | Można zmienić na | Warunek |
|---|---|---|
| 1 Nowe zamówienie | 11, 9, 10 | — |
| 11 Potwierdzone przez sprzedawcę | 12, 9, 10 | dla 12 — list przewozowy w dokumencie |
| 12 Potwierdzone przez kupującego | 9, 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 widzisz | Dlaczego tak jest | Co 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.
1
Pole Login2
Pole Hasło3
Przycisk Sprawdź połączenie- Login — login do konta sprzedawcy EVA.
- Hasło — hasło do konta sprzedawcy EVA.
- Sprawdź połączenie — sprawdza dane logowania w EVA.
Powiązane tematy
- Jeśli katalog nie jest jeszcze na EVA — eksport produktów na EVA.UA feedem XML.
- Jeśli zamówienie przypisało się do niewłaściwego klienta — import zamówień przez API.
- Jeśli obok EVA sprzedajesz na Epicentr — zamówienia z Epicentr.
