Naar de inhoud

Referentiedata beheren

Referentie­datasets

Beheer codelijsten, parameters en andere gedeelde referentiedata met eigenaarschap, versiebeheer en beheerste publicatie.

Landcodes, kostenplaatsen, statuswaarden, parameters en bedrijfsinstellingen beginnen vaak in spreadsheets, databases of applicatieconfiguratie.

Naarmate meer systemen ervan afhangen, heeft elke dataset een duidelijke eigenaar nodig, beheerste wijzigingen, gepubliceerde versies en ingangsdatums.

Refrncr helpt teams gedeelde referentiedatasets te beheren met beoordelingsstappen, versiebeheer en beheerste publicatie.

ReferentiedatasetVerzendtarievenVersie 2 · Eigenaar: LogistiekGepubliceerd
ERPWebshopFacturatieRapportage
Eén gepubliceerde dataset, gebruikt door meerdere systemen.

Definitie

Wat is een referentiedataset?

Een referentiedataset bevat gedeelde bedrijfswaarden die in applicaties, rapportages en bedrijfsprocessen worden gebruikt.

Sommige datasets leggen een lijst met geldige waarden vast. Andere leggen parameters, instellingen of bedrijfsregels vast.

Voorbeelden zijn bezorgmethoden, foutcodes, productcategorieën, kostenplaatsen, bedrijfsinstellingen, risicocategorieën, ML-modelparameters, goedkeuringsdrempels en bewaartermijnen.

Foutcodes

AUTH_401SYNC_503API_TIMEOUT

Bezorg­methoden

EMAILPORTALLETTER

Risico­categorieën

LOWMEDIUMHIGH

ML-model­parameters

temperature 0.7max_tokens 1500top_p 0.9

Goedkeurings­drempels

purchase 5000expense 500refund 1000

Bewaar­termijnen

invoices 7ycontracts 10yaudit_logs 90d

Waar het misgaat

Waarom datasets lastig te beheren worden

Een dataset is eenvoudig bij te houden zolang er één eigenaar en één afnemer is.

De uitdaging begint als meerdere systemen op dezelfde waarden vertrouwen.

  • Meerdere kopieën
  • Verschillende definities
  • Onbekend eigenaarschap
  • Geen versiegeschiedenis
  • Verschillende antwoorden per systeem

Veel kopieën

verzendtarieven_2026.xlsxSHIPPING_LOOKUPshipping_config.jsonTarieven (Blad2)
VerzendtarievenVersie 2Eigenaar: LogistiekIngangsdatum: 2026-01-01Gepubliceerd
Veel kopieën → één publicatie

Twee veelvoorkomende patronen

Codelijsten en parameterdatasets

Sommige referentiedatasets leggen een beheerde lijst met waarden vast.

Andere leggen parameters, drempels en instellingen vast waar systemen op vertrouwen.

Beide patronen gebruiken hetzelfde proces voor eigenaarschap, beoordeling, versiebeheer en publicatie.

CodelijstBezorgmethodenEMAILPORTALLETTER
ParameterdatasetBedrijfsinstellingenVAT_RATE21RETENTION_DAYS365MAX_DISCOUNT10

Eigenaarschap

Behandel datasets als beheerde producten

Elke gedeelde dataset heeft een vaste sleutel nodig, duidelijk eigenaarschap, een afgesproken beoordelingsproces en bekende afnemers.

Gepubliceerde versies blijven ongewijzigd terwijl redacteuren de volgende release in een draft voorbereiden.

Zo wordt de dataset een betrouwbaar product in plaats van een bijproduct van één applicatie.

DatasetVerzendtarieven
EigenaarLogistiek
StatusGepubliceerd
Versie2
Ingangsdatum2026-01-01
Beoordeeld doorDatamanagement
CodeBestemmingTarief
NLNederland4,95
BEBelgië6,95
DEDuitsland7,95

Beheerste wijziging

Beheer wijzigingen met een beheerst proces

Wijzigingen worden los van de huidige publicatie voorbereid, door de verantwoordelijke mensen beoordeeld en als onveranderlijke versie vrijgegeven.

VoorbereidenDraft
→
GoedkeurenBeoordelen
→
VersiePublicerenVersie 3Geldig vanaf 2026-06-01
→
APIAfnemen

Ingangsdatums

Publiceer versies met een ingangsdatum

Wijzigingen hoeven niet direct in te gaan.

Je kunt een versie voorbereiden, beoordelen en publiceren vóór de ingangsdatum.

Afnemers blijven de huidige publicatie gebruiken tot de nieuwe versie geldt.

1Draft10 mei
2Gepubliceerd20 mei
3Geldig1 jun
4AfgenomenVanaf 1 jun

Versies en audit

Weet wat er veranderde en wanneer

Elke gepubliceerde versie blijft beschikbaar.

Publicatiestatus, ingangsdatum, beoordelaar en wijzigingsomschrijving blijven bij elkaar, zodat teams kunnen uitleggen welke waarden zijn gebruikt.

V1GepubliceerdBeoordeeld door DatamanagementEerste tarieven voor Nederland
V2GepubliceerdBeoordeeld door DatamanagementBelgië en Duitsland toegevoegd
V3GepubliceerdBeoordeeld door DatamanagementNieuwe tarieven vanaf 1 juni

Productdomeinen

Referentiedatasets, mappings en hiërarchieën

Referentiedatasets bevatten waarden. Mappings vertalen waarden tussen systemen. Hiërarchieën leggen ouder-kindrelaties vast.

Referentiedataset

CodeNaam
AUTH_401Authenticatie mislukt
SYNC_503Synchronisatiefout

Mappingdataset

BronDoel
CC-4200TERR-EMEA
CC-4300TERR-BENELUX

Hiërarchiedataset

  • Europa
    • Benelux
      • Nederland
      • België
    • DACH

Voorbeelden

Veelvoorkomende referentiedatasets

Kostenplaatsen

Gedeelde financiële referentiedata.

Foutcodes

Gedeelde classificaties voor applicaties en koppelingen.

Statuswaarden

Gedeelde workflow- en applicatiestatussen.

ML-modelparameters

Instellingen voor AI en machine learning, met versiebeheer.

Bedrijfsinstellingen

Configuratiewaarden die voor de hele applicatie gelden.

Bewaartermijnen

Parameters voor compliance.

Waarom refrncr

Waarom teams refrncr gebruiken voor referentiedatasets

  • Eén bron voor gedeelde referentiedata
  • Eigenaarschap
  • Beoordelingsstappen
  • Versiegeschiedenis
  • Ingangsdatums
  • Audittrail
  • Toegang via API
  • Self-hosted

Begin met echte data

Begin met één gedeelde dataset

Kies een dataset die al door meerdere systemen wordt gebruikt, zoals landcodes, verzendtarieven of bedrijfsinstellingen.

Vervang de bestaande kopieën door één gepubliceerde dataset en maak die beschikbaar via de API.