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

feature/H-1976

See merge request hrbox-public/api!19

v2/swagger.yaml

@@ -483,6 +483,76 @@ paths:
         500:
           description: Server Error
 
+  /org-employment/index:
+    get:
+      tags:
+        - org-employment
+      summary: Org employments
+      parameters:
+        - name: id
+          in: query
+          description: Unique identifier of the OrgEmployment (UUID)
+          required: false
+          schema:
+            type: string
+            format: uuid
+        - name: is_removed
+          in: query
+          description: Deleted org employments
+          required: false
+          schema:
+            type: boolean
+      responses:
+        200:
+          description: Get list of requested org employments
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  data:
+                    type: array
+                    items:
+                      $ref: '#/components/schemas/orgEmployment'
+                  _links:
+                    $ref: '#/components/schemas/_links'
+                  _meta:
+                    $ref: '#/components/schemas/_meta'
+        401:
+          description: Unauthorized request
+        403:
+          description: Unauthorized request
+        500:
+          description: Server Error
+
+  /org-employment/view:
+    get:
+      tags:
+        - org-employment
+      summary: View org employment
+      parameters:
+        - name: id
+          in: query
+          description: Unique identifier of the OrgEmployment (UUID)
+          required: false
+          schema:
+            type: string
+            format: uuid
+      responses:
+        200:
+          description: Get single org employment
+          content:
+            application/json:
+              schema:
+                #/components/schemas/orgEmployment
+        401:
+          description: Unauthorized request
+        403:
+          description: Unauthorized request
+        500:
+          description: Server Error
+
+
   /org-employment-file/index:
     get:
       tags:
@@ -8593,6 +8663,190 @@ components:
     shopOrderCancelResponse:
       $ref: '#/components/schemas/apiDefaultResponse'
 
+    orgEmployment:
+      type: object
+      properties:
+        id:
+          type: string
+          format: uuid
+          example: "db43fc69-35f7-4c66-8a63-633b5e9abe33"
+        organization_id:
+          type: string
+          example: "default"
+        org_department_id:
+          type: string
+          format: uuid
+          example: "0212e611-5b19-43f9-8389-7f6a4b87462d"
+        chief_id:
+          type:
+            - string
+            - null
+          example: null
+        chief_organization_id:
+          type: string
+          example: "default"
+        position:
+          type: string
+          example: "Водитель"
+        employment_date:
+          type: string
+          format: date
+          example: "2019-09-25"
+        fired_date:
+          type:
+            - string
+            - null
+          format: date
+          example: null
+        changed_at:
+          type: string
+          format: date-time
+          example: "2025-04-22 05:20:57"
+        org_num:
+          type: string
+          example: "db43fc69-35f7-4c66-8a63-633b5e9abe33"
+        is_removed:
+          type: boolean
+          example: false
+        first_name:
+          type: string
+          example: "Иван"
+        last_name:
+          type: string
+          example: "Петрович"
+        middle_name:
+          type: string
+          example: "F"
+        birthday_date:
+          type: string
+          format: date
+          example: "2004-04-04"
+        gender:
+          type: string
+          enum:
+            - male
+            - female
+          example: "male"
+        photo:
+          type:
+            - string
+            - null
+          example: null
+        emails:
+          type: array
+          items:
+            type: string
+            format: email
+          example: [ ]
+        phones:
+          type: array
+          items:
+            type: string
+          example: [ ]
+        other_contacts:
+          type: array
+          items:
+            type: string
+          example: [ ]
+        user_custom_fields:
+          type: array
+          items:
+            type: object
+          example: [ ]
+        custom:
+          type: array
+          items:
+            type: object
+          example: [ ]
+        cabinet:
+          type: string
+          example: "230"
+        city:
+          type: string
+          example: "Караганда"
+        country_id:
+          type:
+            - string
+            - null
+          example: null
+        timezone_id:
+          type:
+            - string
+            - null
+          example: null
+        statuses:
+          type: array
+          items:
+            type: string
+          example: [ ]
+        login:
+          type:
+            - string
+            - null
+          example: null
+        auth_email:
+          type:
+            - string
+            - null
+          format: email
+          example: null
+        expert_user_id:
+          type:
+            - string
+            - null
+          example: null
+        orgDepartment:
+          $ref: "#/components/schemas/orgDepartment"
+
+    orgDepartment:
+      type: object
+      properties:
+        id:
+          type: string
+          format: uuid
+          example: "0212e611-5b19-43f9-8389-7f6a4b87462d"
+        organization_id:
+          type: string
+          example: "default"
+        name:
+          type: string
+          example: "HRBox org"
+        parent_id:
+          type:
+            - string
+            - null
+          example: null
+        chief_id:
+          type:
+            - string
+            - null
+          example: null
+        chief_organization_id:
+          type:
+            - string
+            - null
+          example: null
+        changed_at:
+          type: string
+          format: date-time
+          example: "2025-04-28 19:13:28"
+        org_num:
+          type: string
+          example: "2345"
+        is_removed:
+          type: boolean
+          example: false
+        department_id:
+          type: string
+          format: uuid
+          example: "5270b5ce-8320-4d83-a096-8a72f8c24307"
+        is_ignored:
+          type: boolean
+          example: false
+        is_synced:
+          type: boolean
+          example: false
+
     orgEmploymentFile:
       type: object
       properties: