Edycja zamówienia PrestaShop z DataFirefly Order Editor
Instalacja modułu, wybór ustawień i edycja zatwierdzonego zamówienia w edytorze na pełnym ekranie: produkty, klient, adresy, rabaty, dostawa, korekta i nowa faktura, historia i cofanie zmian.
Wprowadzenie
DataFirefly Order Editor pozwala edytować zatwierdzone zamówienie jak koszyk: dodawać lub usuwać produkty, zmieniać kombinację, korygować ilość lub cenę, zmieniać adres, przewoźnika, a nawet klienta, usuwać lub dodawać rabat. Edycja odbywa się w przestrzeni na pełnym ekranie, z podsumowaniem przed / po po prawej stronie, które odświeża się w trakcie pracy. Nic nie jest zapisywane przed Twoim potwierdzeniem.
Każda zmiana jest przeliczana przez silnik koszyka PrestaShop. Już wystawiona faktura jest anulowana korektą i zastępowana nową fakturą albo, jeśli wolisz, aktualizowana, a każda zmiana trafia do historii z porównaniem i możliwością cofnięcia.
Moduł działa na PrestaShop od 8.0 do 9.x z PHP od 7.4 do 8.5. Jest przetłumaczony na polski, francuski, angielski, hiszpański, niemiecki, włoski, niderlandzki i portugalski.

Instalacja
- W Moduły > Menedżer modułów kliknij Załaduj moduł i upuść plik
dforderedit-2.0.0.zip. - Podczas instalacji moduł nadaje swoje uprawnienia profilom, które już mogą edytować zamówienia (na przykład SuperAdmin, Sprzedawca, Logistyk).
- Otwórz zamówienie w Zamówienia > Zamówienia: blok Edytor zamówień pojawia się pod listą produktów, z przyciskiem Edytuj to zamówienie i historią zmian.
Profil, który może przeglądać zamówienia, ale nie może ich edytować, widzi blok tylko do odczytu: historię i zarchiwizowane pliki PDF, bez przycisku edycji. Aby udostępnić edytor nowemu profilowi, nadaj mu uprawnienie do edycji zamówień, a następnie zaznacz uprawnienia modułu w Zaawansowane > Zespół > Uprawnienia.

Ustawienia
Strona modułu ma trzy zakładki: Pulpit, Dziennik zmian i Ustawienia. Ustawienia są pogrupowane w trzy bloki.
Kiedy można edytować zamówienie?
- Statusy zamówienia, w których edycja jest dozwolona: statusy Anulowane, Zwrócone i Błąd płatności są domyślnie wykluczone.
- Okno edycji: liczba dni od daty zamówienia, przez które można je edytować. 0 = bez limitu.
Faktury i stan magazynowy
- Domyślna obsługa faktury: korekta i nowa faktura (zalecane, gdy faktura została już wysłana) albo aktualizacja istniejącej faktury pod tym samym numerem. Wybór można zmienić przy każdej edycji.
- Domyślnie przywracaj usunięte ilości do magazynu.
Zespół i identyfikowalność
- Domyślnie powiadamiaj klienta e-mailem.
- Dodawaj prywatną notatkę do zamówienia po każdej zmianie.
- Wymagaj notatki wewnętrznej wyjaśniającej każdą zmianę.
- Zezwalaj na przypisanie zamówienia innemu klientowi.

