PUBLIC BETA · 0.1.0rc2 Source-available · ELv2 · Zelf hosten

Beheer referentiedata vanuit één bron

Landcodes, kostenplaatsen, parameters, mappings tussen applicaties, regio- en organisatie-indelingen en tarieven. Beheer ze op één plek, met vaste datatypen, beoordeling vóór publicatie, versiebeheer en een API die historische gegevens ondersteunt. Speciaal voor referentiedata, zonder de omvang van een volledig MDM-platform.

Publiek beschikbaar voor pilotgebruikers en testers. Nog niet aanbevolen voor productiegebruik.

$ pipx install --pre refrncr
$ refrncr start
→ refrncr running on http://localhost:8000 (SQLite)

De optie --pre is verplicht tijdens de publieke bèta. Upgradecompatibiliteit met de stabiele versie 0.1.0 wordt niet gegarandeerd.

# Beheerde refrncr-omgeving, ingericht per tenant
$ curl https://api.refrncr.com/api/v1/datasets/countries/records \
    -H "Authorization: Bearer $REFRNCR_KEY"

Wat valt onder referentiedata

  • Kostenplaatsen
  • Landcodes
  • Valuta
  • Foutcodes
  • Productcategorieën
  • Verzendtarieven
  • Chemische elementen
  • Parameters
  • Grootboekrekeningen

Waar het misgaat

Spreadsheets werken, totdat meerdere teams dezelfde data gebruiken.

Een spreadsheet is handig om mee te beginnen. Maar zodra meerdere teams dezelfde referentiedata gebruiken, ontbreekt een betrouwbare bron. Bestanden zoals country_codes_v3_final_FINAL.xlsx hebben geen afgedwongen schema, validatie of versiehistorie. Daardoor is achteraf moeilijk vast te stellen welke gegevens bij een eerdere rapportage zijn gebruikt.

Vandaag

  • country_codes_v3_FINAL.xlsx SharePoint
  • countries_2026.csv Laptop van een collega
  • dim_country datawarehouse, handmatig bewerkt
  • COUNTRY_LOOKUP = {…} 4 repositories
  • Landen (Blad2) het financiële model

Geen eigenaar · geen versie · geen historie

Omslagpunt

refrncr

Dataset
countries
Unieke sleutel
iso_code_3
Eigenaar
Datamanagement
Versie
Gepubliceerd v12
Geldig vanaf
2026-01-01 →

Beoordeeld, voorzien van versies, controleerbaar

Elke afnemer

$ curl \
    -H "Authorization: Bearer $REFRNCR_KEY" \
    "$REF/api/v1/datasets/countries/records"
{
  "data": [
    { "identifier": "…",
      "values": {
        "iso_code_3": "ABW", … } },
    …
  ],
  "pagination": { "total": 250, … },
  "version": {
    "number": 12,
    "effective_from": "2026-01-01"
  }
}

Eén bron, overal hetzelfde antwoord

Drie vormen van referentiedata

Referentiedata is meer dan een codetabel.

Sommige referentiedata bestaat uit lijsten. Andere gegevens leggen relaties tussen systemen vast of vormen de basis voor rapportagestructuren. Refrncr ondersteunt alle drie binnen hetzelfde beheer-, versie- en publicatieproces.

Datasets

Beheerde lijsten met vaste datatypen, stabiele sleutels, validatieregels en gepubliceerde versies die ongewijzigd blijven.

Voorbeelden · verzendtarieven · landen · kostenplaatsen

Bekijk referentiedatasets

Mappings

Vertaaltabellen die codes tussen systemen relateren en ontbrekende of ongeldige koppelingen direct zichtbaar maken.

Voorbeeld · SAP-kostenplaats → Salesforce-regio

Bekijk mappingdatasets

Hiërarchieën

Hiërarchieën die het mogelijk maken te aggregeren op een dataset of inzicht verstrekken, met ouder-kindrelaties en geldigheidsdatums.

Voorbeelden · organisatiestructuur · regio-indeling

Bekijk hiërarchiedatasets

Meer over referentiedata beheren

Het product

Van concept tot publicatie.

