PrestaShop: klucz webservice i synchronizacja sklepu

Do czego to służy

Konektor PrestaShop łączy Zaksio ze sklepem przez webservice (wersje 1.7, 8 i 9). Pobiera zamówienia z pozycjami, danymi klienta i adresami, listę ofert (także kombinacje), wysyła stany i przekazuje numery przesyłek. Cen konektor celowo nie wysyła.

Gdzie to znaleźć w aplikacji

Sprzedaż i logistyka, „Kanały sprzedaży”, „Dodaj kanał sprzedaży”, rodzaj „PrestaShop”, a w kanale zakładka „Połączenie”. Pola obowiązkowe: „Adres sklepu” (https, bez /api na końcu) i „Klucz webservice”. Opcjonalne: „Id stanów zamówienia oznaczających opłacone”, „Id stanu zamówienia 'wysłane'” oraz „Id stanów oznaczających anulowanie” (id po przecinku).

Skąd wziąć klucz

1. W panelu PrestaShop wejdź w Parametry zaawansowane, Webservice i włącz opcję włączenia webservice PrestaShop.
2. Kliknij „Dodaj nowy klucz webservice”, wygeneruj klucz i ustaw status „Włączone”.
3. Nadaj uprawnienia odczytu (GET): orders, customers, addresses, countries, currencies, carriers, order_states, products, combinations, stock_availables, order_carriers, configurations i messages.
4. Nadaj uprawnienia zapisu: PUT dla stock_availables i order_carriers oraz POST dla order_histories. Są potrzebne do stanów i numerów przesyłek.
5. W Zaksio wpisz adres sklepu i klucz, kliknij „Zapisz poświadczenia”, a potem „Sprawdź połączenie”.

Oficjalna dokumentacja: devdocs.prestashop-project.org, sekcja Webservice. Nazwy menu i zasobów mogą różnić się między wersjami PrestaShop.

Wymagania sklepu

• Sklep działa przez HTTPS.
• Na hostingu działa mod_rewrite. Jeśli mimo poprawnego klucza dostajesz błąd 401, dopisz w pliku .htaccess sklepu linię „CGIPassAuth On” (albo regułę SetEnvIf Authorization), tak aby nagłówek autoryzacji dochodził do PrestaShop.
• Klucz webservice ma 32 znaki i jest używany jako login uwierzytelniania, bez hasła.

Co synchronizuje

• Zamówienia: pobierane odpytywaniem co kilka minut. Statusy „opłacone” i „anulowane” rozpoznajemy po konfiguracji sklepu albo po id wpisanych w polach opcjonalnych.
• Oferty: produkty i kombinacje (identyfikator w postaci „id:atrybut”).
• Stany: wysyłane paczkami po 20 pozycji. Zapis idzie w XML, bo webservice nie czyta JSON, ale konektor robi to sam.
• Numer przesyłki: zapisywany w przewoźniku zamówienia. Jeśli podasz „Id stanu zamówienia 'wysłane'”, zamówienie dostanie też ten stan.

Czego jeszcze nie ma

• Wysyłania cen: cena w PrestaShop jest netto, a cena brutto zależy od reguł podatkowych, kraju klienta i cen specjalnych, więc ryzyko błędnej ceny jest zbyt duże.
• Zwrotów: webservice nie ma wspólnego zasobu zwrotów dla wszystkich modułów.
• Rabatów z kodów (cart rules): ceny pozycji są po rabatach produktowych, bez rabatu koszykowego.
• Pewnego rozpoznawania paczkomatów: zależy od modułu dostawy i jest tylko heurystyką z adresu dostawy.
• Zapisu stanów dla towarów, których stan liczy sam PrestaShop (zarządzanie zaawansowane magazynem).
• Weryfikacji na żywym sklepie. Niepewne są m.in. kształt listy zasobów w JSON, domyślne id stanów anulowania (6, 7, 8) i brak wysyłki wiadomości e-mail przy zmianie stanu.