Files
core-prestashop/README.md
T

44 lines
2.4 KiB
Markdown

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