Integracja WooCommerce z API hurtowni: sklep z częściami motoryzacyjnymi

#Problem

Sklep internetowy z częściami motoryzacyjnymi oparty na WooCommerce prowadził sprzedaż w oparciu o zewnętrzny magazyn dystrybutora z katalogiem obejmującym kilkadziesiąt tysięcy indeksów produktów. Nazwa sklepu oraz system dostawcy pozostają poufne.

Ręczne zarządzanie tak dużą ofertą było niemożliwe i generowało dwa krytyczne problemy operacyjne:

1. Sprzedaż towarów niedostępnych u dostawcy: najkosztowniejszy błąd w e-commerce motoryzacyjnym polegał na przyjęciu i opłaceniu przez klienta zamówienia na część, której hurtownia fizycznie nie miała już na magazynie. Skutkowało to kosztowną obsługą zwrotów, reklamacjami i utratą zaufania kupujących.
2. Rozjazd cenowy i ryzyko utraty rentowności: hurtownia aktualizowała cenniki z dnia na dzień. Brak natychmiastowej synchronizacji powodował, że sklep sprzedawał asortyment po starych stawkach, w skrajnych przypadkach poniżej realnego kosztu zakupu.

Głównym celem wdrożenia było stworzenie w pełni zautomatyzowanego mechanizmu, który utrzymuje stany magazynowe i ceny w sklepie WooCommerce w ścisłej zgodzie z danymi hurtowni, bez udziału pracy ręcznej.

#Co zrobiłem

Aby rozwiązać problem rozbieżności danych i zabezpieczyć marżę sklepu, zaprojektowałem i wdrożyłem dedykowaną architekturę integracji:

1. Moduł komunikacji z web-service hurtowni: napisałem dedykowany moduł integracyjny w PHP komunikujący się z REST API dystrybutora. Ponieważ dostawca udostępniał dane w formatach JSON oraz XML, silnik parsuje oba formaty i sprowadza je do zunifikowanego wewnętrznego modelu obiektów WooCommerce.
2. Deklaratywne mapowanie pól katalogu:
   • Klucze identyfikacyjne (EAN i indeks producenta): powiązanie pozycji w sklepie z unikalnym rekordem w bazie hurtowni, stanowiące punkt odniesienia przy każdej kolejnej synchronizacji.
   • Atrybuty techniczne i parametry części: automatyczne przekładanie specyfikacji z hurtowni na atrybuty WooCommerce, co umożliwiło klientom filtrowanie i wyszukiwanie części po parametrach pojazdu.
   • Zasoby multimedialne: import zdjęć poglądowych oraz oczyszczanie i osadzanie kodów HTML opisów bezpośrednio w kartach produktów.
3. Dwuetapowa synchronizacja w tle przez WP-Cron: rozdzieliłem zadania harmonogramu na częste, lekkie odpytywanie endpointów o stany magazynowe i bieżące ceny netto oraz cięższy, cykliczny proces nocny weryfikujący pełny asortyment i wprowadzający nowości produktowe.
4. Silnik automatycznej logiki marżowej: wdrożyłem reguły marżowe przeliczające ceny hurtowe netto na detaliczne ceny sprzedaży brutto przed ich zapisem w bazie WooCommerce, co zagwarantowało stałą rentowność bez konieczności manualnej korekty stawek.

#Wynik

Wdrożenie integracji w pełni zautomatyzowało obieg informacji produktowych między hurtownią motoryzacyjną a sklepem:

• Eliminacja sprzedaży braków magazynowych: asortyment niedostępny u dostawcy jest natychmiast oznaczany jako brak w magazynie lub automatycznie ukrywany, co zlikwidowało problem zamówień niemożliwych do zrealizowania.
• Ochrona rentowności w czasie rzeczywistym: każda modyfikacja cen w cenniku dystrybutora przekłada się na natychmiastowe przeliczenie cen detalicznych z zachowaniem ustalonej marży.
• Oszczędność czasu i skalowalność: obsługa sklepu została całkowicie odciążona od manualnego wprowadzania ofert, a mechanizm mapowania pozwala na podłączanie kolejnych kategorii produktowych bez modyfikacji kodu bazowego.

#Stack i czas

• Stack technologiczny: WordPress, WooCommerce, PHP, REST API (JSON/XML), WP-Cron, MySQL.
• Czas realizacji: 4 tygodnie prac programistycznych obejmujących analizę API dostawcy, przygotowanie mapowania danych, implementację zadań synchronizacji w tle oraz testy scenariuszy brzegowych (brak towaru, zmiana stawek, błędy API) na kopii produkcyjnej.