Leveranciersimport & Dropshipping voor PrestaShop 1.7.8, 8 en 9
Een leveranciersfeed koppelen, de velden toewijzen, verkoopprijzen berekenen, imports plannen en elke import controleren.
Overzicht
De module Leveranciersimport & Dropshipping (technische naam dfsupplierfeed) importeert en synchroniseert de catalogi van uw leveranciers in PrestaShop. Hij leest CSV-, XML- en JSON-feeds vanaf een webadres, een FTP- of SFTP-server, een bestand dat u vanaf uw computer uploadt of een bestand dat al op de server staat, en maakt vervolgens producten, combinaties, prijzen, voorraden, afbeeldingen, categorieën en merken aan en werkt ze bij.
Versie 2.0.0 voegt een assistent in 5 stappen toe, een veldkoppeling met slepen en neerzetten, leesbare prijsregels met simulator, een planning per feed achter één enkele cron-URL, een simulatie die niets wegschrijft, een gedetailleerd rapport per import waarmee de laatste import ongedaan kan worden gemaakt, en een interface die in 8 talen is vertaald.
De module vervangt de native CSV-import van PrestaShop niet; die is bedoeld voor een eenmalige handmatige import. Deze module automatiseert terugkerende imports van meerdere leveranciers.

Installatie en update
- Open in de back office Modules > Modulebeheer en daarna Een module uploaden.
- Selecteer het bestand
dfsupplierfeed-2.0.0.zip. - De module verschijnt daarna onder Catalogus > Leveranciersfeeds.
Om van een versie 1.x naar 2.0.0 over te stappen, uploadt u gewoon de nieuwe zip: de update behoudt uw leveranciers, feeds, regels en productkoppelingen. De update is getest vanaf de versies 1.0.0, 1.2.0 en 1.4.0. Feeds die in 1.x zijn aangemaakt, behouden hun 1.x-gedrag (zie Wijzigingen ten opzichte van 1.x).
Maak vóór een update op een productiewinkel een back-up van de database, zoals bij elke module die in de catalogus schrijft.
Overzicht van de interface
- Dashboard: actieve feeds, gekoppelde producten, aangemaakte en bijgewerkte producten en fouten over 24 uur en over 14 dagen, feeds die uw aandacht vragen, laatste cron-aanroep.
- Feeds: lijst van feeds met de bron (inloggegevens verborgen), de laatste import, de planning en de knoppen Simuleren, Nu importeren en Alleen voorraad. Leveranciers en hun prioriteit worden onderaan deze pagina beheerd.
- Prijsregels: berekening van de verkoopprijzen, met de prijssimulator.
- Planning: de enige cron-URL en de volgende uitvoeringen van elke feed.
- Rapporten: één rapport per import of simulatie, plus het technische logboek.
- Gekoppelde producten: producten die aan een feed zijn gekoppeld, herkomst, handmatig gewijzigde prijzen, vergrendelde velden.
- Instellingen: standaardwaarden, grote feeds, beveiliging en limieten, onderhoud.

Een feed aanmaken met de assistent
Klik op Een feed toevoegen. Elke stap wordt afzonderlijk opgeslagen: u kunt later naar elke stap terugkeren, en een feed waarvan de configuratie niet is voltooid, blijft inactief.
Stap 1: Bron
Geef de feed een naam, kies of maak de Leverancier aan (u kunt hem ook als PrestaShop-leverancier aanmaken, zodat de inkoopprijs bij elk product wordt opgeslagen) en kies daarna het Brontype:
- Een link van de leverancier: een http- of https-adres.
- Een bestand op een FTP-server:
ftp://(gewone FTP),ftpes://(expliciete TLS, poort 21, aanbevolen) offtps://(impliciete TLS, poort 990). - Bestand via SSH: SFTP met gebruikersnaam en wachtwoord.
- Upload: een bestand van uw computer.
- Serverbestand: een bestand dat al in de winkelmap staat. Alleen feedbestanden (
.csv .tsv .txt .xml .json .gz .zip) buiten de configuratiemappen kunnen worden gelezen.
Gebruikersnamen en wachtwoorden worden versleuteld opgeslagen met de sleutel van de winkel en nooit meer weergegeven. Gzip- en zip-archieven worden automatisch uitgepakt. Sla op en klik daarna op De verbinding testen: de test gebruikt de opgeslagen instellingen.