Vijf functies helpen teams om referentiedata vast te leggen, te beoordelen en beschikbaar te stellen. Van de eerste import tot een goedgekeurde publicatie: elke stap heeft een duidelijk doel. Zo blijft het overzichtelijk voor de beheerders én voor de teams die de gegevens gebruiken.

Leg de structuur van je dataset vast

  • Maak een eigen schema met datatypen zoals tekst, getal, boolean en datum.
  • Stel verplichte velden en unieke waarden in rond een stabiele sleutel.
  • Voeg records toe en bewerk ze in een draft, zonder de gepubliceerde versie te veranderen.
  • Importeer CSV- en Excel-bestanden. Koppel kolommen en controleer het voorstel voordat je de import bevestigt.
Het tabblad Velden van de dataset Kostenplaatsen in refrncr, in een draft: Code is de sleutel en is verplicht en uniek; Naam, Startdatum en Rapporteerbaar zijn verplicht. Elk veld heeft een vast datatype: tekst, datum, ja/nee of decimaal.

API met peildatum

Rapporteer met de dataset die toen geldig was.

Een reorganisatie verandert de indeling van kostenplaatsen. Voor een rapportage over een eerdere periode heb je de gegevens en structuur uit die periode nodig. Refrncr bewaart welke gepubliceerde versie op iedere peildatum geldig was.

dataset · effective_date
# 1 · zonder parameters → huidige gepubliceerde versie
$ curl -H "Authorization: Bearer $REFRNCR_KEY" \
    "$REF/api/v1/datasets/cost_centers/records"

# 2 · januari–februari → versie 15 (Verkoop)
$ curl -G -H "Authorization: Bearer $REFRNCR_KEY" \
    "$REF/api/v1/datasets/cost_centers/records" \
    -d effective_date=2026-02-28

# 3 · vaste versie 15, en controleer dat die op die datum gold
$ curl -G -H "Authorization: Bearer $REFRNCR_KEY" \
    "$REF/api/v1/datasets/cost_centers/records" \
    -d version=15 -d effective_date=2026-02-28

# 4 · maart–juni → versie 16 (Bedrijfsvoering)
$ curl -G -H "Authorization: Bearer $REFRNCR_KEY" \
    "$REF/api/v1/datasets/cost_centers/records" \
    -d effective_date=2026-03-01
DATASETVERSIES V15 Kostenplaats → Verkoop geldig in jan–feb V16 Kostenplaats → Bedrijfsvoering geldig vanaf 1 mrt 1 mrt RAPPORT 15 jul elke peildatum geeft de toen geldige datasetversie

Een kostenplaats verhuist op 1 maart van Verkoop naar Bedrijfsvoering. Een halfjaarrapport dat op 15 juli wordt gemaakt, rekent de kostenplaats voor januari en februari toe aan Verkoop en voor maart tot en met juni aan Bedrijfsvoering. Refrncr bewaart beide situaties, zodat de rapportage historisch correct en reproduceerbaar blijft.

Wat je achter je laat

Eén bron voor gedeelde referentiedata.

Nu

Meerdere bronbestanden

Met refrncr

Eén beheerde dataset

Beheer elke dataset op één plek, met een eigenaar, een vast schema en validatieregels. Afnemende systemen gebruiken de gepubliceerde gegevens.

Nu

Versienamen in bestandsnamen

Met refrncr

Vaste, gepubliceerde versies

Werk in een draft en publiceer een vaste versie zodra deze klaar is. In de versiehistorie zie je welke gegevens op welk moment beschikbaar waren.

Nu

Mappings verstopt in code

Met refrncr

Mappings als beheerde gegevens

Beheer vertaaltabellen als gegevens met duidelijke governance. Elke afnemer gebruikt dezelfde gepubliceerde mapping; ontbrekende en ongeldige koppelingen blijven zichtbaar.

Nu

Onvolledige wijzigingshistorie

Met refrncr

Een volledige audittrail

Bewaar wie iets wijzigde, het beoordelingsbesluit, de ingangsdatum en de aanpassingen per veld bij elkaar. De audittrail ontstaat tijdens het beheerproces.

Edities

Hetzelfde product, zelf gehost of beheerd door ons.

Community bevat alle kernfuncties: datasets, mappings, hiërarchieën, versiebeheer, publicatie, de API, rechten en audit. Meerdere gebruikers en teams werken samen in één installatie. De commerciële edities voegen hosting, onderhoud, ondersteuning en aanvullende mogelijkheden toe.

