Technische uitwerking scenario opvragen zakelijkGerechtigden van een persoon

[kad-hebbim]

Hieronder wordt het scenario beschreven om de zakelijkgerechtigden op te vragen van een persoon. Daarbij wordt eerst gekeken hoe de huidige flow is vormgegeven (WAS) en daarna hoe de nieuwe flow er uit komt te zien (WORDT). Reden voor een aanpassing in deze flow is het feit dat bepaalde aanvragen nu in een timeout treden en dus niet op te vragen zijn. De nieuwe flow moet dit verhelpen.

In onderstaande flow wordt alleen 1 flow uitgewerkt, maar deze oplossing geldt dus ook voor de volgende endpoints:

• /kadasternietnatuurlijkpersonen/{identificatie}
• /kadasternietnatuurlijkpersonen?q=...
• /kadasternatuurlijkpersonen/{identificatie}
• /kadasternatuurlijkpersonen?q=...
• /kadastraalonroerendezaken?persoon__identificatie={identificatie}
• /kadastraalonroerendezaken?burgerservicenummer={bsn}

WAS:

1. Opvragen persoon:

Levert de persoonsgegevens, een lijst met KadastraalOnroerendeZaken en een lijst met ZakelijkGerechtigden op.

GET /kadasternietnatuurlijkpersonen/71291440

{
  "identificatie": "71291440",
  "domein": "NL.IMKAD.Persoon",
  "omschrijving": "Bankbedrijf",
  "kadastraalOnroerendeZaakIdentificaties": [
    "76870482570000",
    "76870488070000"
  ],
  "_links": {
    "self": {
      "href": "/kadasternietnatuurlijkpersonen/71291440"
    },
    "kadastraalOnroerendeZaken": [
      {
        "href": "/kadastraalonroerendezaken/{kadastraalOnroerendeZaakIdentificaties}",
        "templated": true
      }
    ],
        "zakelijkGerechtigden": [
        {
            "href": "/kadastraalonroerendezaken/76870482570000/zakelijkgerechtigden/20170719"
        },
        {
            "href": "/kadastraalonroerendezaken/76870488070000/zakelijkgerechtigden/30493369"
        }
    ]
    }
}

2. Opvragen zakelijkGerechtigde (loop):

Levert de zakelijkGerechtigde op.

• GET /kadastraalonroerendezaken/76870482570000/zakelijkgerechtigden/20170719

  {
      "identificatie": "20170719",
      "type": "eigenaar",
      "aanvangsdatum": "2018-10-11",
      "tenaamstelling": {
          "aandeel": {
              "noemer": 1,
              "teller": 1
          }
      },
      "persoon": {
          "identificatie": "71291440",
          "omschrijving": "Bankbedrijf",
          "type": "kadaster_niet_natuurlijk_persoon"
      },
      "_links": {
          "self": {
              "href": "/kadastraalonroerendezaken/76870482570000/zakelijkgerechtigden/20170719"
          },
          "persoon": {
              "href": "/kadasternietnatuurlijkpersonen/71291440"
          }
      }
  }

• GET /kadastraalonroerendezaken/76870482570000/zakelijkgerechtigden/30493369

  {
      "identificatie": "30493369",
      "type": "eigenaar",
      "aanvangsdatum": "2018-10-11",
      "tenaamstelling": {
          "aandeel": {
              "noemer": 1,
              "teller": 1
          }
      },
      "persoon": {
          "identificatie": "71291440",
          "omschrijving": "Bankbedrijf",
          "type": "kadaster_niet_natuurlijk_persoon"
      },
      "_links": {
          "self": {
              "href": "/kadastraalonroerendezaken/76870488070000/zakelijkgerechtigden/30493369"
          },
          "persoon": {
              "href": "/kadasternietnatuurlijkpersonen/71291440"
          }
      }
  }

WORDT:

1. Opvragen persoon:

Levert de persoonsgegevens & een lijst met KadastraalOnroerendeZaken op.

GET /kadasternietnatuurlijkpersonen/71291440

{
    "identificatie": "71291440",
    "domein": "NL.IMKAD.Persoon",
    "omschrijving": "Bedrijf x",
    "kadastraalOnroerendeZaakIdentificaties": [
        "76870482570000",
        "76870488070000"
    ],
    "_links": {
        "self": {
            "href": "/kadasternietnatuurlijkpersonen/71291440"
        },
        "kadastraalOnroerendeZaken": [
            {
                "href": "/kadastraalonroerendezaken/{kadastraalOnroerendeZaakIdentificaties}",
                "templated": true
            }
        ]
    }
}

2. Opvragen zakelijkGerechtigden (loop):

