Merge pull request 'feature/OVPAY-2186' (#31) from feature/OVPAY-2186 into develop

Reviewed-on: #31

src/openapi/contracts/contracts-crud.yaml

@@ -6,13 +6,13 @@ info:
 servers:
   - url: https://services.acc.api.htm.nl/abt/abtcontracts/1.0
 paths:
-  /customers/{customerNumber}/contracts:
+  /customers/{customerProfileId}/contracts:
     parameters:
       - in: path
-        name: customerNumber
+        name: customerProfileId
         schema:
           type: integer
-          example: 1001337
+          example: 1337
         required: true
         description: The customerNumber.
     get:
@@ -34,7 +34,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/Contract"
+                $ref: "#/components/schemas/Contracts"
               example:
                 {
                   "contracts":
@@ -48,12 +48,23 @@ paths:
                         "touchpointId": 2,
                         "contractStatus":
                           { "contractStatusId": 2, "name": "active" },
-                        "productId": 1,
-                        "productName": "HTM Maand 20% korting",
                         "termDuration": "P0Y1M0D",
                         "billingDay": 15,
                         "highestInvoiceTerm": 1,
                         "created": "2024-08-01 15:01:00.000",
+                        "contractVersions":
+                          [
+                            {
+                              "contractVersionId": 1,
+                              "termsAndConditions": "https://www.htm.nl/reisproducten/productvoorwaarden/htm-maandkorting/",
+                              "productId": 1,
+                              "productName": "HTM Maand 20% korting",
+                              "taxCode": "V9",
+                              "taxPercentage": 9.0,
+                              "termAmountInclTax": 400,
+                              "start": "2024-08-01 15:01:00.000",
+                            },
+                          ],
                       },
                       {
                         "contractId": "f07253e6-c364-474c-a342-a10a4a7cf305",
@@ -64,14 +75,26 @@ paths:
                         "touchpointId": 2,
                         "contractStatus":
                           { "contractStatusId": 1, "name": "new" },
-                        "productId": 1,
-                        "productName": "HTM Maand 20% korting",
                         "termDuration": "P0Y1M0D",
                         "billingDay": 15,
                         "highestInvoiceTerm": 1,
                         "created": "2024-08-01 15:01:00.000",
+                        "contractVersions":
+                          [
+                            {
+                              "contractVersionId": 1,
+                              "termsAndConditions": "https://www.htm.nl/reisproducten/productvoorwaarden/htm-maandkorting/",
+                              "productId": 1,
+                              "productName": "HTM Maand 20% korting",
+                              "taxCode": "V9",
+                              "taxPercentage": 9.0,
+                              "termAmountInclTax": 400,
+                              "start": "2024-08-01 15:01:00.000",
                             },
                           ],
+                      },
+                    ],
+                  "href": null,
                 }
     post:
       summary: Create a contract for an existing customer profile.
