fixed merge conflicts

DateOfBirth and Birthdate are always formatted YYYY-MM-DD.
Merge pull request 'OVPAY-2002 - Added YAML for Sendgrid OAS3.' (#22 ) from feature/OVPAY-2002 into develop
2025-09-13 21:34:06 +02:00 · 2025-09-12 12:53:42 +02:00 · 2025-09-05 12:40:33 +00:00 · 2025-09-04 12:18:35 +02:00 · 2025-09-01 12:29:24 +00:00 · 2025-09-01 13:47:11 +02:00
9 changed files with 2645 additions and 2025 deletions
--- a/src/openapi/customers/SE-customers.yaml
+++ b/src/openapi/customers/SE-customers.yaml
@ -17,10 +17,10 @@ paths:
    get:
      tags:
        - Customers
-      summary: Get a single customer profile based on search parameters
+      summary: Get a customer profile based on search parameters
      description: |
-        Get a single customer profile based on search parameters. Only returns a profile if a single result matches 
-        the parameters; when multiple results are found, additional search parameters are required to disambiguate.
+        Get a profile based on search parameters. Only returns a profile if a single result matches for a customer
+        the parameters; when multiple results are found, additional search parameters are required to disambiguate. If role is klantenservice, multiple customers can be returned.
      parameters:
        - name: customerProfileId
          in: query
@ -140,7 +140,7 @@ paths:
          content:
            application/json:
              schema:
-                $ref: "#/components/schemas/CustomersResponse"
+                $ref: "#/components/schemas/CustomersResponseList"
        "404":
          description: No customer found
          content:
@ -166,6 +166,178 @@ paths:
                  "detail": "Meer dan 1 klantprofiel gevonden. Verfijn je zoekcriteria.",
                  "instance": "555d00b5-bc3f-4591-949b-479e76d49ea7",
                }
+    post: 
+      tags:
+        - Customers
+      parameters:     
+        - name: X-HTM-ROLE-HEADER
+          in: header
+          schema:
+            type: string
+            example: Customer
+          required: false
+          description: The role of the HTM employee in the case of the SMP, in this case the call can only be done through the SMP
+      summary: Create a customer profile.
+      description: Create a customer profile in the ABT database with status ACTIVE and debtorStatus Inactive with a start date based on the timestamp of this post call. 
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/unavailable"
+            examples:
+              minimalCustomerProfile:
+                value:
+                  {
+                    "person": {
+                      "emailAddress": "j.jansen@hatseflats.nl"
+                    }
+                  }
+              fullCustomerProfile:
+                value:
+                  {
+                    "customerPreference": {
+                      "languageId": 1
+                    },
+                    "person": {
+                      "birthname": "Jan",
+                      "surname": "Jansen",
+                      "prefix": "dhr",
+                      "suffix": "jr",
+                      "dateOfBirth": "1970-01-01",
+                      "emailAddress": "j.jansen@hatseflats.nl",
+                      "addresses": [
+                        {
+                          "street": "Laan van Meerdervoort",
+                          "houseNumber": 5,
+                          "houseNumberSuffix": "B",
+                          "postalCode": "2500AA",
+                          "city": "Den Haag",
+                          "country": "NL",
+                          "isPreferred": true,
+                          "addressTypeId": 1
+                        },
+                        {
+                          "street": "Beeklaan",
+                          "houseNumber": 30,
+                          "houseNumberSuffix": "B",
+                          "postalCode": "2500AA",
+                          "city": "Den Haag",
+                          "country": "NL",
+                          "isPreferred": false,
+                          "addressTypeId": 2
+                        }
+                      ],
+                      "phones": [
+                        {
+                          "number": "6123456789",
+                          "countryCode": "0031",
+                          "phoneTypeId": 1,
+                          "isPreferred": true
+                        },
+                        {
+                          "number": "7012345678",
+                          "countryCode": "0031",
+                          "phoneTypeId": 2,
+                          "isPreferred": false
+                        }
+                      ]
+                    }
+                  }
+      responses: 
+        "201":
+          description: Created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/CustomersResponse"
+    patch:
+      tags:
+        - Customers
+      parameters:
+        - name: X-HTM-JWT-AUTH-HEADER
+          in: header
+          schema:
+            type: string
+            example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
+          required: false
+          description: The JWT of a customer in case of touchpoint were customer logs in themselves
+        - name: X-HTM-CUSTOMER-PROFILE-ID-HEADER
+          in: header
+          schema:
+            type: string
+            example: feaaef83-a551-4283-8419-340b1ada3b55
+          required: false
+          description: The customerProfileId of a customer in the case of the SMP
+        - name: X-HTM-ROLE-HEADER
+          in: header
+          schema:
+            type: string
+            example: Customer
+          required: false
+          description: The role of the HTM employee in the case of the SMP
+      summary: Update a customer profile
+      description: Update a customer profile based on the sub from the JWT, or customerProfileId in case of SMP
+      requestBody:      
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/unavailable"
+            examples:
+              patchCustomer:
+                value:
+                  {
+                    "person": {
+                      "birthname": "Jan",
+                      "surname": "Jansen",
+                      "prefix": "dhr",
+                      "suffix": "jr",
+                      "dateOfBirth": "1970-01-01",
+                      "addresses": [
+                        {
+                          "addressId": 2,
+                          "street": "Laan van Meerdervoort",
+                          "houseNumber": 5,
+                          "postalCode": "2500AA",
+                          "city": "Den Haag",
+                          "country": "NL"
+                        },
+                        {
+                          "addressId": 1,
+                          "street": "Beeklaan",
+                          "houseNumber": 30,
+                          "houseNumberSuffix": "B",
+                          "postalCode": "2500AA",
+                          "city": "Den Haag",
+                          "country": "NL",
+                          "addressTypeId": 2
+                        }
+                      ],
+                      "phones": [
+                        {
+                          "phoneId": 1,
+                          "number": "6123456789",
+                          "countryCode": "0031",
+                          "phoneTypeId": 1,
+                          "isPreferred": true
+                        },
+                        {
+                          "phoneId": 2,
+                          "number": "7012345678",
+                          "countryCode": "0031",
+                          "phoneTypeId": 2,
+                          "isPreferred": false
+                        }
+                      ]
+                    }
+                  } 
+      responses: 
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/CustomersResponse"
+    
  /customers/tokens:
    get:
      tags:
@ -310,6 +482,7 @@ paths:
                                "birthdate": null,
                                "photo": null,
                              },
+                            "gboAgeProfile": null,
                            "_links":
                              {
                                "self":
@ -391,6 +564,7 @@ paths:
                                "birthdate": null,
                                "photo": null,
                              },                            
+                            "gboAgeProfile": null,
                            "_links":
                              {
                                "self":
@ -506,6 +680,13 @@ paths:
                                    "lastChangeDate": "2024-08-24T14:15:22Z",
                                  },
                              },
+                            "gboAgeProfile":
+                              {
+                                "gboAgeProfileId": 1,
+                                "name": "Kind (4 t/m 11 jaar)",
+                                "ageFromInclusive": 4,
+                                "ageToInclusive": 11
+                              },
                            "_links":
                              {
                                "self":
@ -596,6 +777,13 @@ paths:
                                  },
                                "photo": null,
                              },
+                            "gboAgeProfile":
+                              {
+                                "gboAgeProfileId": 1,
+                                "name": "Kind (4 t/m 11 jaar)",
+                                "ageFromInclusive": 4,
+                                "ageToInclusive": 11
+                              },
                            "_links":
                              {
                                "self":
@ -704,6 +892,13 @@ paths:
                                    "lastChangeDate": "2024-08-24T14:15:22Z",
                                  },
                              },
+                              "gboAgeProfile":
+                              {
+                                "gboAgeProfileId": 1,
+                                "name": "Kind (4 t/m 11 jaar)",
+                                "ageFromInclusive": 4,
+                                "ageToInclusive": 11
+                              },
                            "_links":
                              {
                                "self":
@ -753,8 +948,8 @@ paths:
                            },
                        },
                    }
-                ? Token list with every status for tokenTypeId = 2, role = KlantenService
-                : summary: Token list with every status for tokenTypeId = 2, role = KlantenService
+                Token list with every status for tokenTypeId = 2, role = KlantenService:
+                  summary: Token list with every status for tokenTypeId = 2, role = KlantenService
                  description: Token list with every status for tokenTypeId = 2, role = KlantenService
                  value:
                    {
@ -799,6 +994,7 @@ paths:
                                "birthdate": null,
                                "photo": null,
                              },
+                            "gboAgeProfile": null,
                          },
                          {
                            "customerProfileId": 18,
@ -819,6 +1015,7 @@ paths:
                                "birthdate": null,
                                "photo": null,
                              },
+                            "gboAgeProfile": null
                          },
                          {
                            "customerProfileId": 132,
@ -839,6 +1036,7 @@ paths:
                                "birthdate": null,
                                "photo": null,
                              },
+                            "gboAgeProfile": null
                          },
                          {
                            "customerProfileId": 166,
@ -862,6 +1060,7 @@ paths:
                                "birthdate": null,
                                "photo": null,
                              },
+                            "gboAgeProfile": null
                          },
                          {
                            "customerProfileId": 166,
@ -882,6 +1081,7 @@ paths:
                                "birthdate": null,
                                "photo": null,
                              },
+                            "gboAgeProfile": null
                          },
                          {
                            "customerProfileId": 1,
@ -902,6 +1102,7 @@ paths:
                                "birthdate": null,
                                "photo": null,
                              },
+                            "gboAgeProfile": null
                          },
                        ],
                      _links:
@ -1001,6 +1202,7 @@ paths:
                          "ePurse": null,
                          "personalAccountData":
                            { "name": null, "birthdate": null, "photo": null },
+                          "gboAgeProfile": null,
                          "_links":
                            {
                              "self":
@ -1078,6 +1280,7 @@ paths:
                            },
                          "personalAccountData":
                            { "name": null, "birthdate": null, "photo": null },
+                          "gboAgeProfile": null,
                          "_links":
                            {
                              "self":
@ -1228,6 +1431,7 @@ paths:
                          "ePurse": null,
                          "personalAccountData":
                            { "name": null, "birthdate": null, "photo": null },
+                          "gboAgeProfile": null,
                          "_links":
                            {
                              "self":
@ -1297,6 +1501,7 @@ paths:
                            },
                          "personalAccountData":
                            { "name": null, "birthdate": null, "photo": null },
+                          "gboAgeProfile": null,
                          "_links":
                            {
                              "self":
@ -1366,6 +1571,7 @@ paths:
                          "ePurse": null,
                          "personalAccountData":
                            { "name": null, "birthdate": null, "photo": null },
+                          "gboAgeProfile": null,
                          "_links":
                            {
                              "self":
@ -1552,6 +1758,7 @@ paths:
                          "ePurse": null,
                          "personalAccountData":
                            { "name": null, "birthdate": null, "photo": null },
+                          "gboAgeProfile": null,
                          "_links":
                            {
                              "self":
@ -1614,6 +1821,7 @@ paths:
                          "ePurse": null,
                          "personalAccountData":
                            { "name": null, "birthdate": null, "photo": null },
+                          "gboAgeProfile": null,
                          "_links":
                            {
                              "self":
@ -1775,6 +1983,7 @@ paths:
                          "ePurse": null,
                          "personalAccountData":
                            { "name": null, "birthdate": null, "photo": null },
+                          "gboAgeProfile": null,
                          "_links":
                            {
                              "self":
@ -1844,6 +2053,7 @@ paths:
                            },
                          "personalAccountData":
                            { "name": null, "birthdate": null, "photo": null },
+                          "gboAgeProfile": null,
                          "_links":
                            {
                              "self":
@ -1913,6 +2123,7 @@ paths:
                          "ePurse": null,
                          "personalAccountData":
                            { "name": null, "birthdate": null, "photo": null },
+                          "gboAgeProfile": null,
                          "_links":
                            {
                              "self":
@ -2130,11 +2341,13 @@ paths:
                          "tokenStatus":
                            { "tokenStatusId": 2, "name": "Active" },
                          "expirationDate": "2028-02-01",
+                          "productInstances": [],
                          "replacedByTokenId": null,
                          "autoReloadRegistration": null,
                          "ePurse": null,
                          "personalAccountData":
                            { "name": null, "birthdate": null, "photo": null },
+                          "gboAgeProfile": null
                        },
                      "newOvPayToken":
                        {
@ -2145,11 +2358,13 @@ paths:
                          "alias": null,
                          "tokenStatus": null,
                          "expirationDate": "2028-02-01",
+                          "productInstances": [],
                          "replacedByTokenId": null,
                          "autoReloadRegistration": null,
                          "ePurse": null,
                          "personalAccountData":
                            { "name": null, "birthdate": null, "photo": null },
+                          "gboAgeProfile": null
                        },
                      "isTransferable": true,
                      "transferableObjects":
@ -2162,6 +2377,7 @@ paths:
                          "ePurse": true,
                          "personalAccountData":
                            { "name": true, "birthdate": true, "photo": true },
+                          "gboAgeProfile": true
                        },
                      "_links":
                        {
@ -2185,26 +2401,60 @@ paths:
                          "tokenStatus":
                            { "tokenStatusId": 2, "name": "Active" },
                          "expirationDate": "2028-02-01",
+                          "productInstances": [
+                            {
+                              "productId": 1,
+                              "name": "HTM 90% Korting EMV",
+                              "status": "Active",
+                              "isRenewable": true,
+                              "productCategory": {
+                                "productCategoryId": 1,
+                                "name": "Kortingsabonnement"
+                              },
+                              "fromInclusive": "2025-11-25T13:25:00+01:00",
+                              "untilInclusive": "2025-12-25T03:59:59+01:00",
+                              "orderId": "501B17EF-36C4-4039-B92C-6517969B464E",
+                              "orderLineId": "38B17EF-36C4-4039-B92C-4817969B464E",
+                              "contractId": "56B17EF-C436-9043-B76C-481797WEB464F",
+                              "_links": {
+                                "self": {
+                                  "href": "https://api.integratielaag.nl/abt/touchpoint/1.0/customers/tokens/1/productinstances/1",
+                                  "method": "GET"
+                                },
+                                "get_order": {
+                                  "href": "https://api.integratielaag.nl/abt/touchpoint/1.0/orders/501B17EF-36C4-4039-B92C-6517969B464E",
+                                  "method": "GET"
+                                },
+                                "get_contract": {
+                                  "href": "https://api.integratielaag.nl/abt/touchpoint/1.0/customers/contracts/56B17EF-C436-9043-B76C-481797WEB464F",
+                                  "method": "GET"
+                                }
+                              }
+                            }
+                          ],
                          "replacedByTokenId": null,
                          "autoReloadRegistration": null,
                          "ePurse": null,
                          "personalAccountData":
                            { "name": null, "birthdate": null, "photo": null },
+                          "gboAgeProfile": null
                        },
                      "newOvPayToken":
                        {
                          "customerProfileId": null,
                          "ovPayTokenId": null,
                          "xTat": "32089cc8-d187-47ff-a3a9-5c2558def811",
-                          "tokenType": { "tokenTypeId": 1, "name": "EMV" },
+                          "tokenType": { "tokenTypeId": 2, "name": "OV-pas physical" },
                          "alias": null,
                          "tokenStatus": null,
                          "expirationDate": "2028-02-01",
+                          "productInstances": [],
                          "replacedByTokenId": null,
                          "autoReloadRegistration": null,
                          "ePurse": null,
                          "personalAccountData":
                            { "name": null, "birthdate": null, "photo": null },
+                          "gboAgeProfile": null
                        },
                      "isTransferable": false,
                      "transferableObjects":
@ -2217,6 +2467,7 @@ paths:
                          "ePurse": true,
                          "personalAccountData":
                            { "name": true, "birthdate": true, "photo": true },
+                          "gboAgeProfile": true,
                        },
                      "_links": {},
                    }
@ -2234,11 +2485,13 @@ paths:
                          "tokenStatus":
                            { "tokenStatusId": 2, "name": "Active" },
                          "expirationDate": "2028-02-01",
+                          "productInstances": [],
                          "replacedByTokenId": null,
                          "autoReloadRegistration": null,
                          "ePurse": null,
                          "personalAccountData":
                            { "name": null, "birthdate": null, "photo": null },
+                          "gboAgeProfile": null
                        },
                      "newOvPayToken":
                        {
@ -2249,11 +2502,13 @@ paths:
                          "alias": null,
                          "tokenStatus": null,
                          "expirationDate": "2028-02-01",
+                          "productInstances": [],
                          "replacedByTokenId": null,
                          "autoReloadRegistration": null,
                          "ePurse": null,
                          "personalAccountData":
                            { "name": null, "birthdate": null, "photo": null },
+                          "gboAgeProfile": null
                        },
                      "isTransferable": false,
                      "transferableObjects":
@ -2266,6 +2521,7 @@ paths:
                          "ePurse": true,
                          "personalAccountData":
                            { "name": true, "birthdate": true, "photo": true },
+                          "gboAgeProfile": true,
                        },
                      "_links": {},
                    }
