HAALCENTRAAL English translation
BRP API / Personen / Features / overzicht

search for persons by postal code and house number

# language: en
Feature: search for persons by postal code and house number

  As a consumer
  I want to find persons by supplying the postal code and house number of the address at which they are registered

  Background:
    Given address 'A1'
      | postcode (11.60) | huisnummer (11.20) |
      |           2628HJ |                  2 |
    And address 'A2'
      | postcode (11.60) | huisnummer (11.20) | huisletter (11.30) |
      |           2628HJ |                  2 | A                  |
    And address 'A3'
      | postcode (11.60) | huisnummer (11.20) | huisnummertoevoeging (11.40) |
      |           2628HJ |                  2 | III                          |
    And address 'A4'
      | postcode (11.60) | huisnummer (11.20) | aanduiding bij huisnummer (11.50) |
      |           2628HJ |                  2 | to                                |
    And the person 'Jan'
    * 'Jan' was registered at address 'A1' 5 years ago
    And the person 'Piet'
    * 'Piet' was registered at address 'A2' 4 years ago
    And the person 'Kees'
    * 'Kees' was registered at address 'A3' 3 years ago
    And the person 'Gerda'
    * 'Gerda' was registered at address 'A4' 2 years ago

  Rule: persons are found where the postal code and house number of the address at which they are registered match the postal code (not case-sensitive) and house number supplied

    Scenario Outline: the postcode and huisnummer of the address of persons match the postcode (<sub-titel>) and huisnummer supplied
      When 'burgerservicenummer' is requested for persons searched by postal code '<postcode>' and house number '2'
      Then 'Jan, Piet, Kees en Gerda' are found

      Examples:
        | postcode | sub-titel                                                             |
        |   2628HJ | letters zijn hoofdletters                                             |
        |   2628hj | letters zijn kleine letters                                           |
        |  2628 HJ | spatie tussen de cijfers en hoofdletters                              |
        |  2628 hj | spatie tussen de cijfers en kleine letters                            |
        |  2628 Hj | spatie tussen de cijfers en letters (zowel hoofd- als kleine letters) |

  Rule: the optional 'huisletter' parameter (not case-sensitive) can be used to narrow the search criteria

    Scenario Outline: the postcode, huisnummer and huisletter of the address of persons match the postcode, huisnummer and huisletter supplied
      When 'burgerservicenummer' is requested for persons searched by postal code '2628HJ' and house number '2' and parameters
        | huisletter   |
        | <huisletter> |
      Then 'Piet' is found

      Examples:
        | huisletter |
        | A          |
        | a          |

  Rule: the optional 'huisnummertoevoeging' parameter (not case-sensitive) can be used to narrow the search criteria

    Scenario Outline: the postcode, huisnummer and huisnummertoevoeging of the address of persons match the postcode, huisnummer and huisnummertoevoeging supplied
      When 'burgerservicenummer' is requested for persons searched by postal code '2628HJ' and house number '2' and parameters
        | huisnummertoevoeging   |
        | <huisnummertoevoeging> |
      Then 'Kees' is found

      Examples:
        | huisnummertoevoeging |
        | III                  |
        | iii                  |
        | Iii                  |