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.
attr_-kolommen voegt u zelf toe.
Voorbeeld categories.csv
De indeling uit de voorbeelden hieronder.
Voorbeeld articles.csv
Alle kolommen ingevuld: olie en bouten als varianten, plus een los artikel.
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.
Een wijziging doorvoeren is dus: bestand bijwerken en opnieuw uploaden.
;).categories.csv staan de kolommen in de vaste volgorde hieronder, in articles.csv mag de volgorde vrij zijn."15"" velg".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
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 |
article_code, name, brand_name en category_ids.category_ids verwijst naar een bestaande categorie met page_type articles.id's in categories.csv en geen dubbele article_code's in articles.csv.family_id overal exact hetzelfde gespeld.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.| Versie | Datum | Wat is er veranderd |
|---|---|---|
| 1.0 | 3 november 2026 | Eerste 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.