↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz

    Jak importować zamówienia z marketplace’ów i systemów przez API

    21 min czytaniaZaktualizowano

    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ń

    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ń.
    Systemy, które przynoszą zamówienia
    SystemCo to jest i co jest potrzebne
    Kaspi.kzmarketplace nr 1 w Kazachstanie; potrzebny token z panelu sprzedawcy
    Prom.ua (EVO)marketplace nr 1 na Ukrainie, rodzina EVO; potrzebny token z panelu
    Epicentrmarketplace epicentrk.ua; potrzebny token z panelu sprzedawcy
    EVA.UAmarketplace EVA Marketplace; potrzebne login i hasło do panelu sprzedawcy
    Kastamarketplace kasta.ua; potrzebny token z panelu Kasta HUB
    Forte KZmarketplace Forte Market (Kazachstan); potrzebny klucz API
    ceneo.plplatforma w Polsce; potrzebny klucz dostępu (wymieniany na token)
    dotykackakasa/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.

    1. Zamówienia są pobierane z marketplace’u — nowe lub zmienione, od miejsca, w którym ostatnio się zatrzymano.
    2. Wyszukiwany jest klient wśród Twoich kontrahentów; jeśli go nie ma — powstaje nowy.
    3. Pozycje są dopasowywane do katalogu — każdy wiersz zamówienia szuka swojego produktu.
    4. Statusy są przekładane na Twoje: status zamówienia, płatności, dostawy, rodzaj płatności.
    5. Powstaje dokument „Zamówienie klienta” z własnym numerem według Twojej numeracji.
    6. Zapisywane są pozycje dokumentu, numer listu przewozowego (), waga i jednostki miary.
    7. Zamówienie trafia na tablicę (lejek) zgodnie ze swoim statusem.
    Ten sam proces z dwoma rozwidleniami, z których bierze się większość pytań: żółty romb oznacza, że dalsza droga zależy od tego, czy znaleziono dopasowanie
    TakNieTakNie, kategoria jest wzamówieniuNie, brak kategoriiZamówienie jest pobierane zmarketplace’u —nowe lub zmienioneKlient znalezionywśród kontrahentów?Zamówienie trafiado istniejącego kontrahentaPowstaje nowy kontrahentKażda pozycja szukaswojego produktu w kataloguProdukt znaleziony?Pozycja trafiana istniejącą kartęNowa kartaw tej kategoriiNowa karta w kategorii technicznej:ukrytej, wyłączonej z eksportówStatusy są przekładane na TwojePowstaje dokument „Zamówienieklienta”z numerem według Twojej numeracjiZamówienie trafia na tablicęwedług swojego statusu
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді

    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-67 i 380501234567 to jeden numer;
    • w skrzynkach Gmail pomijane są kropki w nazwie i wszystko po „plusie”: jan.kowalski+shop@gmail.com i jankowalski@gmail.com to 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:

    KrokPo czym szukamy
    1po adresie e-mail
    2po telefonie
    3po Telegramie
    4po identyfikatorze klienta w tym samym źródle (powiązanie utworzone przy wcześniejszych importach)
    5po 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:

    KrokPo czym dopasowujemy pozycję
    1po powiązaniu produktu z tym źródłem (powstaje, gdy importujesz katalog)
    2po wewnętrznym kodzie produktu (uuid)
    3po odcisku kontrolnym produktu
    4po kodzie produktu razem z nazwą
    5po samej nazwie
    6po 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:

    1. wbudowana tabela marketplace’u — jest w Prom, Epicentr, Kaspi i Forte;
    2. 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ę;
    3. 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;
    4. słowa kluczowe w kodzie lub nazwie — według tabeli poniżej, od góry do dołu.
    Słowo w kodzie lub nazwie statusuTwó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.

    Karta „Powiązane ustawienia” szablonu importu Kaspi z przyciskami dopasowania
    1Statusy zamówienia
    2Statusy płatności
    1. Statusy zamówienia — dopasowuje statusy zamówień marketplace’u do statusów Twoich dokumentów.
    2. 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:

    Lista zamówień z dwiema kolumnami statusu obok siebie: nasz status i status marketplace’u
    1Status (nasz)
    2Status dokumentu (sklep)
    1. Status — nasz własny status zamówienia, prowadzony przez menedżera.
    2. 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łoCo 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 — nieTwó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 marketplaceAnulowanie 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 przekazujeStatus 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”.

    Co dzieje się z już zaimportowanym zamówieniem przy ponownym przebiegu: lewa gałąź — źródła, które go nie aktualizują, prawa — reguła dla Twojego statusu i zdarzenie zmiany
    NieTakNie — dotykacka, ceneoTak — pozostałe źródłaTakTakNieNieTak i jest dla niegodopasowanieNie — status ustawiłoperator,a w źródle jest ten samTakNieZamówienie przyszło ze źródłaCzy w Elbuz jest już dokumentz tym numerem zamówieniaz tego źródła?Powstaje nowy dokument,status źródła zostaje zapamiętanyCzy źródło aktualizujeistniejące zamówienia?Dokument się nie zmieniaDokument zatwierdzony?Na marketplace zamówienieanulowano, zwrócono,wydano lub dostarczono — i statuszmienił się od ostatniego importu?Status zostaje zastąpiony,rezerwacja jest zdejmowanaStatus w źródle zmienił sięod ostatniego importuLUB nikt nie zmieniał Twojegostatusu?Twój status zostaje zastąpionydopasowanymTwój status zostajeStatus źródła zostaje zapamiętany,płatność i dostawa aktualizują się,jeśli mają dopasowanieCzy coś w dokumencie sięzmieniło?Nowa „Data aktualizacji”,wyzwalacze, Flows,documents.updatedBez daty i zdarzeń
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді

    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.kzProm.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, archiwumBez ograniczenia daty: Elbuz przegląda strony, dopóki marketplace je zwraca
    Kolejne importyZamó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 dniWszystkie zamówienia od początku dnia, w którym utworzono ostatnie zaimportowane
    Rozmiar stronyDo 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”.

    Nagłówek formularza szablonu importu „Mój sklep Kaspi” z plakietką stanu
    1Plakietka stanu szablonu
    1. 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.

    1. 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”.
    2. 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.
    3. 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

    Częste problemy i ich rozwiązania
    Co widziszDlaczego tak jestCo 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

    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