Artikelimporter (v3)

Bijgewerkt 25 augustus 2026

Artikelen importeren met de Artikel Import (v3) in Smart Trade

Artikelen importeren met de Artikel Import (v3)

Met de Artikel Import (v3) lees je een bestand in om artikelen aan te maken of bij te werken. Je gebruikt hem vooral voor prijslijsten. Dit artikel beschrijft de vijf stappen en alle extra mogelijkheden.

Voor beheerders die artikelbestanden importeren.

Kort gezegd: je doorloopt vijf stappen — bestand kiezen, bestandstype, kolommen koppelen, import-opties en bevestigen — en start daarmee de import.

Voor je begint

Je vindt de importer in de module Artikelbeheer via het menu-item Import V3. Je hebt een goed voorbereid CSV- of Excel-bestand nodig. Hoe je een lijst voorbereidt, staat in het artikel over het klaarmaken van een artikellijst.

Stap 1 – Importbestand

In stap 1 kies je waarmee je verder gaat:

  • Nieuwe import — een nieuw bestand inlezen;
  • Import in bewerking — een eerder gestarte, nog niet verwerkte import oppakken.

Naast het inlezen is er een tabblad Templates. Al verwerkte imports vind je op de aparte pagina Verwerkte imports (via het actiemenu). Met het rode prullenbak-icoon verwijder je een lijst uit deze lijst; dat verwijdert alleen de import zelf, niet de al uitgevoerde verwerking.

Bij een nieuwe import kies je het bestand. Geschikt zijn een CSV- of Excel-bestand. Sla een CSV op als “CSV (gescheiden door lijstscheidingsteken) (*.csv)”. Je kunt hier ook Meer info aanzetten, waarmee je onder de stappen een logboek krijgt met informatie over eventuele fouten.

Een geschikte lijst maken

Een geschikte lijst heeft in de eerste rij de kolomnamen, met daaronder per rij één artikel. Let daarbij op:

  • geen lege regels tussen de artikelen;
  • de waarde in een cel past bij de eigenschap;
  • geen €-teken bij een prijs;
  • een EAN-barcode staat als getal.

Welke velden je kunt gebruiken en wat ze betekenen, staat in de referentietabel bij stap 3.

Handige Excel-tips

Stap 2 – Bestandstype

Hier staan de eigenschappen van het ingelezen bestand. Meestal kun je deze stap direct doorzetten, omdat de instellingen al goed staan. De instellingen zijn:

Instelling Wat het doet
BestandstypeHet type van het ingelezen bestand (CSV of Excel).
Kolomnamen overslaanDe kolomnamen in de eerste regel overslaan bij het inlezen.
Lege regels overslaanLege regels in het bestand overslaan.
Eerste regel van het bestandVanaf welke regel het inlezen begint (hangt samen met Kolomnamen overslaan).
ScheidingstekenHet teken waarop de waarden in een CSV worden gescheiden. Bij een CSV gescheiden door lijstscheidingsteken is dit een ;.
GroeperingstekenGeeft aan wat er bij elkaar in één veld hoort, bijvoorbeeld om een scheidingsteken binnen een waarde te laten staan.
Escape-tekenLaat de speciale functie van een ander teken (zoals het scheidings- of groeperingsteken) negeren.
KaraktersetDe tekenset van de waarden. Pas dit aan bij vreemde tekens. Keuze uit ISO-8859-1, UTF-8, Windows-1252 of ASCII.

Stap 3 – Artikeleigenschappen koppelen

In stap 3 koppel je elke kolom uit je bestand aan een veld van het artikel, zodat de gegevens op de juiste plek terechtkomen. Klik op het pen-icoon naast een kolom om het juiste veld te kiezen.

Waar staat welke eigenschap voor?

Alle artikeleigenschappen staan in de keuzelijst. Onderstaande tabel geeft per eigenschap het datatype en een korte uitleg.

