Edycja zamówienia PrestaShop z DataFirefly Order Editor

Wprowadzenie

DataFirefly Order Editor dodaje edytor na stronie każdego zamówienia w panelu administracyjnym, bezpośrednio pod blokiem Produkty. Pozwala edytować zatwierdzone zamówienie jak koszyk: dodawać i usuwać produkty, zmieniać kombinację, poprawiać ilość lub cenę, zmieniać adres albo przewoźnika, usuwać lub dodawać rabat. Każda zmiana jest przeliczana przez silnik koszyka PrestaShop, a faktura jest anulowana korektą i wystawiana ponownie albo aktualizowana, według Twojego wyboru.

Moduł działa na PrestaShop od 8.0 do 9.x. Jest przetłumaczony na polski, angielski, francuski, hiszpański, niemiecki, włoski, niderlandzki i portugalski.

Instalacja

1. W Moduły > Menedżer modułów kliknij Załaduj moduł i upuść plik dforderedit-1.0.0.zip.
2. Podczas instalacji moduł nadaje swoje uprawnienia profilom, które już mogą edytować zamówienia (na przykład SuperAdmin, Sprzedawca, Logistyk).
3. Otwórz zamówienie: blok Edytor zamówień pojawi się pod blokiem Produkty.

Konfiguracja

Strona konfiguracji modułu zawiera pięć ustawień:

• Statusy zamówienia, w których edycja jest dozwolona: edytor jest dostępny tylko dla zamówień w tych statusach. Anulowane, Zwrot środków i Błąd płatności są domyślnie wykluczone.
• Domyślna obsługa faktury: korekta i nowa faktura (zalecane) albo aktualizacja istniejącej faktury z tym samym numerem. Wybór można zmienić przy każdej edycji.
• Domyślnie przywracaj usunięte ilości do magazynu.
• Domyślnie powiadamiaj klienta e-mailem.
• Dodawaj prywatną notatkę do zamówienia po każdej zmianie.

Edycja zamówienia

Otwieranie edytora

Na stronie zamówienia kliknij Edytuj to zamówienie. Dopóki niczego nie potwierdzisz, zamówienie pozostaje nietknięte: przycisk Resetuj cofa wszystkie bieżące zmiany, a przeglądarka ostrzega, jeśli opuszczasz stronę z niezastosowanymi zmianami.

Produkty

• Dodanie produktu: wpisz nazwę, indeks, EAN lub ID w wyszukiwarce (kilka słów, w dowolnej kolejności). Strzałki i klawisz Enter pozwalają wybierać z klawiatury. W przypadku produktu z kombinacjami wybierz kombinację z wyświetlonej listy.
• Zmiana kombinacji: lista pokazuje stan magazynowy każdej kombinacji. Cena nowej kombinacji jest przejmowana automatycznie i pozostaje edytowalna.
• Korekta ilości lub ceny: cena zapłacona przez klienta jest domyślnie zachowana. Link Zastosuj cenę katalogową ustawia aktualną cenę dla tego klienta (grupa, ceny specjalne, rabaty ilościowe).
• Wprowadzanie netto lub brutto: przełącznik nad tabelą wybiera tryb. Domyślnie odpowiada sposobowi wyświetlania cen w grupie klienta. Cena wpisana brutto jest przeliczana na netto, które pozostaje podstawą zamówienia.
• Usunięcie pozycji: ikona kosza przekreśla pozycję, ikona strzałki ją przywraca.

Adresy

Wybierz inny adres klienta z listy albo kliknij Edytuj pola tego adresu, aby poprawić ulicę lub kod pocztowy. Edytowany 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.

Rabaty

Odznacz rabat, aby usunąć go z zamówienia. Wyszukiwarka dodaje istniejącą regułę koszyka po nazwie lub kodzie. Link Dodaj dowolny rabat tworzy rabat kwotowy brutto lub procentowy z wybraną nazwą, bez korzystania z katalogu reguł koszyka. Ten rabat jest zapisywany jako wyłączona reguła koszyka, zarezerwowana dla klienta i już wykorzystana: nie można jej ponownie użyć w koszyku.

Dostawa

Lista przewoźników zawiera tylko tych, którzy mogą dostarczyć zmieniony koszyk pod wybrany adres, z ceną i czasem dostawy. Dla kosztu dostawy są trzy tryby:

• Zachowaj koszt dostawy zamówienia: kwota netto pozostaje, podatek dostosowuje się do adresu, jeśli zmienia się kraj.
• Przelicz z wybranym przewoźnikiem: obowiązkowe przy zmianie przewoźnika.
• Ustal koszt dostawy (brutto).

Opcje

• Status zamówienia po zmianie: status zmienia się przez natywną historię PrestaShop, ze zwykłymi e-mailami.
• Przywróć usunięte ilości do magazynu.
• Wyślij klientowi podsumowanie zmienionego zamówienia, w jego języku.
• Faktura: korekta i nowa faktura albo aktualizacja istniejącej faktury.
• Notatka wewnętrzna, zapisywana w historii zmian.