Edycja zamówienia
Otwieranie edytora
Na stronie zamówienia kliknij Edytuj to zamówienie. Edytor otwiera się na pełnym ekranie. Po lewej sekcje Produkty, Klient i adresy, Rabaty, Dostawa oraz Faktura, stan magazynowy i powiadomienie. Po prawej podsumowanie: liczba oczekujących zmian, nowe sumy, podatki, płatności i alerty. Klawisz Esc lub przycisk Zamknij zamyka edytor; jeśli zostały niezastosowane zmiany, pojawia się prośba o potwierdzenie.
Produkty
- Dodawanie produktu: wpisz nazwę, indeks, EAN lub ID w wyszukiwarce. Strzałki i klawisz Enter pozwalają wybierać z klawiatury. Widoczny jest stan magazynowy i cena katalogowa klienta. Dla produktu z kombinacjami wybierz kombinację.
- Zmiana kombinacji: lista pokazuje stan każdej kombinacji, a poprzednia kombinacja pozostaje widoczna pod pozycją.
- Korekta ilości lub ceny: przyciski − / + dla ilości. Cena zapłacona przez klienta jest zachowana i przypomniana pod ceną; link Zastosuj cenę katalogową pobiera aktualną cenę dla tego klienta (grupa, ceny specjalne, rabaty ilościowe).
- Wprowadzanie cen netto lub brutto: przełącznik nad tabelą domyślnie odpowiada sposobowi wyświetlania cen grupy klienta. Cena wprowadzona brutto jest przeliczana na netto, które pozostaje podstawą zamówienia.
- Usuwanie pozycji: pozycja zostaje przekreślona i można ją przywrócić do momentu potwierdzenia.
Każda pozycja ma oznaczenie: Zmieniony, Dodano, Zmieniono kombinację lub Usunięty. Pozycja podarowana przez regułę koszyka jest oznaczona etykietą Prezent z reguły koszyka.

Klient i adresy
Wybierz inny adres klienta z listy lub kliknij Edytuj pola tego adresu, aby poprawić ulicę lub kod pocztowy. Zmieniony adres jest zapisywany jako nowy adres powiązany tylko z tym zamówieniem: wcześniejsze zamówienia i książka adresowa klienta się nie zmieniają. Jeśli zmienia się kraj, VAT produktów i dostawy jest przeliczany.
Jeśli ustawienie jest włączone, Przypisz innemu klientowi pozwala wyszukać klienta po nazwisku, e-mailu lub ID, a następnie wybrać jego adres dostawy i adres do faktury. Nowa faktura jest wystawiana na jego nazwisko. Zmiana klienta jest odrzucana, jeśli zamówienie ma już korekty zwrotów.

Rabaty i dostawa
Odznacz rabat, aby usunąć go z zamówienia. Wyszukiwarka dodaje istniejącą regułę koszyka po nazwie lub kodzie. Dodaj dowolny rabat tworzy rabat kwotowy brutto lub procentowy z wybraną przez Ciebie nazwą. Jest zapisywany jako wyłączona reguła koszyka, zarezerwowana dla klienta i już wykorzystana: nie można go użyć ponownie.
Przewoźnicy są przedstawieni w kartach z ceną i czasem dostawy dla zmienionego koszyka; ci, którzy nie mogą dostarczyć tego koszyka, są oznaczeni. Koszt dostawy można obsłużyć na trzy sposoby:
- Zachowaj koszt dostawy zamówienia: kwota netto pozostaje, podatek podąża za adresem, jeśli zmienia się kraj.
- Przelicz z wybranym przewoźnikiem: obowiązkowe przy zmianie przewoźnika.
- Ustal koszt dostawy (brutto).

Faktura, stan magazynowy i powiadomienie
- Faktura: anuluj korektą i wystaw nową fakturę albo zaktualizuj istniejącą fakturę (ten sam numer).
- Przywróć usunięte ilości do magazynu.
- Wyślij klientowi podsumowanie zmienionego zamówienia, w jego języku.
- Status zamówienia po zmianie: status zmienia się przez natywną historię zamówienia PrestaShop, ze zwykłymi e-mailami.
- Notatka wewnętrzna, zapisywana w historii zmian (obowiązkowa, jeśli wymaga tego ustawienie).
Podsumowanie i potwierdzenie
Chwilę po każdej zmianie podsumowanie pokazuje sumę brutto przed i po wraz z różnicą, rozbicie na produkty, rabaty, dostawę i podatki, a następnie saldo płatności: Pozostało do zapłaty przez klienta, Nadpłata do zwrotu klientowi lub płatności dokładnie pokrywające nową sumę. Alerty są zebrane w sekcji Sprawdź przed zastosowaniem: brak towaru, faktura już wystawiona, zamówienie już wysłane, produkt gratisowy, reguła koszyka, której minimum nie jest już spełnione, przewoźnik, który już nie dostarcza.
Kliknij Sprawdź i zastosuj (lub Ctrl + Enter): potwierdzenie wymienia wszystko, co zostanie zapisane, dokumenty, które powstaną, i nowy status. Kliknij Potwierdź i zastosuj, a strona przeładuje się z zaktualizowanym zamówieniem.