Groep Eigenschap Type Betekenis
IdentificatieIdGeheel getalDe bestelcode of Artikel ID; een uniek getal van het artikel.
IdentificatieEAN-barcodeGeheel getalDe EAN-barcode (Europees Artikelnummer).
FabrikantFabrikant idGeheel getalHet relatienummer van de fabrikant.
FabrikantFabrikantcodeTekstDe fabrikantcode van het artikel, vaak van de leverancier.
FabrikantFabrikantcode2TekstEen extra fabrikantcode als een artikel er twee nodig heeft.
FabrikantEigen artikelcodeTekstEen eigen artikelcode voor het artikel.
HoofdleverancierHoofdleverancierGeheel getalHet relatienummer van de hoofdleverancier.
ArtikelgroepArtikelgroepGetal of omschrijvingZowel de omschrijving als het nummer van de artikelgroep is toegestaan.
BTWBTW-codeGeheel getalDe btw-code uit de stambestanden.
VerpakkingLagen per verpakkingGetalHet aantal lagen per verpakking.
VerpakkingEenheden per verpakkingGetalHet aantal eenheden per verpakking.
EenheidEenheidTekstDe eenheid van het artikel.
EenheidStuks per eenheidGetalHet aantal stuks per eenheid.
EenheidEenheden per m2GetalHet aantal eenheden per vierkante meter (voor omrekeningen).
EenheidM2 per eenheidGetalHet aantal vierkante meter per eenheid (voor omrekeningen).
OmschrijvingOmschrijvingTekstDe omschrijving van het artikel.
OmschrijvingEigen omschrijvingTekstDe eigen omschrijving van het artikel.
OmschrijvingExtra omschrijvingTekstDe extra omschrijving, vaak gebruikt voor de website.
ArtikelprijsInkoopprijsGetalDe inkoopprijs van het artikel.
ArtikelprijsAlgemene kostenGetalEventuele extra kosten bovenop de inkoopprijs.
ArtikelprijsNieuwe inkoopprijsGetalEen nieuwe inkoopprijs die ingaat vanaf een startdatum.
ArtikelprijsStartdatum nieuwe inkoopprijsDatum (YYYY-MM-DD)De datum waarop de nieuwe inkoopprijs ingaat.
ArtikelprijsVerkoopprijs exclusiefGetalDe verkoopprijs exclusief btw.
ArtikelprijsVerkoopprijs inclusiefGetalDe verkoopprijs inclusief btw.
ArtikelprijsAdviesverkoopprijs (incl. btw)GetalDe adviesverkoopprijs inclusief btw.
ArtikelprijsAdviesverkoopprijs 2 (incl. btw)GetalEen extra adviesverkoopprijs inclusief btw.
ArtikelprijsReseller prijsGetalDe verkoopprijs exclusief voor de reseller-prijskolom.
ArtikelprijsMarge 3GetalDe marge voor een derde prijskolom.
ArtikelprijsMarge 4GetalDe marge voor een vierde prijskolom.
ArtikelprijsGeen vaste prijs0/1 (uit/aan)Het artikel gebruikt op een order niet de artikelprijs, maar de eenheidsprijs op de order.
AfnameverplichtingAantal eenheden per verpakkingGetalHet aantal eenheden per verpakking.
AfnameverplichtingMinimum bestelhoeveelheidGetalHet minimale aantal te bestellen eenheden. Leeg = de bestelhoeveelheid geldt als minimum.
AfnameverplichtingAfname1 t/m 6Het type afname: vrije afname, per eenheid, per verpakking, per laag, per (mini)verpakking, of per (mini)verpakking of laag.
AfnameverplichtingVrije afname / Per eenheid / Per verpakking / Per laag / Per (mini)verpakking / Per (mini)verpakking of laag0/1 (uit/aan)Zet de afname op de betreffende vorm.
Toeslagen en statiegeldStatiegeld artikelArtikel-idHet artikel-id van het statiegeldartikel.
Toeslagen en statiegeldStatiegeld drempelaantalGetalHet aantal eenheden voor één statiegeldartikel; een veelvoud betekent meerdere statiegeldartikelen.
Toeslagen en statiegeldToeslagartikelArtikel-idHet artikel-id van het toeslagartikel.
Fysieke eigenschappenLengte / Breedte / Hoogte in cmGetalDe afmetingen van het artikel in centimeters.
Fysieke eigenschappenGewicht per eenheidGetalHet gewicht per opgegeven eenheid.
Fysieke eigenschappenRekenhulp tonen0/1 (uit/aan)Toont de rekenhulp bij het artikel.
ArtikeleigenschappenEnd of life0/1 (uit/aan)Zet het artikel op end of life (uitlopend).
ArtikeleigenschappenVerbergen0/1 (uit/aan)Verbergt het artikel in je administratie.
ArtikeleigenschappenArtikellocatieTekstDe locatie van het artikel.
ArtikeleigenschappenVerbergen in webshop0/1 (uit/aan)Verbergt het artikel in de webshop.
ArtikeleigenschappenVoorkeursartikel0/1 (uit/aan)Maakt het artikel een voorkeursartikel.
ArtikeleigenschappenVoorraad bijhouden0/1 (uit/aan)Houdt voorraad bij voor het artikel.
ArtikeleigenschappenOverig0/1 (uit/aan)Overige eigenschappen om aan of uit te zetten.
MiniverpakkingenAantal eenheden per miniverpakkingGetalHet aantal eenheden in de gekozen miniverpakking.
MiniverpakkingenMiniverpakking typeGetalHet verpakkings-id van de miniverpakking.
Extra veldenDoor de klant gekozen extra veldenWisselendExtra velden die de klant zelf heeft ingericht; het type hangt af van het veld.
Voorraad per magazijn“magazijn”: Minimale voorraadGetalDe minimale voorraad die het artikel in dat magazijn moet hebben.
Voorraad per magazijn“magazijn”: Maximale voorraadGetalDe maximale voorraad die het artikel in dat magazijn mag hebben.