@ -2282,6 +2538,7 @@ paths:
                          "tokenStatus":
                            { "tokenStatusId": 2, "name": "Active" },
                          "expirationDate": "2028-02-01",
+                          "productInstances": [],
                          "replacedByTokenId": 2,
                          "autoReloadRegistration": null,
                          "ePurse": null,
@ -2318,6 +2575,13 @@ paths:
                                  "lastChangeDate": "2024-08-24T14:15:22Z",
                                },
                            },
+                          "gboAgeProfile":
+                            {
+                              "gboAgeProfileId": 1,
+                              "name": "Kind (4 t/m 11 jaar)",
+                              "ageFromInclusive": 4,
+                              "ageToInclusive": 11
+                            }
                        },
                      "newOvPayToken":
                        {
@ -2328,11 +2592,13 @@ paths:
                          "alias": null,
                          "tokenStatus": null,
                          "expirationDate": "2028-02-01",
+                          "productInstances": [],
                          "replacedByTokenId": null,
                          "autoReloadRegistration": null,
                          "ePurse": null,
                          "personalAccountData":
                            { "name": null, "birthdate": null, "photo": null },
+                          "gboAgeProfile": null
                        },
                      "isTransferable": false,
                      "transferableObjects":
@ -2349,6 +2615,7 @@ paths:
                              "birthdate": false,
                              "photo": false,
                            },
+                          "gboAgeProfile": true,
                        },
                      "_links": {},
                    }
@ -2365,6 +2632,7 @@ paths:
                          "tokenStatus":
                            { "tokenStatusId": 2, "name": "Active" },
                          "expirationDate": "2028-02-01",
+                          "productInstances": [],
                          "replacedByTokenId": 2,
                          "autoReloadRegistration": null,
                          "ePurse": null,
@ -2383,6 +2651,13 @@ paths:
                                },
                              "photo": null,
                            },
+                          "gboAgeProfile":
+                              {
+                                "gboAgeProfileId": 1,
+                                "name": "Kind (4 t/m 11 jaar)",
+                                "ageFromInclusive": 4,
+                                "ageToInclusive": 11
+                              }
                        },
                      "newOvPayToken":
                        {
@ -2393,6 +2668,7 @@ paths:
                          "alias": null,
                          "tokenStatus": null,
                          "expirationDate": "2028-02-01",
+                          "productInstances": [],
                          "replacedByTokenId": null,
                          "autoReloadRegistration": null,
                          "ePurse": null,
@ -2411,6 +2687,13 @@ paths:
                                },
                              "photo": null,
                            },
+                            "gboAgeProfile":
+                              {
+                                "gboAgeProfileId": 4,
+                                "name": "Kind (19 t/m 65 jaar)",
+                                "ageFromInclusive": 19,
+                                "ageToInclusive": 65
+                              }
                        },
                      "isTransferable": false,
                      "transferableObjects":
@ -2423,6 +2706,7 @@ paths:
                          "ePurse": false,
                          "personalAccountData":
                            { "name": true, "birthdate": false, "photo": true },
+                          "gboAgeProfile": false,
                        },
                      "_links": {},
                    }
@ -2582,8 +2866,8 @@ paths:
                        "alias": "My new token",
                      },
                  }
-              ? Transfer from a token with PAD to a new token without existing PAD
-              : summary: Transfer from a token with PAD to a new token without existing PAD
+              Transfer from a token with PAD to a new token without existing PAD:
+                summary: Transfer from a token with PAD to a new token without existing PAD
                description: |
                  Transfer of a token with PAD to a new token by xTAT without existing PAD. Note how this request is 
                  different, since it has an e-mail address on which the new PAD should be created. This request may 
@ -2767,6 +3051,13 @@ paths:
                              "lastChangeDate": "2024-08-24T14:15:22Z",
                            },
                        },
