Release 1.2.2: recover missed PrestaShop status changes

This commit is contained in:
fatequod
2026-10-08 10:57:21 +02:00
parent 86cf1a232f
commit d140625ba0
11 changed files with 401 additions and 19 deletions
+16
View File
@@ -50,6 +50,22 @@ 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.
Oprócz hooka zmiany statusu integracja co minutę sprawdza maksymalnie 50
najdawniej sprawdzanych mapowań z własnej bazy. Odczytuje aktualny status przez
kontrakt `orders.search` i uzupełnia zgubione zdarzenia. Po przejściu partii
sprawdza kolejne zamówienia; pełny obieg może trwać kilka minut. Kontrola
okresowa obejmuje zamówienia z `previousStatusId`, czyli po zmianie statusu,
aby nie wysyłać do sklepu początkowego statusu importu.
Potwierdzony status, jego datę i docelowy status PrestaShop zapisuje lokalnie.
Przed POST utrwala osobny znacznik próby. Jeśli odpowiedź zginie albo kontener
zostanie przerwany, przy następnym sprawdzeniu wykonuje wyłącznie GET. Zgodny
stan sklepu potwierdza poprzednią próbę; niezgodny blokuje dalsze zapisy i
generuje ostrzeżenie `previous write outcome is uncertain`. Taki przypadek
wymaga ręcznej weryfikacji historii i stanu zamówienia przed wznowieniem;
integracja nie ponawia samodzielnie niepewnego POST. Błąd przed utrwaleniem
próby można sprawdzić ponownie. Pominięcia i błędy obsługi zdarzeń są logowane.
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