HAAL✻CENTRAAL English translation
BRP API / Personen / Features / fout-cases

Search by street name/name of public space, house number and municipality of registration - error cases

#language: en

Feature: Search by street name/name of public space, house number and municipality of registration - error cases

Rule: Straat, huisnummer and gemeenteVanInschrijving are mandatory parameters

  @fout-case
  Scenario: The straat, huisnummer and gemeenteVanInschrijving parameters have not been supplied
    When persons are searched with the following parameters
    | naam   | waarde                                           |
    | type   | ZoekMetStraatHuisnummerEnGemeenteVanInschrijving |
    | fields | burgerservicenummer                              |
    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: gemeenteVanInschrijving, huisnummer, straat. |
    | code     | paramsValidation                                                            |
    | instance | /haalcentraal/api/brp/personen                                              |
    And the object has the following 'invalidParams' data
    | code     | name                    | reason                  |
    | required | straat                  | Parameter is verplicht. |
    | required | huisnummer              | Parameter is verplicht. |
    | required | gemeenteVanInschrijving | Parameter is verplicht. |

  @fout-case
  Scenario: An empty string has been supplied as the straat, huisnummer and gemeenteVanInschrijving value
    When persons are searched with the following parameters
    | naam                    | waarde                                           |
    | type                    | ZoekMetStraatHuisnummerEnGemeenteVanInschrijving |
    | fields                  | burgerservicenummer                              |
    | straat                  |                                                  |
    | huisnummer              |                                                  |
    | gemeenteVanInschrijving |                                                  |
    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: gemeenteVanInschrijving, huisnummer, straat. |
    | code     | paramsValidation                                                            |
    | instance | /haalcentraal/api/brp/personen                                              |
    And the object has the following 'invalidParams' data
    | code     | name                    | reason                  |
    | required | straat                  | Parameter is verplicht. |
    | required | huisnummer              | Parameter is verplicht. |
    | required | gemeenteVanInschrijving | Parameter is verplicht. |

