Elbuz pobiera zamówienia z Twojego konta Prom.ua przez Prom API za pomocą tokenu i zamienia je w dokumenty we wspólnej kolejce z innymi kanałami.
Kiedy to się przyda:
- Zamówienia z Prom obsługujesz w osobnej karcie przeglądarki — trafiają na listę dokumentów Elbuz razem z klientem, dostawą, listem przewozowym i prowizją.
- Katalog na Prom wyeksportowano z Elbuz — pozycje zamówień znajdują swoje karty po kodzie produktu, a nie po zgodności nazw.
- Zamówienia mają przychodzić bez ręcznego uruchamiania — Elbuz sam pobiera nowe co 5 minut.
- Masz kilka kont Prom — wszystkie zasilają jedną kolejkę zamówień.
Od czego zacząć: utwórz token na koncie Prom i wklej go do szablonu typu „API - prom.ua, satu.kz” w oknie „Import danych”.
Co potrafi integracja z Prom
- Zamówienia — klient, dostawa, , płatność, kody promocyjne i prowizja CPA trafiają do dokumentu.
- Dopasowanie do katalogu — pozycje znajdują karty po kodzie produktu Elbuz, nieznane są dodawane w kategorii technicznej.
- Statusy — statusy zamówienia i płatności Prom są przekładane na Twoje bez konfiguracji.
- Automatyczny import — co 5 minut nowe zamówienia, świeże się aktualizują, bez duplikatów.
Produktów Prom ta integracja nie importuje: katalog idzie osobno, importem XLSX (EVO) albo przez .
Czego potrzebujesz od Prom
Potrzebna jest jedna wartość — Token, klucz dostępu do API, który tworzysz na koncie firmy w Prom. Token otwiera dostęp do konta, więc przechowuj go jak hasło.
Skąd wziąć token: krok po kroku
| Gdzie | Co zrobić |
|---|---|
| Konto Prom | Sekcja «Налаштування» → «Управління API-токенами» (Ustawienia → Zarządzanie tokenami API) → przycisk «Створити токен» (Utwórz token) |
| Tamże | Ustaw nazwę (opcjonalnie), okres ważności i prawa dostępu dla grup metod |
| Tamże | Kliknij utworzony token, żeby go wyświetlić i skopiować |
| Elbuz | Okno importu → Twój szablon „Prom” → karta „Połączenie” → pole „Token” |
Tokeny może tworzyć właściciel firmy lub użytkownik z rolą «Адміністратор» (Administrator). Jeśli nie ma tej pozycji menu, Twój użytkownik ma inną rolę.
Prawa ustawia się dla każdej grupy metod: brak dostępu / tylko odczyt / odczyt i zapis. Do importu zamówień wystarczy odczyt grupy «Замовлення і повідомлення» (Zamówienia i wiadomości). Żeby Elbuz przekazywał statusy na Prom i odpowiadał klientom ze „Zgłoszeń”, nadaj tej grupie odczyt i zapis. Co najmniej jedna grupa musi być otwarta, inaczej Prom nie zapisze tokenu.
Prom ogranicza ważność tokenu do maksymalnie jednego roku (minimum jeden dzień). Gdy termin minie, import zatrzyma się z błędami autoryzacji. Ustaw przypomnienie: przed końcem terminu przedłuż token na koncie albo utwórz nowy i zaktualizuj pole „Token”.
Objawy w dzienniku: brak praw — Prom odpowiada odmową dostępu; termin minął — błędem autoryzacji.
Instrukcja Prom krok po kroku z opisem wszystkich parametrów tokenu: Zarządzanie tokenami API na koncie firmy (pomoc dla sprzedawców Prom.ua, po ukraińsku).
Jak podłączyć krok po kroku
- Utwórz szablon typu „API - prom.ua, satu.kz”. 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 — całą historię, jaką odda Prom, potem nowe. Nie chcesz czekać — kliknij „Importuj”.
- Otwórz kilka zaimportowanych zamówień i sprawdź pozycje, kwoty, klienta i status.
Co trafia do zamówienia
| Dane Prom | Pole dokumentu w Elbuz |
|---|---|
| numer zamówienia | Numer zewnętrzny (po nim zamówienie jest rozpoznawane ponownie) |
| imię, imię odojcowskie, nazwisko klienta | Imię, imię odojcowskie, nazwisko (wielką literą) |
| identyfikator klienta | Powiązanie kontrahenta ze źródłem |
| e-mail i telefon | E-mail, telefon |
| adres dostawy | Adres dostawy |
| sposób dostawy, przewoźnik, oddział nadawcy i odbiorcy | Dane dostawy |
| numer listu przewozowego | List przewozowy (w polu danego przewoźnika) |
| koszt dostawy | Koszt dostawy |
| kwota zamówienia | Kwota dokumentu |
| komentarz klienta | Opis zamówienia |
| źródło zamówienia | Źródło |
| rabat, kod promocyjny, darmowa dostawa w promocji | Dane promocji |
| prowizja CPA i znacznik jej zwrotu | Prowizja platformy |
| sposób i status płatności | Rodzaj płatności, status płatności |
| status zamówienia | Status dokumentu |
| daty utworzenia i zmiany | Daty zamówienia na platformie |
W wierszach zamówienia przychodzą nazwa, kod produktu, cena, ilość, jednostka miary, kwota wiersza, a także link do produktu i jego zdjęcie na Prom.
Jak pozycje znajdują karty katalogu
Razem z wierszem zamówienia Prom zwraca zewnętrzny identyfikator produktu — ten, który przekazano platformie razem z katalogiem. Eksport Elbuz zapisuje tam kod produktu Elbuz. Produkt pojechał na Prom z naszym kodem, zamówienie wróciło z tym samym kodem — pozycja dokładnie znajduje swoją kartę.
Wyeksportuj katalog na Prom narzędziami Elbuz — eksportem XLSX lub feedem XML. Jeśli katalog wgrywano ręcznie lub obcym narzędziem, pozycje będą szukane po kodzie z nazwą albo tylko po nazwie — to mniej pewne. Ogólna kolejność dopasowania — jak pozycje znajdują produkt.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Kategoria techniczna dla nieznanych produktów
Prom nie przekazuje kategorii produktu w wierszu zamówienia. Pozycja, której nie ma w Twoim katalogu, dostaje kartę w kategorii technicznej „Produkty - evo_market - nazwa szablonu”: nazwa, kod produktu, cena, ilość, jednostka miary, link do strony produktu na Prom i zdjęcie z Prom. Kategoria tworzy się wyłączona i bez eksportu do pliku, jedna na szablon.
Przenoszenie kart stamtąd do własnego drzewa jest bezpieczne: wiersz zamówienia odwołuje się do karty, a nie do kategorii, i przechowuje własne kopie nazwy, kodu, ceny i ilości. Kolejne zamówienia tego samego produktu znajdą kartę w nowym miejscu. Pustą kategorię po przeniesieniu można usunąć.
Kategoria usunięta razem z kartami zabiera też karty z opisami, zdjęciami i cechami. Wiersze już zaimportowanych zamówień zostają, ale powiązanie z kartą się zrywa, a następny przebieg doda kartę i kategorię od nowa. Najpierw przenieś karty, potem usuń kategorię.
Jak statusy Prom stają się Twoimi
Dopasowanie statusów jest wbudowane w integrację:
| Status w Prom | Status dokumentu w Elbuz |
|---|---|
| nowe (oczekuje) | Nowy |
| przyjęte | Uzgodnienie |
| opłacone | Opłacono |
| dostarczone | Dostarczono |
| anulowane | Anulowano |
| wersja robocza | Wersja robocza |
| Co jest dopasowywane | Jak |
|---|---|
| Status płatności | „nieopłacone” → oczekiwanie, „opłacone” → płatność, „zwrócone” → zwrot, „wypłacone sprzedawcy” → osobny stan rozliczenia z platformą |
| Rodzaj płatności «Пром-оплата» (płatność przez Prom) | płatność przez marketplace |
| Rodzaj płatności «Безготівковий розрахунок» (płatność bezgotówkowa) | przelew bankowy |
| Dowolny sposób ze słowami «Накладений платіж» (za pobraniem) | pobranie |
W karcie „Powiązane ustawienia” są przyciski ręcznego dopasowania statusów, rodzajów płatności i dostawy. Najpierw działa dopasowanie wbudowane, a Twoje reguły uzupełniają tylko to, dla czego nie znalazło się odpowiednika.
Co się stanie z już zaimportowanym zamówieniem
Pierwszy przebieg pobiera całą historię zamówień. Kolejne czytają ponownie zamówienia z co najmniej 7 dni; starszych nie czytają. Dokument z takim samym numerem zamówienia Prom i źródłem przebieg znajduje, druga kopia się nie pojawia.
W już zaimportowanych aktualizują się status, płatność i dostawa. Twój status zmienia się dopiero po nowej zmianie na Prom — kto kogo nadpisuje. Anulowanie na Prom zamówienia starszego niż 7 dni do Elbuz nie dotrze.
Jak status z Elbuz trafia na Prom
W drugą stronę status jest przekazywany: zmieniasz status zamówienia Prom w Elbuz — nowy status idzie na Prom. Do tego:
- 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 Prom zmieniasz tylko na koncie Prom.
- Dopasuj swoje statusy do kodów Prom przyciskiem „Statusy zamówienia” szablonu: na Prom idzie kod stojący obok Twojego statusu.
- Nadaj tokenowi odczyt i zapis grupy «Замовлення і повідомлення».
Anulowanie idzie na Prom z powodem. Wynik widać w historii dokumentu: „Status przekazano do marketplace’u: ‹kod›” albo przyczyna, dla której nie przekazano — status niedopasowany, brak dostępów szablonu lub odpowiedź Prom z błędem.
- Klient jest szukany po e-mailu, potem po telefonie, potem po identyfikatorze klienta Prom (bez niego — po odcisku „e-mail + telefon”). W znalezionej karcie uzupełniane są tylko puste e-mail i telefon; imię, adres i reszta się nie aktualizują.
- Karty produktów się nie aktualizują: ani cena, ani stan, ani nazwa. Przeliczana jest tylko łączna liczba sprzedaży.
- Wiersz usunięty przez menedżera nie wróci: pozycje dodaje się tylko do dokumentów utworzonych przez ten sam przebieg.
Jak sprawdzić, czy przebieg się udał
Przycisku „Sprawdź połączenie” w szablonie Prom nie ma: uruchom import i przeczytaj dziennik w Centrum operacji. Okno się nie blokuje, obok dziennika jest przycisk „Zatrzymaj”.
| Wiersz dziennika | Co oznacza |
|---|---|
| „Pobieranie listy zamówień #1”, „#2”, … | numer strony pobieranej właśnie z Prom; ile takich wierszy — tyle stron przeczytano |
| „Pobrano zamówień: N” | ile zamówień Prom oddał na wszystkich stronach łącznie — zarówno nowych, jak i tych, które już były w Elbuz |
| „Łącznie zaimportowano produktów: N” | ile nowych kart produktu trzeba było założyć dla pozycji zamówień |
| „Łącznie zaimportowano zamówień: N” | ile dokumentów utworzono. To jest wynik przebiegu |
| „Aktualizacja wartości na podstawie formuł” | krok końcowy; w automatycznym przebiegu go nie ma |
| „Import danych zakończony! Czas wykonania: …” | przebieg się zakończył, obok — czas jego trwania |
Patrz na liczby, a nie na ostatni wiersz. Brak wiersza „Pobrano zamówień” — Prom nie oddał nowych zamówień, a przebieg i tak zakończy się słowami „Import danych zakończony!”.
Błędy zapisują się w osobnych wierszach — „Nie podano tokenu API” albo odmowa autoryzacji Prom z tekstem 401 Not Authenticated. Taki wiersz oznacza całą operację jako błędną.
- Ślad przebiegu: kolumna „Ostatni import” na liście szablonów i przycisk „Historia uruchomień” w nagłówku szablonu.
- Powiadomienia „Nowe zamówienie” z numerem, kwotą, klientem i produktami — nie więcej niż dziesięć na przebieg; resztę znajdziesz na liście dokumentów.
Zaimportowane zamówienia widać na liście dokumentów w kolumnach źródła:
| Kolumna listy dokumentów | Co w niej jest dla Prom |
|---|---|
| „Źródło: nazwa” | nazwa Twojego szablonu Prom |
| „Źródło (kod)” | kod integracji — dla Prom to evo_market |
| „Źródło: ID” | numer szablonu, którym zaimportowano dokument |
| „Zewnętrzne ID dokumentu (ciąg UUID)” i „Nr dokumentu (sklep)” | numer zamówienia na Prom — ten sam klucz, po którym przebieg rozpoznaje już zaimportowane |
Automatyczny import
Prom 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 Prom z tokenem. Harmonogram szablonu nie jest potrzebny — przycisku „Ustawienia harmonogramu” w formularzu Prom nie ma. Interwał zmienia się w oknie „Harmonogram zadań”, w wierszu tego zadania. Więcej — automatyczny import zamówień.
Ile zamówień idzie w jednym przebiegu
- Nie ma limitu. Zamówienia idą stronami po 100 z jednosekundową przerwą, dopóki Prom nie odda pustej listy.
- Limity Prom z jednego adresu IP — 100 zapytań na sekundę, 200 na 10 sekund i 21 600 na dwie godziny. Jedna strona na sekundę trzyma przebieg daleko od nich.
- Pierwsze połączenie — data w zapytaniu nie jest podawana, przebieg pobiera całą historię, jaką oddaje platforma.
- Kolejne przebiegi — od początku doby, w której utworzono ostatnie zaimportowane zamówienie, ale nie później niż 7 dni temu: tak do już zaimportowanych docierają anulowania i płatności. Istniejące dokumenty się nie dublują.
Granicę widać w sekcji „Zaawansowane” formularza szablonu: „Import zamówień począwszy od ID” i „Import zamówień począwszy od daty (RRRR-MM-DD)”. Obie wartości ustawia sam przebieg, ale wpisane ręcznie zostaje zachowane: następny przebieg ruszy od wcześniejszej z dwóch dat — wpisanej lub „7 dni temu”. Puste pole daty — przebieg pobierze całą historię, jak za pierwszym razem.
1
Import zamówień począwszy od ID2
Import zamówień począwszy od daty (RRRR-MM-DD)- Import zamówień począwszy od ID — minimalne ID zamówienia do pobrania; 0 oznacza brak ograniczenia.
- Import zamówień począwszy od daty — pobierane są tylko zamówienia utworzone tego dnia lub później.
Dwa importy nie idą jednocześnie. Jeśli w tej minucie importuje się inny szablon, także ręcznie, przebieg jest po cichu pomijany, a zamówienia pobierze następny — za 5 minut (jak rozdzielane są importy).
Jak wstrzymać import
Stan szablonu przełącza się plakietką „Aktywny” / „Wyłączony” w nagłówku formularza; na liście szablonów to kolumna „Stan”.
1
Plakietka stanu2
Ikona historii uruchomień- Plakietka stanu — pokazuje, czy szablon jest aktywny, czy wyłączony; w tym demo jest wyłączony.
- Ikona historii uruchomień — otwiera historię przebiegów importu.
Wyłączony szablon automatyczny import pomija; token, dopasowania, zamówienia i znacznik „począwszy od daty” zostają. Ręcznie można go uruchomić. Po włączeniu przebieg zacznie od tego samego znacznika: zamówienia utworzone w czasie przerwy się zaimportują, a statusy już zaimportowanych po znaczniku się zaktualizują (co się aktualizuje).
Scenariusze
Zamówienia z Prom mają pojawiać się w Elbuz bez ręcznego uruchamiania
Co włączyć: szablon typu „API - prom.ua, satu.kz”, pole „Token” w karcie „Połączenie”, stan szablonu „Aktywny”. Harmonogram nie jest potrzebny.
Efekt: co 5 minut przebieg tworzy dokumenty dla nowych zamówień, a w zaimportowanych w ostatnich 7 dniach aktualizuje status, płatność i dostawę.
Pozycje zamówień mają trafiać na istniejące karty, a nie tworzyć nowych
Co włączyć: najpierw wyeksportuj katalog na Prom eksportem XLSX lub feedem XML z Elbuz, potem uruchamiaj szablon „Prom”.
Efekt: pozycja znajduje kartę po kodzie produktu Elbuz. Dla produktu bez karty zakładana jest karta w kategorii technicznej, a przebieg zapamiętuje ją po wewnętrznym produktu w Prom: kolejne zamówienia znajdują już ją. Cena, stan i nazwa znalezionych kart nie są aktualizowane z zamówienia.
Dwa konta Prom — jedna kolejka zamówień
Co włączyć: dwa szablony typu „API - prom.ua, satu.kz”, w każdym własny „Token”.
Efekt: konta są czytane niezależnie, każde z własnym znacznikiem „począwszy od daty”. Dokumenty trafiają na jedną listę, rozróżnia je kolumna „Źródło: nazwa”. Kategoria techniczna każdego szablonu jest osobna. Klient, który kupował na obu kontach, trafia do jednej karty kontrahenta. Zamówienia się nie zdublują, nawet jeśli to samo konto podłączono dwoma szablonami: kod źródła evo_market jest wspólny dla wszystkich szablonów Prom.
Wstrzymać przyjmowanie zamówień, a potem nadrobić zaległości
Co włączyć: plakietkę w nagłówku formularza szablonu przełącz na „Wyłączony”, a po przerwie — z powrotem na „Aktywny”.
Efekt: pierwszy przebieg po włączeniu zaimportuje zamówienia utworzone na Prom w czasie przerwy i zaktualizuje statusy już zaimportowanych, utworzonych po znaczniku.
Co zrobić, gdy import poszedł nie tak
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „401 Not Authenticated” w dzienniku | Token wygasł lub jest nieprawidłowy | Przedłuż token albo utwórz nowy i wklej w pole „Token” (skąd wziąć token) |
| Prom odpowiada odmową dostępu | Token nie ma praw do grupy «Замовлення і повідомлення» | Nadaj tokenowi odczyt tej grupy |
| „Nie podano tokenu API” | Pole „Token” jest puste | Wklej token i zapisz szablon |
| Przebieg się zakończył, a zamówień nie ma | Od poprzedniego importu nie pojawiły się nowe zamówienia | Sprawdź wiersz „Pobrano zamówień” (dziennik) |
| Pozycje zamówień trafiają do „Produkty - evo_market - …” | Katalog na Prom wgrano nie z Elbuz i nie ma w nim kodu produktu | Wyeksportuj katalog z Elbuz (dopasowanie) |
| Zamówienie anulowane na Prom, a w Elbuz nie | Zamówienie jest starsze niż 7 dni — przebieg już go nie czyta; albo menedżer zmienił status po anulowaniu | Zmień status ręcznie (co się aktualizuje) |
Jeśli przebieg się przerwał lub go zatrzymano
Przebieg Prom składa przeczytane strony w plikach tymczasowych i nie rusza bazy, dopóki nie przeczyta wszystkich stron. Ogólne zasady przerwania — w przeglądzie.
- Przerwanie podczas przeglądania stron — w bazie nic się nie pojawiło, znacznik „począwszy od daty” jest na miejscu. Następne uruchomienie przeczyta ten sam przedział.
- „Zatrzymaj” działa przed następną stroną: w dzienniku „Operacja przerwana przez użytkownika!”, przeczytane jest odrzucane, do bazy nic nie trafia.
- Przerwanie podczas zapisu — zostaje to, co zdążyło się zapisać: klienci, produkty, dokumenty, wiersze, a na końcu — znacznik daty. Powtórzenie przeczyta ten sam przedział, istniejące dokumenty rozpozna po numerze i ich nie zdubluje.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Jeśli zaimportowano nie to
Powiedzmy, że szablon uruchomiono z cudzym tokenem. Wszystko, co utworzył przebieg, jest oznaczone źródłem — ogólna kolejność wycofania:
| Co usunąć | Gdzie szukać |
|---|---|
| Dokumenty | lista dokumentów, filtr po kolumnach „Źródło: nazwa”, „Źródło (kod)” lub „Źródło: ID” |
| Karty produktów | katalog bazowy, kolumny „Źródło: kod”, „Źródło: nazwa”, „Źródło: ID”; poza tym wszystkie nowe karty leżą w kategorii technicznej „Produkty - evo_market - nazwa szablonu” |
| Kontrahenci | słownik kontrahentów, kolumny „Źródło — kod” i „Źródło — nazwa” |
Dokumenty usunięte partią trafiają do „Kosza dokumentów”, przycisk „Cofnij” przywraca partię w ciągu 30 dni. Zatwierdzonych dokumentów masowe usuwanie nie rusza: „Nie usunięto zatwierdzonych dokumentów (N). Najpierw anuluj zatwierdzenie.”
Usunięcie dokumentów nie cofa znacznika „począwszy od daty”: zamówienia z ostatnich 7 dni następny przebieg zaimportuje ponownie, starsze — nie. Usunięto przez pomyłkę — przywróć partię z „Kosza dokumentów”, dopóki nie minęło 30 dni.
Najczęstsze pytania
Dlaczego nie importują się produkty z Prom?
Ta integracja przynosi tylko zamówienia. Katalog Prom importuje się osobno — importem XLSX (EVO) lub przez XML.
Czy status zamówienia na Prom zmienia się, gdy obsługuję je w Elbuz?
Tak, jeśli Twoje statusy są dopasowane do kodów Prom (status na Prom). Przełącznik „Przekazywać status zamówienia do marketplace’u” jest domyślnie włączony; po jego wyłączeniu status zostaje w Elbuz. Zmiany na Prom w już zaimportowanym zamówieniu przychodzą, dopóki ma ono nie więcej niż 7 dni.
Zamówienia pojawiają się z opóźnieniem — dlaczego?
Prom nie wysyła natychmiastowych powiadomień: Elbuz pobiera zamówienia co 5 minut, więc opóźnienie wynosi zwykle do 5 minut. Dłuższe bywa, gdy w tym momencie szedł inny import, także ręczny: przebieg jest pomijany do następnego (automatyczny import).
Jak długo jest ważny token Prom?
Od jednego dnia do jednego roku — termin ustawiasz przy tworzeniu. Przed jego końcem przedłuż token na koncie Prom albo wklej nowy token do szablonu.
Czy można ponownie przeczytać zamówienia od dowolnej daty?
Tak. Wpisz datę w pole „Import zamówień począwszy od daty” w sekcji „Zaawansowane” — następny przebieg przeczyta zamówienia od niej (zakres przebiegu).
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Import danych → szablon typu „API - prom.ua, satu.kz”
- Uprawnienia
- okno „Import danych” w „Uprawnieniach grup”
- Przygotuj
- token z konta firmy w Prom
Jeden szablon — jedno połączenie z jednym kontem Prom. Karty z opcjami „Co importować” w szablonie Prom nie ma: integracja zawsze pobiera zamówienia i tylko je.
1
Pole „Token”- Pole „Token” — wklej token API wydany na Twoim koncie Prom.ua.
Powiązane tematy
- Jeśli chcesz wgrać na Prom katalog z Elbuz, żeby zamówienia trafiały na Twoje karty, — eksport na Prom w XLSX.
- Jeśli zamówienie przypisało się do niewłaściwego klienta — import zamówień przez API.
- Jeśli asortyment Prom trzeba przenieść do Elbuz — import XLSX (EVO).
- Jeśli klienci piszą do Ciebie na Prom — wiadomości klientów w zgłoszeniach.
- Jeśli zastanawiasz się, co Elbuz daje sprzedawcy na Prom, — integracja z Prom.
