Integracja z WooCommerce

Integracja z WooCommerce pozwala Państwu połączyć sklep internetowy WooCommerce z Gem Logic. Po połączeniu można wysyłać produkty z Gem Logic do sklepu WooCommerce oraz pobierać zamówienia z WooCommerce do Gem Logic. Dzięki temu katalog produktów i zarządzanie zamówieniami są zsynchronizowane na obu platformach.

Konfiguracja

Wygeneruj klucze API w WooCommerce

Przed połączeniem WooCommerce z Gem Logic należy wygenerować klucze API w swoim sklepie WooCommerce.

  1. Zaloguj się do swojego panelu administracyjnego WordPress.

  2. Przejdź do WooCommerce ‣ Ustawienia ‣ Zaawansowane ‣ REST API.

  3. Kliknij Dodaj klucz.

  4. Wypełnij szczegóły:

    • Opis: wprowadź nazwę identyfikującą ten klucz (np. Integracja Gem Logic).

    • Użytkownik: wybierz użytkownika WordPress, który będzie używany do połączenia API.

    • Uprawnienia: wybierz Odczyt/Zapis. Jest to wymagane, aby Gem Logic mógł zarówno odczytywać zamówienia, jak i tworzyć/aktualizować produkty w Państwa sklepie.

  5. Kliknij Wygeneruj klucz API.

  6. Skopiuj Klucz konsumencki i Sekret konsumencki. Zostaną one wyświetlone tylko raz, dlatego należy je zapisać w bezpiecznym miejscu.

Ważne

Sekret konsumencki jest wyświetlany tylko raz. Jeśli Państwo go utracą, będą musieli unieważnić klucz i wygenerować nowy.

