HAALCENTRAAL English translation
BRP API / Personen / Features / overzicht-gba

supplying RNI participant data

# language: en

@gba
Feature: supplying RNI participant data

  RNI participant data belonging to the following categories is supplied when at least one item of data from those categories is requested
  | categorie | naam           |
  | 01        | Persoon        |
  | 04        | Nationaliteit  |
  | 06        | Overlijden     |
  | 08        | Verblijfplaats |

  Background:
    Given national table "RNI-deelnemerstabel" has the following values
    | code | omschrijving                                                       |
    | 0101 | Belastingdienst (inzake heffingen en toeslagen)                    |
    | 0201 | Sociale Verzekeringsbank (inzake AOW, Anw en AKW)                  |
    | 0501 | Immigratie- en naturalisatiedienst (inzake nationaliteitsgegevens) |

Rule: RNI participant data belonging to category 01 (Persoon), 04 (Nationaliteit), 06 (Overlijden) and/or 08 (Verblijfplaats) is supplied where one or more fields from those categories are requested

  Scenario Outline: the person has RNI participant data for category 01 (Persoon) and one or more fields from that category are requested
    Given the person with citizen service number '000000012' has the following data
    | naam                         | waarde                                      |
    | voornamen (02.10)            | Peter                                       |
    | geslachtsnaam (02.40)        | Jansen                                      |
    | rni-deelnemer (88.10)        | 0101                                        |
    | omschrijving verdrag (88.20) | Belastingverdrag tussen België en Nederland |
    When gba persons are searched with the following parameters
    | naam                | waarde                          |
    | type                | RaadpleegMetBurgerservicenummer |
    | burgerservicenummer | 000000012                       |
    | fields              | <fields>                        |
    Then the response has a person with the following 'naam' data
    | naam          | waarde |
    | voornamen     | Peter  |
    | geslachtsnaam | Jansen |
    And the person has a 'rni' with the following data
    | naam                   | waarde                                          |
    | deelnemer.code         | 0101                                            |
    | deelnemer.omschrijving | Belastingdienst (inzake heffingen en toeslagen) |
    | omschrijvingVerdrag    | Belastingverdrag tussen België en Nederland     |
    | categorie              | Persoon                                         |

    Examples:
    | fields                              |
    | naam                                |
    | naam.voornamen,naam.geslachtsnaam   |
    | naam.volledigeNaam                  |
    | naam.voorletters,naam.geslachtsnaam |

  Scenario Outline: the person has RNI participant data for category 04 (Nationaliteit) and one or more fields from that category are requested
    Given the person with citizen service number '000000012' has a 'nationaliteit' with the following data
    | naam                         | waarde                                      |
    | nationaliteit (05.10)        | <nationaliteit code>                        |
    | rni-deelnemer (88.10)        | <rni-deelnemer code>                        |
    | omschrijving verdrag (88.20) | Belastingverdrag tussen België en Nederland |
    When gba persons are searched with the following parameters
    | naam                | waarde                          |
    | type                | RaadpleegMetBurgerservicenummer |
    | burgerservicenummer | 000000012                       |
    | fields              | <fields>                        |
    Then the response has a person with a 'nationaliteit' with the following data
    | naam                       | waarde                       |
    | nationaliteit.code         | <nationaliteit code>         |
    | nationaliteit.omschrijving | <nationaliteit omschrijving> |
    And the person has a 'rni' with the following data
    | naam                   | waarde                                      |
    | deelnemer.code         | <rni-deelnemer code>                        |
    | deelnemer.omschrijving | <rni-deelnemer omschrijving>                |
    | omschrijvingVerdrag    | Belastingverdrag tussen België en Nederland |
    | categorie              | Nationaliteit                               |

    Examples:
    | nationaliteit code | nationaliteit omschrijving | rni-deelnemer code | rni-deelnemer omschrijving                                         | fields                        |
    | 0052               | Belgische                  | 0201               | Sociale Verzekeringsbank (inzake AOW, Anw en AKW)                  | nationaliteiten               |
    | 0263               | Surinaamse                 | 0501               | Immigratie- en naturalisatiedienst (inzake nationaliteitsgegevens) | nationaliteiten.nationaliteit |

  Scenario: the person has RNI participant data for category 06 (Overlijden) and one or more fields from that category are requested
    Given the person with citizen service number '000000012' has the following 'overlijden' data
    | datum overlijden (08.10) | plaats overlijden (08.20) | land overlijden (08.30) | rni-deelnemer (88.10) |
    | 20020701                 | 0518                      | 6030                    | 0401                  |
    When gba persons are searched with the following parameters
    | naam                | waarde                          |
    | type                | RaadpleegMetBurgerservicenummer |
    | burgerservicenummer | 000000012                       |
    | fields              | overlijden.datum                |
    Then the response has a person with the following 'overlijden' data
    | naam  | waarde   |
    | datum | 20020701 |
    And the person has a 'rni' with the following data
    | naam                   | waarde                         |
    | deelnemer.code         | 0401                           |
    | deelnemer.omschrijving | CAK (inzake zorgverzekeringen) |
    | categorie              | Overlijden                     |

  Scenario Outline: the person has RNI participant data for category 08 (<verblijfplaats type>) and one or more fields from that category are requested
    Given the person with citizen service number '000000036' has the following 'verblijfplaats' data
    | naam                         | waarde                               |
    | land (13.10)                 | <waarde>                             |
    | rni-deelnemer (88.10)        | 0201                                 |
    | omschrijving verdrag (88.20) | Artikel 45 EU-Werkingsverdrag (VWEU) |
    When gba persons are searched with the following parameters
    | naam                | waarde                          |
    | type                | RaadpleegMetBurgerservicenummer |
    | burgerservicenummer | 000000036                       |
    | fields              | <fields>                        |
    Then the response has a person with the following 'verblijfplaats' data
    | naam              | waarde         |
    | land.code         | <waarde>       |
    | land.omschrijving | <omschrijving> |
    And the person has a 'rni' with the following data
    | naam                   | waarde                                            |
    | deelnemer.code         | 0201                                              |
    | deelnemer.omschrijving | Sociale Verzekeringsbank (inzake AOW, Anw en AKW) |
    | omschrijvingVerdrag    | Artikel 45 EU-Werkingsverdrag (VWEU)              |
    | categorie              | Verblijfplaats                                    |

    Examples:
    | verblijfplaats type       | waarde | omschrijving | fields                                |
    | verblijfplaats buitenland | 5010   | België       | verblijfplaats                        |
    | verblijfplaats onbekend   | 0000   | Onbekend     | verblijfplaats.verblijfadres.postcode |
    | verblijfplaats buitenland | 5010   | België       | verblijfplaats.verblijfadres          |
    | verblijfplaats buitenland | 5010   | België       | adressering.adresregel3               |
    | verblijfplaats buitenland | 5010   | België       | adressering.adresregel1               |
    | verblijfplaats buitenland | 5010   | België       | adressering.land                      |
    | verblijfplaats buitenland | 5010   | België       | adressering.land.omschrijving         |

  Scenario Outline: the person has RNI participant data for category 08 (<verblijfplaats type>) and one or more fields from that category are requested
    Given the person with citizen service number '000000036' has the following 'verblijfplaats' data
    | naam                         | waarde                               |
    | rni-deelnemer (88.10)        | 0201                                 |
    | omschrijving verdrag (88.20) | Artikel 45 EU-Werkingsverdrag (VWEU) |
    And the 'verblijfplaats' has the following 'adres' data
    | naam                 | waarde   |
    | gemeentecode (92.10) | 0518     |
    | <naam gba veld>      | <waarde> |
    When gba persons are searched with the following parameters
    | naam                | waarde                          |
    | type                | RaadpleegMetBurgerservicenummer |
    | burgerservicenummer | 000000036                       |
    | fields              | <fields>                        |
    Then the response has a person with the following 'verblijfplaats' data
    | naam        | waarde   |
    | <naam veld> | <waarde> |
    And the person has a 'rni' with the following data
    | naam                   | waarde                                            |
    | deelnemer.code         | 0201                                              |
    | deelnemer.omschrijving | Sociale Verzekeringsbank (inzake AOW, Anw en AKW) |
    | omschrijvingVerdrag    | Artikel 45 EU-Werkingsverdrag (VWEU)              |
    | categorie              | Verblijfplaats                                    |

    Examples:
    | verblijfplaats type | naam gba veld               | waarde   | naam veld           | fields                                           |
    | locatie             | locatiebeschrijving (12.10) | woonboot | locatiebeschrijving | verblijfplaats.verblijfadres.land                |
    | adres               | straatnaam (11.10)          | Spui     | straat              | verblijfplaats.verblijfadres.locatiebeschrijving |

  Scenario Outline: the person has RNI participant data for category 08 and <fields> is requested
    Given the person with citizen service number '000000036' has the following 'verblijfplaats' data
    | naam                         | waarde                               |
    | rni-deelnemer (88.10)        | 0201                                 |
    | omschrijving verdrag (88.20) | Artikel 45 EU-Werkingsverdrag (VWEU) |
    And the 'verblijfplaats' has the following 'adres' data
    | gemeentecode (92.10) | straatnaam (11.10) |
    | 0518                 | Spui               |
    When gba persons are searched with the following parameters
    | naam                | waarde                          |
    | type                | RaadpleegMetBurgerservicenummer |
    | burgerservicenummer | 000000036                       |
    | fields              | <fields>                        |
    Then the response has a person with a 'rni' with the following data
    | naam                   | waarde                                            |
    | deelnemer.code         | 0201                                              |
    | deelnemer.omschrijving | Sociale Verzekeringsbank (inzake AOW, Anw en AKW) |
    | omschrijvingVerdrag    | Artikel 45 EU-Werkingsverdrag (VWEU)              |
    | categorie              | Verblijfplaats                                    |

    Examples:
    | fields                                           |
    | gemeenteVanInschrijving                          |
    | gemeenteVanInschrijving.code                     |
    | gemeenteVanInschrijving.omschrijving             |
    | datumInschrijvingInGemeente                      |
    | datumInschrijvingInGemeente.type                 |
    | datumInschrijvingInGemeente.datum                |
    | datumInschrijvingInGemeente.langFormaat          |
    | datumInschrijvingInGemeente.jaar                 |
    | datumInschrijvingInGemeente.maand                |
    | datumInschrijvingInGemeente.onbekend             |
    | immigratie                                       |
    | immigratie.datumVestigingInNederland             |
    | immigratie.datumVestigingInNederland.type        |
    | immigratie.datumVestigingInNederland.datum       |
    | immigratie.datumVestigingInNederland.langFormaat |
    | immigratie.indicatieVestigingVanuitBuitenland    |
    | immigratie.landVanwaarIngeschreven               |
    | immigratie.landVanwaarIngeschreven.code          |
    | immigratie.landVanwaarIngeschreven.omschrijving  |
    | immigratie.vanuitVerblijfplaatsOnbekend          |

  Scenario Outline: the person has RNI participant data for several categories for which RNI participant data must be supplied, and one or more fields from all those categories are requested
    Given the person with citizen service number '000000024' has the following data
    | naam                         | waarde                                      |
    | voornamen (02.10)            | Peter                                       |
    | rni-deelnemer (88.10)        | 0101                                        |
    | omschrijving verdrag (88.20) | Belastingverdrag tussen België en Nederland |
    And the person has the following 'verblijfplaats' data
    | naam                         | waarde                               |
    | land (13.10)                 | 5010                                 |
    | rni-deelnemer (88.10)        | 0201                                 |
    | omschrijving verdrag (88.20) | Artikel 45 EU-Werkingsverdrag (VWEU) |
    When gba persons are searched with the following parameters
    | naam                | waarde                          |
    | type                | RaadpleegMetBurgerservicenummer |
    | burgerservicenummer | 000000024                       |
    | fields              | <fields>                        |
    Then the response has a person with the following 'naam' data
    | naam      | waarde |
    | voornamen | Peter  |
    And the person has the following 'verblijfplaats' data
    | naam              | waarde |
    | land.code         | 5010   |
    | land.omschrijving | België |
    And the person has a 'rni' with the following data
    | naam                   | waarde                                          |
    | deelnemer.code         | 0101                                            |
    | deelnemer.omschrijving | Belastingdienst (inzake heffingen en toeslagen) |
    | omschrijvingVerdrag    | Belastingverdrag tussen België en Nederland     |
    | categorie              | Persoon                                         |
    And the person has a 'rni' with the following data
    | naam                   | waarde                                            |
    | deelnemer.code         | 0201                                              |
    | deelnemer.omschrijving | Sociale Verzekeringsbank (inzake AOW, Anw en AKW) |
    | omschrijvingVerdrag    | Artikel 45 EU-Werkingsverdrag (VWEU)              |
    | categorie              | Verblijfplaats                                    |

    Examples:
    | fields                                                          |
    | naam,verblijfplaats                                             |
    | naam,verblijfplaats.verblijfadres                               |
    | naam,verblijfplaats.verblijfadres.land                          |
    | naam,verblijfplaats.verblijfadres.land.code                     |
    | naam,verblijfplaats.verblijfadres.land.omschrijving             |
    | naam,verblijfplaats.functieAdres                                |
    | naam,verblijfplaats.functieAdres.omschrijving                   |
    | naam,verblijfplaats.verblijfadres.postcode                      |
    | naam,adressering.land                                           |
    | naam.voornamen,verblijfplaats.datumIngangGeldigheid.langFormaat |
    | naam,adressering.adresregel1                                    |

  Scenario Outline: the person has RNI participant data for one category and a field from another category is requested
    Given the person with citizen service number '000000024' has the following data
    | naam                         | waarde                                      |
    | voornamen (02.10)            | Peter                                       |
    | rni-deelnemer (88.10)        | 0101                                        |
    | omschrijving verdrag (88.20) | Belastingverdrag tussen België en Nederland |
    And the person has the following 'verblijfplaats' data
    | naam         | waarde |
    | land (13.10) | 5010   |
    When gba persons are searched with the following parameters
    | naam                | waarde                          |
    | type                | RaadpleegMetBurgerservicenummer |
    | burgerservicenummer | 000000024                       |
    | fields              | <fields>                        |
    Then the response has a person with the following 'verblijfplaats' data
    | naam              | waarde |
    | land.code         | 5010   |
    | land.omschrijving | België |

    Examples:
    | fields                                 |
    | verblijfplaats                         |
    | verblijfplaats.verblijfadres           |
    | verblijfplaats.verblijfadres.land      |
    | verblijfplaats.verblijfadres.land.code |
    | verblijfplaats.verblijfadres.regel1    |
    | adressering.adresregel1                |
    | adressering.land                       |

  Scenario Outline: the person has several nationalities supplied by an RNI participant
    Given the person with citizen service number '000000140' has a 'nationaliteit' with the following data
    | nationaliteit (05.10) | reden opnemen (63.10) | datum ingang geldigheid (85.10) | rni-deelnemer (88.10) |
    | 0263                  | 301                   | 19620107                        | 201                   |
    And the person has another 'nationaliteit' with the following data
    | nationaliteit (05.10) | reden opnemen (63.10) | datum ingang geldigheid (85.10) | rni-deelnemer (88.10) |
    | 0052                  | 301                   | 19830326                        | 501                   |
    When gba persons are searched with the following parameters
    | naam                | waarde                          |
    | type                | RaadpleegMetBurgerservicenummer |
    | burgerservicenummer | 000000140                       |
    | fields              | <fields>                        |
    Then the response has a person with a 'nationaliteit' with only the following data
    | naam                       | waarde                                   |
    | nationaliteit.code         | 0263                                     |
    | nationaliteit.omschrijving | Surinaamse                               |
    | redenOpname.code           | 301                                      |
    | redenOpname.omschrijving   | Vaststelling bezit vreemde nationaliteit |
    | datumIngangGeldigheid      | 19620107                                 |
    And the person has a 'nationaliteit' with only the following data
    | naam                       | waarde                                   |
    | nationaliteit.code         | 0052                                     |
    | nationaliteit.omschrijving | Belgische                                |
    | redenOpname.code           | 301                                      |
    | redenOpname.omschrijving   | Vaststelling bezit vreemde nationaliteit |
    | datumIngangGeldigheid      | 19830326                                 |
    And the person has a 'rni' with the following data
    | naam                   | waarde                                            |
    | deelnemer.code         | 0201                                              |
    | deelnemer.omschrijving | Sociale Verzekeringsbank (inzake AOW, Anw en AKW) |
    | categorie              | Nationaliteit                                     |
    And the person has another 'rni' with the following data
    | naam                   | waarde                                                             |
    | deelnemer.code         | 0501                                                               |
    | deelnemer.omschrijving | Immigratie- en naturalisatiedienst (inzake nationaliteitsgegevens) |
    | categorie              | Nationaliteit                                                      |

    Examples:
    | fields                                                                              |
    | nationaliteiten                                                                     |
    | nationaliteiten.redenOpname,nationaliteiten.datumIngangGeldigheid                   |
    | nationaliteiten.redenOpname.omschrijving,nationaliteiten.datumIngangGeldigheid.jaar |

  Scenario: the person has one current and one ended nationality supplied by an RNI participant
    Given the person with citizen service number '000000140' has a 'nationaliteit' with the following data
    | nationaliteit (05.10) | reden opnemen (63.10) | datum ingang geldigheid (85.10) | rni-deelnemer (88.10) |
    | 0263                  | 301                   | 19620107                        | 201                   |
    And the person has another 'nationaliteit' with the following data
    | nationaliteit (05.10) | reden opnemen (63.10) | datum ingang geldigheid (85.10) | rni-deelnemer (88.10) |
    | 0052                  | 301                   | 19830326                        | 501                   |
    And the 'nationaliteit' has been changed to the following data
    | reden beëindigen (64.10) | datum ingang geldigheid (85.10) | rni-deelnemer (88.10) |
    | 403                      | 19970715                        | 501                   |
    When gba persons are searched with the following parameters
    | naam                | waarde                          |
    | type                | RaadpleegMetBurgerservicenummer |
    | burgerservicenummer | 000000140                       |
    | fields              | nationaliteiten                 |
    Then the response has a person with a 'nationaliteit' with only the following data
    | naam                       | waarde                                   |
    | nationaliteit.code         | 0263                                     |
    | nationaliteit.omschrijving | Surinaamse                               |
    | redenOpname.code           | 301                                      |
    | redenOpname.omschrijving   | Vaststelling bezit vreemde nationaliteit |
    | datumIngangGeldigheid      | 19620107                                 |
    And the person has a 'rni' with the following data
    | naam                   | waarde                                            |
    | deelnemer.code         | 0201                                              |
    | deelnemer.omschrijving | Sociale Verzekeringsbank (inzake AOW, Anw en AKW) |
    | categorie              | Nationaliteit                                     |
    
  Scenario Outline: the person has RNI participant data for verblijfplaats, but no verblijfplaats fields are requested
    Given the person with citizen service number '000000036' has the following data
    | naam                  | waarde |
    | voornamen (02.10)     | Peter  |
    | geslachtsnaam (02.40) | Jansen |
    And the person has the following 'verblijfplaats' data
    | naam                         | waarde                               |
    | land (13.10)                 | 5010                                 |
    | rni-deelnemer (88.10)        | 0201                                 |
    | omschrijving verdrag (88.20) | Artikel 45 EU-Werkingsverdrag (VWEU) |
    When gba persons are searched with the following parameters
    | naam                | waarde                          |
    | type                | RaadpleegMetBurgerservicenummer |
    | burgerservicenummer | 000000036                       |
    | fields              | <fields>                        |
    Then the response has a person with the following 'naam' data
    | naam          | waarde |
    | voornamen     | Peter  |
    | geslachtsnaam | Jansen |

    Examples:
    | fields |
    | naam   |

  Scenario Outline: the person has RNI participant data for inschrijving and one or more fields from that category are requested
    Given the person with citizen service number '000000048' has the following 'inschrijving' data
    | naam                         | waarde                                      |
    | rni-deelnemer (88.10)        | 0101                                        |
    | omschrijving verdrag (88.20) | Belastingverdrag tussen België en Nederland |
    | <naam gba veld>              | <waarde gba veld>                           |
    When gba persons are searched with the following parameters
    | naam                | waarde                          |
    | type                | RaadpleegMetBurgerservicenummer |
    | burgerservicenummer | 000000048                       |
    | fields              | burgerservicenummer             |
    Then the response has a person with the following data
    | naam                | waarde          |
    | burgerservicenummer | 000000048       |
    | <naam veld 1>       | <waarde veld 1> |
    | <naam veld 2>       | <waarde veld 2> |

    Examples:
    | naam gba veld                        | waarde gba veld | naam veld 1                      | waarde veld 1 | naam veld 2                              | waarde veld 2 |
    | indicatie geheim (70.10)             | 0               |                                  |               |                                          |               |
    | indicatie geheim (70.10)             | 1               | geheimhoudingPersoonsgegevens    | 1             |                                          |               |
    | reden opschorting bijhouding (67.20) | O               | opschortingBijhouding.reden.code | O             | opschortingBijhouding.reden.omschrijving | overlijden    |


