# Produtos Recondicionados PrestaShop: instalação e configuração > Apresentação O módulo acrescenta ao PrestaShop 8 e 9 a gestão de produtos recondicionados e peças únicas. Cada grau de estado (A, B, C e os que acrescentar) é um… - Página: - Idioma: pt - Atualizado em: 2026-10-07 - Outros idiomas: [fr](https://www.datafirefly.com/documentation/dfrefurbished/index.md), [en](https://www.datafirefly.com/en/documentation/dfrefurbished/index.md), [es](https://www.datafirefly.com/es/documentation/dfrefurbished/index.md), [de](https://www.datafirefly.com/de/documentation/dfrefurbished/index.md), [it](https://www.datafirefly.com/it/documentation/dfrefurbished/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfrefurbished/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfrefurbished/index.md) - Índice: ## Apresentação O módulo acrescenta ao PrestaShop 8 e 9 a gestão de produtos recondicionados e peças únicas. Cada grau de estado (A, B, C e os que acrescentar) é um valor de atributo nativo: um produto recondicionado tem portanto combinações como «128 GB Preto, grau A». Cada aparelho é uma unidade com o seu número de série, as suas fotos e os seus testes, e o stock de cada combinação de grau é igual ao número de unidades disponíveis. ## Instalação 1. Em **Módulos > Gestor de módulos**, clique em **Carregar um módulo** e envie o ficheiro `dfrefurbished-1.2.1.zip`. 2. A instalação cria o grupo de atributos **Grade (DataFirefly)**, mostrado como «Estado» na loja, com os graus A, B e C. 3. Aparece o menu **Catálogo > Unidades recondicionadas**. O botão Configurar do módulo leva aos graus e às definições. Para atualizar uma versão anterior, basta carregar o novo ZIP: o script de atualização acrescenta as colunas e tabelas necessárias. ## Configurar os graus Na configuração do módulo, o bloco **Graus de estado** lista os graus com: - **Código** (A, B, C…) e **cor**, usados nos cartões, distintivos e etiquetas; - **Nome e descrição** em cada idioma (ligação «Mostrar todos os idiomas»); - **Impacto no preço por defeito** em percentagem (0, -10 e -20% na instalação); - **Posição**: o primeiro grau é o melhor, o indicador fica cheio; - **Ativo**. A última linha permite acrescentar um grau (marque **Adicionar**). Um grau não pode ser eliminado porque é usado por combinações e encomendas: desative-o. ## Definições do módulo - **Mostrar os cartões de grau** na página do produto, com indicador, preço, poupança e stock. - **Ocultar o seletor de grau nativo** quando os cartões são mostrados. - **Modo unidade: ocultar o botão nativo de adicionar ao carrinho**; o cliente adiciona então uma peça com o respetivo botão. - **Ocultar os números de série** nas páginas públicas (mostrados os 4 últimos caracteres). - **Comparação novo/recondicionado** e a sua posição: por baixo do produto ou junto ao botão do carrinho. - **Oferta recondicionada na página do produto novo**. - **Garantias por defeito** do recondicionado e do novo, em meses. - **Reserva de uma peça no carrinho**, 30 minutos por defeito. - **Números de série na linha da encomenda**, portanto na fatura e na nota de crédito. - **Estados de encomenda que repõem as unidades em stock** (cancelada e erro de pagamento por defeito) e estado das unidades libertadas: disponíveis ou devolvidas (a verificar). - **Lista de testes**: um ponto por linha, em cada idioma. Mantenha a mesma ordem em todos os idiomas: os pontos são associados pelo número da linha. O bloco **Ferramentas** dá acesso às unidades e à ressincronização de todo o stock. ## Preparar um produto recondicionado Abra o produto, separador **Módulos**, e depois **DataFirefly Refurbished & Unique Items**. 1. Marque **Este produto é vendido recondicionado**. O estado nativo do produto passa a «Recondicionado». 2. Escolha o **modo de venda**: por grau (a peça é atribuída na encomenda) ou por peça (o cliente escolhe o aparelho exato). 3. Indique o **produto novo equivalente** para a comparação e a poupança mostrada. As combinações são associadas pelos mesmos atributos (capacidade, cor). 4. Se necessário, ajuste as garantias e o **impacto no preço** de cada grau para este produto, em percentagem ou montante sem IVA. Se ficar vazio, aplica-se a percentagem do grau. 5. Clique em **Guardar as definições de recondicionado**. 6. Clique em **Criar as combinações de grau**: uma combinação por opção base (capacidade, cor…) e por grau ativo. A opção de eliminação remove depois as combinações sem grau; as encomendas anteriores mantêm as suas linhas. 7. Clique em **Aplicar os preços dos graus**. A tabela de graus mostra para cada grau o número de unidades disponíveis, vendidas, devolvidas e ocultas. ## Acrescentar unidades Em **Catálogo > Unidades recondicionadas**, clique em **Adicionar uma unidade**. - **Produto** (pesquisa por nome, referência ou ID), **combinação base** e **grau**. A combinação de grau é criada automaticamente se não existir. - **Número de série**: único por loja. O campo aceita um leitor de código de barras. - **Estado**: disponível, vendida, devolvida, oculta. - **Saúde da bateria**, **garantia** (vazio = valor do produto ou do módulo) e **data de recondicionamento**. - **Preço de venda próprio (sem IVA)**: usado apenas no modo por peça. Vazio = preço da combinação de grau. - **Notas públicas** em cada idioma e **lista de testes** (OK, defeito, N/A, não testado). - **Fotos**: JPG, PNG, WebP ou GIF, máximo 10 MB cada, redimensionadas automaticamente. - Painel **Interno**: SKU, preço de custo, proveniência e notas internas, nunca mostrados aos clientes. **Guardar e adicionar outra** mantém o produto, a combinação e o grau para encadear registos. A página da unidade mostra o seu histórico, uma ligação para a ficha pública e um botão para imprimir a etiqueta. ## Importar unidades em CSV Botão **Importar CSV** na lista de unidades. Ficheiro UTF-8, separador `;` ou `,` detetado na linha de cabeçalho. Está disponível um ficheiro de exemplo. - Obrigatórias: `serial`, `grade` (código do grau) e `product_id` ou `product_reference`. - `base_reference`: referência da combinação sem grau, vazia para um produto sem outros atributos. - Opcionais: `status` (available, hidden, returned), `battery`, `warranty_months`, `date_refurbished` (AAAA-MM-DD), `price`, `cost_price`, `origin`, `sku`, `notes`, `internal_notes`. Marque **Atualizar as unidades já conhecidas** para alterar os números existentes; caso contrário, são ignorados. Uma unidade vendida nunca é alterada por uma importação. ## Na loja ### Página do produto Os cartões de grau mostram o indicador de estado, o preço («Desde» quando as peças têm preços diferentes), a poupança face ao novo e o stock. A ligação **Como são definidos os graus?** abre uma janela com a descrição de cada grau, a lista de testes e a garantia. ### Modo por peça Por baixo dos cartões, a lista **Escolha a sua peça** apresenta cada unidade disponível do grau escolhido: foto (visualizador em ecrã inteiro ao clicar), número mascarado, bateria, testes, garantia e preço. O botão **Adicionar esta peça** reserva-a no carrinho durante o tempo definido; uma peça já reservada por outro cliente mostra «Reservada». ### Comparação e produto novo A tabela compara o novo e cada grau: preço, poupança, estado estético, garantia, disponibilidade. Na página do produto novo, um destaque propõe a oferta recondicionada a partir do grau mais barato. ### Ficha da unidade e certificado Uma unidade disponível tem uma ficha pública (não indexada) com as suas fotos, bateria, lista de testes e notas do técnico. Após a venda, o comprador encontra no detalhe da encomenda uma ligação para o **certificado de estado**, com o número completo, a data de fim da garantia e um botão de impressão. ## Encomendas - Na validação, são atribuídas primeiro as unidades reservadas pelo carrinho e depois as unidades livres mais antigas. As unidades com preço próprio ficam reservadas para a venda por peça. - O número de série é acrescentado ao nome da linha da encomenda se a definição estiver ativa. - A encomenda no back-office mostra um bloco **Unidades recondicionadas** com uma ligação para cada unidade. - Nos estados escolhidos, as unidades voltam a disponível ou a devolvida, e o evento fica registado no seu histórico. ## Painel e etiquetas Por cima da lista de unidades: unidades à venda, a verificar e ocultas, valor do stock ao preço de custo, idade média do stock e número de unidades à venda há mais de 60 dias, unidades vendidas, faturação sem IVA e margem bruta a 30 dias. A ação em massa **Imprimir etiquetas** abre uma folha A4 de 24 etiquetas de 63,5 x 33,9 mm (tipo L7159): produto, grau, bateria, número de série e código QR para a ficha da unidade. O campo **Começar na etiqueta n.º** permite reutilizar uma folha já começada. Imprima a 100%, sem margens nem cabeçalhos. ## Limitações conhecidas - O preço próprio de uma peça só se aplica no modo por peça, e as regras de preços do catálogo não se aplicam às peças com preço próprio. - Num produto recondicionado, o stock introduzido à mão numa combinação de grau é substituído pelo número de unidades disponíveis. - Se um funcionário sem permissões sobre o módulo alterar um produto, o PrestaShop não executa os hooks do módulo: use a ressincronização do stock. - A ocultação do seletor de grau nativo assenta no HTML da página de produto nativa. Num tema muito personalizado, o seletor nativo pode continuar visível junto aos cartões. - Se a reserva de uma peça expirar enquanto ainda está no carrinho, outro cliente pode reservá-la; a encomenda do primeiro cliente recebe então outra unidade do mesmo grau, se existir.