# Refurbished Producten in PrestaShop: installatie en instellingen

> Overzicht De module voegt aan PrestaShop 8 en 9 het beheer van refurbished producten en unieke stukken toe. Elke conditiegrade (A, B, C en de graden die u toevoegt) is…

- Pagina: <https://www.datafirefly.com/nl/documentation/dfrefurbished/>
- Taal: nl
- Bijgewerkt op: 2026-10-07
- Andere talen: [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), [pt](https://www.datafirefly.com/pt/documentation/dfrefurbished/index.md)
- Index: <https://www.datafirefly.com/nl/documentation/llms.txt>

## Overzicht

De module voegt aan PrestaShop 8 en 9 het beheer van refurbished producten en unieke stukken toe. Elke conditiegrade (A, B, C en de graden die u toevoegt) is een standaard attribuutwaarde: een refurbished product heeft dus combinaties zoals "128 GB Zwart, grade A". Elk toestel is een exemplaar met serienummer, foto's en tests, en de voorraad van elke gradecombinatie is gelijk aan het aantal beschikbare exemplaren.

## Installatie

1. Klik in **Modules > Modulebeheer** op **Een module uploaden** en verstuur het bestand `dfrefurbished-1.2.1.zip`.
2. De installatie maakt de attribuutgroep **Grade (DataFirefly)** aan, in de winkel getoond als "Staat", met de graden A, B en C.
3. Het menu **Catalogus > Refurbished exemplaren** verschijnt. De knop Configureren van de module leidt naar de graden en instellingen.

Om een eerdere versie bij te werken, uploadt u gewoon het nieuwe ZIP-bestand: het updatescript voegt de nodige kolommen en tabellen toe.

## Graden configureren

In de moduleconfiguratie toont het blok **Conditiegraden** de graden met:

- **Code** (A, B, C...) en **kleur**, gebruikt op kaarten, badges en etiketten;
- **Naam en beschrijving** in elke taal (link "Alle talen tonen");
- **Standaard prijsimpact** in procent (0, -10 en -20% bij de installatie);
- **Positie**: de eerste grade is de beste, zijn meter is vol;
- **Actief**.

Met de laatste rij voegt u een grade toe (vink **Toevoegen** aan). Een grade kan niet worden verwijderd omdat combinaties en bestellingen hem gebruiken: schakel hem uit.

## Module-instellingen

- **Gradekaarten tonen** op de productpagina, met meter, prijs, besparing en voorraad.
- **De standaard gradekeuze verbergen** wanneer de kaarten worden getoond.
- **Exemplaarmodus: de standaard winkelwagenknop verbergen**; de klant voegt dan een stuk toe met de eigen knop.
- **Serienummers maskeren** op openbare pagina's (de laatste 4 tekens zichtbaar).
- **Vergelijking nieuw/refurbished** en de positie: onder het product of naast de winkelwagenknop.
- **Refurbished aanbod op de pagina van het nieuwe product**.
- **Standaardgaranties** voor refurbished en nieuw, in maanden.
- **Reservering van een stuk in de winkelwagen**, standaard 30 minuten.
- **Serienummers in de bestelregel**, dus op de factuur en de creditnota.
- **Bestelstatussen die exemplaren terug in voorraad zetten** (standaard geannuleerd en betalingsfout) en status van vrijgegeven exemplaren: beschikbaar of geretourneerd (te controleren).
- **Testchecklist**: één punt per regel, in elke taal. Houd in elke taal dezelfde volgorde aan, punten worden gekoppeld via het regelnummer.

Het blok **Hulpmiddelen** leidt naar de exemplaren en synchroniseert alle voorraad opnieuw.

## Een refurbished product voorbereiden

Open het product, tabblad **Modules**, daarna **DataFirefly Refurbished & Unique Items**.

1. Vink **Dit product wordt refurbished verkocht** aan. De standaard productconditie wordt op "Gereviseerd" gezet.
2. Kies de **verkoopmodus**: per grade (het stuk wordt bij de bestelling toegewezen) of per exemplaar (de klant kiest het exacte toestel).
3. Geef het **overeenkomstige nieuwe product** op voor de vergelijking en de getoonde besparing. Combinaties worden gekoppeld op dezelfde attributen (capaciteit, kleur).
4. Stel indien nodig de garanties en de **prijsimpact** van elke grade voor dit product in, in procent of als bedrag excl. btw. Leeg gelaten geldt het percentage van de grade.
5. Klik op **Refurbished-instellingen opslaan**.
6. Klik op **Gradecombinaties aanmaken**: één combinatie per basisoptie (capaciteit, kleur...) en actieve grade. De verwijderoptie verwijdert daarna combinaties zonder grade; eerdere bestellingen behouden hun regels.
7. Klik op **Gradeprijzen toepassen**.

De gradetabel toont per grade het aantal beschikbare, verkochte, geretourneerde en verborgen exemplaren.

## Exemplaren toevoegen

Klik in **Catalogus > Refurbished exemplaren** op **Exemplaar toevoegen**.

- **Product** (zoeken op naam, referentie of ID), **basiscombinatie** en **grade**. De gradecombinatie wordt automatisch aangemaakt als ze niet bestaat.
- **Serienummer**: uniek per winkel. Het veld werkt met een barcodescanner.
- **Status**: beschikbaar, verkocht, geretourneerd, verborgen.
- **Batterijconditie**, **garantie** (leeg = waarde van het product of de module) en **refurbishdatum**.
- **Eigen verkoopprijs (excl. btw)**: alleen gebruikt in exemplaarmodus. Leeg = prijs van de gradecombinatie.
- **Openbare opmerkingen** in elke taal en **testchecklist** (OK, defect, n.v.t., niet getest).
- **Foto's**: JPG, PNG, WebP of GIF, maximaal 10 MB per foto, automatisch geschaald.
- Paneel **Intern**: SKU, kostprijs, herkomst en interne notities, nooit zichtbaar voor klanten.

**Opslaan en nog een toevoegen** behoudt product, combinatie en grade voor de volgende invoer. De pagina van het exemplaar toont de geschiedenis, een link naar de openbare fiche en een knop om het etiket af te drukken.

## Exemplaren importeren uit CSV

Knop **CSV importeren** in de lijst van exemplaren. UTF-8-bestand, scheidingsteken `;` of `,` herkend uit de kopregel. Er is een voorbeeldbestand beschikbaar.

- Verplicht: `serial`, `grade` (gradecode) en `product_id` of `product_reference`.
- `base_reference`: referentie van de combinatie zonder grade, leeg voor een product zonder andere attributen.
- Optioneel: `status` (available, hidden, returned), `battery`, `warranty_months`, `date_refurbished` (JJJJ-MM-DD), `price`, `cost_price`, `origin`, `sku`, `notes`, `internal_notes`.

Vink **Reeds bekende exemplaren bijwerken** aan om bestaande serienummers te wijzigen, anders worden ze overgeslagen. Een verkocht exemplaar wordt nooit door een import gewijzigd.

## In de winkel

### Productpagina

De gradekaarten tonen de conditiemeter, de prijs ("Vanaf" wanneer de stukken verschillende prijzen hebben), de besparing ten opzichte van nieuw en de voorraad. De link **Hoe worden de graden bepaald?** opent een venster met de beschrijving van elke grade, de checklist en de garantie.

### Exemplaarmodus

Onder de kaarten toont de lijst **Kies uw stuk** elk beschikbaar exemplaar van de gekozen grade: foto (schermvullende viewer bij klikken), gemaskeerd nummer, batterij, tests, garantie en prijs. De knop **Dit stuk toevoegen** reserveert het in de winkelwagen voor de ingestelde duur; een stuk dat al door een andere klant is gereserveerd toont "Gereserveerd".

### Vergelijking en nieuw product

De tabel vergelijkt nieuw en elke grade: prijs, besparing, cosmetische staat, garantie, beschikbaarheid. Op de pagina van het nieuwe product biedt een kader het refurbished aanbod aan vanaf de goedkoopste grade.

### Fiche van het exemplaar en certificaat

Een beschikbaar exemplaar heeft een openbare fiche (niet geïndexeerd) met foto's, batterij, checklist en notities van de technicus. Na de verkoop vindt de koper in de details van zijn bestelling een link naar het **conditiecertificaat**, met het volledige nummer, de einddatum van de garantie en een afdrukknop.

## Bestellingen

- Bij het bevestigen worden eerst de door de winkelwagen gereserveerde exemplaren toegewezen, daarna de oudste vrije exemplaren. Exemplaren met een eigen prijs blijven voorbehouden aan de verkoop per exemplaar.
- Het serienummer wordt aan de naam van de bestelregel toegevoegd als de instelling actief is.
- De bestelling in de backoffice toont een blok **Refurbished exemplaren** met een link naar elk exemplaar.
- Bij de gekozen statussen gaan de exemplaren terug naar beschikbaar of geretourneerd, en de gebeurtenis wordt in hun geschiedenis vastgelegd.

## Dashboard en etiketten

Boven de lijst van exemplaren: exemplaren te koop, te controleren en verborgen, voorraadwaarde tegen kostprijs, gemiddelde leeftijd van de voorraad en aantal exemplaren dat al meer dan 60 dagen te koop staat, verkochte exemplaren, omzet excl. btw en brutomarge over 30 dagen.

De bulkactie **Etiketten afdrukken** opent een A4-vel met 24 etiketten van 63,5 x 33,9 mm (type L7159): product, grade, batterij, serienummer en QR-code naar de fiche van het exemplaar. Met het veld **Beginnen bij etiket nr.** hergebruikt u een aangebroken vel. Druk af op 100%, zonder marges of kopteksten.

## Bekende beperkingen

- De eigen prijs van een stuk geldt alleen in exemplaarmodus, en catalogusprijsregels gelden niet voor stukken met een eigen prijs.
- Bij een refurbished product wordt handmatig ingevoerde voorraad op een gradecombinatie vervangen door het aantal beschikbare exemplaren.
- Als een medewerker zonder rechten op de module een product bewerkt, voert PrestaShop de hooks van de module niet uit: gebruik de hersynchronisatie van de voorraad.
- Het verbergen van de standaard gradekeuze steunt op de HTML van de standaard productpagina. Bij een sterk aangepast thema kan de standaard keuze naast de kaarten zichtbaar blijven.
- Als de reservering van een stuk verloopt terwijl het nog in de winkelwagen ligt, kan een andere klant het reserveren; de bestelling van de eerste klant krijgt dan een ander exemplaar van dezelfde grade, als dat bestaat.