@@ -82,7 +105,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/Contract"
+              $ref: "#/components/schemas/PostContractsRequestBody"
             example:
               {
                 "contract":
@@ -91,8 +114,6 @@ paths:
                     "orderLineId": "52efbbfc-8c28-4016-9ece-dc3ef9a70bd8",
                     "touchpointId": 2,
                     "contractStatusId": 1,
-                    "productId": 1,
-                    "productName": "HTM Maand 20% korting",
                     "termDuration": "P0Y1M0D",
                     "billingDay": 15,
                     "highestInvoiceTerm": 0,
@@ -100,10 +121,11 @@ paths:
                       [
                         {
                           "termsAndConditions": "https://www.htm.nl/reisproducten/productvoorwaarden/htm-maandkorting/",
-                          "termAmountExclTax": 1200,
+                          "productId": 1,
-                          "taxCode": "V21",
+                          "productName": "HTM Maand 20% korting",
-                          "taxAmount": 108,
+                          "taxCode": "V9",
-                          "termAmountInclTax": 1308,
+                          "taxPercentage": 9.0,
+                          "termAmountInclTax": 400,
                           "start": "2024-07-04 15:01:00.000",
                           "end": "",
                         },
@@ -125,7 +147,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/Contract"
+                $ref: "#/components/schemas/PostContractsResponseBody"
               example:
                 {
                   "contract":
@@ -184,7 +206,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/Contract"
+                $ref: "#/components/schemas/Contracts"
               example:
                 {
                   "contracts":
@@ -198,8 +220,6 @@ paths:
                         "touchpointId": 2,
                         "contractStatus":
                           { "contractStatusId": 2, "name": "active" },
-                        "productId": 1,
-                        "productName": "HTM Maand 20% korting",
                         "termDuration": "P0Y1M0D",
                         "billingDay": 15,
                         "highestInvoiceTerm": 1,
@@ -257,20 +277,22 @@ paths:
                             {
                               "contractVersionId": 1,
                               "termsAndConditions": "https://www.htm.nl/reisproducten/productvoorwaarden/htm-maandkorting/",
-                              "termAmountExclTax": 1200,
+                              "productId": 1,
-                              "taxCode": "V21",
+                              "productName": "HTM Maand 20% korting",
-                              "taxAmount": 108,
+                              "taxCode": "V9",
-                              "termAmountInclTax": 1308,
+                              "taxPercentage": 9.0,
+                              "termAmountInclTax": 400,
                               "start": "2024-07-04 15:01:00.000",
                               "end": "2024-12-31 15:01:00.000",
                             },
                             {
                               "contractVersionId": 2,
                               "termsAndConditions": "https://www.htm.nl/reisproducten/productvoorwaarden/htm-maandkorting/",
-                              "termAmountExclTax": 1300,
+                              "productId": 1,
-                              "taxCode": "V21",
+                              "productName": "HTM Maand 20% korting",
-                              "taxAmount": 117,
+                              "taxCode": "V9",
-                              "termAmountInclTax": 1417,
+                              "taxPercentage": 9.0,
+                              "termAmountInclTax": 400,
                               "start": "2025-01-01 15:01:00.000",
                             },
                           ],
@@ -284,8 +306,6 @@ paths:
                         "touchpointId": 2,
                         "contractStatus":
                           { "contractStatusId": 1, "name": "new" },
-                        "productId": 1,
-                        "productName": "HTM Maand 20% korting",
                         "termDuration": "P0Y1M0D",
                         "billingDay": 15,
                         "highestInvoiceTerm": 1,
@@ -343,20 +363,22 @@ paths:
                             {
                               "contractVersionId": 1,
                               "termsAndConditions": "https://www.htm.nl/reisproducten/productvoorwaarden/htm-maandkorting/",
-                              "termAmountExclTax": 1200,
+                              "productId": 1,
-                              "taxCode": "V21",
+                              "productName": "HTM Maand 20% korting",
-                              "taxAmount": 108,
+                              "taxCode": "V9",
-                              "termAmountInclTax": 1308,
+                              "taxPercentage": 9.0,
+                              "termAmountInclTax": 400,
                               "start": "2024-07-04 15:01:00.000",
                               "end": "2024-12-31 15:01:00.000",
                             },
                             {
                               "contractVersionId": 2,
                               "termsAndConditions": "https://www.htm.nl/reisproducten/productvoorwaarden/htm-maandkorting/",
-                              "termAmountExclTax": 1300,
+                              "productId": 1,
-                              "taxCode": "V21",
+                              "productName": "HTM Maand 20% korting",
-                              "taxAmount": 117,
+                              "taxCode": "V9",
-                              "termAmountInclTax": 1417,
+                              "taxPercentage": 9.0,
+                              "termAmountInclTax": 400,
                               "start": "2025-01-01 15:01:00.000",
                             },
                           ],
@@ -397,8 +419,6 @@ paths:
                       "touchpointId": 2,
                       "contractStatus":
                         { "contractStatusId": 2, "name": "active" },
-                      "productId": 1,
-                      "productName": "HTM Maand 20% korting",
                       "termDuration": "P0Y1M0D",
                       "billingDay": 15,
                       "highestInvoiceTerm": 1,
@@ -407,20 +427,22 @@ paths:
                           {
                             "contractVersionId": 1,
                             "termsAndConditions": "https://www.htm.nl/reisproducten/productvoorwaarden/htm-maandkorting/",
-                            "termAmountExclTax": 1200,
+                            "productId": 1,
-                            "taxCode": "V21",
+                            "productName": "HTM Maand 20% korting",
-                            "taxAmount": 108,
+                            "taxCode": "V9",
-                            "termAmountInclTax": 1308,
+                            "taxPercentage": 9.0,
+                            "termAmountInclTax": 400,
                             "start": "2024-07-04 15:01:00.000",
                             "end": "2024-12-31 15:01:00.000",
                           },
                           {
                             "contractVersionId": 2,
                             "termsAndConditions": "https://www.htm.nl/reisproducten/productvoorwaarden/htm-maandkorting/",
-                            "termAmountExclTax": 1300,
+                            "productId": 1,
-                            "taxCode": "V21",
+                            "productName": "HTM Maand 20% korting",
-                            "taxAmount": 117,
+                            "taxCode": "V9",
-                            "termAmountInclTax": 1417,
+                            "taxPercentage": 9.0,
+                            "termAmountInclTax": 400,
                             "start": "2025-01-01 15:01:00.000",
                           },
                         ],
@@ -480,14 +502,12 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/Contract"
+              $ref: "#/components/schemas/PatchContractsRequestBody"
             example:
               {
                 "contract":
                   {
                     "contractStatusId": 2,
-                    "productId": 1,
-                    "productName": "HTM 20% korting 2024",
                     "billingDay": 15,
                     "highestInvoiceTerm": 2,
                   },
@@ -498,7 +518,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/Contract"
+                $ref: "#/components/schemas/PatchContractsResponseBody"
               example:
                 {
                   "contract":
@@ -526,16 +546,17 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/InvoiceAccountingStatus"
+              $ref: "#/components/schemas/PostContractVersionsRequestBody"
             example:
               {
                 "contractVersion":
                   {
                     "termsAndConditions": "https://www.htm.nl/reisproducten/productvoorwaarden/htm-maandkorting/",
-                    "termAmountExclTax": 1200,
+                    "productId": 1,
-                    "taxCode": "V21",
+                    "productName": "HTM Maand 20% korting",
-                    "taxAmount": 108,
+                    "taxCode": "V9",
-                    "termAmountInclTax": 1308,
+                    "taxPercentage": 9.0,
+                    "termAmountInclTax": 400,
                     "start": "2024-07-08 15:01:00.000",
                     "end": "",
                   },
@@ -546,7 +567,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ContractVersion"
+                $ref: "#/components/schemas/PostContractVersionsResponseBody"
               example:
                 {
                   "contractVersion":
@@ -581,7 +602,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/ContractVersion"
+              $ref: "#/components/schemas/PatchContractVersionsRequestBody"
             example: { "contractVersion": { "end": "2024-07-03 15:01:00.000" } }
       responses:
         "200":
@@ -589,7 +610,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ContractVersion"
+                $ref: "#/components/schemas/PatchContractVersionsResponseBody"
               example:
                 {
                   "contractVersion":
@@ -598,6 +619,14 @@ paths:
                       "contractVersionId": 1,
                     },
                 }
+    delete:
+      summary: Delete an existing contract version.
+      description: Delete an existing contract version.
+      tags:
+        - ContractVersion
+      responses:
+        "200":
+          description: OK
   /contracts/{contractId}/contractinvoices:
     parameters:
       - in: path
@@ -608,67 +637,6 @@ paths:
           example: d1dd439b-6072-4b97-89c9-724268865b93
         required: true
         description: The contractId of the Contract, formatted as UUID.
-    get:
-      summary: Get invoices of a single contract. DEPRECATED.
-      description: Get invoices of a single contract. WARNING; This method is deprecated. Please use GET /contractinvoices instead.
-      deprecated: true
-      tags:
-        - ContractInvoice
-      responses:
-        "200":
-          description: OK
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/ContractInvoice"
-              example:
-                {
-                  "contractInvoices":
-                    [
-                      {
-                        "contractInvoiceId": "8699d72a-cf4d-4e6b-9e9c-549d837ca51f",
-                        "externalReference": "F2024-0001",
-                        "term": 1,
-                        "invoiceDate": "2024-07-02",
-                        "created": "2024-07-02 15:01:00.000",
-                        "updated": "2024-07-02 15:01:00.000",
-                        "state": "invoice_sent",
-                        "data": "{json}",
-                        "isCredit": false,
-                        "invoiceAccountingStatuses":
-                          [
-                            {
-                              "invoiceAccountingStatusId": "32785417-1fb8-42c7-bda1-533f5868809f",
-                              "accountingStatus":
-                                { "accountingStatusId": 1, "name": "open" },
-                              "createdOn": "2024-06-02 15:01:00.000",
-                              "description": null,
-                            },
-                          ],
-                      },
-                      {
-                        "contractInvoiceId": "dadff658-4ff5-4eb8-b516-492f1f6c6245",
-                        "externalReference": "F2024-0002",
-                        "term": 2,
-                        "invoiceDate": "2024-08-02",
-                        "created": "2024-08-02 15:01:00.000",
-                        "updated": "2024-08-02 15:01:00.000",
-                        "state": "invoice_created",
-                        "data": "{json}",
-                        "isCredit": false,
-                        "invoiceAccountingStatuses":
-                          [
-                            {
-                              "invoiceAccountingStatusId": "84af0f01-0416-4860-851a-a0d4b3cf674a",
-                              "accountingStatus":
-                                { "accountingStatusId": 1, "name": "open" },
-                              "createdOn": "2024-06-02 15:01:00.000",
-                              "description": null,
-                            },
-                          ],
-                      },
-                    ],
-                }
     post:
       summary: Add an invoice to an existing contract.
       description: Add an invoice to an existing contract.
@@ -678,7 +646,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/ContractInvoice"
+              $ref: "#/components/schemas/PostContractInvoicesRequestBody"
             example:
               {
                 "contractInvoice":
@@ -707,7 +675,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ContractInvoice"
+                $ref: "#/components/schemas/PostContractInvoicesResponseBody"
               example:
                 {
                   "contractInvoice":
@@ -820,7 +788,12 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/Contract"
+                type: object
+                properties:
+                  contractInvoices:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/ContractInvoice"
               example:
                 {
                   "contractInvoices":
@@ -890,7 +863,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/ContractInvoice"
+              $ref: "#/components/schemas/PatchContractInvoicesRequestBody"
             example:
               {
                 "contractInvoice":
@@ -906,7 +879,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ContractInvoice"
+                $ref: "#/components/schemas/PatchContractInvoicesResponseBody"
               example:
                 {
                   "contractInvoice":
@@ -933,7 +906,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/ContractInvoice"
+              $ref: "#/components/schemas/PostInvoiceAccountingStatusesRequestBody"
             example:
               {
                 "accountingStatusId": 1,
@@ -946,7 +919,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ContractInvoice"
+                $ref: "#/components/schemas/PostInvoiceAccountingStatusesResponseBody"
               example:
                 {
                   "invoiceAccountingStatusId": "a6836364-4812-4960-9226-69deb2e2b903",
@@ -972,7 +945,12 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/Contract"
+                type: object
+                properties:
+                  contractActions:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/ContractAction"
               example:
                 {
                   "contractActions":
@@ -1004,7 +982,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: "#/components/schemas/ContractAction"
+              $ref: "#/components/schemas/PostContractActionsRequestBody"
             example:
               {
                 "contractAction":
@@ -1022,7 +1000,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ContractAction"
+                $ref: "#/components/schemas/PostContractActionsResponseBody"
               example:
                 {
                   "contractAction":
@@ -1042,6 +1020,11 @@ paths:
           content:
             application/json:
               schema:
+                type: object
+                properties:
+                  contractStatuses:
+                    type: array
+                    items:
                       $ref: "#/components/schemas/ContractStatus"
               example:
                 {
@@ -1054,6 +1037,7 @@ paths:
                       { "contractStatusId": 5, "name": "terminated" },
                       { "contractStatusId": 6, "name": "pending cancellation" },
                       { "contractStatusId": 7, "name": "pending termination" },
+                      { "contractStatusId": 8, "name": "pending change" },
                     ],
                 }
   /actiontypes:
@@ -1068,6 +1052,11 @@ paths:
           content:
             application/json:
               schema:
+                type: object
+                properties:
+                  actionTypes:
+                    type: array
+                    items:
                       $ref: "#/components/schemas/ActionType"
               example:
                 {
@@ -1089,6 +1078,412 @@ components:
       scheme: bearer
       bearerFormat: JWT
   schemas:
+    PostContractsRequestBody:
+      type: object
+      properties:
+        contract:
+          type: object
+          properties:
+            orderId:
+              type: string
+              format: uuid
+              example: eb3d08f7-7feb-4f31-9f5b-daa634e51f48
+            orderLineId:
+              type: string
+              format: uuid
+              example: 52efbbfc-8c28-4016-9ece-dc3ef9a70bd8
+            touchpointId:
+              type: integer
+              example: 2
+            termDuration:
+              type: string
+              format: ISO8601
+              example: P0Y1M0D
+            billingDay:
+              type: integer
+              example: 15
+            highestInvoiceTerm:
+              type: integer
+              example: 0
+            contractVersions:
+              type: array
+              items:
+                type: object
+                properties:
+                  termsAndConditions:
+                    type: string
+                    format: url
+                    example: https://www.htm.nl/reisproducten/productvoorwaarden/htm-maandkorting/
+                  productId:
+                    type: integer
+                    example: 1
+                  productName:
+                    type: string
+                    example: HTM Maand 20% korting
+                  taxCode:
+                    type: string
+                    example: V9
+                  taxPercentage:
+                    type: number
+                    format: float
+                    example: 9.0
+                  termAmountInclTax:
+                    type: integer
+                    example: 400
+                  start:
+                    type: string
+                    format: date-time
+                    example: 2024-07-04 15:01:00.000
+                  end:
+                    type: string
+                    format: date-time
+                    example: 2024-12-31 15:01:00.000
+                required:
+                  - termsAndConditions
+                  - productId
+                  - productName
+                  - taxCode
+                  - taxPercentage
+                  - termAmountInclTax
+                  - start
+          required:
+            - orderId
+            - orderLineId
+            - touchpointId
+            - termDuration
+            - billingDay
+            - highestInvoiceTerm
+            - contractVersions
+      required:
+        - contract
+    PostContractsResponseBody:
+      type: object
+      properties:
+        contract:
+          type: object
+          properties:
+            contractId:
+              type: string
+              format: uuid
+              example: 5a3876a1-e9a1-4278-8983-4679a8d583c2
+            contractNumber:
+              type: string
+              pattern: '^D\d{6}$'
+              example: D123456
+          required:
+            - contractId
+            - contractNumber
+      required:
+        - contract
+    PatchContractsRequestBody:
+      type: object
+      properties:
+        contract:
+          type: object
+          properties:
+            contractStatusId:
+              type: integer
+              example: 2
+            billingDay:
+              type: integer
+              example: 15
+            highestInvoiceTerm:
+              type: integer
+              example: 2
+      required:
+        - contract
+    PatchContractsResponseBody:
+      type: object
+      properties:
+        contract:
+          type: object
+          properties:
+            contractId:
+              type: string
+              format: uuid
+              example: 5a3876a1-e9a1-4278-8983-4679a8d583c2
+            contractNumber:
+              type: string
+              pattern: '^D\d{6}$'
+              example: D123456
+          required:
+            - contractId
+            - contractNumber
+      required:
+        - contract
+    PostContractVersionsRequestBody:
+      type: object
+      properties:
+        contractVersion:
+          type: object
+          properties:
+            termsAndConditions:
+              type: string
+              format: url
+              example: https://www.htm.nl/reisproducten/productvoorwaarden/htm-maandkorting/
+            productId:
+              type: integer
+              example: 1
+            productName:
+              type: string
+              example: HTM Maand 20% korting
+            taxCode:
+              type: string
+              example: V9
+            taxPercentage:
+              type: number
+              format: float
+              example: 9.0
+            termAmountInclTax:
+              type: integer
+              example: 400
+            start:
+              type: string
+              format: date-time
+              example: 2024-07-04 15:01:00.000
+            end:
+              type: string
+              format: date-time
+              example: 2024-12-31 15:01:00.000
+          required:
+            - termsAndConditions
+            - productId
+            - productName
+            - taxCode
+            - taxPercentage
+            - termAmountInclTax
+            - start
+      required:
+        - contractVersion
+    PostContractVersionsResponseBody:
+      type: object
+      properties:
+        contractVersion:
+          type: object
+          properties:
+            contractId:
+              type: string
+              format: uuid
+              example: 5a3876a1-e9a1-4278-8983-4679a8d583c2
+            contractVersionId:
+              type: integer
+              example: 1
+          required:
+            - contractId
+            - contractVersionId
+      required:
+        - contractVersion
+    PatchContractVersionsRequestBody:
+      type: object
+      properties:
+        contractVersion:
+          type: object
+          properties:
+            end:
+              type: string
+              format: date-time
+              example: 2024-12-31 15:01:00.000
+      required:
+        - contractVersion
+    PatchContractVersionsResponseBody:
+      type: object
+      properties:
+        contractVersion:
+          type: object
+          properties:
+            contractId:
+              type: string
+              format: uuid
+              example: 5a3876a1-e9a1-4278-8983-4679a8d583c2
+            contractVersionId:
+              type: integer
+              example: 1
+          required:
+            - contractId
+            - contractVersionId
+      required:
+        - contractVersion
+    PostContractInvoicesRequestBody:
+      type: object
+      properties:
+        contractInvoice:
+          type: object
+          properties:
+            externalReference:
+              type: string
+              example: F2024-0001
+            term:
+              type: integer
+              example: 1
+            invoiceDate:
+              type: string
+              format: date
+              example: 2024-07-02
+            created:
+              type: string
+              format: date-time
+              example: 2024-07-02 15:01:00.000
+            updated:
+              type: string
+              format: date-time
+              example: 2024-07-02 15:01:00.000
+            state:
+              type: string
+              example: invoice_created
+            data:
+              type: string
+              format: json
+              example: "{json}"
+            isCredit:
+              type: boolean
+              example: false
+            invoiceAccountingStatuses:
+              type: array
+              items:
+                type: object
+                properties:
+                  accountingStatusId:
+                    type: integer
+                    example: 1
+                  createdOn:
+                    type: string
+                    format: date-time
+                    example: 2024-07-02 15:01:00.000
+                  description:
+                    type: string
+                    example: null
+                required:
+                  - accountingStatusId
+                  - createdOn
+          required:
+            - externalReference
+            - term
+            - invoiceDate
+            - created
+            - updated
+            - state
+            - data
+            - isCredit
+            - invoiceAccountingStatuses
+      required:
+        - contractInvoice
+    PostContractInvoicesResponseBody:
+      type: object
+      properties:
+        contractInvoice:
+          type: object
+          properties:
+            contractInvoiceId:
+              type: string
+              format: uuid
+              example: 8699d72a-cf4d-4e6b-9e9c-549d837ca51f
+          required:
+            - contractInvoiceId
+      required:
+        - contractInvoice
+    PatchContractInvoicesRequestBody:
+      type: object
+      properties:
+        contractInvoice:
+          type: object
+          properties:
+            updated:
+              type: string
+              format: date-time
+              example: 2024-07-02 15:01:00.000
+            state:
+              type: string
+              example: invoice_reopened
+            data:
+              type: string
+              format: json
+              example: "{json}"
+      required:
+        - contractInvoice
+    PatchContractInvoicesResponseBody:
+      type: object
+      properties:
+        contractInvoice:
+          type: object
+          properties:
+            contractInvoiceId:
+              type: string
+              format: uuid
+              example: 8699d72a-cf4d-4e6b-9e9c-549d837ca51f
+          required:
+            - contractInvoiceId
+      required:
+        - contractInvoice
+    PostInvoiceAccountingStatusesRequestBody:
+      type: object
+      properties:
+        accountingStatusId:
+          type: integer
+          example: 1
+        createdOn:
+          type: string
+          format: date-time
+          example: 2024-07-02 15:01:00.000
+        description:
+          type: string
+          example: null
+      required:
+        - accountingStatusId
+        - createdOn
+    PostInvoiceAccountingStatusesResponseBody:
+      type: object
+      properties:
+        invoiceAccountingStatusId:
+          type: string
+          format: uuid
+          example: a6836364-4812-4960-9226-69deb2e2b903
+      required:
+        - invoiceAccountingStatusId
+    PostContractActionsRequestBody:
+      type: object
+      properties:
+        contractAction:
+          type: object
+          properties:
+            actionType:
+              type: integer
+              example: 2
+            user:
+              type: string
+              example: subid123456
+            timestamp:
+              type: string
+              format: date-time
+              example: 2024-07-02 15:01:00.000
+            details:
+              type: string
+              example: Contract changed xyz
+            correlationId:
+              type: string
+              format: uuid
+              example: 976e7a4c-bf24-43d2-b444-55817556e7ee
+          required:
+            - actionType
+            - user
+            - timestamp
+            - details
+            - correlationId
+      required:
+        - contractAction
+    PostContractActionsResponseBody:
+      type: object
+      properties:
+        contractAction:
+          type: object
+          properties:
+            contractActionId:
+              type: string
+              format: uuid
+              example: 8699d72a-cf4d-4e6b-9e9c-549d837ca51f
+          required:
+            - contractActionId
+      required:
+        - contractAction
     Contract:
       type: object
       properties:
@@ -1117,12 +1512,6 @@ components:
         contractStatus:
           type: object
           $ref: "#/components/schemas/ContractStatus"
-        productId:
-          type: integer
-          example: 1
-        productName:
-          type: string
-          example: HTM Maand 20% korting
         termDuration:
           type: string
           format: ISO8601
@@ -1190,18 +1579,22 @@ components:
           type: string
           format: url
           example: https://www.htm.nl/reisproducten/productvoorwaarden/htm-maandkorting/
-        termAmountExclTax:
+        productId:
           type: integer
-          example: 1200
+          example: 1
+        productName:
+          type: string
+          example: HTM Maand 20% korting
         taxCode:
           type: string
-          example: V21
+          example: V9
-        taxAmount:
+        taxPercentage:
-          type: integer
+          type: number
-          example: 108
+          format: float
+          example: 9.0
         termAmountInclTax:
           type: integer
-          example: 1308
+          example: 400
         start:
           type: string
           format: date-time

src/openapi/contracts/contracts-se.yaml

@@ -164,20 +164,22 @@ paths:
                           {
                             "contractVersionId": 1,
                             "termsAndConditions": "https://www.htm.nl/reisproducten/productvoorwaarden/htm-maandkorting/",
-                            "termAmountExclTax": 1200,
+                            "productId": 1,
-                            "taxCode": "V21",
+                            "productName": "HTM Maand 20% korting",
-                            "taxAmount": 108,
+                            "taxCode": "V9",
-                            "termAmountInclTax": 1308,
+                            "taxPercentage": 9.0,
+                            "termAmountInclTax": 400,
                             "start": "2024-07-04 15:01:00.000",
                             "end": "2024-12-31 15:01:00.000",
                           },
                           {
                             "contractVersionId": 2,
                             "termsAndConditions": "https://www.htm.nl/reisproducten/productvoorwaarden/htm-maandkorting/",
-                            "termAmountExclTax": 1300,
+                            "productId": 1,
-                            "taxCode": "V21",
+                            "productName": "HTM Maand 20% korting",
-                            "taxAmount": 117,
+                            "taxCode": "V9",
-                            "termAmountInclTax": 1417,
+                            "taxPercentage": 9.0,
+                            "termAmountInclTax": 400,
                             "start": "2025-01-01 15:01:00.000",
                           },
                         ],
@@ -509,20 +511,22 @@ paths:
                           {
                             "contractVersionId": 1,
                             "termsAndConditions": "https://www.htm.nl/reisproducten/productvoorwaarden/htm-maandkorting/",
-                            "termAmountExclTax": 1200,
+                            "productId": 1,
-                            "taxCode": "V21",
+                            "productName": "HTM Maand 20% korting",
-                            "taxAmount": 108,
+                            "taxCode": "V9",
-                            "termAmountInclTax": 1308,
+                            "taxPercentage": 9.0,
+                            "termAmountInclTax": 400,
                             "start": "2024-07-04 15:01:00.000",
                             "end": "2024-12-31 15:01:00.000",
                           },
                           {
                             "contractVersionId": 2,
                             "termsAndConditions": "https://www.htm.nl/reisproducten/productvoorwaarden/htm-maandkorting/",
-                            "termAmountExclTax": 1300,
+                            "productId": 1,
-                            "taxCode": "V21",
+                            "productName": "HTM Maand 20% korting",
-                            "taxAmount": 117,
+                            "taxCode": "V9",
-                            "termAmountInclTax": 1417,
+                            "taxPercentage": 9.0,
+                            "termAmountInclTax": 400,
                             "start": "2025-01-01 15:01:00.000",
                           },
                         ],