Merge pull request 'develop' (#4) from develop into main

Reviewed-on: #4

src/openapi/contracts/contracts-crud.yaml

@@ -216,6 +216,7 @@ paths:
                               "created": "2024-06-02 15:01:00.000",
                               "updated": "2024-06-02 15:01:00.000",
                               "state": "invoice_created",
+                              "isCredit": false,
                             },
                             {
                               "contractInvoiceId": "1c345237-4d84-47f0-93c2-7b94338e3355",
@@ -224,6 +225,7 @@ paths:
                               "created": "2024-07-02 15:01:00.000",
                               "updated": "2024-07-02 15:01:00.000",
                               "state": "invoice_created",
+                              "isCredit": false,
                             },
                           ],
                         "contractVersions":
@@ -273,6 +275,7 @@ paths:
                               "created": "2024-06-02 15:01:00.000",
                               "updated": "2024-06-02 15:01:00.000",
                               "state": "invoice_created",
+                              "isCredit": false,
                             },
                             {
                               "contractInvoiceId": "1c345237-4d84-47f0-93c2-7b94338e3355",
@@ -281,6 +284,7 @@ paths:
                               "created": "2024-07-02 15:01:00.000",
                               "updated": "2024-07-02 15:01:00.000",
                               "state": "invoice_created",
+                              "isCredit": false,
                             },
                           ],
                         "contractVersions":
@@ -401,6 +405,7 @@ paths:
                             "updated": "2024-07-02 15:01:00.000",
                             "state": "invoice_created",
                             "data": "{json}",
+                            "isCredit": false,
                           },
                         ],
                     },
@@ -568,6 +573,7 @@ paths:
                         "updated": "2024-07-02 15:01:00.000",
                         "state": "invoice_sent",
                         "data": "{json}",
+                        "isCredit": false,
                       },
                       {
                         "contractInvoiceId": "dadff658-4ff5-4eb8-b516-492f1f6c6245",
@@ -577,6 +583,7 @@ paths:
                         "updated": "2024-08-02 15:01:00.000",
                         "state": "invoice_created",
                         "data": "{json}",
+                        "isCredit": false,
                       },
                     ],
                 }
@@ -600,6 +607,7 @@ paths:
                     "updated": "2024-07-02 15:01:00.000",
                     "state": "invoice_created",
                     "data": "{json}",
+                    "isCredit": false,
                   },
               }
       responses:
@@ -684,6 +692,13 @@ paths:
             example: created
           required: false
           description: Invoice state.
+        - in: query
+          name: isCredit
+          schema:
+            type: boolean
+            example: false
+          required: false
+          description: Whether the invoice is a credit invoice.
       responses:
         "200":
           description: OK
@@ -704,6 +719,7 @@ paths:
                         "updated": "2024-06-02 15:01:00.000",
                         "state": "invoice_created",
                         "data": "{json}",
+                        "isCredit": false,
                       },
                       {
                         "contractId": "a7452e22-3894-40cc-87d6-869370a92277",
@@ -714,6 +730,7 @@ paths:
                         "updated": "2024-08-02 15:01:00.000",
                         "state": "invoice_created",
                         "data": "{json}",
+                        "isCredit": false,
                       },
                     ],
                 }
@@ -1049,6 +1066,9 @@ components:
           type: string
           format: json
           example: { json }
+        isCredit:
+          type: boolean
+          example: false
     ContractStatus:
       type: object
       properties:

src/openapi/orders/orders-crud.yaml

@@ -17,8 +17,7 @@ paths:
           name: externalOrderId
           schema:
             type: string
-            format: uuid
+            example: EXT001
-            example: 26ce08bc-0443-465f-9cd2-a7143f33eed0
           required: false
           description: The order id in the external system.
         - in: query
@@ -110,7 +109,7 @@ paths:
               type: integer
           explode: false
           required: false
-          description: Filter on possible order statuses. 1 = concept, 2 = awaitingPayment, 3 = pendingPayment, 4 = paid, 5 = delivered, 6 = cancelled.
+          description: Filter on most recent order status. 1 = concept, 2 = awaitingPayment, 3 = pendingPayment, 4 = paid, 5 = delivered, 6 = cancelled.
       responses:
         "200":
           description: OK
@@ -141,6 +140,7 @@ paths:
                         "createdOn": "2024-03-22T09:00:00",
                         "lastUpdatedOn": "2024-03-22T09:00:00",
                         "order_OrderStatus":
+                          [
                             {
                               "order_orderStatusId": "f1d0e1a7-a3cf-4876-b8f2-073add10667f",
                               "orderStatus":
@@ -148,6 +148,17 @@ paths:
                               "createdOn": "2024-03-22T09:00:00",
                               "description": "Order succesvol betaald",
                             },
+                            {
+                              "order_orderStatusId": "2b9b7943-3a74-4f2e-ad65-012b62c80821",
+                              "orderStatus":
+                                {
+                                  "orderStatusId": 3,
+                                  "name": "pendingPayment",
+                                },
+                              "createdOn": "2024-03-22T08:55:00",
+                              "description": "Betaling in behandeling",
+                            },
+                          ],
                         "orderLines":
                           [
                             {
@@ -315,11 +326,18 @@ paths:
                 "shippingAddressId": 1,
                 "createdOn": "2024-03-22T09:00:00",
                 "order_OrderStatus":
+                  [
                     {
                       "orderStatusId": 4,
                       "createdOn": "2024-03-22T09:00:00",
                       "description": "Order succesvol betaald",
                     },
+                    {
+                      "orderStatusId": 3,
+                      "createdOn": "2024-03-22T08:55:00",
+                      "description": "Betaling in behandeling",
+                    },
+                  ],
                 "orderLines":
                   [
                     {
@@ -475,12 +493,21 @@ paths:
                   "createdOn": "2024-03-22T09:00:00",
                   "lastUpdatedOn": "2024-03-22T09:00:00",
                   "order_OrderStatus":
+                    [
                       {
                         "order_orderStatusId": "f1d0e1a7-a3cf-4876-b8f2-073add10667f",
                         "orderStatus": { "orderStatusId": 4, "name": "paid" },
                         "createdOn": "2024-03-22T09:00:00",
                         "description": "Order succesvol betaald",
                       },
+                      {
+                        "order_orderStatusId": "2b9b7943-3a74-4f2e-ad65-012b62c80821",
+                        "orderStatus":
+                          { "orderStatusId": 3, "name": "pendingPayment" },
+                        "createdOn": "2024-03-22T08:55:00",
+                        "description": "Betaling in behandeling",
+                      },
+                    ],
                   "orderLines":
                     [
                       {
@@ -767,8 +794,8 @@ paths:
         required: true
         description: The id of the order to process.
     post:
-      summary: P2. Add one or more payments to an order.
+      summary: P2. Add a payment to an order.
-      description: Add one or more payments to an order.
+      description: Add a payment to an order.
       tags:
         - Payment
       requestBody:
@@ -777,7 +804,6 @@ paths:
             schema:
               $ref: "#/components/schemas/unavailable"
             example:
-              [
               {
                 "createdOn": "2024-03-22T09:00:00",
                 "amountDebit": 121,
@@ -805,8 +831,7 @@ paths:
                     "ascription": "J. de Vries",
                     "place": "Den Haag",
                   },
-                },
+              }
-              ]
       responses:
         "201":
           description: Created