Levert alle zakelijkGerechtigden van een kadastraalOnroerendeZaak op. Hier kan ook gekozen worden om nog een type parameter mee te geven als de gebruiker alleen op zoek is naar zakelijkGerechtigden van een bepaald type (wat voorheen in de WAS situatie kon met de parameter zakelijkgerechtigde___type.

• GET /kadastraalonroerendezaken/76870482570000/zakelijkgerechtigden

  {
      "_links": {
          "self": {
              "href": "/kadastraalonroerendezaken/76870482570000/zakelijkgerechtigden"
          }
      },
      "_embedded": {
          "zakelijkGerechtigden": [
              {
                  "identificatie": "20170719",
                  "type": "eigenaar",
                  "aanvangsdatum": "2018-10-11",
                  "tenaamstelling": {
                      "aandeel": {
                          "noemer": 1,
                          "teller": 1
                      }
                  },
                  "persoon": {
                      "identificatie": "71291440",
                      "omschrijving": "Bankbedrijf",
                      "type": "kadaster_niet_natuurlijk_persoon"
                  },
                  "_links": {
                      "self": {
                          "href": "/kadastraalonroerendezaken/76870482570000/zakelijkgerechtigden/20170719"
                      },
                      "persoon": {
                          "href": "/kadasternietnatuurlijkpersonen/71291440"
                      }
                  }
              },
              {
                  "identificatie": "20170717",
                  "type": "erfpachter",
                  "aanvangsdatum": "2018-10-11",                
                  "tenaamstelling": {
                      "aandeel": {
                          "noemer": 2,
                          "teller": 1
                      },
                      "burgerlijkeStaatTenTijdeVanVerkrijging": {
                          "code": "2",
                          "waarde": "Ongehuwd en geen geregistreerd partnerschap"
                      }
                  },
                  "persoon": {
                      "identificatie": "71303564",
                      "omschrijving": "Christiaan de Goede",
                      "type": "kadaster_natuurlijk_persoon"
                  },
                  "_links": {
                      "self": {
                          "href": "/kadastraalonroerendezaken/76870482570000/zakelijkgerechtigden/20170717"
                      },
                      "persoon": {
                          "href": "/kadasternatuurlijkpersonen/71303564"
                      }
                  }
              }
          ]
      }
  }

• GET /kadastraalonroerendezaken/76870488070000/zakelijkgerechtigden

  {
    "_links": {
      "self": {
        "href": "/kadastraalonroerendezaken/76870488070000/zakelijkgerechtigden"
      }
    },
    "_embedded": {
      "zakelijkGerechtigden": [
              {
                  "identificatie": "30493369",
                  "type": "eigenaar",
                  "aanvangsdatum": "2018-10-11",
                  "tenaamstelling": {
                      "aandeel": {
                          "noemer": 1,
                          "teller": 1
                      }
                  },
                  "persoon": {
                      "identificatie": "71291440",
                      "omschrijving": "Bankbedrijf",
                      "type": "kadaster_niet_natuurlijk_persoon"
                  },
                  "_links": {
                      "self": {
                          "href": "/kadastraalonroerendezaken/76870488070000/zakelijkgerechtigden/30493369"
                      },
                      "persoon": {
                          "href": "/kadasternietnatuurlijkpersonen/71291440"
                      }
                  }
              }
          ]
      }
  }

3. Filter de zakelijkGerechtigden.

"zakelijkGerechtigden": [
{ "identificatie": "20170719" },
{ "identificatie": "30493369" },
]

Kanttekening

Dit is een breaking change; immers we leveren geen zakelijkGerechtigden meer bij bovenstaande endpoints.

[melsk-r]

Grotendeels is het mij duidelijk. Ik heb wel een opmerking en een vraag.

1. Misschien een beetje muggenziften maar uit de WORDT situatie leidt ik af dat het eerste JSON fragment in de WAS situatie eigenlijk als onderstaand zou moeten zijn:

{
  "identificatie": "71291440",
  "domein": "NL.IMKAD.Persoon",
  "omschrijving": "Bankbedrijf",
  "kadastraalOnroerendeZaakIdentificaties": [
    "76870482570000",
    "76870488070000"
  ],
  "_links": {
    "self": {
      "href": "/kadasternietnatuurlijkpersonen/71291440"
    },
    "kadastraalOnroerendeZaken": [
      {
        "href": "/kadastraalonroerendezaken/{kadastraalOnroerendeZaakIdentificaties}",
        "templated": true
      }
    ],
        "zakelijkGerechtigden": [
        {
            "href": "/kadastraalonroerendezaken/76870482570000/zakelijkgerechtigden/20170719"
        },
        {
            "href": "/kadastraalonroerendezaken/76870482570000/zakelijkgerechtigden/20170717"
        },
        {
            "href": "/kadastraalonroerendezaken/76870488070000/zakelijkgerechtigden/30493369"
        }
    ]
    }
}

2. Wat is de functie van step 3 in de WORDT situatie? Ik bedoel, hoe/waar/wanneer gebruik je dit filter?

3. Filter de zakelijkGerechtigden.

"zakelijkGerechtigden": [
{ "identificatie": "20170719" },
{ "identificatie": "30493369" },
]

[kad-hebbim]

Ziehier de antwoorden:

1. De response levert hier alleen de zakelijkgerechtigdeIdentificaties van deze persoon (71291440). ZakelijkgerechtigdeIdentificatie 20170717is gekoppeld aan een ander persoon en wordt dus niet teruggegeven.
2. Aangezien je nu de zakelijkgerechtigden gaat opvragen van een kadastraalonroerendezaak, krijg je dus alle zakelijkgerechtigden terug die gekoppeld zijn aan deze zaak. Daarom moet er nog een filtering plaatsvinden om alleen de zakelijkgerechtigden te pakken die betrekking hebben op de persoon (71291440) die je initieel bevraagt.

[kad-hebbim]

PR