feat: openapi specs for send_back_reports_api

reference/admin.yaml

@@ -4027,6 +4027,23 @@ components:
       description: |
         Explanation to the action if provided by the user
       example: All bills are in order
+    reports_send_back_in:
+      type: object
+      additionalProperties: false
+      required:
+        - id
+        - reason
+      properties:
+        id:
+          type: string
+          description: |
+            id of report, which need to be send_back
+          example: rpa21A2rdj2
+        reason:
+          type: string
+          description: |
+            reason for sending back the report
+          example: We don't accept laundry bills
     process_ach_in:
       type: object
       properties:
@@ -12523,6 +12540,67 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/404'
+  /admin/reports/send_back/bulk:
+    post:
+      tags:
+        - Reports
+      summary: Reports Send_back
+      description: |
+        Reports Send_back
+      operationId: reports_send_back
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              additionalProperties: false
+              required:
+                - data
+              properties:
+                data:
+                  type: array
+                  items:
+                    $ref: '#/components/schemas/reports_send_back_in'
+      responses:
+        '200':
+          description: OK
+        '400':
+          description: Bad request
+          content:
+            application/json:
+              schema:
+                oneOf:
+                  - $ref: '#/components/schemas/bulk_error'
+                  - type: object
+                    properties:
+                      error:
+                        type: string
+                        nullable: true
+                      message:
+                        type: string
+                        nullable: true
+                      data:
+                        type: object
+                        nullable: true
+        '401':
+          description: Unauthorized request
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/401'
+        '403':
+          description: Forbidden
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/403'
+        '404':
+          description: Not Found
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/404'
   /admin/reports/process_ach/bulk:
     post:
       tags:

src/admin/openapi.yaml

@@ -188,6 +188,8 @@ paths:
     $ref: paths/admin@reports.yaml
   /admin/reports/eject_expenses:
     $ref: 'paths/admin@reports@eject_expenses.yaml'
+  /admin/reports/send_back/bulk:
+    $ref: 'paths/admin@reports@send_back@bulk.yaml'
   /admin/reports/process_ach/bulk:
     $ref: paths/admin@reports@process_ach@bulk.yaml
   /admin/reports/mark_paid/bulk:

src/admin/paths/admin@reports@send_back@bulk.yaml

@@ -0,0 +1,60 @@
+post:
+  tags:
+    - Reports
+  summary: Reports Send_back
+  description: |
+    Reports Send_back
+  operationId: reports_send_back
+  requestBody:
+    required: true
+    content:
+      application/json:
+        schema:
+          type: object
+          additionalProperties: False
+          required:
+            - data
+          properties:
+            data:
+              type: array
+              items:
+                $ref: ../../components/schemas/report.yaml#/reports_send_back_in
+  responses:
+    '200':
+      description: OK
+    '400':
+      description: Bad request
+      content:
+        application/json:
+          schema:
+            oneOf:
+              - $ref: ../../components/schemas/bulk_error.yaml
+              - type: object
+                properties:
+                  error:
+                    type: string
+                    nullable: true
+                  message:
+                    type: string
+                    nullable: true
+                  data:
+                    type: object
+                    nullable: true
+    '401':
+      description: Unauthorized request
+      content:
+        application/json:
+          schema:
+            $ref: ../../components/schemas/401.yaml
+    '403':
+      description: Forbidden
+      content:
+        application/json:
+          schema:
+            $ref: ../../components/schemas/403.yaml
+    '404':
+      description: Not Found
+      content:
+        application/json:
+          schema:
+            $ref: '../../components/schemas/404.yaml'

src/components/schemas/report.yaml

@@ -488,6 +488,24 @@ report_action_with_expenses_ids_to_eject:
           - $ref: './fields.yaml#/id_string'
       example: [ 'txelntgwgwll' ]
 
+reports_send_back_in:
+  type: object
+  additionalProperties: False
+  required:
+    - id
+    - reason
+  properties:
+    id:
+      type: string
+      description: |
+        id of report, which need to be send_back
+      example: 'rpa21A2rdj2'
+    reason:
+      type: string
+      description: |
+        reason for sending back the report
+      example: "We don't accept laundry bills"
+
 report_action_submit:
   type: object
   additionalProperties: False