# Encomenda Rápida B2B (Quick Order): guia completo

> Apresentação O módulo Encomenda Rápida B2B (dfquickorder) acrescenta uma página de introdução rápida onde os seus clientes profissionais compõem uma encomenda diretamente a partir das suas referências (SKU), sem percorrer…

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

## Apresentação

O módulo **Encomenda Rápida B2B** (`dfquickorder`) acrescenta uma página de introdução rápida onde os seus clientes profissionais compõem uma encomenda diretamente a partir das suas **referências (SKU)**, sem percorrer o catálogo. Podem introduzir as referências uma a uma com preenchimento automático, **colar duas colunas a partir do Excel**, **importar um ficheiro CSV**, recarregar uma **lista de reposição** guardada ou **repetir uma encomenda anterior** e acrescentar tudo ao carrinho com um clique.

Foi concebido para a reposição B2B e para compradores com pressa: um grossista que conhece as suas referências poupa muito tempo face à navegação produto a produto. A grelha resolve cada SKU em tempo real (nome, preço conforme o grupo, stock, quantidade mínima, combinação).

## Compatibilidade

- PrestaShop 8.0 a 9.x
- PHP 7.4 a 8.3
- Loja única e multiloja
- 5 idiomas: FR, EN, ES, DE, IT
- Tema Classic e temas personalizados (grelha em JavaScript nativo, sem dependência do jQuery)
- Sem dependências (nem Composer nem framework)

## Instalação

1. No back-office, abra **Módulos > Gestor de módulos**.
2. Clique em **Instalar um módulo** e selecione o ficheiro `dfquickorder.zip`.
3. Depois de instalado, clique em **Configurar**.

Na instalação, o módulo cria a sua tabela de listas de reposição, regista os seus hooks (`displayCustomerAccount`, `displayNav2` e o hook personalizado `displayQuickOrderBlock`) e inicializa as suas definições predefinidas. Passa então a aparecer uma ligação **Encomenda rápida** na área de cliente.

## Configuração

### Acesso e restrição

- **Grupos de clientes autorizados**: deixe vazio para abrir a encomenda rápida a toda a gente, ou selecione um ou vários grupos para a reservar aos seus clientes B2B. Os visitantes não autorizados são reencaminhados para a sua conta.

### Introdução e importação

- **Separador CSV**: ponto e vírgula, vírgula, tabulação ou barra vertical, consoante o formato exportado pelos seus clientes.
- **Número de linhas predefinido**: número de linhas vazias apresentadas ao abrir a grelha.
- **Máximo de linhas por CSV ou colagem**: proteção contra importações demasiado volumosas; as linhas acima do limite são ignoradas com um aviso.

### Apresentação e funcionalidades

- **Apresentar o preço e o subtotal**: apresenta o preço unitário, o total por linha e o total estimado, calculados segundo o método fiscal do grupo (sem ou com IVA).
- **Colagem a partir do Excel**: ativa o separador de colagem de duas colunas (referência e quantidade).
- **Listas de reposição**: ativa a gravação e o recarregamento de listas com nome, por cliente.
- **Repetir encomenda com um clique**: ativa o recarregamento de uma encomenda anterior na grelha.
- **Botão «Converter em orçamento»**: apresentado apenas se o módulo `dfb2bquote` estiver instalado e ativo (ponte com a gama de orçamentos B2B).

## Utilização

### A grelha de introdução de SKU

O cliente escreve uma referência: um menu de preenchimento automático propõe os produtos e combinações correspondentes (por referência ou por nome). Ao validar, a linha é resolvida em tempo real e apresenta o nome do produto, a designação da combinação, o preço unitário segundo o seu grupo, o total da linha e uma etiqueta de estado. Uma nova linha vazia é acrescentada automaticamente à medida que avança.

### Os estados de linha

- **Verde**: referência válida, stock suficiente.
- **Laranja**: quantidade ajustada (stock parcial disponível, ou quantidade mínima de venda atingida).
- **Vermelho**: referência desconhecida, produto indisponível ou sem stock.

