44 lines
2.4 KiB
Markdown
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ń.
|