VulCode

Integracja WooCommerce z ERP, Allegro i kurierami

Zamówienia z WooCommerce trafiają do ERP i do magazynu, stany i ceny wracają do sklepu, a faktury idą do KSeF. Przez REST API i webhooki, a tam, gdzie to rozsądne, przez własną wtyczkę w sklepie.

Platformy sklepowe
Droga zamówienia WooCommerce w panelu integracji: webhook, kolejka, dokument w Subiekcie, faktura w KSeF i PDF w koncie klienta
Zamówienie w koncie klienta sklepu na telefonie, z fakturą i numerem KSeF

REST API z zewnątrz czy wtyczka w środku sklepu

WooCommerce daje obie drogi. Wybór zależy od tego, gdzie ma działać logika.

Twój serwer
WordPress z WooCommerce
WooCommerce
koszykzamówieniametody dostawy

Zamówienia w HPOS, domyślnie w nowych sklepach od wersji 8.2.

hooki WooCommerce

Własna wtyczka WooCommerce

Widzi: koszyk, pola zamówienia, metody dostawy i reguły, których nie ustawisz z zewnątrz

Kiedy ta droga
  • Zmiana ma być widoczna w samym sklepie: koszyk, pola zamówienia, metody dostawy.
  • Potrzebujesz reguł, których nie da się ustawić z zewnątrz.

Wtyczka zgodna z hookami WooCommerce, z kodem w repozytorium i testami przed aktualizacjami. Piszemy ją przez API zamówień WooCommerce, nie przez bezpośrednie zapytania do tabel.

/wp-json/wc/v3REST API i webhooki

Integracja przez REST API

Widzi: zamówienia, produkty, stany i ceny przez API, z kluczem konsumenta

Kiedy ta droga
  • Dane płyną do systemu poza sklepem: ERP, magazyn, panel B2B.
  • Chcesz, żeby aktualizacja WordPressa nie dotykała integracji.
  • Integracja ma działać także, gdy sklep jest przeciążony.

Usługa obok sklepu: REST API do odczytu i zapisu, webhooki do zdarzeń. Klucz i sekret konsumenta przez HTTPS, osobne dla integracji i z minimalnymi uprawnieniami.

  • ERP
  • Magazyn
  • Panel B2B

Webhook WooCommerce, któremu można ufać

WooCommerce podpisuje każdy webhook. Tak przechodzi przez odbiornik, zanim zmieni cokolwiek w ERP.

Gdzie odpada i dlaczego

Dostawa od WooCommerce

webhook order.created
  • Zatrzymuje się: Odpowiedź inna niż 2xx, 301 albo 302

    Liczy się jako nieudana. Po ponad pięciu takich z rzędu WooCommerce wyłącza webhook, więc monitoring sprawdza, czy jest aktywny.

Podpis

X-WC-Webhook-Signature

HMAC-SHA256 z surowej treści, kluczem webhooka, w Base64, porównany w stałym czasie.

  • Zatrzymuje się: Podpis niezgodny

    Odrzucamy go. Taki webhook nie zmienia niczego w ERP.

Odpowiedź i kolejka

integracja

Odpowiedź 200 idzie od razu, a zdarzenie czeka w kolejce.

  • Idzie inną drogą: Obsługa w tle

    Zapis w ERP nie wydłuża odpowiedzi, więc dostawa nie liczy się jako nieudana.

Zapis w ERP

np. Subiekt nexo PRO