A resolução trata as **combinações**: uma referência de combinação devolve o `id_product_attribute` correto e a designação dos seus atributos. A pesquisa é feita pela referência e, em alternativa, pelo código de barras EAN13, respeitando a loja atual e os produtos ativos.

### Colar a partir do Excel

No separador **Colar do Excel**, o cliente cola duas colunas (referência e quantidade) diretamente a partir da sua folha de cálculo. Cada linha é analisada e resolvida e depois injetada na grelha com o seu estado. Uma eventual linha de cabeçalho («sku», «referência»...) é detetada e ignorada.

### Importação CSV

No separador **Importar CSV**, o cliente carrega um ficheiro de duas colunas. O ficheiro é lido no navegador e depois enviado para resolução. É fornecido um **modelo CSV** descarregável para orientar o formato esperado. É aplicado o separador configurado no back-office, com recurso automático aos separadores mais comuns.

### Listas de reposição

Um cliente com sessão iniciada pode **gravar a grelha atual como uma lista com nome** (por exemplo, «Reposição mensal») e recarregá-la a qualquer momento no separador **As minhas listas**. Cada lista pertence ao cliente e à loja; pode ser carregada na grelha ou eliminada.

### Repetir uma encomenda anterior

O separador **Repetir encomenda** lista as últimas encomendas válidas do cliente. Um clique recarrega na grelha todas as referências e quantidades da encomenda, prontas a ajustar e a acrescentar ao carrinho.

### Acrescentar ao carrinho e converter em orçamento

O botão **Acrescentar tudo ao carrinho** acrescenta de uma vez todas as linhas válidas ao carrinho, respeitando as quantidades. Se o módulo `dfb2bquote` estiver ativo, o botão **Converter em orçamento** acrescenta as linhas ao carrinho e passa depois ao percurso de orçamento.

### Acesso à encomenda rápida

A ligação **Encomenda rápida** está disponível na área de cliente. Também pode apresentá-la na navegação superior e, através do hook personalizado `displayQuickOrderBlock`, inserir um bloco com apelo à ação onde quiser na sua loja.

## FAQ e resolução de problemas

### A grelha apresenta um erro «JSON inválido» ou não resolve as referências

Limpe a cache do PrestaShop (Parâmetros avançados > Desempenho) e, durante os testes, desative a combinação/compressão de ficheiros (CCC). As respostas da grelha são JSON estrito: o módulo limpa qualquer saída parasita antes de responder, o que evita que uma mensagem do PHP corrompa a resposta.

### Como reservar a encomenda rápida aos meus clientes profissionais?

Na configuração, selecione o grupo ou grupos autorizados em **Grupos de clientes autorizados**. Todos os outros visitantes ficam sem acesso à página.

### As combinações são suportadas?

Sim. Uma referência de combinação é resolvida para a combinação correta, com a designação dos seus atributos, o seu preço e o seu stock próprios. O código de barras EAN13 também é aceite como referência.

### O que acontece se uma quantidade ultrapassar o stock?

Consoante a definição de gestão de ruturas do produto, a quantidade é ajustada ao stock disponível (estado laranja) ou a linha é marcada como esgotada (estado vermelho). As referências não encontradas são assinaladas sem bloquear o resto da grelha.

### As listas e a repetição de encomenda exigem conta?

Sim: a gravação de listas e a repetição de encomendas anteriores exigem que o cliente tenha sessão iniciada. A introdução de SKU, a colagem e a importação CSV também funcionam para os visitantes autorizados.

### É compatível com o PrestaShop 9?

Sim. O módulo é compatível com o PrestaShop 8 e 9, em multiloja e multilingue (FR, EN, ES, DE, IT).

**Numa loja portuguesa** — A interface do módulo não é fornecida em português: traduza as legendas em Parâmetros avançados > Traduções, escolhendo `dfquickorder`. Verifique também o separador CSV: as folhas de cálculo em configuração portuguesa exportam normalmente com ponto e vírgula.