Integracja Subiekt GT z WooCommerce: ceny, stany i zamówienia bez przepisywania

Sklep z chłodnicami i częściami do maszyn i pojazdów miał dwa systemy, które nie rozmawiały ze sobą: WooCommerce i Subiekt GT. Połączyliśmy je tak, że ceny, stany, wymiary i numery OE jadą z Subiekta do sklepu same, a zamówienia ze sklepu trafiają do Subiekta jako zamówienia klienta (ZK) z poprawnym kontrahentem, krajem i VAT. Integracja pracuje na produkcji codziennie, a w katalogu jest ponad tysiąc produktów.

Punkt wyjścia

Firma sprzedaje części w sklepie internetowym, ale magazyn, ceny i dokumenty prowadzi w Subiekcie GT. Dla klienta to dwa osobne światy. Zmiana ceny w Subiekcie wymagała poprawki w sklepie. Stan magazynowy w sklepie bywał inny niż na półce. Zamówienie ze sklepu ktoś musiał przepisać do Subiekta ręcznie: wybrać kontrahenta, sprawdzić kraj i stawkę VAT, przepisać pozycje.

Do tego dochodził specyficzny katalog. Część produktów ma po kilkanaście numerów OE, wymiary zapisane w różnych formatach („520X680” dla chłodnicy, „575-210” dla zbiornika) i typy z kartoteki Subiekta, które przychodzą po angielsku i z literówkami.

Rozwiązanie: agent przy Subiekcie, sklep po REST API

Na komputerze, na którym stoi Subiekt GT, działa nasz agent. Odczytuje towary, ceny i stany z bazy SQL Server, a dokumenty tworzy przez Sferę GT, czyli oficjalny interfejs InsERT. Nie zapisujemy faktur ani zamówień bezpośrednio do tabel Subiekta, bo taki dokument dotyka numeracji, VAT, rozrachunków i magazynu, i łatwo go uszkodzić.

Agent sam łączy się ze sklepem przez REST API WooCommerce, więc firma nie musi wystawiać swojej sieci ani bazy na zewnątrz. Nowe i opłacone zamówienia trafiają najpierw do lokalnego bufora, a dopiero stamtąd do Subiekta. Dzięki temu chwilowa awaria sieci albo zamknięty Subiekt nie gubią zamówień.

Pierwszy przebieg, 16 lipca, objął 315 produktów. Dziś agent obsługuje cały katalog, zakłada brakujące produkty jako szkice do sprawdzenia i uzupełnia dodatkowe dane z kartoteki.

Co jedzie z Subiekta do sklepu

Katalog sklepu to nie tylko cena i stan. Z kartoteki Subiekta przychodzi kilka pól, których sklep używa w wyszukiwarce, filtrach i na karcie produktu.

Symbol to klucz, więc pilnujemy go jak klucza

Najgroźniejszy błąd w takiej integracji jest cichy: ktoś w panelu sklepu „poprawia” SKU, bo literówka rzuciła mu się w oczy. Od tej chwili produkt przestaje się łączyć z kartoteką. Powstaje duplikat albo stan trafia na inny produkt niż ten, który widać w opisie.

Dlatego pole SKU w panelu jest tylko do odczytu. Jest furtka „Zmieniam symbol świadomie”, która wymaga potwierdzenia, ale zapisy samej integracji przechodzą bez ograniczeń. Poniżej widać różnicę.

Wymiary: jedno pole, dwa formaty, filtr z tolerancją

Klienci szukają chłodnicy po wymiarze. Kartoteka podaje go jako tekst: dla chłodnicy „AxB” to wysokość razy szerokość bez grubości, dla zbiornika „A-B” to szerokość i grubość. Z tego tekstu sklep wylicza liczby do filtra i sortowania. Filtr działa z tolerancją ±5 mm, bo nikt nie mierzy chłodnicy co do milimetra.

Jak to wygląda na produkcji

Poniżej dane z działającego sklepu, odczytane 27 października około 15:30. Pokazują, że zmiany nie spływają raz na dobę, tylko przez cały dzień pracy, a katalog ma wyraźną strukturę.

Cztery rzeczy, których nie widać z zewnątrz

To nie są funkcje z oferty, tylko miejsca, w których integracja potrafi się cicho zepsuć. Wybierz jedno, żeby zobaczyć, co się działo i co z tym zrobiliśmy.

Efekty

• Cena i stan w sklepie zgadzają się z Subiektem w ciągu kilku minut, bez wpisywania ich drugi raz.
• Zamówienia powstają w Subiekcie jako ZK z właściwym kontrahentem, krajem i stawką VAT, także dla zamówień zagranicznych po wycenie.
• Wyszukiwarka znajduje produkt po numerze OE w dowolnym zapisie, a filtr po wymiarach działa na danych z kartoteki.
• Nowe towary z Subiekta pojawiają się w sklepie jako szkice, więc nikt nie zakłada produktu od zera.
• Symbol łączący sklep z kartoteką jest chroniony przed przypadkową edycją.