← Terug naar home

Universele set
aanleveren

Zo levert u uw universele assortiment aan, zodat grossiers het in hun webshop aan garages kunnen aanbieden. Versie 1.0. Vragen via support@grossier.nu. Bent u ERP-leverancier? Dan is het ERP-koppelvlak uw document.

Documenten, versie 1.0

1. Zo werkt het

U levert twee CSV-bestanden aan: categories.csv met de indeling van uw assortiment en articles.csv met uw artikelen. Bij deze handleiding horen twee lege sjablonen met de juiste kopregel en een ingevulde voorbeeldset.

  • Stuur uw eerste versie naar support@grossier.nu. We lopen die samen na voordat hij live gaat.
  • Daarna richten wij de ontvangst in: u krijgt een eigen SFTP-account. Zet de twee bestanden in de hoofdmap, met precies deze namen. Wij lezen ze elke nacht automatisch in.
  • Lever altijd de volledige set aan, geen losse wijzigingen. Wat niet meer in het bestand staat, verdwijnt de volgende ochtend uit de webshop.
  • Prijzen en voorraad horen niet in deze bestanden. Die haalt de grossier uit zijn eigen systeem.

Een wijziging doorvoeren is dus: bestand bijwerken en opnieuw uploaden.

2. Bestandsformaat

  • Opslaan als CSV UTF-8, anders gaan letters met accenten stuk.
  • Kolommen gescheiden door een puntkomma (;).
  • De eerste regel is de kopregel met exact de kolomnamen uit deze handleiding. In categories.csv staan de kolommen in de vaste volgorde hieronder, in articles.csv mag de volgorde vrij zijn.
  • Bevat een tekst een puntkomma, aanhalingsteken of regeleinde? Zet de hele waarde dan tussen dubbele aanhalingstekens. Een aanhalingsteken in de tekst schrijft u dubbel: "15"" velg".
  • Een lege waarde laat u gewoon leeg.

3. categories.csv

De indeling zoals de garage er doorheen klikt. Twee of drie lagen is genoeg. Producten hangen altijd in de onderste laag.

Kolom Verplicht Inhoud
id ja Uniek nummer dat u zelf kiest. Blijft hetzelfde bij elke aanlevering.
name ja Naam zoals de garage hem ziet, maximaal 50 tekens.
position nee Volgorde binnen dezelfde laag: 1, 2, 3.
image_url ja Webadres van een afbeelding voor deze categorie, zonder inloggen te openen.
parent_id nee Leeg bij een hoofdcategorie, anders het id van de categorie erboven.
page_type ja children als er categorieën onder hangen, articles als er producten in komen.
id;name;position;image_url;parent_id;page_type
1;Motorolie;1;https://www.voorbeeld.nl/cat/motorolie.jpg;;children
2;Personenauto;1;https://www.voorbeeld.nl/cat/personenauto.jpg;1;articles
3;Bedrijfswagen;2;https://www.voorbeeld.nl/cat/bedrijfswagen.jpg;1;articles
4;Bevestigingsmateriaal;2;https://www.voorbeeld.nl/cat/bevestiging.jpg;;articles
5;Pechhulp;3;https://www.voorbeeld.nl/cat/pechhulp.jpg;;articles

4. articles.csv

Eén regel per artikel. Elke verpakking of maat is een eigen artikel met een eigen artikelnummer.

Kolom Verplicht Inhoud
article_code ja Uw artikelnummer zoals het op pakbon en factuur staat, maximaal 50 tekens. Hierop koppelen grossiers prijs en voorraad, dus schrijf het exact zoals in uw eigen systeem. Uniek per regel.
name ja Productnaam zoals de garage hem ziet, maximaal 255 tekens. Elk artikel krijgt een eigen naam die het onderscheidt van de andere artikelen.
brand_name ja Merknaam, maximaal 50 tekens, overal op dezelfde manier gespeld.
category_ids ja Het id van de categorie uit categories.csv, alleen categorieën met page_type articles. Meerdere mag, gescheiden door komma's: "2,3".
description nee Uitgebreide omschrijving, zie hieronder.
ean_number nee EAN-13 streepjescode, 13 cijfers.
global_ranking nee Hoe belangrijk het artikel is, hoger komt bovenaan. Leeg of 0 = geen voorkeur.
tecdoc_brand_code nee Uw TecDoc-merknummer, als u dat hebt.
attr_… nee Eigenschappen, zie hieronder.
asset_1 … asset_5 nee Productfoto's, zie hieronder.
family_id, family_attributes nee Varianten van hetzelfde product, zie hieronder.

Omschrijving. Gewone tekst met regeleinden. Een vet kopje maakt u met <b>Toepassing</b>, een opsomming met <ul><li>Eerste punt</li></ul>. Zet na een kopje altijd eerst een regel gewone tekst. Geen andere opmaak.

