HAALCENTRAAL English translation
BRP API / Personen / Features / niet-adellijk

As a municipality I want the correct and consistent aanschrijfwijze for my residents

# language: en

Feature: As a municipality I want the correct and consistent aanschrijfwijze for my residents
  The fields aanschrijfwijze.naam and aanschrijfwijze.aanspreekvorm for a person are filled by the provider, so that a person can be addressed unambiguously.
  
  The aanschrijfwijze is used as the first line or lines of the address on an envelope, or at the top left of a letter, directly above the address.
  
  The field aanschrijfwijze.aanspreekvorm is filled only for persons with a title of nobility and for persons who may use a courtesy title.
  
  Academic titles are not included when composing the aanschrijfwijze for the time being. Academic titles are not authentic data and have therefore been placed out of scope.
  

  When composing the aanschrijfwijze, the following is determined in order:
    1. Whether a courtesy title may be used. This is described in aanschrijfwijze/hoffelijkheidstitel.feature.
    2. If not, whether a title of nobility or predicate may be used. This is described in aanschrijfwijze/adellijk.feature.
    3. If not, the aanschrijfwijze is composed without a title of nobility or predicate. This is described in aanschrijfwijze/niet-adellijk.feature.
  
  The rules below apply only where NO title of nobility, predicate or courtesy title may be used.

  Rule: The name in aanschrijfwijze is composed on the basis of aanduiding naamgebruik as follows:
    | aanduiding naamgebruik | omschrijving                 | naam in aanschrijfwijze |
    | E                      | eigen naam                   | VL VV GN                |
    | P                      | partner naam                 | VL VP GP                |
    | V                      | partner naam voor eigen naam | VL VP GP-VV GN          |
    | N                      | partner naam na eigen naam   | VL VV GN-VP GP          |

    Meaning of the abbreviations in aanschrijfwijze:
    VL = initials
    VV = voorvoegselGeslachtsnaam (surname prefix)
    GN = surname
    VP = voorvoegselGeslachtsnaam of the partner
    GP = surname of the partner

    The following also applies:
    - spaces at the start or end of aanschrijfwijze.naam are removed
    - double spaces are removed from aanschrijfwijze.naam
    - a space before or after the "-" is removed from aanschrijfwijze.naam
    - the initials are included as described in voorletters.feature
    - the first name component in aanschrijfwijze.naam begins with a capital letter

    Scenario: A name without a voorvoegsel and no partner
      Given the person with citizen service number '000000012' has the following data
      | naam                           | waarde    |
      | voornamen (02.10)              | Anna Özil |
      | geslachtsnaam (02.40)          | Groenen   |
      | aanduiding naamgebruik (61.10) | E         |
      And the person has never had a current or dissolved marriage or partnership
      When persons are searched with the following parameters
      | naam                | waarde                          |
      | type                | RaadpleegMetBurgerservicenummer |
      | burgerservicenummer | 000000012                       |
      | fields              | adressering.aanschrijfwijze     |
      Then the response has a person with only the following 'adressering' data
      | naam                 | waarde       |
      | aanschrijfwijze.naam | A.Ö. Groenen |

    Scenario Outline: A name with a voorvoegsel and no partner
      Given the person with citizen service number '000000024' has the following data
      | naam                           | waarde        |
      | voornamen (02.10)              | <voornamen>   |
      | voorvoegsel (02.30)            | <voorvoegsel> |
      | geslachtsnaam (02.40)          | Groenen       |
      | aanduiding naamgebruik (61.10) | E             |
      And the person has never had a current or dissolved marriage or partnership
      When persons are searched with the following parameters
      | naam                | waarde                          |
      | type                | RaadpleegMetBurgerservicenummer |
      | burgerservicenummer | 000000024                       |
      | fields              | adressering.aanschrijfwijze     |
      Then the response has a person with only the following 'adressering' data
      | naam                 | waarde                    |
      | aanschrijfwijze.naam | <naam in aanschrijfwijze> |

      Examples:
      | voornamen      | voorvoegsel | naam in aanschrijfwijze |
      | Bert Philip    | van         | B.P. van Groenen        |
      | Carla Theodora | Van         | C.T. Van Groenen        |
      | Dirk-Willem    | in het      | D. in het Groenen       |
      | Elise Q        | In Den      | E.Q In Den Groenen      |

    Scenario Outline: A person with a partner, no voorvoegsel in the name of the person or the partner
      Given the person with citizen service number '000000036' has the following data
      | naam                           | waarde                   |
      | voornamen (02.10)              | <voornamen>              |
      | geslachtsnaam (02.40)          | Groenen                  |
      | aanduiding naamgebruik (61.10) | <aanduiding naamgebruik> |
      And the person has a 'partner' with the following data
      | naam                  | waarde  |
      | geslachtsnaam (02.40) | Groenlo |
      When persons are searched with the following parameters
      | naam                | waarde                          |
      | type                | RaadpleegMetBurgerservicenummer |
      | burgerservicenummer | 000000036                       |
      | fields              | adressering.aanschrijfwijze     |
      Then the response has a person with only the following 'adressering' data
      | naam                 | waarde                    |
      | aanschrijfwijze.naam | <naam in aanschrijfwijze> |

      Examples:
      | voornamen      | aanduiding naamgebruik | naam in aanschrijfwijze |
      | Anna Özil      | E                      | A.Ö. Groenen            |
      | Bert Philip    | P                      | B.P. Groenlo            |
      | Carla Theodora | V                      | C.T. Groenlo-Groenen    |
      | Dirk-Willem    | N                      | D. Groenen-Groenlo      |
      
    Scenario Outline: A person with a partner, with a voorvoegsel in the name of the person and no voorvoegsel in the name of the partner
      Given the person with citizen service number '000000048' has the following data
      | naam                           | waarde                   |
      | voornamen (02.10)              | <voornamen>              |
      | voorvoegsel (02.30)            | van                      |
      | geslachtsnaam (02.40)          | Velzen                   |
      | aanduiding naamgebruik (61.10) | <aanduiding naamgebruik> |
      And the person has a 'partner' with the following data
      | naam                  | waarde  |
      | geslachtsnaam (02.40) | Groenlo |
      When persons are searched with the following parameters
      | naam                | waarde                          |
      | type                | RaadpleegMetBurgerservicenummer |
      | burgerservicenummer | 000000048                       |
      | fields              | adressering.aanschrijfwijze     |
      Then the response has a person with only the following 'adressering' data
      | naam                 | waarde                    |
      | aanschrijfwijze.naam | <naam in aanschrijfwijze> |

      Examples:
      | voornamen | aanduiding naamgebruik | naam in aanschrijfwijze |
      | Elise Q   | E                      | E.Q van Velzen          |
      | Fred      | P                      | F. Groenlo              |
      | Geraldine | V                      | G. Groenlo-van Velzen   |
      | Henk      | N                      | H. van Velzen-Groenlo   |
      
    Scenario Outline: A person with a partner, no voorvoegsel in the name of the person and a voorvoegsel in the name of the partner
      Given the person with citizen service number '000000061' has the following data
      | naam                           | waarde                   |
      | voornamen (02.10)              | <voornamen>              |
      | geslachtsnaam (02.40)          | <geslachtsnaam>          |
      | aanduiding naamgebruik (61.10) | <aanduiding naamgebruik> |
      And the person has a 'partner' with the following data
      | naam                  | waarde                  |
      | voorvoegsel (02.30)   | <voorvoegsel partner>   |
      | geslachtsnaam (02.40) | <geslachtsnaam partner> |
      When persons are searched with the following parameters
      | naam                | waarde                          |
      | type                | RaadpleegMetBurgerservicenummer |
      | burgerservicenummer | 000000061                       |
      | fields              | adressering.aanschrijfwijze     |
      Then the response has a person with only the following 'adressering' data
      | naam                 | waarde                    |
      | aanschrijfwijze.naam | <naam in aanschrijfwijze> |

      Examples:
      | voornamen | geslachtsnaam | aanduiding naamgebruik | voorvoegsel partner | geslachtsnaam partner | naam in aanschrijfwijze |
      | Iris      | Groenen       | E                      | Van Den             | Berg                  | I. Groenen              |
      | Joris     | Groenen       | P                      | Van Den             | Berg                  | J. Van Den Berg         |
      | Karin     | Groenen       | V                      | Van Den             | Berg                  | K. Van Den Berg-Groenen |
      | Leo       | Groenen       | N                      | Van Den             | Berg                  | L. Groenen-Van Den Berg |
      
    Scenario Outline: A person with a partner, with a voorvoegsel in the name of the person and a voorvoegsel in the name of the partner
      Given the person with citizen service number '000000073' has the following data
      | naam                           | waarde                   |
      | voornamen (02.10)              | <voornamen>              |
      | voorvoegsel (02.30)            | <voorvoegsel>            |
      | geslachtsnaam (02.40)          | <geslachtsnaam>          |
      | aanduiding naamgebruik (61.10) | <aanduiding naamgebruik> |
      And the person has a 'partner' with the following data
      | naam                  | waarde                  |
      | voorvoegsel (02.30)   | <voorvoegsel partner>   |
      | geslachtsnaam (02.40) | <geslachtsnaam partner> |
      When persons are searched with the following parameters
      | naam                | waarde                          |
      | type                | RaadpleegMetBurgerservicenummer |
      | burgerservicenummer | 000000073                       |
      | fields              | adressering.aanschrijfwijze     |
      Then the response has a person with only the following 'adressering' data
      | naam                 | waarde                    |
      | aanschrijfwijze.naam | <naam in aanschrijfwijze> |

      Examples:
      | voornamen | voorvoegsel | geslachtsnaam | aanduiding naamgebruik | voorvoegsel partner | geslachtsnaam partner | naam in aanschrijfwijze    |
      | Marion    | van         | Velzen        | E                      | Van Den             | Berg                  | M. van Velzen              |
      | Nico      | van         | Velzen        | P                      | Van Den             | Berg                  | N. Van Den Berg            |
      | Odette    | van         | Velzen        | V                      | Van Den             | Berg                  | O. Van Den Berg-van Velzen |
      | Piet      | van         | Velzen        | N                      | Van Den             | Berg                  | P. van Velzen-Van Den Berg |

    Scenario Outline: the person has a name chain (no voornamen)
      Given the person with citizen service number '000000085' has the following data
      | naam                           | waarde           |
      | geslachtsnaam (02.40)          | Ali bin Mohammed |
      | aanduiding naamgebruik (61.10) | <naamgebruik>    |
      And the person has a 'partner' with the following data
      | naam                  | waarde |
      | voorvoegsel (02.30)   | van    |
      | geslachtsnaam (02.40) | Velzen |
      When persons are searched with the following parameters
      | naam                | waarde                          |
      | type                | RaadpleegMetBurgerservicenummer |
      | burgerservicenummer | 000000085                       |
      | fields              | adressering.aanschrijfwijze     |
      Then the response has a person with only the following 'adressering' data
      | naam                 | waarde                    |
      | aanschrijfwijze.naam | <naam in aanschrijfwijze> |

      Examples:
      | naamgebruik | naam in aanschrijfwijze     |
      | E           | Ali bin Mohammed            |
      | P           | Van Velzen                  |
      | V           | Van Velzen-Ali bin Mohammed |
      | N           | Ali bin Mohammed-van Velzen |