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ć
- Utwórz szablon typu „API - market.forte.kz”. Chcesz najpierw sprawdzić — przełącz plakietkę „Aktywny” na „Wyłączony”.
- 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).
- Otwórz kilka zaimportowanych zamówień i porównaj pozycje, kwoty, klienta i status z kontem Forte.
- 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 Forte | Pole dokumentu w Elbuz |
|---|---|
| identyfikator zamówienia | Numer zewnętrzny (po nim zamówienie jest rozpoznawane ponownie) |
| imię odbiorcy | Imię |
| e-mail odbiorcy | |
| telefon komórkowy | Telefon |
| miasto i adres dostawy | Miasto, adres dostawy |
| kwota łączna | Kwota dokumentu |
| sposób płatności | Sposób płatności (raty i kredyt) |
| status zamówienia | Status dokumentu (tabela statusów) |
| daty utworzenia i zmiany | Data 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 Forte | Status dokumentu w Elbuz |
|---|---|
| nowy | Nowy |
| oczekuje na potwierdzenie przez sprzedawcę | Uzgodnienie |
| oczekuje na potwierdzenie przez bank | Uzgodnienie |
| potwierdzony przez sprzedawcę | Potwierdzenie |
| w dostawie | Wysłano |
| oczekuje na wydanie | Wysłano |
| dostarczony | Dostarczono |
| wydany | Zrealizowano |
| anulowany — przez sprzedawcę, bank lub klienta | Anulowano |
| zwrot | Zwró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.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
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ą
| Co widzisz | Dlaczego tak jest | Co 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.
1
Pole Token- Pole Token — klucz API z konta sprzedawcy.
Powiązane tematy
- Jeśli potrzebujesz ogólnego obrazu, jak zamówienia z różnych marketplace’ów stają się dokumentami, — Import zamówień przez API.
- Jeśli zamówienie trzeba zatwierdzić i zarezerwować towar — Zamówienie klienta.
- Jeśli w katalogu zebrały się półpuste duplikaty — Duplikaty katalogu.
