# Data i godzina dostawy w PrestaShop: dokumentacja modułu

> Ten moduł dodaje do checkoutu PrestaShop 8 i 9 obowiązkowy wybór daty i przedziału dostawy, ograniczony rzeczywistą pojemnością pracowni, ze strefami dostaw według dni tygodnia, bilecikiem z dedykacją, odbiorem w…

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

Ten moduł dodaje do checkoutu PrestaShop 8 i 9 obowiązkowy wybór daty i przedziału dostawy, ograniczony rzeczywistą pojemnością pracowni, ze strefami dostaw według dni tygodnia, bilecikiem z dedykacją, odbiorem w sklepie i dopłatami do dostawy. Nazwa techniczna: `dfflorist`.

## Instalacja

1. W **Moduły > Menedżer modułów** kliknij **Załaduj moduł** i upuść plik ZIP.
2. Podczas instalacji moduł tworzy swoje tabele, dwa przykładowe przedziały (Rano 09:00-12:00 i Popołudnie 14:00-18:00), cztery ilustrowane wzory bilecików oraz ukryty produkt **Dopłata do dostawy** (indeks `DFFLO-SURCHARGE`).
3. Pojawia się nowa zakładka **Zamówienia > Dostawy kwiaciarni**. Pasek nawigacji modułu prowadzi do planu, stref, przedziałów, dni zamknięcia, bilecików, obciążenia pracowni i ustawień.

Nie usuwaj produktu Dopłata do dostawy z katalogu: przenosi on dopłaty w koszyku. Możesz zmienić jego nazwę, zdjęcie i regułę podatkową.

## Ustawienia ogólne

### Zakres

- **Produkty objęte**: wszystkie produkty lub tylko z zaznaczonych kategorii (kwiaty cięte, rośliny, świeże produkty).
- **Przewoźnicy objęci**: pozostaw wszystko odznaczone, aby planowanie dotyczyło wszystkich. Przy wyborze pozostali przewoźnicy (np. suszone kwiaty w paczce) nie pytają o datę.
- **Przewoźnicy odbioru w sklepie**: zobacz niżej.
- **Dostarczaj tylko w strefach**: gdy aktywna jest choć jedna strefa, kod pocztowy spoza wszystkich stref nie złoży zamówienia z objętym przewoźnikiem.
- **Znacznik na karcie produktu** i **kolor akcentu** bloku w checkoucie.

### Data dostawy i czas realizacji

- **Data wymagana** i **godzina wymagana** (tylko gdy dla wybranego dnia istnieją przedziały).
- **Dostawa tego samego dnia** i jej **godzina graniczna** (HH:MM, strefa czasowa sklepu).
- **Dzienna godzina graniczna zamówień** (opcjonalnie): zamówienia złożone po tej godzinie liczą się od następnego dnia. Przykład: 16:00 przy jednym dniu realizacji, zamówienia z poniedziałku z godziny 17:00 nie można dostarczyć we wtorek.
- **Minimalny czas realizacji** w dniach, **czas przygotowania przed przedziałem** dla zamówień na ten sam dzień, **okno rezerwacji** w dniach.

### Pojemność pracowni

- **Dni dostaw** pracowni i **pojemność na dzień tygodnia** w jednostkach (0 = brak limitu dziennego).
- **Domyślne obciążenie na produkt**: liczba jednostek na sztukę. Inne obciążenie dla produktu ustawisz w **Obciążenie pracowni**.
- **Rezerwacja podczas checkoutu** (domyślnie 20 minut): koszyki z wybranym przedziałem blokują go na ten czas.
- **Ostrzeżenie o ostatnich miejscach** i **statusy zamówień zwalniające pojemność** (domyślnie anulowane, błąd płatności, zwrot).

### Bilecik i odbiorca

Włącz bilecik, w razie potrzeby ustaw wiadomość jako wymaganą, określ maksymalną długość, zaoferuj pole podpisu i opcję bileciku bez podpisu. Telefon odbiorcy może być ukryty, opcjonalny lub wymagany.

## Strefy dostaw

Strefa grupuje kody pocztowe i dni, w które jest obsługiwana. Dozwolone wzorce, jeden na wiersz lub oddzielone przecinkami:

- dokładny kod: `30-001`
- prefiks: `30*`
- zakres: `30-001..31-999`

Kraj jest opcjonalny. **Dodatkowy czas realizacji** dodaje się do minimalnego czasu dla odległych stref i wyłącza tam dostawę tego samego dnia. Gdy pasuje kilka stref, obowiązuje pierwsza aktywna strefa z listy.

## Przedziały czasowe

Każdy przedział ma tłumaczoną etykietę, godzinę początku i końca, dni tygodnia, pojemność w jednostkach (0 = obowiązuje tylko pojemność dzienna), opcjonalną **dopłatę brutto** i w razie potrzeby ograniczenie do wybranych stref. Bez aktywnych przedziałów klient wybiera tylko datę.

## Dni zamknięcia i dni szczytu

