Koppelingen voor agri en tuinbouw: toelatingen, plantenpaspoort en productcodes in je webshop

Herkenbaar?

Een toeleverancier aan boeren, tuinders en hoveniers loopt in de webshop tegen dingen aan die een gewone groothandel niet kent.

• Middelen met een toelating. Een gewasbeschermingsmiddel of biocide heeft een toelating van het Ctgb nodig. Die toelating heeft een einddatum en een gebruikersgroep: professioneel, niet-professioneel of beide.
• Planten met een plantenpaspoort. Bij verkoop via internet moet het paspoort mee tot bij de eindgebruiker, met een traceerbaarheidscode per partij.
• Codes van de sector. Bloemen en planten hebben een productcode van Floricode, met kenmerkcodes voor kleur, sortering en fust. Die lijst verandert elke week.
• Emballage en partijen. Fust en emballage met een eigen code, en partijen met een eigen nummer die terug te vinden moeten zijn.

Hieronder per gegeven waar het vandaan komt en hoe het in de webshop komt.

Wat agri- en tuinbouwtoeleveranciers het vaakst koppelen

Toelatingen van het Ctgb

Het Ctgb publiceert alle toelatingen in een openbare API in JSON:API-formaat, dezelfde bron waarop de toelatingendatabank draait. Op 3 oktober 2026 gaf de API 1.104 geldige toelatingen voor gewasbeschermingsmiddelen; met het filter NonProfessional waren dat er 202. Per toelating staan onder meer het toelatingsnummer, de einddatum, de gebruikersgroep en de etiketgegevens: gevarensymbolen, signaalwoord en H- en P-zinnen. Een fragment met eigen waarden, in de veldnamen van de API:

{
  "name": "VOORBEELD 250 SC",
  "authorisation": {
    "registrationNumber": { "nl": "16012" },
    "expirationDate": "2028-11-29T23:00:00Z",
    "actual": [ { "userType": { "type": "Professional" } } ]
  },
  "lastModifiedDate": "2026-09-30T22:00:00Z"
}

Een rekenvoorbeeld. De API geeft standaard 50 toelatingen per pagina. Een volledige ronde over de 1.104 geldige middelen is 1.104 / 50 = 22,08, dus 23 verzoeken. Daarna vraagt de koppeling elke dag alleen de middelen op met een lastModifiedDate sinds de vorige ronde. Het artikel in je ERP hoeft alleen het toelatingsnummer te dragen; de rest komt van het Ctgb en is daarmee altijd gelijk aan de toelating.

Als een toelating wijzigt of eindigt, stelt het Ctgb een aflevertermijn vast: de periode waarin de toelatinghouder het oude middel nog mag verkopen. Hoe lang die is, hangt af van het risico. De koppeling zet een artikel met een verlopen expirationDate daarom op een controlelijst in plaats van het zelf offline te halen.

Plantenpaspoort

De Europese Plantgezondheidsverordening (EU 2016/2031) maakt een plantenpaspoort verplicht voor planten voor opplant, zoals potplanten, stekken, zaden en bloembollen. Bij verkoop via internet moet het paspoort volgens de NVWA aanwezig zijn tot de plant bij de eindgebruiker is. Het paspoort zit op de kleinste handelseenheid en bevat vier vaste regels:

De C-regel is het werk. Een webshoporder voor een plant moet bij picken aan een partij worden gekoppeld, zodat het juiste paspoort op de zending komt. In Exact Online komen partijen uit inventory/BatchNumbers, met een beschikbare hoeveelheid per magazijn. De koppeling zet de partij op de orderregel in het ERP, zodat bij een uitbraak van een ziekte terug te vinden is welke klant welke partij kreeg.

Productcodes uit de sierteelt

Op de veilingen worden volgens Floricode bijna 20.000 bloemen en planten op naam verhandeld, elk met een eigen productcode, voorheen de VBN-code. Er komen gemiddeld 2.000 producten per jaar bij en er verdwijnen er ook. Naast de productcode zijn er kenmerkcodes voor sortering, kleur, kwaliteit en fust. De codes voor fust en andere logistieke middelen beheert Royal FloraHolland; Floricode verspreidt ze. Floricode levert alle codes via een API, per code op aanvraag of als dagelijkse mutaties. Een webshop die planten op naam toont, gebruikt de productcode als sleutel en de kenmerken als filters.

Systemen

Het ERP blijft de bron voor wat je verkoopt, voor hoeveel en uit welke partij. De sectorbronnen leveren wat niet in je ERP thuishoort: of een middel mag worden verkocht, en hoe een plant officieel heet. Het overzicht per ERP staat op ERP koppelen aan je webshop.

Standaarden

GS1 Data Source heeft voor agrarisch en vers een eigen ingang met codelijsten voor emballage, verpakkingstypes en internationale keurmerken, en datakwaliteitsafspraken voor aardappelen, groente en fruit. De sierteelt gebruikt naast GS1 ook Floricode-codes en interne codes; volgens Floricode ervaren bijna alle bedrijven in de keten daar problemen mee. De koppeling legt per artikel vast welke code de sleutel is en houdt de andere als verwijzing bij.

Wat dit voor je koppeling betekent

Wij bouwen de koppeling op jouw ERP en jouw webshop en hangen er de bronnen van de sector aan: de toelating van het Ctgb, de codes van Floricode of GS1, de partij voor het plantenpaspoort. Per gegeven ligt vast welk systeem leidend is. Daarna hosten en bewaken we hem, met een log en een diff per run, zodat je ziet welk middel van status is veranderd voordat een klant het bestelt.

De andere branches staan op branches, het overzicht van alle stromen op koppelingen. Vertel welk ERP je gebruikt en welke productgroepen je online verkoopt.