Stap 2: Formaat en voorbeeld
Klik op Automatisch detecteren: de module leest de eerste items en detecteert het formaat (CSV, XML of JSON), de codering, het scheidingsteken en, voor XML en JSON, het Itempad (de herhaalde node die één product voorstelt). Er verschijnt een voorbeeld van de eerste regels. U kunt elke waarde handmatig corrigeren.
- Coderingen die naar UTF-8 worden omgezet: UTF-8 met of zonder BOM, UTF-16 met BOM, ISO-8859-1, ISO-8859-15 en Windows-1252.
- CSV: puntkomma, komma, tab en pipe als scheidingsteken; meerregelige velden tussen aanhalingstekens; optie om ontbrekende kolommen aan het einde van een regel toe te staan.
- XML: namespaces worden gelezen (
g:gtin), attributen worden gelezen met@naam. Elk document met een DTD wordt vóór de analyse geweigerd. - JSON: puntnotatie (
data.products), array-index (images.0).

Stap 3: Koppeling
De linkerkolom toont de Feedvelden met een voorbeeldwaarde. Sleep ze naar de PrestaShop-velden, of klik op een feedveld en daarna op het doelveld (ook met het toetsenbord te bedienen). Suggesties toepassen vult de koppeling in op basis van de kolomnamen, met een betrouwbaarheidsindicatie voor elk voorstel. Vertaalde kolommen worden herkend: nom_en of title_de worden name:en of name:de.
Alleen een koppelsleutel is verplicht: reference of ean13. Voor bijzondere gevallen geeft Geavanceerd: de veldkoppeling als JSON bewerken toegang tot de ruwe koppeling (zie Overzicht van de velden).
Controleer of het veld dat aan cost is gekoppeld echt een inkoopprijs is. Veel leveranciers leveren ook een adviesverkoopprijs: koppel die aan retail_price, anders wordt uw marge toegepast op een prijs waar al een marge in zit.

Stap 4: Catalogus en prijzen
- Nieuwe producten: producten die nog niet in uw catalogus staan wel of niet aanmaken, en ze direct online zetten of uitgeschakeld aanmaken ter controle (standaard).
- Hoofdcategorie en Ontbrekende categorieën aanmaken: paden zoals
Huis > Kantoor > Stoelenworden onder deze categorie opgezocht; het scheidingsteken is instelbaar. Categorieën en merken kunnen uitgeschakeld worden aangemaakt. - Prijzen en belastingen: inkoopprijs inclusief of exclusief btw, btw-tarief van de feed, valuta van de feed (omgerekend naar de standaardvaluta van de winkel). De verkoopprijzen komen uit de prijsregels.
- Producten herkennen: De producten in mijn catalogus koppelen met dezelfde sleutel (referentie of EAN). Deze optie staat standaard uit voor een nieuwe feed: zonder deze optie raakt de module geen enkel product aan dat hij niet zelf heeft aangemaakt. Er kan een voorvoegsel worden toegevoegd aan de aangemaakte referenties.
- Wat de feed bij bestaande producten mag wijzigen, met Bewaar wat ik handmatig wijzig: een prijs, naam of beschrijving die sinds de laatste import handmatig is gewijzigd, wordt niet meer overschreven.
- Afbeeldingen bij bijwerken: alleen de nieuwe toevoegen, of ook de afbeeldingen verwijderen die de feed niet meer vermeldt. Alleen afbeeldingen die door de module zijn geïmporteerd worden verwijderd, nooit uw eigen afbeeldingen.
- Voorraad: hoeveelheid uit de feed, of hoeveelheid uit de feed min de door bestellingen gereserveerde hoeveelheden.
- Producten die niet meer in de feed staan: ongemoeid laten, hun voorraad op 0 zetten, ze uitschakelen, beide, of de door de feed aangemaakte producten verwijderen (de andere worden uitgeschakeld). Een veiligheidsdrempel (standaard 30%) blokkeert de actie als een te groot deel van de producten van de feed in één keer verdwijnt.
- Categoriekoppeling: De categorieën van de feed lezen en daarna elke categorie van de leverancier naar een van uw eigen categorieën sturen.
- Combinaties en gerelateerde producten: zie verderop.
- Winkels: in multishop worden producten, prijzen en voorraad naar de aangevinkte winkels geschreven.

