Synchronizacja Allegro z własnym sklepem: jeden stan magazynowy w dwóch kanałach

Silniki-elektryczne.com.pl sprzedaje ten sam towar w dwóch miejscach: we własnym sklepie i na Allegro. Katalog liczy ponad 2 300 pozycji, ale fizycznie w magazynie leży po kilka sztuk danego silnika. Dopóki zamówień było dwa–trzy dziennie, właściciel po każdej sprzedaży ręcznie poprawiał stan w drugim kanale. Kiedy zamówień przybyło, zdarzyło się to, co musiało się zdarzyć. Ktoś kupił ostatnią sztukę na Allegro, trzy minuty później ktoś inny kupił tę samą sztukę w sklepie. Zwrot pieniędzy, przeprosiny i klient, który już nie wróci.

Gotowe programy do tego celu istnieją. Baselinker pobiera abonament i dopasowuje produkty według własnych reguł, wtyczki do WooCommerce w ogóle tu nie pasowały, bo sklep stoi na własnym zapleczu. Zbudowałem więc synchronizację od zera, pod ten konkretny katalog. Działa od 2021 roku i to o niej jest ten wpis: co robi, co się w niej psuło i ile taka rzecz kosztuje, jeśli chcesz mieć ją u siebie.

Co dokładnie się synchronizuje

Integracja składa się z pięciu części, które razem domykają pętlę między sklepem a Allegro.

Część	Co robi	Jak często
Autoryzacja	trzyma klucz dostępu do konta Allegro i odświeża go sama, zanim wygaśnie	co 12 h, 5 minut przed terminem
Sklep → Allegro	po każdym zamówieniu, anulowaniu albo zmianie stanu w panelu wysyła nowy stan na Allegro	natychmiast
Allegro → sklep	pobiera z Allegro informację o sprzedaży i obniża stan w sklepie	co 3 minuty
Publikacja ofert	z panelu sklepu tworzy nową ofertę na Allegro z parametrami silnika (moc, obroty, producent, waga)	na kliknięcie
Panel powiązań	pokazuje, który produkt jest którą ofertą, gdzie stany się rozjechały i pozwala powiązać ręcznie	na bieżąco

Ceny idą wyłącznie w jedną stronę, ze sklepu na Allegro. Promocja ustawiona na Allegro nie zmienia ceny w sklepie, bo cennikiem zarządza się w jednym miejscu.

Trzy rzeczy, które musiały się zepsuć, zanim całość zadziałała

Klucz dostępu wygasa co 12 godzin. Pierwsza wersja synchronizacji stawała o trzeciej w nocy, bo klucz wygasł między jednym a drugim sprawdzeniem. Teraz przed każdym zapytaniem do Allegro program sprawdza, czy klucz dożyje najbliższych pięciu minut, a jeśli nie, odświeża go i zapisuje nowy. Jeśli odświeżenie się nie uda (na przykład ktoś cofnął uprawnienia w panelu Allegro), reszta sklepu pracuje normalnie, a właściciel dostaje informację w panelu.

Allegro bywa niedostępne. Serwis zwraca błąd „chwilowo niedostępny” częściej, niż można by się spodziewać. Bez ponawiania prób synchronizacja gubiłaby kilka zdarzeń tygodniowo. Każde zapytanie ponawiam więc do trzech razy, z rosnącą przerwą (sekunda, dwie, cztery).

Zerowy stan wymaga zakończenia oferty. Gdy stan spada do zera, samo wpisanie „0” nie wystarcza, bo Allegro przestaje wyświetlać oferty z zerową dostępnością dopiero po ich zakończeniu. Kiedy stan wraca powyżej zera (po anulowaniu zamówienia), trzeba ofertę najpierw wznowić, odczekać półtorej sekundy, aż Allegro ją przetworzy, i dopiero wtedy ustawić stan. Pół sekundy działało w czterech przypadkach na pięć. Półtorej sekundy działa zawsze. Takich rzeczy nie ma w dokumentacji; wychodzą po kilku dniach obserwacji.

Dopasowanie produktów: ten sam silnik, dwie nazwy

Sklep i Allegro opisują ten sam towar inaczej. W sklepie: „silnik elektryczny 11kW 2950obr. 3fazowy INDUKTA”. Na Allegro: „silnik elektryczny 11kW 2950obr. INDUKTA MS”. Pierwszy import z Allegro dopasował 60 % ofert, reszta wisiała jako „brak powiązania”, choć w magazynie leżały te same silniki.

Rozwiązanie to normalizacja nazw przed porównaniem: małe litery, usunięcie słowa „3fazowy” (dla silników to informacja nadmiarowa), usunięcie oznaczeń serii z końca nazwy, przecinki w mocach zamienione na kropki. Po takim czyszczeniu obie nazwy są identyczne. Kilkanaście procent produktów wciąż wymaga ręcznego powiązania w panelu, bo Allegro limituje nazwę do 75 znaków i sprzedawcy skracają ją po swojemu.

Publikacja ofert z panelu sklepu

Właściciel dodaje nowy produkt w panelu sklepu, zaznacza „dodaj też na Allegro” i oferta powstaje sama, z parametrami przepisanymi na słownik Allegro. Ten słownik jest osobnym światem: moc, obroty, napięcie i waga mają własne identyfikatory zależne od kategorii, a lista producentów liczy ponad 30 000 pozycji. Cennik dostawy dobiera się według wagi, bo silnik 3 kg jedzie innym cennikiem Allegro Smart niż silnik 90 kg.

Jeśli Allegro odrzuci ofertę (brak parametru, za długa nazwa), produkt jest wycofywany również ze sklepu, a właściciel widzi komunikat z powodem. Dzięki temu w sklepie nie wisi towar, którego na Allegro nigdy nie było, a błąd poprawia się od razu.

Jak to wygląda przy jednym zamówieniu

Klient kupuje silnik 11 kW w sklepie i płaci BLIK-iem. Sklep rezerwuje sztukę, wysyła potwierdzenia mailem i w tej samej chwili wypycha nowy stan na Allegro. Jeśli to była ostatnia sztuka, oferta na Allegro zostaje zakończona. Równolegle przebudowują się dwa serwisy satelickie sklepu (silnik-elektryczny.pl i silniki-trojfazowe.pl), żeby pokazywały aktualną dostępność. Gdyby w tym samym czasie ktoś kupił ten silnik na Allegro, sklep dowie się o tym w ciągu trzech minut i obniży stan u siebie. Okno trzech minut to jedyne miejsce, gdzie nadsprzedaż jest teoretycznie możliwa; przy kilku zamówieniach dziennie na niszowy towar od 2021 roku nie zdarzyła się ani razu.

Ile to kosztuje i kiedy ma sens

Cała integracja to kilka tysięcy linii kodu i osobny panel. Ma sens, gdy sprzedajesz jednocześnie we własnym sklepie i na Allegro, a produkty mają parametry, po których klienci ich szukają (moc, wymiar, seria). Przy prostym asortymencie i sklepie na WooCommerce taniej wyjdzie Baselinker.

W sklepie budowanym na zamówienie synchronizację z Allegro wyceniam jako osobny moduł, po rozmowie o katalogu. Sam sklep zaczyna się od 4 999 zł netto; kalkulator na stronie usługi pokaże, co podnosi cenę. Jeśli masz sklep, w którym stany rozjeżdżają się między kanałami, opisz mi, jak sprzedajesz, a powiem, ile taka integracja zajmie i ile będzie kosztować.