Voorwaarden als regels

eligibility.rules van een maatregel is een lijst van regelknopen die allemaal moeten kloppen. De matcher evalueert ze tegen de gegevens van een matchverzoek; de volledige record geeft ze zoals ze zijn, zodat je ze zelf kunt tonen of evalueren. Thema’s staan er bewust los van: een thema is een reden om een maatregel te tonen, een regel is een voorwaarde waaraan je moet voldoen.

Knopen#

Knopen worden onderscheiden door hun sleutels. De lijst op het hoogste niveau is een impliciete all. De id van een voorwaarde is stabiel binnen haar maatregel (region, size, applicant_type, nace, age_max), en zo kan de change feed zeggen welke regel veranderde: eligibility.rules[age_max].

Dit zijn de regels van de federale tax shelter voor startende ondernemingen: de toets voor kleine vennootschappen uit het Wetboek van vennootschappen en verenigingen (minstens twee van de drie criteria) als een any van drie paren, gevolgd door een leeftijdsgrens. De herkomst is ingekort in de eerste zes.

[
  {
    "any": [
      {
        "all": [
          {
            "id": "size",
            "field": "company.employees",
            "op": "lte",
            "value": 50,
            "provenance": "…"
          },
          {
            "id": "size_turnover_a",
            "field": "company.turnover_eur",
            "op": "lte",
            "value": 11250000,
            "provenance": "…"
          }
        ]
      },
      {
        "all": [
          {
            "id": "size_employees_b",
            "field": "company.employees",
            "op": "lte",
            "value": 50,
            "provenance": "…"
          },
          {
            "id": "size_balance_b",
            "field": "company.balance_sheet_eur",
            "op": "lte",
            "value": 6000000,
            "provenance": "…"
          }
        ]
      },
      {
        "all": [
          {
            "id": "size_turnover_c",
            "field": "company.turnover_eur",
            "op": "lte",
            "value": 11250000,
            "provenance": "…"
          },
          {
            "id": "size_balance_c",
            "field": "company.balance_sheet_eur",
            "op": "lte",
            "value": 6000000,
            "provenance": "…"
          }
        ]
      }
    ]
  },
  {
    "id": "age_max",
    "field": "company.age_years",
    "op": "lt",
    "value": 4,
    "label": {
      "nl": "In de eerste vier jaar na de oprichting",
      "fr": "Dans les quatre premières années après la constitution",
      "en": "Within the first four years after incorporation",
      "de": null
    },
    "provenance": {
      "method": "curated",
      "source_url": "https://financien.belgium.be/nl/ondernemingen/tax-shelter-kleine-ondernemingen/startende-start-up",
      "source_section": null,
      "review_status": "verified",
      "reviewed_at": "2026-09-27",
      "note": "Completed years: the fifth year after incorporation belongs to the scale-up regime."
    }
  }
]

Drie waarden#

Een gegeven dat de aanroeper niet meegaf, is onbekend, nooit verondersteld. Dat geldt ook voor een gegeven met een vorm die de operator niet kan vergelijken, en voor een regel met een misvormde waarde: een kapotte regel slaagt nooit per ongeluk. De uitkomst van de hele boom is een van de drie, en die bepaalt de matchstatus. De gegevens die onbekend waren terwijl ze de uitkomst konden veranderen, komen terug als unknowns; zodra een boom beslist is (een fail in een all, een pass in een any), vallen de onbekenden weg, want er valt niets meer te vragen.

Velden#

Een gesloten lijst: een regel over een gegeven dat de matcher niet kan krijgen, zou altijd onbekend blijven. request_path is de eigenschap van het matchverzoek die het gegeven levert, en waar unknowns en missing_information naar verwijzen.

GET /v1/taxonomy geeft dezelfde lijst als rule_fields, elk veld met de vraag die je stelt, in het Nederlands, Frans en Engels.

Operatoren#

Strings worden vergeleken zonder onderscheid tussen hoofd- en kleine letters. Getallen mogen als JSON-getal of als numerieke string.

Labels#

Een regel kan een eigen label hebben ({ nl, fr, en, de }), meestal de woorden van de officiële pagina; heeft hij er geen, dan ontbreekt het veld in de record. Anders wordt een label opgesteld uit veld, operator en waarde, in elke taal van de dienst: Project cost at least €25,000, Projectkost minstens € 25.000, Coût du projet au moins 25 000 €. De reasons van een match bevatten het label in de taal die je vroeg.

Herkomst en reviewstatus#

Elke voorwaarde vermeldt waar ze vandaan komt:

Waar regels vandaan komen

• Uit gestructureerde velden: een regionale maatregel krijgt een regel region (contains_any op company.regions), een beperking op grootte een regel size, een lijst van types aanvragers een regel applicant_type, sectorlijsten regels nace en nace_excluded. Hun review_status is auto.
• Uit patronen in de tekst (bijvoorbeeld een maximum- of minimumleeftijd van de onderneming): method is text_pattern, review_status is unreviewed.
• Opgesteld aan de hand van de officiële pagina: method is curated, review_status is verified. Zo’n regel vervangt de automatische regel met dezelfde id.

rules_basis van de maatregel vat dit samen (none, derived, extracted, curated), en confidence zegt in welke mate de regels vatten wat bepaalt wie in aanmerking komt: 0,9 voor handmatig opgestelde regels tenzij anders ingesteld, 0,6 voor geëxtraheerde, 0,45 voor afgeleide. Alleen curated of extracted regels met 0,7 of meer kunnen een match likely_eligible maken.