Stap 4 – Import-opties

In stap 4 bepaal je hoe de import zich gedraagt. Links staat een matrix met de gekoppelde eigenschappen; rechts staan de beleidsinstellingen.

De matrix per eigenschap

Kolom Betekenis
ItemeigenschapDe naam van de artikeleigenschap.
BronWaarop de eigenschap is gebaseerd; bij een kolom uit het bestand staat hier de kolomnaam.
MatchenVink aan om op deze eigenschap bestaande artikelen te herkennen. Match bij voorkeur op Artikel ID, of op fabrikantcode met fabrikant-id, of op EAN-barcode; zo voorkom je dubbele artikelen.
BijwerkenWanneer de eigenschap wordt bijgewerkt (zie de bijwerk-opties hieronder).
FoutafhandelingWat er gebeurt bij een fout in deze eigenschap (zie de foutafhandelingsopties hieronder).

Bij Bijwerken kies je per eigenschap wanneer die wordt overgenomen:

Optie Wat het doet
AltijdDe eigenschap wordt altijd bijgewerkt met de waarde uit het bestand.
Altijd (ook leeg)Altijd bijgewerkt, ook als de waarde in het bestand leeg is. Het veld wordt dan dus ook leeggemaakt.
NooitDe eigenschap wordt nooit bijgewerkt.
Alleen nieuwDe eigenschap wordt alleen bij nieuwe artikelen ingevuld.
Alleen bestaandDe eigenschap wordt alleen bij bestaande artikelen bijgewerkt.

Bij Foutafhandeling kies je wat er gebeurt als in deze eigenschap een fout optreedt:

Optie Wat het doet
Import blokkerenDe hele import wordt geblokkeerd zodra hierbij een fout optreedt.
Eigenschap overslaanDeze eigenschap wordt voor het hele bestand overgeslagen als er een fout optreedt; de rest wordt wel verwerkt.
Item niet importerenAlleen het betreffende artikel (de rij met de fout) wordt niet geïmporteerd; de overige rijen wel.

Per regel zijn er drie acties: met het pen-icoon (bewerken) verander je de bron van een eigenschap en geef je een eigen waarde op als de bron leeg is; met het groene plus-icoon voeg je een eigenschap toe die niet in de lijst staat; met het rode prullenbak-icoon verwijder je een zelf toegevoegde eigenschap.

Let op
Kies je geen enkel matchveld, dan waarschuwt Smart Trade: alle artikelen worden dan als nieuw ingelezen en er worden geen bestaande artikelen bijgewerkt.

De beleidsinstellingen