Eigenschappen. Elke kolom die begint met attr_ wordt een eigenschap op het artikel; u kiest zelf welke en hoeveel. De garage ziet de naam zonder attr_, met spaties voor underscores en een hoofdletter: attr_aantal_polen wordt "Aantal polen". Zet de eenheid tussen blokhaken in de kolomnaam en alleen het getal in de waarde: kolom attr_inhoud[L], waarde 5. Eenheid maximaal 10 tekens, en per eigenschap één eenheid (dus niet attr_inhoud[ML] naast attr_inhoud[L]). Meerdere waarden scheidt u met ---, bijvoorbeeld ACEA C3---API SP.

Foto's. asset_1 is de hoofdfoto, asset_2 tot en met asset_5 zijn extra foto's. Vul een volledig webadres in dat zonder inloggen te openen is, bijvoorbeeld van uw eigen website. Losse fotobestanden kunnen we niet verwerken. Geen foto? Laat de kolom leeg, zet er geen vervangend plaatje in.

Varianten. Hetzelfde product in meerdere verpakkingen of maten toont de webshop als één product met een keuze. Geef die regels dezelfde family_id: maximaal 50 tekens, zonder spaties, op elke regel exact hetzelfde gespeld, ook qua hoofdletters. Zet in family_attributes de naam van de eigenschap waarin ze verschillen, zoals de garage hem ziet (Inhoud). Die eigenschap moet een getal zijn. Een product met maar één uitvoering krijgt geen family_id.

Voorbeelden (een deel van de kolommen). Eén olie in drie verpakkingen: hier hoort de inhoud in de naam.

article_code name attr_inhoud[L] attr_viscositeit family_id family_attributes
10001 Motorolie 5W-30 1 L 1 SAE 5W-30 OLIE5W30 Inhoud
10005 Motorolie 5W-30 5 L 5 SAE 5W-30 OLIE5W30 Inhoud
10020 Motorolie 5W-30 20 L 20 SAE 5W-30 OLIE5W30 Inhoud

Eén bout in drie lengtes, per doos van 500 stuks. Het aantal per verpakking staat in een eigenschap, niet in de naam.

article_code name attr_lengte[MM] attr_per_doos[ST] family_id family_attributes
20816 Zeskantbout M8 x 16 verzinkt 16 500 BOUTM8 Lengte
20820 Zeskantbout M8 x 20 verzinkt 20 500 BOUTM8 Lengte
20830 Zeskantbout M8 x 30 verzinkt 30 500 BOUTM8 Lengte

Een artikel zonder varianten laat family_id leeg:

article_code name attr_kabellengte[M] attr_kleur family_id family_attributes
30100 Sleepkabel met haken 4 Geel

5. Controle vóór u uploadt

  • Beide bestanden opgeslagen als CSV UTF-8 met puntkomma, met de exacte bestandsnamen.
  • Elk artikel heeft article_code, name, brand_name en category_ids.
  • Elk category_ids verwijst naar een bestaande categorie met page_type articles.
  • Geen dubbele id's in categories.csv en geen dubbele article_code's in articles.csv.
  • EAN's staan voluit als 13 cijfers. Excel maakt er vaak 8,71234E+12 van: zet die kolom op Tekst voordat u opslaat.
  • Geen twee artikelen met dezelfde naam.
  • Merknaam en family_id overal exact hetzelfde gespeld.
  • Tekst met een puntkomma of aanhalingsteken staat tussen aanhalingstekens.
  • Per eigenschap één eenheid, alleen getallen in de waarde.
  • Elke categorie heeft een afbeelding, en alle links naar afbeeldingen openen zonder inloggen.

6. Als een bestand niet voldoet

  • Kan een bestand niet worden ingelezen, bijvoorbeeld omdat het ontbreekt, leeg is of een waarde boven de maximale lengte bevat? Dan blijft uw vorige set in de webshop staan.
  • Krimpt de set met meer dan de helft? Dan blijft de vorige set ook staan, en lezen we de nieuwe pas in na overleg met u.
  • Een losse regel met te weinig kolommen of zonder article_code slaan we over; de rest van het bestand wordt wel ingelezen. Een artikel zonder geldige categorie blijft vindbaar via de zoekfunctie, maar staat niet in de indeling.

Wijzigingen per versie

VersieDatumWat is er veranderd
1.03 november 2026Eerste openbare versie. Dezelfde kolommen en regels als de eerder per mail verstuurde handleiding, aangevuld met een voorbeeldset en met wat er gebeurt als een bestand niet voldoet.

Binnen versie 1 komen er hooguit nieuwe optionele kolommen bij. Een nieuwe verplichting of een andere kolomnaam wordt versie 2, met een overgangstermijn.