Source-available · ELv2

Community

Host refrncr zelf, met één organisatie per installatie. Begin eenvoudig met ingebouwde SQLite en stap over op PostgreSQL voor gebruik in productie.

Beheerde SaaS

refrncr Cloud

Binnenkort

Op maat

Enterprise

Binnenkort

MogelijkheidCommunityCloud BinnenkortEnterprise Binnenkort
Datasets, datatypen & records✓
Mappings & vertaaltabellen✓
Hiërarchieën✓
Draft → beoordeling → publicatie✓
Geldigheidsdatums & API met peildatum✓
Teams, rechten & audit✓
Meerdere gebruikers en teams✓
Snel starten met ingebouwde SQLite✓
PostgreSQLeigen beheer
Platform voor meerdere tenants—
Inrichting, quota & facturatie—
SSO / SAML / OIDC, SCIM—
Dataopslag in de EUeigen infrastructuur
SLA & commerciële ondersteuning—

✓ inbegrepen · optioneel = beschikbaar in overleg · — niet van toepassing · gepland = nog niet beschikbaar

Prijzen

Community is gratis. Cloud en Enterprise volgen later.

Community is gratis en blijft dat. Cloud en Enterprise komen binnenkort beschikbaar.

Zelf hosten · ELv2

Community

€0blijvend

Onbeperkt aantal bewerkers · eigen infrastructuur

  • Alle kernfuncties: datasets, mappings, hiërarchieën, versiebeheer en API
  • Meerdere gebruikers en teams, één organisatie per installatie
  • Snel starten met ingebouwde SQLite, of je eigen PostgreSQL
  • Rechten en audit inbegrepen
  • Geen licentie- of gebruikskosten
  • Ondersteuning vanuit de community
Beheerde SaaS

refrncr Cloud

Binnenkort

Op maat

Enterprise

Binnenkort

Afbakening

Wat refrncr niet is.

Refrncr is gemaakt voor referentiedata die gecontroleerd en relatief weinig verandert. Transacties en operationele gegevens die de hele dag wijzigen, horen thuis in andere systemen. Ook de volgende functies vallen buiten de scope:

  • Golden records en bronprioritering
  • Berekende meetwaarden en allocaties
  • Ontdubbelen en fuzzy matching
  • MDM voor klantgegevens of PIM
  • Een datacatalogus of data-lineageproduct
  • Een algemene oplossing voor datakwaliteit
  • Een productcatalogus
  • Een BI-platform
  • Een algemene BPM- of workflowoplossing

In gebruik nemen

Begin met SQLite. Gebruik PostgreSQL in productie.

Snel starten

Ingebouwde SQLite, zonder extra infrastructuur. Eén installatie en één opdracht geven je een werkende omgeving voor je eigen gegevens.

Eigen database

Gebruik PostgreSQL voor productie met meerdere gebruikers, in je eigen netwerk en met je eigen back-up- en bewaarbeleid.

Rechten

Duidelijke rechten: Bekijken, Bewerken, Goedkeuren en Publiceren. Je ziet zowel rechtstreeks toegekende rechten als rechten via een team.

API-sleutels

Een geheim wordt één keer getoond bij het aanmaken. Daarna zie je de identificatie en metadata. Het aanmaken en intrekken van sleutels wordt vastgelegd in de audittrail.

Installeren

refrncr.org

Begin vandaag in je eigen omgeving.

Source-available onder ELv2, zelf te hosten en blijvend gratis. Begin met een lijst die je team dagelijks gebruikt, zoals kostenplaatsen. Importeer de gegevens en publiceer ze via de API om te zien hoe het beheer werkt.

$ pipx install --pre refrncr
$ refrncr start
refrncr.com

Liever een beheerde omgeving?

Refrncr Cloud gebruikt dezelfde productkern op beheerde PostgreSQL. Wij verzorgen hosting, back-ups en platformbeheer, zodat je het platform niet zelf hoeft te beheren.

  • Beheerde PostgreSQL, zonder eigen infrastructuurteam.
  • Eigen tenant met meerdere gebruikers en teams.
  • Enterprise-mogelijkheden op aanvraag zodra ze beschikbaar zijn.