# Okna Czasowe Dostawy PrestaShop: instalacja i konfiguracja

> Opis Moduł dodaje do procesu zamówienia PrestaShop 8 i 9 wybór dnia i okna godzinowego dostawy lub odbioru. Każde okno ma limit wyrażony liczbą zamówień, każda strefa swoje kody pocztowe,…

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

## Opis

Moduł dodaje do procesu zamówienia PrestaShop 8 i 9 wybór dnia i okna godzinowego dostawy lub odbioru. Każde okno ma limit wyrażony liczbą zamówień, każda strefa swoje kody pocztowe, przewoźników, godzinę graniczną i dni zamknięcia. Wybrane okno towarzyszy zamówieniu w planowaniu, e-mailach, na fakturze i dokumencie dostawy.

## Instalacja

1. W **Moduły > Menedżer modułów** kliknij **Załaduj moduł** i wyślij plik `dfdeliveryslots-1.1.0.zip`.
2. Moduł tworzy menu **Zamówienia > Okna dostaw**. Przycisk Konfiguruj modułu również tam prowadzi.
3. Od wersji 1.0.0 wystarczy wysłać nowy plik ZIP: skrypt aktualizacji doda nowe kolumny, tabele i hooki.

## Tworzenie strefy

Otwórz zakładkę **Strefy i okna**, a następnie **Dodaj strefę**. Używana jest pierwsza aktywna strefa z listy pasująca do przewoźnika, kraju i kodu pocztowego adresu.

### Typ strefy

**Dostawa do domu** lub **Odbiór w sklepie**. Typ zmienia teksty widoczne dla klienta ("Wybierz dzień i godzinę odbioru"), w e-mailach i na fakturze. Przy odbiorze przypisz przewoźnika "odbiór w sklepie" i zostaw kody pocztowe puste.

### Przewoźnicy

Zaznacz przewoźników, pod którymi wyświetla się wybór okna. Lista obejmuje tylko natywnych przewoźników: przewoźnicy z modułów (punkty odbioru, firmy kurierskie) nie są obsługiwani.

### Kraje i kody pocztowe

Zostaw kraje puste, aby objąć wszystkie kraje. Kody pocztowe oddziela się przecinkami lub nowymi wierszami:

- dokładna wartość: `06000`
- zakres: `06000-06300`
- prefiks: `06*`
- kody z myślnikiem: `00-950`, zakres `00-001-00-999`

Pole **Sprawdź kod pocztowy** pokazuje na żywo, czy kod jest objęty strefą.

### Czas realizacji i godzina graniczna

- **Minimalny czas realizacji (dni)**: 0 pozwala na dostawę tego samego dnia, 1 zaczyna od jutra.
- **Godzina graniczna zamówień**: po tej godzinie do czasu realizacji dodawany jest jeden dzień.
- **Czas przygotowania (minuty)**: okno, które zaczyna się za mniej niż ten czas, nie jest już proponowane.
- **Okres rezerwacji (dni)**: liczba proponowanych dni od pierwszego możliwego dnia.
- **Maksymalna liczba dostaw dziennie**: limit dla wszystkich okien dnia, 0 oznacza brak limitu.

## Okna tygodniowe

**Szybki generator** tworzy okna za jednym razem: zaznaczone dni, godzina rozpoczęcia i zakończenia, czas trwania, limit i dopłata. Każde okno można potem edytować:

- **Limit**: maksymalna liczba zamówień na okno i datę, 0 oznacza bez limitu.
- **Dopłata**: kwota brutto doliczana do zamówienia za to okno (ekspres, wieczór, niedziela), 0 oznacza brak.
- **Oferowane**: po odznaczeniu okno pozostaje zapisane, ale nie jest proponowane.

Usunięcie okna nie wpływa na zamówienia już na nie złożone.

## Dni zamknięcia