Faktura i korekta
Tryb korekta i nowa faktura (domyślny)
- PDF faktury jest archiwizowany w niezmienionej postaci, zanim cokolwiek zostanie zapisane.
- Korekta anuluje fakturę na całą kwotę. Jej PDF również jest archiwizowany.
- Wystawiana jest nowa faktura z kolejnym numerem. Przypisywane są do niej pozycje, rabaty, przewoźnik i płatności.
Anulowana faktura zawsze pobiera się z oryginalnym PDF, w panelu i na koncie klienta, i zawiera adnotację o anulowaniu. Wychodzi też tak, jak ją wystawiono, w zbiorczym eksporcie Zamówienia > Faktury (według daty lub statusu) i nigdy nie otrzymuje fikcyjnej płatności, gdy zamówienie przechodzi później w status opłacony.
Jeśli zamówienie ma kilka faktur, wszystkie są anulowane korektami i zastępowane jedną nową fakturą.
Tryb aktualizacji
Kwoty istniejącej faktury są aktualizowane, a faktura zachowuje swój numer, tak jak robi to natywnie PrestaShop. PDF sprzed zmiany jest mimo to archiwizowany.
Jeśli nie wystawiono jeszcze żadnej faktury, nie ma czego generować ponownie: aktualizowane jest tylko zamówienie.
Płatności i zwroty
Otrzymana już płatność pozostaje przy zamówieniu i jest przypisywana do nowej faktury. Po zmianie komunikat pokazuje kwotę pozostałą do zapłaty lub nadpłatę, z przyciskami Zarejestruj płatność i Częściowy zwrot, które otwierają natywne narzędzia PrestaShop. Moduł nigdy sam nie pobiera ani nie zwraca pieniędzy: zwrotu dokonujesz u swojego operatora płatności.
Stan magazynowy
Stan magazynowy jest korygowany o różnicę, z natywnymi ruchami magazynowymi. Ilość zmieniona z 2 na 3 zużywa jedną sztukę, usunięta pozycja wraca do magazynu, jeśli opcja jest zaznaczona, zamieniona kombinacja zwraca starą i zużywa nową. Jeśli zamówienie zostało już wysłane, alert prosi o sprawdzenie, czy towar faktycznie wrócił.
Zablokowane pozycje
- Pozycja zwrócona lub z refundacją: nie można jej zmienić ani usunąć, aby nie zafałszować istniejących korekt.
- Pozycja personalizowana (tekst, plik przesłany przez klienta): można ją tylko usunąć. Pliki klienta nigdy nie są naruszane.
- Produkt usunięty z katalogu: pozycję można tylko usunąć.
E-mail do klienta
Jeśli zaznaczysz powiadomienie, klient otrzyma e-mail w swoim języku z listą zmian, nową zawartością zamówienia i kwotą do zapłaty lub do zwrotu. Ogólny e-mail PrestaShop „zamówienie zmienione” nie jest wysyłany dodatkowo. Bez powiadomienia klient nic nie otrzymuje.

Historia i cofanie zmian
Historia w bloku zamówienia przedstawia każdą zmianę na osi czasu: data, pracownik, suma przed i po, rodzaj dokumentu, notatka wewnętrzna. Pokaż szczegóły otwiera porównanie pozycja po pozycji (ilości, ceny, kombinacje), rabaty, adresy, przewoźnika oraz linki do zarchiwizowanych plików PDF: anulowana faktura (oryginalny PDF), faktura przed zmianą i korekta anulująca.

