Files
core-prestashop/README.md
T

3.4 KiB

Moduł do integracji Prestashop

Moduł podłącza się do sklepu podanego w konfiguracji i dodaje zamówienia za pomocą modułu core/orders

Daty zamówień i płatności

Daty PrestaShop bez oznaczenia strefy (date_add, date_upd) są odczytywane w strefie sklepu ustawionej w „Połączenie ze sklepem → Strefa czasowa sklepu”. Domyślnie jest to Europe/Warsaw, również dla istniejących konfiguracji bez tego pola. Dla sklepu w innej strefie ustaw jej nazwę IANA, np. Europe/London. Przeliczenie uwzględnia czas letni i zimowy, niezależnie od strefy serwera. Daty zawierające już Z lub offset zachowują wskazany moment.

Poprawka dotyczy nowych importów zamówień i płatności. Nie zmienia dat już zapisanych zamówień ani istniejących płatności. Niepoprawne daty korzystają z czasu importu; powtórzona godzina przy zmianie czasu oznacza jej pierwsze wystąpienie, ponieważ data PrestaShop nie rozróżnia obu wystąpień.

Statusy zamówień

Orbito jest źródłem prawdy dla statusów zamówień. Przy ładowaniu zakładki „Mapowanie statusów” moduł pobiera aktualną listę i nazwy statusów z PrestaShop. Zapisane mapowanie jest używane wyłącznie w kierunku Orbito → PrestaShop:

  • nowe zamówienie otrzymuje w Orbito status ustawiony w „Import zamówień”, bez odczytywania current_state jako statusu docelowego;
  • zmiana zmapowanego statusu w Orbito tworzy wpis order_histories w PrestaShop;
  • zmiany statusu wykonane w PrestaShop nigdy nie nadpisują statusu w Orbito;
  • status niezmapowany nie jest wysyłany do sklepu;
  • jeden status Orbito może wskazywać tylko jeden status PrestaShop.

Klucz Webservice wymaga co najmniej odczytu order_states i orders oraz prawa POST do order_histories. Synchronizacja nie używa sendemail=1, więc sama zmiana z Orbito nie zleca PrestaShop wysłania wiadomości statusowej do klienta.

Każda kombinacja PrestaShop jest zapisywana w core/products jako osobny produkt. Tożsamość źródłowa ma postać product:<id produktu>:combination:<id kombinacji>; dla produktu bez kombinacji identyfikator kombinacji wynosi 0. Przy kolejnym imporcie zgodny rekord ze starszym, numerycznym sourceId jest bezpiecznie migrowany po SKU. Dane wariantu obejmują jego referencję, EAN, lokalizację magazynową, zdjęcie i wagę produktu powiększoną o wpływ wagi kombinacji. Cena bazowa netto katalogu jest pobierana z ceny produktu PrestaShop powiększonej o wpływ ceny kombinacji; cena pozycji zamówienia pozostaje niezależną ceną transakcyjną i nie nadpisuje katalogu.

Podczas importu zamówienia moduł zapisuje publiczne wiadomości klienta jako customer_message. Obsługuje standardowe zasoby PrestaShop: messages po id_order i id_cart, wątki customer_threads oraz ich customer_messages, a także standardowe gift_message. Dotyczy to też DeliveryMessage / pola delivery_message z checkoutu, które PrestaShop zapisuje w standardowym messages po id_cart. Klucz Webservice musi mieć uprawnienie GET do tych zasobów. Niedostępny endpoint powoduje ostrzeżenie bez logowania treści wiadomości i nie blokuje importu zamówienia.

Wiadomości prywatne i wpisy pracowników są pomijane, a kopie tej samej treści z checkoutu i wątku klienta są deduplikowane. Moduł nie odczytuje prywatnych tabel ani niestandardowych pól checkoutów. Zmiana działa dla nowo importowanych zamówień; nie wykonuje automatycznego backfillu istniejących zamówień.