Integracja Elbuz z WooCommerce pobiera katalog i zamówienia sklepu bezpośrednio przez REST API, bez plików, i trzyma produkty w katalogu bazowym obok innych kanałów sprzedaży.
Kiedy to się przyda:
- Katalog jest już na stronie WordPress — produkty, warianty, drzewo kategorii, marki, zdjęcia i teksty SEO trafią do kart.
- Ceny i dostępność prowadzisz według cenników dostawców — Elbuz liczy je u siebie, a osobny szablon eksportuje je z powrotem na stronę.
- Strona to nie jedyny kanał — produkt edytujesz w jednym miejscu, a zmiany trafiają na marketplace’y.
- Zamówienia ze strony mają trafiać do jednej kolejki — każde trafia jako dokument „Zamówienie klienta”.
Od czego zacząć: utwórz klucz REST API w WooCommerce.
Co potrafi połączenie z WooCommerce
- Przenosi produkt do karty — nazwę, opisy, markę, kod, kod kreskowy, cenę i starą cenę, stan, wagę, tagi, tytuł i opis SEO, zdjęcia.
- Odtwarza drzewo kategorii pełną ścieżką i rozkłada warianty na osobne karty jednej rodziny wariantów.
- Powtarza stan produktu — szkic na stronie wyłącza kartę, publikacja ją włącza.
- Pobiera zamówienia i zakłada je jako dokument „Zamówienie klienta”.
- Aktualizuje się według harmonogramu i zapisuje w dzienniku każdą odczytaną stronę.
Czego potrzeba od WooCommerce: adres i para kluczy
Aplikacji deweloperskiej ani kodu powiązania w WooCommerce nie ma. Potrzebne są wszystkie trzy wartości:
- Adres sklepu — pełny strony, na przykład
https://store.com. Koniecznie przezhttps. - Consumer key — klucz dostępu, zaczyna się od
ck_. - Consumer secret — sekret, zaczyna się od
cs_.
Skąd wziąć klucze: krok po kroku
| Gdzie | Co zrobić |
|---|---|
| WordPress | Ustawienia → Bezpośrednie odnośniki: niczego nie trzeba zmieniać, pasuje każdy tryb, także „Prosty” (Plain) |
| WooCommerce | WooCommerce → Ustawienia → Zaawansowane → → „Dodaj klucz” |
| Tamże | Wypełnij opis, wybierz użytkownika, w imieniu którego będzie działał klucz, i poziom dostępu |
| Elbuz | Okno importu → Twój szablon „WooCommerce” → karta „Połączenie” → pola adresu, Consumer key i Consumer secret |
Po utworzeniu WooCommerce pokaże consumer key i consumer secret — skopiuj oba, bo sekret jest wyświetlany tylko raz. Zgubionego klucza się nie odzyskuje: tworzy się nowy i unieważnia stary.
Odczyt (Read) wystarczy, by pobierać katalog. Odczyt/Zapis (Read/Write) — dla zamówień i zwrotnej aktualizacji cen i stanów na stronie; nadaj go od razu, żeby potem nie generować klucza na nowo. Załóż dla integracji osobnego użytkownika WordPress: widać wtedy, kto łączył się ze sklepem, a dostęp łatwo cofnąć.
Jeśli w WordPress ustawiono tryb bezpośrednich odnośników „Prosty”, zwykły adres REST API sklepu (/wp-json/wc/v3/…) nie odpowiada. Elbuz rozpoznaje to sam: ponawia zapytanie przez zapasowy adres ?rest_route=/wc/v3/… i dalej cały przebieg działa przez niego.
Oficjalna instrukcja WooCommerce: WooCommerce REST API — opisano tam też zarządzanie kluczami i ich unieważnianie.
Jak połączyć
- Utwórz szablon typu „WooCommerce” i w karcie „Połączenie” wpisz adres, consumer key i consumer secret.
- Kliknij „Sprawdź połączenie” — jeszcze przed pierwszym importem dowiesz się, czy strona przyjmuje Twoje klucze.
- W karcie „Wybór danych do importu” zaznacz „Produkty”, w razie potrzeby „Zdjęcia” i „Zamówienia”, zapisz i uruchom.
Co trafia do karty
| Dane WooCommerce | Pole karty w Elbuz |
|---|---|
| nazwa produktu | Nazwa (dla wariantu — „Nazwa — S / Black”) |
| opis | Pełny opis |
| krótki opis | Krótki opis |
| marka produktu | Producent |
sku | Kod |
| / z pól dodatkowych | Kod kreskowy (tylko cyfry) |
regular_price / sale_price | Cena (promocyjna ma pierwszeństwo) |
regular_price przy aktywnej promocji | Stara cena |
stock_quantity lub status dostępności | Stan |
status publish | Aktywność karty (szkic przychodzi wyłączony) |
| tagi produktu | Tagi |
| drzewo kategorii | Kategoria — pełną ścieżką |
slug | Adres SEO (przyjazny URL) |
| waga | Waga |
| tytuł i opis SEO (Yoast / Rank Math) | Meta title i meta description |
| zwykłe atrybuty produktu | Cechy |
| atrybuty wariantu | Opcje wariantu |
| galeria produktu + zdjęcie wariantu | Obrazy — przy zaznaczonym polu „Zdjęcia” |
| identyfikatory produktu i wariantu | Klucze powiązania ze stroną |
- Cena — cena promocyjna ze strony staje się ceną karty, a zwykła — „starą ceną”, więc rabat widać tak samo jak na witrynie.
- Stan — przy włączonym zarządzaniu stanem magazynowym przenosi się dokładna ilość; bez niego WooCommerce zna tylko „jest / brak”, a do karty trafia 1 lub 0.
- Kod kreskowy — własnego pola GTIN w WooCommerce nie ma, dlatego Elbuz szuka go w polach dodatkowych popularnych wtyczek i zostawia tylko cyfry.
- — z Yoast SEO lub Rank Math tytuł i opis strony produktu przechodzą do karty.
Kategorie, marki i warianty
Kategorie przychodzą pełną ścieżką: Elbuz osobno czyta drzewo kategorii sklepu, więc struktura strony powtarza się w katalogu bazowym. Marka staje się producentem.
Warianty (rozmiary, kolory, wersje) przychodzą jako osobne karty z nazwą w rodzaju „Nazwa produktu — S / Black”, z własną ceną, stanem i kodem; warianty jednego produktu łączą się w rodzinę wariantów. Osie wariantu (Rozmiar, Kolor) stają się opcjami, zwykłe atrybuty — cechami.
Czyja cena zostanie w karcie
Kolejność zapisu ceny jest sztywna:
- Przebieg zapisuje cenę ze strony.
- Gdy wszystkie strony są zebrane, po właśnie utworzonych kartach przechodzi narzut katalogu bazowego — liczy cenę od ceny zakupu, tylko tam, gdzie cena zakupu jest większa od zera. WooCommerce nie przekazuje ceny zakupu, więc w nowej karcie zostaje cena ze strony. Istniejących kart ten krok nie dotyka.
- Na końcu przebieg przelicza pola według formuł — wiersz „Aktualizacja wartości na podstawie formuł”. Działają tylko formuły stosowane przy imporcie; jeśli formuła liczy cenę, ostatnie słowo należy do niej.
„Stała cena” i „Nie aktualizuj” chronią kartę zarówno przed narzutem, jak i przed zapisem ceny przez import. Różnica: „Stała cena” blokuje tylko ceny, „Nie aktualizuj” — całą kartę.
Kategoria nowej karty i producent
Kategorii nowej karty program szuka w trzech krokach: Twoja kategoria z tą samą pełną ścieżką → kategoria o tej samej nazwie w dowolnym miejscu drzewa (od liścia do korzenia) → cała nowa gałąź. Dlatego duplikaty w rodzaju „Laptopy (2)” nie powstają, dopóki nazwy się zgadzają.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Produkty bez kategorii trafiają do technicznej „Produkty - woocommerce” — wyłączonej i niebiorącej udziału w eksportach. Przenoś z niej karty swobodnie: przebieg nie nadpisuje kategorii głównej istniejącej karty, a przeniesienie nie zmienia wystawionych dokumentów. Samej kategorii nie można usuwać, dopóki są w niej produkty — zostaną usunięte razem z nią (kategorie techniczne).
Producent to marka produktu WooCommerce; jeśli marek nie ma, pole jest puste. Nowa marka sama dodaje się do słownika. Nazwę marki zmieniaj po stronie WooCommerce: markę przemianowaną w Elbuz przebieg założy ponownie pod starą nazwą.
Co kolejny przebieg robi z Twoimi poprawkami
Każde uruchomienie to pełne lustro katalogu strony: przebieg przechodzi wszystkie strony produktów, więc poprawki w Elbuz żyją do następnej aktualizacji, bez ostrzeżenia. Pobierania „tylko zmian” dla katalogu nie ma.
- Nadpisywane ze strony: nazwa, pełny i krótki opis, cena, stara cena, ilość i dostępność, kod, kod kreskowy, waga, producent, tagi, tytuł i opis SEO, aktywność.
- Puste nie kasuje: puste pole lub zero ze strony zostawia poprzednią wartość. Skończyła się promocja — „Stara cena” w karcie zostaje dawna. Zerem i pustką nadpisywane są tylko ilość i aktywność. Dostępność wynika z ilości: więcej niż zero — „Dostępny”, zero — „Brak w magazynie”.
- Nie rusza w istniejącej karcie: zdjęć (galeria wgrywa się tylko przy tworzeniu), cech (nowe atrybuty nie są dopisywane), miejsca w drzewie kategorii, ceny zakupu.
Zablokować całą kartę — przełącznik „Nie aktualizuj” w produkcie (to też kolumna „Nie aktualizować (flaga)” w oknie „Produkty”, ustawiana wprost w tabeli). Tylko cenę i starą cenę — „Stała cena”. Więcej: jak zablokować swoją wartość.
1
Nie aktualizuj- Nie aktualizuj — przełącznik, który chroni cały produkt przed zmianami z importu.
Karta jest wyszukiwana po nazwie, a nie po identyfikatorze produktu na stronie (ten jest zapisywany tylko na potrzeby eksportu zwrotnego).
Zmienisz nazwę na stronie — przebieg założy obok drugą kartę, a stara zostanie ze starymi liczbami. Zmienisz ją w Elbuz — karta się znajdzie, a nazwa wróci ze strony. Dla wariantu porównywana jest pełna nazwa z etykietą „Nazwa — S / Black”, więc zmiana nazwy rozmiaru czy koloru też daje nową kartę.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Produkt zniknął ze strony lub stał się szkicem
| Co się stało na stronie | Co będzie z kartą w Elbuz |
|---|---|
| Produkt usunięto | Zostaje bez zmian: z ostatnią ceną i stanem, włączona, bez wiersza w dzienniku. Usuń ją ręcznie — inaczej trafia do eksportu |
| Produkt jest szkicem, prywatny lub w koszu | Następny przebieg wyłącza kartę; włączona jest tylko w stanie publish |
| Produkt ponownie opublikowano | Karta się włącza |
Pola „usuwaj to, czego nie ma w źródle” dla WooCommerce nie ma. Ogólna zasada — produkt zniknął ze źródła.
Wyłączysz „Aktywność” ręcznie, a na stronie produkt jest opublikowany — następny przebieg włączy kartę z powrotem. Utrzymać ją wyłączoną można tylko flagą „Nie aktualizuj”. Samo wyłączenie aktywności niczego nie usuwa, ale wyłączona karta nie trafia do eksportu: nowy szablon eksportu domyślnie bierze tylko aktywne produkty.
Jak odbierać zamówienia z WooCommerce
To samo połączenie pobiera też zamówienia — przy kluczu z uprawnieniami Odczyt/Zapis i zaznaczonym polu „Zamówienia”. Chcesz tylko produkty — zostaw je odznaczone.
Zamówienie trafia jako dokument „Zamówienie klienta”, niezatwierdzony: stan i rezerwacja nie zmienią się, dopóki dokument nie zostanie zatwierdzony. Specyfika WooCommerce:
- Status dokumentu — ze stanu zamówienia (
pending,processing,on-hold,completed,cancelled,refunded,failed) przez dopasowanie statusów w karcie szablonu. Niedopasowany stan to pierwszy status słownika, „Nowy”. - Znacznik płatności — z daty płatności: jest data — do dopasowania idzie
paid, nie ma —unpaid. - Przewoźnik — z pierwszego wiersza dostawy zamówienia, razem z nazwą ze strony.
- Wiersz zamówienia szuka karty po identyfikatorze wariantu, a jeśli wariantu nie ma — produktu. Dlatego katalog zaimportuj wcześniej albo w tym samym przebiegu.
Pierwszy przebieg pobiera wszystkie zamówienia w dowolnym stanie, kolejne — zmienione po dacie ostatniego pobranego (w czasie UTC, tak jak zwraca WooCommerce), i aktualizują już założone dokumenty. Duplikatu nie będzie: dokument jest wyszukiwany po identyfikatorze zamówienia razem z kodem źródła. W dzienniku — wiersz „Pobrano zamówień:”. Ogólna mechanika — import zamówień.
Aktualizacja według harmonogramu
Gdy połączenie jest sprawdzone, ustaw harmonogram szablonu przyciskiem ustawień zadania w formularzu: ceny i stany będą się aktualizować, a nowe produkty — dodawać. Ceny i stany na stronę odsyła osobny szablon WooCommerce w oknie „Eksport danych” z własnym harmonogramem (szablony eksportu).
Każda strona zostawia w dzienniku wiersz „WooCommerce: strona katalogu 3, pobrano produktów: 300”, a na końcu — „WooCommerce: katalog zaimportowany, produktów: N”. Ogólnie o dzienniku — jak sprawdzić, że import się udał.
Ile pobiera jeden przebieg
Limitu liczby produktów nie ma. Porcje są stałe:
| Co | Porcja |
|---|---|
| Produkty | 100 na stronę — maksimum WooCommerce |
| Warianty | 100 na stronę, osobnym zapytaniem dla każdego produktu z wariantami |
| Kategorie | 100 na stronę, drzewo czytane raz na początku przebiegu |
| Zamówienia | 100 na stronę |
| Zapis do katalogu | paczki po 500 pozycji |
Sklep z wariantami wysyła do strony więcej zapytań niż taki sam sklep z prostymi produktami, więc trwa dłużej — to nie zawieszenie. Okno można zamknąć: dziennik żyje w Centrum operacji. Czas trwania widać w kolumnie „Czas trwania” i w „Historii uruchomień”.
Scenariusze
Wszystkie pola poniżej są w karcie „Wybór danych do importu”, z wyjątkiem ostatniego scenariusza: tam flaga jest w samym produkcie.
1
Produkty2
Zdjęcia3
Zamówienia- Produkty — import katalogu produktów.
- Zdjęcia — import zdjęć produktów.
- Zamówienia — import zamówień.
Pobrać katalog strony, a zamówienia zostawić na stronie
Co włączyć. „Produkty”; „Zdjęcia” — jeśli potrzebne są obrazy. „Zamówienia” — odznaczone.
Efekt. Prosty produkt staje się kartą, produkt z wariantami — rodziną kart. Kategoria przychodzi pełną ścieżką, marka staje się producentem, zamówień przebieg nie odczytuje. Ceny zakupu nie będzie — WooCommerce jej nie przekazuje.
Zdjęcia ze strony — zdecyduj przed pierwszym przebiegiem
Co włączyć. „Zdjęcia” — jeszcze przed pierwszym uruchomieniem szablonu.
Efekt. Każda nowa karta dostaje galerię produktu, a karta wariantu — najpierw własne zdjęcie wariantu, potem galerię bez powtórzeń. Pole zaznaczone po pierwszym przebiegu doda zdjęcia tylko nowym kartom.
Zobaczyć na pierwszych stronach, jak układa się katalog
Co kliknąć. Uruchom szablon i, gdy w dzienniku pojawią się wiersze „WooCommerce: strona katalogu…”, kliknij „Zatrzymaj” w Centrum operacji.
Efekt. Przebieg doczyta bieżącą stronę (do 100 produktów), zapisze zebrane dane, nałoży narzut na nowe karty i zakończy się wierszem „WooCommerce: katalog zaimportowany, produktów: N”. Najpierw przychodzą produkty z najniższymi identyfikatorami na stronie. Zapisane dane zostają w kartach; następny pełny przebieg znajdzie je po nazwie, bez duplikatów.
Odbierać zamówienia ze strony w Elbuz
Co włączyć. „Zamówienia” razem z „Produkty” albo po imporcie katalogu — jeśli zaznaczono oba, katalog idzie pierwszy.
Efekt. Każde zamówienie staje się dokumentem „Zamówienie klienta”; kolejne przebiegi dobierają zmienione i aktualizują je bez drugiego dokumentu (zamówienia).
Edytować kartę w Elbuz tak, żeby przebieg jej nie nadpisywał
Co włączyć. „Nie aktualizuj” w karcie produktu, grupa „Ochrona podczas importu”.
Efekt. Przebieg znajduje kartę, ale nie zmienia w niej ani pól, ani dostępności, ani cech; zmiany ze strony do niej nie dotrą, dopóki nie zdejmiesz flagi. Przed drugą kartą po zmianie nazwy produktu na stronie flaga nie chroni.
Co zrobić, gdy WooCommerce się nie importuje
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „WooCommerce: podaj adres sklepu i klucze API (consumer key/secret)” | Jedno z trzech pól połączenia jest puste — przebieg nawet nie połączył się ze stroną | Wypełnij wszystkie trzy pola w karcie „Połączenie” (czego potrzeba) |
| „WooCommerce: błąd API —” i treść od sklepu | Strona odmówiła: klucze nie pasują lub skopiowano je ze spacjami, adres nie jest przez https albo ma zbędną ścieżkę, brakuje uprawnień, sklep nie odpowiedział | Kliknij „Sprawdź połączenie” — łączy się tymi samymi kluczami i od razu pokazuje odmowę (skąd wziąć klucze) |
| Klucze są na pewno poprawne, a sprawdzenie połączenia zwraca błąd | REST API jest wyłączone albo zewnętrzne zapytania blokuje hosting lub wtyczka bezpieczeństwa | Włącz REST API i zezwól na zewnętrzne zapytania do strony |
| „WooCommerce: katalog zaimportowany, produktów: 0” | Strona odpowiedziała, ale nie zwróciła produktów: katalog jest pusty albo klucz ma ograniczony dostęp | Sprawdź uprawnienia klucza w WooCommerce i to, czy w szablonie zaznaczono „Produkty” |
| W katalogu są dwa takie same produkty z różnymi nazwami | Produkt lub wariant przemianowano na stronie — przebieg założył nową kartę | Usuń starą kartę (jeśli przebieg zrobił nie to) |
Jeśli przebieg się przerwał
Produkty zapisują się do katalogu paczkami po 500, więc po przerwaniu część jest już zaktualizowana, a reszta ma stare dane. Ponowienie jest bezpieczne: karty znajdą się po nazwie, duplikatów nie będzie ani w katalogu, ani w zamówieniach, a następny udany przebieg dokończy końcowy narzut. Ogólna mechanika — jeśli przebieg się przerwał.
Odpowiedzi „zbyt wiele zapytań”, „usługa niedostępna” czy stronę zabezpieczeń program przetrzymuje sam: do czterech prób z przerwą podaną przez stronę (nie dłuższą niż 30 s) albo 2, 4, 6 i 8 s. Na odpowiedź czeka 180 s, na połączenie — 30 s. Potem przebieg zatrzymuje się z czerwonym wierszem „WooCommerce: błąd API —”.
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Jeśli przebieg zrobił nie to
Karty założone przez to połączenie wyfiltrujesz w oknie „Produkty” po kolumnach „Źródło: nazwa” i „Źródło: kod” (woocommerce) i usuniesz zbiorczo — tak usuwa się też duplikaty po zmianie nazwy. Nadpisane karty szukaj po „Data aktualizacji” (jeśli zaimportowano nie to).
Zbiorczo cofnąć importu w Elbuz nie ma czym. Ale przebieg odzwierciedla stronę, więc poprawne dane przywraca się po stronie WooCommerce i powtarza import. Poprzednią cenę widać w bloku „Historia cen produktu”, jeśli prowadzenie historii cen jest włączone.
Najczęstsze pytania
Jakie uprawnienia nadać kluczowi — Odczyt czy Odczyt/Zapis?
Do katalogu wystarczy Odczyt. Do zamówień i eksportu cen i stanów z powrotem na stronę — Odczyt/Zapis (skąd wziąć klucze).
Zgubiony consumer secret — gdzie go sprawdzić?
Nigdzie: WooCommerce pokazuje sekret tylko raz. Utwórz nowy klucz, wpisz go do szablonu, a stary unieważnij.
Czy kolejny przebieg nadpisze moje poprawki w karcie?
Tak: nazwę, opisy, cenę, stan, markę i aktywność przebieg bez ostrzeżenia przywróci ze strony. Zdjęć, cech ani kategorii istniejącej karty nie rusza. Zablokujesz to flagą „Nie aktualizuj” lub „Stała cena” (kolejny przebieg).
Dlaczego w kartach nie ma ceny zakupu?
WooCommerce jej nie przechowuje. Cena zakupu trafia do karty z cennika dostawcy i od niej liczą się reguły narzutu (czyja cena zostanie).
Zdjęcie dodane na stronie — dlaczego nie pojawiło się w karcie?
Zdjęcia i cechy wgrywają się tylko przy tworzeniu karty; w istniejącej przebieg ich nie aktualizuje (kolejny przebieg).
Czy można usunąć kategorię „Produkty - woocommerce”?
Tylko pustą: usunięcie kategorii zabiera wszystkie produkty, dla których jest główną. Najpierw przenieś karty do swoich kategorii. Następny przebieg utworzy kategorię techniczną ponownie, gdy tylko przyjdzie produkt bez kategorii (kategoria i producent).
Jak wczytać katalog do systemu, żeby potem stany i ceny aktualizowały się na stronie?
Dwoma szablonami na jednym kluczu z uprawnieniami Odczyt/Zapis: szablon WooCommerce w „Imporcie danych” pobiera katalog, a osobny szablon WooCommerce w „Eksporcie danych” z własnym harmonogramem aktualizuje ceny i stany na stronie.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Import danych
- Szablon
- nowy szablon → typ „WooCommerce”; jeden szablon — jedna strona
- Uprawnienia
- okno „Import danych” w „Uprawnieniach grup”
- Przygotuj
- adres strony z https, consumer key i consumer secret
1
Adres sklepu2
Consumer key3
Consumer secret4
Sprawdź połączenie- Adres sklepu — URL Twojej strony WooCommerce.
- Consumer key — klucz ck_... z ustawień REST API WooCommerce.
- Consumer secret — sekret cs_... przypisany do klucza.
- Sprawdź połączenie — sprawdza połączenie przed importem.
Jak ogólnie działają szablony importu — przegląd importu danych.
Powiązane tematy
- Jeśli chcesz zrozumieć, jak szablon importu obchodzi się z dowolnym źródłem, — Import danych do katalogu.
- Jeśli katalog jest zaimportowany i dalej trzeba skonfigurować ceny, dostępność i nowości — od czego zacząć i dokąd iść dalej.
- Jeśli zamówienia ze strony trzeba połączyć z innymi kanałami — Import zamówień z marketplace’ów.
- Jeśli ceny i stany z Elbuz mają wracać na stronę — Szablony eksportu.
