{"openapi":"3.0.1","info":{"title":"A5 public API v02","version":"1.0.0"},"servers":[{"description":"SwaggerHub API Auto Mocking","url":"https://virtserver.swaggerhub.com/galickyav/A5_public_API_v02/1.0.0"},{"url":"http://localhost:8000/api/v1/","description":"сервер надо указать правильный"}],"paths":{"/getOrgData":{"get":{"summary":"Метод отримання організації","tags":["Організаційно-штатна структура"],"operationId":"getOrgData","parameters":[{"name":"EDRPOUCode","in":"header","required":false,"description":"ЄДРПОУ код організації, дані якої потрібно отримати","schema":{"type":"number"},"example":32855961},{"name":"onDate","in":"header","required":false,"description":"Дата, на яку потрібно отримати дані у вигляді \"рррр-мм-дд\"","schema":{"type":"string"},"example":"2024-02-15"},{"name":"positionType","in":"header","required":false,"description":"Значення або масив значень для фільтрації штатних посад та призначень за типом посади","schema":{"type":"string"}},{"name":"workPlace","in":"header","required":false,"description":"Значення або масив значень для фільтрації призначень за місцем роботи","schema":{"type":"string"}}],"responses":{"200":{"description":"Повертає інформацію по організації","content":{"application/json":{"schema":{"type":"object","properties":{"organization":{"description":"dfdfdfdfdf","type":"array","required":["ID","mi_data_id","parentUnitID","EDRPOUCode","name","dateFrom","dateTo","state","mi_deleteDate","mi_createDate","mi_modifyDate"],"items":{"type":"object","properties":{"ID":{"type":"number","example":123456,"description":"Унікальний у межах системи числовий ідентифікатор"},"mi_data_id":{"type":"number","example":123456,"description":"Унікальний ідентифікатор організаційної одиниці"},"parentUnitID":{"type":"number","example":123456,"description":"Підпорядкування"},"EDRPOUCode":{"type":"number","example":123456,"description":"Код ЄДРПОУ"},"name":{"type":"string","example":"Romashka LTD","description":"Назва організації"},"dateFrom":{"type":"string","example":"12.01.2020","format":"12.01.2020"},"dateTo":{"type":"string","example":"12.01.2020","format":"12.01.2020"},"state":{"type":"string","enum":["ACTIVE","NEW"],"description":"діючий або новий запис"},"mi_deleteDate":{"type":"string","example":"12.01.2020","format":"12.01.2020","description":"Дата видалення"},"mi_createDate":{"type":"string","example":"12.01.2020","format":"12.01.2020","description":"Дата створення"},"mi_modifyDate":{"type":"string","example":"12.01.2020","format":"12.01.2020","description":"Дата останньої зміни даних"}}}},"department":{"type":"array","required":["ID","mi_data_id","parentUnitID","orgID","name"],"items":{"type":"object","properties":{"ID":{"type":"number","example":123456,"description":"Унікальний у межах системи числовий ідентифікатор"},"mi_data_id":{"type":"number","example":123456,"description":"Унікальний ідентифікатор організаційної одиниці"},"parentUnitID":{"type":"number","example":123456,"description":"Підпорядкування"},"orgID":{"type":"number","example":123456,"description":"Організація"},"name":{"type":"string","example":"Romashka LTD","description":"Назва організації"},"positionChiefID":{"type":"number","example":123456,"description":"Посада керівника підрозділу"},"employeeChiefID":{"type":"number","example":123456,"description":"Керівник підрозділу"},"dateFrom":{"type":"string","example":"12.01.2020","format":"12.01.2020"},"dateTo":{"type":"string","example":"12.01.2020","format":"12.01.2020"},"state":{"type":"string","enum":["ACTIVE","NEW"],"description":"діючий або новий запис"},"mi_deleteDate":{"type":"string","example":"12.01.2020","format":"12.01.2020","description":"Дата видалення"},"mi_createDate":{"type":"string","example":"12.01.2020","format":"12.01.2020","description":"Дата створення"},"mi_modifyDate":{"type":"string","example":"12.01.2020","format":"12.01.2020","description":"Дата останньої зміни даних"}}}},"position":{"type":"array","required":["ID","mi_data_id","parentUnitID","orgID","name"],"items":{"type":"object","properties":{"ID":{"type":"number","example":123456,"description":"Унікальний у межах системи числовий ідентифікатор"},"mi_data_id":{"type":"number","example":123456,"description":"Унікальний ідентифікатор організаційної одиниці"},"parentUnitID":{"type":"number","example":123456,"description":"Підпорядкування"},"orgID":{"type":"number","example":123456,"description":"Організація"},"name":{"type":"string","example":"Romashka LTD","description":"Назва організації"},"dateFrom":{"type":"string","example":"12.01.2020","format":"12.01.2020","description":"Дата початку дії даного запису. Запис вважається діючим у періоді «Діє з» – «Діє по»"},"dateTo":{"type":"string","example":"12.01.2020","format":"12.01.2020","description":"Дата закінчення дії даного запису. Запис вважається діючим у періоді «Діє з» – «Діє по»"},"state":{"type":"string","enum":["ACTIVE","NEW"],"description":"діючий або новий запис"},"positionType":{"type":"number","example":123456,"description":"Код типу посади"},"positionTypeName":{"type":"string","example":"Бухгалтер-касир","description":"Назва типу посади"},"mi_deleteDate":{"type":"string","example":"12.01.2020","format":"12.01.2020","description":"Дата видалення"},"mi_createDate":{"type":"string","example":"12.01.2020","format":"12.01.2020","description":"Дата створення"},"mi_modifyDate":{"type":"string","example":"12.01.2020","format":"12.01.2020","description":"Дата останньої зміни даних"}}}},"employee":{"type":"array","required":["ID","taxCode","taxCodeType","fullName","lastName","firstName","middleName","lastNameEng","firstNameEng","middleNameEng","birthDate","phoneMobile","phoneWorking","email","photo","orgID","mi_deleteDate","mi_createDate","mi_modifyDate"],"items":{"type":"object","properties":{"ID":{"type":"number","example":123456,"description":"Унікальний у межах системи числовий ідентифікатор"},"taxCode":{"anyOf":[{"type":"string"},{"type":"number"}],"example":"KA 222333","description":"РНОКПП або паспорт.  Мае бути 10-значний ІПН, або паспорт XX999999 (серія 2 знаки та номер)"},"taxCodeType":{"anyOf":[{"type":"string"},{"type":"number"}],"example":"KA 222333","description":"Код типу."},"fullName":{"type":"string","example":"Петров Петро Петрович","description":"ПІБ"},"lastName":{"type":"string","example":"Петров","description":"Прізвище"},"firstName":{"type":"string","example":"Петро","description":"Ім’я"},"middleName":{"type":"string","example":"Петрович","description":"По батькові"},"lastNameEng":{"type":"string","example":"Petrov","description":"Прізвище (англ.)"},"firstNameEng":{"type":"string","example":"Petro","description":"Ім’я (англ.)"},"middleNameEng":{"type":"string","example":"Petrovich","description":"По батькові (англ.)"},"birthDate":{"type":"string","example":"1985.12.25","description":"Дата народження"},"phoneMobile":{"type":"number","example":"38 050 394 58 62","description":"Телефон мобільний"},"phoneWorking":{"type":"number","example":"38 022 394 58 62","description":"Телефон робочій"},"email":{"anyOf":[{"type":"string"},{"type":"number"}],"example":"petro@gmail.com","description":"Адреса електронної пошти"},"photo":{"type":"string","description":"Телефон мобільний"},"orgID":{"type":"number","description":"Ідентифікатор організації"},"mi_deleteDate":{"type":"string","example":"12.01.2020","format":"12.01.2020","description":"Дата видалення"},"mi_createDate":{"type":"string","example":"12.01.2020","format":"12.01.2020","description":"Дата створення"},"mi_modifyDate":{"type":"string","example":"12.01.2020","format":"12.01.2020","description":"Дата останньої зміни даних"}}}},"employeePosition":{"type":"array","required":["ID","employeeID","orgID","departmentID","positionID","dateFrom","dateTo","isActive","positionType","positionTypeName","workPlace","workPlaceName","mi_deleteDate","mi_createDate","mi_modifyDate"],"items":{"type":"object","properties":{"ID":{"type":"number","example":123456,"description":"Унікальний у межах системи числовий ідентифікатор"},"employeeID":{"type":"number","description":"Ідентифікатор Особи"},"orgID":{"type":"number","description":"Ідентифікатор організації"},"departmentID":{"type":"number","description":"Ідентифікатор підрозділу"},"positionID":{"type":"number","description":"Ідентифікатор посади"},"dateFrom":{"type":"number","description":"Діє з","example":"12.01.2020"},"dateTo":{"type":"number","description":"Діє по","example":"12.01.2020"},"isActive":{"type":"string","description":"Ознака актуальності. isActive=true – запис актуальний."},"positionType":{"type":"number","description":"Код типу посади"},"positionTypeName":{"type":"string","description":"Назва типу посади"},"workPlace":{"type":"number","description":"Код місця роботи"},"workPlaceName":{"type":"string","description":"Назва місця роботи"},"mi_deleteDate":{"type":"string","example":"12.01.2020","format":"12.01.2020","description":"Дата видалення"},"mi_createDate":{"type":"string","example":"12.01.2020","format":"12.01.2020","description":"Дата створення"},"mi_modifyDate":{"type":"string","example":"12.01.2020","format":"12.01.2020","description":"Дата останньої зміни даних"}}}},"orgRespPosition":{"type":"array","required":["ID","orgID","positionID","dateFrom","dateTo","mi_deleteDate","mi_createDate","mi_modifyDate"],"items":{"type":"object","properties":{"ID":{"type":"number","example":123456,"description":"Унікальний у межах системи числовий ідентифікатор"},"orgID":{"type":"number","description":"Ідентифікатор організації"},"positionID":{"type":"number","description":"Ідентифікатор посади"},"dateFrom":{"type":"number","description":"Діє з","example":"12.01.2020"},"dateTo":{"type":"number","description":"Діє по","example":"12.01.2020"},"mi_deleteDate":{"type":"string","example":"12.01.2020","format":"12.01.2020","description":"Дата видалення"},"mi_createDate":{"type":"string","example":"12.01.2020","format":"12.01.2020","description":"Дата створення"},"mi_modifyDate":{"type":"string","example":"12.01.2020","format":"12.01.2020","description":"Дата останньої зміни даних"}}}}}}}}},"400":{"description":"Некоректний запит","content":{"aplication/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"403":{"description":"Помилка авторизації.","content":{"aplication/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"500":{"description":"Внутрішня помилка системи.","content":{"aplication/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}},"/getPhoto":{"get":{"summary":"Метод отримання фото працівників","tags":["Організаційно-штатна структура"],"operationId":"getPhoto","parameters":[{"name":"employeeID","in":"header","required":true,"description":"Ідентифікатор працівника","schema":{"type":"number"},"example":123456}],"responses":{"200":{"description":"Повертає фото працівника","content":{"application/json":{"schema":{"type":"object","properties":{"photo":{"type":"string","description":"дані закодовані в Base64"},"contentType":{"type":"string","description":"MIME-тип зображення"},"size":{"type":"number","description":"розмір в байтах","example":25684}}}}}},"400":{"description":"Некоректний запит","content":{"aplication/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"403":{"description":"Помилка авторизації.","content":{"aplication/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}},"500":{"description":"Внутрішня помилка системи.","content":{"aplication/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}}}}}}}}}}}