76 lines
4.5 KiB
Markdown
76 lines
4.5 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`
|
|
|
|
## 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.
|
|
|
|
Formularz ma wiersz dla każdego statusu Orbito i listę statusów PrestaShop do
|
|
wyboru. Kilka statusów Orbito może wskazywać ten sam status PrestaShop.
|
|
Lista Orbito pochodzi z kontraktu `orders.status.search`; brak dostawcy,
|
|
niejednoznaczny dostawca lub błąd pobierania są widoczne w formularzu.
|
|
|
|
Przed udostępnieniem formularza moduł uzupełnia nowe pola na podstawie starych
|
|
przypisań. Migracja jest addytywna: można ją wznowić po przerwaniu, a kolejne
|
|
uruchomienia nie nadpisują zapisanych wyborów ani celowo wyczyszczonych pól.
|
|
Stare klucze `mapping.state_<PS ID>` pozostają bez zmian. Nowe pola
|
|
`mapping.orbito_<Orbito ID>` mają pierwszeństwo tylko dla danego statusu Orbito;
|
|
dopóki pole nie zostało zapisane, synchronizacja odczytuje stare przypisanie.
|
|
Zapisanie pustego pola wyłącza wysyłkę, bez przywracania starego
|
|
przypisania. Odczyt obejmuje również statusy nieobecne już na listach — formularz
|
|
pokazuje ich zapisane ID. Konflikt starych przypisań nie wybiera celu automatycznie:
|
|
pokazuje wszystkie cele i wymaga wybrania jednego lub wyczyszczenia pola.
|
|
|
|
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ń.
|