+                      "gboAgeProfile":
+                        {
+                         "gboAgeProfileId": 1,
+                         "name": "Kind (4 t/m 11 jaar)",
+                         "ageFromInclusive": 4,
+                         "ageToInclusive": 11
+                        },
                      "_links":
                        {
                          "self":
@ -3085,6 +3376,13 @@ components:
            alias:
              type: string
              example: MyNewToken
+    CustomersResponseList:
+      type: object
+      properties:
+        customers: 
+          type: array
+          items:
+            $ref: "#/components/schemas/CustomersResponse"      
    CustomersResponse:   
      type: object
      properties:
--- a/src/openapi/customers/customers-crud-v2.yaml
+++ b/src/openapi/customers/customers-crud-v2.yaml
@ -864,7 +864,7 @@ paths:
    patch:
      tags:
        - Customer
-      summary: Modify a customer element
+      summary: Modify a customer debtorStatus
      description: >-

      parameters:
@ -880,9 +880,30 @@ paths:
            schema:
              $ref: "#/components/schemas/customersEntity"
            examples:
-              customer:
+              updateDebtorStatus:
                value:
                  debtorStatusId: 2
+              updateFullPerson:
+                value:
+                  person: {
+                      birthname: "Jan",
+                      surname: "Jansen",
+                      prefix: "de",
+                      suffix: "jr",
+                      dateOfBirth: "1970-01-01",
+                      emailAddress: "TEST@TEST1.NL"
+                    }
+              updateCompleteEntity:
+                value:                  
+                  debtorStatusId: 2
+                  person: {
+                      birthname: "Jan",
+                      surname: "Jansen",
+                      prefix: "de",
+                      suffix: "jr",
+                      dateOfBirth: "1970-01-01",
+                      emailAddress: "TEST@TEST1.NL"
+                    }
        required: true
      responses:
        201:
@ -1065,10 +1086,15 @@ paths:
            schema:
              $ref: "#/components/schemas/patchCustomerAddress"
            examples:
-              updateAddressTypeId:
+              fullAddress:
                value:
                  address:
-                    addressTypeId: 2
+                    street: Sesamstraat
+                    houseNumber: 1
+                    houseNumberSuffix: A
+                    postalCode: 1234 AB
+                    city: Den Haag
+                    country: NL
        required: true
      responses:
        200:
@ -1126,8 +1152,8 @@ paths:
              customerPhone:
                value:
                  phone:
-                    number: 0701112233
-                    countryCode: 0031
+                    number: "0701112233"
+                    countryCode: "0031"
                    phoneTypeId: 1
                    isPreferred: true
        required: true
@ -1162,6 +1188,13 @@ paths:
            schema:
              $ref: "#/components/schemas/phoneEntity"
            examples:            
+              updateFullPhoneEntity:
+                value:
+                  phone:
+                    phoneTypeId: 2
+                    number: "0701112233"
+                    countryCode: "0031"
+                    isPreferred: false
              updatePhoneTypeId:
                value:
                  phone:
@ -1424,6 +1457,13 @@ paths:
            schema:
              $ref: "#/components/schemas/ovPayTokenEntity"
            examples:
+              updateFullToken:
+                value: 
+                  ovpaytoken:
+                    alias: "ING pas mobiel"                    
+                    tokenStatusId: 1                    
+                    replacedByTokenId: 8
+                    lastdigits: 4563
              updateTokenAlias:
                value:
                  ovpaytoken:
@ -1726,54 +1766,6 @@ paths:
        - default: []
      x-auth-type: Application & Application User
      x-throttling-tier: Unlimited
-  /billingInformations/{billingInformationId}:
-    patch:
-      tags:
-        - Billing Information
-      summary: Update a billing information
-      description: >-
-
-      parameters:
-        - name: billingInformationId
-          in: path
-          required: true
-          schema:
-            type: integer
-            example: 1
-      requestBody:
-        content:
-          application/json:
-            schema:
-              $ref: "#/components/schemas/billingInformationEntity"
-            examples:
-              updateBillingInformationAlias:
-                value:
-                  billingInformation:
-                    alias: "Mijn rekening details"
-              updateBillingInformation:
-                value:
-                  billingInformation:
-                    alias: "Mijn rekening details"
-                    iban: "NL06RABO8902022560"
-        required: true
-      responses:
-        200:
-          description: Successfully updated a customer billing information
-          content:
-            application/json:
-              example:
-                {
-                  "billingInformationId": 1,
-                  "customerProfileId": 1,
-                  "iban": "NL06RABO8902022560",
-                  "ascription": "J. Doe",
-                  "alias": "Mijn rekening details",
-                  "created": "2024-03-22T08:55:00",
-                }
-      security:
-        - default: []
-      x-auth-type: Application & Application User
-      x-throttling-tier: Unlimited
  /directdebitmandates:
    get:
      tags:
--- a/src/openapi/orders/orders-crud.yaml
+++ b/src/openapi/orders/orders-crud.yaml
@ -192,7 +192,7 @@ paths:
                                      {
                                        "personalAccountDataId": "47db8a40-3238-4bf5-9284-759e3888bd47",
                                        "name": "Jan de Vries",
-                                        "birthdate": "01-01-1970",
+                                        "birthdate": "1970-01-01",
                                        "photo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAWJLR0Q+SWQA4wAAAAd0SU1FB+YCBAwmK58TFQgAAAAldEVYdGRhdGU6Y3JlYXRlADIwMjItMDItMDRUMTI6Mzg6NDMrMDA6MDBAjYOrAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIyLTAyLTA0VDEyOjM4OjQzKzAwOjAwMdA7FwAAAFd6VFh0UmF3IHByb2ZpbGUgdHlwZSBpcHRjAAB4nOPyDAhxVigoyk/LzEnlUgADIwsuYwsTIxNLkxQDEyBEgDTDZAMjs1Qgy9jUyMTMxBzEB8uASKBKLgDqFxF08kI1lQAAAYdpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0n77u/JyBpZD0nVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkJz8+DQo8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIj48cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPjx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+PC9yZGY6RGVzY3JpcHRpb24+PC9yZGY6UkRGPjwveDp4bXBtZXRhPg0KPD94cGFja2V0IGVuZD0ndyc/PiyUmAsAAAANSURBVBhXY3grk/YfAAXYAm/HQierAAAAAElFTkSuQmCC" ,
                                        "challengeType":
                                          {
@ -373,7 +373,7 @@ paths:
                              "personalAccountData":
                                {
                                  "name": "Jan de Vries",
-                                  "birthdate": "01-01-1970",
+                                  "birthdate": "1970-01-01",
                                  "photo": "DSC_0502.JPG",
                                  "challengeTypeId": 1,
                                  "oneTimePassword": "H5Iiz3JTaQeIV8p",
@ -555,7 +555,7 @@ paths:
                                {
                                  "personalAccountDataId": "47db8a40-3238-4bf5-9284-759e3888bd47",
                                  "name": "Jan de Vries",
-                                  "birthdate": "01-01-1970",
+                                  "birthdate": "1970-01-01",
                                  "photo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAWJLR0Q+SWQA4wAAAAd0SU1FB+YCBAwmK58TFQgAAAAldEVYdGRhdGU6Y3JlYXRlADIwMjItMDItMDRUMTI6Mzg6NDMrMDA6MDBAjYOrAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIyLTAyLTA0VDEyOjM4OjQzKzAwOjAwMdA7FwAAAFd6VFh0UmF3IHByb2ZpbGUgdHlwZSBpcHRjAAB4nOPyDAhxVigoyk/LzEnlUgADIwsuYwsTIxNLkxQDEyBEgDTDZAMjs1Qgy9jUyMTMxBzEB8uASKBKLgDqFxF08kI1lQAAAYdpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0n77u/JyBpZD0nVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkJz8+DQo8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIj48cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPjx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+PC9yZGY6RGVzY3JpcHRpb24+PC9yZGY6UkRGPjwveDp4bXBtZXRhPg0KPD94cGFja2V0IGVuZD0ndyc/PiyUmAsAAAANSURBVBhXY3grk/YfAAXYAm/HQierAAAAAElFTkSuQmCC" ,                         
                                  "challengeType":
                                    { "challengeTypeId": 1, "name": "email" },
@ -779,7 +779,7 @@ paths:
                          "verificationCode": "A7H6",
                          "personalAccountData":
                            {
-                              "birthdate": "01-01-1970"
+                              "birthdate": "1970-01-01"
                            },
                        },
                      ],
@ -1136,7 +1136,7 @@ paths:
                            {
                              "personalAccountDataId": "47db8a40-3238-4bf5-9284-759e3888bd47",
                              "name": "Jan de Vries",
-                              "birthdate": "01-01-1970",
+                              "birthdate": "1970-01-01",
                              "photo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAWJLR0Q+SWQA4wAAAAd0SU1FB+YCBAwmK58TFQgAAAAldEVYdGRhdGU6Y3JlYXRlADIwMjItMDItMDRUMTI6Mzg6NDMrMDA6MDBAjYOrAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIyLTAyLTA0VDEyOjM4OjQzKzAwOjAwMdA7FwAAAFd6VFh0UmF3IHByb2ZpbGUgdHlwZSBpcHRjAAB4nOPyDAhxVigoyk/LzEnlUgADIwsuYwsTIxNLkxQDEyBEgDTDZAMjs1Qgy9jUyMTMxBzEB8uASKBKLgDqFxF08kI1lQAAAYdpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0n77u/JyBpZD0nVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkJz8+DQo8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIj48cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPjx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+PC9yZGY6RGVzY3JpcHRpb24+PC9yZGY6UkRGPjwveDp4bXBtZXRhPg0KPD94cGFja2V0IGVuZD0ndyc/PiyUmAsAAAANSURBVBhXY3grk/YfAAXYAm/HQierAAAAAElFTkSuQmCC" ,
                              "challengeType":
                                { "challengeTypeId": 1, "name": "email" },
@ -1275,7 +1275,7 @@ paths:
                "verificationCode": "A7H6",
                "personalAccountData":
                  {                   
-                    "birthdate": "01-01-1970",
+                    "birthdate": "1970-01-01",
                  }
              }
      responses:
@ -1377,7 +1377,7 @@ paths:
                      {
                        "personalAccountDataId": "47db8a40-3238-4bf5-9284-759e3888bd47",
                        "name": "Jan de Vries",
-                        "birthdate": "01-01-1970",
+                        "birthdate": "1970-01-01",
                        "photo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAWJLR0Q+SWQA4wAAAAd0SU1FB+YCBAwmK58TFQgAAAAldEVYdGRhdGU6Y3JlYXRlADIwMjItMDItMDRUMTI6Mzg6NDMrMDA6MDBAjYOrAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIyLTAyLTA0VDEyOjM4OjQzKzAwOjAwMdA7FwAAAFd6VFh0UmF3IHByb2ZpbGUgdHlwZSBpcHRjAAB4nOPyDAhxVigoyk/LzEnlUgADIwsuYwsTIxNLkxQDEyBEgDTDZAMjs1Qgy9jUyMTMxBzEB8uASKBKLgDqFxF08kI1lQAAAYdpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0n77u/JyBpZD0nVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkJz8+DQo8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIj48cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPjx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+PC9yZGY6RGVzY3JpcHRpb24+PC9yZGY6UkRGPjwveDp4bXBtZXRhPg0KPD94cGFja2V0IGVuZD0ndyc/PiyUmAsAAAANSURBVBhXY3grk/YfAAXYAm/HQierAAAAAElFTkSuQmCC" ,
                        "challengeType":
                          { "challengeTypeId": 1, "name": "email" },
@ -1457,7 +1457,7 @@ paths:
                description: Only record birthdate PersonalAccountData
                value:
                  {
-                    "birthdate": "01-01-1970"
+                    "birthdate": "1970-01-01"
                  }              
              name PersonalAccountData:
                summary: PersonalAccountData name
@ -1479,7 +1479,7 @@ paths:
                value:
                  {
                    "name": "Jan de Vries",
-                    "birthdate": "01-01-1970",
+                    "birthdate": "1970-01-01",
                    "photo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAWJLR0Q+SWQA4wAAAAd0SU1FB+YCBAwmK58TFQgAAAAldEVYdGRhdGU6Y3JlYXRlADIwMjItMDItMDRUMTI6Mzg6NDMrMDA6MDBAjYOrAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIyLTAyLTA0VDEyOjM4OjQzKzAwOjAwMdA7FwAAAFd6VFh0UmF3IHByb2ZpbGUgdHlwZSBpcHRjAAB4nOPyDAhxVigoyk/LzEnlUgADIwsuYwsTIxNLkxQDEyBEgDTDZAMjs1Qgy9jUyMTMxBzEB8uASKBKLgDqFxF08kI1lQAAAYdpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0n77u/JyBpZD0nVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkJz8+DQo8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIj48cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPjx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+PC9yZGY6RGVzY3JpcHRpb24+PC9yZGY6UkRGPjwveDp4bXBtZXRhPg0KPD94cGFja2V0IGVuZD0ndyc/PiyUmAsAAAANSURBVBhXY3grk/YfAAXYAm/HQierAAAAAElFTkSuQmCC" ,
                    "challengeTypeId": 1,
                    "oneTimePassword": "H5Iiz3JTaQeIV8p",
@ -1490,7 +1490,7 @@ paths:
                value:
                  {
                    "name": "Jan de Vries",
-                    "birthdate": "01-01-1970",
+                    "birthdate": "1970-01-01",
                    "photo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAWJLR0Q+SWQA4wAAAAd0SU1FB+YCBAwmK58TFQgAAAAldEVYdGRhdGU6Y3JlYXRlADIwMjItMDItMDRUMTI6Mzg6NDMrMDA6MDBAjYOrAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIyLTAyLTA0VDEyOjM4OjQzKzAwOjAwMdA7FwAAAFd6VFh0UmF3IHByb2ZpbGUgdHlwZSBpcHRjAAB4nOPyDAhxVigoyk/LzEnlUgADIwsuYwsTIxNLkxQDEyBEgDTDZAMjs1Qgy9jUyMTMxBzEB8uASKBKLgDqFxF08kI1lQAAAYdpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0n77u/JyBpZD0nVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkJz8+DQo8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIj48cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPjx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+PC9yZGY6RGVzY3JpcHRpb24+PC9yZGY6UkRGPjwveDp4bXBtZXRhPg0KPD94cGFja2V0IGVuZD0ndyc/PiyUmAsAAAANSURBVBhXY3grk/YfAAXYAm/HQierAAAAAElFTkSuQmCC" ,
                    "challengeTypeId": 1,
                    "oneTimePassword": "H5Iiz3JTaQeIV8p",
@ -1558,7 +1558,7 @@ paths:
            format: date
            example: 1970-01-01
          required: false
-          description: The date of birth of the customer.
+          description: "The date of birth of the customer (formatted: YYYY-MM-DD)."
        - in: query
          name: photo
          schema:
@ -1598,7 +1598,7 @@ paths:
                    "orderLineId": "858e31b9-67f0-46ca-bf88-91a382b9c079",
                    "orderId": "858e31b9-67f0-46ca-bf88-91a382b9c079",
                    "name": "Jan de Vries",
-                    "birthdate": "01-01-1970",
+                    "birthdate": "1970-01-01",
                    "photo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAWJLR0Q+SWQA4wAAAAd0SU1FB+YCBAwmK58TFQgAAAAldEVYdGRhdGU6Y3JlYXRlADIwMjItMDItMDRUMTI6Mzg6NDMrMDA6MDBAjYOrAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIyLTAyLTA0VDEyOjM4OjQzKzAwOjAwMdA7FwAAAFd6VFh0UmF3IHByb2ZpbGUgdHlwZSBpcHRjAAB4nOPyDAhxVigoyk/LzEnlUgADIwsuYwsTIxNLkxQDEyBEgDTDZAMjs1Qgy9jUyMTMxBzEB8uASKBKLgDqFxF08kI1lQAAAYdpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0n77u/JyBpZD0nVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkJz8+DQo8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIj48cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPjx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+PC9yZGY6RGVzY3JpcHRpb24+PC9yZGY6UkRGPjwveDp4bXBtZXRhPg0KPD94cGFja2V0IGVuZD0ndyc/PiyUmAsAAAANSURBVBhXY3grk/YfAAXYAm/HQierAAAAAElFTkSuQmCC" ,
                    "challengeType": { "challengeTypeId": 1, "name": "email" },
                    "oneTimePassword": "H5Iiz3JTaQeIV8p",
@ -2164,7 +2164,7 @@ paths:
            format: date
            example: 1970-01-01
          required: false
-          description: The date of birth of the customer.
+          description: "The date of birth of the customer (formatted: YYYY-MM-DD)."
      responses:
        "200":
          description: OK
--- a/src/openapi/orders/service_engine_orders.yaml
+++ b/src/openapi/orders/service_engine_orders.yaml
@ -280,7 +280,7 @@ paths:
                                          {
                                            "personalAccountDataId": "47db8a40-3238-4bf5-9284-759e3888bd47",
                                            "name": "Jan de Vries",
-                                            "birthdate": "01-01-1970",
+                                            "birthdate": "1970-01-01",
                                            "photo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAWJLR0Q+SWQA4wAAAAd0SU1FB+YCBAwmK58TFQgAAAAldEVYdGRhdGU6Y3JlYXRlADIwMjItMDItMDRUMTI6Mzg6NDMrMDA6MDBAjYOrAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIyLTAyLTA0VDEyOjM4OjQzKzAwOjAwMdA7FwAAAFd6VFh0UmF3IHByb2ZpbGUgdHlwZSBpcHRjAAB4nOPyDAhxVigoyk/LzEnlUgADIwsuYwsTIxNLkxQDEyBEgDTDZAMjs1Qgy9jUyMTMxBzEB8uASKBKLgDqFxF08kI1lQAAAYdpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0n77u/JyBpZD0nVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkJz8+DQo8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIj48cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPjx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+PC9yZGY6RGVzY3JpcHRpb24+PC9yZGY6UkRGPjwveDp4bXBtZXRhPg0KPD94cGFja2V0IGVuZD0ndyc/PiyUmAsAAAANSURBVBhXY3grk/YfAAXYAm/HQierAAAAAElFTkSuQmCC",
                                            "challengeType":
                                              {
@ -366,7 +366,7 @@ paths:
                                "personalAccountData":
                                  {
                                    "name": "Jan de Vries",
-                                    "birthdate": "01-01-1970",
+                                    "birthdate": "1970-01-01",
                                    "photo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAWJLR0Q+SWQA4wAAAAd0SU1FB+YCBAwmK58TFQgAAAAldEVYdGRhdGU6Y3JlYXRlADIwMjItMDItMDRUMTI6Mzg6NDMrMDA6MDBAjYOrAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIyLTAyLTA0VDEyOjM4OjQzKzAwOjAwMdA7FwAAAFd6VFh0UmF3IHByb2ZpbGUgdHlwZSBpcHRjAAB4nOPyDAhxVigoyk/LzEnlUgADIwsuYwsTIxNLkxQDEyBEgDTDZAMjs1Qgy9jUyMTMxBzEB8uASKBKLgDqFxF08kI1lQAAAYdpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0n77u/JyBpZD0nVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkJz8+DQo8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIj48cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPjx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+PC9yZGY6RGVzY3JpcHRpb24+PC9yZGY6UkRGPjwveDp4bXBtZXRhPg0KPD94cGFja2V0IGVuZD0ndyc/PiyUmAsAAAANSURBVBhXY3grk/YfAAXYAm/HQierAAAAAElFTkSuQmCC",
                                    "challengeTypeId": 1,
                                    "oneTimePassword": "H5Iiz3JTaQeIV8p",
@ -416,7 +416,7 @@ paths:
                                "personalAccountData":
                                  {
                                    "name": "Jan de Vries",
-                                    "dateOfBirth": "01-01-1970",
+                                    "dateOfBirth": "1970-01-01",
                                    "photoReference": "DSC_0502.JPG",
                                    "fileType": "image/jpg",
                                    "challengeTypeId": 1,
@ -537,7 +537,7 @@ paths:
                                "personalAccountData":
                                  {
                                    "name": "Jan de Vries",
-                                    "dateOfBirth": "01-01-1970",
+                                    "dateOfBirth": "1970-01-01",
                                    "photoReference": "DSC_0502.JPG",
                                    "fileType": "image/jpg",
                                    "challengeTypeId": 1,
@ -696,7 +696,7 @@ paths:
                                    {
                                      "personalAccountDataId": "47db8a40-3238-4bf5-9284-759e3888bd47",
                                      "name": "Jan de Vries",
-                                      "birthdate": "01-01-1970",
+                                      "birthdate": "1970-01-01",
                                      "photo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAWJLR0Q+SWQA4wAAAAd0SU1FB+YCBAwmK58TFQgAAAAldEVYdGRhdGU6Y3JlYXRlADIwMjItMDItMDRUMTI6Mzg6NDMrMDA6MDBAjYOrAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIyLTAyLTA0VDEyOjM4OjQzKzAwOjAwMdA7FwAAAFd6VFh0UmF3IHByb2ZpbGUgdHlwZSBpcHRjAAB4nOPyDAhxVigoyk/LzEnlUgADIwsuYwsTIxNLkxQDEyBEgDTDZAMjs1Qgy9jUyMTMxBzEB8uASKBKLgDqFxF08kI1lQAAAYdpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0n77u/JyBpZD0nVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkJz8+DQo8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIj48cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPjx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+PC9yZGY6RGVzY3JpcHRpb24+PC9yZGY6UkRGPjwveDp4bXBtZXRhPg0KPD94cGFja2V0IGVuZD0ndyc/PiyUmAsAAAANSURBVBhXY3grk/YfAAXYAm/HQierAAAAAElFTkSuQmCC",
                                      "challengeType":
                                        {
@ -880,7 +880,7 @@ paths:
                                    {
                                      "personalAccountDataId": "47db8a40-3238-4bf5-9284-759e3888bd47",
                                      "name": "Jan de Vries",
-                                      "birthdate": "01-01-1970",
+                                      "birthdate": "1970-01-01",
                                      "photo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAWJLR0Q+SWQA4wAAAAd0SU1FB+YCBAwmK58TFQgAAAAldEVYdGRhdGU6Y3JlYXRlADIwMjItMDItMDRUMTI6Mzg6NDMrMDA6MDBAjYOrAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIyLTAyLTA0VDEyOjM4OjQzKzAwOjAwMdA7FwAAAFd6VFh0UmF3IHByb2ZpbGUgdHlwZSBpcHRjAAB4nOPyDAhxVigoyk/LzEnlUgADIwsuYwsTIxNLkxQDEyBEgDTDZAMjs1Qgy9jUyMTMxBzEB8uASKBKLgDqFxF08kI1lQAAAYdpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0n77u/JyBpZD0nVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkJz8+DQo8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIj48cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPjx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+PC9yZGY6RGVzY3JpcHRpb24+PC9yZGY6UkRGPjwveDp4bXBtZXRhPg0KPD94cGFja2V0IGVuZD0ndyc/PiyUmAsAAAANSURBVBhXY3grk/YfAAXYAm/HQierAAAAAElFTkSuQmCC",
                                      "challengeType":
                                        {
@ -1107,7 +1107,7 @@ paths:
                                    {
                                      "personalAccountDataId": "47db8a40-3238-4bf5-9284-759e3888bd47",
                                      "name": "Jan de Vries",
-                                      "birthdate": "01-01-1970",
+                                      "birthdate": "1970-01-01",
                                      "photo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAWJLR0Q+SWQA4wAAAAd0SU1FB+YCBAwmK58TFQgAAAAldEVYdGRhdGU6Y3JlYXRlADIwMjItMDItMDRUMTI6Mzg6NDMrMDA6MDBAjYOrAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIyLTAyLTA0VDEyOjM4OjQzKzAwOjAwMdA7FwAAAFd6VFh0UmF3IHByb2ZpbGUgdHlwZSBpcHRjAAB4nOPyDAhxVigoyk/LzEnlUgADIwsuYwsTIxNLkxQDEyBEgDTDZAMjs1Qgy9jUyMTMxBzEB8uASKBKLgDqFxF08kI1lQAAAYdpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0n77u/JyBpZD0nVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkJz8+DQo8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIj48cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPjx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+PC9yZGY6RGVzY3JpcHRpb24+PC9yZGY6UkRGPjwveDp4bXBtZXRhPg0KPD94cGFja2V0IGVuZD0ndyc/PiyUmAsAAAANSURBVBhXY3grk/YfAAXYAm/HQierAAAAAElFTkSuQmCC",
                                      "challengeType":
                                        {
@ -1290,7 +1290,7 @@ paths:
                          "personalAccountData":
                            {
                              "name": "Jan de Vries",
-                              "dateOfBirth": "01-01-1970",
+                              "dateOfBirth": "1970-01-01",
                              "photoReference": "DSC_0502.JPG",
                              "fileType": "image/jpg",
                              "challengeTypeId": 1,
@ -1786,7 +1786,7 @@ paths:
                                    {
                                      "personalAccountDataId": "47db8a40-3238-4bf5-9284-759e3888bd47",
                                      "name": "Jan de Vries",
-                                      "birthdate": "01-01-1970",
+                                      "birthdate": "1970-01-01",
                                      "photo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAWJLR0Q+SWQA4wAAAAd0SU1FB+YCBAwmK58TFQgAAAAldEVYdGRhdGU6Y3JlYXRlADIwMjItMDItMDRUMTI6Mzg6NDMrMDA6MDBAjYOrAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIyLTAyLTA0VDEyOjM4OjQzKzAwOjAwMdA7FwAAAFd6VFh0UmF3IHByb2ZpbGUgdHlwZSBpcHRjAAB4nOPyDAhxVigoyk/LzEnlUgADIwsuYwsTIxNLkxQDEyBEgDTDZAMjs1Qgy9jUyMTMxBzEB8uASKBKLgDqFxF08kI1lQAAAYdpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0n77u/JyBpZD0nVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkJz8+DQo8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIj48cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPjx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+PC9yZGY6RGVzY3JpcHRpb24+PC9yZGY6UkRGPjwveDp4bXBtZXRhPg0KPD94cGFja2V0IGVuZD0ndyc/PiyUmAsAAAANSURBVBhXY3grk/YfAAXYAm/HQierAAAAAElFTkSuQmCC",
                                      "challengeType":
                                        {
@ -2321,7 +2321,7 @@ paths:
                value:
                  {
                    "name": "Jan de Vries",
-                    "birthdate": "01-01-1970",
+                    "birthdate": "1970-01-01",
                    "photo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAWJLR0Q+SWQA4wAAAAd0SU1FB+YCBAwmK58TFQgAAAAldEVYdGRhdGU6Y3JlYXRlADIwMjItMDItMDRUMTI6Mzg6NDMrMDA6MDBAjYOrAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIyLTAyLTA0VDEyOjM4OjQzKzAwOjAwMdA7FwAAAFd6VFh0UmF3IHByb2ZpbGUgdHlwZSBpcHRjAAB4nOPyDAhxVigoyk/LzEnlUgADIwsuYwsTIxNLkxQDEyBEgDTDZAMjs1Qgy9jUyMTMxBzEB8uASKBKLgDqFxF08kI1lQAAAYdpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0n77u/JyBpZD0nVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkJz8+DQo8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIj48cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPjx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+PC9yZGY6RGVzY3JpcHRpb24+PC9yZGY6UkRGPjwveDp4bXBtZXRhPg0KPD94cGFja2V0IGVuZD0ndyc/PiyUmAsAAAANSURBVBhXY3grk/YfAAXYAm/HQierAAAAAElFTkSuQmCC" ,
                    "challengeTypeId": 1,
                    "oneTimePassword": "H5Iiz3JTaQeIV8p",
@ -2414,7 +2414,7 @@ paths:
                                  "personalAccountData":{
                                    "personalAccountDataId": "d9021fdd-6e83-45c0-9aef-71680f0b4e74",
                                    "name": "Jan de Vries",
-                                    "birthdate": "01-01-1970",
+                                    "birthdate": "1970-01-01",
                                    "photo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAWJLR0Q+SWQA4wAAAAd0SU1FB+YCBAwmK58TFQgAAAAldEVYdGRhdGU6Y3JlYXRlADIwMjItMDItMDRUMTI6Mzg6NDMrMDA6MDBAjYOrAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIyLTAyLTA0VDEyOjM4OjQzKzAwOjAwMdA7FwAAAFd6VFh0UmF3IHByb2ZpbGUgdHlwZSBpcHRjAAB4nOPyDAhxVigoyk/LzEnlUgADIwsuYwsTIxNLkxQDEyBEgDTDZAMjs1Qgy9jUyMTMxBzEB8uASKBKLgDqFxF08kI1lQAAAYdpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0n77u/JyBpZD0nVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkJz8+DQo8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIj48cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPjx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+PC9yZGY6RGVzY3JpcHRpb24+PC9yZGY6UkRGPjwveDp4bXBtZXRhPg0KPD94cGFja2V0IGVuZD0ndyc/PiyUmAsAAAANSURBVBhXY3grk/YfAAXYAm/HQierAAAAAElFTkSuQmCC" ,
                                    "challengeTypeId": 1,
                                    "oneTimePassword": "H5Iiz3JTaQeIV8p",
@ -2463,7 +2463,7 @@ paths:
                description: Update personal account data v2.2
                value:
                  {
-                    "birthdate": "01-01-2010",
+                    "birthdate": "2010-01-01",
                  }
      responses:
        "201": 
@ -2553,7 +2553,7 @@ paths:
                                  "personalAccountData":{
                                    "personalAccountDataId": "d9021fdd-6e83-45c0-9aef-71680f0b4e74",
                                    "name": "Jan de Vries",
-                                    "birthdate": "01-01-2010",
+                                    "birthdate": "2010-01-01",
                                    "photo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAWJLR0Q+SWQA4wAAAAd0SU1FB+YCBAwmK58TFQgAAAAldEVYdGRhdGU6Y3JlYXRlADIwMjItMDItMDRUMTI6Mzg6NDMrMDA6MDBAjYOrAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIyLTAyLTA0VDEyOjM4OjQzKzAwOjAwMdA7FwAAAFd6VFh0UmF3IHByb2ZpbGUgdHlwZSBpcHRjAAB4nOPyDAhxVigoyk/LzEnlUgADIwsuYwsTIxNLkxQDEyBEgDTDZAMjs1Qgy9jUyMTMxBzEB8uASKBKLgDqFxF08kI1lQAAAYdpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0n77u/JyBpZD0nVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkJz8+DQo8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIj48cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPjx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+PC9yZGY6RGVzY3JpcHRpb24+PC9yZGY6UkRGPjwveDp4bXBtZXRhPg0KPD94cGFja2V0IGVuZD0ndyc/PiyUmAsAAAANSURBVBhXY3grk/YfAAXYAm/HQierAAAAAElFTkSuQmCC" ,
                                    "challengeTypeId": 1,
                                    "oneTimePassword": "H5Iiz3JTaQeIV8p",
@ -2845,7 +2845,7 @@ paths:
                                    {
                                      "personalAccountDataId": "47db8a40-3238-4bf5-9284-759e3888bd47",
                                      "name": "Jan de Vries",
-                                      "birthdate": "01-01-1970",
+                                      "birthdate": "1970-01-01",
                                      "photo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAWJLR0Q+SWQA4wAAAAd0SU1FB+YCBAwmK58TFQgAAAAldEVYdGRhdGU6Y3JlYXRlADIwMjItMDItMDRUMTI6Mzg6NDMrMDA6MDBAjYOrAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIyLTAyLTA0VDEyOjM4OjQzKzAwOjAwMdA7FwAAAFd6VFh0UmF3IHByb2ZpbGUgdHlwZSBpcHRjAAB4nOPyDAhxVigoyk/LzEnlUgADIwsuYwsTIxNLkxQDEyBEgDTDZAMjs1Qgy9jUyMTMxBzEB8uASKBKLgDqFxF08kI1lQAAAYdpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0n77u/JyBpZD0nVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkJz8+DQo8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIj48cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPjx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+PC9yZGY6RGVzY3JpcHRpb24+PC9yZGY6UkRGPjwveDp4bXBtZXRhPg0KPD94cGFja2V0IGVuZD0ndyc/PiyUmAsAAAANSURBVBhXY3grk/YfAAXYAm/HQierAAAAAElFTkSuQmCC",
                                      "challengeType":
                                        {
@ -3114,7 +3114,7 @@ paths:
                                    {
                                      "personalAccountDataId": "47db8a40-3238-4bf5-9284-759e3888bd47",
                                      "name": "Jan de Vries",
-                                      "birthdate": "01-01-1970",
+                                      "birthdate": "1970-01-01",
                                      "photo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAWJLR0Q+SWQA4wAAAAd0SU1FB+YCBAwmK58TFQgAAAAldEVYdGRhdGU6Y3JlYXRlADIwMjItMDItMDRUMTI6Mzg6NDMrMDA6MDBAjYOrAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIyLTAyLTA0VDEyOjM4OjQzKzAwOjAwMdA7FwAAAFd6VFh0UmF3IHByb2ZpbGUgdHlwZSBpcHRjAAB4nOPyDAhxVigoyk/LzEnlUgADIwsuYwsTIxNLkxQDEyBEgDTDZAMjs1Qgy9jUyMTMxBzEB8uASKBKLgDqFxF08kI1lQAAAYdpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0n77u/JyBpZD0nVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkJz8+DQo8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIj48cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPjx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+PC9yZGY6RGVzY3JpcHRpb24+PC9yZGY6UkRGPjwveDp4bXBtZXRhPg0KPD94cGFja2V0IGVuZD0ndyc/PiyUmAsAAAANSURBVBhXY3grk/YfAAXYAm/HQierAAAAAElFTkSuQmCC",
                                      "challengeType":
                                        {
@ -3303,7 +3303,7 @@ paths:
                                    {
                                      "personalAccountDataId": "47db8a40-3238-4bf5-9284-759e3888bd47",
                                      "name": "Jan de Vries",
-                                      "birthdate": "01-01-1970",
+                                      "birthdate": "1970-01-01",
                                      "photo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAWJLR0Q+SWQA4wAAAAd0SU1FB+YCBAwmK58TFQgAAAAldEVYdGRhdGU6Y3JlYXRlADIwMjItMDItMDRUMTI6Mzg6NDMrMDA6MDBAjYOrAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIyLTAyLTA0VDEyOjM4OjQzKzAwOjAwMdA7FwAAAFd6VFh0UmF3IHByb2ZpbGUgdHlwZSBpcHRjAAB4nOPyDAhxVigoyk/LzEnlUgADIwsuYwsTIxNLkxQDEyBEgDTDZAMjs1Qgy9jUyMTMxBzEB8uASKBKLgDqFxF08kI1lQAAAYdpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0n77u/JyBpZD0nVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkJz8+DQo8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIj48cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPjx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+PC9yZGY6RGVzY3JpcHRpb24+PC9yZGY6UkRGPjwveDp4bXBtZXRhPg0KPD94cGFja2V0IGVuZD0ndyc/PiyUmAsAAAANSURBVBhXY3grk/YfAAXYAm/HQierAAAAAElFTkSuQmCC",
                                      "challengeType":
                                        {
@ -3593,7 +3593,7 @@ paths:
                                    {
                                      "personalAccountDataId": "47db8a40-3238-4bf5-9284-759e3888bd47",
                                      "name": "Jan de Vries",
-                                      "birthdate": "01-01-1970",
+                                      "birthdate": "1970-01-01",
                                      "photo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAWJLR0Q+SWQA4wAAAAd0SU1FB+YCBAwmK58TFQgAAAAldEVYdGRhdGU6Y3JlYXRlADIwMjItMDItMDRUMTI6Mzg6NDMrMDA6MDBAjYOrAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIyLTAyLTA0VDEyOjM4OjQzKzAwOjAwMdA7FwAAAFd6VFh0UmF3IHByb2ZpbGUgdHlwZSBpcHRjAAB4nOPyDAhxVigoyk/LzEnlUgADIwsuYwsTIxNLkxQDEyBEgDTDZAMjs1Qgy9jUyMTMxBzEB8uASKBKLgDqFxF08kI1lQAAAYdpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0n77u/JyBpZD0nVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkJz8+DQo8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIj48cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPjx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+PC9yZGY6RGVzY3JpcHRpb24+PC9yZGY6UkRGPjwveDp4bXBtZXRhPg0KPD94cGFja2V0IGVuZD0ndyc/PiyUmAsAAAANSURBVBhXY3grk/YfAAXYAm/HQierAAAAAElFTkSuQmCC",
                                      "challengeType":
                                        {
@ -3779,7 +3779,7 @@ paths:
                                    {
                                      "personalAccountDataId": "47db8a40-3238-4bf5-9284-759e3888bd47",
                                      "name": "Jan de Vries",
-                                      "birthdate": "01-01-1970",
+                                      "birthdate": "1970-01-01",
                                      "photo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAWJLR0Q+SWQA4wAAAAd0SU1FB+YCBAwmK58TFQgAAAAldEVYdGRhdGU6Y3JlYXRlADIwMjItMDItMDRUMTI6Mzg6NDMrMDA6MDBAjYOrAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIyLTAyLTA0VDEyOjM4OjQzKzAwOjAwMdA7FwAAAFd6VFh0UmF3IHByb2ZpbGUgdHlwZSBpcHRjAAB4nOPyDAhxVigoyk/LzEnlUgADIwsuYwsTIxNLkxQDEyBEgDTDZAMjs1Qgy9jUyMTMxBzEB8uASKBKLgDqFxF08kI1lQAAAYdpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0n77u/JyBpZD0nVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkJz8+DQo8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIj48cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPjx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+PC9yZGY6RGVzY3JpcHRpb24+PC9yZGY6UkRGPjwveDp4bXBtZXRhPg0KPD94cGFja2V0IGVuZD0ndyc/PiyUmAsAAAANSURBVBhXY3grk/YfAAXYAm/HQierAAAAAElFTkSuQmCC",
                                      "challengeType":
                                        {
@ -3969,7 +3969,7 @@ paths:
                                    {
                                      "personalAccountDataId": "47db8a40-3238-4bf5-9284-759e3888bd47",
                                      "name": "Jan de Vries",
-                                      "birthdate": "01-01-1970",
+                                      "birthdate": "1970-01-01",
                                      "photo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAWJLR0Q+SWQA4wAAAAd0SU1FB+YCBAwmK58TFQgAAAAldEVYdGRhdGU6Y3JlYXRlADIwMjItMDItMDRUMTI6Mzg6NDMrMDA6MDBAjYOrAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIyLTAyLTA0VDEyOjM4OjQzKzAwOjAwMdA7FwAAAFd6VFh0UmF3IHByb2ZpbGUgdHlwZSBpcHRjAAB4nOPyDAhxVigoyk/LzEnlUgADIwsuYwsTIxNLkxQDEyBEgDTDZAMjs1Qgy9jUyMTMxBzEB8uASKBKLgDqFxF08kI1lQAAAYdpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0n77u/JyBpZD0nVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkJz8+DQo8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIj48cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPjx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+PC9yZGY6RGVzY3JpcHRpb24+PC9yZGY6UkRGPjwveDp4bXBtZXRhPg0KPD94cGFja2V0IGVuZD0ndyc/PiyUmAsAAAANSURBVBhXY3grk/YfAAXYAm/HQierAAAAAElFTkSuQmCC",
                                      "challengeType":
                                        {
@ -4147,7 +4147,7 @@ paths:
                                    {
                                      "personalAccountDataId": "47db8a40-3238-4bf5-9284-759e3888bd47",
                                      "name": "Jan de Vries",
-                                      "birthdate": "01-01-1970",
+                                      "birthdate": "1970-01-01",
                                      "photo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAACXBIWXMAABYlAAAWJQFJUiTwAAAAAWJLR0Q+SWQA4wAAAAd0SU1FB+YCBAwmK58TFQgAAAAldEVYdGRhdGU6Y3JlYXRlADIwMjItMDItMDRUMTI6Mzg6NDMrMDA6MDBAjYOrAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIyLTAyLTA0VDEyOjM4OjQzKzAwOjAwMdA7FwAAAFd6VFh0UmF3IHByb2ZpbGUgdHlwZSBpcHRjAAB4nOPyDAhxVigoyk/LzEnlUgADIwsuYwsTIxNLkxQDEyBEgDTDZAMjs1Qgy9jUyMTMxBzEB8uASKBKLgDqFxF08kI1lQAAAYdpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0n77u/JyBpZD0nVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkJz8+DQo8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIj48cmRmOlJERiB4bWxuczpyZGY9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkvMDIvMjItcmRmLXN5bnRheC1ucyMiPjxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSJ1dWlkOmZhZjViZGQ1LWJhM2QtMTFkYS1hZDMxLWQzM2Q3NTE4MmYxYiIgeG1sbnM6dGlmZj0iaHR0cDovL25zLmFkb2JlLmNvbS90aWZmLzEuMC8iPjx0aWZmOk9yaWVudGF0aW9uPjE8L3RpZmY6T3JpZW50YXRpb24+PC9yZGY6RGVzY3JpcHRpb24+PC9yZGY6UkRGPjwveDp4bXBtZXRhPg0KPD94cGFja2V0IGVuZD0ndyc/PiyUmAsAAAANSURBVBhXY3grk/YfAAXYAm/HQierAAAAAElFTkSuQmCC",
                                      "challengeType":
                                        {
--- a/src/openapi/products/SE-products-SE.yaml
+++ b/src/openapi/products/SE-products-SE.yaml
@ -6,7 +6,7 @@ info:
    To be used by touchpoints to get information about HTM products they are allowed to see and/or sell.
  version: "1.0"
 servers:  
-  - url: https://services.acc.api.htm.nl/abt/touchpoint/1.0
+  - url: https://services.acc.api.htm.nl/abt/abtserviceengine/1.0
 tags:
  - name: ServiceEngine Products
    description: |-
@ -90,7 +90,7 @@ paths:
                            "productDescription": "Reis een dag met het openbaar vervoer bij HTM",
                            "productCategory":
                              {
-                                "productCategoryId": 6,
+                                "productCategoryId": 5,
                                "isTravelProduct": false,
                                "name": "Barcode",
                              },
@ -123,7 +123,7 @@ paths:
                            "productDescription": "Reis een dag met het openbaar vervoer bij HTM",
                            "productCategory":
                              {
-                                "productCategoryId": 6,
+                                "productCategoryId": 5,
                                "isTravelProduct": false,
                                "name": "Barcode",
                              },
@ -156,7 +156,7 @@ paths:
                            "productDescription": "Voor een vast bedrag onbeperkt reizen met EBS, HTM en RET in het gekozen gebied in de regio Rotterdam Den Haag.",
                            "productCategory":
                              {
-                                "productCategoryId": 3,
+                                "productCategoryId": 2,
                                "isTravelProduct": true,
                                "name": "Afgekocht reisrecht",
                              },
@ -222,7 +222,7 @@ paths:
                            "productDescription": "Reis een dag met het openbaar vervoer bij HTM",
                            "productCategory":
                              {
-                                "productCategoryId": 6,
+                                "productCategoryId": 5,
                                "isTravelProduct": false,
                                "name": "Barcode",
                              },
@ -313,6 +313,7 @@ paths:
                    {
                      "productId": 24,
                      "parentProductId": null,
+                      "layerInfo": null,
                      "fikoArticleNumber": "1234",
                      "gboPackageTemplateId": "30901",
                      "tapConnectProductCode": null,
@ -425,6 +426,7 @@ paths:
                    {
                      "productId": 126,
                      "parentProductId": null,
+                      "layerInfo": null,
                      "fikoArticleNumber": "1234",
                      "gboPackageTemplateId": "30001",
                      "tapConnectProductCode": null,
@ -527,6 +529,12 @@ paths:
                          {
                            "productId": 119,
                            "parentProductId": 126,
+                            "layerInfo": {
+                              "layerInfoId": 1,
+                              "choiceKey": "isRenewable",
+                              "choiceLabel": "Kies voor een doorlopend abonnement of een enkele termijn",
+                              "isCustomChoice": false,
+                            },
                            "fikoArticleNumber": "1234",
                            "gboPackageTemplateId": "30001",
                            "tapConnectProductCode": null,
@ -641,6 +649,12 @@ paths:
                          {
                            "productId": 120,
                            "parentProductId": 126,
+                            "layerInfo": {
+                              "layerInfoId": 1,
+                              "choiceKey": "isRenewable",
+                              "choiceLabel": "Kies voor een doorlopend abonnement of een enkele termijn",
+                              "isCustomChoice": false,
+                            },
                            "fikoArticleNumber": "1234",
                            "gboPackageTemplateId": "30001",
                            "tapConnectProductCode": null,
@ -765,6 +779,7 @@ paths:
                    {
                      "productId": 49,
                      "parentProductId": null,
+                      "layerInfo": null,
                      "fikoArticleNumber": "1234",
                      "gboPackageTemplateId": null,
                      "tapConnectProductCode": null,
@ -794,12 +809,6 @@ paths:
                      "customerSegments": [],
                      "allowedGboAgeProfiles":
                        [
-                          {
-                            "gboAgeProfileId": 1,
-                            "name": "Baby/peuter (0 t/m 3 jaar)",
-                            "ageFromInclusive": 0,
-                            "ageToInclusive": 3,
-                          },
                          {
                            "gboAgeProfileId": 2,
                            "name": "Kind (4 t/m 11 jaar)",
@ -827,7 +836,7 @@ paths:
                        ],
                      "productCategory":
                        {
-                          "productCategoryId": 3,
+                          "productCategoryId": 2,
                          "isTravelProduct": true,
                          "name": "Afgekocht reisrecht",
                        },
@ -837,26 +846,10 @@ paths:
                      "incompatibleProducts": [],
                      "mandatoryCustomerDataItems":
                        [
-                          {
-                            "mandatoryCustomerDataItemId": 1,
-                            "customerDataItem": "birthname",
-                          },
-                          {
-                            "mandatoryCustomerDataItemId": 2,
-                            "customerDataItem": "surname",
-                          },
-                          {
-                            "mandatoryCustomerDataItemId": 3,
-                            "customerDataItem": "dateOfBirth",
-                          },
                          {
                            "mandatoryCustomerDataItemId": 4,
                            "customerDataItem": "emailAddress",
                          },
-                          {
-                            "mandatoryCustomerDataItemId": 7,
-                            "customerDataItem": "ovPayToken",
-                          },
                          {
                            "mandatoryCustomerDataItemId": 8,
                            "customerDataItem": "padBirthDate",
@ -928,6 +921,12 @@ paths:
                          {
                            "productId": 109,
                            "parentProductId": 49,
+                            "layerInfo": {
+                              "layerInfoId": 2,
+                              "choiceKey": "regio",
+                              "choiceLabel": "Kies de gewenste regio",
+                              "isCustomChoice": true,
+                            },
                            "fikoArticleNumber": "1234",
                            "gboPackageTemplateId": "33615",
                            "tapConnectProductCode": null,
@ -957,12 +956,6 @@ paths:
                            "customerSegments": [],
                            "allowedGboAgeProfiles":
                              [
-                                {
-                                  "gboAgeProfileId": 1,
-                                  "name": "Baby/peuter (0 t/m 3 jaar)",
-                                  "ageFromInclusive": 0,
-                                  "ageToInclusive": 3,
-                                },
                                {
                                  "gboAgeProfileId": 2,
                                  "name": "Kind (4 t/m 11 jaar)",
@ -990,7 +983,7 @@ paths:
                              ],
                            "productCategory":
                              {
-                                "productCategoryId": 3,
+                                "productCategoryId": 2,
                                "isTravelProduct": true,
                                "name": "Afgekocht reisrecht",
                              },
@ -1003,26 +996,10 @@ paths:
                            "incompatibleProducts": [],
                            "mandatoryCustomerDataItems":
                              [
-                                {
-                                  "mandatoryCustomerDataItemId": 1,
-                                  "customerDataItem": "birthname",
-                                },
-                                {
-                                  "mandatoryCustomerDataItemId": 2,
-                                  "customerDataItem": "surname",
-                                },
-                                {
-                                  "mandatoryCustomerDataItemId": 3,
-                                  "customerDataItem": "dateOfBirth",
-                                },
                                {
                                  "mandatoryCustomerDataItemId": 4,
                                  "customerDataItem": "emailAddress",
                                },
-                                {
-                                  "mandatoryCustomerDataItemId": 7,
-                                  "customerDataItem": "ovPayToken",
-                                },
                                {
                                  "mandatoryCustomerDataItemId": 8,
                                  "customerDataItem": "padBirthDate",
@ -1094,6 +1071,12 @@ paths:
                                {
                                  "productId": 114,
                                  "parentProductId": 109,
+                                  "layerInfo": {
+                                    "layerInfoId": 3,
+                                    "choiceKey": "allowedGboAgeProfiles",
+                                    "choiceLabel": "Wat is uw geboortedatum?",
+                                    "isCustomChoice": false,
+                                  },
                                  "fikoArticleNumber": "1234",
                                  "gboPackageTemplateId": "33615",
                                  "tapConnectProductCode": null,
@ -1123,12 +1106,6 @@ paths:
                                  "customerSegments": [],
                                  "allowedGboAgeProfiles":
                                    [
-                                      {
-                                        "gboAgeProfileId": 1,
-                                        "name": "Baby/peuter (0 t/m 3 jaar)",
-                                        "ageFromInclusive": 0,
-                                        "ageToInclusive": 3,
-                                      },
                                      {
                                        "gboAgeProfileId": 4,
                                        "name": "Volwassene (19 t/m 64 jaar)",
@ -1144,7 +1121,7 @@ paths:
                                    ],
                                  "productCategory":
                                    {
-                                      "productCategoryId": 3,
+                                      "productCategoryId": 2,
                                      "isTravelProduct": true,
                                      "name": "Afgekocht reisrecht",
                                    },
@ -1157,26 +1134,10 @@ paths:
                                  "incompatibleProducts": [],
                                  "mandatoryCustomerDataItems":
                                    [                                      
-                                      {
-                                        "mandatoryCustomerDataItemId": 1,
-                                        "customerDataItem": "birthname",
-                                      },
-                                      {
-                                        "mandatoryCustomerDataItemId": 2,
-                                        "customerDataItem": "surname",
-                                      },
-                                      {
-                                        "mandatoryCustomerDataItemId": 3,
-                                        "customerDataItem": "dateOfBirth",
-                                      },
                                      {
                                        "mandatoryCustomerDataItemId": 4,
                                        "customerDataItem": "emailAddress",
                                      },
-                                      {
-                                        "mandatoryCustomerDataItemId": 7,
-                                        "customerDataItem": "ovPayToken",
-                                      },
                                      {
                                        "mandatoryCustomerDataItemId": 8,
                                        "customerDataItem": "padBirthDate",
@ -1260,6 +1221,12 @@ paths:
                                {
                                  "productId": 115,
                                  "parentProductId": 109,
+                                  "layerInfo": {
+                                    "layerInfoId": 3,
+                                    "choiceKey": "allowedGboAgeProfiles",
+                                    "choiceLabel": "Wat is uw geboortedatum?",
+                                    "isCustomChoice": false,
+                                  },
                                  "fikoArticleNumber": "1234",
                                  "gboPackageTemplateId": "33615",
                                  "tapConnectProductCode": null,
@ -1304,7 +1271,7 @@ paths:
                                    ],
                                  "productCategory":
                                    {
-                                      "productCategoryId": 3,
+                                      "productCategoryId": 2,
                                      "isTravelProduct": true,
                                      "name": "Afgekocht reisrecht",
                                    },
@ -1317,26 +1284,10 @@ paths:
                                  "incompatibleProducts": [],
                                  "mandatoryCustomerDataItems":
                                    [                                     
-                                      {
-                                        "mandatoryCustomerDataItemId": 1,
-                                        "customerDataItem": "birthname",
-                                      },
-                                      {
-                                        "mandatoryCustomerDataItemId": 2,
-                                        "customerDataItem": "surname",
-                                      },
-                                      {
-                                        "mandatoryCustomerDataItemId": 3,
-                                        "customerDataItem": "dateOfBirth",
-                                      },
                                      {
                                        "mandatoryCustomerDataItemId": 4,
                                        "customerDataItem": "emailAddress",
                                      },
-                                      {
-                                        "mandatoryCustomerDataItemId": 7,
-                                        "customerDataItem": "ovPayToken",
-                                      },
                                      {
                                        "mandatoryCustomerDataItemId": 8,
                                        "customerDataItem": "padBirthDate",
@ -1421,6 +1372,12 @@ paths:
                                      {
                                        "productId": 116,
                                        "parentProductId": 115,
+                                        "layerInfo": {
+                                          "layerInfoId": 1,
+                                          "choiceKey": "isRenewable",
+                                          "choiceLabel": "Kies voor een doorlopend abonnement of een enkele termijn",
+                                          "isCustomChoice": false,
+                                        },
                                        "fikoArticleNumber": "1234",
                                        "gboPackageTemplateId": "33615",
                                        "tapConnectProductCode": null,
@ -1465,7 +1422,7 @@ paths:
                                          ],
                                        "productCategory":
                                          {
-                                            "productCategoryId": 3,
+                                            "productCategoryId": 2,
                                            "isTravelProduct": true,
                                            "name": "Afgekocht reisrecht",
                                          },
@ -1478,26 +1435,10 @@ paths:
                                        "incompatibleProducts": [],
                                        "mandatoryCustomerDataItems":
                                          [
-                                            {
-                                              "mandatoryCustomerDataItemId": 1,
-                                              "customerDataItem": "birthname",
-                                            },
-                                            {
-                                              "mandatoryCustomerDataItemId": 2,
-                                              "customerDataItem": "surname",
-                                            },
-                                            {
-                                              "mandatoryCustomerDataItemId": 3,
-                                              "customerDataItem": "dateOfBirth",
-                                            },
                                            {
                                              "mandatoryCustomerDataItemId": 4,
                                              "customerDataItem": "emailAddress",
                                            },
-                                            {
-                                              "mandatoryCustomerDataItemId": 7,
-                                              "customerDataItem": "ovPayToken",
-                                            },
                                            {
                                              "mandatoryCustomerDataItemId": 8,
                                              "customerDataItem": "padBirthDate",
@ -1585,6 +1526,12 @@ paths:
                                      {
                                        "productId": 117,
                                        "parentProductId": 115,
+                                        "layerInfo": {
+                                          "layerInfoId": 1,
+                                          "choiceKey": "isRenewable",
+                                          "choiceLabel": "Kies voor een doorlopend abonnement of een enkele termijn",
+                                          "isCustomChoice": false,
+                                        },
                                        "fikoArticleNumber": "1234",
                                        "gboPackageTemplateId": "33615",
                                        "tapConnectProductCode": null,
@ -1629,7 +1576,7 @@ paths:
                                          ],
                                        "productCategory":
                                          {
-                                            "productCategoryId": 3,
+                                            "productCategoryId": 2,
                                            "isTravelProduct": true,
                                            "name": "Afgekocht reisrecht",
                                          },
@ -1642,26 +1589,10 @@ paths:
                                        "incompatibleProducts": [],
                                        "mandatoryCustomerDataItems":
                                          [
-                                            {
-                                              "mandatoryCustomerDataItemId": 1,
-                                              "customerDataItem": "birthname",
-                                            },
-                                            {
-                                              "mandatoryCustomerDataItemId": 2,
-                                              "customerDataItem": "surname",
-                                            },
-                                            {
-                                              "mandatoryCustomerDataItemId": 3,
-                                              "customerDataItem": "dateOfBirth",
-                                            },
                                            {
                                              "mandatoryCustomerDataItemId": 4,
                                              "customerDataItem": "emailAddress",
                                            },
-                                            {
-                                              "mandatoryCustomerDataItemId": 7,
-                                              "customerDataItem": "ovPayToken",
-                                            },
                                            {
                                              "mandatoryCustomerDataItemId": 8,
                                              "customerDataItem": "padBirthDate",
@ -1753,6 +1684,12 @@ paths:
                          {
                            "productId": 112,
                            "parentProductId": 49,
+                            "layerInfo": {
+                              "layerInfoId": 2,
+                              "choiceKey": "regio",
+                              "choiceLabel": "Kies de gewenste regio",
+                              "isCustomChoice": true,
+                            },
                            "fikoArticleNumber": "1234",
                            "gboPackageTemplateId": "33618",
                            "tapConnectProductCode": null,
@ -1782,12 +1719,6 @@ paths:
                            "customerSegments": [],
                            "allowedGboAgeProfiles":
                              [
-                                {
-                                  "gboAgeProfileId": 1,
-                                  "name": "Baby/peuter (0 t/m 3 jaar)",
-                                  "ageFromInclusive": 0,
-                                  "ageToInclusive": 3,
-                                },
                                {
                                  "gboAgeProfileId": 2,
                                  "name": "Kind (4 t/m 11 jaar)",
@ -1815,7 +1746,7 @@ paths:
                              ],
                            "productCategory":
                              {
-                                "productCategoryId": 3,
+                                "productCategoryId": 2,
                                "isTravelProduct": true,
                                "name": "Afgekocht reisrecht",
                              },
@ -1828,26 +1759,11 @@ paths:
                            "incompatibleProducts": [],
                            "mandatoryCustomerDataItems":
                              [
-                                {
-                                  "mandatoryCustomerDataItemId": 1,
-                                  "customerDataItem": "birthname",
-                                },
-                                {
-                                  "mandatoryCustomerDataItemId": 2,
-                                  "customerDataItem": "surname",
-                                },
-                                {
-                                  "mandatoryCustomerDataItemId": 3,
-                                  "customerDataItem": "dateOfBirth",
-                                },
+
                                {
                                  "mandatoryCustomerDataItemId": 4,
                                  "customerDataItem": "emailAddress",
                                },
-                                {
-                                  "mandatoryCustomerDataItemId": 7,
-                                  "customerDataItem": "ovPayToken",
-                                },
                                {
                                  "mandatoryCustomerDataItemId": 8,
                                  "customerDataItem": "padBirthDate",
@ -1937,6 +1853,53 @@ paths:
                    }
 components:
  schemas:
+    LayerInfoResponse:
+      type: object
+      description: >-
+        Gives information on the choice that the customer has to make, to enable the touchpoint 
+        to proceed further "down the product-tree" by selecting (PATCH-ing) the correct product-variant.
+        LayerInfo is not a mandatory product-attribute, but it should always be present on all product for which 
+        `parentProductId != null`.  (LayerInfo makes no sense for top-level parents as there is always a single starting point). \
+
+        **PMT should ensure that all products in the same "product-branch" (same `parentProductId`) have the same `layerInfoId` 
+        referenced. If a product is found to be in violation of this rule, its attribtue `isValid` should be set to `false`.**
+      required:
+        - layerInfoId
+        - choiceKey
+        - choiceLabel
+        - isCustomChoice 
+      properties:
+        layerInfoId:
+          example: 1
+          type: integer
+        choiceKey:
+          example: isRenewable
+          type: string
+          description: >-
+            Contains the JSON Key of the product-attribute that the customer has to make some 
+            choice on (determined by PMT), so that te correct product-variant can be selected by the touchpoint. For some 
+            decisions (like region), there is no product attribute, and thus `isCustomChoice` will be set 
+            to `true`, and `choiceKey` can then be set to any string on which touchpoints can also trigger 
+            behaviour if desired (think "region picker tool"). Therefore, reuse of choiceKeys should be 
+            the goal, so touchoints can keep their triggers simple and prevent duplication of 
+            similar choiceKeys to trigger the same behaviour.
+        choiceLabel:
+          example: Kies voor een doorlopend abonnement of een enkele termijn
+          type: string
+          description: >-
+            Contains a human-readable label for the choice that the customer has to make - this label 
+            should be something that is easy to understand for the customer. Only one label (and thus, one language) 
+            is supported; label translations should be handled by the touchpoint.
+        isCustomChoice:
+          example: false
+          type: boolean
+          description: >-
+            Indicates if the choice is a custom choice. If `false`, the PMT should fill `choiceKey` with the 
+            "differing attribute for this product-layer" and the user should not be able to override this. When 
+            no single attribute can be pinpointed by PMT, the product will become invalid (`isValid == false`) until either 
+            a situation with a single differing attribute is created, or if `isCustomChoice` is set to `true` - this would, 
+            however, also mean that touchpoints should be notified of this, especially if the configured LayerInfo contains 
+            a new, not previously used, `choiceKey`.
    GboAgeProfileResponse:
      type: object
      required:
@ -2199,6 +2162,8 @@ components:
        parentProductId:
          type: integer
          example: 1
+        layerInfo:
+          $ref: '#/components/schemas/LayerInfoResponse'
        fikoArticleNumber:
          type: string
          description: The article number of the product in FIKO
--- a/src/openapi/products/SE-products-TP.yaml
+++ b/src/openapi/products/SE-products-TP.yaml
@ -90,7 +90,7 @@ paths:
                            "productDescription": "Reis een dag met het openbaar vervoer bij HTM",
                            "productCategory":
                              {
-                                "productCategoryId": 6,
+                                "productCategoryId": 5,
                                "isTravelProduct": false,
                                "name": "Barcode",
                              },
@ -123,7 +123,7 @@ paths:
                            "productDescription": "Reis een dag met het openbaar vervoer bij HTM",
                            "productCategory":
                              {
-                                "productCategoryId": 6,
+                                "productCategoryId": 5,
                                "isTravelProduct": false,
                                "name": "Barcode",
                              },
@ -156,7 +156,7 @@ paths:
                            "productDescription": "Voor een vast bedrag onbeperkt reizen met EBS, HTM en RET in het gekozen gebied in de regio Rotterdam Den Haag.",
                            "productCategory":
                              {
-                                "productCategoryId": 3,
+                                "productCategoryId": 2,
                                "isTravelProduct": true,
                                "name": "Afgekocht reisrecht",
                              },
@ -222,7 +222,7 @@ paths:
                            "productDescription": "Reis een dag met het openbaar vervoer bij HTM",
                            "productCategory":
                              {
-                                "productCategoryId": 6,
+                                "productCategoryId": 5,
                                "isTravelProduct": false,
                                "name": "Barcode",
                              },
@ -313,6 +313,7 @@ paths:
                    {
                      "productId": 24,
                      "parentProductId": null,
+                      "layerInfo": null,
                      "fikoArticleNumber": "1234",
                      "gboPackageTemplateId": "30901",
                      "tapConnectProductCode": null,
@ -425,6 +426,7 @@ paths:
                    {
                      "productId": 126,
                      "parentProductId": null,
+                      "layerInfo": null,
                      "fikoArticleNumber": "1234",
                      "gboPackageTemplateId": "30001",
                      "tapConnectProductCode": null,
@ -527,6 +529,12 @@ paths:
                          {
                            "productId": 119,
                            "parentProductId": 126,
+                            "layerInfo": {
+                              "layerInfoId": 1,
+                              "choiceKey": "isRenewable",
+                              "choiceLabel": "Kies voor een doorlopend abonnement of een enkele termijn",
+                              "isCustomChoice": false,
+                            },
                            "fikoArticleNumber": "1234",
                            "gboPackageTemplateId": "30001",
                            "tapConnectProductCode": null,
@ -641,6 +649,12 @@ paths:
                          {
                            "productId": 120,
                            "parentProductId": 126,
+                            "layerInfo": {
+                              "layerInfoId": 1,
+                              "choiceKey": "isRenewable",
+                              "choiceLabel": "Kies voor een doorlopend abonnement of een enkele termijn",
+                              "isCustomChoice": false,
+                            },
                            "fikoArticleNumber": "1234",
                            "gboPackageTemplateId": "30001",
                            "tapConnectProductCode": null,
@ -765,6 +779,7 @@ paths:
                    {
                      "productId": 49,
                      "parentProductId": null,
+                      "layerInfo": null,
                      "fikoArticleNumber": "1234",
                      "gboPackageTemplateId": null,
                      "tapConnectProductCode": null,
@ -794,12 +809,6 @@ paths:
                      "customerSegments": [],
                      "allowedGboAgeProfiles":
                        [
-                          {
-                            "gboAgeProfileId": 1,
-                            "name": "Baby/peuter (0 t/m 3 jaar)",
-                            "ageFromInclusive": 0,
-                            "ageToInclusive": 3,
-                          },
                          {
                            "gboAgeProfileId": 2,
                            "name": "Kind (4 t/m 11 jaar)",
@ -827,7 +836,7 @@ paths:
                        ],
                      "productCategory":
                        {
-                          "productCategoryId": 3,
+                          "productCategoryId": 2,
                          "isTravelProduct": true,
                          "name": "Afgekocht reisrecht",
                        },
@ -837,26 +846,10 @@ paths:
                      "incompatibleProducts": [],
                      "mandatoryCustomerDataItems":
                        [
-                          {
-                            "mandatoryCustomerDataItemId": 1,
-                            "customerDataItem": "birthname",
-                          },
-                          {
-                            "mandatoryCustomerDataItemId": 2,
-                            "customerDataItem": "surname",
-                          },
-                          {
-                            "mandatoryCustomerDataItemId": 3,
-                            "customerDataItem": "dateOfBirth",
-                          },
                          {
                            "mandatoryCustomerDataItemId": 4,
                            "customerDataItem": "emailAddress",
                          },
-                          {
-                            "mandatoryCustomerDataItemId": 7,
-                            "customerDataItem": "ovPayToken",
-                          },
                          {
                            "mandatoryCustomerDataItemId": 8,
                            "customerDataItem": "padBirthDate",
@ -928,6 +921,12 @@ paths:
                          {
                            "productId": 109,
                            "parentProductId": 49,
+                            "layerInfo": {
+                              "layerInfoId": 2,
+                              "choiceKey": "regio",
+                              "choiceLabel": "Kies de gewenste regio",
+                              "isCustomChoice": true,
+                            },
                            "fikoArticleNumber": "1234",
                            "gboPackageTemplateId": "33615",
                            "tapConnectProductCode": null,
@ -957,12 +956,6 @@ paths:
                            "customerSegments": [],
                            "allowedGboAgeProfiles":
                              [
-                                {
-                                  "gboAgeProfileId": 1,
-                                  "name": "Baby/peuter (0 t/m 3 jaar)",
-                                  "ageFromInclusive": 0,
-                                  "ageToInclusive": 3,
-                                },
                                {
                                  "gboAgeProfileId": 2,
                                  "name": "Kind (4 t/m 11 jaar)",
@ -990,7 +983,7 @@ paths:
                              ],
                            "productCategory":
                              {
-                                "productCategoryId": 3,
+                                "productCategoryId": 2,
                                "isTravelProduct": true,
                                "name": "Afgekocht reisrecht",
                              },
@ -1003,26 +996,10 @@ paths:
                            "incompatibleProducts": [],
                            "mandatoryCustomerDataItems":
                              [
-                                {
-                                  "mandatoryCustomerDataItemId": 1,
-                                  "customerDataItem": "birthname",
-                                },
-                                {
-                                  "mandatoryCustomerDataItemId": 2,
-                                  "customerDataItem": "surname",
-                                },
-                                {
-                                  "mandatoryCustomerDataItemId": 3,
-                                  "customerDataItem": "dateOfBirth",
-                                },
                                {
                                  "mandatoryCustomerDataItemId": 4,
                                  "customerDataItem": "emailAddress",
                                },
-                                {
-                                  "mandatoryCustomerDataItemId": 7,
-                                  "customerDataItem": "ovPayToken",
-                                },
                                {
                                  "mandatoryCustomerDataItemId": 8,
                                  "customerDataItem": "padBirthDate",
@ -1094,6 +1071,12 @@ paths:
                                {
                                  "productId": 114,
                                  "parentProductId": 109,
+                                  "layerInfo": {
+                                    "layerInfoId": 3,
+                                    "choiceKey": "allowedGboAgeProfiles",
+                                    "choiceLabel": "Wat is uw geboortedatum?",
+                                    "isCustomChoice": false,
+                                  },
                                  "fikoArticleNumber": "1234",
                                  "gboPackageTemplateId": "33615",
                                  "tapConnectProductCode": null,
@ -1123,12 +1106,6 @@ paths:
                                  "customerSegments": [],
                                  "allowedGboAgeProfiles":
                                    [
-                                      {
-                                        "gboAgeProfileId": 1,
-                                        "name": "Baby/peuter (0 t/m 3 jaar)",
-                                        "ageFromInclusive": 0,
-                                        "ageToInclusive": 3,
-                                      },
                                      {
                                        "gboAgeProfileId": 4,
                                        "name": "Volwassene (19 t/m 64 jaar)",
@ -1144,7 +1121,7 @@ paths:
                                    ],
                                  "productCategory":
                                    {
-                                      "productCategoryId": 3,
+                                      "productCategoryId": 2,
                                      "isTravelProduct": true,
                                      "name": "Afgekocht reisrecht",
                                    },
@ -1157,26 +1134,10 @@ paths:
                                  "incompatibleProducts": [],
                                  "mandatoryCustomerDataItems":
                                    [                                      
-                                      {
-                                        "mandatoryCustomerDataItemId": 1,
-                                        "customerDataItem": "birthname",
-                                      },
-                                      {
-                                        "mandatoryCustomerDataItemId": 2,
-                                        "customerDataItem": "surname",
-                                      },
-                                      {
-                                        "mandatoryCustomerDataItemId": 3,
-                                        "customerDataItem": "dateOfBirth",
-                                      },
                                      {
                                        "mandatoryCustomerDataItemId": 4,
                                        "customerDataItem": "emailAddress",
                                      },
-                                      {
-                                        "mandatoryCustomerDataItemId": 7,
-                                        "customerDataItem": "ovPayToken",
-                                      },
                                      {
                                        "mandatoryCustomerDataItemId": 8,
                                        "customerDataItem": "padBirthDate",
@ -1260,6 +1221,12 @@ paths:
                                {
                                  "productId": 115,
                                  "parentProductId": 109,
+                                  "layerInfo": {
+                                    "layerInfoId": 3,
+                                    "choiceKey": "allowedGboAgeProfiles",
+                                    "choiceLabel": "Wat is uw geboortedatum?",
+                                    "isCustomChoice": false,
+                                  },
                                  "fikoArticleNumber": "1234",
                                  "gboPackageTemplateId": "33615",
                                  "tapConnectProductCode": null,
@ -1304,7 +1271,7 @@ paths:
                                    ],
                                  "productCategory":
                                    {
-                                      "productCategoryId": 3,
+                                      "productCategoryId": 2,
                                      "isTravelProduct": true,
                                      "name": "Afgekocht reisrecht",
                                    },
@ -1317,26 +1284,10 @@ paths:
                                  "incompatibleProducts": [],
                                  "mandatoryCustomerDataItems":
                                    [                                     
-                                      {
-                                        "mandatoryCustomerDataItemId": 1,
-                                        "customerDataItem": "birthname",
-                                      },
-                                      {
-                                        "mandatoryCustomerDataItemId": 2,
-                                        "customerDataItem": "surname",
-                                      },
-                                      {
-                                        "mandatoryCustomerDataItemId": 3,
-                                        "customerDataItem": "dateOfBirth",
-                                      },
                                      {
                                        "mandatoryCustomerDataItemId": 4,
                                        "customerDataItem": "emailAddress",
                                      },
-                                      {
-                                        "mandatoryCustomerDataItemId": 7,
-                                        "customerDataItem": "ovPayToken",
-                                      },
                                      {
                                        "mandatoryCustomerDataItemId": 8,
                                        "customerDataItem": "padBirthDate",
@ -1421,6 +1372,12 @@ paths:
                                      {
                                        "productId": 116,
                                        "parentProductId": 115,
+                                        "layerInfo": {
+                                          "layerInfoId": 1,
+                                          "choiceKey": "isRenewable",
+                                          "choiceLabel": "Kies voor een doorlopend abonnement of een enkele termijn",
+                                          "isCustomChoice": false,
+                                        },
                                        "fikoArticleNumber": "1234",
                                        "gboPackageTemplateId": "33615",
                                        "tapConnectProductCode": null,
@ -1465,7 +1422,7 @@ paths:
                                          ],
                                        "productCategory":
                                          {
-                                            "productCategoryId": 3,
+                                            "productCategoryId": 2,
                                            "isTravelProduct": true,
                                            "name": "Afgekocht reisrecht",
                                          },
@ -1478,26 +1435,10 @@ paths:
                                        "incompatibleProducts": [],
                                        "mandatoryCustomerDataItems":
                                          [
-                                            {
-                                              "mandatoryCustomerDataItemId": 1,
-                                              "customerDataItem": "birthname",
-                                            },
-                                            {
-                                              "mandatoryCustomerDataItemId": 2,
-                                              "customerDataItem": "surname",
-                                            },
-                                            {
-                                              "mandatoryCustomerDataItemId": 3,
-                                              "customerDataItem": "dateOfBirth",
-                                            },
                                            {
                                              "mandatoryCustomerDataItemId": 4,
                                              "customerDataItem": "emailAddress",
                                            },
-                                            {
-                                              "mandatoryCustomerDataItemId": 7,
-                                              "customerDataItem": "ovPayToken",
-                                            },
                                            {
                                              "mandatoryCustomerDataItemId": 8,
                                              "customerDataItem": "padBirthDate",
@ -1585,6 +1526,12 @@ paths:
                                      {
                                        "productId": 117,
                                        "parentProductId": 115,
+                                        "layerInfo": {
+                                          "layerInfoId": 1,
+                                          "choiceKey": "isRenewable",
+                                          "choiceLabel": "Kies voor een doorlopend abonnement of een enkele termijn",
+                                          "isCustomChoice": false,
+                                        },
                                        "fikoArticleNumber": "1234",
                                        "gboPackageTemplateId": "33615",
                                        "tapConnectProductCode": null,
@ -1629,7 +1576,7 @@ paths:
                                          ],
                                        "productCategory":
                                          {
-                                            "productCategoryId": 3,
+                                            "productCategoryId": 2,
                                            "isTravelProduct": true,
                                            "name": "Afgekocht reisrecht",
                                          },
@ -1642,26 +1589,10 @@ paths:
                                        "incompatibleProducts": [],
                                        "mandatoryCustomerDataItems":
                                          [
-                                            {
-                                              "mandatoryCustomerDataItemId": 1,
-                                              "customerDataItem": "birthname",
-                                            },
-                                            {
-                                              "mandatoryCustomerDataItemId": 2,
-                                              "customerDataItem": "surname",
-                                            },
-                                            {
-                                              "mandatoryCustomerDataItemId": 3,
-                                              "customerDataItem": "dateOfBirth",
-                                            },
                                            {
                                              "mandatoryCustomerDataItemId": 4,
                                              "customerDataItem": "emailAddress",
                                            },
-                                            {
-                                              "mandatoryCustomerDataItemId": 7,
-                                              "customerDataItem": "ovPayToken",
-                                            },
                                            {
                                              "mandatoryCustomerDataItemId": 8,
                                              "customerDataItem": "padBirthDate",
@ -1723,7 +1654,7 @@ paths:
                                                      "country": "Nederland",
                                                      "emailAddress": "info@htm.nl",
                                                      "phoneNumber": "070 374 9002",
-                                                      "taxId": "572309345923",
+                                                      "taxId": 572309345923,
                                                      "imageReference": "https://www.htm.nl/media/leif2leu/htm-logo-mobile.svg",
                                                    },
                                                },
@ -1753,6 +1684,12 @@ paths:
                          {
                            "productId": 112,
                            "parentProductId": 49,
+                            "layerInfo": {
+                              "layerInfoId": 2,
+                              "choiceKey": "regio",
+                              "choiceLabel": "Kies de gewenste regio",
+                              "isCustomChoice": true,
+                            },
                            "fikoArticleNumber": "1234",
                            "gboPackageTemplateId": "33618",
                            "tapConnectProductCode": null,
@ -1782,12 +1719,6 @@ paths:
                            "customerSegments": [],
                            "allowedGboAgeProfiles":
                              [
-                                {
-                                  "gboAgeProfileId": 1,
-                                  "name": "Baby/peuter (0 t/m 3 jaar)",
-                                  "ageFromInclusive": 0,
-                                  "ageToInclusive": 3,
-                                },
                                {
                                  "gboAgeProfileId": 2,
                                  "name": "Kind (4 t/m 11 jaar)",
@ -1815,7 +1746,7 @@ paths:
                              ],
                            "productCategory":
                              {
-                                "productCategoryId": 3,
+                                "productCategoryId": 2,
                                "isTravelProduct": true,
                                "name": "Afgekocht reisrecht",
                              },
@ -1828,26 +1759,11 @@ paths:
                            "incompatibleProducts": [],
                            "mandatoryCustomerDataItems":
                              [
-                                {
-                                  "mandatoryCustomerDataItemId": 1,
-                                  "customerDataItem": "birthname",
-                                },
-                                {
-                                  "mandatoryCustomerDataItemId": 2,
-                                  "customerDataItem": "surname",
-                                },
-                                {
-                                  "mandatoryCustomerDataItemId": 3,
-                                  "customerDataItem": "dateOfBirth",
-                                },
+
                                {
                                  "mandatoryCustomerDataItemId": 4,
                                  "customerDataItem": "emailAddress",
                                },
-                                {
-                                  "mandatoryCustomerDataItemId": 7,
-                                  "customerDataItem": "ovPayToken",
-                                },
                                {
                                  "mandatoryCustomerDataItemId": 8,
                                  "customerDataItem": "padBirthDate",
@ -1905,7 +1821,7 @@ paths:
                                          "country": "Nederland",
                                          "emailAddress": "info@htm.nl",
                                          "phoneNumber": "070 374 9002",
-                                          "taxId": "572309345923",
+                                          "taxId": 572309345923,
                                          "imageReference": "https://www.htm.nl/media/leif2leu/htm-logo-mobile.svg",
                                        },
                                    },
@ -1937,6 +1853,53 @@ paths:
                    }
 components:
  schemas:
+    LayerInfoResponse:
+      type: object
+      description: >-
+        Gives information on the choice that the customer has to make, to enable the touchpoint 
+        to proceed further "down the product-tree" by selecting (PATCH-ing) the correct product-variant.
+        LayerInfo is not a mandatory product-attribute, but it should always be present on all product for which 
+        `parentProductId != null`.  (LayerInfo makes no sense for top-level parents as there is always a single starting point). \
+
+        **PMT should ensure that all products in the same "product-branch" (same `parentProductId`) have the same `layerInfoId` 
+        referenced. If a product is found to be in violation of this rule, its attribtue `isValid` should be set to `false`.**
+      required:
+        - layerInfoId
+        - choiceKey
+        - choiceLabel
+        - isCustomChoice 
+      properties:
+        layerInfoId:
+          example: 1
+          type: integer
+        choiceKey:
+          example: isRenewable
+          type: string
+          description: >-
+            Contains the JSON Key of the product-attribute that the customer has to make some 
+            choice on (determined by PMT), so that te correct product-variant can be selected by the touchpoint. For some 
+            decisions (like region), there is no product attribute, and thus `isCustomChoice` will be set 
+            to `true`, and `choiceKey` can then be set to any string on which touchpoints can also trigger 
+            behaviour if desired (think "region picker tool"). Therefore, reuse of choiceKeys should be 
+            the goal, so touchoints can keep their triggers simple and prevent duplication of 
+            similar choiceKeys to trigger the same behaviour.
+        choiceLabel:
+          example: Kies voor een doorlopend abonnement of een enkele termijn
+          type: string
+          description: >-
+            Contains a human-readable label for the choice that the customer has to make - this label 
+            should be something that is easy to understand for the customer. Only one label (and thus, one language) 
+            is supported; label translations should be handled by the touchpoint.
+        isCustomChoice:
+          example: false
+          type: boolean
+          description: >-
+            Indicates if the choice is a custom choice. If `false`, the PMT should fill `choiceKey` with the 
+            "differing attribute for this product-layer" and the user should not be able to override this. When 
+            no single attribute can be pinpointed by PMT, the product will become invalid (`isValid == false`) until either 
+            a situation with a single differing attribute is created, or if `isCustomChoice` is set to `true` - this would, 
+            however, also mean that touchpoints should be notified of this, especially if the configured LayerInfo contains 
+            a new, not previously used, `choiceKey`.
    GboAgeProfileResponse:
      type: object
      required:
@ -2199,6 +2162,8 @@ components:
        parentProductId:
          type: integer
          example: 1
+        layerInfo:
+          $ref: '#/components/schemas/LayerInfoResponse'
        fikoArticleNumber:
          type: string
          description: The article number of the product in FIKO
--- a/src/openapi/products/productreference-crud.yaml
+++ b/src/openapi/products/productreference-crud.yaml
--- a/src/openapi/products/products-crud.yaml
+++ b/src/openapi/products/products-crud.yaml
--- a/src/openapi/sendgrid/sendgrid-oas_v3.yaml
+++ b/src/openapi/sendgrid/sendgrid-oas_v3.yaml
@ -0,0 +1,593 @@
+openapi: "3.0.3"
+info:
+  title: Twilio SendGrid v3 API
+  description: >-
+    The Twilio SendGrid v3 API provides a simple, intuitive RESTful-like
+    interface for sending email at scale, monitoring email engagement data
+    programmatically, managing account settings, and more. This OpenAPI
+    representation of the Twilio SendGrid v3 API allows you to generate helper
+    libraries (in addition to the libraries officially released by Twilio
+    SendGrid) and build mock servers for testing.
+  termsOfService: https://www.twilio.com/legal/tos
+  contact:
+    name: Twilio SendGrid Support
+    url: https://support.sendgrid.com/hc/en-us
+  license:
+    name: MIT
+    url: https://github.com/sendgrid/sendgrid-oai/blob/main/LICENSE
+  version: 1.8.1
+servers:
+  - url: https://https://services.acc.api.htm.nl/sendgrid
+    description: The Integration Layer SendGrid API integration (Acceptance).
+paths:
+  /v3/mail/send:
+    post:
+      operationId: POST_mail-send
+      summary: v3 Mail Send
+      tags:
+        - Mail Send
+      description: |-
+        The Mail Send endpoint allows you to send email over SendGrid's v3 Web API, the most recent version of our API. If you are looking for documentation about the v2 Mail Send endpoint, see our [v2 API Reference](https://sendgrid.com/docs/API_Reference/Web_API/mail.html).
+  
+        ## Helper Libraries
+  
+        Twilio SendGrid provides libraries to help you quickly and easily integrate with the v3 Web API in 7 different languages:
+  
+        * [C#](https://github.com/sendgrid/sendgrid-csharp) 
+        * [Go](https://github.com/sendgrid/sendgrid-go)
+        * [Java](https://github.com/sendgrid/sendgrid-java)
+        * [Node JS](https://github.com/sendgrid/sendgrid-nodejs)
+        * [PHP](https://github.com/sendgrid/sendgrid-php)
+        * [Python](https://github.com/sendgrid/sendgrid-python)
+        * [Ruby](https://github.com/sendgrid/sendgrid-ruby)
+  
+        ## Dynamic Transactional Templates and Handlebars
+  
+        In order to send a dynamic template, specify the template ID with the `template_id` parameter. 
+  
+        To specify handlebar substitutions, define your substitutions in the request JSON with this syntax:
+  
+        ```
+        "dynamic_template_data": {
+           "guest": "Jane Doe",
+           "partysize": "4",
+           "english": true,
+           "date": "April 1st, 2021"
+        }
+        ```
+  
+        For more information about Dynamic Transactional Templates and Handlebars, see our documentation and reference pages.
+  
+        * [How to send an email with Dynamic Transactional Templates
+        ](https://sendgrid.com/docs/ui/sending-email/how-to-send-an-email-with-dynamic-transactional-templates/)
+        * [Using Handlebars](https://sendgrid.com/docs/for-developers/sending-email/using-handlebars/) 
+  
+        ## Mail Body Compression
+  
+        Mail body compression is available to some high volume accounts. Talk to your CSM if you are interested in this functionality. Mail body compression works by setting up a JSON payload as defined on this page, then compressing it with gzip (the gzip file can be no more than 30mb).
+  
+        To use mail body compression:
+  
+        1. Add a `Content-Encoding` header, with a value of `gzip`.  
+           a. `Content-Encoding: gzip` 
+        2. Send the gzip as a data-binary.  
+           a. `--data-binary '@data.json.gz'
+        `
+  
+        ## Multiple Reply-To Emails
+  
+        Using `reply_to_list` allows senders to include more than one recipient email address to receive reply and/or bounce messages from the recipient of the email.
+  
+        ### Usage Considerations
+  
+        * `reply_to` is mutually exclusive with `reply_to_list`. If both are used, then the API call will be rejected. 
+        * The `reply_to_list` object, when used, must at least have an email parameter and may also contain a name parameter.
+        * Each email address in the `reply_to_list` should be unique.
+        * There is a limit of 1000 `reply_to_list` emails per mail/send request.
+        * In SMTP calls, we will omit any invalid emails.
+  
+        ### Possible 400 Error Messages
+  
+        * `reply_to` is mutually exclusive with `reply_to_list`.
+        * The `reply_to_list` object, when used, must at least have an email parameter and may also contain a name parameter.
+        * Each email address in the `reply_to_list` should be unique.
+        * There is a limit of X `reply_to` emails per mail/send request.
+        * The `reply_to_list` email does not contain a valid address.
+        * The `reply_to_list` email exceeds the maximum total length of X characters.
+        * The `reply_to_list` email parameter is required.
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                personalizations:
+                  type: array
+                  description: An array of messages and their metadata. Each object within personalizations can be thought of as an envelope - it defines who should receive an individual message and how that message should be handled. See our [Personalizations documentation](https://sendgrid.com/docs/for-developers/sending-email/personalizations/) for examples.
+                  uniqueItems: false
+                  maxItems: 1000
+                  items:
+                    type: object
+                    properties:
+                      from:
+                        $ref: "#/components/schemas/from_email_object"
+                      to:
+                        $ref: "#/components/schemas/to_email_array"
+                      cc:
+                        type: array
+                        description: An array of recipients who will receive a copy of your email. Each object in this array must contain the recipient's email address. Each object in the array may optionally contain the recipient's name.
+                        maxItems: 1000
+                        items:
+                          $ref: "#/components/schemas/cc_bcc_email_object"
+                      bcc:
+                        type: array
+                        description: An array of recipients who will receive a blind carbon copy of your email. Each object in this array must contain the recipient's email address. Each object in the array may optionally contain the recipient's name.
+                        maxItems: 1000
+                        items:
+                          $ref: "#/components/schemas/cc_bcc_email_object"
+                      subject:
+                        type: string
+                        description: The subject of your email. See character length requirements according to [RFC 2822](http://stackoverflow.com/questions/1592291/what-is-the-email-subject-length-limit#answer-1592310).
+                        minLength: 1
+                      headers:
+                        type: object
+                        description: 'A collection of JSON key/value pairs allowing you to specify handling instructions for your email. You may not overwrite the following headers: `x-sg-id`, `x-sg-eid`, `received`, `dkim-signature`, `Content-Type`, `Content-Transfer-Encoding`, `To`, `From`, `Subject`, `Reply-To`, `CC`, `BCC`'
+                      substitutions:
+                        type: object
+                        description: Substitutions allow you to insert data without using Dynamic Transactional Templates. This field should **not** be used in combination with a Dynamic Transactional Template, which can be identified by a `template_id` starting with `d-`. This field is a collection of key/value pairs following the pattern "substitution_tag":"value to substitute". The key/value pairs must be strings. These substitutions will apply to the text and html content of the body of your email, in addition to the `subject` and `reply-to` parameters. The total collective size of your substitutions may not exceed 10,000 bytes per personalization object.
+                        maxProperties: 10000
+                      dynamic_template_data:
+                        type: object
+                        description: Dynamic template data is available using Handlebars syntax in Dynamic Transactional Templates. This field should be used in combination with a Dynamic Transactional Template, which can be identified by a `template_id` starting with `d-`. This field is a collection of key/value pairs following the pattern "variable_name":"value to insert".
+                      custom_args:
+                        type: object
+                        description: Values that are specific to this personalization that will be carried along with the email and its activity data. Substitutions will not be made on custom arguments, so any string that is entered into this parameter will be assumed to be the custom argument that you would like to be used. This field may not exceed 10,000 bytes.
+                        maxProperties: 10000
+                      send_at:
+                        type: integer
+                        description: A unix timestamp allowing you to specify when your email should be delivered. Scheduling delivery more than 72 hours in advance is forbidden.
+                    required:
+                      - to
+                from:
+                  $ref: "#/components/schemas/from_email_object"
+                reply_to:
+                  $ref: "#/components/schemas/reply_to_email_object"
+                reply_to_list:
+                  type: array
+                  description: An array of recipients who will receive replies and/or bounces. Each object in this array must contain the recipient's email address. Each object in the array may optionally contain the recipient's name. You can either choose to use “reply_to” field or “reply_to_list” but not both.
+                  uniqueItems: true
+                  maxItems: 1000
+                  items:
+                    type: object
+                    properties:
+                      email:
+                        type: string
+                        description: The email address where any replies or bounces will be returned.
+                        format: email
+                      name:
+                        type: string
+                        description: A name or title associated with the `reply_to_list` email address.
+                    required:
+                      - email
+                subject:
+                  type: string
+                  description: The global or 'message level' subject of your email. This may be overridden by subject lines set in personalizations.
+                  minLength: 1
+                content:
+                  type: array
+                  description: An array where you can specify the content of your email. You can include multiple [MIME types](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types) of content, but you must specify at least one MIME type. To include more than one MIME type, add another object to the array containing the `type` and `value` parameters.
+                  items:
+                    type: object
+                    properties:
+                      type:
+                        type: string
+                        description: The MIME type of the content you are including in your email (e.g., `“text/plain”` or `“text/html”`).
+                        minLength: 1
+                      value:
+                        type: string
+                        description: The actual content of the specified MIME type that you are including in your email.
+                        minLength: 1
+                    required:
+                      - type
+                      - value
+                attachments:
+                  type: array
+                  description: An array of objects where you can specify any attachments you want to include.
+                  items:
+                    type: object
+                    properties:
+                      content:
+                        type: string
+                        description: The Base64 encoded content of the attachment.
+                        minLength: 1
+                      type:
+                        type: string
+                        description: The MIME type of the content you are attaching (e.g., `“text/plain”` or `“text/html”`).
+                        minLength: 1
+                      filename:
+                        type: string
+                        description: The attachment's filename.
+                      disposition:
+                        type: string
+                        default: attachment
+                        description: The attachment's content-disposition, specifying how you would like the attachment to be displayed. For example, `“inline”` results in the attached file are displayed automatically within the message while `“attachment”` results in the attached file require some action to be taken before it is displayed, such as opening or downloading the file.
+                        enum:
+                          - inline
+                          - attachment
+                      content_id:
+                        type: string
+                        description: The attachment's content ID. This is used when the disposition is set to `“inline”` and the attachment is an image, allowing the file to be displayed within the body of your email.
+                    required:
+                      - content
+                      - filename
+                template_id:
+                  type: string
+                  description: An email template ID. A template that contains a subject and content — either text or html — will override any subject and content values specified at the personalizations or message level.
+                headers:
+                  description: An object containing key/value pairs of header names and the value to substitute for them. The key/value pairs must be strings. You must ensure these are properly encoded if they contain unicode characters. These headers cannot be one of the reserved headers.
+                  type: object
+                categories:
+                  type: array
+                  description: 'An array of category names for this message. Each category name may not exceed 255 characters. '
+                  uniqueItems: true
+                  maxItems: 10
+                  items:
+                    type: string
+                    maxLength: 255
+                custom_args:
+                  description: Values that are specific to the entire send that will be carried along with the email and its activity data.  Key/value pairs must be strings. Substitutions will not be made on custom arguments, so any string that is entered into this parameter will be assumed to be the custom argument that you would like to be used. This parameter is overridden by `custom_args` set at the personalizations level. Total `custom_args` size may not exceed 10,000 bytes.
+                  type: string
+                send_at:
+                  type: integer
+                  description: A unix timestamp allowing you to specify when you want your email to be delivered. This may be overridden by the `send_at` parameter set at the personalizations level. Delivery cannot be scheduled more than 72 hours in advance. If you have the flexibility, it's better to schedule mail for off-peak times. Most emails are scheduled and sent at the top of the hour or half hour. Scheduling email to avoid peak times — for example, scheduling at 10:53 — can result in lower deferral rates due to the reduced traffic during off-peak times.
+                batch_id:
+                  type: string
+                  description: An ID representing a batch of emails to be sent at the same time. Including a `batch_id` in your request allows you include this email in that batch. It also enables you to cancel or pause the delivery of that batch. For more information, see the [Cancel Scheduled Sends API](https://sendgrid.com/docs/api-reference/).
+                asm:
+                  type: object
+                  description: An object allowing you to specify how to handle unsubscribes.
+                  properties:
+                    group_id:
+                      type: integer
+                      description: The unsubscribe group to associate with this email.
+                    groups_to_display:
+                      type: array
+                      description: An array containing the unsubscribe groups that you would like to be displayed on the unsubscribe preferences page.
+                      maxItems: 25
+                      items:
+                        type: integer
+                  required:
+                    - group_id
+                ip_pool_name:
+                  type: string
+                  description: The IP Pool that you would like to send this email from.
+                  minLength: 2
+                  maxLength: 64
+                mail_settings:
+                  type: object
+                  description: A collection of different mail settings that you can use to specify how you would like this email to be handled.
+                  properties:
+                    bypass_list_management:
+                      type: object
+                      description: Allows you to bypass all unsubscribe groups and suppressions to ensure that the email is delivered to every single recipient. This should only be used in emergencies when it is absolutely necessary that every recipient receives your email. This filter cannot be combined with any other bypass filters. See our [documentation](https://sendgrid.com/docs/ui/sending-email/index-suppressions/#bypass-suppressions) for more about bypass filters.
+                      properties:
+                        enable:
+                          type: boolean
+                          description: Indicates if this setting is enabled.
+                    bypass_spam_management:
+                      type: object
+                      description: Allows you to bypass the spam report list to ensure that the email is delivered to recipients. Bounce and unsubscribe lists will still be checked; addresses on these other lists will not receive the message. This filter cannot be combined with the `bypass_list_management` filter. See our [documentation](https://sendgrid.com/docs/ui/sending-email/index-suppressions/#bypass-suppressions) for more about bypass filters.
+                      properties:
+                        enable:
+                          type: boolean
+                          description: Indicates if this setting is enabled.
+                    bypass_bounce_management:
+                      type: object
+                      description: Allows you to bypass the bounce list to ensure that the email is delivered to recipients. Spam report and unsubscribe lists will still be checked; addresses on these other lists will not receive the message. This filter cannot be combined with the `bypass_list_management` filter. See our [documentation](https://sendgrid.com/docs/ui/sending-email/index-suppressions/#bypass-suppressions) for more about bypass filters.
+                      properties:
+                        enable:
+                          type: boolean
+                          description: Indicates if this setting is enabled.
+                    bypass_unsubscribe_management:
+                      type: object
+                      description: Allows you to bypass the global unsubscribe list to ensure that the email is delivered to recipients. Bounce and spam report lists will still be checked; addresses on these other lists will not receive the message. This filter applies only to global unsubscribes and will not bypass group unsubscribes. This filter cannot be combined with the `bypass_list_management` filter. See our [documentation](https://sendgrid.com/docs/ui/sending-email/index-suppressions/#bypass-suppressions) for more about bypass filters.
+                      properties:
+                        enable:
+                          type: boolean
+                          description: Indicates if this setting is enabled.
+                    footer:
+                      type: object
+                      description: The default footer that you would like included on every email.
+                      properties:
+                        enable:
+                          type: boolean
+                          description: Indicates if this setting is enabled.
+                        text:
+                          type: string
+                          description: The plain text content of your footer.
+                        html:
+                          type: string
+                          description: The HTML content of your footer.
+                    sandbox_mode:
+                      type: object
+                      description: Sandbox Mode allows you to send a test email to ensure that your request body is valid and formatted correctly.
+                      properties:
+                        enable:
+                          type: boolean
+                          description: Indicates if this setting is enabled.
+                tracking_settings:
+                  type: object
+                  description: Settings to determine how you would like to track the metrics of how your recipients interact with your email.
+                  properties:
+                    click_tracking:
+                      type: object
+                      description: Allows you to track if a recipient clicked a link in your email.
+                      properties:
+                        enable:
+                          type: boolean
+                          description: Indicates if this setting is enabled.
+                        enable_text:
+                          type: boolean
+                          description: Indicates if this setting should be included in the `text/plain` portion of your email.
+                    open_tracking:
+                      type: object
+                      description: Allows you to track if the email was opened by including a single pixel image in the body of the content. When the pixel is loaded, Twilio SendGrid can log that the email was opened.
+                      properties:
+                        enable:
+                          type: boolean
+                          description: Indicates if this setting is enabled.
+                        substitution_tag:
+                          type: string
+                          description: Allows you to specify a substitution tag that you can insert in the body of your email at a location that you desire. This tag will be replaced by the open tracking pixel.
+                    subscription_tracking:
+                      type: object
+                      description: Allows you to insert a subscription management link at the bottom of the text and HTML bodies of your email. If you would like to specify the location of the link within your email, you may use the `substitution_tag`.
+                      properties:
+                        enable:
+                          type: boolean
+                          description: Indicates if this setting is enabled.
+                        text:
+                          type: string
+                          description: Text to be appended to the email with the subscription tracking link. You may control where the link is by using the tag <% %>
+                        html:
+                          type: string
+                          description: HTML to be appended to the email with the subscription tracking link. You may control where the link is by using the tag <% %>
+                        substitution_tag:
+                          type: string
+                          description: "A tag that will be replaced with the unsubscribe URL. for example: `[unsubscribe_url]`. If this parameter is used, it will override both the `text` and `html` parameters. The URL of the link will be placed at the substitution tag's location with no additional formatting."
+                    ganalytics:
+                      type: object
+                      description: Allows you to enable tracking provided by Google Analytics.
+                      properties:
+                        enable:
+                          type: boolean
+                          description: Indicates if this setting is enabled.
+                        utm_source:
+                          type: string
+                          description: Name of the referrer source. (e.g. Google, SomeDomain.com, or Marketing Email)
+                        utm_medium:
+                          type: string
+                          description: Name of the marketing medium. (e.g. Email)
+                        utm_term:
+                          type: string
+                          description: Used to identify any paid keywords.
+                        utm_content:
+                          type: string
+                          description: Used to differentiate your campaign from advertisements.
+                        utm_campaign:
+                          type: string
+                          description: The name of the campaign.
+              required:
+                - personalizations
+                - from
+                - subject
+                - content
+              example:
+                personalizations:
+                  - to:
+                      - email: john_doe@example.com
+                        name: John Doe
+                      - email: julia_doe@example.com
+                        name: Julia Doe
+                    cc:
+                      - email: jane_doe@example.com
+                        name: Jane Doe
+                    bcc:
+                      - email: james_doe@example.com
+                        name: Jim Doe
+                  - from:
+                      email: sales@example.com
+                      name: Example Sales Team
+                    to:
+                      - email: janice_doe@example.com
+                        name: Janice Doe
+                    bcc:
+                      - email: jordan_doe@example.com
+                        name: Jordan Doe
+                from:
+                  email: orders@example.com
+                  name: Example Order Confirmation
+                reply_to:
+                  email: customer_service@example.com
+                  name: Example Customer Service Team
+                subject: Your Example Order Confirmation
+                content:
+                  - type: text/html
+                    value: <p>Hello from Twilio SendGrid!</p><p>Sending with the email service trusted by developers and marketers for <strong>time-savings</strong>, <strong>scalability</strong>, and <strong>delivery expertise</strong>.</p><p>%open-track%</p>
+                attachments:
+                  - content: PCFET0NUWVBFIGh0bWw+CjxodG1sIGxhbmc9ImVuIj4KCiAgICA8aGVhZD4KICAgICAgICA8bWV0YSBjaGFyc2V0PSJVVEYtOCI+CiAgICAgICAgPG1ldGEgaHR0cC1lcXVpdj0iWC1VQS1Db21wYXRpYmxlIiBjb250ZW50PSJJRT1lZGdlIj4KICAgICAgICA8bWV0YSBuYW1lPSJ2aWV3cG9ydCIgY29udGVudD0id2lkdGg9ZGV2aWNlLXdpZHRoLCBpbml0aWFsLXNjYWxlPTEuMCI+CiAgICAgICAgPHRpdGxlPkRvY3VtZW50PC90aXRsZT4KICAgIDwvaGVhZD4KCiAgICA8Ym9keT4KCiAgICA8L2JvZHk+Cgo8L2h0bWw+Cg==
+                    filename: index.html
+                    type: text/html
+                    disposition: attachment
+                categories:
+                  - cake
+                  - pie
+                  - baking
+                send_at: 1617260400
+                batch_id: AsdFgHjklQweRTYuIopzXcVBNm0aSDfGHjklmZcVbNMqWert1znmOP2asDFjkl
+                asm:
+                  group_id: 12345
+                  groups_to_display:
+                    - 12345
+                ip_pool_name: transactional email
+                mail_settings:
+                  bypass_list_management:
+                    enable: false
+                  footer:
+                    enable: false
+                  sandbox_mode:
+                    enable: false
+                tracking_settings:
+                  click_tracking:
+                    enable: true
+                    enable_text: false
+                  open_tracking:
+                    enable: true
+                    substitution_tag: '%open-track%'
+                  subscription_tracking:
+                    enable: false
+      responses:
+        '202':
+          description: ''
+        '400':
+          description: ''
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/global_error_response_schema"
+        '401':
+          description: ''
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/global_error_response_schema"
+        '403':
+          description: ''
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/global_error_response_schema"
+        '404':
+          description: ''
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/global_error_response_schema"
+        '413':
+          description: ''
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/global_error_response_schema"
+        '500':
+          description: ''
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/global_error_response_schema"
+      security:
+        - Authorization: []
+components:
+  securitySchemes:
+    Authorization:
+      type: http
+      scheme: bearer
+      bearerFormat: JWT
+      description: >-
+        The API key used to authenticate with the SendGrid v3 API. You can find
+        your API key in the [Twilio SendGrid UI](https://app.sendgrid.com/settings/api_keys).
+        For more information, see our [API Key documentation](https://sendgrid.com/docs/ui/account-and-settings/api-keys/).
+  schemas:
+    from_email_object:
+      title: From Email Object
+      type: object
+      properties:
+        email:
+          type: string
+          format: email
+          description: The 'From' email address used to deliver the message. This address should be a verified sender in your Twilio SendGrid account.
+        name:
+          type: string
+          description: A name or title associated with the sending email address.
+      required:
+      - email
+      example:
+        email: jane_doe@example.com
+        name: Jane Doe
+    to_email_array:
+      title: To Email Array
+      type: array
+      items:
+        type: object
+        properties:
+          email:
+            type: string
+            format: email
+            description: The intended recipient's email address.
+          name:
+            type: string
+            description: The intended recipient's name.
+        required:
+        - email
+      example:
+      - email: john_doe@example.com
+        name: John Doe
+    cc_bcc_email_object:
+      title: CC BCC Email Object
+      type: object
+      properties:
+        email:
+          type: string
+          format: email
+          description: The intended recipient's email address.
+        name:
+          type: string
+          description: The intended recipient's name.
+      required:
+      - email
+      example:
+        email: jane_doe@example.com
+        name: Jane Doe
+    reply_to_email_object:
+      title: Reply_to Email Object
+      type: object
+      properties:
+        email:
+          type: string
+          format: email
+          description: The email address where any replies or bounces will be returned.
+        name:
+          type: string
+          description: A name or title associated with the `reply_to` email address.
+      required:
+      - email
+      example:
+        email: jane_doe@example.com
+        name: Jane Doe
+    global_error_response_schema:
+      title: Global Error Response Schema
+      type: object
+      properties:
+        errors:
+          type: array
+          items:
+            type: object
+            properties:
+              message:
+                type: string
+                description: the error message
+              field:
+                description: the field that generated the error
+                nullable: true
+                type: string
+              help:
+                type: object
+                description: helper text or docs for troubleshooting
+            required:
+            - message
+        id:
+          type: string
+      example:
+        errors:
+        - field: field_name
+          message: error message
Author	SHA1	Message	Date
Mirjam Herald	bdfff9377b	fixed merge conflicts	2025-09-13 21:34:06 +02:00
b.boterman@htm.nl	a7c1908d00	DateOfBirth and Birthdate are always formatted YYYY-MM-DD.	2025-09-12 12:53:42 +02:00
Bas Boterman	840b62f493	Merge pull request 'OVPAY-2002 - Added YAML for Sendgrid OAS3.' (#22 ) from feature/OVPAY-2002 into develop Reviewed-on: #22	2025-09-05 12:40:33 +00:00
Mirjam Herald	71575926d6	layerinfo url lowercase	2025-09-04 12:18:35 +02:00
Mirjam Herald	2c9cd23b2f	Merge pull request 'updated the patches' (#26 ) from feature/OVPAY2095-customersv2patch into develop Reviewed-on: #26 Reviewed-by: Bas Boterman <b.boterman@htm.nl>	2025-09-01 12:29:24 +00:00
Mirjam Herald	6337cbc578	phonenumber en coutrycode stringified	2025-09-01 13:47:11 +02:00
Mirjam Herald	617099c1a8	naming examples	2025-09-01 13:19:10 +02:00
Mirjam Herald	8730cfbe99	updated the patches	2025-09-01 12:24:11 +02:00
Max Martens	24c9c8ab6e	Merge pull request 'feature/OVPAY-2007-Products-LayerInfo' (#24 ) from feature/OVPAY-2007-Products-LayerInfo into develop Reviewed-on: #24	2025-08-28 09:26:23 +00:00
Max Martens	0515529551	fixxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx	2025-08-28 11:24:22 +02:00
Max Martens	d9d82eae66	fixxxxxxxxxxxxx	2025-08-28 11:22:04 +02:00
Max Martens	227fa07da0	Added CRUD POST/PUT examples with layerInfo	2025-08-28 10:36:22 +02:00
Mirjam Herald	9fe5913be3	Merge pull request 'OVPAY-2032 - Added profile instances to the get token call.' (#23 ) from feature/OVPAY-2032 into develop Reviewed-on: #23	2025-08-25 13:33:55 +00:00
Mirjam Herald	4d9e6a831f	Review comments verwerkt	2025-08-25 15:32:14 +02:00
Mirjam Herald	270ea246df	changed GET customers to always return a list	2025-08-19 15:23:55 +02:00
Mirjam Herald	908afa2bc0	added existing post patch customer to SE swagger	2025-08-19 12:12:58 +02:00
Max Martens	3ecf55b6ec	SE and TP OAI now also fixed, including multi-layer example for LayerInfo	2025-08-17 23:30:57 +02:00
Max Martens	d4c5165b39	Fixed	2025-08-17 22:25:49 +02:00
Max Martens	7de54cbd86	WIP, still need to fix some very legacy incorrect confusing stuff in this OAI-spec (thanks Greg for pointing that out!)	2025-08-17 19:53:29 +02:00
Max Martens	ad58b53440	Ultra major refactor of ABTProductReference Swagger; added new LayerInfo entity	2025-08-14 14:27:46 +02:00
b.boterman@htm.nl	d8a6a59c7d	OVPAY-2032 - Added product instances to the compare call.	2025-08-14 11:59:13 +02:00
b.boterman@htm.nl	57607d8ad7	OVPAY-2032 - Added profile instances to the compare call.	2025-08-14 11:53:19 +02:00
b.boterman@htm.nl	adcbc4e61c	OVPAY-2032 - Added profile instances to the get token call.	2025-08-14 11:41:25 +02:00
b.boterman@htm.nl	a87058641d	OVPAY-2002 - Removed invisible Unicode characters	2025-08-06 15:28:59 +02:00
b.boterman@htm.nl	ea8b7f9986	OVPAY-2002 - Added YAML for Sendgrid OAS3.	2025-08-06 13:02:29 +02:00