↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Jak podłączyć ukraińskie marketplace’y: co się importuje z każdego

    Jak importować zamówienia z Kasta do Elbuz

    5 min czytaniaZaktualizowano

    Elbuz sam pobiera zamówienia z konta sprzedawcy Kasta HUB przez API Kasta za pomocą tokena i zapisuje je jako dokumenty we wspólnej kolejce z innymi kanałami. Status i list przewozowy mogą wracać na Kasta.

    Kiedy to się przyda:

    • Katalog na Kasta idzie feedem z Elbuz — pozycje zamówień trafiają na Twoje karty produktów.
    • Menedżerowie nie chcą dwa razy zmieniać statusu — potwierdzenie, list przewozowy i anulowanie same docierają do Kasta.
    • Klient anulował zamówienie albo zwraca towar — status dokumentu zmienia się sam.

    Od czego zacząć: „Import danych” → „Dodaj” → typ „Kasta”, potem token z konta HUB.

    Co potrafi połączenie z Kasta

    • Zamówienia — klient, odbiorca, oddział Nova Poshta, list przewozowy, płatność i komentarz trafiają do dokumentu.
    • Dopasowanie do katalogu — pozycje znajdują Twoje karty po kodzie produktu i nazwie albo po numerze produktu z Twojego feedu.
    • Statusy Kasta — zamieniają się na Twoje bez konfiguracji, w tym anulowanie i zwrot.
    • Status z powrotem na Kasta — potwierdzenie, spakowanie, list przewozowy i anulowanie z powodem.
    • Harmonogram — co 5 minut, tylko zmienione zamówienia.

    Produktów, cen i stanów to połączenie nie przekazuje: asortyment trafia na Kasta feedem XML, a Kasta sama aktualizuje z niego ceny i dostępność.

    Jak połączyć Kasta tokenem

    1. W koncie Kasta HUB otwórz «Налаштування» (Ustawienia) → karta „API” i skopiuj token.
    2. W oknie „Import danych” kliknij „Dodaj” i wybierz typ „Kasta”. Przełączników „Co importować” w formularzu nie ma: połączenie obsługuje tylko zamówienia.
    3. Wklej token w pole „Token” karty „Połączenie”. Formularz zapisuje się sam.
    4. Kliknij „Sprawdź połączenie”. Sukces — „Połączenie działa. Kasta (nazwa Twojej organizacji)”. Niepowodzenie — „Połączenie nie powiodło się:” i odpowiedź Kasta.
    5. Szablon z plakietką „Aktywny” w ciągu 5 minut zacznie sam pobierać zamówienia, za pierwszym razem — z 30 dni. Nie chcesz czekać — kliknij „Importuj”.

    Z tokenem można czytać Twoje zamówienia i zmieniać ich statusy. Nie wysyłaj go na otwartych czatach. Jeśli usuniesz lub wymienisz token w HUB, wklej nowy w szablon, inaczej import będzie dostawał odmowę.

    Co trafia do zamówienia

    Zamówienie zapisuje się jako dokument „Zamówienie klienta”.

    Dane KastaCo z nich powstaje w Elbuz
    numer zamówienianumer zewnętrzny i klucz, po którym zamówienie jest rozpoznawane ponownie
    klient: imię, imię odojcowskie, nazwisko, telefon; e-mail z adresu dostawykontrahent i kontakty dokumentu
    odbiorca: imię, nazwisko, telefon, miastoodbiorca dostawy
    dostawa przez Nova Poshtarodzaj dostawy „Nova Poshta”, oddział według jego kodu — z adresem ze słownika Nova Poshta
    numer przesyłkilist przewozowy dokumentu
    sposób płatnościkod Kasta bez zmian: card (kartą), cod (przy odbiorze), bnpl (płatność w częściach)
    udane obciążenie karty albo status „Opłacono” w historii zamówieniastatus płatności „Opłacono”, w przeciwnym razie „Oczekiwanie”
    komentarzeopis zamówienia
    statusstatus dokumentu (tabela)
    pozycjewiersze dokumentu z ceną, którą zapłacił klient; pozycje usunięte korektą nie są przenoszone

    Kwota dokumentu to tyle, ile klient zapłacił za produkty. Koszt dostawy nie jest doliczany do dokumentu.

    Jak pozycje znajdują karty w katalogu

    W wierszu zamówienia Kasta zwraca identyfikator produktu z Twojego feedu (offer id) z przedrostkiem rzid_, a także kod produktu, markę, kolor i rozmiar. Ogólna kolejność wyszukiwania — jak pozycje znajdują produkt:

    • Najpierw — karta, którą Elbuz już założył dla tej pozycji Kasta przy wcześniejszych importach, potem — wewnętrzny kod produktu.
    • Dalej — po kodzie produktu razem z nazwą, potem po samej nazwie. Nazwę Elbuz składa z rodzaju produktu, marki, koloru i rozmiaru z wiersza Kasta.
    • Na końcu — po identyfikatorze z feedu jako numerze produktu w Elbuz: w szablonie Kasta z Elbuz offer id to właśnie ten numer.
    • Nic się nie znalazło — Elbuz zakłada kartę w kategorii technicznej „Produkty - kasta - ‹nazwa szablonu›”. Kategoria powstaje wyłączona, więc takie karty same nie trafią do feedów.

    Jak statusy Kasta stają się Twoimi

    Dopasowanie jest wbudowane w połączenie. Kasta nie zwraca bieżącego statusu osobnym polem — Elbuz ustala go z historii zamówienia: anulowanie i zwrot mają pierwszeństwo przed dostawą, a z etapów dostawy brany jest najpóźniejszy.

    Status na KastaKodStatus dokumentu w Elbuz
    UtworzoneCreatedNowy
    PotwierdzoneConfirmedBySupplierPotwierdzenie
    Spakowane; Zarejestrowane w firmie kurierskiejPacked; AnnouncedForDeliverySkompletowano
    WysłaneSentToDeliveryWysłano
    Dotarło do oddziałuAtLocation; ReceivedAtSelfDeliveryDostarczono
    DoręczoneDeliveredWydano
    AnulowaneCancelledAnulowano
    Prośba o anulowanie (dopóki sprzedawca nie odmówi)CancellationRequestedOczekuje na anulowanie
    Zwrot utworzony, wysłany, w oddziale, doręczony (jeśli zwrot nie został anulowany)ReturnCreated i inneOczekuje na zwrot
    Zwrot przyjęty; Zwrócono środkiReturnArrived; RefundedZwrócono
    Okno statusów zamówienia z blokiem statusów marketplace’u znalezionych w zaimportowanych zamówieniach
    1Status marketplace’u
    2Twój status
    3Wiersz Packed dopasowany z tabeli
    1. Status marketplace’u — nazwa statusu w takiej postaci, w jakiej wysyła ją Kasta.
    2. Twój status — status, który dostaje Twój dokument w Elbuz.
    3. Packed — ten wiersz ma oznaczenie „z tabeli”, więc dopasowanie pochodzi z tabeli statusów.

    Jak status i list przewozowy wracają na Kasta

    Zmieniasz status zamówienia Kasta w Elbuz — nowy status idzie na Kasta. Działa to od razu, wystarczy dopasować statusy; anulowanie zamówienia przez wsparcie AI trafia na Kasta niezależnie od przełącznika, jeśli przy „Anulowano” w tabeli jest kod Cancelled. Co jest potrzebne:

    1. 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 Kasta zmieniasz tylko w HUB.
    2. Otwórz szablon Kasta, przycisk „Statusy zamówienia”, i wpisz kody Kasta przy swoich statusach, na przykład: „Potwierdzenie” — ConfirmedBySupplier, „Skompletowano” — Packed, „Wysłano” — SentToDelivery, „Anulowano” — Cancelled. Do rejestracji listu przewozowego służy jeszcze AnnouncedForDelivery, dla „Dostarczono” — Delivered.
    • Etapy pośrednie można pomijać. Elbuz prosi Kasta, by sama utworzyła pominięte etapy, więc od razu „Wysłano” można ustawić bez „Potwierdzone” i „Spakowane”.
    • List przewozowy. „Zarejestrowane w firmie kurierskiej” i „Wysłane” Kasta przyjmuje tylko z listem przewozowym. Jeśli w HUB włączone jest automatyczne śledzenie przesyłek, „Wysłane” Kasta ustawia sama i cudzego nie przyjmuje — wtedy przy „Wysłano” wpisz AnnouncedForDelivery. Jeśli w dokumencie list przewozowy jest pusty, Elbuz nie wysyła statusu i zapisuje to w historii dokumentu. Wpisz numer i ustaw status ponownie.
    • „Spakowane” — Elbuz bierze pozycje i kwotę z samego zamówienia na Kasta. Przy płatności kartą Kasta obciąża kartę klienta właśnie w momencie „Spakowane”.
    • Anulowanie idzie z powodem: prośba klienta, „zmiana zdania” lub „znalazł taniej” w zgłoszeniu do wsparcia AI — „Klient sam poprosił o anulowanie”, duplikat — „Zamówienie zdublowane”, we wszystkich pozostałych przypadkach, w tym przy ręcznym „Anulowano”, — „Indywidualna decyzja sprzedawcy”.
    • Powtórka jest bezpieczna. Ten sam status dla tego samego zamówienia Kasta przyjmuje tylko raz, ponowne przekazanie nie tworzy duplikatu.
    • Wynik widać w historii dokumentu: „Status przekazano do marketplace’u: Packed” albo przyczyna, dlaczego nie — status niedopasowany, brak dostępów w szablonie, błąd od Kasta.

    Dla Kasta tabela „Statusy zamówienia” jest potrzebna tylko do przekazywania statusu z powrotem: przy imporcie statusy zamienia wbudowana tabela. Jeśli w wierszu jest kilka kodów po przecinku, na Kasta pójdzie pierwszy.

    Co dzieje się z już zaimportowanym zamówieniem

    Zamówienie jest rozpoznawane po numerze na Kasta, więc kopia się nie pojawia. Zasady są wspólne dla marketplace’ów (dwa statusy jednego zamówienia):

    • Dokument niezatwierdzony, status na Kasta się zmienił — status dokumentu jest nadpisywany według wbudowanej tabeli; ten sam — Twój status zostaje.
    • Dokument zatwierdzony — zmienia się tylko na statusy, które zdejmują rezerwację: anulowanie lub zwrot na Kasta przeniosą też zatwierdzony dokument, a rezerwacja się przeliczy.

    Po udanym przekazaniu statusu na Kasta Elbuz zapamiętuje wysłany kod, więc kolejny import z tym samym kodem nie nadpisze Twojego statusu. Kwota, ilość i cena w wierszach przy ponownym imporcie się nie zmieniają.

    Automatyczny import

    Zadanie systemowe „Zamówienia z marketplace’ów” co 5 minut pobiera zamówienia ze wszystkich aktywnych szablonów Kasta z tokenem. Harmonogram szablonu nie jest potrzebny. Szczegóły — automatyczny import zamówień.

    • Pierwsze uruchomienie pobiera zamówienia z ostatnich 30 dni.
    • Kolejne — tylko zmienione po najświeższym już zaimportowanym, z zapasem 10 minut: statusy na Kasta pojawiają się z opóźnieniem.
    • Zakres przebiegu — porcje po 100 zamówień, do 100 porcji. Błąd Kasta przerywa przebieg bez zapisu: kolejny odczyta to samo okno w całości.
    • Limity Kasta. Przy „za dużo zapytań” (429) Elbuz czeka dłużej i próbuje do trzech razy, przy awarii serwera — tak samo do trzech.

    Wiersze dziennika: „Kasta: strona N, pobrano zamówień: M” i na końcu „Kasta: import zamówień zakończony, łącznie: N”.

    Wyłącznik to plakietka „Aktywny” / „Wyłączony” w kolumnie „Stan” listy importów. Wyłączony szablon automatyczny import pomija, a statusy przestają trafiać na Kasta: przekazywanie szuka aktywnego szablonu Kasta.

    Scenariusze

    Zamówienia mają przychodzić same

    Wklej token, kliknij „Sprawdź połączenie” i upewnij się, że szablon jest „Aktywny”. Co 5 minut przebieg pobiera zmienione zamówienia, pierwszy — z 30 dni.

    Menedżer wystawia list przewozowy w Elbuz, Kasta dowiaduje się sama

    Wpisz SentToDelivery przy „Wysłano” — przekazywanie statusu jest domyślnie włączone. Wpisz list przewozowy w dokumencie i ustaw „Wysłano”: Kasta dostanie status „Wysłane” z numerem; o utworzenie pominiętych etapów Elbuz prosi samą Kasta. Przy automatycznym śledzeniu w HUB wpisz przy „Wysłano” AnnouncedForDelivery.

    Klient prosi o anulowanie

    Prośba o anulowanie z Kasta przeniesie dokument w „Oczekuje na anulowanie”. Ustaw „Anulowano” — przy włączonym przekazywaniu i kodzie Cancelled w tabeli Kasta dostanie anulowanie z powodem „Indywidualna decyzja sprzedawcy”. Przez wsparcie AI anulowanie na prośbę klienta pójdzie z powodem „Klient sam poprosił o anulowanie”.

    Pozycje mają trafiać na istniejące karty

    Eksportuj katalog na Kasta szablonem Elbuz i nie zmieniaj w nim offer id: wtedy identyfikator w zamówieniu jest równy numerowi produktu, a pozycja znajdzie swoją kartę.

    Co zrobić, gdy zamówienia nie przychodzą albo status nie dociera

    Co widziszDlaczego tak jestCo zrobić
    „Kasta: nie podano tokenu dostępu” W szablonie pole „Token” jest puste Wklej token z «Налаштування» (Ustawienia) → „API” w koncie HUB
    „Kasta: błąd zapytania do API.” w dzienniku Kasta odpowiedziała błędem; przyczyna jest w tym samym wierszu Jednorazowa awaria — kolejny przebieg za 5 minut odczyta to samo okno. Błąd się powtarza — sprawdź token przyciskiem „Sprawdź połączenie”
    „Status … nie został przekazany do marketplace’u: platforma wymaga dla niego listu przewozowego” Dla „Zarejestrowane w firmie kurierskiej” lub „Wysłane” w dokumencie nie ma listu przewozowego Wpisz list przewozowy i ustaw status ponownie
    „Status nie został przekazany do marketplace’u: „…” nie jest powiązany ze statusem platformy” Przy tym statusie w tabeli „Statusy zamówienia” nie ma kodu Kasta Wpisz kod, jeśli status ma coś znaczyć na Kasta
    „Status … nie został przekazany do marketplace’u: …” z odpowiedzią Kasta o niemożliwym statusie albo włączonym automatycznym śledzeniu Kasta nie przyjęła przejścia: zamówienie jest tam już anulowane albo dalej w łańcuchu, albo „Wysłane” Kasta śledzi sama Sprawdź status w koncie HUB; przy automatycznym śledzeniu przekazuj list przewozowy kodem AnnouncedForDelivery

    Najczęstsze pytania

    Czy to połączenie aktualizuje ceny i stany na Kasta?

    Nie. Elbuz przekazuje na Kasta asortyment, ceny i stany feedem XML, a Kasta sama je z niego aktualizuje — eksport na Kasta.

    Dlaczego kwota dokumentu jest mniejsza niż w koncie Kasta?

    Do dokumentu trafia tylko kwota, którą klient zapłacił za produkty. Kosztu dostawy Elbuz nie dolicza.

    Z jakiego okresu pobiorą się zamówienia przy pierwszym uruchomieniu?

    Z ostatnich 30 dni. Potrzebujesz innego okresu — wpisz datę w polu „Import zamówień począwszy od daty (RRRR-MM-DD)” w sekcji „Zaawansowane” formularza szablonu.

    Klient zrezygnował z części produktów — co stanie się z dokumentem?

    Pozycje usunięte korektą na Kasta nie trafiają do nowego dokumentu. W już zaimportowanym dokumencie wiersze i kwota przy ponownym imporcie się nie zmieniają — popraw je ręcznie.

    Czy Kasta przeszkadza w połączeniu Rozetka albo Prom?

    Nie. Każdy marketplace to osobny szablon, a tabele statusów prowadzone są dla każdego szablonu osobno.

    Gdzie to jest i kto ma dostęp

    Menu
    Słowniki → Operacje → Import danych → szablon typu „Kasta”
    Uprawnienia
    okno „Import” w „Uprawnieniach grup”
    Przygotuj
    token z konta Kasta HUB («Налаштування» (Ustawienia) → „API”)
    Formularz szablonu importu Kasta z kartą Połączenie, polem Token i przyciskiem Sprawdź połączenie
    1Pole Token
    2Przycisk Sprawdź połączenie
    1. Token — wklej token z konta Kasta HUB (Ustawienia → karta API).
    2. Sprawdź połączenie — sprawdza token bez importowania czegokolwiek.

    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