Mass Product Updater (CSV/Excel). Mass Product Updater importeert een CSV- of Excelbestand (.xlsx) en werkt de prijs, de voorraad, de status en de identificatiecodes van uw bestaande producten bij. U slaat herbruikbare profielen voor kolomtoewijzing op, bekijkt elke wijziging vooraf in een proefrun met een verschil per rij voordat er iets wordt weggeschreven, voert de import in batches uit met een foutenrapport per rij en maakt de laatste run zo nodig ongedaan. Met een cron die met een token is beveiligd automatiseert u feeds van leveranciers. Geen programmeerwerk, geen aanpassingen aan het thema.
Mass Product Updater importeert een CSV- of Excelbestand (.xlsx) en werkt de prijs, de voorraad, de status en de identificatiecodes van uw bestaande producten bij. U slaat herbruikbare profielen voor kolomtoewijzing op, bekijkt elke wijziging vooraf in een proefrun met een verschil per rij voordat er iets wordt weggeschreven, voert de import in batches uit met een foutenrapport per rij en maakt de laatste run zo nodig ongedaan. Met een cron die met een token is beveiligd automatiseert u feeds van leveranciers. Geen programmeerwerk, geen aanpassingen aan het thema.
1. Installatie
- Ga in het back-office naar Modules → Module Manager → Upload a module en selecteer de ZIP van de module.
- Klik na de installatie op Configure om de installatiewizard te openen.
.local, .test, localhost) zijn altijd toegestaan. Zodra er een nieuwe versie beschikbaar is, wordt dit direct in de module getoond.Als u in plaats van de bevestiging de melding ‘Upload failed’ ziet, heeft PrestaShop de module mogelijk zonder bericht uitgeschakeld: uw instellingen en gegevens blijven behouden. Hoe u een module bijwerkt en wat u doet bij de melding ‘Upload failed’.
2. Configuratie: stap voor stap
Het scherm Configure heeft vier tabbladen: Import / update, Mapping profiles, History & rollback en Settings. Een gewone import verloopt als een korte wizard: uploaden → kolommen toewijzen → proefrun → toepassen.
1. Een CSV- of Excelbestand uploaden begin hier
Kies op het tabblad Import / update een File (.csv / .xlsx) en klik op Upload. Toegestane typen zijn .csv, .txt en .xlsx, tot 20 MB. CSV wordt volledig ondersteund; XLSX wordt naar best vermogen gelezen als de PHP-extensies ZIP en SimpleXML beschikbaar zijn. Hebt u al een opgeslagen profiel, kies het dan bij Use a saved profile om de toewijzing en de bronopties vooraf in te vullen. Onthoud: dit hulpmiddel werkt alleen bestaande producten bij en maakt nooit nieuwe aan.
2. Kolommen en bronopties toewijzen
Na het uploaden toont de module een voorbeeld van de koptekst en de eerste voorbeeldrijen, zodat u elke bronkolom kunt toewijzen. Stel bovenaan de opties voor het inlezen in en daaronder de kolomtoewijzing.
- Match products by: de identificatiecode waarmee het product wordt gevonden: Product ID, Reference, EAN13, UPC of Supplier reference.
- Delimiter / Enclosure: het scheidingsteken tussen velden (gebruik
\tvoor een tab) en het aanhalingsteken. - Encoding / Decimal: de codering van het bestand (bijv.
UTF-8,ISO-8859-1,Windows-1252; het wordt naar UTF-8 omgezet) en het decimaalteken (.of,). - First row is a header: vink aan als rij 1 kolomnamen bevat.
- When no product matches: Skip silently of Report in the run log.
- Column mapping table: kies voor elke kolom waaraan ze wordt toegewezen: ** MATCH KEY (identifier) **, Price (tax excl.), Wholesale price, Stock quantity (set), Stock quantity (delta +/-), Specific price (fixed), Active (0/1), Weight, Reference, EAN13, UPC, Minimum quantity, of laat het op -- ignore -- staan.
U moet precies één kolom toewijzen als MATCH KEY en minstens één kolom aan een veld dat moet worden bijgewerkt.
3. Proefrun: voorbeeld & verschil aanbevolen
Klik op Dry-run (preview) om de import te simuleren zonder iets weg te schrijven. De module meldt hoeveel rijen matched zijn, not found zijn of errors hadden, en opent het detail van de run met een verschil per rij: elk gewijzigd veld wordt getoond als oud → nieuw. Bekijk het verschil altijd voordat u de wijzigingen toepast.
4. De import uitvoeren (toepassen)
Klik als het verschil klopt op Apply changes en bevestig. De import draait in batches (de Batch size bij Settings bepaalt hoeveel rijen per transactie worden verwerkt). Aan het einde krijgt u een samenvatting, updated, not found, errors van het totale aantal rijen, en het volledige detail van de run met het logboek per rij.
5. Mapping profiles herbruikbaar
Op het tabblad Mapping profiles slaat u een kolomtoewijzing eenmalig op en gebruikt u die opnieuw voor terugkerende feeds. Een profiel bevat de profielnaam, het match field, het scheidingsteken, aanhalingsteken, de codering en het decimaalteken, de vlag voor de koptekst, het gedrag bij niet-gevonden producten en de toewijzing per kolom (op basis van de kolomindex vanaf 0). Opgeslagen profielen kunt u bewerken of verwijderen, en ze zijn te kiezen op het tabblad Import en voor de cron.
6. History & rollback
Het tabblad History & rollback toont recente runs met hun modus (dry-run / apply), bron, totalen en status. Open een run om de statistieken te zien, het logboek per rij (te filteren op resultaat) en een knop Download report (CSV). Bij een toegepaste run kunt u op Roll back this run klikken om de vorige waarden van elk gewijzigd veld te herstellen, mits de momentopname van vóór de update is bewaard (zie Settings).
7. Cron beveiligd met een token automatisering
Op het tabblad Settings geeft de sectie Scheduled import (cron) u een kant-en-klare Cron URL met een geheim token. Roep die aan vanuit uw planner (bijv. crontab) om het gekozen Cron profile toe te passen op de ingestelde Cron source: een http(s)-URL van een feed van een leverancier, of een eenvoudige bestandsnaam in de werkmap van de module (modules/cll_csvimport/work/). Gebruik Regenerate cron token om het token te vernieuwen. Het token is verplicht en wordt gecontroleerd via een hash.
8. Settings: standaardwaarden & gegevens
Het tabblad Settings bevat ook: Enable the module, Batch size (20-5000 rijen per transactie; lager is veiliger op kleine servers), de default source options (scheidingsteken, aanhalingsteken, codering, decimaalteken, koptekst, gedrag bij niet-gevonden producten) waarmee nieuwe imports vooraf worden ingevuld, Keep pre-update snapshot (maakt rollback mogelijk, laat het aan) en Drop data on uninstall (standaard uit; indien aan verwijdert het deïnstalleren alle profielen en de volledige runhistorie).
3. Controleer of het werkt
- Upload een klein bestand en voer een Dry-run uit; open het detail van de run en controleer dat het verschil per rij de verwachte waarden oud → nieuw toont.
- Voer Apply changes uit op een paar rijen, open daarna de betreffende producten en controleer dat de prijs of voorraad is gewijzigd zoals getoond.
- Open via History & rollback die toegepaste run en klik op Roll back this run; controleer dat de producten weer hun vorige waarden hebben.
- Plak de Cron URL in een browser (of roep hem aan met
curl), er moet een run in History verschijnen voor het ingestelde profiel en de ingestelde bron.
4. FAQ
Maakt het nieuwe producten aan?
Nee. Mass Product Updater werkt alleen producten bij die al bestaan. Rijen waarvan de identificatiecode bij geen enkel product past, worden overgeslagen of gemeld, nooit aangemaakt.
Welke bestandsformaten worden ondersteund?
CSV (en tab- of tekstbestanden .txt) wordt volledig ondersteund. Excel .xlsx wordt naar best vermogen gelezen als de PHP-extensies ZIP en SimpleXML beschikbaar zijn. Bestanden tot 20 MB worden geaccepteerd.
Hoe werkt het koppelen van producten?
U kiest een koppelsleutel, Product ID, Reference, EAN13, UPC of Supplier reference, en wijst er een kolom aan toe. Elke rij wordt aan de hand van die code aan een product gekoppeld voordat een veld wordt bijgewerkt.
Is de rollback veilig?
Ja, zolang Keep pre-update snapshot is ingeschakeld (de standaardinstelling). De module bewaart de vorige waarde van elk gewijzigd veld, zodat een toegepaste run ze exact kan herstellen. Een run kan maar één keer ongedaan worden gemaakt.