- **Zamknięte**: data jest zablokowana (urlop, inwentaryzacja).
- **Dzień szczytu lub otwarcie wyjątkowe**: pojemność dnia zastępuje Twoja (0 = bez limitu), a dzień jest otwarty nawet, jeśli zwykle jest zamknięty. Jeśli na ten dzień tygodnia nie ma przedziałów, oferowane są wszystkie aktywne przedziały.

## Bileciki

Każdy wzór ma nazwę, sugerowany tekst wypełniający wiadomość po wyborze bileciku oraz grafikę JPG, PNG lub WebP do 2 MB, zalecane proporcje 3:2. Cztery dołączone wzory (Urodziny, Miłość, Dziękuję, Kondolencje) można edytować.

## Obciążenie pracowni na produkt

Dla każdego produktu podaj **jednostki na sztukę** (0 dla wazonu lub czekoladek bez przygotowania) oraz **dodatkowe przygotowanie** w dniach dla produktów na zamówienie. Gdy taki produkt jest w koszyku, czas realizacji się wydłuża, a dostawa tego samego dnia zostaje wyłączona.

## Co widzi klient w checkoucie

W kroku Dostawa blok pojawia się pod listą przewoźników, nad przyciskiem Dalej. Klient wybiera dzień w kalendarzu (wskaźnik pokazuje obciążenie, „+” oznacza dopłatę), a następnie przedział pokazujący ostatnie miejsca i dopłatę. Potem wybiera wzór bileciku, pisze dedykację i podpis i widzi aktualizujący się podgląd. Wybór zapisuje się automatycznie.

Przycisk Dalej pozostaje zablokowany, dopóki brakuje wymaganych danych, a serwer ponownie sprawdza wszystko przy zatwierdzaniu kroku.

## Odbiór w sklepie

Zaznacz swoich przewoźników Click & collect w **Przewoźnicy odbioru w sklepie**. Dla nich blok zmienia się w **Datę odbioru**: bez strefy, bez telefonu odbiorcy i bez dopłaty. Przedziały ograniczone do stref nie są oferowane. Gdy klient zmienia przewoźnika, blok przeładowuje się, a dopłata jest dodawana lub usuwana z koszyka.

## Dopłaty do dostawy

Sumują się trzy źródła, wszystkie brutto w walucie domyślnej:

- dopłata wybranego **przedziału** (ekspres, konkretna godzina);
- dopłata za **dzień tygodnia** (np. niedziela);
- dopłata za **ten sam dzień**.

Suma trafia do koszyka jako pozycja **Dopłata do dostawy** z regułą podatkową ukrytego produktu. Jest widoczna w podsumowaniu, zamówieniu i na fakturze. Dopłata jest usuwana automatycznie, gdy klient wybierze odbiór w sklepie lub gdy w koszyku nie ma już objętych produktów.

## Plan dnia i druk

Strona **Planowanie** pokazuje pasek 14 dni z ich wypełnieniem, obciążenie wybranego dnia według przedziałów, jednostki zablokowane przez trwające koszyki oraz listę dostaw (godzina, strefa lub oznaczenie Odbiór w sklepie, odbiorca, adres, produkty, bilecik). Trzy akcje:

- **Drukuj bileciki**: bileciki A6, cztery na arkusz A4 z liniami cięcia, potem oznaczone jako Wydrukowane;
- **Arkusz dostaw**: trasa według przedziałów, odbiory w sklepie w osobnej sekcji;
- **Eksport CSV**: separator średnik, zgodny z Excelem.

## Zamówienia, e-maile i PDF

- Lista zamówień w back-office zyskuje sortowaną kolumnę **Data dostawy** z filtrem zakresu dat.
- Karta zamówienia pokazuje panel z datą, przedziałem, strefą, dopłatą i bilecikiem oraz pozwala je zmienić (bez kontroli pojemności).
- W standardowych e-mailach data jest dodawana po nazwie przewoźnika, w języku zamówienia. Zmienne do Twoich szablonów: `{dfflo_delivery_date}`, `{dfflo_delivery_slot}`, `{dfflo_card_message}`.
- Faktura PDF pokazuje datę i telefon odbiorcy, dokument dostawy dodatkowo dedykację.

## Aktualizacja z wersji 1.0.0

Załaduj ZIP 1.1.0 na istniejącą wersję w menedżerze modułów. Skrypt aktualizacji dodaje nowe kolumny i ustawienia, tworzy produkt Dopłata do dostawy i przypisuje grafiki do przykładowych bilecików. Strefy, przedziały i zamówienia zostają zachowane.

## Najczęstsze pytania

### Blok nie pojawia się w checkoucie

Sprawdź, czy moduł jest włączony w ustawieniach, czy koszyk zawiera objęty produkt i czy wybrany przewoźnik jest objęty lub ustawiony jako odbiór w sklepie.

### Nie jest proponowana żadna data

Sprawdź dni dostaw pracowni, dni obsługi strefy klienta, minimalny czas realizacji i okno rezerwacji. Produkt z dodatkowym przygotowaniem również przesuwa pierwszą datę.

### Co dzieje się przy odinstalowaniu?

Strefy, przedziały, bileciki i daty zapisane w zamówieniach zostają usunięte, podobnie jak produkt Dopłata do dostawy. Zafakturowane już pozycje dopłat pozostają w zamówieniach.
