Elbuz pobiera zamówienia z panelu sprzedawcy Epicentr przez API Epicentr (Merchant API) na podstawie tokenu i zamienia je na dokumenty, które menedżerowie obsługują w jednej kolejce z innymi kanałami.
Kiedy to się przyda:
- Katalog trafia na Epicentr feedem z Elbuz — zamówienia wracają przez API i cykl zamyka się bez pracy ręcznej.
- Zamówienie anulowano na marketplace’ie — dokument sam przechodzi w „Anulowano”, nawet zatwierdzony, a rezerwacja jest zwalniana.
- Menedżer prowadzi własne statusy — zostają, dopóki status na Epicentr się nie zmieni.
- Pozycje mają trafiać na Twoje karty — identyfikator z feedu wraca w wierszu zamówienia.
Od czego zacząć: wygeneruj token w panelu Epicentr i wklej go do szablonu „Epicentr” w oknie „Import danych”.
Co potrafi podłączenie Epicentr
- Zamówienia — klient, dostawa, kwota, komentarz i znacznik płatności trafiają do dokumentu.
- Dopasowanie do katalogu — pozycje znajdują karty po identyfikatorze z Twojego feedu, nieznane są zakładane w kategorii technicznej.
- Statusy — kody Epicentr są dopasowywane do Twoich statusów bez konfiguracji.
- Aktualizacja zamówień — zmiana statusu na marketplace’ie dociera do niezatwierdzonego dokumentu, a anulowanie, zwrot i wydanie — także do zatwierdzonego.
- Harmonogram — każdy przebieg pobiera tylko zmienione zamówienia.
Katalogu produktów to podłączenie nie importuje: asortyment idzie na marketplace w drugą stronę, feedem XML.
Czego potrzeba od Epicentr
Potrzebny jest jeden token z panelu sprzedawcy. Tokeny może generować administrator firmy.
Skąd wziąć token: krok po kroku
| Gdzie | Co zrobić |
|---|---|
| Panel sprzedawcy Epicentr | Włączyć przełącznik w ustawieniach dodatkowych — wtedy pojawi się potrzebna karta |
| Tamże | „Ustawienia” → „Ustawienia firmy” → karta „API” → przycisk „Wygeneruj” |
| Tamże | Skopiować token ikoną po prawej stronie pola |
| Elbuz | Okno importu → Twój szablon „Epicentr” → karta „Połączenie” → pole „Token” |
- Liczba tokenów nie jest ograniczona, wszystkie są aktywne jednocześnie — dla Elbuz utwórz osobny token o zrozumiałej nazwie.
- „Odśwież klucz” wydaje nowy token, a poprzedni działa dalej, dopóki go nie usuniesz.
Tokeny Epicentr nie mają terminu ważności i działają, dopóki ich nie usuniesz. Kto ma token, ten ma dostęp do Twoich zamówień: nie przesyłaj go w otwartych czatach. Klucz został ujawniony — usuń go w panelu ikoną kosza (wymiana od razu ustanie) i wygeneruj nowy.
Jak podłączyć krok po kroku
- Utwórz szablon typu „Epicentr”. Przełączników „co importować” nie ma: podłączenie obsługuje tylko zamówienia. Chcesz najpierw sprawdzić — przełącz plakietkę „Aktywny” na „Wyłączony”.
- Wklej token w karcie „Połączenie”. Formularz zapisuje się sam, przycisku zapisu nie ma: w aktywnym szablonie zwykle w ciągu 5 minut Elbuz sam zacznie pobierać zamówienia — z 30 dni, dalej nowe. Nie chcesz czekać — kliknij „Importuj”.
- Kliknij „Sprawdź połączenie”. Sukces — „Połączenie działa” i e-mail konta Epicentr, do którego należy token: po nim widać, że klucz pochodzi z właściwego panelu. Niepowodzenie — „Połączenie nie powiodło się” i przyczyna od marketplace’u.
- Otwórz kilka zamówień i sprawdź pozycje, kwoty, klienta i status.
Co trafia do zamówienia
| Dane Epicentr | Pole dokumentu w Elbuz |
|---|---|
| numer zamówienia | Numer zewnętrzny |
| wewnętrzny identyfikator zamówienia | Klucz, po którym zamówienie jest rozpoznawane ponownie |
| imię, imię ojca, nazwisko odbiorcy | Imię, imię ojca, nazwisko |
| identyfikator klienta | Powiązanie kontrahenta ze źródłem |
| telefon i e-mail | Telefon, e-mail |
| dane dostawy | Adres dostawy |
| kwota zamówienia | Kwota dokumentu |
| komentarz do zamówienia | Opis zamówienia |
| znacznik płatności | Status płatności: „Opłacono” lub „Oczekiwanie” |
| status zamówienia | Status dokumentu (zob. tabelę statusów) |
| daty utworzenia i zmiany | Daty zamówienia na marketplace’ie |
W wierszach zamówienia przychodzą nazwa, SKU, cena, ilość, wartość wiersza, jednostka miary, a także link do produktu i jego obraz na marketplace’ie.
Jak pozycje znajdują karty katalogu
Razem z wierszem zamówienia Epicentr zwraca identyfikator produktu w Twoim systemie — wartość przekazaną w polu identyfikatora Twojego feedu XML: numer wewnętrzny, kod lub SKU. Elbuz sprawdza go po kolei wszystkimi sposobami, więc działa każdy wybór.
- Karta, którą Elbuz sam założył dla tej oferty Epicentr przy poprzednich importach.
- Wewnętrzny kod produktu.
- SKU razem z nazwą.
- Sama nazwa.
- Numer produktu — tylko dla identyfikatora złożonego z samych cyfr.
Decyduje pierwsze sprawdzenie, które zadziałało. Dlatego jeśli w feedzie jest numer produktu, a w katalogu dwie karty o tej samej nazwie, pozycja trafi na kartę znalezioną po nazwie.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Eksportuj katalog na Epicentr narzędziami Elbuz: identyfikator w feedzie i w zamówieniu jest wtedy na pewno ten sam. Asortyment wgrany ręcznie będzie wyszukiwany po SKU i nazwie — mniej niezawodnie. Ogólna kolejność — jak pozycje znajdują produkt.
Karty z kategorii technicznej
Pozycja bez odpowiednika w katalogu dostaje kartę w kategorii technicznej „Produkty - epicentr - ‹nazwa Twojego szablonu›”. Kategoria powstaje jako wyłączona i bez oznaczenia do eksportu, więc takie produkty same nie trafią do feedów.
W karcie — nazwa, SKU, cena i ilość z wiersza zamówienia, link do produktu i zdjęcie z marketplace’u. Cena jest tu ta, po której sprzedano, a ilość — zamówiona. Takie karty uzupełnia się albo łączy z istniejącymi produktami.
Przenosić karty do zwykłych kategorii można: wiersz dokumentu odwołuje się do produktu, a nie do kategorii, i przechowuje własną nazwę, SKU, cenę i ilość.
Usunięcie kategorii zabiera wszystkie produkty, dla których jest ona główna. Wiersze zaimportowanych zamówień zostaną z nazwą, ceną i kwotą, ale link do produktu się zerwie, a w zestawieniach sprzedaży te pozycje przestaną się odnajdywać. Najpierw rozłóż karty do swoich kategorii, potem usuń pustą kategorię techniczną.
Jak statusy Epicentr stają się Twoimi
Dopasowanie jest wbudowane w podłączenie:
| Status w Epicentr | Kod marketplace’u | Status dokumentu w Elbuz |
|---|---|---|
| Nowe | new | Nowy |
| Potwierdzone przez sprzedawcę | confirmed_by_merchant | Uzgodnienie |
| Potwierdzone | confirmed | Potwierdzenie |
| Wysłane | sent | Wysłano |
| Gotowe do odbioru | delivered | Dostarczono |
| Odebrane | received | Wydano |
| Zakończone; Zamknięte | completed; closed | Zrealizowano |
| Anulowane; Anulowane przez sprzedawcę | canceled; canceled_by_merchant | Anulowano |
| Zwrócone | returned | Zwrócono |
| Wniosek o zwrot | return_requested | Oczekuje na decyzję o zwrocie |
| Zakończone i Zamknięte (odmowa sprzedawcy) | completed_merchant_rejection; closed_merchant_rejection | Odrzucono |
- Kolumna „Status dokumentu (sklep)” pokazuje kod ze środkowej kolumny — confirmed_by_merchant, sent itd., a nie nazwę ukraińską.
- Zamówienie, które długo stoi w statusie pośrednim, Epicentr sam przenosi w „Zakończono”, a Elbuz przejmie to przy kolejnym imporcie.
- Płatność przychodzi jako znacznik „opłacono”: jest — status płatności „Opłacono”, nie ma — „Oczekiwanie”.
W karcie „Powiązane ustawienia” są przyciski ręcznego dopasowania statusów, form płatności i dostawy. Najpierw działa dopasowanie wbudowane, a Twoje reguły uzupełniają tylko to, dla czego odpowiednika nie znaleziono.
Jak status z Elbuz trafia na Epicentr
Po zmianie statusu zamówienia z Epicentr w Elbuz nowy status idzie na Epicentr, jeśli jest dla niego kod w tabeli „Statusy zamówienia” szablonu. Co jest potrzebne:
- Przyciskiem „Statusy zamówienia” szablonu wpisz naprzeciw swoich statusów kody Epicentr ze środkowej kolumny tabeli powyżej. Dopasowanie wbudowane działa tylko przy imporcie, do przekazywania potrzebna jest właśnie Twoja tabela.
- 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 Epicentr zmieniasz tylko w panelu.
Anulowanie zamówienia przez wsparcie AI idzie na Epicentr niezależnie od przełącznika, jeśli naprzeciw „Anulowano” stoi kod. Wynik widać w historii dokumentu: „Status przekazano do marketplace’u: ‹kod›” albo przyczyna, dlaczego nie — status niedopasowany, brak danych dostępowych szablonu, błąd od Epicentr.
Co się stanie z już zaimportowanym zamówieniem
Zamówienie jest rozpoznawane po wewnętrznym identyfikatorze Epicentr razem z kodem źródła, więc kopia się nie pojawia. Ogólna reguła — dwa statusy jednego zamówienia.
Dokument jest zatwierdzony — import zmienia w nim tylko status i tylko na taki, który zdejmuje rezerwację:
- kod Epicentr zmienił się od poprzedniego importu i według tabeli dopasowania to „Dostarczono”, „Wydano”, „Zrealizowano”, „Anulowano”, „Zwrócono” lub „Odrzucono” — dokument przechodzi w ten status, rezerwacja jest przeliczana;
- dokument już ma status zdejmujący rezerwację — nie jest ruszany.
Reszta zatwierdzonego dokumentu się nie zmienia; w karcie widnieje „Dokument jest zatwierdzony — edycja zablokowana”. Żeby inne zmiany z marketplace’u znów przychodziły, cofnij zatwierdzenie.
Dokument nie jest zatwierdzony — Elbuz porównuje kod statusu Epicentr z zapamiętanym poprzednio:
- kod ten sam — Twój status zostaje, poprawki menedżera nie są ruszane;
- kod inny — status jest nadpisywany według tabeli dopasowania, nawet jeśli menedżer właśnie ustawił własny;
- kodu jeszcze nie zapamiętano — status nie jest ruszany, kod jest tylko zapamiętywany.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Do niezatwierdzonego dokumentu za każdym razem trafiają kod statusu Epicentr, kod i nazwa sposobu płatności i dostawy. Status płatności, dostawy i typ płatności są aktualizowane tylko przy znalezionym odpowiedniku — „nie dopasowano” nie czyści ustawionej wartości.
Nie zmieniają się: kwota, imię i nazwisko, telefon, e-mail, adres, ilość i cena w wierszach; wiersze nie są usuwane. U znalezionego klienta dopisywane są tylko puste e-mail i telefon.
Jeśli zamówienie zniknęło z panelu Epicentr
Import niczego nie usuwa ani nie dezaktywuje:
- usunięto lub ukryto w panelu — dokument zostaje taki jak po ostatnim imporcie;
- anulowano — przychodzi kod anulowania i dokument przechodzi w „Anulowano”, także zatwierdzony;
- już się nie zmienia — Elbuz pobiera tylko zmiany, więc dokument nie jest aktualizowany.
Osobnego sygnału „zamówienia już nie ma” nie będzie. Punktem odniesienia jest kolumna „Status dokumentu (sklep)” z ostatnim kodem od Epicentr. Czy usunąć dokument, czy zostawić go dla historii, decydujesz Ty.
Kiedy zamówienie dociera do magazynu i rezerwacji
Zamówienie trafia jako niezatwierdzony dokument „Zamówienie klienta” i do zatwierdzenia nie dotyczy magazynu.
- „Zatwierdź” — towar idzie do rezerwacji. Potrzebne są włączone ustawienie „Ewidencja ilościowa magazynu” i co najmniej jeden aktywny magazyn. Rezerwacja jest liczona w magazynie z zamówienia, a bez niego — w magazynie domyślnym.
- Dokument WZ na podstawie zamówienia fizycznie zdejmuje towar ze stanu — to jego zatwierdzenie zmniejsza stan.
- Rezerwację zdejmują statusy „Zrealizowano”, „Zakończono”, „Wydano”, „Dostarczono”, „Anulowano”, „Anulowany zwrot”, „Odrzucono”, „Zwrócono”, „Zwrot towaru”, „Unieważniono”, „Niepowodzenie”, „Wygasło”, „Nieaktualne”. W „Wysłano” rezerwacja się utrzymuje: paczka jest w drodze i może wrócić.
- „Wysyłki częściowe” są włączone — rezerwacja zmniejsza się także przy zatwierdzeniu dokumentu WZ: zajęta zostaje niewysłana ilość.
Rezerwacja jest przeliczana, gdy dokument się zatwierdza, cofa zatwierdzenie, zmienia status w samym Elbuz albo gdy import przenosi zatwierdzone zamówienie w status zdejmujący rezerwację.
Automatyczny import
Epicentr nie wysyła natychmiastowych powiadomień, więc Elbuz odpytuje go sam: zadanie systemowe „Zamówienia z marketplace’ów” co 5 minut pobiera zamówienia wszystkich aktywnych szablonów Epicentr z tokenem. Harmonogram szablonu nie jest potrzebny — przycisku „Ustawienia harmonogramu” w formularzu nie ma. Interwał zmienia się w oknie „Harmonogram zadań”, w wierszu tego zadania. Więcej — automatyczny import zamówień.
- Pierwsze uruchomienie pobiera zamówienia z ostatnich 30 dni.
- Kolejne — tylko zmienione po poprzednim imporcie.
Ile zamówień bierze jeden przebieg
- Strony po 100 zamówień, nie więcej niż 200 stron na przebieg — do 20 000 zamówień. Reszta przyjdzie przy następnym uruchomieniu.
- Co 200 zamówień zapisuje się do bazy osobną porcją, więc przerwanie zostawia zapisane wszystko do ostatniej porcji.
- Na zapytanie — 30 sekund na połączenie i 180 sekund na odpowiedź. Przy błędzie serwera lub „zbyt wielu zapytaniach” (kod 429) — do trzech prób z rosnącą pauzą, dalej wiersz „Epicentr: błąd zapytania do API.” z przyczyną.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Dziennik jest prowadzony w Centrum operacji, okno można zamknąć. Wiersze dziennika:
| Wiersz | Co oznacza |
|---|---|
| „Epicentr: strona N, pobrano zamówień: M” | odczytano kolejną stronę |
| „Pobrano zamówień: N” | zapisano porcję |
| „Łącznie zaimportowano produktów: N” | nowe karty w kategorii technicznej |
| „Łącznie zaimportowano zamówień: N” | nowe dokumenty |
| „Epicentr: import zamówień zakończony, łącznie: N”, „Import danych zakończony!” | przebieg się zakończył |
Jak wstrzymać import
Wyłącznik jest jeden — stan szablonu, plakietka „Aktywny” / „Wyłączony” w kolumnie „Stan” listy importów.
1
Plakietka stanu („Wyłączony”)- Plakietka stanu w wierszu szablonu Epicentr — pokazuje „Wyłączony”; kliknięcie przełącza szablon, dlatego jej nie klikano.
Wyłączony szablon automatyczny import pomija, ręczne uruchomienie działa. Dokumenty, karty, kontrahenci, dopasowania, token i punkt startowy zostają. Po włączeniu przebieg pobierze wszystko, co zmieniło się na Epicentr w czasie przerwy.
Scenariusze
Zamówienia mają przychodzić same, bez ręcznego uruchamiania
Wklej token w pole „Token”, kliknij „Sprawdź połączenie” i upewnij się, że w kolumnie „Stan” jest „Aktywny”. Harmonogram nie jest potrzebny: co 5 minut przebieg pobiera zmienione zamówienia, pierwszy — z 30 dni; nowe trafiają jako niezatwierdzone. Stan magazynowy nie zmieni się do zatwierdzenia, a Twój status pójdzie na Epicentr tylko wtedy, gdy w szablonie wypełniono tabelę „Statusy zamówienia” (status na Epicentr).
Menedżer prowadzi swoje statusy, ale anulowanie na marketplace’ie ma je nadpisywać
Nic nie trzeba włączać: kod canceled już przechodzi w „Anulowano”. Dopóki kod na Epicentr jest ten sam, status menedżera zostaje; zmienił się — niezatwierdzony dokument dostaje status według dopasowania. Zatwierdzony dokument dostanie tylko status zdejmujący rezerwację: anulowanie, zwrot, wydanie lub zakończenie. Ręczne przyciski dopasowania są potrzebne tylko dla kodów, których nie ma w tabeli.
Pozycje zamówień mają trafiać na istniejące karty, a nie mnożyć nowe
Wyeksportuj katalog na Epicentr szablonem eksportu Elbuz — w wierszu zamówienia wróci identyfikator z feedu. Jeśli w feedzie jest SKU, a wiersz nie ma własnego SKU, Elbuz będzie szukać po nim razem z nazwą. Pozycja bez odpowiednika dostanie kartę w kategorii technicznej, a następne zamówienie z tą samą ofertą trafi na nią.
Wstrzymać przyjmowanie zamówień i niczego nie przegapić
Przełącz plakietkę w kolumnie „Stan” na „Wyłączony”. Punkt startowy w czasie przerwy się nie przesuwa, więc po powrocie do „Aktywny” przebieg pobierze wszystko, co zmieniło się w tym czasie. Dokumenty, karty i token zostają.
Co zrobić, gdy zamówienia nie przychodzą
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Epicentr: nie podano tokenu dostępu” | W szablonie puste jest pole „Token” — z marketplace’em nawet się nie łączono | Wklej token z panelu i zapisz szablon (skąd go wziąć) |
| „Połączenie nie powiodło się: …” | Marketplace nie przyjął klucza: token skopiowano niecały, ze spacją albo usunięto go w panelu | Skopiuj token ponownie ikoną przy polu i kliknij „Sprawdź połączenie” jeszcze raz |
| „Epicentr: błąd zapytania do API.” | Marketplace nie odpowiedział lub zwrócił błąd trzy razy z rzędu; przyczyna stoi w tym samym wierszu dziennika | Nic — to, co nie zdążyło przyjść, pobierze następne przejście (granice przebiegu). Często „zbyt wiele zapytań” (429) — zwiększ interwał zadania „Zamówienia z marketplace’ów” w oknie „Harmonogram zadań” |
| Nowe zamówienie pojawiło się później niż po 5 minutach | W tym momencie importował się inny szablon, także ręcznie, — dwa importy nie idą jednocześnie, a przejście zamówień jest pomijane bez wpisu w dzienniku | Nic: zamówienie pobierze następne przejście. Jeśli opóźnienia są częste, rozłóż w czasie harmonogramy innych szablonów importu |
| Pozycje zamówienia nie znalazły Twoich produktów | Identyfikator w feedzie nie zgadza się z katalogiem albo katalog wgrano nie z Elbuz | Wyeksportuj katalog narzędziami Elbuz (dopasowanie) |
| „Nie usunięto zatwierdzonych dokumentów (N). Najpierw anuluj zatwierdzenie.” | Zatwierdzonego dokumentu nie można usunąć — jest już ujęty w ewidencji | Cofnij zatwierdzenie i powtórz usuwanie (jak usunąć omyłkowy przebieg) |
Jeśli przebieg uruchomiono omyłkowo
Wszystko, co przyszło, znajdziesz, filtrując po kolumnach źródła (ogólna kolejność wycofania):
- „Dokumenty” — „Źródło: nazwa” (nazwa szablonu), „Źródło (kod)” (epicentr), „Źródło: ID” (numer szablonu);
- „Produkty” — „Źródło: nazwa”, „Źródło: kod”, „Źródło: ID”;
- „Kontrahenci” — „Źródło — nazwa”, „Źródło — kod”.
Usunięte dokumenty trafiają do „Kosza dokumentów”: przycisk „Cofnij” przywraca pakiet, kosz przechowuje migawki przez 30 dni. Zatwierdzonym dokumentom najpierw cofa się zatwierdzenie. Kontrahentów i karty usuwa się osobno, w ich oknach.
Następny przebieg pobiera tylko zmiany po poprzednim imporcie, więc usunięte zamówienie nie przyjdzie, dopóki coś się z nim nie stanie na marketplace’ie. Pierwszy przebieg nowego podłączenia sprawdzaj od razu.
Najczęstsze pytania
Czy tym podłączeniem można zaimportować produkty do katalogu?
Nie, podłączenie przynosi tylko zamówienia. Katalog eksportuje się na Epicentr feedem XML — eksport na Epicentr.
Czy token trzeba odnawiać co jakiś czas?
Nie, tokeny Epicentr nie mają terminu ważności — działają, dopóki ich nie usuniesz. Dlatego chroń token jak hasło.
Czy status zamówienia na Epicentr się zmienia, gdy obsługuję je w Elbuz?
Tak, jeśli w szablonie wypełniono tabelę „Statusy zamówienia”: naprzeciw Twojego statusu — kod Epicentr. Przełącznik „Przekazywać status zamówienia do marketplace’u” jest domyślnie włączony; po jego wyłączeniu na Epicentr idzie tylko anulowanie przez wsparcie AI (status na Epicentr).
Ile tokenów można utworzyć?
Dowolnie dużo — wszystkie są aktywne jednocześnie. „Odśwież klucz” wydaje nowy token, a poprzedni działa, dopóki się go nie usunie.
Z jakiego okresu pobiorą się zamówienia przy pierwszym uruchomieniu?
Z ostatnich 30 dni. Dalej pobierane są tylko zamówienia zmienione po poprzednim imporcie.
Dlaczego w panelu nie ma karty „API”?
Karta pojawia się po włączeniu przełącznika API w ustawieniach dodatkowych, a tokeny może generować administrator firmy. Nie ma karty — Twój użytkownik ma prawdopodobnie inną rolę.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Import danych → szablon typu „Epicentr”
- Uprawnienia
- okno „Import danych” w „Uprawnieniach grup”
- Przygotuj
- token z panelu sprzedawcy Epicentr
Jeden szablon — jedno podłączenie do jednego panelu sprzedawcy.
1
Pole „Token”2
Przycisk „Sprawdź połączenie”- Pole „Token” — tu wklejasz token API z panelu sprzedawcy Epicentr.
- Przycisk „Sprawdź połączenie” — sprawdza token na marketplace’ie (na tym zrzucie nie został kliknięty).
Powiązane tematy
- Jeśli katalog nie został jeszcze wyeksportowany na Epicentr — eksport na Epicentr feedem XML.
- Jeśli zamówienie przypisało się do niewłaściwego klienta — import zamówień przez API.
- Jeśli obok Epicentr sprzedajesz na Rozetka — katalog i zamówienia z Rozetka.