Rule: a straat is a string of at least 1 and at most 80 characters. These characters may be:
      - lower-case letters (a-z)
      - upper-case letters (A-Z)
      - diacritics (À-ž)
      - digits (0-9)
      - space ( ), period (.), minus (-) and the single quotation mark (')

  @fout-case
  Scenario Outline: <titel>
    When persons are searched with the following parameters
    | naam                    | waarde                                           |
    | type                    | ZoekMetStraatHuisnummerEnGemeenteVanInschrijving |
    | fields                  | burgerservicenummer                              |
    | straat                  | <straat>                                         |
    | huisnummer              | 1                                                |
    | gemeenteVanInschrijving | 0518                                             |
    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: straat.                      |
    | code     | paramsValidation                                            |
    | instance | /haalcentraal/api/brp/personen                              |
    And the object has the following 'invalidParams' data
    | code    | name   | reason                                                                                                                                 |
    | pattern | straat | Waarde voldoet niet aan patroon ^[a-zA-Z0-9À-ž \-\'\.]{1,80}$\|^[a-zA-Z0-9À-ž \-\'\.]{7,79}\*{1}$\|^\*{1}[a-zA-Z0-9À-ž \-\'\.]{7,79}$. |

    Examples:
    | titel                                             | straat                                                                                                    |
    | De opgegeven straat is meer dan 80 karakters lang | abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ |
    | De opgegeven straat bevat ongeldige karakters     | <script>alert('hello world');</script>                                                                    |

Rule: a straat with a wildcard is a string of at least 7 and at most 79 characters, beginning or ending with the "*" characters. The remaining characters may be:
      - lower-case letters (a-z)
      - upper-case letters (A-Z)
      - diacritics (À-ž)
      - digits (0-9)
      - space ( ), period (.), minus (-) and the single quotation mark (')

  @fout-case
  Scenario Outline: <titel>
    When persons are searched with the following parameters
    | naam                    | waarde                                           |
    | type                    | ZoekMetStraatHuisnummerEnGemeenteVanInschrijving |
    | straat                  | <straat>                                         |
    | huisnummer              | 38                                               |
    | gemeenteVanInschrijving | 0518                                             |
    | fields                  | burgerservicenummer                              |
    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: straat.                      |
    | code     | paramsValidation                                            |
    | instance | /haalcentraal/api/brp/personen                              |
    And the object has the following 'invalidParams' data
    | code    | name   | reason                                                                                                                                 |
    | pattern | straat | Waarde voldoet niet aan patroon ^[a-zA-Z0-9À-ž \-\'\.]{1,80}$\|^[a-zA-Z0-9À-ž \-\'\.]{7,79}\*{1}$\|^\*{1}[a-zA-Z0-9À-ž \-\'\.]{7,79}$. |

    Examples:
    | straat     | titel                                                                                   |
    | *van Ock*  | De "*" wildcard is opgegeven als eerste en laatste karakter in de straat parameter      |
    | Laan * van | De "*" wildcard is niet opgegeven als eerste of laatste karakter in de straat parameter |
    | Laan*      | De straat parameter bevat niet het minimum aantal vereiste karakters                    |

Rule: a huisnummer is a number between 1 and 99999

  @fout-case
  Scenario Outline: A string with one or more non-numeric characters has been supplied as the huisnummer value
    When persons are searched with the following parameters
    | naam                    | waarde                                           |
    | type                    | ZoekMetStraatHuisnummerEnGemeenteVanInschrijving |
    | fields                  | burgerservicenummer                              |
    | straat                  | leyweg                                           |
    | huisnummer              | <huisnummer>                                     |
    | gemeenteVanInschrijving | 0518                                             |
    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: huisnummer.                  |
    | code     | paramsValidation                                            |
    | instance | /haalcentraal/api/brp/personen                              |
    And the object has the following 'invalidParams' data
    | code    | name       | reason                       |
    | integer | huisnummer | Waarde is geen geldig getal. |

    Examples:
    | huisnummer                            |
    | twee                                  |
    | 2e                                    |
    | <script>alert('hello world')</script> |

  @fout-case
  Scenario Outline: The huisnummer supplied does not fall between 1 and 99999
    When persons are searched with the following parameters
    | naam                    | waarde                                           |
    | type                    | ZoekMetStraatHuisnummerEnGemeenteVanInschrijving |
    | fields                  | burgerservicenummer                              |
    | straat                  | leyweg                                           |
    | huisnummer              | <huisnummer>                                     |
    | gemeenteVanInschrijving | 0518                                             |
    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: huisnummer.                  |
    | code     | paramsValidation                                            |
    | instance | /haalcentraal/api/brp/personen                              |
    And the object has the following 'invalidParams' data
    | code   | name       | reason   |
    | <code> | huisnummer | <reason> |

    Examples:
    | huisnummer | code    | reason                             |
    | 0          | minimum | Waarde is lager dan minimum 1.     |
    | 100000     | maximum | Waarde is hoger dan maximum 99999. |

Rule: a huisletter is a string of 1 letter (not case-sensitive)

  @fout-case
  Scenario Outline: An invalid value has been supplied for the 'huisletter' parameter
    When persons are searched with the following parameters
    | naam                    | waarde                                           |
    | type                    | ZoekMetStraatHuisnummerEnGemeenteVanInschrijving |
    | straat                  | leyweg                                           |
    | huisnummer              | 2                                                |
    | gemeenteVanInschrijving | 0518                                             |
    | huisletter              | <huisletter>                                     |
    | fields                  | burgerservicenummer                              |
    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: huisletter.                  |
    | code     | paramsValidation                                            |
    | instance | /haalcentraal/api/brp/personen                              |
    And the object has the following 'invalidParams' data
    | code    | name       | reason                                         |
    | pattern | huisletter | Waarde voldoet niet aan patroon ^[a-zA-Z]{1}$. |

    Examples:
    | huisletter                             |
    | <script>alert('hello world');</script> |
    | 1                                      |

Rule: A huisnummertoevoeging is a string of at least 1 and at most 4 characters. These characters may be:
      - lower-case letters (a-z)
      - upper-case letters (A-Z)
      - space ( ) and minus (-)

  @fout-case
  Scenario Outline: An invalid value has been supplied for the 'huisnummertoevoeging' parameter
    When persons are searched with the following parameters
    | naam                    | waarde                                           |
    | type                    | ZoekMetStraatHuisnummerEnGemeenteVanInschrijving |
    | straat                  | leyweg                                           |
    | huisnummer              | 2                                                |
    | gemeenteVanInschrijving | 0518                                             |
    | huisnummertoevoeging    | <huisnummertoevoeging>                           |
    | fields                  | burgerservicenummer                              |
    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: huisnummertoevoeging.        |
    | code     | paramsValidation                                            |
    | instance | /haalcentraal/api/brp/personen                              |
    And the object has the following 'invalidParams' data
    | code    | name                 | reason                                                 |
    | pattern | huisnummertoevoeging | Waarde voldoet niet aan patroon ^[a-zA-Z0-9 \-]{1,4}$. |

    Examples:
    | huisnummertoevoeging                   |
    | <script>alert('hello world');</script> |
    | 123.45                                 |

Rule: inclusiefOverledenPersonen is a boolean

  @fout-case
  Scenario Outline: An invalid value has been supplied for the 'inclusiefOverledenPersonen' parameter
    When persons are searched with the following parameters
    | naam                       | waarde                                           |
    | type                       | ZoekMetStraatHuisnummerEnGemeenteVanInschrijving |
    | straat                     | Afrikanerplein                                   |
    | huisnummer                 | 1                                                |
    | gemeenteVanInschrijving    | 0363                                             |
    | fields                     | burgerservicenummer                              |
    | inclusiefOverledenPersonen | <inclusief overleden personen>                   |
    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: inclusiefOverledenPersonen.  |
    | code     | paramsValidation                                            |
    | instance | /haalcentraal/api/brp/personen                              |
    And the object has the following 'invalidParams' data
    | code    | name                       | reason                  |
    | boolean | inclusiefOverledenPersonen | Waarde is geen boolean. |

    Examples:
    | inclusief overleden personen |
    |                              |
    | geen boolean                 |

Rule: Only the parameters specified for the search type supplied may be used

  @fout-case
  Scenario Outline: <titel>
    When persons are searched with the following parameters
    | naam                    | waarde                                           |
    | type                    | ZoekMetStraatHuisnummerEnGemeenteVanInschrijving |
    | straat                  | Afrikanerplein                                   |
    | huisnummer              | 1                                                |
    | gemeenteVanInschrijving | 0363                                             |
    | <parameter>             | <waarde>                                         |
    | fields                  | burgerservicenummer                              |
    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: <parameter>.                 |
    | code     | paramsValidation                                            |
    | instance | /haalcentraal/api/brp/personen                              |
    And the object has the following 'invalidParams' data
    | code         | name        | reason                      |
    | unknownParam | <parameter> | Parameter is niet verwacht. |

    Examples:
    | titel                                     | parameter   | waarde     |
    | zoeken met parameter uit ander zoektype   | voornamen   | Pietje     |
    | typfout in naam optionele parameter       | huisleter   | A          |
    | zoeken met niet gespecificeerde parameter | bestaatNiet | een waarde |