Zakładka **Dni zamknięcia** zamyka datę lub okres (do 366 dni) dla jednej strefy lub wszystkich. Zaznacz **Powtarzaj co roku w tym samym dniu** dla stałych świąt, np. 25 grudnia.

## Czas realizacji produktów

Zakładka **Czas realizacji produktów** dodaje dni do produktów przygotowywanych na zamówienie. Reguła dotyczy produktu (ID lub kod) albo kategorii. Najdłuższy dodatkowy czas w koszyku jest doliczany do czasu strefy, a klient widzi komunikat z pierwszym dostępnym dniem.

## Planowanie

Zakładka **Planowanie dostaw** pokazuje najbliższe 14 dni z liczbą zamówień, a dla wybranego dnia zajętość każdego okna i zamówienia pogrupowane według okien.

- **Dostosuj ten dzień**: zmienia limit okna tylko na tę datę. Puste = zwykły limit, 0 = okno zamknięte w tym dniu.
- **Drukuj listę dostaw**: adresy, telefony i instrukcje według okien.
- **Eksportuj CSV**: plik rozdzielany średnikami, otwierany w Excelu.

## Ustawienia

- **Okno obowiązkowe** dla przewoźników przypisanych do strefy.
- **Ukryj tych przewoźników**, gdy adres jest poza wszystkimi strefami.
- **Okno w e-mailach potwierdzających**, obok nazwy przewoźnika.
- **Blokada okna podczas składania zamówienia**: domyślnie 30 minut, 0 liczy tylko złożone zamówienia.
- **Próg wyświetlania pozostałych miejsc**: wyświetla "Zostało tylko 2" poniżej tej liczby miejsc.
- **Kolor akcentu** wybranego dnia i okna.
- **Podatek od dopłat**.

### Pozycja dopłaty

PrestaShop nie pozwala doliczyć kwoty do kosztów natywnego przewoźnika bez override. Dopłatę przenosi więc ukryty produkt utworzony przez moduł, dodawany do koszyka jako osobna pozycja z ceną właściwą dla koszyka. Pozostaw ten produkt aktywnym i w razie potrzeby wyklucz go z feedów produktowych. Jego ID jest widoczne w ustawieniach.

## E-mail z przypomnieniem

Włącz **Wyślij klientowi przypomnienie**, wybierz liczbę dni przed (1 = dzień wcześniej, 0 = rano tego samego dnia) i godzinę, od której wysyłka jest dozwolona. Wywołuj URL crona widoczny w ustawieniach raz na godzinę, na przykład:

```
0 * * * * curl -s "https://twoj-sklep.pl/pl/module/dfdeliveryslots/cron?token=..."
```

Przycisk **Wyślij teraz zaległe przypomnienia** uruchamia wysyłkę ręcznie. Każde zamówienie dostaje jedno przypomnienie, wysyłane ponownie po zmianie daty w panelu administracyjnym. Szablony `dfds_reminder` i `dfds_reminder_pickup` znajdują się w folderze `mails/` modułu, w 8 językach.

## Po stronie zamówień

- **Strona zamówienia**: okno, strefa, dopłata i formularz zmiany daty lub okna. Przy zmianach w panelu limit nie jest sprawdzany.
- **Lista zamówień**: kolumna Okno dostawy, sortowana i filtrowana według zakresu dat.
- **Faktura i dokument dostawy PDF**: okno drukowane w języku zamówienia.
- **Anulowane zamówienie**: okno jest automatycznie zwalniane.

## Znane ograniczenia

- Przewoźnicy z modułów (punkty odbioru) nie są obsługiwani.
- Moduł jest przeznaczony dla natywnego procesu zamówienia. Moduły zamówienia na jednej stronie nie były testowane.
- Kupon procentowy obejmuje także pozycję dopłaty, a dopłata liczy się do progu darmowej dostawy.
- W trybie konserwacji cron musi być wywoływany z dozwolonego adresu IP.
