Integrator sprzedaży open source - raport z własnego testu

Różnica wobec BaseLinkera czy Sellasista sprowadza się do tego, gdzie fizycznie stoi oprogramowanie i czyje są dane. Integrator w abonamencie działa na serwerach dostawcy, a Ty korzystasz z panelu. Integrator o otwartym kodzie instalujesz na swoim serwerze i masz dostęp do bazy oraz kodu źródłowego.

OpenLinker to polski projekt na licencji Apache 2.0. W repozytorium znaleźliśmy dziewięć gotowych adapterów, każdy z jawnie zadeklarowanym zakresem działania.

Zestaw jest wyraźnie polski. KSeF, Subiekt, inFakt, InPost i ERLI to rzeczy, których zagraniczne narzędzia open source nie mają i mieć nie będą.

Dane z repozytorium mówią o dojrzałości kodu więcej niż deklaracje na stronie: na 3 021 plików źródłowych przypada 626 plików z testami, czyli około 21% całości. Jak na projekt przed pierwszym stabilnym wydaniem to dużo.

Projekt jest opisany przez autorów jako wersja alfa przed pierwszym stabilnym wydaniem. To nie jest formalność, tylko ostrzeżenie, które trzeba wziąć poważnie przy decyzji o wdrożeniu produkcyjnym.

Postawienie zajęło nam około dziesięciu minut od pobrania repozytorium do działającego interfejsu. Większość tego czasu to budowanie obrazów i pobieranie warstw, więc na wolniejszym łączu potrwa dłużej.

Dokumentacja podaje jako wymagania Node 22 i menedżer pakietów pnpm w wersji 10. W praktyce do samego uruchomienia nie są potrzebne – tryb demonstracyjny to wyłącznie Docker Compose. Node przydaje się dopiero przy pracy nad kodem.

Uruchomienie postawiło dziesięć kontenerów: bazę PostgreSQL, Redis na kolejki, MySQL, dwa sklepy testowe oraz osobne procesy interfejsu, API i workera przetwarzającego zadania w tle. Migracje bazy przeszły bez błędu i utworzyły czterdzieści osiem tabel.

Rozdzielenie API i workera na osobne procesy to dobry znak architektoniczny. Znaczy, że długie synchronizacje nie blokują panelu, a przy większym obciążeniu workera można zwielokrotnić.

Działa. Spięliśmy testowy sklep PrestaShop i uruchomiliśmy pełną synchronizację katalogu oraz stanów magazynowych.

Test samego połączenia zwrócił odpowiedź poprawną w 27 milisekundach. Potem poszła synchronizacja właściwa.

Ważniejszy od pierwszego zaciągnięcia jest test tego, co dzieje się przy zmianie. Ustawiliśmy w PrestaShopie stan magazynowy jednego produktu ze stu sztuk na 777 i uruchomiliśmy synchronizację ponownie. Wszystkie trzy warianty tego produktu dostały nową wartość.

Ciekawy jest sposób, w jaki to zrobił. Warianty zaktualizowały się w odstępach dokładnie dziesięciosekundowych, co odpowiada limitowi sześćdziesięciu zapytań na minutę zadeklarowanemu przez adapter PrestaShopa. Narzędzie samo pilnuje, żeby nie zalać sklepu ruchem – i to jest zachowanie, którego przy własnych skryptach integracyjnych zwykle brakuje.

Zlecenie synchronizacji całego katalogu rozkłada się wachlarzem na osobne zadania dla każdego produktu. Zamówienia idą niezależną ścieżką. Dzięki temu błąd na jednym produkcie nie przewraca całej synchronizacji.

Nazwa myli. Uruchomienie trybu demo nie daje gotowego, spiętego środowiska – daje postawione puste narzędzie obok dwóch pustych sklepów.

Po starcie lista połączeń jest pusta, a testowy WooCommerce nie ma ani jednego produktu, dopóki nie uruchomi się osobnego polecenia zasilającego dane. W PrestaShopie usługa sieciowa, przez którą integrator się łączy, jest wyłączona – w konfiguracji sklepu nie istnieje nawet wpis, który miałby ją włączać. Trzeba go dodać, założyć konto dostępowe i nadać uprawnienia do poszczególnych zasobów.

