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_statejako statusu docelowego; - zmiana zmapowanego statusu w Orbito tworzy wpis
order_historiesw 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ń.