WooCommerce: klucze REST API i synchronizacja sklepu

Do czego to służy

Konektor WooCommerce łączy Zaksio ze sklepem na WordPressie przez REST API v3. Pobiera zamówienia, wysyła stany (i opcjonalnie ceny), pozwala zmapować produkty oraz przekazuje numery przesyłek.

Gdzie to znaleźć w aplikacji

Sprzedaż i logistyka, „Kanały sprzedaży”, „Dodaj kanał sprzedaży”, rodzaj „WooCommerce”, a w kanale zakładka „Połączenie”. Pola formularza: „Adres sklepu”, „Consumer key” i „Consumer secret”.

Skąd wziąć klucze

1. W panelu WordPress wejdź w WooCommerce, Ustawienia, Zaawansowane, REST API i kliknij „Dodaj klucz”.
2. Wpisz opis (np. Zaksio), wybierz użytkownika z rolą administratora lub menedżera sklepu i ustaw uprawnienia „Odczyt/Zapis”.
3. Kliknij „Wygeneruj klucz API” i od razu skopiuj Consumer key (zaczyna się od ck_) oraz Consumer secret (zaczyna się od cs_). Sekret pokazuje się tylko raz.
4. W Zaksio wklej adres sklepu (koniecznie z https://, bez /wp-admin i bez /wp-json) oraz oba klucze, kliknij „Zapisz poświadczenia”, a potem „Sprawdź połączenie”.

Wymagania sklepu

• Sklep działa pod HTTPS. Adresy bez https:// są odrzucane.
• W WordPressie, Ustawienia, Bezpośrednie odnośniki, wybrana jest struktura inna niż „Zwykle”. Inaczej REST API nie odpowiada.
• Użytkownik, do którego przypisano klucz, ma wystarczające uprawnienia, a klucz ma dostęp „Odczyt/Zapis”.

Nazwy menu w WordPressie i WooCommerce mogą się różnić zależnie od wersji i motywu. Oficjalna instrukcja uwierzytelniania: woocommerce.github.io/woocommerce-rest-api-docs, sekcja „Authentication”.

Co synchronizuje

• Zamówienia: pobierane odpytywaniem co kilka minut, od ostatnio zmodyfikowanego. Zamówienia „oczekuje na płatność” są pomijane do czasu opłacenia.
• Oferty: produkty proste i warianty. Wariant ma identyfikator w postaci „id rodzica:id wariantu”.
• Stany: wysyłane paczkami po 100 pozycji.
• Ceny: tylko po włączeniu ustawienia kanału „syncPrices”. Zaksio zakłada ceny brutto w sklepie (opcja cen wpisanych z podatkiem) i zmienia cenę regularną, a cena promocyjna zostaje bez zmian.
• Numer przesyłki: WooCommerce nie ma na to natywnego pola, więc numer trafia do notatki dla klienta i do pola „_zaksio_tracking”. Bez wtyczki do śledzenia przesyłek nie pojawi się w osobnej sekcji.

Ustawienia zależne od wtyczek

WooCommerce nie ma standardowego miejsca na punkt odbioru (paczkomat) ani NIP kupującego. Nazwy pól zapisywane przez wtyczki sklepu można wskazać w ustawieniach kanału („pickupPointMetaKey” i „nipMetaKey”). Konektor zna kilka popularnych nazw, ale nie potwierdziliśmy ich na żywych sklepach. Zamówienia zawierają dane osobowe kupujących, traktuj je zgodnie z zasadami ochrony danych obowiązującymi w Twojej firmie.

Czego jeszcze nie ma

• Zwrotów: refundy WooCommerce nie są obsługiwane, a częściowy zwrot nie zmienia zamówienia w Zaksio.
• Opłat dodatkowych (np. dopłata za pobranie) jako pozycji zamówienia.
• Sprawdzania waluty przy wysyłce cen: waluta cennika musi być walutą sklepu.
• Webhooków: brak natychmiastowych powiadomień o zamówieniach.
• Weryfikacji na żywym sklepie. Niepewny jest m.in. kształt błędów pojedynczych pozycji w paczce.