Encomenda Rápida B2B (Quick Order): guia completo
Instalar, configurar e explorar a encomenda rápida B2B: grelha de SKU com preenchimento automático, importação CSV, colagem do Excel, listas de reposição e repetição de encomenda com um clique para PrestaShop 8 e 9.
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
- No back-office, abra Módulos > Gestor de módulos.
- Clique em Instalar um módulo e selecione o ficheiro
dfquickorder.zip. - 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
dfb2bquoteestiver 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.