Stap 5: Planning en simulatie
Kies de frequentie van de Volledige import (aanmaken, bijwerken, ontbrekende producten) en van de Voorraad- en prijssynchronisatie (alleen gekoppelde producten): alleen handmatig, elke N minuten, elke N uur, elke dag of elke week. Stel het Rapport per e-mail in: alleen wanneer er iets misging, na elke import, of nooit.
Klik vervolgens op Een simulatie uitvoeren: de hele feed wordt gelezen en elke beslissing wordt genomen zoals bij een echte import, maar er wordt niets naar de catalogus geschreven. Het simulatierapport toont wat zou worden aangemaakt, bijgewerkt, behouden of als ontbrekend behandeld. Als het naar wens is, klikt u op Afronden en de feed inschakelen.

Overzicht van de velden
Velden die beschikbaar zijn in de koppeling:
reference ean13 upc isbn mpn name description description_short meta_title meta_description cost retail_price minimum_price tax_rate quantity low_stock_threshold category manufacturer condition weight width height depth image images group_reference attributes variant_attribute variants_stock variants_ean variants_reference related
Elk tekstveld bestaat ook per taal: name:en, description:de… Een veld kan een lijst met bronnen krijgen: voor images worden alle gevulde kolommen geïmporteerd; voor de andere velden wordt de eerste niet-lege waarde gebruikt.
{ "fields": { "reference": "sku", "ean13": "ean", "name": "title", "name:en": "title_en", "cost": "price", "quantity": "stock", "images": ["image_1", "image_2"] } }
{ "items_path": "products/product", "fields": { "reference": "@sku", "ean13": "g:gtin", "cost": "pricing/wholesale" } }
{ "items_path": "data.products", "fields": { "cost": "prices.cost", "images": "media" } }
Combinaties en gerelateerde producten
Eén regel per variant
Vink Combinaties opbouwen aan en koppel group_reference (identiek voor alle varianten van een product) en attributes (bijvoorbeeld Maat:M|Kleur:Rood).
Maten gebundeld in één kolom
Voor een feed die één regel per product levert met de maten in één kolom (S:4,M:9), vinkt u Gebundelde varianten splitsen aan en koppelt u variants_stock, plus variants_ean en variants_reference als de feed die levert. De attribuutgroep, het itemscheidingsteken en het waardescheidingsteken worden op de feed ingesteld.
Vink deze optie vóór de eerste import aan. Anders worden de producten zonder bovenliggende referentie aangemaakt en daarna opnieuw aangemaakt wanneer u de optie inschakelt.
Tweede as en gerelateerde producten
variant_attribute voegt een tweede as toe (kleur, materiaal…) onder de groep die op de feed is gekozen. related ontvangt een kommagescheiden lijst van leveranciersreferenties: met De gerelateerde referenties als accessoires koppelen worden dat PrestaShop-accessoires, die worden opgelost zodra de feed volledig is gelezen. Bestaande accessoires worden nooit verwijderd.
Prijsregels en simulator
De verkoopprijs wordt berekend op basis van de inkoopprijs. Een regel leest als een zin, in drie delen:
- Wanneer: leverancier, categorie (en onderliggende categorieën), kostenbereik („vanaf” en „tot”, uitgesloten).
- Verkoopprijs: opslag (kosten + X%), coëfficiënt (kosten × X), margepercentage (X% van de verkoopprijs), vast bedrag (kosten + X), of aanbevolen prijs van de feed − X%; met een toegevoegd vast bedrag, een minimummarge en een minimumprijs exclusief btw.
- Afwerking: psychologische afronding (.99, .95, .90, .49/.99, geheel getal, eindigend op 9), toegepast op de prijs inclusief btw die uw klanten zien of op de prijs exclusief btw.
Wanneer meerdere regels van toepassing zijn, wint de hoogste Prioriteit. Zonder regel geldt de standaardmarge uit de instellingen (30%). De Prijssimulator toont de gekozen regel en elke stap van de berekening tot aan de afgeronde prijs.

