Use hook-backed outbound status mapping

This commit is contained in:
fatequod
2026-09-30 11:49:04 +02:00
parent 599a7b9863
commit 1f79463f51
9 changed files with 392 additions and 169 deletions
+16
View File
@@ -30,6 +30,22 @@ Zapisane mapowanie jest używane wyłącznie w kierunku Orbito → PrestaShop:
- 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.