# 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ć…

- Strona: <https://www.datafirefly.com/pl/documentation/dforderedit/>
- Język: pl
- Zaktualizowano: 2026-09-23
- Inne języki: [fr](https://www.datafirefly.com/documentation/dforderedit/index.md), [en](https://www.datafirefly.com/en/documentation/dforderedit/index.md), [es](https://www.datafirefly.com/es/documentation/dforderedit/index.md), [de](https://www.datafirefly.com/de/documentation/dforderedit/index.md), [it](https://www.datafirefly.com/it/documentation/dforderedit/index.md), [nl](https://www.datafirefly.com/nl/documentation/dforderedit/index.md), [pt](https://www.datafirefly.com/pt/documentation/dforderedit/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

## 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.

Profil bez prawa edycji zamówień nie widzi edytora. Aby udostępnić go nowemu profilowi, nadaj mu prawo edycji zamówień i zaznacz uprawnienia modułu w **Zaawansowane > Zespół > Uprawnienia**.

## 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.

Jeśli nie wystawiono jeszcze faktury, nie ma czego generować ponownie: aktualizowane jest tylko zamówienie.

## 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.