Planning en cron
Eén enkele cron-URL bedient alle feeds. Laat uw hostingprovider deze elke 5 tot 15 minuten aanroepen: bij elke aanroep start de module wat volgens de planning van elke feed aan de beurt is. De volledige URL, met het token, wordt weergegeven in Planning.
*/10 * * * * curl -s "https://uwwinkel.tld/index.php?fc=module&module=dfsupplierfeed&controller=cron&token=UW_TOKEN&mode=auto" > /dev/null
Een cron-aanroep overlapt nooit met de vorige en een feed wordt nooit twee keer tegelijk geïmporteerd. De URL’s van versie 1 (mode=stock, mode=full, &id_feed=N, &budget=600) worden nog ondersteund.
Houd deze URL privé. Als u in de Instellingen een nieuw token genereert, werk dan uw cronjob bij.

Rapporten, simulatie en ongedaan maken
Elke import en elke simulatie levert een rapport op: gelezen, aangemaakte, bijgewerkte, ongewijzigde, overgeslagen en in de feed ontbrekende items, en fouten. Het detail toont elk product met zijn waarden Voor en Na, filters per actie en een zoekfunctie. Downloaden (CSV) exporteert het rapport; cellen die een spreadsheetprogramma als formules zou kunnen lezen, worden onschadelijk gemaakt.
Deze import ongedaan maken herstelt de waarden die door de laatste import van een feed zijn gewijzigd, alleen waar niemand ze sindsdien heeft aangepast, en verwijdert de producten en combinaties die deze import heeft aangemaakt. Afbeeldingen worden niet hersteld, en aangemaakte categorieën en merken blijven behouden omdat andere producten ze kunnen gebruiken.

Gekoppelde producten en vergrendelde velden
Het tabblad Gekoppelde producten toont de producten die aan elke feed zijn gekoppeld: leveranciersreferentie, prijs, voorraad, datum waarop het product voor het laatst in de feed stond, herkomst (aangemaakt door de feed of bestaand product). Een prijs die sinds de laatste import handmatig is gewijzigd, wordt gemarkeerd. Vergrendel een veld om uw eigen waarde te behouden: de feed wijzigt het bij dit product niet meer. De knop De miniaturen van deze feed opnieuw genereren maakt de miniaturen opnieuw aan in alle geconfigureerde afbeeldingsformaten.

Leveranciers en EAN-prioriteit
Leveranciers worden aangemaakt via de assistent en onderaan de pagina Feeds beheerd. Wanneer twee leveranciers dezelfde EAN leveren, behoudt de leverancier met de beste prioriteit (1 = hoogste) het product; de andere bronnen worden voor die EAN overgeslagen.
Instellingen, beveiliging en limieten
- Catalogus: standaardmarge (30%), producten die door nieuwe feeds worden aangemaakt direct online zetten, een product uitschakelen wanneer de voorraad van zijn feed 0 bereikt (en weer inschakelen wanneer de voorraad terugkomt), een voorraadbeweging registreren bij elke hoeveelheidswijziging, maximaal aantal afbeeldingen per product (10).
- Grote feeds: tijdbudget per run (120 s), controlepunt elke N items (2.000), bewaartermijn van rapporten (30 dagen).
- Beveiliging en limieten: maximale feedgrootte (200 MB, gemeten na uitpakken), downloadtime-out (300 s), maximale afbeeldingsgrootte (10 MB) en maximale afbeeldingsresolutie (25 megapixels), vertrouwde hosts, nieuw cron-token.
- Server: status van cURL, SFTP-ondersteuning en de privécache.
- Onderhoud: de cache en de onderbroken imports wissen, de rapporten en logboeken verwijderen.
Interne adressen (loopback, privénetwerken, metadata-adressen van cloudhosts en hun IPv6-equivalenten) worden geweigerd voor feeds en afbeeldingen, tenzij u ze opgeeft in Vertrouwde hosts. Omleidingen worden één voor één gevolgd en opnieuw gecontroleerd. De downloadcache staat in var/modules/dfsupplierfeed/, buiten bereik van het web.
Alle acties in de back office respecteren de rechten van de medewerker op het tabblad (bekijken, toevoegen, bewerken, verwijderen).

