Aby przenieść produkt z Sellivo do swojego sklepu WooCommerce, jednorazowo zapisujesz trzy dane: adres sklepu (musi zaczynać się od https://), Consumer Key oraz Consumer Secret, które generujesz w WooCommerce w Ustawienia → Zaawansowane → REST API z uprawnieniem Odczyt/zapis. Potem każdy zaimportowany produkt wysyłasz jednym kliknięciem jako zadanie w tle — ze zdjęciami i, jeśli je ma, jako produkt z wariantami wraz ze wszystkimi wariacjami. Ponowne wysłanie aktualizuje istniejący produkt, zamiast tworzyć obok drugi.
Podłączasz WooCommerce bez instalacji i bez zatwierdzania
WooCommerce to najprostszy kanał w Sellivo. Nie ma procesu instalacji, nie ma weryfikacji aplikacji i nie ma zgody, na którą musiałbyś czekać. Raz zapisujesz dwa dane dostępowe, a potem każdy produkt wysyłasz jednym kliknięciem.
Ten kanał został świadomie zbudowany jako kanał dodatkowy. Uzupełnia wysyłkę do Shopify, ale nie odwzorowuje każdego jej szczegółu. Czego brakuje, napisaliśmy wprost niżej, w części o ograniczeniach — przeczytaj ją przed pierwszą wysyłką, żebyś nie czekał na synchronizację stanów magazynowych, której dla WooCommerce po prostu nie ma.
Połączenie krok po kroku: trzy dane
Połączenie konfigurujesz w profilu sklepu w sekcji „Połączenie z WooCommerce”. Jeśli pracujesz z osadzoną aplikacją Shopify, tę samą kartę znajdziesz tam w zakładce Ustawienia.
Po pierwsze adres sklepu: adres Twojego sklepu WooCommerce, na przykład https://moj-sklep.pl. Musi zaczynać się od https://. Adres http:// zostanie odrzucony, i to z konkretnego powodu: dane dostępowe idą przy każdym żądaniu jako Basic Auth i przez nieszyfrowane połączenie wędrowałyby otwartym tekstem.
Po drugie i po trzecie Consumer Key (zaczyna się od ck_) i Consumer Secret (zaczyna się od cs_). Oba generujesz w swoim sklepie w WooCommerce → Ustawienia → Zaawansowane → REST API. Kluczowe jest tam uprawnienie Odczyt/zapis — przy samym odczycie Sellivo nie może tworzyć produktów.
Przy zapisie Sellivo sprawdza dodatkowo, czy adres sklepu wskazuje na prawdziwy, publicznie dostępny adres; adresy wewnętrzne i lokalne są odrzucane. Dane dostępowe zapisujemy zaszyfrowane (AES-256-GCM) i nigdy nie zwracamy ich do przeglądarki. Po połączeniu widzisz już tylko adres sklepu i przycisk rozłączenia.
Jeśli przy łączeniu pojawi się błąd, prawie zawsze chodzi o jeden z tych trzech punktów: http zamiast https, literówka w adresie albo klucz z uprawnieniem tylko do odczytu.
Wysyłka produktu i śledzenie jej przebiegu
Wysyłka działa jako zadanie w tle. W osadzonej aplikacji Shopify po imporcie znajdziesz przycisk „Opublikuj także w WooCommerce”; z aplikacji webowej uruchamiasz wysyłkę osobno dla każdego produktu.
Jeśli kanał nie jest połączony albo konfiguracja jest niekompletna, nie zostanie wysłane zupełnie nic. Sellivo tworzy wtedy wpis w dzienniku ze statusem „blocked” i podaje powód. Nie ma więc połowicznych wysyłek, po których musiałbyś sprawdzać w sklepie, co faktycznie dotarło.
Każda próba — udana czy nie — trafia do historii wysyłek produktu razem z liczbą przesłanych zdjęć i wariantów oraz adnotacją, czy było to utworzenie, czy aktualizacja. Ta historia to najpewniejsze miejsce, żeby zrozumieć niepowodzenie.
Co dociera do Twojego sklepu WooCommerce
Sellivo buduje z Twojego produktu najpierw model niezależny od kanału, a potem mapuje go na REST API WooCommerce. Przesyłane są tytuł, opis w HTML, opis SEO jako opis skrócony, cena i SKU oraz zdjęcia i opcje wariantów. Dokładne przyporządkowanie znajdziesz w tabeli poniżej.
Produkt zawsze powstaje ze statusem publish — trybu roboczego dla WooCommerce na razie nie ma. Jeśli chcesz sprawdzić produkt przed publikacją, zrób to w Sellivo, zanim uruchomisz wysyłkę.
Przy zdjęciach jest jedna właściwość, którą warto znać: WooCommerce sam pobiera zdjęcia po adresie URL. Dlatego Sellivo przekazuje wyłącznie adresy publicznie dostępne. Zdjęcia AI, które wewnętrznie istnieją jako obiekt danych, udostępniamy w tym celu pod publicznym adresem Sellivo w postaci https://www.sellivo.app/api/media/<id>, żeby Twój sklep mógł je pobrać. Wysyłane są zdjęcia oryginalne i zatwierdzone zdjęcia AI; niezatwierdzone szkice AI zostają poza wysyłką.
Produkty z wariantami trafiają do sklepu wraz z wariacjami
To miejsce, w którym WooCommerce różni się technicznie od Shopify, a Sellivo bierze tę pracę na siebie. Najpierw system ustala prawdziwe osie wariantów: liczą się tylko te opcje, które faktycznie mają więcej niż jedną wartość. Jeśli Twój produkt ma trzy kolory, ale wszystkie w rozmiarze M, to „kolor” jest osią, a „rozmiar” nie. Tak ma być, bo inaczej wariacja byłaby oparta na cesze identycznej dla wszystkich.
Gdy jest co najmniej jedna oś, Sellivo zakłada produkt jako produkt z wariantami i wpisuje osie jako widoczne atrybuty wariacji. Cena wędruje wtedy do wariacji zamiast do produktu nadrzędnego — tak oczekuje tego WooCommerce. Poszczególne wariacje dodawane są następnie w drugim kroku, każda ze swoją ceną i swoim SKU. Wymaga to osobnych wywołań, bo REST API WooCommerce nie potrafi utworzyć produktu i wariacji za jednym razem.
Gdy nie ma żadnej osi, powstaje produkt prosty z ceną i SKU bezpośrednio przy produkcie. SKU stoi celowo albo przy produkcie prostym, albo przy wariacjach, nigdy w obu miejscach — w WooCommerce dane SKU może wystąpić w sklepie tylko raz.
Dwa rodzaje wariacji są pomijane: te z niepełną kombinacją cech i te, które powtarzałyby tę samą kombinację po raz drugi. WooCommerce i tak odrzuca duplikaty. Jeśli przejdzie tylko część wariacji, Sellivo zgłasza wysyłkę jako udaną z adnotacją w rodzaju „2 z 6 wariacji nie powiodło się”. Jeśli nie przejdzie ani jedna, wysyłka liczy się jako nieudana, mimo że produkt już powstał — żebyś wiedział, że w sklepie leży niekompletny produkt.
Ponowna wysyłka oznacza aktualizację, a nie duplikat
Sellivo zapamiętuje ID produktu w WooCommerce z ostatniej udanej wysyłki. Przy kolejnej wysyłce to ID idzie razem z żądaniem, a adapter aktualizuje istniejący produkt, zamiast tworzyć nowy. Bez tej logiki po trzech wysyłkach miałbyś ten sam produkt w sklepie trzy razy.
Przy aktualizacji produktu z wariantami istniejące wariacje są najpierw usuwane, a potem tworzone od nowa. To również jest zamierzone: WooCommerce inaczej po prostu zostawiłby stare wariacje i po zmianie asortymentu miałbyś w sklepie rozmiary albo kolory, których już w ogóle nie ma. Jeśli Sellivo nie zdoła usunąć starych wariacji, wysyłka i tak liczy się jako udana, ale z adnotacją „produkt zaktualizowany, stare wariacje nieusunięte”.
Gdy aktualizacja się nie powiedzie, Sellivo zachowuje znane ID produktu w dzienniku. Kolejna próba znów więc aktualizuje i nie tworzy drugiego produktu.
Gdy usunąłeś produkt w sklepie docelowym
To przypadek, który wiele systemów obsługuje źle. Sellivo robi to tak: próba aktualizacji trafia w pustkę, WooCommerce odpowiada „nie znaleziono” (HTTP 404). Zamiast w nieskończoność rozbijać się o to martwe ID, Sellivo jednorazowo zakłada produkt od nowa i przesyła potem wariacje jak przy pierwszej wysyłce. Znów masz więc w sklepie działający produkt, z nowym ID WooCommerce, które od tego momentu służy do kolejnych aktualizacji.
Dotyczy to wyraźnie tylko odpowiedzi „nie znaleziono”. Inne błędy — złe dane dostępowe, wygasłe uprawnienia, błędy serwera — zgłaszamy jako niepowodzenie i nie zasłaniamy ich cichym utworzeniem produktu od nowa.
Ograniczenia, które warto znać wcześniej
Ponieważ WooCommerce jest zbudowany jako kanał dodatkowy, kilku rzeczy dostępnych dla Shopify tutaj nie ma. Nie ma synchronizacji cen ani stanów magazynowych: codzienne porównanie ze stroną źródłową zapisuje zmiany cen wyłącznie do Shopify. Gdy zmieni się Twoja cena zakupu, poprawiasz produkt w Sellivo i wysyłasz go do WooCommerce ponownie.
Nie ma też bramki jakości. Inaczej niż przy wysyłce do Shopify, przed wysyłką do WooCommerce Sellivo nie sprawdza, czy kontrola jakości została zaliczona. Jeśli Ci na tym zależy, przeprowadź ją wcześniej samodzielnie.
Nie są przesyłane stany magazynowe, przypisanie kategorii ani tagi — te prowadzisz w WooCommerce. Poza wysyłką zostają również cena porównawcza i GTIN, czyli ceny przekreślone i kody kreskowe, a także pola meta z adresem źródłowym i wartościami compliance, które towarzyszą wysyłce do Shopify. Ochrony katalogu i eksportu CSV dla tego kanału nie ma.
Na jeden sklep Sellivo możesz zapisać dokładnie jeden sklep WooCommerce. Gdy rozłączysz połączenie, przechodzi ono w stan „rozłączone”, a kolejne wysyłki są blokowane. Twoje już przesłane produkty pozostają w WooCommerce nienaruszone.
| Pole w Sellivo | Pole w WooCommerce | Uwaga |
|---|---|---|
| Tytuł | name | Przesyłany zawsze. |
| Opis (HTML) | description | Formatowanie zostaje zachowane. |
| Opis SEO | short_description | W WooCommerce pojawia się jako opis skrócony. |
| Cena | regular_price | Tylko przy produktach prostych; w produkcie z wariantami cena stoi przy wariacji. |
| SKU | sku | Albo przy produkcie prostym, albo przy wariacjach, nigdy w obu miejscach. |
| Zdjęcia | images (źródło i tekst alternatywny) | Tylko adresy publicznie dostępne; zatwierdzone zdjęcia AI przez /api/media/<id>. |
| Opcje wariantów | attributes | Osią wariacji stają się tylko opcje z więcej niż jedną wartością. |
| Stany magazynowe, kategorie, tagi | — | Nie są przesyłane; prowadzisz je w WooCommerce. |
| Cena porównawcza i GTIN | — | Ceny przekreślone i kody kreskowe nie idą razem. |
| Pola meta (adres źródłowy, compliance) | — | Tylko przy wysyłce do Shopify, nie przy WooCommerce. |
Przy wysyłce do WooCommerce status produktu to zawsze publish — trybu roboczego dla tego kanału na razie nie ma.
FAQ
Czy potrzebuję dodatkowej wtyczki do WooCommerce?
Nie. Sellivo korzysta z REST API, które jest już częścią WooCommerce. Generujesz tam tylko klucz w WooCommerce → Ustawienia → Zaawansowane → REST API i wpisujesz Consumer Key oraz Consumer Secret w Sellivo.
Dlaczego adres mojego sklepu jest odrzucany?
Adres musi zaczynać się od https:// — przez http dane dostępowe szłyby jako Basic Auth otwartym tekstem. Sellivo sprawdza dodatkowo, czy adres jest publicznie dostępny; adresy wewnętrzne i lokalne są odrzucane. Trzeci częsty powód to klucz z uprawnieniem tylko do odczytu zamiast Odczyt/zapis.
Czy przy każdej wysyłce powstaje w sklepie nowy produkt?
Nie. Sellivo zapamiętuje ID produktu w WooCommerce z ostatniej udanej wysyłki i tym ID aktualizuje istniejący produkt. Jeśli usunąłeś go w WooCommerce, Sellivo rozpozna to po odpowiedzi „nie znaleziono” i jednorazowo utworzy go od nowa.
Czy stany magazynowe i ceny są synchronizowane na bieżąco?
Nie. Codzienne porównanie ze stroną źródłową zapisuje zmiany cen wyłącznie do Shopify, a stanów magazynowych kanał WooCommerce nie przesyła w ogóle. Gdy coś zmieniasz, poprawiasz produkt w Sellivo i wysyłasz go ponownie.
Czy warianty koloru i rozmiaru trafiają do sklepu?
Tak. Jeśli Twój produkt ma przynajmniej jedną opcję z kilkoma wartościami, Sellivo zakłada go jako produkt z wariantami i dodaje wariacje w drugim kroku — każdą z ceną i SKU. Opcje, które mają tę samą wartość we wszystkich wariacjach, celowo nie stają się osią wariantu.
Czy mogę połączyć kilka sklepów WooCommerce?
Na jeden sklep Sellivo możesz zapisać dokładnie jeden sklep WooCommerce. Gdy rozłączysz połączenie, kolejne wysyłki są blokowane; produkty już przesłane pozostają w WooCommerce nienaruszone.
Czy moje zdjęcia AI też są przesyłane?
Zatwierdzone zdjęcia AI tak, niezatwierdzone szkice nie. Ponieważ WooCommerce sam pobiera zdjęcia po adresie URL, Sellivo udostępnia zdjęcia AI pod publicznym adresem w postaci https://www.sellivo.app/api/media/<id>.
Z linku do produktu prosto do Twojego sklepu WooCommerce
Zapisz raz adres sklepu, Consumer Key i Consumer Secret — potem każdy produkt wychodzi jednym kliknięciem, ze zdjęciami i wariantami.
Wypróbuj za darmo