# Productos Reacondicionados PrestaShop: instalación y configuración

> Presentación El módulo añade a PrestaShop 8 y 9 la gestión de productos reacondicionados y piezas únicas. Cada grado de estado (A, B, C y los que añada) es un…

- Página: <https://www.datafirefly.com/es/documentation/dfrefurbished/>
- Idioma: es
- Actualizado el: 2026-10-07
- Otros idiomas: [fr](https://www.datafirefly.com/documentation/dfrefurbished/index.md), [en](https://www.datafirefly.com/en/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), [pt](https://www.datafirefly.com/pt/documentation/dfrefurbished/index.md)
- Índice: <https://www.datafirefly.com/es/documentation/llms.txt>

## Presentación

El módulo añade a PrestaShop 8 y 9 la gestión de productos reacondicionados y piezas únicas. Cada grado de estado (A, B, C y los que añada) es un valor de atributo nativo: un producto reacondicionado tiene combinaciones como «128 GB Negro, grado A». Cada aparato es una unidad con su número de serie, sus fotos y sus pruebas, y el stock de cada combinación de grado es igual al número de unidades disponibles.

## Instalación

1. En **Módulos > Gestor de módulos**, haga clic en **Subir un módulo** y envíe el archivo `dfrefurbished-1.2.1.zip`.
2. La instalación crea el grupo de atributos **Grade (DataFirefly)**, mostrado como «Estado» en la tienda, con los grados A, B y C.
3. Aparece el menú **Catálogo > Unidades reacondicionadas**. El botón Configurar del módulo lleva a los grados y ajustes.

Para actualizar una versión anterior, basta con subir el nuevo ZIP: el script de actualización añade las columnas y tablas necesarias.

## Configurar los grados

En la configuración del módulo, el bloque **Grados de estado** lista los grados con:

- **Código** (A, B, C…) y **color**, usados en tarjetas, insignias y etiquetas;
- **Nombre y descripción** en cada idioma (enlace «Mostrar todos los idiomas»);
- **Impacto en el precio por defecto** en porcentaje (0, -10 y -20 % en la instalación);
- **Posición**: el primer grado es el mejor, su indicador está lleno;
- **Activo**.

La última fila permite añadir un grado (marque **Añadir**). Un grado no se puede eliminar porque lo usan combinaciones y pedidos: desactívelo.

## Ajustes del módulo

- **Mostrar las tarjetas de grado** en la ficha de producto, con indicador, precio, ahorro y stock.
- **Ocultar el selector de grado nativo** cuando se muestran las tarjetas.
- **Modo unidad: ocultar el botón nativo de añadir al carrito**; el cliente añade entonces una pieza con su propio botón.
- **Ocultar los números de serie** en las páginas públicas (se muestran los 4 últimos caracteres).
- **Comparación nuevo/reacondicionado** y su posición: debajo del producto o junto al botón de compra.
- **Oferta reacondicionada en la ficha del producto nuevo**.
- **Garantías por defecto** del reacondicionado y del nuevo, en meses.
- **Reserva de una pieza en el carrito**, 30 minutos por defecto.
- **Números de serie en la línea de pedido**, y por tanto en la factura y la factura rectificativa.
- **Estados de pedido que devuelven las unidades al stock** (cancelado y error de pago por defecto) y estado de las unidades liberadas: disponibles o devueltas (a revisar).
- **Lista de pruebas**: un punto por línea, en cada idioma. Mantenga el mismo orden en todos los idiomas: los puntos se asocian por número de línea.

El bloque **Herramientas** da acceso a las unidades y a la resincronización de todo el stock.

## Preparar un producto reacondicionado

Abra el producto, pestaña **Módulos**, y luego **DataFirefly Refurbished & Unique Items**.

1. Marque **Este producto se vende reacondicionado**. El estado nativo del producto pasa a «Reacondicionado».
2. Elija el **modo de venta**: por grado (la pieza se asigna al pedido) o por pieza (el cliente elige el aparato exacto).
3. Indique el **producto nuevo equivalente** para la comparación y el ahorro mostrado. Las combinaciones se asocian por los mismos atributos (capacidad, color).
4. Ajuste si es necesario las garantías y el **impacto en el precio** de cada grado para este producto, en porcentaje o en importe sin IVA. Si se deja vacío, se aplica el porcentaje del grado.
5. Haga clic en **Guardar los ajustes de reacondicionado**.
6. Haga clic en **Crear las combinaciones de grado**: una combinación por opción base (capacidad, color…) y por grado activo. La opción de eliminación quita después las combinaciones sin grado; los pedidos anteriores conservan sus líneas.
7. Haga clic en **Aplicar los precios de los grados**.

La tabla de grados muestra para cada grado el número de unidades disponibles, vendidas, devueltas y ocultas.

## Añadir unidades

En **Catálogo > Unidades reacondicionadas**, haga clic en **Añadir una unidad**.

- **Producto** (búsqueda por nombre, referencia o ID), **combinación base** y **grado**. La combinación de grado se crea automáticamente si no existe.
- **Número de serie**: único por tienda. El campo admite un lector de códigos de barras.
- **Estado**: disponible, vendida, devuelta, oculta.
- **Salud de la batería**, **garantía** (vacío = valor del producto o del módulo) y **fecha de reacondicionamiento**.
- **Precio de venta propio (sin IVA)**: solo se usa en modo por pieza. Vacío = precio de la combinación de grado.
- **Notas públicas** en cada idioma y **lista de pruebas** (OK, defecto, N/A, no probado).
- **Fotos**: JPG, PNG, WebP o GIF, 10 MB como máximo cada una, redimensionadas automáticamente.
- Panel **Interno**: SKU, precio de coste, procedencia y notas internas, nunca visibles para los clientes.

**Guardar y añadir otra** conserva el producto, la combinación y el grado para encadenar entradas. La ficha de la unidad muestra su historial, un enlace a su ficha pública y un botón para imprimir la etiqueta.

## Importar unidades en CSV

Botón **Importar CSV** en la lista de unidades. Archivo UTF-8, separador `;` o `,` detectado en la línea de cabecera. Se puede descargar un archivo de ejemplo.

- Obligatorias: `serial`, `grade` (código del grado) y `product_id` o `product_reference`.
- `base_reference`: referencia de la combinación sin grado, vacía para un producto sin otros atributos.
- Opcionales: `status` (available, hidden, returned), `battery`, `warranty_months`, `date_refurbished` (AAAA-MM-DD), `price`, `cost_price`, `origin`, `sku`, `notes`, `internal_notes`.

Marque **Actualizar las unidades ya conocidas** para modificar los números existentes; si no, se omiten. Una unidad vendida nunca se modifica por una importación.

## En la tienda

### Ficha de producto

Las tarjetas de grado muestran el indicador de estado, el precio («Desde» cuando las piezas tienen precios distintos), el ahorro respecto al nuevo y el stock. El enlace **¿Cómo se definen los grados?** abre una ventana con la descripción de cada grado, la lista de pruebas y la garantía.

### Modo por pieza

Bajo las tarjetas, la lista **Elija su pieza** muestra cada unidad disponible del grado elegido: foto (visor a pantalla completa al hacer clic), número enmascarado, batería, pruebas, garantía y precio. El botón **Añadir esta pieza** la reserva en el carrito durante el tiempo configurado; una pieza ya reservada por otro cliente muestra «Reservada».

### Comparación y producto nuevo

La tabla compara el nuevo y cada grado: precio, ahorro, estado estético, garantía, disponibilidad. En la ficha del producto nuevo, un recuadro propone la oferta reacondicionada a partir del grado más barato.

### Ficha de la unidad y certificado

Una unidad disponible tiene una ficha pública (no indexada) con sus fotos, su batería, su lista de pruebas y las notas del técnico. Tras la venta, el comprador encuentra en el detalle de su pedido un enlace al **certificado de estado**, con el número completo, la fecha de fin de garantía y un botón de impresión.

## Pedidos

- Al validar, se asignan primero las unidades reservadas por el carrito y luego las unidades libres más antiguas. Las unidades con precio propio se reservan para la venta por pieza.
- El número de serie se añade al nombre de la línea de pedido si el ajuste está activo.
- El pedido en el back-office muestra un bloque **Unidades reacondicionadas** con un enlace a cada unidad.
- En los estados elegidos, las unidades vuelven a disponible o a devuelta, y el evento se registra en su historial.

## Panel y etiquetas

Encima de la lista de unidades: unidades a la venta, a revisar y ocultas, valor del stock a precio de coste, antigüedad media del stock y número de unidades a la venta desde hace más de 60 días, unidades vendidas, facturación sin IVA y margen bruto a 30 días.

La acción masiva **Imprimir etiquetas** abre una hoja A4 de 24 etiquetas de 63,5 x 33,9 mm (tipo L7159): producto, grado, batería, número de serie y código QR hacia la ficha de la unidad. El campo **Empezar en la etiqueta n.º** permite reutilizar una hoja empezada. Imprima al 100 %, sin márgenes ni encabezados.

## Limitaciones conocidas

- El precio propio de una pieza solo se aplica en modo por pieza, y las reglas de precios del catálogo no se aplican a las piezas con precio propio.
- En un producto reacondicionado, el stock introducido a mano en una combinación de grado se sustituye por el número de unidades disponibles.
- Si un empleado sin permisos sobre el módulo modifica un producto, PrestaShop no ejecuta los hooks del módulo: use la resincronización del stock.
- La ocultación del selector de grado nativo se basa en el HTML de la ficha de producto nativa. En un tema muy personalizado, el selector nativo puede seguir visible junto a las tarjetas.
- Si la reserva de una pieza caduca mientras sigue en el carrito, otro cliente puede reservarla; el pedido del primer cliente recibe entonces otra unidad del mismo grado si existe.