To nie jest wada oprogramowania, tylko realny obraz nakładu pracy. Każdy, kto wdrażał integrator, wie, że konfiguracja połączeń zajmuje więcej czasu niż instalacja. Tutaj jest tak samo, z tą różnicą, że nikt tego za Ciebie nie kliknie w kreatorze.

Na to trafiliśmy w połowie testu i warto o tym wiedzieć przed wdrożeniem. Konfiguracja połączenia z WooCommerce wymaga adresu z certyfikatem HTTPS i odrzuca adresy w sieciach prywatnych.

Powód jest sensowny. Interfejs programistyczny WooCommerce uwierzytelnia się parą kluczy przesyłanych metodą, która po zwykłym HTTP leci otwartym tekstem. Twórcy zablokowali więc możliwość skonfigurowania połączenia w sposób, który ujawniłby klucze w sieci.

Skutek praktyczny jest taki, że sklepu WooCommerce postawionego lokalnie albo na adresie wewnętrznym nie spniesz. Twórcy projektu sami obchodzą to publicznym tunelem, co opisali we własnej instrukcji testów. PrestaShop tego ograniczenia nie ma i łączy się po zwykłym adresie wewnętrznym.

Dla sklepu produkcyjnego z poprawnym certyfikatem to żaden problem. Dla środowiska testowego albo przedprodukcyjnego to dodatkowa rzecz do zorganizowania.

Powiemy wprost: dla większości sklepów to zły wybór. Abonament u dostawcy jest tańszy niż serwer plus czyjaś uwaga, a wsparcie z numerem telefonu ma wartość, której nie widać, dopóki coś nie przestanie działać w piątek po południu.

Najmocniejszy argument za otwartym kodem nie dotyczy ceny, tylko brakującej integracji. W modelu abonamentowym możesz jedynie zgłosić prośbę i czekać. Tutaj moduł da się dopisać – choć trzeba wiedzieć, ile to kosztuje. Według naszego pomiaru adapter jednego kuriera w tym projekcie to około 2,7 tys. linii kodu i drugie tyle testów, więc mówimy o dniach pracy programisty, nie o popołudniu.

Warto też sprawdzić, czego w projekcie nie ma. Gotowe adaptery nadawcze obejmują InPost i DPD Polska. Orlen Paczka i DHL są w kodzie rozpoznawane jako nazwy przewoźników przy przesyłkach z Allegro, ale nadać nimi przesyłki przez ten integrator się nie da. Jeśli Twoja logistyka stoi na jednym z nich, to jest pozycja do wyceny przed decyzją, a nie po niej.

Licencja kosztuje zero i to jedyna pozycja, która jest darmowa. Reszta to normalny projekt wdrożeniowy.

Na koszt składa się serwer, konfiguracja połączeń i usług sieciowych po stronie sklepów, mapowanie kategorii i statusów, testy synchronizacji na realnym katalogu oraz utrzymanie po uruchomieniu. Jeśli brakuje integracji, dochodzi jej napisanie i przetestowanie.

Punkt odniesienia jest jawny: według cenników dostawców integratory w abonamencie zaczynają się dziś od 69 zł miesięcznie za plan startowy. Tyle musi zaoszczędzić własny serwer, żeby w ogóle wejść w rachunek.

Uczciwe porównanie wygląda tak: roczny abonament u dostawcy zestawiasz z rocznym kosztem serwera i utrzymania, a nie z zerem na stronie projektu. Przy małym sklepie ten rachunek prawie zawsze wychodzi na korzyść abonamentu. Przy dużym katalogu, nietypowej logistyce albo wymaganiach co do przechowywania danych zaczyna się to zmieniać.

Jeśli rozważasz taki kierunek, porównanie integratorów pokazuje, gdzie ta opcja stoi wobec rozwiązań abonamentowych. Wdrożenia i migracje robimy w ramach sklepów internetowych – napisz przez formularz kontaktowy, podaj liczbę zamówień, kanały sprzedaży i kurierów, a powiemy, czy w Twoim przypadku własny serwer cokolwiek daje, czy tylko dokłada pracy.