Połącz WooCommerce z Gem Logic

  1. W Gem Logic przejdź do Configuration ‣ Sales channels.

  2. Otwórz kanał sprzedaży, który chce Pan/Pani połączyć z WooCommerce, lub utwórz nowy.

  3. Zaznacz pole wyboru WooCommerce.

  4. Wypełnij następujące pola:

    • URL: pełny adres URL sklepu WooCommerce (np. https://www.panaski.com). Nie dołączaj ukośnika na końcu.

    • WooCommerce Key: wklej klucz konsumencki, który wygenerował Pan/Pani wcześniej.

    • WooCommerce Secret: wklej sekret konsumencki, który wygenerował Pan/Pani wcześniej.

  5. Jeśli używa Pan/Pani wtyczki Perfect WooCommerce Brands w swoim sklepie WooCommerce, zaznacz pole wyboru WooCommerce brands plugin. Dzięki temu Gem Logic będzie synchronizować marki produktów z WooCommerce.

  6. Zapisz kanał sprzedaży.

Wskazówka

Upewnij się, że sklep WooCommerce używa protokołu HTTPS. Dane dostępowe do API są szyfrowane i przechowywane bezpiecznie w Gem Logic.

Przypisywanie produktów do kanału sprzedaży

Aby produkty mogły zostać przesłane do WooCommerce, muszą być przypisane do kanału sprzedaży WooCommerce.

  1. Przejdź do Products.

  2. Otwórz produkt i przejdź do jego sekcji kanały sprzedaży.

  3. Dodaj kanał sprzedaży WooCommerce do produktu.

  4. Upewnij się, że produkt ma skonfigurowaną regułę cenową dla tego kanału sprzedaży, aby posiadał cenę po przesłaniu do WooCommerce.

Przesyłanie produktów

Może Pan/Pani przesyłać produkty z Gem Logic do sklepu WooCommerce. W ten sposób produkty zostaną utworzone lub zaktualizowane w WooCommerce na podstawie danych z Gem Logic.

Przesyłanie pojedynczego produktu

Aby przesłać pojedynczy produkt, otwórz go w Gem Logic i użyj akcji przesyłania z sekcji kanałów sprzedaży produktu. Produkt zostanie utworzony w WooCommerce, jeśli jeszcze nie istnieje, lub zaktualizowany, jeśli posiada już identyfikator WooCommerce.

Przesyłanie wszystkich produktów

Aby przesłać jednocześnie wszystkie produkty przypisane do kanału sprzedaży WooCommerce:

  1. Przejdź do Configuration ‣ Sales channels.

  2. Otwórz kanał sprzedaży WooCommerce.

  3. Kliknij Prześlij wszystkie produkty do WooCommerce.

Operacja jest wykonywana w tle. Postęp można śledzić na stronie historia przesyłania.

Co jest przesyłane

Podczas przesyłania produktu do WooCommerce synchronizowane są następujące dane:

  • SKU (używane do dopasowywania produktów między oboma systemami)

  • Nazwa i opis (na podstawie języka kanału sprzedaży)

  • Cena standardowa i cena promocyjna (z reguły cenowej dla tego kanału sprzedaży)

  • Obrazy (ponownie przesyłane tylko w przypadku zmian)

  • Kategorie i kolekcje (tworzone w WooCommerce, jeśli nie istnieją)

  • Atrybuty (tworzone jako globalne atrybuty WooCommerce)

  • Tagi

  • Ilość w magazynie

  • Marki (jeśli wtyczka WooCommerce brands jest włączona)

  • Typ produktu: prosty lub zmienny (z wariantami)

Produkty zmienne i warianty

Jeśli produkt w Gem Logic jest oznaczony jako produkt nadrzędny, jest przesyłany jako produkt zmienny w WooCommerce. Wszystkie produkty podrzędne (warianty) są przesyłane jako wariacje produktu. Każdy wariant zawiera własną cenę, SKU, obraz i wartości atrybutów (np. rozmiar, kolor).

Dezaktywacja produktu

Może Pan/Pani dezaktywować produkt w WooCommerce z poziomu Gem Logic. Ustawia to status produktu na wersja robocza w WooCommerce, czyniąc go niewidocznym w sklepie bez usuwania go.

Historia przesyłania

Każda operacja przesyłania jest rejestrowana. Może Pan/Pani przeglądać historię przesyłania na stronie szczegółów kanału sprzedaży. Każdy wpis w historii pokazuje:

  • Czas rozpoczęcia i zakończenia

  • Status (rozpoczęty, zakończony, nieudany lub częściowy sukces)

  • Łączna liczba produktów, udanych i nieudanych

  • Wskaźnik sukcesu i czas trwania

  • Szczegółowe wyniki dla każdego produktu (kliknij Wyświetl szczegóły, aby zobaczyć, które produkty zakończyły się powodzeniem lub niepowodzeniem)

Pobieranie produktów

Może Pan/Pani pobrać produkty ze swojego sklepu WooCommerce do Gem Logic. Jest to szczególnie przydatne podczas wstępnego importu, gdy po raz pierwszy łączy Pan/Pani swój sklep.

  1. Przejdź do Configuration ‣ Sales channels.

  2. Otwórz kanał sprzedaży WooCommerce.

  3. Kliknij Pobierz produkty z WooCommerce.

Operacja ta jest uruchamiana jako zadanie w tle i importuje następujące dane dla każdego produktu:

  • SKU, nazwa i opis

  • Cena regularna i cena promocyjna

  • Kategorie i marki

  • Obrazy (pobrane i przechowywane w Gem Logic)

  • Tagi

  • Ilości w magazynie

  • Atrybuty i metale

  • Warianty produktu (dla produktów zmiennych)

Informacja

Produkty, które już istnieją w Gem Logic (dopasowane według ID WooCommerce lub SKU), są pomijane podczas importu. Tworzone są tylko nowe produkty.

Pobieranie zamówień

Można pobierać ukończone zamówienia z WooCommerce do Gem Logic.

Pobierz zamówienia ręcznie

  1. Przejdź do Configuration ‣ Sales channels.

  2. Otwórz kanał sprzedaży WooCommerce.

  3. Kliknij Pobierz zamówienia z WooCommerce.

Proces uruchamia się w tle. Zostanie Pan/Pani przekierowany(a) na stronę historia pobrań, gdzie można monitorować postęp w czasie rzeczywistym.

Automatyczne pobieranie zamówień

Zamówienia można również pobierać automatycznie zgodnie z harmonogramem przy użyciu systemu zadań w tle. Zapewnia to regularne importowanie nowych ukończonych zamówień bez ręcznej interwencji.

Co jest importowane

Podczas pobierania zamówień z WooCommerce importowane są następujące dane:

  • Klucz zamówienia (używany jako unikalny identyfikator zamówienia)

  • Dane kontaktowe klienta (nazwisko, adres, e-mail, telefon) — kontakt jest tworzony lub aktualizowany w CRM

  • Data zamówienia i waluta

  • Pozycje zamówienia: każda pozycja zawiera produkt (dopasowany według ID WooCommerce lub SKU), ilość, ceny (bez VAT i z VAT) oraz stawkę podatkową

  • Potrącenie zapasów: zapasy są automatycznie potrącane dla każdej pozycji zamówienia

Informacja

Tylko zamówienia o statusie ukończone są importowane. Zamówienia o innych statusach (np. w trakcie realizacji, wstrzymane, oczekujące) są pomijane.

Informacja

Zamówienia, które zostały już zaimportowane (dopasowane według klucza zamówienia), są pomijane, aby uniknąć duplikatów.

Historia pobrań

Każda operacja pobierania jest rejestrowana. Historię pobrań można przeglądać ze strony szczegółów kanału sprzedaży. Każdy rekord zawiera:

  • Czas rozpoczęcia i zakończenia

  • Status (rozpoczęty, zakończony, nieudany lub częściowy sukces)

  • Całkowita liczba przetworzonych zamówień, liczba nowych utworzonych zamówień, pominiętych i niepomyślnych

  • Czas trwania i komunikaty o błędach