Moduł do integracji Prestashop

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

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.

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ń.

S
Description
Moduł Prestashop Orbito v2
Readme
554 KiB
Languages
JavaScript 99.7%
Shell 0.3%