Ostatnią zmianę zamówienia można cofnąć przyciskiem Cofnij tę zmianę, dopóki zamówienie od tego czasu się nie zmieniło. Odwrotne zmiany są ładowane do edytora: sprawdzasz podgląd i zatwierdzasz jak zwykłą zmianę, z jej dokumentami. Cofnięcie również jest zapisywane.

Jeśli dwóch pracowników pracuje nad tym samym zamówieniem, drugi zostaje zablokowany: gdy zamówienie zmieniło się od otwarcia edytora (inna zmiana, płatność, zwrot), podgląd i zastosowanie są odrzucane z przyciskiem Odśwież.
Przy odinstalowaniu historia i zarchiwizowane pliki PDF są zachowywane, aby anulowane faktury pozostały rozpoznawalne po ponownej instalacji modułu.
Pulpit i dziennik
Pulpit podsumowuje ostatnie 30 dni: zmiany, zmienione zamówienia, zmianę netto sum (przeliczoną na walutę domyślną), wystawione korekty i nowe faktury, cofnięte zmiany, ostatnie zmiany i zmiany według pracownika.

Dziennik zmian wymienia wszystkie zmiany w sklepie z zamówieniem, klientem, pracownikiem, datą, sumami przed / po, różnicą, rodzajem faktury i notatką. Można go filtrować po ID lub numerze zamówienia, pracowniku i okresie oraz eksportować do CSV.

Aktualizacja z wersji 1.0.0
Załaduj dforderedit-2.0.0.zip na poprzednią wersję w menedżerze modułów. Aktualizacja dodaje swoje kolumny i nowe ustawienia, nie naruszając historii ani zarchiwizowanych plików PDF. Faktury anulowane w wersji 1.0.0 zachowują oryginalny PDF w historii; zmian wykonanych w wersji 1.0.0 nie można cofnąć automatycznie.
Dla programistów
actionOrderEdited: natywny hook PrestaShop, wywoływany zorderpo każdej zmianie (moduł ps_emailalerts nie jest wywoływany, aby uniknąć ogólnego e-maila do klienta).actionDfOrderEditAfter: wywoływany zorder,id_dforderedit_log,changes(pozycje, rabaty, adresy, przewoźnik, sumy) iid_order_slips.
Przeliczenie odbywa się w tymczasowym koszyku, który nigdy nie jest powiązany z zamówieniem i jest usuwany na końcu. Podgląd jest liczony w transakcji, która zawsze jest wycofywana. Rozbicie VAT pozycji jest przeliczane natywną metodą PrestaShop.
Rozwiązywanie problemów
Przycisk Edytuj to zamówienie się nie pojawia
Blok podaje przyczynę: status zamówienia poza edytowalnymi statusami, zamówienie starsze niż okno edycji, usunięty klient lub profil tylko do odczytu. Dostosuj ustawienia modułu lub uprawnienia profilu.
„To zamówienie zostało zmienione od otwarcia edytora”
Inny pracownik, płatność lub zwrot zmieniły zamówienie. Kliknij Odśwież, aby zacząć od najnowszej wersji.
Przewoźnik nie może dostarczyć nowego koszyka
Waga, kwota lub strefa wykraczają poza przedziały przewoźnika. Wybierz innego przewoźnika lub ustal koszt dostawy ręcznie.
Nie udało się ustawić dokładnie ceny pozycji
Reguła katalogu (na przykład rabat grupowy) działa dodatkowo na wprowadzoną cenę. Sprawdź cenę w podsumowaniu przed potwierdzeniem.
Zamówienie z koszyka z wieloma przewoźnikami
Gdy koszyk został podzielony na kilka zamówień, reguły koszyka są przeliczane tylko dla edytowanego zamówienia. Przypomina o tym alert w podsumowaniu.