Program do obsługi zamówień Elbuz pobiera zamówienia z marketplace’ów, systemów CRM i kas przez API i zbiera je w jednej liście dokumentów — bez ręcznego przepisywania.
Kiedy to się przyda:
- Sprzedajesz na kilku platformach — wszystkie zamówienia stają się dokumentami „Zamówienie klienta” z Twoją numeracją.
- Klient kupuje w różnych kanałach — Elbuz go rozpoznaje i nie tworzy duplikatów.
- Marketplace’y mają własne nazwy statusów — tabele dopasowania sprowadzają je do Twoich.
- Menedżer prowadzi zamówienia we własnych statusach — import nie nadpisuje ustawionego przez niego statusu, a płatność i dostawę pobiera z marketplace’u.
Od czego zacząć: znajdź swój marketplace na liście i otwórz jego artykuł — tam są klucze i szczegóły.
Co potrafi import zamówień
- Wyszukiwanie klienta — zamówienie trafia do istniejącego kontrahenta, a nowego tworzy tylko wtedy, gdy nikogo nie znaleziono.
- Dopasowanie pozycji do katalogu — każdy wiersz szuka swojego produktu, a nieznany nie ginie, tylko staje się kartą.
- Dopasowanie statusów — status zamówienia, płatności, dostawy i rodzaj płatności są przekładane na Twoje.
- Ochrona pracy menedżera — status ustawiony przez menedżera zmienia się dopiero po nowej zmianie na marketplace.
- Automatyczny import bez duplikatów — marketplace’y Elbuz odpytuje sam co 5 minut, pamięta, dokąd doszedł, i rozpoznaje już zaimportowane zamówienie.
Zamówienia przychodzą z dwóch typów źródeł:
- Integracje katalogowe, które obsługują i produkty, i zamówienia: Rozetka, Shopify, WooCommerce, Amazon, eBay, Allegro, eMAG, a także SalesDrive. Zamówienia włącza się w nich osobnym przełącznikiem w szablonie — szczegóły w artykułach o poszczególnych platformach i w przeglądzie importu katalogu przez API.
- Systemy, które przynoszą tylko zamówienia: marketplace’y Kaspi.kz, Prom.ua (rodzina EVO), Epicentr, EVA.UA, Kasta, Forte KZ, ceneo.pl, kasa dotykacka. Produkty z nich nie trafiają do katalogu — przychodzą wyłącznie jako wiersze samych zamówień.
| System | Co to jest i co jest potrzebne |
|---|---|
| Kaspi.kz | marketplace nr 1 w Kazachstanie; potrzebny token z panelu sprzedawcy |
| Prom.ua (EVO) | marketplace nr 1 na Ukrainie, rodzina EVO; potrzebny token z panelu |
| Epicentr | marketplace epicentrk.ua; potrzebny token z panelu sprzedawcy |
| EVA.UA | marketplace EVA Marketplace; potrzebne login i hasło do panelu sprzedawcy |
| Kasta | marketplace kasta.ua; potrzebny token z panelu Kasta HUB |
| Forte KZ | marketplace Forte Market (Kazachstan); potrzebny klucz API |
| ceneo.pl | platforma w Polsce; potrzebny klucz dostępu (wymieniany na token) |
| dotykacka | kasa/POS (sprzedaż punktu stacjonarnego jako zamówienia); potrzebne instancji i token |
Lista w samym oknie importu może być szersza od tej i jest uzupełniana. Zamówienia z własnej strony przynoszą też moduł OpenCart 3 i Horoshop.
Połączenie z PrivatBankiem (Autoklient) jest na tej samej liście, ale przynosi nie zamówienia, tylko wpływy bankowe — wyciąg z rachunku, z którego powstają dokumenty płatności. To osobny temat (uzgadnianie płatności), nie import zamówień.
Po co to firmie, opisaliśmy osobno: co to daje Twojemu sklepowi.
Co dzieje się z zamówieniem krok po kroku
Choć marketplace’y są różne, wszystkie zamówienia przechodzą w Elbuz przez ten sam proces. Właśnie tu widać, dlaczego klient „przykleił się” do istniejącego kontrahenta, skąd wziął się numer dokumentu i dlaczego w zamówieniu może brakować pozycji.
- Zamówienia są pobierane z marketplace’u — nowe lub zmienione, od miejsca, w którym ostatnio się zatrzymano.
- Wyszukiwany jest klient wśród Twoich kontrahentów; jeśli go nie ma — powstaje nowy.
- Pozycje są dopasowywane do katalogu — każdy wiersz zamówienia szuka swojego produktu.
- Statusy są przekładane na Twoje: status zamówienia, płatności, dostawy, rodzaj płatności.
- Powstaje dokument „Zamówienie klienta” z własnym numerem według Twojej numeracji.
- Zapisywane są pozycje dokumentu, numer listu przewozowego (), waga i jednostki miary.
- Zamówienie trafia na tablicę (lejek) zgodnie ze swoim statusem.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Dokument powstaje jako niezatwierdzony: sam w sobie nie zdejmuje towaru ze stanu i go nie rezerwuje. Co z nim robić dalej — w artykule o zamówieniu klienta.
Jak znajdowany jest klient
Zanim utworzy nowego kontrahenta, Elbuz próbuje rozpoznać istniejącego. Do porównania adres e-mail i telefon są sprowadzane do wspólnej postaci:
- wielkość liter nie ma znaczenia;
- z telefonu brana jest tylko część cyfrowa:
+38 (050) 123-45-67i380501234567to jeden numer; - w skrzynkach Gmail pomijane są kropki w nazwie i wszystko po „plusie”:
jan.kowalski+shop@gmail.comijankowalski@gmail.comto jedna osoba.
Sprowadzanie do wspólnej postaci działa tylko przy porównaniu. W karcie kontrahenta i w samym zamówieniu zapisywany jest adres podany przez klienta — z kropkami i wielkimi literami. Właśnie na niego trafią Twoje wiadomości.
Dalej klient jest wyszukiwany po kolei, a pierwsze trafienie kończy wyszukiwanie:
| Krok | Po czym szukamy |
|---|---|
| 1 | po adresie e-mail |
| 2 | po telefonie |
| 3 | po Telegramie |
| 4 | po identyfikatorze klienta w tym samym źródle (powiązanie utworzone przy wcześniejszych importach) |
| 5 | po zewnętrznym identyfikatorze kontrahenta w karcie |
Jeśli nikogo nie znaleziono, powstaje nowy kontrahent: nazwa jest brana z firmy (a gdy jej brak — z imienia i nazwiska), wypełniane są telefon, e-mail, miasto i adres, i od razu tworzone jest powiązanie z tym źródłem. Następnym razem ten sam klient zostanie rozpoznany po nim, nawet jeśli zmieni e-mail. Gdy w zamówieniu nie ma żadnego identyfikatora klienta, Elbuz tworzy go sam z adresu e-mail i telefonu.
Niektóre strony wstawiają do zamówień „jednym kliknięciem” własny adres sklepu — wtedy wszystkie takie zamówienia skleiłyby się w jednego kontrahenta. Do tego służą wspólne listy wyjątków: wymienione w nich adresy i numery telefonów są pomijane przy wyszukiwaniu kontrahenta.
Jak pozycje znajdują produkt w katalogu
Każdy wiersz zamówienia przechodzi wyszukiwanie — od najpewniejszego sposobu do najogólniejszego:
| Krok | Po czym dopasowujemy pozycję |
|---|---|
| 1 | po powiązaniu produktu z tym źródłem (powstaje, gdy importujesz katalog) |
| 2 | po wewnętrznym kodzie produktu (uuid) |
| 3 | po odcisku kontrolnym produktu |
| 4 | po kodzie produktu razem z nazwą |
| 5 | po samej nazwie |
| 6 | po ID produktu w Elbuz, które marketplace zwrócił w zamówieniu (przekazuje je Twój feed) — tylko jeśli to ID jest liczbowe |
Jeśli produktu nie znaleziono, nie ginie on: Elbuz tworzy dla niego kartę.
- Takie same pozycje z różnych zamówień jednego przebiegu dostają jedną wspólną kartę. Produkty są rozróżniane po ID na marketplace, a bez niego — po kodzie produktu razem z nazwą (w ceneo.pl, który nie przekazuje ani ID, ani kodu, — w praktyce po nazwie).
- Kategoria jest brana z samego zamówienia — po nazwie lub kodzie zewnętrznym. Niektóre źródła (m.in. Kaspi i Prom) nie przekazują kategorii w wierszu i wtedy pozycja trafia do kategorii technicznej „Produkty — źródło — nazwa połączenia”.
- Kategoria techniczna powstaje jako ukryta i wyłączona z eksportów, żeby niepełne karty nie trafiły do Twoich kanałów sprzedaży.
Karta utworzona z wiersza zamówienia zawiera tylko nazwę, kod produktu, cenę i ilość — bez opisu, zdjęć i parametrów. Od czasu do czasu przenoś znalezione tam produkty do właściwej gałęzi i uzupełniaj je albo dopasowuj do istniejących kart.
Od znalezionego produktu pozycja przejmuje wagę z karty, jeśli w zamówieniu jej nie ma, a jednostka miary jest ustalana po nazwie; jeśli nie zostanie rozpoznana, wstawiana jest sztuka. Waga jest potrzebna do wyliczenia przesyłki.
Jak dopasować statusy marketplace’u do Twoich
Każdy marketplace ma własne nazwy statusów zamówienia. Elbuz sam sprowadza je do Twoich, po kolei, do pierwszego trafienia:
- wbudowana tabela marketplace’u — jest w Prom, Epicentr, Kaspi i Forte;
- ręczna tabela „Statusy zamówienia” tego szablonu — po kodzie, po nazwie albo po wierszu, w którym po przecinku wymieniono kilka statusów zewnętrznych; reguły innych szablonów nie są brane pod uwagę;
- dokładne trafienie kodu lub nazwy statusu marketplace’u w Twój status — nazwa jest porównywana w każdym z języków programu;
- słowa kluczowe w kodzie lub nazwie — według tabeli poniżej, od góry do dołu.
| Słowo w kodzie lub nazwie statusu | Twój status |
|---|---|
| unpaid, не оплач, очікує оплати | Oczekuje na płatność |
| cancel, скасов | Anulowano |
| refund, повернення коштів | Zwrot środków |
| return, поверн | Zwrócono |
| delivered, received, отриман | Dostarczono |
| shipped, відправлен | Wysłano |
| complete, виконан | Zrealizowano |
| paid, оплачен | Opłacono |
| confirm, accept, підтвердж | Potwierdzenie |
| process, оброб | W trakcie obsługi |
| new, pending, очіку | Nowy |
Jeśli status nie zostanie rozpoznany żadnym sposobem, zamówienie dostaje „Nowy”.
Jak dopasowano statusy, widać w oknie „Statusy zamówienia” otwartym z formularza szablonu. Blok „Statusy marketplace’u w pobranych zamówieniach” pokazuje każdy status marketplace’u, liczbę zamówień, które z nim przyszły, Twój status i skąd się wziął: „wbudowana tabela marketplace’u”, „z tabeli”, „po nazwie” lub „nierozpoznany — «Nowy»”. Jeśli się nie zgadzasz, wpisz kod lub nazwę statusu marketplace’u w wierszu właściwego statusu tabeli.
Osobno dopasowuje się status płatności, status dostawy, rodzaje płatności i rodzaje dostawy — każdą tabelę ustawia się własnym przyciskiem w karcie „Powiązane ustawienia” w formularzu szablonu: „Statusy zamówienia”, „Statusy dostawy”, „Statusy płatności”, „Rodzaje płatności”, „Rodzaje dostawy” (są w Kaspi, Prom, Forte i na platformach katalogowych, takich jak Rozetka). Status zewnętrzny bez odpowiednika nie powoduje utraty zamówienia: dostaje ono status domyślny.
1
Statusy zamówienia2
Statusy płatności- Statusy zamówienia — dopasowuje statusy zamówień marketplace’u do statusów Twoich dokumentów.
- Statusy płatności — dopasowuje statusy płatności marketplace’u do Twoich statusów płatności.
Razem ze statusami do dokumentu trafiają dane techniczne dostawy: jeśli marketplace przekazał numer listu przewozowego, trafia on do pola swojego przewoźnika (Nova Poshta, Justin, Ukrposhta), a zamówienie można od razu śledzić z Elbuz.
Dwa statusy jednego zamówienia: Twój i marketplace’u
- Twój status — kolumna „Status” na liście zamówień i status w karcie dokumentu. Prowadzi go menedżer: potwierdził, kompletuje, wysłał.
- Status na marketplace — to, co o zamówieniu „myśli” Rozetka, Prom czy Kaspi. Widać go w sąsiedniej kolumnie „Status dokumentu (sklep)”.
Obie kolumny stoją obok siebie, więc rozbieżność widać bez wchodzenia do panelu marketplace’u. W przykładzie poniżej menedżer jeszcze nie wziął zamówienia do realizacji (u nas „Nowy”), a marketplace trzyma je w oczekiwaniu:
1
Status (nasz)2
Status dokumentu (sklep)- Status — nasz własny status zamówienia, prowadzony przez menedżera.
- Status dokumentu (sklep) — status zamówienia na marketplace, przechowywany osobno.
Kto kogo nadpisuje: Twój status czy marketplace’u
Zamówienie żyje w dwóch systemach i zmieniać je mogą obie strony. Reguła dla Twojego statusu: import zmienia go, jeśli status w źródle zmienił się od ostatniego importu albo nikt jeszcze nie zmieniał Twojego statusu po imporcie. Status ustawiony przez menedżera zostaje, dopóki źródło trzyma ten sam.
„Zmieniał” oznacza każdą zmianę statusu: w oknie, przez proces, zbiorczym oznaczeniem lub samym importem.
| Co się stało | Co będzie po następnym imporcie |
|---|---|
| Marketplace zmienił status, a zamówienia u siebie nikt nie ruszał | Twój status zaktualizuje się zgodnie z dopasowaniem |
| Status zmieniono u Ciebie, na marketplace — nie | Twój status zostanie. Import go nie rusza |
| Zamówienie zaimportowano, zanim wypełniono dopasowanie, i nikt go nie ruszał | Po wypełnieniu dopasowania status i płatność zostaną pobrane przy następnym imporcie, nawet jeśli na marketplace nic się nie zmieniło |
| Ustawiono „W trakcie obsługi”, a z marketplace’u przyszła płatność | Status zamówienia zostaje Twój, a status płatności zaktualizuje się z marketplace’u — to różne pola, nie kolidują ze sobą |
| Zmieniono status na „Skompletowano”, a klient anulował zamówienie na marketplace | Anulowanie wygra — raz, w chwili zmiany na marketplace. Kolejne importy go nie powtarzają, dalej zamówienie znów prowadzisz Ty |
| Status dostawy prowadzi śledzenie przesyłek przewoźnika, a marketplace statusu dostawy nie przekazuje | Status dostawy zostanie. Domyślny status dostawy („Oczekiwanie od nadawcy”) dostają tylko nowe zamówienia |
| Zamówienie jest już zatwierdzone (podpisane) | Twój status zostaje, z jednym wyjątkiem: jeśli na marketplace zamówienie anulowano, zwrócono, wydano lub dostarczono, zatwierdzone zamówienie dostanie odpowiedni status, a jego rezerwacja zostanie zdjęta. Inne zmiany statusu na marketplace nie ruszają zatwierdzonego zamówienia |
Płatność, dostawa, rodzaj płatności i rodzaj dostawy są zawsze brane ze źródła, jeśli mają dopasowanie. Bez dopasowania pole zostaje takie, jakie było.
Tabela powyżej dotyczy Kaspi.kz, Prom.ua, Forte KZ, Horoshop, Epicentr, Rozetka, Kaufland, tunelu, API v2 (POST /orders/sync) oraz integracji katalogowych, gdy pobierają zamówienia zmienione od daty ostatniego importu. W Kaspi, Prom, Forte i Horoshop ponowny import zmienia tylko statusy — zamówienia, płatności i dostawy; pozostałe pola dokumentu zostają Twoje.
Anulowanie z Kaspi, Prom i Horoshop dociera tylko wtedy, gdy zamówienie ma nie więcej niż 7 dni: żeby je zobaczyć, te szablony za każdym razem czytają ponownie zamówienia z ostatnich 7 dni. Forte KZ czyta ponownie ostatni tysiąc zamówień. Jeśli anulowano starsze zamówienie, status dokumentu zmienia się ręcznie.
Szablony dotykacka i ceneo.pl w ogóle nie aktualizują już zaimportowanych zamówień: anulowań nie wysyłają, każde zamówienie przychodzi jako „Opłacono”.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Data aktualizacji i zdarzenie zmiany dokumentu
Zamówienie, w którym import coś zmienił — status, płatność, dostawę, status na marketplace — dostaje nową datę aktualizacji i zdarzenie „Dokument: aktualizacja”. Reagują na nie wyzwalacze, procesy (Flows) i webhook documents.updated. Jeśli zamówienie przyszło takie samo, jak było, — nie ma ani nowej daty, ani zdarzeń.
Marketplace’y, które przyjmują status z powrotem (na przykład Rozetka), dostają go, gdy przesuwasz zamówienie u siebie. Ten sam status nie jest wysyłany ponownie, a własna wysyłka nie wraca do Ciebie jak echo.
Zamówienie zniknęło z marketplace’u
Import zamówień nigdy nie usuwa dokumentów. Jeśli zamówienie na marketplace usunięto, ukryto lub przeniesiono do archiwum — dokument w Elbuz zostaje:
- w dotykacka i ceneo po pierwszym imporcie w ogóle się nie zmienia;
- w pozostałych źródłach aktualizuje się według tabeli powyżej, dopóki źródło zwraca to zamówienie; jeśli go nie zwraca — nic się nie stanie.
Ponowny import nie rusza pozycji w już utworzonym dokumencie: wiersz usunięty ręcznie nie zostanie dopisany z powrotem.
Automatyczny import i harmonogram
Prawie wszystkie te systemy działają na zasadzie odpytywania (polling): Elbuz sam zwraca się do nich po nowe zamówienia. Webhook (marketplace natychmiast przesyła zamówienie do Ciebie) mają tylko niektóre integracje — Shopify, Wix, SalesDrive. Jak często:
- Marketplace’y — same, co 5 minut. Zadanie systemowe „Zamówienia z marketplace’ów” po kolei pobiera zamówienia wszystkich aktywnych szablonów z kluczem lub powiązaniem aplikacji. Prom, Epicentr, EVA.UA, Kasta, Kaspi, Forte — zawsze; Rozetka, Allegro, Amazon, eBay, eMAG, Etsy, Kaufland, Bol, Cdiscount, Mirakl, OTTO, Newegg, ManoMano, Walmart, Zalando, TikTok — jeśli w szablonie zaznaczono „Zamówienia”. Katalog i opinie nie są importowane w tym przebiegu, dla nich obowiązuje harmonogram szablonu.
- Pozostałe systemy — według harmonogramu szablonu (albo webhookiem, gdzie jest dostępny): OLX, Horoshop, Wix, Shopify, WooCommerce, SalesDrive, Odoo, ceneo, dotykacka. Harmonogram ustawia się przyciskiem „Ustawienia harmonogramu” w formularzu szablonu: aktywnemu sklepowi — kilkanaście razy dziennie, spokojnemu — rzadziej.
Zadanie „Zamówienia z marketplace’ów” widać w oknie „Harmonogram zadań” (typ „Import produktów”), tam też zmienia się interwał. Nie wyłączaj ani nie usuwaj go: zamówienia z marketplace’ów przestaną przychodzić.
Jeśli trwa inny import, w tym ręczny, przebieg jest po cichu pomijany, a zamówienia pobierze następny. Przebieg nie przelicza formuł produktów.
Żeby nie pobierać tego samego dwa razy, Elbuz zapamiętuje datę i numer ostatniego zaimportowanego zamówienia. Obie wartości widać w formularzu szablonu, w bloku „Zaawansowane”: pola „Import zamówień począwszy od ID” i „Import zamówień począwszy od daty (RRRR-MM-DD)”.
- Zmień je i zapisz szablon — następny przebieg ruszy od nowej wartości w granicach, które wyznacza marketplace (Kaspi kieruje się tylko datą i nie sięga dalej niż 14 dni wstecz).
- Puste pole kasuje zapamiętane miejsce.
- Każdy dokument przechowuje identyfikator zamówienia na marketplace — po nim istniejące już zamówienie jest rozpoznawane i nie jest duplikowane.
Każde uruchomienie zostawia ślad w dzienniku: „Pobrano zamówień” — ile przyszło z marketplace’u, „Łącznie zaimportowano zamówień” — ile stało się nowymi dokumentami, a także błędy.
Importy idą po jednym. Szablon według harmonogramu nie startuje, jeśli trwa inny przebieg według harmonogramu: w dzienniku pojawia się „Anulowano import według harmonogramu, przyczyna - trwa import innego szablonu (konflikt przetwarzania danych).”. Na przebieg zamówień czeka do 10 minut, ręczne uruchomienie nie zatrzymuje harmonogramu szablonu. Ogólne zasady — w przeglądzie importu danych.
Ile pobiera jeden przebieg
W Kaspi i Prom nie ma sztywnego limitu liczby zamówień: Elbuz przegląda strony, dopóki się nie skończą. Różnią się okres i stan zamówień:
| Kaspi.kz | Prom.ua | |
|---|---|---|
| Pierwszy import (data ostatniego zamówienia w szablonie jest pusta) | Zamówienia utworzone w ciągu ostatnich 14 dni, osobno w każdym z sześciu stanów Kaspi: nowe, do podpisania, odbiór osobisty, dostawa, Kaspi Dostawa, archiwum | Bez ograniczenia daty: Elbuz przegląda strony, dopóki marketplace je zwraca |
| Kolejne importy | Zamówienia we wszystkich tych samych sześciu stanach, utworzone od daty ostatniego zaimportowanego zamówienia do końca bieżącego dnia. Jeśli ta data jest starsza niż 14 dni, brane są tylko ostatnie 14 dni | Wszystkie zamówienia od początku dnia, w którym utworzono ostatnie zaimportowane |
| Rozmiar strony | Do 1000 zamówień | 100 zamówień, między stronami — przerwa jednej sekundy |
Wynika z tego konsekwencja dla Kaspi: jeśli Elbuz długo nie pobierał zamówień (szablon był wyłączony, klucz wygasł), zamówienia starsze niż 14 dni już nie przyjdą. Dla każdego zamówienia Kaspi Elbuz osobno pobiera pozycje, a dla każdej pozycji — jeszcze dwa zapytania o produkt; limit to 20 sekund na połączenie i 2 minuty na odpowiedź. Dla Prom Elbuz nie ustawia własnego limitu czasu.
Zatrzymanie jest sprawdzane przed każdym zapytaniem o listę zamówień (w Prom — przed każdą stroną). W Kaspi strony pobrane przed zatrzymaniem i tak są zapisywane, a data ostatniego zamówienia przesuwa się na najnowsze z nich. W Prom przebieg przerwany w trakcie przeglądania stron nie zapisuje niczego, a następny pobierze te same zamówienia jeszcze raz. Tak samo Prom odrzuca cały przebieg, jeśli marketplace nie zwrócił kolejnej strony.
Wyłączyć szablon czy usunąć
Szablony Kaspi, Prom, Epicentr, Forte i połączeń uniwersalnych (dotykacka, ceneo) nie mają osobnego przełącznika „Zamówienia”: taki szablon przynosi wyłącznie zamówienia. Zatrzymuje się go przełącznikiem stanu w nagłówku formularza — „Aktywny” / „Wyłączony”.
1
Plakietka stanu szablonu- Plakietka stanu szablonu — pokazuje, czy szablon jest aktywny, czy wyłączony; kliknięcie od razu przełącza stan.
- Wyłączony szablon jest pomijany przez harmonogram, ale przycisk „Importuj” działa. Dokumenty, kontrahenci i powiązania zostają. Po ponownym włączeniu przebieg ruszy od daty ostatniego zaimportowanego zamówienia (w Kaspi — nie dalej niż 14 dni wstecz).
- Usunięty szablon znika z listy razem z harmonogramem. Dokumenty, kontrahenci i produkty, które utworzył, zostają. Nowy szablon dla tego samego marketplace’u nie zdubluje zamówień: dokument jest rozpoznawany po numerze zamówienia i kodzie marketplace’u, a nie po szablonie.
Jeśli import poszedł nie tak
Przebiegu nie da się cofnąć jednym przyciskiem, ale wszystko, co utworzył, jest oznaczone szablonem źródłowym, więc skutki usuwa się hurtowo.
- Zbędne dokumenty. Na liście zamówień włącz kolumnę „Źródło: ID” (numer szablonu) i przefiltruj po niej, w razie potrzeby także po dacie utworzenia. Zaznacz dokumenty i usuń je. Zatwierdzone dokumenty nie są usuwane z partii — program poda, ile takich zostało; najpierw cofnij zatwierdzenie. Usunięte dokumenty leżą 30 dni w „Koszu dokumentów”, a zaraz po usunięciu w komunikacie jest przycisk „Cofnij”.
- Zbędni kontrahenci. Na liście kontrahentów przefiltruj po kolumnie „Źródło — nazwa” (nazwa szablonu) i usuń ich — trafiają do „Kosza”. Kontrahent w koszu nie znika z bazy i następny import może znów przypisać do niego zamówienie po adresie e-mail lub telefonie.
- Karty produktów utworzone z wierszy zamówień wyfiltrujesz kolumną „Źródło: ID” na liście produktów. Wiersz dokumentu przechowuje własną kopię nazwy, kodu produktu i ceny.
Data i numer ostatniego zamówienia w szablonie nie wracają same po porządkach. Żeby zacząć od innego miejsca, zmień pola „Import zamówień począwszy od ID” i „Import zamówień począwszy od daty (RRRR-MM-DD)” w bloku „Zaawansowane”.
Scenariusze
Marketplace daje i katalog, i zamówienia
Zadanie. Podłączyć Rozetkę, Shopify lub inną platformę katalogową tak, żeby pozycje zamówień trafiały na Twoje karty.
Co zrobić. Najpierw zaimportuj katalog, potem włącz przełącznik zamówień w tym samym szablonie. Pierwszy import sprawdź na kilku zamówieniach: pozycje, kwoty, klient, status.
Efekt. Każdy produkt ma powiązanie ze źródłem, pozycje są dopasowywane od pierwszego kroku, bez przypadkowych trafień po nazwie, a kategoria techniczna nie zapełnia się duplikatami.
Menedżer prowadzi własne statusy, a anulowania z marketplace’u nie można przegapić
Zadanie. Pracować z zamówieniami we własnych statusach i widzieć, co dzieje się na marketplace.
Co zrobić. Wypełnij tabele dopasowania statusów w karcie „Powiązane ustawienia” i trzymaj na liście zamówień kolumnę „Status dokumentu (sklep)”.
Efekt. Anulowanie z marketplace’u raz przebije Twój status — nawet w zatwierdzonym zamówieniu, a jego rezerwacja zostanie zdjęta; przez resztę czasu status jest Twój. Jeśli przywrócisz anulowane zamówienie do realizacji, ten sam status marketplace’u nie anuluje go drugi raz. W dotykacka i ceneo rozbieżność widać tylko w panelu marketplace’u — status dokumentu zmienia się ręcznie.
Czego nie będzie. W Kaspi, Prom i Horoshop anulowanie zamówienia starszego niż 7 dni nie dotrze.
Kilka marketplace’ów — jedna kolejka
Zadanie. Obsługiwać zamówienia ze wszystkich marketplace’ów na jednej liście.
Co zrobić. Dla każdego konta utwórz osobny szablon z własnym kluczem. Harmonogram jest potrzebny tylko systemom, których nie odpytuje zadanie „Zamówienia z marketplace’ów”.
Efekt. Wszystkie zamówienia trafiają na jedną listę „Zamówienia” z Twoimi statusami; klient, który kupował na różnych marketplace’ach, jest rozpoznawany po adresie e-mail lub telefonie.
Dopasowanie wypełniono, gdy zamówienia już przyszły
Zadanie. Zamówienia ze strony lub marketplace’u mają status „Nowy” i brak płatności, bo tabele „Statusy zamówienia” i „Statusy płatności” były puste.
Co zrobić. Wypełnij obie tabele i poczekaj na następny import albo kliknij „Importuj”.
Efekt. W Epicentr, Rozetka, Kaufland, tunelu i API v2 zamówienia, które nadal trafiają do zakresu pobieranego ze źródła i których menedżer nie ruszał, dostaną status i płatność według dopasowania. Te, które są już w realizacji, zachowają status menedżera, ale płatność dostaną. Zamówienia spoza zakresu (w tunelu — zmienione na stronie ponad 7 dni temu) przestaw ręcznie.
Zaimportować okres ponownie po błędzie w dopasowaniu
Zadanie. Zamówienia przyszły z błędnymi statusami, bo tabela dopasowania była pusta. W Kaspi, Prom, Forte i Horoshop wystarczy wypełnić tabelę: zamówienia, które następny przebieg przeczyta ponownie, same pobiorą status. Ponownie importować trzeba dotykacka i ceneo, a także zamówienia Kaspi, Prom i Horoshop starsze niż 7 dni.
Co zrobić. Wypełnij tabelę, usuń dokumenty przebiegu filtrem po „Źródło: ID”, zmień pola „Import zamówień począwszy od ID” i „…od daty” w „Zaawansowane” i uruchom szablon.
Efekt. Zamówienia przyjdą od nowa, już z poprawnymi statusami. W Kaspi okres nie może być starszy niż 14 dni.
Co zrobić, gdy zamówienia przychodzą nie tak
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Wszystkie zamówienia przychodzą z jednym statusem | Status zewnętrzny nie znalazł wiersza w tabeli dopasowania tego szablonu | Dodaj wiersze w „Statusy zamówienia” (dopasowanie) |
| Zamówienie przykleiło się do innego klienta | Strona wstawia własny adres e-mail sklepu lub wspólny numer | Dodaj adres lub numer do list wyjątków (wyszukiwanie klienta) |
| Klient anulował zamówienie na Kaspi lub Prom, a w Elbuz status jest stary | Zamówienie ma ponad 7 dni — szablon już go nie czyta ponownie; albo operator przywrócił anulowane zamówienie do realizacji | Zmień status dokumentu ręcznie (kto kogo nadpisuje) |
| Stare zamówienia Kaspi nie przyszły | Kaspi zwraca zamówienia nie starsze niż 14 dni | Nie zostawiaj szablonu Kaspi na długo wyłączonego (limity przebiegu) |
| Przebieg Prom zatrzymano — nowych zamówień nie ma | Przerwany przebieg Prom nie zapisuje niczego | Uruchom go jeszcze raz: pobierze te same zamówienia |
| Pozycje zamówień trafiają do kategorii technicznej | Produktu nie znaleziono w katalogu | Zaimportuj katalog z tego samego źródła albo przenieś karty (dopasowanie pozycji) |
| Dopasowanie wypełnione, a stare zamówienia nadal mają status „Nowy” | Dopasowanie działa podczas importu, a nie na już zapisanych dokumentach | Poczekaj na następny import; zamówienia spoza zakresu źródła przestaw ręcznie (scenariusz) |
| Nie ma kolumny „Status dokumentu (sklep)” | Kolumna jest za prawą krawędzią albo wyłączona | Przewiń tabelę w prawo albo włącz kolumnę w „Ustawieniach kolumn” okna |
Najczęstsze pytania
Czy trzeba najpierw zaimportować katalog, żeby pobierać zamówienia?
Nie, wiersze zamówień nie giną: nieznane produkty stają się kartami. Ale z katalogiem pozycje są dopasowywane dokładnie i bez duplikatów (scenariusz).
Czy zamówienia przychodzą natychmiast?
Prawie nigdzie: zamówienia z marketplace’ów Elbuz pobiera co 5 minut, z pozostałych systemów — według harmonogramu szablonu. Natychmiastowy odbiór webhookiem mają tylko niektóre integracje, np. Shopify i SalesDrive.
Czy import nadpisze status ustawiony przez menedżera?
Nie, dopóki na marketplace jest ten sam status co poprzednio. Jeśli status na marketplace się zmienił, Twój zaktualizuje się według dopasowania. Zatwierdzone zamówienie dostaje nowy status tylko wtedy, gdy na marketplace zostało anulowane, zwrócone, wydane lub dostarczone (tabela).
Wypełniono dopasowanie, a stare zamówienia się nie zmieniły — co robić?
Poczekać na następny import: zamówienia, które nadal trafiają do zakresu pobieranego ze źródła i których menedżer nie ruszał, dostaną status i płatność według dopasowania. Starsze niż ten zakres, a także zamówienia dotykacka i ceneo przestaw ręcznie.
Czy ponowny import zdubluje zamówienia?
Nie. Dokument przechowuje identyfikator zamówienia na marketplace i po nim już zaimportowane zamówienie jest rozpoznawane — nawet jeśli szablon usunięto i utworzono nowy.
Czy można podłączyć kilka marketplace’ów naraz?
Tak. Dla każdego konta — osobny szablon z własnym kluczem, a wszystkie zamówienia spływają do jednej kolejki. Marketplace’y są odpytywane same co 5 minut, pozostałe systemy potrzebują harmonogramu szablonu.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Import danych
- Gdzie widać zamówienia
- okno „Zamówienia”, dokumenty „Zamówienie klienta”
- Uprawnienia
- okno „Import danych” w uprawnieniach grup
- Co przygotować
- klucz dostępu z panelu marketplace’u — najczęściej jeden token
W oknie importu tworzysz szablon, wybierasz system z listy, wpisujesz klucz i włączasz import zamówień. Jeden szablon to jedno połączenie z jednym kontem; dla różnych kont lub marketplace’ów tworzy się osobne szablony.
Powiązane tematy
- Jeśli marketplace zwraca też produkty — Import katalogu przez API.
- Jeśli zamówienie trzeba zatwierdzić, zarezerwować i wysłać — Zamówienie klienta.
- Jeśli sprzedajesz na Kaspi — Import zamówień z Kaspi.kz; na Prom — Import zamówień z Prom.ua.
- Jeśli Twoja strona lub system księgowy ma sam wysyłać zamówienia — zamówienia sklepu przez API v2.
- Jeśli wybierasz CRM dla sklepu — co to daje Twojemu sklepowi.
