↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Marketplace’y w Kazachstanie: co się importuje i jak je podłączyć

    Jak importować zamówienia z Forte Market: raty, kredyt i wbudowane statusy

    12 min czytaniaZaktualizowano

    Elbuz sam pobiera zamówienia z konta sprzedawcy Forte Market kluczem API i zapisuje je na wspólnej liście zamówień obok sprzedaży z innych kanałów; nie trzeba przepisywać zamówień ręcznie.

    Kiedy to się przyda:

    • Sprzedajesz na Forte i gdzie indziej — zamówienia z Forte stają się dokumentami „Zamówienie klienta” we wspólnej kolejce z pozostałymi.
    • Klienci kupują na raty lub na kredyt — dokument sam dostaje sposób płatności „Raty” albo „Kredyt”.
    • Menedżer prowadzi zamówienie w Elbuz — jego status zmienia się dopiero po nowej zmianie na Forte.
    • Statusy Forte mają zgadzać się z Twoimi — dopasowanie jest wbudowane, nie trzeba go konfigurować.

    Od czego zacząć: weź token w koncie sprzedawcy Forte i utwórz szablon „API - market.forte.kz”.

    Co potrafi połączenie z Forte

    • Import zamówień — klient, adres, kwota i pozycje trafiają do dokumentu „Zamówienie klienta”. Katalog z Forte nie jest importowany: produkty przychodzą tylko jako wiersze zamówień.
    • Karty dla nieznanych produktów — pozycja, której nie ma w katalogu, nie ginie, tylko staje się kartą w kategorii technicznej.
    • Raty i kredyt — bankowe sposoby płatności rozpoznają się same i trafiają do osobnych sposobów płatności.
    • Wbudowane dopasowanie statusów — statusy Forte zamieniają się na Twoje bez żadnych tabel.
    • Automatyczny import — co 5 minut, tylko nowe zamówienia, bez duplikatów.

    Czego potrzeba od Forte Market

    Forte wymaga jednej wartości — Token. To klucz API wydawany w koncie sprzedawcy Forte Market; jest przesyłany z każdym zapytaniem i potwierdza, że pyta właśnie Twój sklep.

    Pomoc marketplace’u dla sprzedawców: Praca z API Forte Market. Klucz wydawany jest w koncie sprzedawcy; jeśli nie ma przycisku, napisz do opiekuna z marketplace’u — dostęp do nie jest otwierany automatycznie dla wszystkich typów kont.

    Każdy, kto dostanie klucz, będzie mógł czytać Twoje zamówienia razem z kontaktami klientów. Przekazuj go tylko specjaliście technicznemu, który konfiguruje integrację, i nie wysyłaj go na otwartych czatach.

    Jak połączyć

    1. Utwórz szablon typu „API - market.forte.kz”. Chcesz najpierw sprawdzić — przełącz plakietkę „Aktywny” na „Wyłączony”.
    2. Wklej token w pole „Token” karty „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 — do tysiąca najświeższych. Nie chcesz czekać — kliknij „Importuj”: dziennik od razu pokaże, czy marketplace przyjął klucz (co jest w dzienniku).
    3. Otwórz kilka zaimportowanych zamówień i porównaj pozycje, kwoty, klienta i status z kontem Forte.
    4. Przejrzyj pozycje. Jeśli produkty przyszły jako nowe karty w kategorii technicznej, kody produktów na marketplace i w katalogu się nie zgadzają — popraw to, póki takich kart jest mało (jak).

    Harmonogramu nie trzeba ustawiać: nowe zamówienia przychodzą same co 5 minut (automatyczny import).

    Co przychodzi z zamówieniem

    Dane FortePole dokumentu w Elbuz
    identyfikator zamówieniaNumer zewnętrzny (po nim zamówienie jest rozpoznawane ponownie)
    imię odbiorcyImię
    e-mail odbiorcyE-mail
    telefon komórkowyTelefon
    miasto i adres dostawyMiasto, adres dostawy
    kwota łącznaKwota dokumentu
    sposób płatnościSposób płatności (raty i kredyt)
    status zamówieniaStatus dokumentu (tabela statusów)
    daty utworzenia i zmianyData zamówienia, data zmiany na marketplace
    pozycje: nazwa, kod produktu, cena, ilośćWiersze dokumentu

    Na liście dokumentów zamówienia z Forte rozpoznasz po kolumnie „Źródło: nazwa” — jest tam nazwa szablonu. Numer zamówienia na marketplace znajduje się w kolumnie „Nr dokumentu (sklep)”.

    Stan i rezerwacja

    Zaimportowane zamówienie trafia do okna „Zamówienia” jako dokument „Zamówienie klienta” — niezatwierdzony. Sam przebieg nie zmienia stanów: nie robi ani rezerwacji, ani rozchodu. Jedyne, co aktualizuje w kartach produktów, to pole „Liczba sprzedaży”: przelicza się ono ze wszystkich zamówień klientów po każdym uruchomieniu, w którym marketplace zwrócił choć jedno zamówienie.

    Dalej wszystko zależy od tego, co robisz z zamówieniem u siebie:

    • Jeśli zatwierdzisz zamówienie, rezerwuje ono towar — pod warunkiem, że w „Schemacie pracy” włączona jest ewidencja magazynowa i jest co najmniej jeden aktywny magazyn. Rezerwacja znika, gdy zamówienie przejdzie w status końcowy (m.in. „Anulowano” lub „Zwrócono”), albo w miarę zatwierdzania dokumentów WZ utworzonych na podstawie tego zamówienia.
    • Fizycznie towar zdejmuje z magazynu osobny dokument WZ (wydanie zewnętrzne), a nie samo zamówienie.
    • Jeśli zamówienie zostaje niezatwierdzone, nie blokuje stanu.

    Anulowanie po stronie Forte po imporcie dociera do Elbuz, póki zamówienie jest wśród tysiąca najświeższych: dokument dostaje status anulowania, a rezerwacja zatwierdzonego znika (jak). Więcej o zatwierdzaniu i rezerwacji — w artykule o zamówieniu klienta.

    Gdzie trafiają produkty, których nie ma w katalogu

    Forte nie przekazuje kategorii produktu. Dlatego pozycja jest najpierw szukana wśród Twoich produktów: po numerze produktu Forte w kartach utworzonych przez to połączenie, potem po kodzie produktu razem z nazwą, potem po samej nazwie. Jeśli się nie znajdzie — tworzy się dla niej karta w kategorii technicznej źródła.

    Taka karta zawiera tylko nazwę, kod produktu, cenę i ilość — bez opisu, zdjęć i cech. Ogólną kolejność dopasowania pozycji opisuje przegląd importu zamówień przez API.

    Kategoria techniczna powstaje w korzeniu drzewa, jej nazwa zaczyna się od słowa „Produkty” i kończy nazwą Twojego szablonu. Jest zakładana jako wyłączona i z odznaczoną flagą eksportu. Jeśli kategoria o takiej nazwie już jest w korzeniu, kolejne przebiegi dodają do niej nowe karty, zamiast zakładać drugą.

    Każda karta utworzona przez to połączenie pamięta swój szablon i numer produktu na Forte. Wszystkie takie karty znajdziesz w kategorii technicznej drzewa katalogu albo filtrem listy produktów po kolumnie „Źródło: nazwa”. Kolejne zamówienie z tym samym produktem Forte znajduje już tę kartę po zapisanym numerze i nie tworzy nowej.

    Karty można przenieść do własnego drzewa. Wiersze zamówień wskazują samą kartę, a nie kategorię, a kolejne zamówienia znajdują kartę po numerze produktu Forte, gdziekolwiek leży. Pustą kategorię techniczną można potem usunąć; pojawi się znowu dopiero wtedy, gdy w zamówieniu przyjdzie produkt, którego nie znaleziono w katalogu.

    Jeśli usuniesz kategorię techniczną, gdy są w niej karty, razem z nią usuwane są też te karty. Wiersze już zaimportowanych zamówień zostają: nazwa, kod produktu, cena i ilość są zapisane w samym wierszu. Ale powiązanie wiersza z kartą znika, a kolejne zamówienie z tym samym produktem znowu utworzy nową kartę w nowej kategorii technicznej.

    Jeśli zebrały się już półpuste duplikaty, scal każdy z właściwą kartą w oknie „Duplikaty katalogu”, jeśli okno znalazło taką parę:

    • przy scalaniu zamówienia, dokumenty, ruchy magazynowe i powiązanie z produktem Forte przechodzą na kartę, która zostaje, a druga jest usuwana;
    • przed „Scal karty” sprawdź, którą kartę okno oznaczyło jako „Zostanie”: karty z wierszami zamówień mają wyższą ocenę, więc może to być półpusta — przycisk „Zostaw drugą” zamienia je miejscami;
    • po scaleniu kolejne zamówienia Forte z tym produktem trafiają już na kartę, która została.

    Scalenia kart nie można cofnąć — sprawdź parę przed kliknięciem „Scal karty”.

    Żeby duplikaty się nie pojawiały, utrzymuj katalog wypełniony i pilnuj, aby kody produktów na marketplace zgadzały się z kodami produktów w Elbuz.

    Jaki status i sposób płatności dostaje dokument

    Dopasowanie statusów Forte jest wbudowane w samo połączenie — nic nie trzeba konfigurować:

    Status w ForteStatus dokumentu w Elbuz
    nowyNowy
    oczekuje na potwierdzenie przez sprzedawcęUzgodnienie
    oczekuje na potwierdzenie przez bankUzgodnienie
    potwierdzony przez sprzedawcęPotwierdzenie
    w dostawieWysłano
    oczekuje na wydanieWysłano
    dostarczonyDostarczono
    wydanyZrealizowano
    anulowany — przez sprzedawcę, bank lub klientaAnulowano
    zwrotZwrócono

    Status Forte, którego połączenie nie zna, Elbuz rozpoznaje po nazwie — na przykład ze słowem „anul” stanie się „Anulowano”; jeśli nie rozpozna — „Nowy” (kolejność dopasowania).

    W karcie „Powiązane ustawienia” są przyciski ręcznego dopasowania statusów, sposobów płatności i dostawy. Na zamówienia Forte reguły z tych okien nie wpływają: import uwzględnia tylko reguły przypisane do swojego szablonu, a okna z karty Forte zapisują reguły bez takiego przypisania. Reguły innych szablonów i innych marketplace’ów też nie działają.

    Raty i kredyt

    Duża część zamówień Forte jest składana na raty albo na kredyt z banku. Sposób płatności przychodzi jako nazwa, a Elbuz rozpoznaje w niej te dwa scenariusze:

    • w nazwie jest słowo «Рассрочка» (raty) — sposób płatności „Raty”;
    • w nazwie jest słowo «Кредит» (kredyt) — sposób płatności „Kredyt”;
    • pozostałe sposoby płatności dobierane są ogólnymi regułami po słowach w nazwie, a bez dopasowania ustawiana jest „Karta płatnicza”.

    Status płatności we wszystkich zamówieniach Forte to „Oczekiwanie”: faktyczny wpływ pieniędzy oznaczasz u siebie, gdy bank przeleje środki.

    Automatyczny import

    Forte nie wysyła natychmiastowych powiadomień, więc Elbuz odpytuje go sam: zadanie systemowe „Zamówienia z marketplace’ów” co 5 minut pobiera zamówienia ze wszystkich aktywnych szablonów Forte z tokenem. Harmonogram szablonu nie jest potrzebny — przycisku „Ustawienia harmonogramu” w formularzu nie ma. Interwał zmienia się w oknie „Harmonogram zadań”, w wierszu tego zadania.

    Jeśli w tej minucie importuje się inny szablon, także ręcznie, przebieg jest po cichu pomijany, a zamówienia pobierze następny. Wyłączony szablon automatyczny import pomija — wyłączyć czy usunąć.

    Co pobiera każde uruchomienie

    W jednym uruchomieniu Elbuz pobiera do tysiąca ostatnich zamówień, posortowanych według daty zmiany — od najświeższych do starszych. Osobnego filtra „tylko nowe” tu nie ma: marketplace zwraca wspólną listę, a Elbuz sam wybiera z niej to, czego jeszcze nie ma. Jeśli w koncie jest więcej niż tysiąc zamówień, najstarsze do tej próbki nie trafią.

    Duplikat nie powstanie: zamówienie jest rozpoznawane po numerze zewnętrznym. W już zaimportowanych aktualizują się status, płatność i dostawa, póki zamówienie jest wśród tysiąca najświeższych. Twój status zmienia się dopiero po nowej zmianie na Forte — kto kogo nadpisuje.

    Bez tokena zapytanie do Forte nie jest wysyłane, ale dziennik i tak kończy się wierszem „Import danych zakończony!”. Po zatrzymaniu ostatnim wierszem w dzienniku zostaje „Operacja przerwana przez użytkownika!”. Jeśli Forte nie przyjął klucza albo zapytanie nie przeszło, dziennik pokazuje czerwony wiersz „Forte: błąd API —”, a zamówienia nie są zapisywane. Dalej każde zamówienie przechodzi jedno rozwidlenie: już zaimportowane z Forte — aktualizuje status, płatność i dostawę, nowe — dostaje dokument, a nieznane pozycje najpierw stają się kartami kategorii technicznej.
    nietaktaknienietaknietaktaknienietakUruchomienie szablonuPole „Token” wypełnione?„Nie podano tokenu API”zapytanie do Forte nie jest wysyłaneKliknięto zatrzymanie?„Operacja przerwana przezużytkownika!”wiersza „zakończony” nie maZapytanie do Fortedo 1000 najświeższych zamówieńForte przyjął klucz i odpowiedział?Czerwony wiersz „Forte: błąd API—”zamówienia nie są zapisywane„Import danych zakończony!”Marketplace zwrócił zamówienia?Zamówienie jest już wśródzaimportowanych z Forte?Aktualizują się status,płatność i dostawaPozycja znaleziona w katalogu?Nowa karta w kategorii technicznejKlient i dokument„Zamówienie klienta” z wierszami
    • Початок або кінець
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді

    Jak sprawdzić, czy zamówienia dotarły

    Po uruchomieniu w dzienniku szablonu pojawiają się takie wiersze, w tej kolejności:

    • „Pobieranie listy zamówień #1” — Elbuz odpytał Forte.
    • „Pobrano zamówień: N” — ile zamówień zwrócił marketplace. Wliczają się też te, które zaimportowano wcześniej, więc liczba nie jest równa liczbie nowych.
    • „Łącznie zaimportowano produktów: N” — ile nowych kart utworzono w kategorii technicznej. Wiersza nie ma, jeśli wszystkie pozycje znalazły się w katalogu. Gdy karty powstały, zaraz po nim idzie wiersz „Indeksowanie produktów”.
    • „Łącznie zaimportowano zamówień: N” — ile nowych dokumentów utworzono. Wiersza nie ma, jeśli nowych zamówień nie było.
    • „Import danych zakończony!” i czas trwania.

    Osobnych liczników „pominięto” ani „z błędem” dziennik nie prowadzi. Znane już zamówienia widać jako różnicę między „Pobrano zamówień” a „Łącznie zaimportowano zamówień”. Błędy dostępu omawia tabela problemów.

    Jeśli uruchomienie się przerwało lub je zatrzymano

    Przebieg wygląda tak: jedno zapytanie do Forte o listę do tysiąca zamówień, potem wyszukanie i utworzenie klientów, potem utworzenie kart dla nieznanych produktów, potem dokumenty. Wszystkie nowe dokumenty przebiegu zapisują się jednym zapytaniem do bazy, a ich wiersze — następnym.

    Osobnego punktu wznowienia nie ma. Każde uruchomienie znów prosi o ten sam tysiąc najświeższych zamówień i tworzy tylko te, których jeszcze nie ma wśród zaimportowanych z Forte — rozpoznaje je po numerze zewnętrznym zamówienia. Dlatego ponowne uruchomienie po przerwaniu nie dubluje już utworzonych dokumentów.

    • Przerwanie przed zapisem dokumentów — nowych zamówień w Elbuz nie ma, ponowne uruchomienie utworzy je od zera. Klienci i karty, które zdążyły powstać, przy powtórce są odnajdywane, a nie zakładane drugi raz.
    • Przerwanie między zapisem dokumentów a zapisem ich wierszy — dokumenty już są, ale bez pozycji. Ponowne uruchomienie uznaje takie dokumenty za zaimportowane i nie dopisuje do nich wierszy. Trzeba je uzupełnić ręcznie albo usunąć: usunięte zamówienie kolejne uruchomienie zaimportuje od nowa, jeśli jest jeszcze wśród tysiąca najświeższych.

    Zatrzymanie importu Forte jest sprawdzane raz — przed zapytaniem do marketplace’u. Kliknięte przed tą chwilą — dziennik pisze „Operacja przerwana przez użytkownika!” i nic nie jest zapisywane. Jeśli zapytanie już poszło, zamówienia i tak się zapiszą, ale wiersza „Import danych zakończony!” na końcu nie będzie.

    Scenariusze

    Prowadzić zamówienia Forte we wspólnej kolejce i nie tracić zmian menedżera

    Zadanie. Zamówienia z Forte mają być obsługiwane tam, gdzie sprzedaż z innych kanałów, a menedżer dalej zmienia status i skład zamówienia już w Elbuz.

    Co włączyć. Szablon typu „API - market.forte.kz” i klucz w polu „Token”. Harmonogram nie jest potrzebny.

    Efekt. Co 5 minut przebieg tworzy dokumenty „Zamówienie klienta” dla nowych zamówień, a w już zaimportowanych aktualizuje status, płatność i dostawę. Status menedżera zmienia się dopiero po nowej zmianie na Forte, w tym po anulowaniu.

    Odróżniać zamówienia na raty i na kredyt

    Zadanie. Widzieć, które zamówienia są opłacane przez bank, i nie mylić ich z pozostałymi.

    Co włączyć. Nic — rozpoznawanie jest wbudowane w połączenie.

    Efekt. Dokumenty dostają sposób płatności „Raty” albo „Kredyt” według nazwy sposobu płatności, status płatności — „Oczekiwanie”. Wpływ pieniędzy oznaczasz sam, gdy bank przeleje środki.

    Żeby pozycje trafiały na istniejące karty, a nie na nowe

    Zadanie. Produkty z zamówień Forte mają wiązać się z kartami Twojego katalogu.

    Co zrobić. Pilnuj, aby kod produktu i nazwa na Forte zgadzały się z kodem produktu i nazwą karty w Elbuz.

    Efekt. Znaleziona pozycja wskazuje istniejącą kartę. Nieznaleziona staje się kartą w kategorii technicznej — wyłączonej, bez flagi eksportu, bez opisu i zdjęć — i nie trafi do Twojego drzewa kategorii, dopóki jej nie przeniesiesz.

    Co zrobić, gdy zamówienia nie przychodzą

    Najczęstsze problemy
    Co widziszDlaczego tak jestCo zrobić
    Czerwony wiersz „Forte: błąd API —” po „Pobieranie listy zamówień #1” Marketplace nie przyjął klucza albo zapytanie nie przeszło; obok jest wyjaśnienie od Forte Skopiuj klucz z konta od nowa — w całości, bez spacji na początku i na końcu (skąd go wziąć)
    „Nie podano tokenu API” Pole „Token” jest puste, zapytanie do Forte nie zostało wysłane Wklej token — formularz zapisze się sam (jak połączyć)
    Po „Pobieranie listy zamówień” nie ma wiersza „Pobrano zamówień” Marketplace nie zwrócił żadnego zamówienia — w koncie ich nie ma Sprawdź zamówienia w koncie Forte
    W Elbuz nie ma starych zamówień W jednym uruchomieniu pobiera się do tysiąca najświeższych zamówień Nie odkładaj pierwszego połączenia i nie zostawiaj szablonu na długo wyłączonego (co pobiera uruchomienie)
    Pozycje za każdym razem tworzą nowe karty Kod produktu na marketplace nie zgadza się z kodem w katalogu Porównaj kody produktów, istniejące duplikaty scal (kategoria techniczna)
    Zamówienie anulowano na Forte, a w Elbuz status jest stary Zamówienie nie jest już wśród tysiąca najświeższych albo przebieg jeszcze się nie odbył Poczekaj do 5 minut; stare zamówienie przenieś w „Anulowano” ręcznie (stan i rezerwacja)
    Dokument zamówienia bez pozycji Przebieg przerwał się między zapisem dokumentów a ich wierszy Uzupełnij pozycje ręcznie albo usuń dokument (przerwanie uruchomienia)

    Najczęstsze pytania

    Skąd wziąć token Forte Market?

    Z konta sprzedawcy, z sekcji pracy z API. Jeśli nie ma potrzebnego przycisku, napisz do swojego opiekuna w Forte — dostęp do API nie jest otwierany automatycznie dla wszystkich typów kont.

    Czy można zaimportować z Forte produkty do katalogu?

    Nie. To połączenie przynosi tylko zamówienia; produkty przychodzą jako wiersze zamówień, a nieznane pozycje stają się kartami w kategorii technicznej.

    Bank przelał pieniądze za raty — dlaczego płatność wciąż ma status „Oczekiwanie”?

    Elbuz ustawia „Oczekiwanie” wszystkim zamówieniom Forte i nie oznacza płatności jako otrzymanej. Wpływ od banku oznacz w dokumencie sam (raty i kredyt).

    Dlaczego status zamówienia w Elbuz nie zmienia się za marketplace’em?

    Zmienia się, póki zamówienie jest wśród tysiąca najświeższych: przebieg aktualizuje status, płatność i dostawę. Twój status zmienia się dopiero po nowej zmianie na Forte (kto kogo nadpisuje).

    Czy trzeba konfigurować dopasowanie statusów?

    Nie, jest wbudowane. Ręczne reguły z karty „Powiązane ustawienia” nie wpływają na zamówienia Forte (tabela statusów).

    Jak usunąć omyłkowo zaimportowane zamówienia?

    Przefiltruj listę zamówień po kolumnie „Źródło: nazwa” i usuń dokumenty zbiorczo. Kolejne uruchomienie zaimportuje je ponownie, jeśli są jeszcze wśród tysiąca najświeższych (ogólne zasady).

    Gdzie to jest i kto ma dostęp

    Menu
    Słowniki → Operacje → Import danych
    Typ szablonu
    „API - market.forte.kz”
    Uprawnienia
    okno „Import danych” w „Uprawnieniach grup”
    Przygotuj
    token (klucz API) z konta sprzedawcy Forte Market

    Plik nie jest potrzebny: połączenie działa na kluczu. Jeden szablon — jedno połączenie z jednym kontem sprzedawcy.

    Karta połączenia szablonu importu API - market.forte.kz z polem Token
    1Pole Token
    1. Pole Token — klucz API z konta sprzedawcy.

    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