# Wysyłka Chłodzona i Sucha PrestaShop: instalacja i konfiguracja
> Przegląd Moduł jest przeznaczony dla sklepów sprzedających produkty suche i chłodzone. Klient ma jeden koszyk, płaci raz i otrzymuje jedno zamówienie z jednym kosztem dostawy. Koszt zależy od strefy (kraj…
- Strona:
- Język: pl
- Zaktualizowano: 2026-10-12
- Inne języki: [fr](https://www.datafirefly.com/documentation/dfcoldchain/index.md), [en](https://www.datafirefly.com/en/documentation/dfcoldchain/index.md), [es](https://www.datafirefly.com/es/documentation/dfcoldchain/index.md), [de](https://www.datafirefly.com/de/documentation/dfcoldchain/index.md), [it](https://www.datafirefly.com/it/documentation/dfcoldchain/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfcoldchain/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfcoldchain/index.md)
- Indeks:
## Przegląd
Moduł jest przeznaczony dla sklepów sprzedających produkty suche i chłodzone. Klient ma jeden koszyk, płaci raz i otrzymuje jedno zamówienie z jednym kosztem dostawy. Koszt zależy od strefy (kraj i kod pocztowy) oraz od zawartości koszyka: tylko suche, tylko chłodzone lub oba. Produkty chłodzone są odrzucane w strefach, do których nie dociera łańcuch chłodniczy. Po złożeniu zamówienia moduł dzieli je na paczki, po jednej na typ, każdą z własnym przewoźnikiem i śledzeniem.
Panel modułu jest przetłumaczony na angielski, hiszpański, francuski i portugalski. W polskim back-office wyświetla się po angielsku, dlatego nazwy pól poniżej podano po angielsku.
## Instalacja
1. W **Moduły > Menedżer modułów** kliknij **Załaduj moduł** i wyślij `dfcoldchain-1.0.2.zip`.
2. Moduł tworzy swojego przewoźnika o nazwie **Envío estándar**. W razie potrzeby zmień nazwę w **Wysyłka > Przewoźnicy**: moduł śledzi przewoźnika także po edycji.
3. Sprawdź, czy przewoźnik ma **regułę podatkową**. Przy instalacji moduł kopiuje regułę przewoźnika domyślnego.
4. Otwórz konfigurację modułu i zacznij od zakładki **Diagnostics**.
Przy instalacji tworzone są cztery przykładowe strefy dla Hiszpanii i Portugalii (miasto, wyspy i miasta autonomiczne, Madera i Azory, część kontynentalna). Dostosuj je lub usuń przed uruchomieniem.
## Strefy i taryfy
Strefy są czytane od góry do dołu, najpierw najniższy numer priorytetu. Obowiązuje pierwsza aktywna strefa, której kraj i kod pocztowy pasują do adresu. Cel bez pasującej strefy nie otrzymuje tego przewoźnika, a produkty chłodzone są tam odrzucane.
### Pola strefy
- **Zone name** i **Active**.
- **Priority**: dokładne strefy (miasto, wyspy) umieszczaj przed szerokimi (cały kraj).
- **Countries (ISO)**: jeden lub kilka kodów oddzielonych przecinkami, np. `PL`.
- **Postcodes**: puste dla całego kraju, w przeciwnym razie jeden kod w wierszu lub oddzielone przecinkami.
- **Free from**: próg darmowej dostawy, 0 gdy brak.
- **Dry only**, **Chilled only**, **Dry and chilled**: taryfy brutto w walucie domyślnej.
- **Chilled products can be delivered**: odznaczone blokuje w tej strefie każdy koszyk z produktami chłodzonymi.
- **Split the order into one shipment per class**: odznaczone oznacza jedną przesyłkę (np. dostawa lokalna).
### Składnia kodów pocztowych
- dokładna wartość: `00-950`
- zakres: `00-001..05-999` nie jest obsługiwany dla kodów z myślnikiem; dla zakresu po pierwszych cyfrach użyj np. `00*` lub `01*`
- zakres liczbowy: `50001-50020` (oba końce tej samej długości), lub `50001..50020`
- prefiks: `02*`
### Wyświetlana kwota
Taryfy wpisuje się brutto. Moduł wylicza kwotę netto stawką przewoźnika dla adresu klienta, więc wyświetlana kwota jest zawsze równa wpisanej, niezależnie od kraju. Kwoty są przeliczane na walutę koszyka.
## Produkty chłodzone
W zakładce **Chilled products** wybierz odpowiednie kategorie (Ctrl lub Cmd dla kilku) i w razie potrzeby zaznacz **Include subcategories**. Produkt jest chłodzony, jeśli należy do jednej z tych kategorii, nawet gdy nie jest to jego kategoria domyślna. Reszta jest sucha.
W **Product exceptions** wyszukasz produkt po nazwie, indeksie lub ID i wymusisz go jako chłodzony lub suchy. Zmiany zapisują się od razu.
## Paczki po zamówieniu
Gdy zamówienie zostanie złożone z przewoźnikiem modułu w strefie z podziałem, moduł tworzy paczkę dla każdego obecnego typu: najpierw chłodzoną, potem suchą. W zakładce **Shipments** ustaw dla każdego typu:
- **nazwę przewoźnika widoczną dla klienta** (domyślnie SEUR Frío dla chłodzonych i Transporte estándar dla suchych);
- **URL śledzenia**, w którym `@` zastępowane jest numerem śledzenia.
W strefie bez podziału zamówienie ma jedną przesyłkę z nazwą i URL śledzenia przewoźnika zamówienia.
## Checkout
- **Hide the other carriers**, gdy przewoźnik modułu jest dostępny: klient widzi jedną kwotę.
- **Carriers always kept**: np. odbiór w sklepie. Pozostają widoczni i nie są blokowani przez ograniczenie chłodzonych.
- **Free shipping threshold computed after vouchers**: domyślnie próg liczony jest od sumy produktów brutto przed rabatami.
- **Notice on chilled product pages**.
- **Postcode checker in the cart**, gdy zawiera produkty chłodzone.
- **Button to remove chilled products**, gdy adres nie jest obsługiwany.
### Jak działa blokada
Gdy koszyk zawiera produkty chłodzone, a adres dostawy jest poza strefą, moduł usuwa opcje dostawy z listy, którą PrestaShop buduje dla każdego checkoutu. Bez opcji dostawy zamówienia nie da się opłacić. Klient widzi komunikat z listą produktów, wyświetlany przez hook `displayBeforeCarrier` natywnego checkoutu i wstrzykiwany JavaScriptem do checkoutów na jednej stronie, które przeładowują przewoźników przez AJAX.
Dla gościa koszyk jest szacowany dla kraju sklepu lub kodu pocztowego wpisanego w sprawdzarce koszyka, dopóki adres nie zostanie podany w checkoucie.
### Teksty dla klienta
Komunikat na karcie produktu i komunikat blokady edytuje się dla każdego języka w zakładce **Checkout**.
## Symulator
Zakładka **Simulator** pokazuje dla zapisanych stref pasującą strefę, kwotę i planowane paczki dla kraju, kodu pocztowego, sumy produktów i zawartości (suche, chłodzone lub oba). Zapisz najpierw, jeśli zmieniłeś strefy.
## Diagnostyka
Zakładka **Diagnostics** sprawdza, czy przewoźnik istnieje i ma regułę podatkową, czy natywne progi darmowej dostawy są wyłączone (**Wysyłka > Preferencje**), czy nie dochodzą koszty obsługi, czy produkty chłodzone są zdefiniowane i czy żaden produkt nie jest ograniczony do przewoźników. Pokazuje też moduły działające w tych samych miejscach. Przycisk **Create the carrier again** naprawia instalację, w której przewoźnik został usunięty.
## Zamówienia
- **Karta zamówienia**: panel Shipments pokazuje każdą paczkę z produktami, przewoźnikiem, numerem i URL śledzenia oraz statusem (To prepare, Shipped, Delivered).
- **E-mail do klienta**: zaznacz pole przed zapisaniem wysłanej paczki, aby wysłać jej zawartość i link śledzenia. Szablon `dfcoldchain_shipped` w folderze `mails/` modułu, po angielsku, hiszpańsku, francusku i portugalsku. Polscy klienci otrzymują wersję angielską.
- **List kompletacyjny**: jedna strona do druku na paczkę, z paskiem CHILLED dla paczek chłodzonych.
- **Rebuild shipments**: użyj po zmianie pozycji zamówienia, dopóki żadna paczka nie została wysłana.
- **Ostrzeżenie**: jeśli zamówienie zawiera produkty chłodzone dla strefy poza łańcuchem chłodniczym, pojawia się czerwony komunikat.
- **Po stronie klienta**: gdy zamówienie ma kilka paczek lub numer śledzenia, widać je w szczegółach zamówienia na koncie klienta.
## Znane ograniczenia
- Moduł nie generuje etykiet: twórz je u przewoźników lub w ich modułach.
- Produkt ograniczony do niektórych przewoźników może sprawić, że PrestaShop podzieli koszyk na kilka zamówień. Usuń te ograniczenia.
- Natywny próg darmowej dostawy (**Wysyłka > Preferencje**) ma pierwszeństwo przed strefami modułu.
- W multisklepie strefy i ustawienia są wspólne dla wszystkich sklepów.
- Natywny pakiet jest klasyfikowany wg samego produktu pakietu, nie jego składników.
- Każdy checkout na jednej stronie ma własny HTML: przed uruchomieniem przetestuj pełne zamówienie jako gość i jako zarejestrowany klient na kopii sklepu.