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

supplying RNI participant data (PersoonBeperkt)

# language: en

@gba
Feature: supplying RNI participant data (PersoonBeperkt)

  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        |
  | 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) 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                                      |
    | geboortedatum (03.10)        | 19830526                                    |
    | 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                       | ZoekMetGeslachtsnaamEnGeboortedatum |
    | geslachtsnaam              | Jansen                              |
    | geboortedatum              | 1983-05-26                          |
    | 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.voorletters,naam.geslachtsnaam |
    | naam.volledigeNaam                  |

  Scenario Outline: the person has RNI participant data for category 08 (residence abroad) and <fields> is requested
    Given the person with citizen service number '000000036' has the following data
    | naam                         | waarde                                      |
    | geslachtsnaam (02.40)        | Jansen                                      |
    | geboortedatum (03.10)        | 19830526                                    |
    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                       | ZoekMetGeslachtsnaamEnGeboortedatum |
    | geslachtsnaam              | Jansen                              |
    | geboortedatum              | 1983-05-26                          |
    | fields                     | <fields>                            |
    Then the response has a person with 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         | 0201                                              |
    | deelnemer.omschrijving | Sociale Verzekeringsbank (inzake AOW, Anw en AKW) |
    | omschrijvingVerdrag    | Artikel 45 EU-Werkingsverdrag (VWEU)              |
    | categorie              | Verblijfplaats                                    |

    Examples:
    | fields                                                                                   |
    | adressering.adresregel1                                                                  |
    | adressering.adresregel2                                                                  |
    | adressering.adresregel3                                                                  |
    | adressering.land                                                                         |
    | adressering.adresregel1,adressering.adresregel2,adressering.adresregel3,adressering.land |

  Scenario Outline: the person has RNI participant data for category 08 (<verblijfplaats type>) and <fields> is requested
    Given the person with citizen service number '000000036' has the following data
    | naam                         | waarde                                      |
    | geslachtsnaam (02.40)        | Jansen                                      |
    | geboortedatum (03.10)        | 19830526                                    |
    And the person 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          | ZoekMetGeslachtsnaamEnGeboortedatum |
    | geslachtsnaam | Jansen                              |
    | geboortedatum | 1983-05-26                          |
    | 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 | adressering.adresregel1 |
    | locatie             | locatiebeschrijving (12.10) | woonboot | locatiebeschrijving | adressering.adresregel2 |
    | adres               | straatnaam (11.10)          | Spui     | straat              | adressering.adresregel1 |
    | adres               | straatnaam (11.10)          | Spui     | straat              | adressering.adresregel2 |

  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                                       |
    | geslachtsnaam (02.40)        | Jansen                                      |
    | geboortedatum (03.10)        | 19830526                                    |
    | 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          | ZoekMetGeslachtsnaamEnGeboortedatum |
    | geslachtsnaam | Jansen                              |
    | geboortedatum | 1983-05-26                          |
    | fields        | <fields>                            |
    Then the response has a person with the following 'naam' data
    | naam          | waarde |
    | voornamen     | Peter  |
    | geslachtsnaam | Jansen |
    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,adressering.adresregel1                                          |
    | naam.voornamen,naam.geslachtsnaam,adressering.land.omschrijving       |
    | naam,adressering.adresregel2                                          |
    | naam,adressering.adresregel1,adressering.adresregel2,adressering.land |

  Scenario Outline: the person has RNI participant data for the categories persoon and verblijfplaats, and adressering is requested
    Given the person with citizen service number '000000024' has the following data
    | naam                         | waarde                                      |
    | voornamen (02.10)            | Peter                                       |
    | geslachtsnaam (02.40)        | Jansen                                      |
    | geboortedatum (03.10)        | 19830526                                    |
    | 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          | ZoekMetGeslachtsnaamEnGeboortedatum |
    | geslachtsnaam | Jansen                              |
    | geboortedatum | 1983-05-26                          |
    | fields        | <fields>                            |
    Then the response has a person with 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         | 0201                                              |
    | deelnemer.omschrijving | Sociale Verzekeringsbank (inzake AOW, Anw en AKW) |
    | omschrijvingVerdrag    | Artikel 45 EU-Werkingsverdrag (VWEU)              |
    | categorie              | Verblijfplaats                                    |

    Examples:
    | fields                                                           |
    | adressering.adresregel1                                          |
    | adressering.adresregel2                                          |
    | adressering.adresregel3                                          |
    | adressering.land                                                 |
    | adressering.land.code                                            |
    | adressering.land.omschrijving                                    |
    | adressering.adresregel1,adressering.adresregel2,adressering.land |
    | adressering                                                      |
    
  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   |
    | geboortedatum (03.10) | 19830526 |
    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          | ZoekMetGeslachtsnaamEnGeboortedatum |
    | geslachtsnaam | Jansen                              |
    | geboortedatum | 1983-05-26                          |
    | fields        | <fields>                            |
    Then the response has a person with the following 'naam' data
    | naam          | waarde |
    | voornamen     | Peter  |
    | geslachtsnaam | Jansen |

    Examples:
    | fields             |
    | naam               |
    | naam.volledigeNaam |


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                                      |
    | geslachtsnaam (02.40)        | Jansen                                      |
    | geboortedatum (03.10)        | 19830526                                    |
    | 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          | ZoekMetGeslachtsnaamEnGeboortedatum |
    | geslachtsnaam | Jansen                              |
    | geboortedatum | 1983-05-26                          |
    | 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.datum         | 1     |
    | geslacht,adressering,rni.deelnemer          | 2     |