Empik: integracja WooCommerce z Empik Marketplace

Zbudowaliśmy dla Empiku bezpłatną wtyczkę, która łączy sklepy WooCommerce z Empik Marketplace i działa dziś w ponad 500 sklepach.

Technologie użyte w tej realizacji

GitLab JavaScript MySQL php WooCommerce WordPress

Empik to jedna z największych sieci handlowych w Polsce, a Empik Marketplace otwiera jej platformę dla zewnętrznych sprzedawców. Wielu z nich prowadzi własne sklepy na WooCommerce. Zaprojektowaliśmy i zbudowaliśmy od zera wtyczkę Empik for WooCommerce, która synchronizuje produkty, oferty, ceny i zamówienia między sklepem a marketplace’em. Od pierwszej wersji rozwijamy ją i utrzymujemy w katalogu WordPress.org.

Wyzwanie

Sprzedawca, który ma sklep na WooCommerce i chce wejść na Empik Marketplace, prowadzi w praktyce dwa kanały sprzedaży. Bez integracji musi ręcznie przenosić produkty, pilnować zgodności cen i promocji, a zamówienia z Empiku obsługiwać poza swoim panelem. Przy kilkuset produktach to codzienna praca i ryzyko sprzedaży towaru, którego nie ma już na stanie.

Dla Empiku ten próg wejścia oznaczał wolniejszy onboarding sprzedawców. Wtyczka miała go obniżyć, a przy tym działać w setkach różnych sklepów: z wariantami produktów, z różnymi metodami wysyłki, z nowym sposobem przechowywania zamówień w WooCommerce (HPOS) i na serwerach o bardzo różnej konfiguracji.

Kluczowe wymagania

• Eksport produktów z WooCommerce do Empiku, z EAN i stawką VAT
• Automatyczna synchronizacja ofert, cen i promocji po każdej zmianie w sklepie
• Import zamówień z Empiku do panelu WooCommerce
• Przekazywanie numerów przesyłek do Empiku, w tym z InPost
• Tryb testowy (sandbox) i produkcyjny, konfiguracja kluczem API bez udziału programisty
• Zgodność z HPOS i wariantami produktów WooCommerce

Rozwiązanie

Zbudowaliśmy wtyczkę, która zamienia WooCommerce w centrum obsługi sprzedaży na Empiku. Sprzedawca zarządza produktami i zamówieniami w jednym panelu, a integracja w tle dba o to, żeby oba kanały pokazywały te same dane.

Produkty i oferty

Wtyczka eksportuje produkty do Empiku i na bieżąco synchronizuje oferty: ceny, promocje, stan produktu i klasę logistyczną. Sprzedawca może ustawić mnożnik ceny, żeby oferta na marketplace miała inną marżę niż w sklepie, oraz parametr czasu wysyłki (lead time to ship). Oferty obejmują też warianty produktów.

Zamówienia i wysyłka

Zamówienia z Empiku trafiają do WooCommerce jak każde inne, więc magazyn pakuje je w znanym procesie. Tabela oczekujących zamówień pokazuje, co czeka na import, a wyszukiwarka działa także po numerze zamówienia z Empiku. Numery przesyłek wracają do Empiku automatycznie, z gotową integracją InPost.

Konfiguracja bez programisty

Kreator pierwszego uruchomienia prowadzi sprzedawcę przez podłączenie konta Empik i ustawienia. Metody wysyłki WooCommerce mapuje się na metody Empiku z podpowiedziami w panelu. Tryb sandbox pozwala sprawdzić całą konfigurację przed startem sprzedaży.

Kluczowe decyzje

Synchronizacja w tle, odporna na różne serwery. Wymiana danych działa w zadaniach cyklicznych (cron). Dodaliśmy obsługę WP Cron, bo część sprzedawców korzysta z hostingu bez dostępu do systemowego crona. Dzięki temu integracja działa również w małych sklepach.

Zgodność z HPOS. WooCommerce przenosi zamówienia do nowych, wydajniejszych tabel. Dostosowaliśmy import zamówień tak, żeby działał zarówno w starym, jak i nowym modelu, także w trybie zgodności. Sprzedawca nie musi wybierać między integracją a aktualizacją sklepu.

Rozwój na podstawie zgłoszeń z setek sklepów. Wtyczka jest publiczna, więc każda nietypowa konfiguracja szybko wychodzi na jaw. Regularne wydania pozwalają nam reagować na problemy sprzedawców i dokładać funkcje, o które proszą.

Jak pracowaliśmy

Efekty

Co dalej

Wtyczkę rozwijamy dalej razem z Empikiem: wydajemy poprawki i nowe funkcje na podstawie zgłoszeń sprzedawców. Wtyczkę można pobrać bezpłatnie z katalogu WordPress.org.

Usługi powiązane

• Integracje z marketplace’ami
• Wtyczki WooCommerce na zamówienie
• Integracje e-commerce przez API
• Opieka techniczna nad WordPress i WooCommerce (SiteCare)