From 741f6c34ddf42a7e4352d2bd5873b37ededce050 Mon Sep 17 00:00:00 2001
From: Nico Kroll <kroll@prm-ag.de>
Date: Thu, 21 Aug 2025 10:28:38 +0200
Subject: [PATCH] Providing information about top sold articles

---
 src/v2/shop.yaml | 41 ++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 40 insertions(+), 1 deletion(-)

diff --git a/src/v2/shop.yaml b/src/v2/shop.yaml
index f71e3d0..71b32d6 100644
--- a/src/v2/shop.yaml
+++ b/src/v2/shop.yaml
@@ -117,6 +117,36 @@ paths:
           $ref: "#/components/responses/GenericError"
       security: 
       - SessionScheme: []
+  /TopSoldArticles:
+    get:
+      tags:
+      - "General"
+      parameters:
+      - $ref: "#/components/parameters/GuidOnlineService"
+      - name: "Type"
+        description: "Provide the types you want to get."
+        in: "query"
+        required: true
+        schema:
+          type: "string"
+          enum:
+            - "Last7Days"
+            - "Last30Days"
+            - "Last90Days"
+            - "Last365Days"
+      responses:
+        200:
+          description: "successful operation"
+          content:
+            application/json:
+              schema:
+                type: "array"
+                items:
+                  $ref: "#/components/schemas/TopSoldArticle"
+        default:
+          $ref: "#/components/responses/GenericError"
+      security: 
+      - SessionScheme: []
 # Settings
   /Configs:
     get:
@@ -1947,6 +1977,16 @@ components:
               type: "number"
             PriceGross:
               type: "number"
+        TopSoldArticle:
+          type: "object"
+          required:
+            - "GuidShopArticle"
+            - "NumberOfSells"
+          properties:
+            GuidShopArticle:
+              type: "string"
+            NumberOfSells:
+              type: "number"
     securitySchemes:
         SessionScheme:
             type: http
@@ -2108,7 +2148,6 @@ components:
 # GET /Vehicles
 # GET /Tubes
 # GET /Campaigns
-# GET /TopSoldArticles