Grote catalogi
Feeds worden streaming gelezen en de verwerking wordt in runs opgedeeld: elke run stopt na het tijdbudget en de volgende cron-aanroep hervat op exact hetzelfde item. Metingen in onze testomgeving (PrestaShop 9.1.5 in een Docker-container, CSV-feed van 50.000 regels zonder afbeeldingen), ter indicatie: ze hangen af van uw server, uw catalogus en uw feed.
- Aanmaken van 50.000 producten: 2.351 s in 20 cron-runs, 44 tot 51 MB geheugen per run, 0 fouten.
- Opnieuw importeren van dezelfde feed zonder wijzigingen: 165 s.
- Volledige simulatie: 140 s, niets weggeschreven.
- Proces abrupt gestopt tijdens een import: hervat bij het item waar het was gestopt, zonder duplicaten.
Voer eerst een simulatie uit en daarna een eerste volledige import op een testwinkel als u die hebt. Afbeeldingen maken imports aanzienlijk langer.
Wijzigingen ten opzichte van 1.x
Feeds die in 1.x zijn aangemaakt, behouden hun gedrag: ze blijven catalogusproducten met dezelfde EAN koppelen, en hun prijsregels blijven de prijs exclusief btw afronden. De enige wijzigingen die ook voor deze feeds gelden:
- de actie op producten die niet meer in de feed staan, wordt geannuleerd als de import niets heeft gelezen, als het document misvormd of afgekapt is, of als meer dan de veiligheidsdrempel (30%) zou worden geraakt;
- een 1.x-import die op het moment van de update onderbroken was, begint opnieuw vanaf het begin, omdat de cache van locatie is veranderd;
- er wordt altijd naar boven afgerond (1.x kon 31,995 afronden naar 31,99).
Problemen oplossen
Foutmeldingen geven de oorzaak en de te volgen stappen aan, in de taal van de medewerker. De meest voorkomende gevallen:
“Adres … is intern …: geblokkeerd ter bescherming van uw server”
De feed verwijst naar een adres in het lokale netwerk. Als dat de bedoeling is (interne server van uw leverancier of van uw ERP), voeg de host dan toe in Instellingen > Vertrouwde hosts.
“Bestand niet gevonden op de bron (404)”
Controleer het adres of het pad van het bestand en klik daarna op De verbinding testen.
“De feed is groter dan de limiet van … MB”
Verhoog Maximale feedgrootte in de Instellingen. De limiet wordt gemeten na uitpakken.
De producten worden aangemaakt maar zijn niet zichtbaar in de winkel
Dat is de standaardinstelling: aangemaakte producten worden ter controle uitgeschakeld. Schakel ze in via de catalogus, of vink in stap 4 aan dat ze direct online worden gezet.
Mijn bestaande producten worden niet bijgewerkt
Vink voor een nieuwe feed in stap 4 De producten in mijn catalogus koppelen met dezelfde sleutel aan.
“Veiligheidsdrempel bereikt: producten die in de feed ontbreken zijn ongemoeid gelaten”
De veiligheidsdrempel heeft de actie geblokkeerd. Het rapport vermeldt dit; controleer de feed en verhoog daarna de drempel als het verdwijnen normaal is.
Geplande imports starten niet
Het dashboard toont de laatste cron-aanroep. Is er geen, stel dan bij uw hostingprovider de cronjob in met de URL van de pagina Planning.
Een CSV-regel wordt geweigerd
Het aantal kolommen komt niet overeen met de kopregel, meestal door een niet-ontsnapt scheidingsteken in een tekst. De regel wordt geweigerd om te voorkomen dat verschoven waarden worden geïmporteerd.

Compatibiliteit en bekende beperkingen
- PrestaShop 1.7.8 tot 9.x, PHP 7.4 tot 8.5. Getest op PrestaShop 1.7.8.11, 8.2.1 en 9.1.5, met PHP 7.4, 8.1 en 8.5.
- Zonder override van de PrestaShop-core. Multishop wordt ondersteund.
- Interface en meldingen in het Frans, Engels, Spaans, Duits, Italiaans, Pools, Nederlands en Portugees.
- SFTP: alleen authenticatie met wachtwoord (geen sleutel). FTP met impliciete TLS (
ftps://, poort 990) is niet getest. - Ongedaan maken: beperkt tot de laatste import van een feed, zonder herstel van afbeeldingen.