Rule: rni may not be requested, because it is supplied automatically

  @fout-case
  Scenario Outline: rni in <fields> may not be requested, because it is supplied automatically
    Given the person with citizen service number '000000012' has the following data
    | naam                         | waarde                                      |
    | voornamen (02.10)            | Peter                                       |
    | geslachtsnaam (02.40)        | Jansen                                      |
    | rni-deelnemer (88.10)        | 0101                                        |
    | omschrijving verdrag (88.20) | Belastingverdrag tussen België en Nederland |
    When gba persons are searched with the following parameters
    | naam                | waarde                          |
    | type                | RaadpleegMetBurgerservicenummer |
    | burgerservicenummer | 000000012                       |
    | fields              | <fields>                        |
    Then the response has an object with the following data
    | naam     | waarde                                                      |
    | type     | https://datatracker.ietf.org/doc/html/rfc7231#section-6.5.1 |
    | title    | Een of meerdere parameters zijn niet correct.               |
    | status   | 400                                                         |
    | detail   | De foutieve parameter(s) zijn: fields[<index>].             |
    | code     | paramsValidation                                            |
    | instance | /haalcentraal/api/brp/personen                              |
    And the object has the following 'invalidParams' data
    | code   | name            | reason                                        |
    | fields | fields[<index>] | Parameter bevat een niet toegestane veldnaam. |

    Examples:
    | fields                                      | index |
    | rni                                         | 0     |
    | rni.deelnemer                               | 0     |
    | rni.deelnemer.code                          | 0     |
    | rni.deelnemer.omschrijving                  | 0     |
    | rni.omschrijvingVerdrag                     | 0     |
    | rni.categorie                               | 0     |
    | rni.omschrijvingVerdrag,burgerservicenummer | 0     |
    | naam.voorvoegsel,rni,geboorte.plaats        | 1     |
    | geslacht,adressering.aanhef,rni.deelnemer   | 2     |