# Przygotowanie zamówień & Picking (dfpicking) — Kompletny przewodnik

> Przegląd dfpicking przyspiesza przygotowanie zamówień w PrestaShop 8 i 9. Moduł łączy wiele zamówień w jedną listę kompletacyjną, agreguje ilości według produktu i lokalizacji magazynowej, obsługuje skanowanie kodów kreskowych (EAN13,…

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

## Przegląd

dfpicking przyspiesza przygotowanie zamówień w PrestaShop 8 i 9. Moduł łączy wiele zamówień w jedną **listę kompletacyjną**, agreguje ilości według produktu i lokalizacji magazynowej, obsługuje **skanowanie kodów kreskowych** (EAN13, UPC, ISBN lub indeks), przełącza zamówienia na natywny status **« Przygotowanie w toku »** oraz drukuje **listę kompletacyjną** i **dokumenty pakowania** (bez cen) w formacie PDF.

## Instalacja

1. Panel administracyjny → **Moduły → Menedżer modułów → Załaduj moduł**.
2. Prześlij `dfpicking.zip` i kliknij **Zainstaluj**.
3. W menu pojawi się nowa zakładka **Zamówienia → Przygotowanie (picking)**.

Kompatybilność: PrestaShop 8.0 → 9.x, PHP 7.2 → 8.4. Bez zewnętrznych zależności: moduł korzysta z natywnego silnika PDF PrestaShop.

## Konfiguracja

Przejdź do **Moduły → dfpicking → Konfiguruj**:

- **Kwalifikujące się statusy zamówień** — zamówienia o tych statusach można dodać do listy kompletacyjnej (domyślnie: płatność zaakceptowana).
- **Status stosowany na początku przygotowania** — nadawany każdemu zamówieniu dodanemu do listy (domyślnie: natywny status « Przygotowanie w toku »).
- **Status stosowany na końcu** — opcjonalny status nadawany przy zamknięciu listy (domyślnie: bez zmiany).
- **E-mail o zmianie statusu** — czy wysyłać natywny e-mail do klienta przy zmianach statusu (domyślnie: wyłączone).

Uzupełnij pole **Lokalizacja** na stronie Katalog → Stany magazynowe: lista kompletacyjna będzie wtedy sortowana według lokalizacji, zgodnie z układem magazynu.

## Tworzenie listy kompletacyjnej

1. Otwórz **Zamówienia → Przygotowanie (picking)** i kliknij **Nowa lista kompletacyjna**.
2. Zaznacz zamówienia do przygotowania (dostępne pole « zaznacz wszystko »).
3. Kliknij **Utwórz listę kompletacyjną**.

Wybrane zamówienia natychmiast przechodzą na skonfigurowany status przygotowania. Zamówienia znajdujące się już na otwartej liście są automatycznie ukrywane, aby uniknąć podwójnej kompletacji. Ilości zwrócone lub zrefundowane są wykluczane.

## Kompletacja ze skanowaniem kodów

Ekran przygotowania oferuje dwa widoki: **produkty zagregowane** (wszystkie zamówienia razem, posortowane według lokalizacji) oraz **szczegóły według zamówienia**. Umieść kursor w polu skanowania — pozostaje ono aktywne automatycznie — i skanuj kolejne artykuły:

- Rozpoznawane kody: **EAN13, UPC, ISBN oraz indeks** produktu lub kombinacji.
- Każdy skan jest przypisywany do **najstarszego zamówienia** jeszcze nieobsłużonego dla danego produktu.
- Wysoki dźwięk = artykuł odhaczony; niski dźwięk = nieznany kod lub produkt już skompletowany.
- Ukończone wiersze zmieniają kolor na zielony, a globalny pasek postępu aktualizuje się w czasie rzeczywistym.
- Przyciski **+ / −** przy każdym wierszu umożliwiają ręczną korektę (produkt bez kodu, uszkodzenie itp.).

Skaner musi działać w **trybie klawiatury (emulacja HID)** i wysyłać klawisz **Enter** po każdym odczycie (sufiks CR/LF, domyślnie włączony w większości modeli).

## Drukowanie dokumentów

### PDF listy kompletacyjnej

Przycisk **PDF listy kompletacyjnej** generuje dokument zagregowany według produktu: lokalizacja, indeks, EAN13, łączna ilość, podział na zamówienia i pole do odhaczenia.

### PDF dokumentów pakowania

Przycisk **PDF dokumentów pakowania** generuje jeden dokument na zamówienie, **celowo bez cen**: adres dostawy, przewoźnik, waga całkowita i lista produktów z polami do odhaczenia. Włóż go do paczki.

## Zakończenie przygotowania

Gdy wszystko jest odhaczone, kliknij **Zakończ przygotowanie**: lista przechodzi w status « Zakończona », a zamówienia — jeśli skonfigurowano — otrzymują status końcowy. Panel **Przygotowanie zamówienia** na każdej karcie zamówienia w panelu administracyjnym pokazuje powiązane listy i ich postęp.

## Rozwiązywanie problemów

- **« Nieznany kod » przy skanowaniu** — sprawdź, czy EAN13/UPC/indeks jest uzupełniony na karcie produktu (lub kombinacji) i czy produkt należy do bieżącej listy.
- **Brak dźwięku** — przeglądarki wymagają interakcji użytkownika przed odtworzeniem dźwięku: kliknij raz na stronie, a następnie skanuj.
- **Zamówienie nie pojawia się przy tworzeniu listy** — jego status nie należy do kwalifikujących się statusów lub znajduje się już na otwartej liście.
- **Pusta lokalizacja** — pole lokalizacji w Katalog → Stany magazynowe nie jest uzupełnione; lista jest wtedy sortowana według indeksu.

## Odinstalowanie

Odinstalowanie usuwa tabele modułu (`dfpicking_list`, `dfpicking_item`), jego konfigurację i zakładkę menu. Twoje zamówienia i ich statusy pozostają bez zmian.