# Envio Refrigerado e Seco PrestaShop: instalação e configuração > Apresentação O módulo foi pensado para lojas que vendem produtos secos e refrigerados. O cliente mantém um só carrinho, paga uma vez e recebe uma única encomenda com um único… - Página: - Idioma: pt - Atualizado em: 2026-10-12 - Outros idiomas: [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), [pl](https://www.datafirefly.com/pl/documentation/dfcoldchain/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfcoldchain/index.md) - Índice: ## Apresentação O módulo foi pensado para lojas que vendem produtos secos e refrigerados. O cliente mantém um só carrinho, paga uma vez e recebe uma única encomenda com um único valor de envio. Esse valor depende da zona (país e código postal) e do conteúdo do carrinho: só seco, só refrigerado ou ambos. O refrigerado é recusado nas zonas onde a cadeia de frio não chega. Após a encomenda, o módulo separa-a em volumes, um por tipo, cada um com a sua transportadora e o seu seguimento. ## Instalação 1. Em **Módulos > Gestor de módulos**, clique em **Carregar um módulo** e envie o ficheiro `dfcoldchain-1.0.2.zip`. 2. O módulo cria a sua transportadora, chamada **Envío estándar**. Mude o nome em **Transporte > Transportadoras** se necessário: o módulo segue a transportadora mesmo depois de alterada. 3. Verifique que a transportadora tem uma **regra de imposto**. Na instalação, o módulo copia a da transportadora predefinida. 4. Abra a configuração do módulo e comece pelo separador **Diagnóstico**. Na instalação são criadas quatro zonas de exemplo para Espanha e Portugal (uma cidade, as ilhas e cidades autónomas espanholas, Madeira e Açores, o continente). Adapte-as ou elimine-as antes de publicar. ## Zonas e tarifas As zonas são lidas de cima para baixo, primeiro o número de prioridade mais baixo. Aplica-se a primeira zona ativa cujo país e código postal correspondem à morada. Um destino que não corresponde a nenhuma zona não recebe esta transportadora, e o refrigerado é aí recusado. ### Campos de uma zona - **Nome da zona** e **Ativa**. - **Prioridade**: coloque as zonas precisas (uma cidade, ilhas) antes das amplas (um país inteiro). - **Países (ISO)**: um ou mais códigos separados por vírgulas, por exemplo `ES,PT`. - **Códigos postais**: vazio para todo o país, caso contrário um código por linha ou separados por vírgulas. - **Grátis a partir de**: limiar de envio grátis, 0 para nenhum. - **Só seco**, **Só refrigerado**, **Seco e refrigerado**: tarifas com IVA na moeda predefinida. - **Os produtos refrigerados podem ser entregues**: desmarcado, qualquer carrinho com refrigerado fica bloqueado nesta zona. - **Separar a encomenda num envio por tipo**: desmarcado, a encomenda sai num único envio (entrega local, por exemplo). ### Sintaxe dos códigos postais - valor exato: `1000-001` - intervalo pelos 4 primeiros dígitos: `4000-4999` (os dois extremos devem ter o mesmo comprimento), ou `4000..4999` - prefixo: `9*` (Madeira e Açores) ### Valor mostrado As tarifas são introduzidas com IVA. O módulo calcula o valor sem IVA com a taxa da transportadora para a morada do cliente, por isso o valor mostrado é sempre o introduzido, seja qual for o país. Os valores são convertidos para a moeda do carrinho. ## Produtos refrigerados No separador **Produtos refrigerados**, selecione as categorias em causa (Ctrl ou Cmd para várias) e assinale **Incluir subcategorias** se necessário. Um produto é refrigerado se pertencer a uma destas categorias, mesmo que não seja a sua categoria predefinida. Tudo o resto é seco. Em **Exceções por produto** pode procurar um produto por nome, referência ou ID e forçá-lo como refrigerado ou seco. As alterações são guardadas de imediato. ## Volumes depois da encomenda Quando é feita uma encomenda com a transportadora do módulo numa zona que separa envios, o módulo cria um volume por cada tipo presente: primeiro o refrigerado, depois o seco. No separador **Envios** configure para cada tipo: - o **nome da transportadora mostrado ao cliente** (por defeito SEUR Frío para o refrigerado e Transporte estándar para o seco); - o **URL de seguimento**, onde `@` é substituído pelo número de seguimento. Numa zona sem separação, a encomenda tem um único envio com o nome e o URL de seguimento da transportadora da encomenda. ## Checkout - **Ocultar as outras transportadoras** quando a do módulo está disponível: o cliente vê um único valor. - **Transportadoras sempre mantidas**: por exemplo o levantamento na loja. Continuam visíveis e não são bloqueadas pela restrição do refrigerado. - **Limiar de envio grátis calculado após cupões**: por defeito o limiar é calculado sobre o total dos produtos com IVA, antes de descontos. - **Aviso nas páginas dos produtos refrigerados**. - **Verificador de código postal no carrinho** quando contém refrigerado. - **Botão para remover os produtos refrigerados** quando a morada não é servida. ### Como funciona o bloqueio Quando o carrinho tem refrigerado e a morada de entrega está fora de zona, o módulo retira as opções de envio da lista que o PrestaShop constrói para todos os checkouts. Sem opção de envio a encomenda não pode ser paga. O cliente vê uma mensagem com os produtos afetados, mostrada pelo hook `displayBeforeCarrier` do checkout nativo e inserida por JavaScript nos checkouts numa página que recarregam as transportadoras por AJAX. Para um cliente convidado, o carrinho é estimado com o país da loja, ou com o código postal introduzido no verificador do carrinho, até a morada ser introduzida no checkout. ### Textos para o cliente O aviso da página de produto e a mensagem de bloqueio editam-se por idioma no separador **Checkout**. ## Simulador O separador **Simulador** calcula com as zonas guardadas a zona aplicada, o valor e os volumes previstos para um país, um código postal, um total de produtos e um conteúdo (seco, refrigerado ou ambos). Guarde antes de simular se alterou as zonas. ## Diagnóstico O separador **Diagnóstico** verifica que a transportadora existe e tem regra de imposto, que os limiares nativos de envio grátis estão desativados (**Transporte > Preferências**), que não se somam custos de manuseamento, que há produtos refrigerados definidos e que nenhum produto está restrito a transportadoras. Lista também os módulos que atuam nos mesmos pontos. O botão **Criar de novo a transportadora** repara uma instalação cuja transportadora foi eliminada. ## Encomendas - **Ficha da encomenda**: um painel Envios mostra cada volume com produtos, transportadora, número e URL de seguimento, e estado (Por preparar, Enviado, Entregue). - **Email ao cliente**: assinale a caixa antes de guardar um volume enviado para mandar o seu conteúdo e a ligação de seguimento. Modelo `dfcoldchain_shipped` na pasta `mails/` do módulo, em inglês, espanhol, francês e português. - **Guia de preparação**: uma página imprimível por volume, com faixa REFRIGERADO para o frio. - **Regenerar os envios**: use após alterar as linhas da encomenda, enquanto nenhum volume tiver saído. - **Alerta**: se uma encomenda contém refrigerado para uma zona fora da cadeia de frio, uma mensagem vermelha indica-o. - **Do lado do cliente**: quando a encomenda tem vários volumes ou um número de seguimento, aparecem no detalhe da encomenda da sua conta. ## Limitações conhecidas - O módulo não gera etiquetas: crie-as nas suas transportadoras ou nos módulos delas. - Um produto restrito a certas transportadoras pode levar o PrestaShop a dividir o carrinho em várias encomendas. Retire essas restrições. - Um limiar nativo de envio grátis (**Transporte > Preferências**) sobrepõe-se às zonas do módulo. - Em multiloja, as zonas e as definições são comuns a todas as lojas. - Um pack nativo é classificado pelo próprio produto pack, não pelos seus componentes. - Cada checkout numa página tem a sua própria marcação: teste uma encomenda completa como convidado e como cliente registado numa cópia da loja antes de publicar.