[{"data":1,"prerenderedAt":155},["ShallowReactive",2],{"help-article-staff-571":3,"help-view-staff":37},{"data":4},{"help":5},{"id":6,"name":7,"article":8},"48","Staff",{"id":9,"catalog":10,"category":11,"keywords":14,"title":25,"description":26,"body":27,"legacy":28,"created_by":29,"created_at":33,"updated_at":34,"edge_associated_articles":35},"571",{"id":6,"name":7},{"id":12,"name":13},"83","Огляди можливостей",[15,16,17,18,19,20,21,22,23,24],"API","MCP","інтеграції","ключ API","ШІ-асистент","експериментальні функції","рівень доступу","імпорт історії","відсутності","значення змінних","Публічний API і MCP: що можна читати й змінювати ззовні","OneB Staff можна під'єднати до інших систем і до ШІ-асистентів. Для цього є дві поверхні: **API для інтеграцій** (для розробників, які пишуть код) і **MCP для ШІ-асистентів** (Claude, ChatGPT та інші, які вміють працювати з інструментами). Обидві вмикаються в Налаштуваннях, пункт «Експериментальні функції».\n\n![Екран «Е","OneB Staff можна під'єднати до інших систем і до ШІ-асистентів. Для цього є дві поверхні: **API для інтеграцій** (для розробників, які пишуть код) і **MCP для ШІ-асистентів** (Claude, ChatGPT та інші, які вміють працювати з інструментами). Обидві вмикаються в Налаштуваннях, пункт «Експериментальні функції».\n\n![Екран «Експериментальні функції»: перемикачі MCP і API, рівень доступу, ключі](/img/s4/9856/5b32d9aa1fefe5db0f7c2a4d4fadc4b5b423.png?s=3121f194f9ce12bb17e1418b20a63eff \"Налаштування → Експериментальні функції\")\n\n## Що можна робити ззовні\n\nЧерез API і MCP доступне все те саме, що бачить і робить користувач у застосунку, але поступово: спочатку читання, далі зміни по розділах.\n\n**Читання (доступне всім):** команда (особи, трудові договори, посади), довідники (компанії, відділи, посади, календарі, категорії нарахувань, змінні, схеми), нарахування й виплати, баланси «кому скільки винні», відсутності й залишки відпусток, прогони нарахувань, платіжна відомість і прогноз ФОТ, а також попередні перегляди «що буде, якщо» (нарахування за період, перерахунок, компенсація відпустки) без жодних змін у даних.\n\n**Зміни (перший етап — команда й довідники):**\n\n- **Компанії:** створити й відредагувати реквізити. Валюта задається при створенні й далі не змінюється.\n- **Відділи й посади з довідника:** створити, перейменувати, видалити. Видалити можна лише відділ або посаду, на які не посилаються працівники; підвідділи видаляються разом із відділом.\n- **Платіжний календар компанії:** задати дні нарахувань і виплат цілком.\n- **Виробничий календар:** додати або прибрати свято чи перенесений робочий день на дату, скопіювати винятки з попереднього року.\n- **Особи:** створити людину разом із першим трудовим договором, змінити персональні дані (контакти, адресу, страховий стаж, ознаку інвалідності).\n- **Трудові договори:** додати особі ще один договір (сумісництво), змінити стартовий залишок відпустки, звільнити, прийняти знову, поставити або зняти паузу планових нарахувань і заздалегідь побачити, які місяці вона пропустить.\n- **Посади в договорі:** додати посаду, змінити відділ, посаду з довідника чи схему нарахувань, закрити посаду датою.\n\n**Зміни (другий етап — історія, відсутності, значення):**\n\n- **Імпорт історії** зі старої системи або таблиці: працівники, історія окладів, нарахування, виплати й відсутності. Докладніше — у розділі нижче.\n- **Відсутності:** створити документ (відпустка, лікарняний, відрядження тощо), змінити його, поки він не проведений, підтвердити або зняти підтвердження, змінити дату завершення вже проведеної відсутності з перерахунком, провести нарахування по одному документу або пакетом до 100.\n- **Типи відсутностей і норми добових:** подивитися картку, створити новий тип чи норму, відредагувати. Ключ типу (alias) не можна змінити, якщо тип уже використаний у документах; ключ норми утворюється з назви при створенні й далі не змінюється.\n- **Компенсація невикористаної відпустки:** провести для звільненого працівника на вказану дату. Якщо невикористаних днів не лишилося, система відмовить і пояснить чому.\n- **Значення змінних розрахунку:** задати постійні значення (оклад, ставки) на рівні всього робочого простору, компанії, відділу, посади з довідника або конкретної посади працівника; додати версію значення «з дати»; задати помісячні показники (наприклад, відпрацьовані години) працівникам компанії за місяць.\n\nТретій етап додасть прогони нарахувань, ручні нарахування й виплати, перерахунки; четвертий — сторно, видалення й керування каталогом змінних і схем.\n\n## Імпорт історії через API або ШІ-асистента\n\nІмпорт двокроковий, щоб помилкові дані не потрапили в облік непомітно:\n\n1. **Подати рядки.** Інтеграція або асистент надсилає список рядків одного типу (до 1000 за раз). Система нічого не записує, а повертає результат перевірки: скільки рядків готові, скільки з попередженнями, скільки з помилками, і перші 20 помилок із номерами рядків і порадою, що виправити.\n2. **Підтвердити.** Якщо все гаразд, підтвердження записує дані. Помилкові рядки можна пропустити, підтвердивши лише готові. Непідтверджений результат перевірки зберігається 7 днів, потім видаляється.\n\nРекомендований порядок для перенесення історії клієнта: спочатку працівники (вони створюються разом із першим трудовим договором; невідомі відділи й посади додаються в довідник автоматично), далі історія окладів, нарахування, виплати й відсутності. Дати й суми можна подавати у звичному людському вигляді («05.07.2026», «19 250,50») — система їх розпізнає. Імпорт працівників займає місця ліміту працівників тарифу: якщо ліміт вичерпано, підтвердження відмовить, а результат перевірки залишиться, щоб повторити після зміни тарифу.\n\nДля нарахувань після підтвердження доступна **звірка**: система порівнює імпортовані суми з тим, що порахувала б сама за поточними налаштуваннями, і показує розбіжності по працівниках і місяцях.\n\n## Рівні доступу\n\nЩо саме дозволено, визначає рівень:\n\n| Рівень | Що дозволяє |\n| --- | --- |\n| Читання | лише дивитися дані |\n| Читання і зміни | створювати, редагувати, звільняти, проводити, імпортувати |\n| Повний | те саме, а також видаляти й скасовувати |\n\nДля API рівень має кожен ключ окремо, для MCP один рівень задається на весь робочий простір. Якщо ШІ-асистент або інтеграція намагається зробити більше, ніж дозволено, у відповіді буде зрозуміле пояснення, який рівень потрібен і де його увімкнути.\n\n## Захист від втрати історії\n\nВидалити через API чи MCP можна лише те, що не має історії:\n\n- особу або договір — лише якщо по договорах немає нарахувань, виплат, відсутностей і компенсацій відпустки;\n- посаду в договорі — лише без нарахувань і заданих значень змінних;\n- відділ або посаду з довідника — лише якщо на них не посилаються посади працівників.\n\nДля припинення трудових відносин використовуйте звільнення, а не видалення: історія нарахувань зберігається, а працівника можна прийняти знову.\n\nОкремо про значення змінних: зняття значення на якомусь рівні видаляє всю історію версій цієї змінної на цьому рівні (включно з майбутніми). Якщо потрібно лише змінити суму — задайте нове значення або додайте версію «з дати», а не знімайте його.\n\n## Як почати\n\n1. Відкрийте Налаштування → Експериментальні функції.\n2. **Для ШІ-асистента:** увімкніть «Дозволити підключення через MCP», оберіть рівень доступу й скопіюйте адресу підключення в налаштування асистента.\n3. **Для інтеграції кодом:** увімкніть «Дозволити доступ через API», натисніть «Створити ключ», задайте назву, рівень і за потреби термін дії. Ключ показується один раз, збережіть його одразу. Опис усіх операцій є за посиланням «Документація API».\n4. Ключ, що більше не потрібен, відкличте в тому самому списку.\n\nДоступ через API і MCP залежить від тарифу робочого простору.",false,{"id":30,"name":31,"photo_url":32},"37","Ярослав Плакида","https://account.oneb.app/uploads/usr/photo/1/JMQPpCmTUtL2j8Mecr5W3TbY5ZbyK4fw.jpeg?w=300&h=300&fit=crop&s=7712ff4ac866b4965be19403505c01c8",1791374835,1791399002,{"edges":36},[],{"data":38},{"help":39},{"id":6,"name":7,"language":40,"edge_categories":41,"edge_translations":153},null,{"page_info":42,"edges":44},{"has_next_page":28,"end_cursor":43},"W1s0XSxbMSw4MF1d",[45,65,93,121],{"node":46},{"id":47,"name":48,"created_at":49,"articles_count":50,"edge_preview_articles":51},"81","З чого почати",1782908698,3,{"edges":52},[53,57,61],{"node":54},{"id":55,"title":56},"478","Що таке Staff: огляд застосунку",{"node":58},{"id":59,"title":60},"464","Перехід з іншої системи: як перенести всі дані",{"node":62},{"id":63,"title":64},"378","Як імпортувати співробітників з Excel або CSV",{"node":66},{"id":67,"name":68,"created_at":69,"articles_count":70,"edge_preview_articles":71},"82","Поняття й терміни",1782955204,5,{"edges":72},[73,77,81,85,89],{"node":74},{"id":75,"title":76},"473","Мінбаза і максбаза ЄСВ, зміни заднім числом",{"node":78},{"id":79,"title":80},"469","Баланс відпустки і страховий стаж",{"node":82},{"id":83,"title":84},"411","Категорії нарахувань: баланс і податки",{"node":86},{"id":87,"title":88},"383","Як дати прийняття та звільнення впливають на нарахування",{"node":90},{"id":91,"title":92},"380","Тип значення змінної: число чи відсоток",{"node":94},{"id":12,"name":13,"created_at":95,"articles_count":96,"edge_preview_articles":97},1782958181,13,{"edges":98},[99,101,105,109,113,117],{"node":100},{"id":9,"title":25},{"node":102},{"id":103,"title":104},"570","Пауза нарахувань: як тимчасово не нараховувати зарплату",{"node":106},{"id":107,"title":108},"569","Експериментальні функції: API для інтеграцій і MCP для ШІ-асистентів",{"node":110},{"id":111,"title":112},"477","Доступ для служби підтримки",{"node":114},{"id":115,"title":116},"468","Відсутності: календар, типи і статуси",{"node":118},{"id":119,"title":120},"414","Картка співробітника: повний огляд",{"node":122},{"id":123,"name":124,"created_at":125,"articles_count":126,"edge_preview_articles":127},"80","Покрокові інструкції",1782809096,17,{"edges":128},[129,133,137,141,145,149],{"node":130},{"id":131,"title":132},"476","Масове проведення відпускних і лікарняних",{"node":134},{"id":135,"title":136},"474","Імпорт історії відсутностей з Excel: покрокова інструкція",{"node":138},{"id":139,"title":140},"472","Компенсація невикористаної відпустки при звільненні",{"node":142},{"id":143,"title":144},"471","Відрядження і добові",{"node":146},{"id":147,"title":148},"470","Як нарахувати відпускні, лікарняні та декретні",{"node":150},{"id":151,"title":152},"467","Імпорт історії виплат з Excel: покрокова інструкція",{"edges":154},[],1791429752778]