Nowe sumy i potwierdzenie

Chwilę po każdej zmianie pasek przypięty do dołu ekranu pokazuje sumę brutto przed i po, różnicę oraz kwotę, którą klient musi jeszcze dopłacić, albo nadpłatę do zwrotu. Link Szczegóły otwiera porównanie pozycja po pozycji (ilości, ceny, stawki podatku), rabaty, adresy i wszystkie sumy. Ostrzeżenia pojawiają się powyżej: za mało towaru, reguła koszyka, której minimum nie jest już osiągnięte, przewoźnik, który już nie dostarcza.

Kliknij Zastosuj zmiany: potwierdzenie wymienia zmienione pozycje, rabaty, zmianę przewoźnika, dokumenty, które zostaną utworzone, i nowy status. Kliknij Potwierdź i zastosuj, a strona przeładuje się ze zaktualizowanym zamówieniem.

Faktura i korekta

Tryb korekty i nowej faktury (domyślny)

1. PDF faktury jest archiwizowany w niezmienionej postaci, przed jakimkolwiek zapisem.
2. Korekta anuluje fakturę na całą kwotę. Jej PDF również jest archiwizowany.
3. Nowa faktura jest wystawiana z kolejnym numerem. Pozycje, rabaty, przewoźnik i płatności są do niej przypisywane.

Link do pobrania anulowanej faktury, w panelu i na koncie klienta, zawsze zwraca jej oryginalny PDF. Anulowana faktura nie jest już proponowana w formularzu dodawania płatności.

Tryb aktualizacji

Kwoty istniejącej faktury są aktualizowane i zachowuje ona swój numer, tak jak robi to natywnie PrestaShop. PDF sprzed zmiany jest mimo to archiwizowany. Zamówienie z kilkoma fakturami zawsze przechodzi przez tryb korekty i nowej faktury.

Płatności i zwroty

Otrzymana już płatność pozostaje przy zamówieniu. Gdy nowa suma jest wyższa, PrestaShop pokazuje pozostałą kwotę jak przy każdej płatności częściowej. Gdy jest niższa, nadpłata pojawia się w edytorze, a zwrot odbywa się u operatora płatności.

Gdy zamówienie przechodzi później w status opłacony, PrestaShop zwykle dodaje płatność dla każdej nieopłaconej faktury. Moduł zapobiega tej fikcyjnej płatności na fakturach anulowanych korektą.

Magazyn

Stan magazynowy jest korygowany o różnicę. Zwiększenie ilości z 2 do 3 zużywa jedną sztukę, usunięta pozycja zwraca swoją ilość do magazynu, jeśli opcja jest zaznaczona, a wymieniona kombinacja oddaje starą i zużywa nową. Ilości zarezerwowane są przeliczane na końcu.

Zablokowane pozycje

• Pozycja zwrócona: nie można jej zmienić ani usunąć, aby istniejące korekty pozostały poprawne. Pozostałe pozycje zamówienia można edytować.
• Pozycja personalizowana (tekst, plik przesłany przez klienta): można ją usunąć, ale nie zmienić. Tekst personalizacji jest wyświetlany pod pozycją, a pliki klienta nigdy nie są naruszane.
• Produkt usunięty z katalogu: pozycję można tylko usunąć.

Historia i identyfikowalność

Historia pod edytorem wymienia każdą zmianę: datę, pracownika, zmienione pozycje, rabaty, adresy, przewoźnika i status, sumę przed i po, notatkę wewnętrzną oraz linki do zarchiwizowanych PDF. Prywatna notatka podsumowuje także zmianę w wiadomościach zamówienia.

Po odinstalowaniu historia i zarchiwizowane PDF są zachowywane, aby anulowane faktury pozostały rozpoznawalne po ponownej instalacji modułu.

Dla programistów

• actionOrderEdited: natywny hook PrestaShop, wywoływany z order po każdej zmianie.
• actionDfOrderEditAfter: wywoływany z order, id_dforderedit_log, changes (pozycje, rabaty, adresy, przewoźnik, sumy) i id_order_slips.

Przeliczenie korzysta z tymczasowego koszyka, który nigdy nie jest powiązany z zamówieniem i jest usuwany na końcu. Podgląd jest liczony w transakcji, która jest wycofywana.

Rozwiązywanie problemów

Edytor nie pojawia się w zamówieniu

Sprawdź, czy status zamówienia należy do edytowalnych statusów w konfiguracji oraz czy profil pracownika ma prawo edycji zamówień i podglądu modułu.

Przewoźnik nie może dostarczyć nowego koszyka

Waga, kwota lub strefa wykraczają poza przedziały przewoźnika. Wybierz innego przewoźnika z listy albo ustal koszt dostawy ręcznie.

Nie udało się dokładnie ustawić ceny pozycji

Reguła katalogu (na przykład rabat grupowy) działa dodatkowo na wpisaną cenę. Sprawdź cenę w szczegółach 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 ostrzeżenie w podglądzie.