# Registar uma encomenda no back-office com o DataFirefly Order Creator
> Apresentação O DataFirefly Order Creator adiciona ao back-office uma página de registo de encomendas, pensada para as encomendas recebidas por telefone ou por email. A página segue a ordem de…
- Página:
- Idioma: pt
- Atualizado em: 2026-10-13
- Outros idiomas: [fr](https://www.datafirefly.com/documentation/dfordercreator/index.md), [en](https://www.datafirefly.com/en/documentation/dfordercreator/index.md), [es](https://www.datafirefly.com/es/documentation/dfordercreator/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfordercreator/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfordercreator/index.md), [it](https://www.datafirefly.com/it/documentation/dfordercreator/index.md), [de](https://www.datafirefly.com/de/documentation/dfordercreator/index.md)
- Índice:
## Apresentação
O DataFirefly Order Creator adiciona ao back-office uma página de registo de encomendas, pensada para as encomendas recebidas por telefone ou por email. A página segue a ordem de um registo de encomenda em quatro etapas (cliente, produtos, moradas e entrega, pagamento e estado) e mostra à direita um resumo que é recalculado a cada ação.
A encomenda é criada com a mesma função do ecrã nativo do PrestaShop (`PaymentModule::validateOrder`), a partir do carrinho do cliente. O módulo funciona no PrestaShop 8.0 a 9.x e a interface está traduzida em francês, inglês, espanhol, alemão, italiano, neerlandês, polaco e português.
## Instalação
1. Em **Módulos > Gestor de módulos**, clique em **Carregar um módulo** e largue o ficheiro `dfordercreator-1.0.0.zip`.
2. A página é adicionada em **Encomendas > Registo de encomendas**.
3. Por predefinição, os botões **Adicionar nova encomenda** do back-office também abrem esta página.
Para abrir a página a um perfil que não seja SuperAdmin, atribua-lhe permissões sobre o separador **Registo de encomendas** em **Parâmetros avançados > Equipa > Permissões**. A permissão **Adicionar** é necessária para criar clientes e encomendas. Sem ela, o funcionário pode preparar um carrinho e enviar a ligação de pagamento.
Em multiloja, selecione uma única loja no seletor no topo do back-office antes de registar uma encomenda.
## Configuração
A página de configuração do módulo tem estas definições:
- **Substituir os botões nativos «Adicionar nova encomenda»**: o botão da lista de encomendas abre a página do módulo, e o botão de criação de encomenda de um carrinho de cliente abre-a com esse carrinho já carregado.
- **Estado da encomenda predefinido**: um estado fixo, ou o último estado usado pelo funcionário.
- **Método de pagamento predefinido**: um módulo de pagamento fixo, ou o último usado pelo funcionário.
- **Os preços introduzidos pelos funcionários são**: c/ IVA ou s/ IVA. Cada funcionário pode alternar na página, e a sua escolha fica guardada no navegador.
- **Permitir alterar preços e descontos de linha**.
- **Mostrar a margem**, calculada s/ IVA a partir do preço de custo dos produtos e das combinações.
- **Permitir adicionar produtos sem stock**: mostra uma caixa que permite ao funcionário ultrapassar o stock numa encomenda concreta.
- **Enviar email ao cliente por predefinição**: estado inicial da opção no momento de criar a encomenda.
- **Resultados da pesquisa**: número máximo de clientes ou de produtos apresentados (5 a 50).
## Registar uma encomenda
### 1. O cliente
Escreva pelo menos dois caracteres na pesquisa (ou um número de cliente). A pesquisa abrange o apelido, o nome, o email, a empresa, o telefone das moradas, o número de IVA e o código postal. Pode combinar várias palavras, por exemplo «silva porto». Escolha o cliente com as setas e a tecla Enter, ou com o rato.
A ficha mostra os grupos do cliente (o grupo predefinido a escuro, com a sua redução), as encomendas válidas, o valor gasto, a última encomenda e a nota privada. A ligação **Histórico** expande:
- as seis últimas encomendas, com o botão **Encomendar novamente**, que adiciona os respetivos produtos ao carrinho;
- os carrinhos abertos do cliente, com o botão **Retomar este carrinho**.
O botão **Novo cliente** (ou Alt + N) abre a criação de um cliente: nome, apelido, email, empresa, grupo, idioma, conta de convidado se a loja o permitir, newsletter e primeira morada. Se o email já existir, a janela propõe usar o cliente existente. Numa conta normal, a caixa **Enviar ao cliente uma ligação para escolher uma palavra-passe** envia-lhe o email nativo de reposição da palavra-passe.
**Mudar de cliente** mantém no carrinho os produtos já introduzidos.
### 2. Os produtos
A tecla / coloca o cursor na pesquisa de produtos. A pesquisa abrange o nome, a referência, o EAN, o UPC, o MPN, a referência do fornecedor e o ID, incluindo os das combinações. Cada resultado mostra a imagem, a referência, o stock e o preço para este cliente. As combinações aparecem expandidas por baixo do respetivo produto.
- ↑ ↓ para navegar, Enter para adicionar, Shift + Enter para adicionar mantendo os resultados abertos.
- O campo **Qtd.** ao lado da pesquisa define a quantidade adicionada.
- Com um leitor de códigos de barras, leia o código na pesquisa: o produto ou a combinação cujo EAN, UPC ou referência corresponde é adicionado diretamente.
Na tabela das linhas:
- **Quantidade**: botões **+** e **-** ou introdução direta. Pôr 0 ou clicar no caixote do lixo retira a linha.
- **Preço unitário**: introduzido c/ IVA ou s/ IVA conforme o botão acima da tabela. Um preço introduzido c/ IVA é convertido para s/ IVA com a taxa de imposto da linha.
- **Desconto**: uma percentagem aplicada ao preço da linha.
- Quando o preço ou o desconto é alterado, o preço de catálogo aparece riscado com a ligação **Repor**, e o preço líquido aparece por baixo da linha.
- A margem s/ IVA da linha aparece por baixo do respetivo total se a opção estiver ativa.
O preço e o desconto de uma linha são guardados como um preço específico limitado ao carrinho, como no ecrã nativo. O preço do produto no catálogo não muda. Uma redução de grupo pode ainda aplicar-se por cima: o preço apresentado na linha é sempre o que o PrestaShop vai faturar.
### 3. Moradas e entrega
A morada de entrega é a primeira morada do cliente. Mude-a com a lista pendente, corrija-a com **Editar** ou crie uma nova com **Nova morada**. Desmarque **Faturar para a morada de entrega** para escolher outra morada de faturação.
Uma morada já usada numa encomenda anterior nunca é alterada: o PrestaShop mantém a versão antiga nessas encomendas e o módulo guarda uma nova morada, que substitui a antiga no livro de moradas do cliente.
As transportadoras que entregam este carrinho nesta morada aparecem com o logótipo, o prazo e o preço. A primeira transportadora proposta pelo PrestaShop é selecionada automaticamente. Se a loja oferecer embrulho para oferta ou embalagem reciclada, as opções aparecem por baixo das transportadoras. Um carrinho que só contém produtos virtuais não precisa de transportadora.
### 4. Pagamento e estado
- **Método de pagamento**: os módulos de pagamento instalados e ativos na loja.
- **Estado da encomenda**: a indicação por baixo do campo diz se este estado considera a encomenda paga.
- **Mensagem para o cliente**: visível na conta do cliente e na encomenda, como uma mensagem deixada no momento da encomenda.
- **Nota interna**: guardada na nota da encomenda, visível apenas no back-office.
- **Enviar email ao cliente**: desmarcada, a confirmação da encomenda e o email do estado escolhido não são enviados ao cliente. Os emails destinados à loja são enviados normalmente.
## O resumo da encomenda
O resumo mostra o número de artigos, o total dos produtos, os descontos, os portes, o embrulho para oferta, o total s/ IVA, os impostos e o total c/ IVA, e depois a margem s/ IVA e a respetiva percentagem. Um ícone de alerta indica que um produto do carrinho não tem preço de custo.
- **Moeda e idioma**: as duas listas no topo do resumo. O idioma determina o dos nomes dos produtos e dos emails do cliente.
- **Código do vale de desconto**: escreva um código ou clique numa das sugestões, que são os vales que este cliente pode usar. A cruz retira um vale.
- **Desconto na encomenda**: um valor c/ IVA ou uma percentagem, depois **Aplicar**. É guardado como uma regra de carrinho de utilização única reservada ao cliente.
- **Envio grátis**: cria uma regra de carrinho de envio grátis para este carrinho, como a opção nativa.
A lista de verificação indica as etapas que faltam. **Criar a encomenda** (ou Ctrl + Enter) indica o que falta se a encomenda não estiver completa. Depois de criada a encomenda, uma janela mostra a referência e o total com três opções: abrir a encomenda, registar uma nova encomenda para este cliente, ou registar uma nova encomenda.
## Ligação de pagamento
Quando o cliente prefere pagar online, não crie a encomenda:
- **Enviar por email** envia o email nativo do PrestaShop que convida o cliente a pagar a encomenda, com a ligação do seu carrinho.
- **Copiar a ligação** coloca a mesma ligação na área de transferência, para um SMS ou uma aplicação de mensagens.
O cliente chega ao passo de pagamento da loja, com sessão iniciada na sua conta, com o carrinho preparado (preços alterados, descontos e transportadora incluídos). A encomenda é criada pelo pagamento do cliente.
## Rascunho e vários separadores
O carrinho atual é mantido: ao voltar à página, o módulo retoma o último carrinho do funcionário e indica-o com uma mensagem. O número do carrinho está no endereço da página, o que permite registar duas encomendas em dois separadores. **Recomeçar** inicia um novo registo, e o carrinho anterior fica nos carrinhos do cliente.
O botão **As minhas encomendas recentes** lista as encomendas criadas pelo funcionário com o módulo.
## Atalhos de teclado
- / ou F2: pesquisar um produto
- Alt + C: pesquisar um cliente
- Alt + N: novo cliente
- ↑ ↓ e depois Enter: escolher nos resultados
- Esc: fechar os resultados
- Ctrl + Enter: criar a encomenda
- ?: mostrar a ajuda dos atalhos
## Na página da encomenda
Cada encomenda criada com o módulo mostra um bloco **Registo de encomendas**: o funcionário que a registou, a data, se o cliente não foi avisado por email, e o número de linhas cujo preço foi alterado.
## Resolução de problemas
### Não aparece nenhuma transportadora
Nenhuma transportadora cobre a zona do país de entrega, ou o peso e o valor do carrinho estão fora dos seus escalões. Verifique a configuração das transportadoras, ou escolha outra morada.
### O produto não é adicionado: «Apenas X em stock»
O produto não aceita encomendas sem stock. Ative a opção **Permitir adicionar produtos sem stock** na configuração e depois assinale a caixa **Permitir produtos sem stock nesta encomenda** por baixo da pesquisa de produtos.
### O email da ligação de pagamento ou da palavra-passe não foi enviado
O módulo usa os emails do PrestaShop. Verifique a configuração em **Parâmetros avançados > E-mail** e envie um email de teste.
### Os botões «Adicionar nova encomenda» ainda abrem o ecrã nativo
Verifique se a opção de substituição está ativa e depois limpe a cache do navegador. Se o módulo foi desativado e reativado, verifique se continua associado ao hook `displayBackOfficeHeader`.