# Multiarmazém e Encaminhamento de Stock: documentação

> Apresentação O Multiarmazém e Encaminhamento de Stock atribui automaticamente cada encomenda validada ao armazém mais pertinente, cruzando o stock realmente disponível com a zona de entrega do cliente. O módulo…

- Página: <https://www.datafirefly.com/pt/documentation/multi-entrepot-routage-stock/>
- Idioma: pt
- Atualizado em: 2026-09-09
- Outros idiomas: [fr](https://www.datafirefly.com/documentation/multi-entrepot-routage-stock/index.md), [en](https://www.datafirefly.com/en/documentation/multi-entrepot-routage-stock/index.md), [es](https://www.datafirefly.com/es/documentation/multi-entrepot-routage-stock/index.md), [de](https://www.datafirefly.com/de/documentation/multi-entrepot-routage-stock/index.md), [it](https://www.datafirefly.com/it/documentation/multi-entrepot-routage-stock/index.md), [pl](https://www.datafirefly.com/pl/documentation/multi-entrepot-routage-stock/index.md), [nl](https://www.datafirefly.com/nl/documentation/multi-entrepot-routage-stock/index.md)
- Índice: <https://www.datafirefly.com/pt/documentation/llms.txt>

## Apresentação

O Multiarmazém e Encaminhamento de Stock atribui automaticamente cada encomenda validada ao armazém mais pertinente, cruzando o stock realmente disponível com a zona de entrega do cliente. O módulo gere os seus próprios armazéns, um stock independente por armazém e regras de cobertura geográfica, sem qualquer dependência de uma API de geocodificação externa.

A atribuição é feita a um armazém por encomenda. Quando nenhum armazém cobre a totalidade da encomenda, esta é marcada como parcial e entregue ao armazém mais completo, para tratamento manual.

O pacote de traduções do módulo cobre francês, inglês, espanhol, alemão e italiano, mas não o português. Numa loja portuguesa, traduza as cadeias em _Parâmetros avançados > Traduções > Traduções dos módulos_, caso contrário os textos apresentados ficam no idioma de recurso.

## Pré-requisitos e compatibilidade

- PrestaShop 1.7.6 a 9.x (compatível com PrestaShop 8 e 9)
- PHP 7.2 a 8.x
- Compatível com multiloja e multi-idioma (FR, EN, ES, DE, IT)
- Sem dependências externas e sem necessidade de chave de API

## Instalação

1. No back-office, abra **Módulos > Gestor de módulos** e clique em **Carregar um módulo**.
2. Selecione o arquivo ZIP do módulo e inicie a instalação.
3. Depois de instalado, aparece um menu **Multiarmazém** em **Encomendas**, com quatro subpáginas: Armazéns, Zonas de cobertura, Stock por armazém e Encaminhamento das encomendas.

A instalação cria automaticamente as tabelas e os separadores necessários. A desinstalação remove de forma limpa os separadores e os dados do módulo.

## Configuração geral

Abra a página de configuração do módulo para definir a estratégia de encaminhamento e as opções de stock.

### Estratégias de encaminhamento

- **Geografia primeiro** (predefinição): privilegia o armazém mais próximo que tenha a totalidade do stock.
- **Stock primeiro**: dá prioridade a um armazém capaz de servir a encomenda por inteiro e só depois desempata pela proximidade.
- **Prioridade de armazém**: segue a ordem de prioridade que definir, ignorando a geografia.

### Opções

- **Cobertura global de recurso**: se nenhuma regra corresponder, o armazém mantém-se elegível em último recurso.
- **Decremento do stock**: deduz o stock do armazém no momento da atribuição.
- **Sincronização para o PrestaShop**: envia a soma dos armazéns para o stock do PrestaShop (opcional, desativada por predefinição).
- **Permitir encomendas parciais**: atribui mesmo assim o armazém mais completo quando nenhum cobre tudo.
- **Estados que libertam o stock**: lista de estados de encomenda (por predefinição Cancelada, Reembolsada e Erro de pagamento) que voltam a creditar automaticamente o stock reservado.

## Criar um armazém

Em **Multiarmazém > Armazéns**, acrescente um armazém com o nome, o país, uma prioridade (quanto mais baixo o valor, mais prioritário é o armazém) e o estado ativo. As coordenadas de latitude e longitude são facultativas e meramente informativas.

## Definir as zonas de cobertura

Em **Multiarmazém > Zonas de cobertura**, associe a cada armazém uma ou mais regras:

- **Código postal**: um ou vários prefixos separados por vírgulas (por exemplo 1000, 4000, 8000). Um prefixo pode ser limitado a um país com a sintaxe ISO:prefixo (por exemplo PT:1000,ES:28).
- **País**: cobertura de um país inteiro.
- **Zona**: cobertura de uma zona do PrestaShop.

Um armazém sem qualquer regra é considerado de cobertura global: cobre todos os destinos. A proximidade é hierarquizada do mais preciso para o mais amplo: código postal, depois país, depois zona e por fim cobertura global.

Em Portugal, os códigos postais dos Açores e da Madeira começam por 9 (intervalo 9000-9999). Se tratar as ilhas a partir de um armazém distinto ou com um prazo de expedição diferente, crie uma regra de código postal com o prefixo 9 e reserve os prefixos continentais para o armazém principal.

## Gerir o stock por armazém

Em **Multiarmazém > Stock por armazém**, introduza as quantidades por produto e por armazém. Pode importar com um clique o stock existente do PrestaShop para o armazém à sua escolha e ajustá-lo em seguida. Para catálogos grandes, o bloco Importar / exportar CSV permite exportar o stock completo, descarregar um modelo de catálogo pré-preenchido por armazém (todos os produtos e combinações) e voltar a importar as quantidades por referência de produto ou por ID, em modo substituição ou adição.

Se a sincronização para o PrestaShop estiver ativa, o stock PrestaShop de um produto é substituído pela soma das quantidades desse artigo em todos os armazéns. Verifique a sua configuração antes de ativar esta opção em produção.

## Compreender o encaminhamento

Na validação de uma encomenda, o módulo avalia cada armazém ativo segundo dois eixos: o escalão geográfico (proximidade) e a capacidade de servir as linhas da encomenda. Consoante a estratégia escolhida, seleciona um armazém e atribui-lhe um estado.

- **Automático**: um armazém cobre toda a encomenda, atribuição sem intervenção.
- **Manual**: o armazém foi escolhido manualmente a partir da ficha da encomenda.
- **Parcial**: nenhum armazém cobre tudo, sendo retido o mais completo para tratamento manual.
- **Não encaminhada**: nenhum armazém elegível (por exemplo, se as encomendas parciais estiverem desativadas).

## Seguir e reatribuir as encomendas

A lista **Multiarmazém > Encaminhamento das encomendas** resume o armazém atribuído e o estado de cada encomenda. Um painel dedicado aparece também na ficha da encomenda no back-office: armazém atribuído, estado, disponibilidade linha a linha, reatribuição manual e recálculo automático com um clique.

Numa reatribuição, o stock anteriormente reservado é novamente creditado ao armazém de origem segundo a alocação exata memorizada e depois debitado do novo armazém: sem perdas nem duplicações de contagem.

## Resolução de problemas

- **Uma encomenda fica sem encaminhamento**: confirme que existe pelo menos um armazém ativo e elegível, e que as encomendas parciais estão autorizadas caso nenhum armazém cubra tudo.
- **O stock não diminui**: certifique-se de que a opção de decremento está ativa na configuração.
- **Um destino nunca é coberto**: acrescente uma regra de cobertura adequada ou ative a cobertura global de recurso.

O encaminhamento está encapsulado de forma segura: em caso de anomalia, o incidente fica registado e a encomenda é criada normalmente, sem nunca bloquear o processo de compra.