Elbuz łączy się ze stroną Wix kluczem API, pobiera produkty i zamówienia do jednego katalogu i odsyła na stronę ceny i stany. Strona pozostaje stroną — zmienia się tylko to, skąd biorą się liczby.
Kiedy to się przyda:
- Pojawił się drugi kanał sprzedaży — katalog strony łączy się w Elbuz z marketplace’ami.
- Ceny liczysz w Elbuz — eksport zapisuje je w wariantach na Wix.
- Zamówienia ze strony i z marketplace’ów żyją osobno — spływają do jednej kolejki dokumentów.
- Produkt ukryto na stronie — następny przebieg wyłączy aktywność karty.
Od czego zacząć: utwórz na koncie Wix klucz API i skopiuj ID strony.
Co potrafi połączenie z Wix
- Działa z obiema wersjami katalogu — V1 i V3 rozpoznawane są automatycznie.
- Przenosi produkt do karty — nazwę, opis, markę, kod, cenę po rabacie, stan, widoczność, kategorię i zdjęcia.
- Rozkłada warianty — każdy kolor czy rozmiar staje się osobną kartą w rodzinie wariantów.
- Przenosi widoczność — produkt ukryty na stronie zostaje wyłączony w Elbuz.
- Pobiera zamówienia jako dokument „Zamówienie klienta” ze statusami realizacji i płatności.
- Odsyła na stronę ceny i stany — tylko do Twoich wariantów, reszty produktu nie rusza.
Czego potrzeba od Wix: klucz API i ID strony
| Gdzie | Co zrobić |
|---|---|
| Konto Wix | Otwórz manage.wix.com → „Ustawienia konta” → „Klucze API” |
| Tamże | Utwórz klucz z uprawnieniami Wix Stores i eCommerce i skopiuj go |
| Tamże | Skopiuj ID strony — to ciąg w adresie panelu zaraz po /dashboard/ |
| Elbuz | Okno importu → Twój szablon „Wix.com” → karta „Połączenie” → pola „Klucz API Wix” i „ID strony (Site ID)” |
Klucz API Wix jest wyświetlany tylko raz: skopiuj go od razu i przechowuj w bezpiecznym miejscu. Zgubisz go — utwórz nowy, a stary unieważnij. Bez uprawnień Wix Stores i eCommerce zapytania o katalog lub zamówienia zwrócą odmowę dostępu.
Jak połączyć krok po kroku
- Utwórz szablon typu „Wix.com” i wklej do karty „Połączenie” klucz oraz ID strony.
- Kliknij „Sprawdź połączenie” — odpowiedź pokaże wersję katalogu Twojej strony.
- Zaznacz, co importować: produkty, zamówienia czy jedno i drugie, i czy pobierać zdjęcia.
- Zapisz szablon i uruchom import ręcznie.
- Porównaj ze stroną kilka kart (cena, stan, kategoria) i kilka zamówień (pozycje, kwota, klient) — rozbieżność lepiej wychwycić na kilkunastu kartach. Potem ustaw harmonogram szablonu.
Dwie wersje katalogu: V1 i V3
W Wix współistnieją dwie generacje katalogu — stara (V1) i nowa (V3); strona działa tylko na jednej. Elbuz sam rozpoznaje wersję przy każdym uruchomieniu, nie musisz niczego wybierać.
Różnica jest jedna: aktualizacja cen i stanów z powrotem na stronę działa dla V3. Na V1 import do Elbuz działa w pełni, a aktualizacja zwrotna — nie, i dziennik poda to wprost.
Co trafia do karty
| Dane Wix | Pole produktu w Elbuz |
|---|---|
| nazwa produktu | Nazwa |
| opis | Opis |
| marka | Producent |
| kod () | Kod |
| cena i cena obniżona | Cena (sprzedaży) i stara cena |
| stan | Ilość |
| widoczność produktu | Status |
| kolekcja / kategoria | Kategoria |
| obrazy | Zdjęcia (jeśli zaznaczono pole) |
| opcje wariantu (kolor, rozmiar…) | Cechy-opcje produktu |
Cena jest brana tak, jak widzi ją klient: jeśli w Wix ustawiono cenę obniżoną, to ona staje się ceną sprzedaży, a pełna trafia do „starej ceny” — przekreślona cena ze strony zostaje też u Ciebie.
Warianty produktu
Jeśli produkt ma warianty — rozmiary, kolory — Elbuz zakłada każdy wariant jako osobną kartę i łączy je w rodzinę wariantów według nazwy produktu bazowego; osobnej karty „produktu głównego” nie ma.
- Nazwa karty to nazwa produktu i wartości opcji po myślniku: „Koszulka — Czerwony / M”.
- Kod jest brany z samego wariantu, a wybór klienta (kolor, rozmiar) trafia do cech-opcji.
- Kart wychodzi więcej niż produktów na stronie: dziennik pisze wprost — „produktów (łącznie z wariantami)”.
Kategorie
Elbuz najpierw czyta listę kolekcji (w V3 — kategorii) strony, a dopiero potem przypisuje produkty. Jeśli listy nie udało się pobrać (na przykład kluczowi brakuje uprawnień), produkty trafią do kategorii technicznej „Produkty - wix” — wyłączonej i niebiorącej udziału w eksportach; w dzienniku pojawi się osobny wiersz. Jak postępować z kategoriami technicznymi — przegląd importu.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Czyja cena zostanie w karcie
Cenę po kolei zapisują trzy mechanizmy, kolejność jest zawsze ta sama:
- Import z Wix wpisuje cenę ze strony.
- Reguły narzutu przechodzą tylko po kartach utworzonych w tym przebiegu i tylko tam, gdzie koszt własny jest większy od zera. Wix nie przekazuje kosztu własnego, więc w nowym produkcie zostaje cena ze strony. Wypełniony koszt własny (ręcznie lub z cennika dostawcy) — reguła nadpisze cenę z Wix. „Stała cena” i „Nie aktualizuj” wyłączają produkt spod narzutu.
- Formuły pól z zaznaczonym „Stosuj przy imporcie katalogu bazowego ze źródeł zewnętrznych” mają ostatnie słowo: obejmują zarówno nowe, jak i dawno założone produkty spełniające ich warunek.
Co kolejny przebieg robi z Twoimi poprawkami
Każde uruchomienie nadpisuje w istniejącej karcie: nazwę, opis, markę, kod, cenę, starą cenę, ilość i aktywność. Poprawisz nazwę czy opis w Elbuz — następny przebieg bez ostrzeżenia przywróci tekst ze strony.
Nie rusza: zdjęć (dodawane są tylko do nowych kart), cech-opcji, miejsca produktu w Twoim drzewie kategorii, adresu strony produktu, kosztu własnego i pól, których w Wix nie ma.
Karta jest rozpoznawana nie po kodzie, lecz po odcisku nazwy, z którą produkt przyjechał pierwszy raz. Zmiana nazwy w Elbuz nie chroni przed aktualizacją — nazwa wróci ze strony. A zmiana nazwy na Wix da nową kartę: starej przebieg już nie znajdzie.
Kartę zablokujesz w sekcji „Ochrona podczas importu”: „Nie aktualizuj” wyłącza ją z przebiegu całkowicie, „Stała cena” chroni tylko cenę i starą cenę. Więcej: jak zablokować swoją wartość.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
1
Przełącznik „Nie aktualizuj”2
Przełącznik „Stała cena”- Nie aktualizuj — chroni całą kartę przed przebiegiem importu z Wix.
- Stała cena — chroni przed przebiegiem tylko cenę i starą cenę.
Produkt zniknął ze strony lub został ukryty
| Co się stało na Wix | Co będzie z kartą w Elbuz |
|---|---|
| Produkt usunięto | Zostaje bez zmian: z ostatnią ceną i stanem, aktywna, bez wiersza w dzienniku. Usuń ją ręcznie |
| Produkt ukryto | Następny przebieg wyłączy aktywność; przywrócisz widoczność — wróci i aktywność |
| Usunięto jeden wariant | Jego karta zostaje w rodzinie wariantów ze starymi liczbami |
| Strona na V3 nie zwróciła wariantów produktu | Produkt pominięto, w dzienniku czerwony wiersz z jego nazwą (co zrobić) |
Pola „usuwaj to, czego nie ma w źródle” w szablonie Wix nie ma. Dlatego ukrywanie produktu na stronie jest pewniejsze niż usuwanie: ukryty dotrze do Elbuz, usunięty — nie. Ogólna zasada — produkt zniknął ze źródła.
Wyłączyć aktywność czy usunąć kartę
Wyłączenie aktywności jest odwracalne: karta zostaje w katalogu ze wszystkimi danymi, znika tylko z witryny Elbuz. Warto wiedzieć dwie rzeczy:
- Eksport do Wix i tak bierze nieaktywną kartę — wynik filtrowania opiera się na fladze „Eksportuj do pliku (do sklepu)” i aktywnej kategorii. Nie chcesz wysyłać jej ceny i stanu — dodaj warunek aktywności do filtrowania w szablonie eksportu.
- Aktywność ustala strona — włączysz kartę ręcznie, a na Wix produkt jest ukryty, i najbliższy przebieg znowu ją wyłączy.
Usunięcie zabiera też powiązanie z produktem na Wix: eksport już go nie widzi, a następny import założy kartę od nowa — z nową datą dodania, nowym adresem strony produktu i bez Twoich poprawek.
Jak odbierać zamówienia z Wix
Zamówienia Elbuz czyta z jednej warstwy eCommerce, więc wersja katalogu nie ma tu znaczenia. Pierwsze uruchomienie przenosi historię; potem pobierane są zamówienia, które zmieniły się od poprzedniego uruchomienia — istniejące są aktualizowane, a nie dublowane.
Do dokumentu trafiają:
- numer, daty utworzenia i zmiany;
- imię, nazwisko i telefon odbiorcy, e-mail klienta, adres dostawy z miastem, kodem pocztowym i krajem;
- waluta, sposób dostawy, kwota i pozycje z kodem, ceną i ilością;
- status realizacji i status płatności — osobnymi polami z osobnymi dopasowaniami w karcie „Powiązane ustawienia”.
Każde zamówienie trafia jako niezatwierdzony dokument „Zamówienie klienta”: towar nie jest zdejmowany ze stanu ani rezerwowany. Rezerwację tworzą tylko zatwierdzone dokumenty — i tylko przy włączonej ewidencji magazynowej.
Statusy i kolejny przebieg
Status dokumentu pochodzi ze statusu realizacji przez dopasowanie (przycisk „Statusy zamówienia”), status płatności — z własnego dopasowania. Niedopasowany status to pierwszy status słownika, czyli „jak nowe”.
Twój status obsługi kolejny przebieg zmienia tylko wtedy, gdy status na Wix faktycznie zmienił się od poprzedniego razu. Statusy płatności i dostawy oraz sposoby płatności i dostawy przyjmowane są ze strony bez zmian. Zatwierdzonego dokumentu przebieg w ogóle nie rusza. Ogólna mechanika — dwa statusy jednego zamówienia.
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Osobne pole „stan zamówienia”, którym Wix oznacza anulowanie, nie jest przenoszone do dokumentu. Zamówienie anulowane na koncie Wix zostanie w Elbuz w poprzednim statusie — zamknij je ręcznie. Zwrot pieniędzy widać po statusie płatności.
Natychmiastowe powiadomienie o zamówieniu Wix wysyła tylko aplikacjom ze swojego App Market. Przy kluczu API zamówienia przychodzą według harmonogramu: opóźnienie równa się odstępowi między uruchomieniami. Dla aktywnego sklepu ustaw harmonogram kilkanaście razy na dobę.
Ponownie pobrać zamówienia za okres
W karcie szablonu rozwiń blok „Zaawansowane”: są tam pola „Import zamówień począwszy od daty (RRRR-MM-DD)” i „Import zamówień począwszy od ID”.
- Ustawisz wcześniejszą datę — następny przebieg pobierze zamówienia od niej i zaktualizuje istniejące dokumenty; duplikatów nie będzie.
- Wyczyścisz oba pola — przebieg przejdzie całą historię, ale istniejących dokumentów nie zaktualizuje, tylko doda brakujące.
1
Przycisk „Statusy zamówienia”2
Pole importu zamówień od daty3
Pole importu zamówień od ID- Statusy zamówienia — otwiera dopasowanie statusów zamówień Wix do statusów Elbuz.
- Import zamówień począwszy od daty (RRRR-MM-DD) — zamówienia utworzone przed tą datą są pomijane.
- Import zamówień począwszy od ID — zamówienia z niższym ID są pomijane.
Jak aktualizować ceny i stany na stronie
Kierunek odwrotny to osobny szablon eksportu typu „Wix.com” (szablony eksportu). Wix nie potrafi zaktualizować pojedynczego wariantu punktowo, dlatego Elbuz czyta cały produkt, podmienia ceny i stany tylko w Twoich wariantach i odsyła produkt jednym wywołaniem. Pozostałe warianty i struktura produktu zostają nietknięte.
- Nie tworzy nowych produktów na stronie — karty prowadzi strona. Produkty bez powiązania ze stroną są pomijane, ich liczbę widać w dzienniku.
- Niczego nie usuwa na stronie — produkt wyłączony w Elbuz z eksportu lub usunięty zostaje na Wix taki, jaki był; usuń go na koncie Wix.
- Strona na V1 nie przyjmuje eksportu (o wersjach).
- Початок або кінець
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
Aktualizacja według harmonogramu
Gdy pierwsze uruchomienie jest sprawdzone, ustaw harmonogram szablonu. Dla zamówień harmonogram to jedyna droga, więc częstotliwość wyznacza opóźnienie.
Ile udźwignie jeden przebieg
Limitu liczby produktów czy zamówień nie ma.
- Dane są pobierane stronami po 100 pozycji z sekundową przerwą między nimi; produkty zapisują się do katalogu paczkami po 500.
- Na jedno zapytanie program czeka do 120 sekund, na połączenie — 30.
- Na „zbyt wiele zapytań” — do trzech ponowień z przerwami 3, 6 i 9 sekund; potem przebieg zatrzymuje się z wierszem „429: retry limit reached”.
- Eksport zwrotny: co dziesięć produktów — wiersz w dzienniku i krótka przerwa.
Okno szablonu można zamknąć: dziennik żyje w Centrum operacji. Czas trwania Twojego katalogu widać w kolumnie „Czas trwania” i w „Historii uruchomień”.
Scenariusze
Katalog prowadzi strona, Elbuz łączy go z innymi kanałami
Co włączyć: w szablonie „Wix.com”, karta „Wybór danych do importu”, — pola „Produkty” i „Zdjęcia”, potem harmonogram.
Efekt: każdy przebieg przynosi ze strony nazwę, opis, markę, kod, cenę, ilość i aktywność. Zdjęcia dostają tylko nowe karty. Wycofuj produkt ze sprzedaży, ukrywając go na stronie — wtedy przebieg wyłączy kartę.
Ceny i dostępność prowadzi Elbuz, strona tylko je pokazuje
Co włączyć: raz zaimportuj katalog z zaznaczonym „Produkty”, żeby karty dostały powiązanie ze stroną. Potem odznacz „Produkty”, zostawiając „Zamówienia”, albo włącz w kartach „Stała cena”. Ceny na stronę wysyła szablon eksportu „Wix.com”.
Efekt: eksport zapisuje cenę, starą cenę i stan w powiązanych wariantach na Wix. Jeśli zostawisz „Produkty” bez stałej ceny, następny import przywróci w kartach ceny ze strony.
Zamówienia ze strony — w jednej kolejce z innymi kanałami
Co włączyć: pole „Zamówienia”, dopasowanie przyciskiem „Statusy zamówienia” w „Powiązanych ustawieniach” i harmonogram.
Efekt: każde zamówienie staje się niezatwierdzonym dokumentem „Zamówienie klienta”, bez duplikatów. Status menedżera przebieg zmienia tylko wtedy, gdy zmienił się status realizacji na Wix.
Ponownie pobrać zamówienia za okres
Co włączyć: w „Zaawansowanych” ustaw wcześniejszą datę w polu „Import zamówień począwszy od daty (RRRR-MM-DD)”.
Efekt: następny przebieg pobierze zamówienia zmienione po tej dacie i zaktualizuje istniejące dokumenty (ponownie pobrać zamówienia).
Chronić wybrane karty przed stroną
Co włączyć: w karcie produktu, sekcja „Ochrona podczas importu”: „Stała cena” — chronić tylko cenę, „Nie aktualizuj” — całą kartę.
Efekt: przy „Stałej cenie” pozostałe pola aktualizują się ze strony. Przy „Nie aktualizuj” przebieg niczego nie zmienia, więc pozycję ukrytą na Wix trzeba będzie wyłączyć ręcznie.
Co zrobić, gdy Wix się nie importuje
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „Wix: podaj klucz API i ID strony” | W szablonie nie ma klucza | Wklej klucz i ID strony do karty „Połączenie” (skąd je wziąć) |
| „Wix: błąd API —” i treść odmowy od strony | Klucz jest nieważny, unieważniony albo brakuje mu uprawnień Wix Stores i eCommerce; rzadziej — strona jest chwilowo niedostępna | Kliknij „Sprawdź połączenie”. W razie potrzeby utwórz na koncie Wix nowy klucz z potrzebnymi uprawnieniami |
| „Wix: nie udało się pobrać listy kategorii — produkty trafią do kategorii źródłowej” | Lista kolekcji nie przyszła — najczęściej kluczowi brakuje uprawnień | Przypisz produkty z kategorii „Produkty - wix” do swojego drzewa albo popraw uprawnienia klucza i uruchom ponownie (kategorie) |
| „Wix: strona nie zwróciła wariantów produktu — produkt pominięto, zgłoś to pomocy technicznej” | Strona na V3 nie zwróciła wariantów właśnie tego produktu | Do katalogu nie trafił wcale. Nazwa produktu jest w tym samym wierszu dziennika — przekaż ją wsparciu |
| „Wix: strona działa na starej wersji katalogu (V1) — eksport obsługuje V3” | Aktualizacja zwrotna działa dla nowego katalogu (o wersjach) | Import ze strony działa przy tym w pełni; w sprawie eksportu dla V1 napisz do wsparcia |
| „Wix: pominięto produktów niepowiązanych ze stroną” | Te produkty nie mają powiązania z kartą na Wix: nie zostały założone ze strony | Najpierw wykonaj import katalogu z Wix — to on tworzy powiązanie (aktualizacja na stronie) |
| „429: retry limit reached” | Wix odpowiada „zbyt wiele zapytań” i nie odpuścił po trzech próbach | Uruchom później, a harmonogram ustaw rzadziej; po tym wierszu przebieg jest zatrzymany (limity przebiegu) |
Jeśli przebieg się przerwał
Produkty zapisują się paczkami po 500, więc po przerwaniu część katalogu jest już zaktualizowana. Strona zamówień (do 100) zapisuje się od razu i razem z nią przesuwa się data „importuj począwszy od”, więc następne uruchomienie zacznie od miejsca przerwania. Uruchom ponownie — duplikatów nie będzie. Ogólna mechanika — jeśli przebieg się przerwał.
Przycisk „Zatrzymaj” w Centrum operacji doczytuje bieżącą stronę, zapisuje pobrane dane i następnej już nie bierze. Dla katalogu po tym nadal działają reguły narzutu, a w dzienniku zostaje zwykłe podsumowanie „Wix: katalog zaimportowany”.
Jeśli zaimportowano nie to
Produkty tego szablonu wyfiltrujesz w „Produktach” po kolumnie „Źródło: nazwa”, a nadpisane karty — po „Data aktualizacji” (jeśli zaimportowano nie to). Specyfika Wix: usuwając karty zbiorczo, usuwasz też powiązanie z produktami strony — eksport już ich nie widzi, a następny import założy je jako nowe karty. Zamówienia pobierzesz ponownie datą w „Zaawansowanych” (ponownie pobrać zamówienia).
Najczęstsze pytania
Dlaczego zamówienia z Wix przychodzą z opóźnieniem?
Natychmiastowe powiadomienia Wix wysyła tylko aplikacjom ze swojego App Market; połączenie kluczem API ich nie dostaje. Elbuz pobiera zamówienia według harmonogramu, a opóźnienie równa się odstępowi między uruchomieniami. Ustaw częstszy harmonogram.
Dlaczego zaimportowało się więcej produktów, niż jest na stronie?
Warianty stają się osobnymi kartami: produkt z trzema rozmiarami da trzy karty połączone w rodzinę wariantów. Dziennik pisze wprost — „produktów (łącznie z wariantami)” (warianty).
Czy Elbuz tworzy nowe produkty na stronie Wix?
Nie. Eksport aktualizuje ceny i stany istniejących produktów, kartami zarządza strona. Produkty bez powiązania ze stroną są pomijane, ich liczbę widać w dzienniku.
Co się stanie z produktem usuniętym lub ukrytym na stronie Wix?
Usunięty — karta zostanie z ostatnią ceną i stanem, usuń ją ręcznie. Ukryty — następny przebieg wyłączy aktywność karty, a po przywróceniu widoczności ją przywróci (produkt zniknął).
Zamówienie anulowano na stronie — dlaczego w Elbuz nie jest anulowane?
Znacznik anulowania Wix nie jest przenoszony do dokumentu: Elbuz czyta tylko statusy realizacji i płatności. Zamknij dokument ręcznie; zwrot pieniędzy widać po statusie płatności.
Czy zaimportowane zamówienie zmienia stan w katalogu?
Nie. Zamówienie trafia jako niezatwierdzony dokument „Zamówienie klienta”, a rezerwacja pojawia się dopiero po zatwierdzeniu — i tylko przy włączonej ewidencji magazynowej.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Import danych
- Szablon
- nowy szablon → typ „Wix.com”; jeden szablon — jedna strona
- Uprawnienia
- okno „Import danych” w „Uprawnieniach grup”
- Przygotuj
- klucz API Wix z uprawnieniami Wix Stores i eCommerce, strony
1
Pole „Klucz API Wix”2
Pole „ID strony (Site ID)”- Klucz API Wix — wklej klucz utworzony na koncie Wix z uprawnieniami Wix Stores i eCommerce.
- ID strony — identyfikator strony z adresu panelu Wix.
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 zamówienia z Wix trzeba połączyć z innymi kanałami — Import zamówień przez API.
- Jeśli ceny i stany z Elbuz mają trafiać na stronę — Szablony eksportu.
- Jeśli podłączasz też marketplace’y — Import katalogu przez API.
