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
- W koncie Kasta HUB otwórz «Налаштування» (Ustawienia) → karta „API” i skopiuj token.
- 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.
- Wklej token w pole „Token” karty „Połączenie”. Formularz zapisuje się sam.
- Kliknij „Sprawdź połączenie”. Sukces — „Połączenie działa. Kasta (nazwa Twojej organizacji)”. Niepowodzenie — „Połączenie nie powiodło się:” i odpowiedź Kasta.
- 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 Kasta | Co z nich powstaje w Elbuz |
|---|---|
| numer zamówienia | numer zewnętrzny i klucz, po którym zamówienie jest rozpoznawane ponownie |
| klient: imię, imię odojcowskie, nazwisko, telefon; e-mail z adresu dostawy | kontrahent i kontakty dokumentu |
| odbiorca: imię, nazwisko, telefon, miasto | odbiorca dostawy |
| dostawa przez Nova Poshta | rodzaj dostawy „Nova Poshta”, oddział według jego kodu — z adresem ze słownika Nova Poshta |
| numer przesyłki | list przewozowy dokumentu |
| sposób płatności | kod 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ówienia | status płatności „Opłacono”, w przeciwnym razie „Oczekiwanie” |
| komentarze | opis zamówienia |
| status | status dokumentu (tabela) |
| pozycje | wiersze 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 idto 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 Kasta | Kod | Status dokumentu w Elbuz |
|---|---|---|
| Utworzone | Created | Nowy |
| Potwierdzone | ConfirmedBySupplier | Potwierdzenie |
| Spakowane; Zarejestrowane w firmie kurierskiej | Packed; AnnouncedForDelivery | Skompletowano |
| Wysłane | SentToDelivery | Wysłano |
| Dotarło do oddziału | AtLocation; ReceivedAtSelfDelivery | Dostarczono |
| Doręczone | Delivered | Wydano |
| Anulowane | Cancelled | Anulowano |
| Prośba o anulowanie (dopóki sprzedawca nie odmówi) | CancellationRequested | Oczekuje na anulowanie |
| Zwrot utworzony, wysłany, w oddziale, doręczony (jeśli zwrot nie został anulowany) | ReturnCreated i inne | Oczekuje na zwrot |
| Zwrot przyjęty; Zwrócono środki | ReturnArrived; Refunded | Zwrócono |
1
Status marketplace’u2
Twój status3
Wiersz Packed dopasowany z tabeli- Status marketplace’u — nazwa statusu w takiej postaci, w jakiej wysyła ją Kasta.
- Twój status — status, który dostaje Twój dokument w Elbuz.
- 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:
- 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.
- 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 widzisz | Dlaczego tak jest | Co 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”)
1
Pole Token2
Przycisk Sprawdź połączenie- Token — wklej token z konta Kasta HUB (Ustawienia → karta API).
- Sprawdź połączenie — sprawdza token bez importowania czegokolwiek.
Powiązane tematy
- Jeśli katalog nie jest jeszcze na Kasta — eksport produktów na Kasta feedem XML.
- Jeśli zamówienie przypisało się do niewłaściwego klienta — import zamówień przez API.
- Jeśli sprzedajesz też na Rozetce — katalog i zamówienia z Rozetki.
