HAALCENTRAAL English translation
BRP API / Personen / Features / overzicht

supplying the aanhef of a person

# language: en

@info-api
Feature: supplying the aanhef of a person
  As a consumer
  I want to be able to request the aanhef (the introductory sentence of a letter or email) for a person
  so that I can address the person correctly and consistently

  The following abbreviations are used in this specification:
  - GA = "Geachte mevrouw", "Geachte heer" or "Geachte VL" depending on the gender
  - VL = initials
  - VV = surname prefix.
  - GN = surname
  - VP = surname prefix of the partner
  - GP = surname of the partner

  Rule: the aanhef of a person without a partner is composed as follows: GA VV GN. Where a person has no voorvoegsel, the superfluous space is not included

    Scenario Outline: a person with voornamen, geslachtsnaam and no voorvoegsel has geslacht <voorbeeld>
      Given the person 'Jo'
      * has the following data
        | naam                        | waarde     |
        | geslachtsaanduiding (04.10) | <geslacht> |
        | voornamen (02.10)           | Jo Rene    |
        | geslachtsnaam (02.40)       | Groenen    |
      When 'adressering.aanhef' is requested for 'Jo'
      Then 'Jo' has the following 'adressering' data
        | aanhef   |
        | <aanhef> |

      Examples:
        | voorbeeld | geslacht | aanhef                  |
        | man       | M        | Geachte heer Groenen    |
        | vrouw     | V        | Geachte mevrouw Groenen |
        | onbekend  | O        | Geachte J.R. Groenen    |

  Rule: the voorvoegsel begins with a capital letter, except where one or more initials precede it (gender O)

    Scenario Outline: a person with voornamen, voorvoegsel and geslachtsnaam has geslacht <voorbeeld>
      Given the person 'Robin'
      * has the following data
        | naam                        | waarde      |
        | geslachtsaanduiding (04.10) | <geslacht>  |
        | voornamen (02.10)           | Robin Melle |
        | voorvoegsel (02.30)         | van         |
        | geslachtsnaam (02.40)       | Puffelen    |
      When 'adressering.aanhef' is requested for 'Robin'
      Then 'Robin' has the following 'adressering' data
        | aanhef   |
        | <aanhef> |

      Examples:
        | voorbeeld | geslacht | aanhef                       |
        | man       | M        | Geachte heer Van Puffelen    |
        | vrouw     | V        | Geachte mevrouw Van Puffelen |
        | onbekend  | O        | Geachte R.M. van Puffelen    |

  Rule: the aanhef of a person with a (former) partner is composed on the basis of aanduiding naamgebruik as follows
    | aanduiding naamgebruik | aanhef         |
    | E                      | GA VV GN       |
    | P                      | GA VP GP       |
    | V                      | GA VP GP-VV GN |
    | N                      | GA VV GN-VP GP |

    Scenario Outline: a person with a partner has aanduiding naamgebruik '<naamgebruik>'
      Given the person 'Joan'
      And has the following data
        | naam                           | waarde          |
        | geslachtsaanduiding (04.10)    | V               |
        | voorvoegsel (02.30)            | <voorvoegsel>   |
        | geslachtsnaam (02.40)          | <geslachtsnaam> |
        | aanduiding naamgebruik (61.10) | <naamgebruik>   |
      And the person 'Jan' with citizen service number '000000143'
      And has the following data
        | naam                  | waarde                  |
        | voorvoegsel (02.30)   | <partner voorvoegsel>   |
        | geslachtsnaam (02.40) | <partner geslachtsnaam> |
      And 'Joan' and 'Jan' are <verbintenis> to each other
      When 'adressering.aanhef' is requested for 'Joan'
      Then 'Joan' has the following 'adressering' data
        | aanhef   |
        | <aanhef> |

      Examples:
        | naamgebruik | voorvoegsel | geslachtsnaam | partner voorvoegsel | partner geslachtsnaam | aanhef                                 | verbintenis                 |
        | E           | in het      | Veld          | van                 | Velzen                | Geachte mevrouw In het Veld            | gehuwd                                   |
        | E           |             | Groenen       |                     | Groenink              | Geachte mevrouw Groenen                | een geregistreerd partnerschap aangegaan |
        | P           | in het      | Veld          | van                 | Velzen                | Geachte mevrouw Van Velzen             | gehuwd                                   |
        | P           |             | Groenen       |                     | Groenink              | Geachte mevrouw Groenink               | een geregistreerd partnerschap aangegaan |
        | V           | in het      | Veld          | van                 | Velzen                | Geachte mevrouw Van Velzen-in het Veld | gehuwd                                   |
        | V           |             | Groenen       |                     | Groenink              | Geachte mevrouw Groenink-Groenen       | een geregistreerd partnerschap aangegaan |
        | N           | in het      | Veld          | van                 | Velzen                | Geachte mevrouw In het Veld-van Velzen | gehuwd                                   |
        | N           |             | Groenen       |                     | Groenink              | Geachte mevrouw Groenen-Groenink       | een geregistreerd partnerschap aangegaan |