Instelling Wat het doet
Artikelen bijwerkenWelke artikelen worden verwerkt: Zowel bestaande bijwerken als nieuwe aanmaken, Alleen bestaande bijwerken, of Alleen nieuwe aanmaken.
Wat er met de verkoopprijs gebeurtAlleen van toepassing als je geen verkoopprijs importeert. Kies Bestaande verkoopprijs behouden (de marge wordt herberekend) of Bestaande marge (%) behouden (de verkoopprijzen worden herberekend).
Zet fabrikantartikelen op end of lifeZet alle artikelen van de fabrikant die niet in het bestand staan op end of life (EOL).
Afronding toepassenRondt de ingelezen verkoopprijzen af op basis van ingestelde staffels.

Waarschuwing
Gebruik de end-of-life-optie niet als je versie lager is dan 21.94. Daar zat een fout in die vanaf 21.94 is opgelost.

Stap 5 – Bevestigen

De laatste stap toont een samenvatting van wat de import gaat doen, met onder meer het totaal aantal items, het aantal overgeslagen items, het aantal bij te werken bestaande items, het aantal extra items door een beleidsinstelling en het aantal nieuw aan te maken items.

Daaronder staan twee knoppen:

  • Start import — start de hele import;
  • Test import — verwerkt alleen de eerste twee items, zodat je het resultaat kunt controleren.

Daaronder staat het resultaat in matrixen, verdeeld over de tabbladen In te lezen rijen, Overgeslagen rijen (door de instellingen van stap 4, vaak vanwege fouten) en Extra rijen (die door een beleidsinstelling extra worden verwerkt). Een legenda legt de kleuren uit, zoals Ongewijzigd, Nieuwe waarde, Waarde met waarschuwing, Nieuw item, Overgeslagen waarde en Waarde met fout. Ga je met de muis op een cel staan, dan zie je de huidige waarde van die eigenschap.

Goed om te weten
Elk van de drie matrixen kun je exporteren: kies het juiste tabblad en gebruik in het actiemenu Exporteer als .xlsx of Exporteer als .csv.

Een importbestand wijzigen

Bevat een bestand fouten die je hebt verbeterd, dan hoef je niet opnieuw te beginnen. Ga naar het actiemenu en kies Wijzig import bestand, en upload het nieuwe of gewijzigde bestand. Je kiest wat er met de huidige lijst gebeurt: overschrijven of bewaren (dan maak je een nieuwe import met dezelfde instellingen). Je krijgt daarna nog een controlevraag.

Let op
Pas je de kopregel aan of voeg je kolommen toe of verwijder je die, dan kan het bestand de bestaande koppeling (template) niet meer gebruiken en moet je het als nieuw bestand inlezen. Houd je dezelfde opbouw aan, dan kun je op deze manier ook een nieuw ontvangen leveranciersbestand inlezen.

Een import terugdraaien (back-up)

Een ingelezen lijst kun je terugzetten via een back-up:

  1. Ga naar de betreffende import door er bij stap 1 op te klikken.
  2. Kies in het actiemenu Backups.
  3. Kies de juiste import; de nieuwste staan onderaan. Je ziet daaronder wat de wijzigingen waren.
  4. Klik op terugdraaien om de waarden te herstellen naar vóór deze import. Artikelen die door de import nieuw zijn aangemaakt, worden verborgen.

Let op
Verwijder je een import (met het prullenbak-icoon), dan kan de back-up daarna niet meer worden teruggedraaid.

Het logboek

Het logboek houdt de details van de import bij, met name over fouten. Je zet het aan het begin aan met het vinkje Meer info. Ben je al bezig, dan zet je het alsnog aan via het actiemenu met Zet meer info aan.

In het logboek kunnen verschillende meldingen staan. Een paar veelvoorkomende:

  • Geen btw-percentage gevonden; het standaardpercentage wordt gebruikt.
  • Er is geen match gekozen: alle artikelen worden als nieuw ingelezen.
  • Omschrijving of fabrikant is verplicht voor een nieuw artikel.
  • Een artikelgroep kan niet gevonden worden.
  • De eenheid van het te importeren artikel verschilt van het matchende artikel.
  • Een kolomnaam kan niet worden gelezen (controleer de kolom en pas eventueel de karakterset aan).

 

Mist u iets?

Laat het weten, dan vullen we de kennisbank aan.