Merge branch 'feature/H-1976' into 'master'

feature/H-1976 See merge request hrbox-public/api!17
2025-04-25 04:31:26 +00:00
parent fd4f688dc9 3d1f3a0d25
commit 505213857c
1 changed files with 127 additions and 0 deletions
@@ -483,6 +483,55 @@ paths:
        500:
          description: Server Error

+  /org-employment-file/index:
+    get:
+      tags:
+        - org-employment
+      summary: Get list of requested org employment files
+      responses:
+        200:
+          description: Org employment files
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  data:
+                    type: array
+                    items:
+                      $ref: '#/components/schemas/orgEmploymentFile'
+                  _links:
+                    $ref: '#/components/schemas/_links'
+                  _meta:
+                    $ref: '#/components/schemas/_meta'
+        401:
+          description: Unauthorized request
+        403:
+          description: Unauthorized request
+        500:
+          description: Server Error
+
+  /org-employment-file/request:
+    get:
+      tags:
+        - org-employment
+      summary: Get org employment file
+      responses:
+        200:
+          description: Get org employment file
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/orgEmploymentFile'
+        401:
+          description: Unauthorized request
+        403:
+          description: Unauthorized request
+        404:
+          description: File not found
+        500:
+          description: Server Error
+
  /user-group/items:
    get:
      tags:
@@ -8403,6 +8452,84 @@ components:
    shopOrderCancelResponse:
      $ref: '#/components/schemas/apiDefaultResponse'

+    orgEmploymentFile:
+      type: object
+      properties:
+        id:
+          description: ID записи
+          type: string
+          format: uuid
+          example: 195e1707-3f5d-4780-8dc1-b1023e1f974f
+        org_employment_id:
+          description: ID конкретного сотрудника
+          type: string
+          format: uuid
+          example: 195e1707-3f5d-4780-8dc1-b1023e1f974f
+        org_employment_file_status_id:
+          type: integer
+          description: Cостояние документа
+          oneOf:
+            - title: REQUESTED
+              const: 1
+              description: "Запрошен"
+            - title: PENDING
+              const: 2
+              description: "В обработке"
+            - title: READY
+              const: 3
+              description: "Готов"
+        org_employment_file_type_id:
+          type: integer
+          description: Тип документа
+          oneOf:
+            - title: PAYSLIP
+              const: payslip
+              description: "Расчетный лист"
+            - title: NDFL2
+              const: ndfl2
+              description: "2НДФЛ"
+            - title: CUSTOM
+              const: custom
+              description: "Кастомный тип"
+        custom_id:
+          description: ID кастомной обработки
+          type: string
+          maxLength: 127
+        date_from:
+          description: Дата с (например для расчетной ведомости, за период с)
+          type: string
+          format: 'date'
+          example: 2025-04-23
+        date_to:
+          description: Дата по (например для расчетной ведомости, за период по)
+          type: string
+          format: 'date'
+          example: 2025-04-27
+        created_at:
+          type: string
+          description: Дата последнего изменения
+          format: 'date-time'
+          example: 2025-04-25 16:15:03
+        updated_at:
+          type: string
+          description: Дата создания
+          format: 'date-time'
+          example: 2025-04-25 16:15:03
+        ready_at:
+          type: string
+          format: 'date-time'
+          example: 2025-04-25 16:15:03
+        organization_id:
+          type: string
+          description: ID организации
+          format: uuid
+          example: 195e1707-3f5d-4780-8dc1-b1023e1f974f
+        user_id:
+          type: string
+          description: ID пользователя
+          format: uuid
+          example: 195e1707-3f5d-4780-8dc1-b1023e1f974f
+
  parameters:
    boardDateTypeParam:
      in: query