Zdarzenie z kolejki staje się zamówieniem w ERP.

    Na końcu

    Zamówienie w ERP

    Nikt nie przepisuje zamówień do ERP.

    Duży katalog, wolny sklep

    Integracje z dużymi sklepami WooCommerce często spowalniają je bardziej niż ruch klientów. Tego pilnujemy.

    Stany z Subiekta do WooCommerce w panelu integracji: tylko zmiany, żądania wsadowe po 100 produktów i odczyt kontrolny z nagłówkami sum

    Jedno żądanie to jedno uruchomienie WordPressa

    Pojedynczo286

    286 żądań na 286 zmienionych produktów

    Wsadowo4

    4 żądania: 100, 100 i 80 produktów oraz 6 wariantów

    • Tylko zmianyPełny import katalogu co godzinę obciąża bazę. Do sklepu idzie tylko to, co się zmieniło.
    • Paczki po 100Operacje wsadowe przyjmują domyślnie do 100 obiektów, więc stany i ceny idą paczkami po 100.
    • Sumy z nagłówkówOdczyt ustawia per_page i czyta X-WP-Total oraz X-WP-TotalPages zamiast zgadywać liczbę stron.

    Z czym łączymy WooCommerce

    Najczęstsze połączenia. Każde ma własną stronę.

    WooCommerce

    REST API i webhooki

    Subiekt GT i nexo

    W obie strony
    • Dokumenty, stany i ceny.
    • Zamówienia przychodzą webhookiem order.created i zmianami statusu.
    • Stany wracają po dokumencie magazynowym, wsadowo, do 100 produktów w żądaniu.
    Subiekt GT i nexo

    Comarch Optima

    W obie strony
    • Zamówienia i rozrachunki.
    • Ceny po zmianie cennika w ERP.
    • Produkty i warianty po nowym towarze w kartotece.
    Comarch Optima

    Allegro

    W obie strony
    • Wspólny stan i zamówienia.
    • Stan prowadzi ERP, a sklep i Allegro go odbierają.
    Allegro

    Kurierzy

    W obie strony
    • Punkty, etykiety, statusy.
    • Status i numer przesyłki wracają do zamówienia po wydaniu i nadaniu paczki.
    Kurierzy i wysyłka

    Płatności

    Do WooCommerce
    • Wtyczki bramek albo własna integracja.
    Płatności online

    KSeF

    Z WooCommerce
    • Faktury z zamówień.
    • Faktura z numerem KSeF trafia jako PDF do konta klienta sklepu.
    KSeF

    Jak to zrobimy: WooCommerce z Subiektem i Allegro

    Wdrożenie krok po kroku.

    Punkt wyjścia
    Sklep
    WooCommerce z kilkoma tysiącami produktów
    ERP
    Subiekt nexo PRO z magazynem
    Kanały
    Sklep i Allegro
    1. PZ 118/2026 w Subiekcie
      WKR-18V-2A: 23 → 47
      sklep: 47, Allegro: 47

      Jedno źródło stanów

      Stany prowadzi Subiekt. Sklep i Allegro tylko je odbierają.

    2. order.created, podpis zgodny
      ZK 386/2026 w Subiekcie

      Zamówienia z webhooków

      Nowe zamówienia przychodzą webhookiem z podpisem i trafiają do Subiekta przez kolejkę.

    3. POST products/batch: 100
      POST products/batch: 100
      POST products/batch: 80
      POST products/1840/variations/batch: 6

      Stany wsadowo

      Zmiany stanów zbieramy i wysyłamy paczkami po 100, żeby nie spowalniać sklepu.

    4. FS 1093/2026 przyjęta w KSeF
      PDF z numerem KSeF w koncie klienta

      Faktury do klienta

      Faktura z Subiekta, z numerem KSeF, pojawia się w koncie klienta w sklepie.

    Wynik: Sklep i Allegro sprzedają z jednego magazynu, a nikt nie przepisuje zamówień do Subiekta.

    Najczęstsze pytania o WooCommerce

    Odpowiedzi o wtyczkach, szybkości sklepu, aktualizacjach i wycenie.

    Czytaj dalej

    Inne platformy i to, co zwykle łączymy ze sklepem.

    Z czym ma się łączyć Twój WooCommerce?

    Napisz, jakie masz ERP, kanały i kurierów oraz ile produktów jest w sklepie. Odpowiemy w godzinę z pytaniami i wyceną.