Як це побудовано
Кожна дія тут є також викликом API, інструментом для агента і командою CLI: список дій.
шар 4
Екрани
Сторінки, Data API, ключі, вхід. Логіки тут немає: вона в шарах нижче.
- web
Один публічний Worker. Малює сторінки з описів модулів і віддає ті самі дії через API. Своєї бази не має.
шар 3
Український пакет
Усе, що є українським законом чи практикою. Друга країна - другий пакет, шари під ним не змінюються.
- pack-ua
Ставки й рахунки, ПДВ за першою подією, податкові накладні, податкові режими.
Наймання, картка зарплати з умовами людини, табель з видами відсутності, нарахування з поясненням кожного рядка, відомість за місяць, виплата. Картка містить персональні дані: інвалідність, пенсія, військовий стан, діти, пільги - лише те, що потрібне для розрахунку.
Дії, сторінки, рахунки
- Дії
- run_payroll v2 · accountant Нарахувати зарплату
pay_payroll v2 · accountant Виплатити зарплату і податки
hire_employee v3 · accountant Найняти співробітника
import_employees v1 · accountant Імпортувати список співробітників
record_timesheet v1 · accountant Записати табель
end_employment v1 · accountant Звільнити
set_attributes v1 · accountant Редагувати умови людини
cancel_attributes v1 · accountant Скасувати запис про умови людини
record_leave v1 · accountant Записати відсутність
cancel_leave v1 · accountant Скасувати відсутність
record_pay_input v1 · accountant Записати суму або відсоток за місяць
pay_advance v1 · accountant Виплатити аванс
record_cpi v1 · accountant Записати індекс споживчих цін
record_earnings v1 · accountant Записати заробіток до початку обліку
load_parameters v1 · accountant Завантажити параметри розрахунку
set_parameter v1 · accountant Редагувати параметр розрахунку - Сторінки
- /payroll /payroll/employees /payroll/people /payroll/people/:id /payroll/slip/:id/:period /payroll/register /payroll/register/:period /payroll/timesheet /payroll/timesheet/:period /payroll/params
- Рахунки модуля
- 378 Розрахунки з державними цільовими фондами
471 Забезпечення виплат відпусток
685 Розрахунки з іншими кредиторами
375 Розрахунки за відшкодуванням завданих збитків - Пакети правил
- ua-payroll ua-payslip
- Привʼязка в web
- MOD_PAYROLL
Звʼязок з PeopleKit: найм, зміна окладу, табель з відпусток і звільнення потрапляють в облік без повторного введення.
Податкова система компанії (загальна, 2 чи 3 група, ПДВ), режими контрагентів, податки за місяць, сплата і попередження про ліміти. Реквізити компанії і друковані форми документів.
Дії, сторінки, рахунки
- Дії
- set_profile v1 · accountant Задати податкову систему
set_party_regime v1 · accountant Режим контрагента
accrue_month v1 · accountant Нарахувати податки за місяць
pay_tax v1 · accountant Сплатити податок
set_company v1 · accountant Зберегти реквізити компанії
set_party_requisites v1 · accountant / sales / purchaser Зберегти реквізити контрагента - Сторінки
- /podatky /podatky/company /podatky/party/:id
- Рахунки модуля
- 6413 Розрахунки з податку на прибуток
6415 Розрахунки з єдиного податку
94 Інші витрати операційної діяльності
98 Податок на прибуток (і єдиний податок)
301 Готівка в національній валюті - Пакети правил
- tax-regimes 2026 (packages/rules/src/tax.ts)
- Привʼязка в web
- MOD_PODATKY
Курси НБУ, рахунки іноземних постачальників і оплати у валюті, переоцінка на кінець місяця. Імпорт: товар на склад, митна декларація, мито і ПДВ при ввезенні.
Дії, сторінки, рахунки
- Дії
- fetch_rate v1 · accountant Отримати курс НБУ
fetch_rates v1 · accountant Отримати курси НБУ за період
set_rate v1 · accountant Записати курс вручну
foreign_bill v2 · accountant Рахунок іноземного постачальника
buy_currency v1 · accountant Купівля валюти
pay_foreign v1 · accountant Оплата у валюті
revalue v1 · accountant Переоцінка на кінець місяця
pay_customs v1 · accountant Кошти митниці
customs_entry v1 · accountant Митна декларація
broker_invoice v1 · accountant Рахунок митного брокера
reverse_declaration v1 · accountant Сторнувати митну декларацію
reverse_broker_invoice v1 · accountant Сторнувати рахунок митного брокера - Сторінки
- /valyuta /valyuta/customs /valyuta/customs/receipt/:receiptEventId /valyuta/customs/:id
- Рахунки модуля
- 312 Поточні рахунки в іноземній валюті
632 Розрахунки з іноземними постачальниками
714 Дохід від операційної курсової різниці
945 Втрати від операційної курсової різниці
281 Товари на складі
710 Дохід від первісного визнання та зміни вартості активів
942 Витрати на купівлю-продаж іноземної валюти
201 Сировина й матеріали
377 Розрахунки з іншими дебіторами (митниця)
631 Розрахунки з вітчизняними постачальниками
644 Податковий кредит (не підтверджений)
23 Виробництво
902 Собівартість реалізованих товарів
949 Інші витрати операційної діяльності - Пакети правил
- fx-nbu
- Привʼязка в web
- MOD_VALYUTA
Оборотно-сальдова відомість, картка рахунку, баланс, фінансові результати, рух грошових коштів, управлінський звіт по місяцях, собівартість випуску, чернетки податкових звітів і перевірки. Тільки читає.
Дії, сторінки, рахунки
- Дії
- close_month v1 · chief_accountant Закрити місяць
- Сторінки
- /zvity/zakryttia /zvity/zakryttia/:period /zvity /zvity/osv /zvity/osv/:from/:to /zvity/kartka/:account /zvity/kartka/:account/:from/:to /zvity/kartka/:account/:from/:to/:page /zvity/balans /zvity/balans/:from/:to /zvity/finrez /zvity/finrez/:from/:to /zvity/rukh-koshtiv /zvity/rukh-koshtiv/:from/:to /zvity/ryadok/:of/:line /zvity/ryadok/:of/:line/:from/:to /zvity/upravlinskyi /zvity/upravlinskyi/:from/:to /zvity/sobivartist /zvity/sobivartist/:from/:to /zvity/pdv /zvity/pdv/:from/:to /zvity/prybutok /zvity/prybutok/:from/:to /zvity/dohody-esv /zvity/dohody-esv/:from/:to /zvity/perevirky /zvity/perevirky/:from/:to
- Рахунки модуля
- тільки базові
- Пакети правил
- reports (packages/pack-ua/src/reports)
- Привʼязка в web
- MOD_ZVITY
шар 2
Модулі
Процеси: які кроки є, хто їх робить, що перевіряється. Кожен модуль - окремий Worker без бази.
Рахунки покупцям з ПДВ і оплати з привʼязкою до рахунків.
Дії, сторінки, рахунки
- Дії
- issue_invoice v3 · accountant Виставити рахунок
record_payment v2 · accountant Отримати оплату
create_customer v1 · accountant Створити покупця - Сторінки
- /invoices /invoices/new
- Рахунки модуля
- тільки базові
- Пакети правил
- ua-sales
- Привʼязка в web
- MOD_INVOICING
Банківські рахунки, платежі через банк із затвердженням другою людиною, стрічка виписки із зіставленням, каса з ПКО й ВКО.
Дії, сторінки, рахунки
- Дії
- add_bank_account v1 · accountant Створити банківський рахунок
import_statement v2 · accountant Імпортувати виписку
post_matched v2 · accountant Провести впевнені
post_line v3 · accountant Провести рядок
post_line_as v1 · accountant Провести рядок вручну
ignore_line v1 · accountant Пропустити рядок
cash_in v1 · accountant Прибутковий касовий ордер
expense_report v1 · accountant Авансовий звіт
cash_out v1 · accountant Видатковий касовий ордер
set_receiver v2 · accountant Записати реквізити одержувача
set_tax_receiver v1 · accountant Записати рахунок бюджету або зарплатного проєкту
create_order v1 · accountant Підготувати платіж
build_batch v1 · accountant Зібрати пакет платежів
approve_order v1 · accountant Затвердити платіж
reject_order v1 · accountant Відхилити платіж
cancel_order v1 · accountant Скасувати платіж
mark_sent v2 · accountant Позначити надісланими в банк
confirm_delivery v1 · accountant Записати результат передачі в банк
push_lines v1 · accountant Прийняти рядки виписки від інтеграції
add_line v1 · accountant Додати рядок виписки вручну
match_feed v1 · accountant Зіставити рядки з платежами
link_line v1 · accountant Привʼязати рядок до платежу
simulate_bank v1 · accountant Симулятор банку: виконати надіслані платежі
link_posted v1 · accountant Привʼязати рядок виписки до проведеного платежу
unlink_line v1 · accountant Зняти привʼязку рядка виписки - Сторінки
- /hroshi /hroshi/platezhi /hroshi/oderzhuvachi /hroshi/platezhi/:id /hroshi/strichka
- Рахунки модуля
- 301 Готівка в національній валюті
372 Розрахунки з підзвітними особами
631 Розрахунки з вітчизняними постачальниками
371 Розрахунки за виданими авансами
644 Податковий кредит (не підтверджений)
643 Податкові зобовʼязання (з авансів отриманих)
681 Розрахунки за авансами одержаними - Пакети правил
- без правил
- Привʼязка в web
- MOD_HROSHI
Відвантаження товарів і готової продукції зі складу, оплати й аванси покупців, ПДВ за першою подією і реєстр податкових накладних.
Дії, сторінки, рахунки
- Дії
- ship v4 · sales Відвантажити
new_order v1 · sales Нове замовлення покупця
add_order_line v1 · sales Додати рядок
confirm_order v1 · sales Затвердити й зарезервувати
ship_order v1 · storekeeper Відвантажити за замовленням
cancel_order v1 · sales Скасувати замовлення
return v2 · sales Повернення від покупця
customer_payment v3 · accountant Оплата від покупця
register_tax_invoice v1 · accountant Позначити як зареєстровану
payment_terms v1 · accountant Записати умови оплати покупця
new_request v1 · sales Новий запит покупця
bind_request_line v1 · sales Привʼязати рядок запиту до позиції
accept_request v1 · sales Прийняти запит
decline_request v1 · sales Відхилити запит
close_request v1 · sales Позначити запит виконаним
order_from_request v1 · sales Створити замовлення за запитом
set_deal v1 · sales Зберегти умови угоди
make_for_order v1 · production Запустити у виробництво
mark_sent v1 · sales / storekeeper Позначити документ надісланим
mark_signed v1 · sales / storekeeper Позначити документ підписаним
mark_refused v1 · sales / storekeeper Записати відмову підписати - Сторінки
- /prodazh /prodazh/pay/:documentId /prodazh/pdv /prodazh/pdv/:period /prodazh/requests /prodazh/request/:id /prodazh/order/:id
- Рахунки модуля
- 26 Готова продукція
281 Товари на складі
643 Податкові зобовʼязання (з авансів отриманих)
681 Розрахунки за авансами одержаними
702 Дохід від реалізації товарів
902 Собівартість реалізованих товарів - Пакети правил
- ua-sales-goods
- Привʼязка в web
- MOD_PRODAZH
Вхідні рахунки постачальників з податковим кредитом ПДВ, оплати з привʼязкою до рахунків, і AI-розпізнавання сканів (Cloudflare Workers AI, без ключа; Claude точніший, за ключем).
Дії, сторінки, рахунки
- Дії
- record_bill v2 · accountant Записати рахунок постачальника
pay_bill v1 · accountant Оплатити рахунок постачальника
create_supplier v1 · accountant Створити постачальника
scan_invoice v1 · accountant Розпізнати рахунок (AI)
approve_scanned_bill v1 · accountant Затвердити розпізнаний рахунок
reject_proposal v1 · accountant Відхилити пропозицію - Сторінки
- /expenses /expenses/proposals /expenses/proposals/:id
- Рахунки модуля
- 631 Розрахунки з вітчизняними постачальниками
93 Витрати на збут
644 Податковий кредит (не підтверджений) - Пакети правил
- ua-purchases ua-purchases-no-vat
- Привʼязка в web
- MOD_EXPENSES
Позиції, P/N виробників і прайси постачальників. Один власний код на річ; P/N, код постачальника і старий код ведуть до неї.
Дії, сторінки, рахунки
- Дії
- create_item v2 · purchaser / production Нова позиція
add_mpn v1 · purchaser / production Додати P/N виробника
retire_mpn v1 · purchaser / production Прибрати P/N
set_lifecycle v1 · purchaser / production Зберегти стан позиції
add_analog v1 · purchaser / production Додати аналог у чергу
retire_analog v2 · purchaser / production Прибрати аналог із черги
record_price v1 · purchaser Записати ціну постачальника
find v1 · viewer / storekeeper / sales / purchaser / production Знайти за будь-яким кодом
describe_item v1 · purchaser / production Описати позицію
set_term v1 · purchaser / production Створити або редагувати термін словника
retire_term v1 · purchaser / production Прибрати термін зі словника - Сторінки
- /dovidnyk /dovidnyk/items/:id /dovidnyk/item/:id /dovidnyk/glossary
- Рахунки модуля
- тільки базові
- Пакети правил
- без правил
- Привʼязка в web
- MOD_DOVIDNYK
Від «треба» до «лежить на полиці»: заявка, замовлення постачальнику за ціною з прайсу, прихід у комірку. Без вільного тексту в роботі.
Дії, сторінки, рахунки
- Дії
- new_request v1 · storekeeper / sales / purchaser / production Нова заявка
bind_line v1 · purchaser Привʼязати рядок до позиції
to_work v1 · purchaser Взяти заявку в роботу
order_from_request v1 · purchaser Замовити в постачальника
place_order v1 · purchaser Розмістити замовлення
cancel_order v1 · purchaser Скасувати замовлення
receive v3 · storekeeper Прийняти за замовленням
return_to_supplier v2 · purchaser Повернути постачальнику
tax_invoice v2 · accountant Записати ПН постачальника
buy_cash v2 · accountant Купити за готівку
new_internal v1 · storekeeper / sales / purchaser / production Новий внутрішній запит
bind_internal_line v1 · storekeeper / purchaser / production Привʼязати рядок запиту до позиції
accept_internal v1 · storekeeper / purchaser Прийняти внутрішній запит
decline_internal v1 · storekeeper / purchaser Відхилити внутрішній запит
purchase_from_internal v1 · purchaser Створити заявку на закупівлю за запитом
link_movement v1 · storekeeper Записати рух запасу, яким виконано запит
close_internal v1 · storekeeper / purchaser Позначити запит виконаним - Сторінки
- /zakupka /zakupka/internal /zakupka/internal/:id /zakupka/request/:id /zakupka/order/:id
- Рахунки модуля
- 201 Сировина й матеріали
281 Товари на складі
631 Розрахунки з вітчизняними постачальниками
371 Розрахунки за виданими авансами
644 Податковий кредит (не підтверджений)
719 Інші доходи від операційної діяльності
949 Інші витрати операційної діяльності
301 Готівка в національній валюті - Пакети правил
- stock-average
- Привʼязка в web
- MOD_ZAKUPKA
Склад: склади й комірки зі сталими кодами, прихід, видача, переміщення й інвентаризація за середньою собівартістю. Кількість і вартість живуть у книзі, тож залишок завжди дорівнює сумі рухів.
Дії, сторінки, рахунки
- Дії
- receive v3 · accountant Прийняти на склад
issue v2 · storekeeper Видати у виробництво
write_off v2 · accountant Списати (брак, псування)
transfer v3 · storekeeper Перемістити між місцями
create_site v1 · storekeeper Нове виробництво (резерв і робоче місце)
count v1 · storekeeper Інвентаризація місця
create_warehouse v1 · storekeeper Створити склад
create_bins v1 · storekeeper Створити комірки стелажа
rebuild_balance v1 · accountant Перерахувати збережені залишки - Сторінки
- /komora /komora/locations /komora/sites
- Рахунки модуля
- 201 Сировина й матеріали
22 Малоцінні та швидкозношувані предмети
26 Готова продукція
281 Товари на складі
23 Виробництво
94 Інші витрати операційної діяльності
947 Нестачі і втрати від псування цінностей
719 Інші доходи від операційної діяльності
631 Розрахунки з вітчизняними постачальниками
644 Податковий кредит (не підтверджений) - Пакети правил
- stock-average
- Привʼязка в web
- MOD_KOMORA
Специфікації з версіями, заміни лише в рядку специфікації, виробництво за собівартістю компонентів.
Дії, сторінки, рахунки
- Дії
- new_bom v2 · production Нова версія специфікації
add_line v2 · production Додати рядок
add_substitute v1 · production Дозволити заміну в рядку
activate v1 · production Затвердити версію
produce v4 · production Виробити
add_work_center v1 · production Створити робоче місце
add_operation v2 · production Додати операцію
new_order v1 · production Нове виробниче замовлення
release_order v2 · production Запустити у виробництво
reserve_order v1 · production Зарезервувати компоненти
hand_over v1 · production Передати резерв
take_back v1 · production Повернути резерв
produce_order v2 · production Випуск за замовленням
cancel_order v1 · production Скасувати замовлення
set_release_rule v1 · production Правило запуску замовлень
set_plan v1 · production План виробництва на місяць
new_change v2 · production Нова зміна (ECN)
attach_change v2 · production Додати версію до зміни
approve_change v1 · production Затвердити зміну
reject_change v1 · production Відхилити зміну
compare v2 · viewer / storekeeper / purchaser / production Порівняти версії специфікації
where_used v1 · viewer / storekeeper / purchaser / production Де використовується позиція
plan v1 · viewer / storekeeper / purchaser / production Потреба: що виготовити й що купити
trace v1 · viewer / storekeeper / sales / production Простежити серійний номер
set_subsystem v1 · production Створити або редагувати підсистему
set_line_subsystem v1 · production Віднести рядок до підсистеми
describe_operation v1 · production Описати операцію
start_operation v1 · shop_worker Почати операцію
finish_operation v1 · shop_worker Завершити операцію
pause_operation v1 · shop_worker Призупинити операцію
resume_operation v1 · shop_worker Відновити операцію
enter_operation_time v1 · shop_worker Внести час операції
start_rework v1 · production Почати доопрацювання
void_operation v1 · production Скасувати запис про операцію
assign_workplace v1 · production Призначити на робоче місце
end_assignment v1 · production Завершити призначення - Сторінки
- /zbirka /zbirka/bom/:id /zbirka/orders/:orderId /zbirka/handover/:orderId/:itemId/:toKind/:toId/:ask /zbirka/plan /zbirka/changes /zbirka/changes/:changeId /zbirka/products /zbirka/product/:id /zbirka/product/:id/describe /zbirka/floor /zbirka/people /zbirka/people/:partyId /zbirka/floor/:workCenterId
- Рахунки модуля
- 201 Сировина й матеріали
26 Готова продукція
23 Виробництво
91 Загальновиробничі витрати - Пакети правил
- stock-average
- Привʼязка в web
- MOD_ZBIRKA
Контроль якості перед відвантаженням (ВТК): перелік перевірок на виріб, протокол на кожен серійний номер. Без пройденого протоколу виріб не відвантажується.
Дії, сторінки, рахунки
- Дії
- new_checklist v1 · production Новий перелік перевірок
add_point v2 · production Додати пункт перевірки
set_point_route v1 · production Вказати операцію і прилад пункту
activate_checklist v1 · production Зробити перелік чинним
record_protocol v1 · production Записати протокол перевірки
mark_returned v1 · production Назвати виріб, що повернувся без номера
retire_checklist v1 · production Зняти виріб з контролю - Сторінки
- /yakist /yakist/units/:serial /yakist/checklists /yakist/checklists/:checklistId
- Рахунки модуля
- тільки базові
- Пакети правил
- без правил
- Привʼязка в web
- MOD_YAKIST
Реєстр обладнання й інструменту цеху: що де стоїть, хто що тримає, коли повірка, що ремонтували. Картка робочого місця: що тут роблять і правила безпеки.
Дії, сторінки, рахунки
- Дії
- register v1 · production Створити обладнання чи інструмент
edit v1 · production Редагувати картку
set_state v1 · production Зберегти стан
hand_out v1 · production / storekeeper Видати
take_back v1 · production / storekeeper Повернути
transfer v1 · production / storekeeper Передати іншому
void_custody v1 · production Скасувати помилковий запис про видачу
record_verification v1 · production Записати повірку чи калібрування
void_verification v1 · production Скасувати запис про повірку
record_maintenance v1 · production Записати обслуговування чи ремонт
describe_workplace v2 · production Описати робоче місце - Сторінки
- /instrument /instrument/kind/:kind /instrument/state/:state /instrument/item/:equipmentId /instrument/places /instrument/place/:workCenterId /instrument/people /instrument/person/:partyId /instrument/verification
- Рахунки модуля
- тільки базові
- Пакети правил
- без правил
- Привʼязка в web
- MOD_INSTRUMENT
Основні засоби з амортизацією, перевірка перед закриттям місяця, закриття місяця й року.
Дії, сторінки, рахунки
- Дії
- put_in_use v1 · accountant Ввести в експлуатацію
depreciate v1 · accountant Нарахувати амортизацію за місяць
dispose v1 · accountant Списати основний засіб
close_overhead v1 · accountant Закрити рахунок 91
close_month v2 · chief_accountant Закрити місяць
close_year v1 · chief_accountant Закрити рік - Сторінки
- /aktyvy
- Рахунки модуля
- 104 Машини та обладнання
105 Транспортні засоби
106 Інструменти, прилади, інвентар
109 Інші основні засоби
131 Знос основних засобів
152 Придбання (виготовлення) основних засобів
631 Розрахунки з вітчизняними постачальниками
976 Списання необоротних активів
44 Нерозподілений прибуток (непокриті збитки)
79 Фінансові результати
91 Загальновиробничі витрати
902 Собівартість реалізованих товарів - Пакети правил
- straight-line
- Привʼязка в web
- MOD_AKTYVY
Історія всього: звідки прийшла кожна позиція, виріб, документ і людина, де були й куди пішли. Нічого нового не зберігає: читає книгу й журнал змін.
Дії, сторінки, рахунки
- Дії
- немає
- Сторінки
- /slid /slid/month/:month /slid/period/:from/:to /slid/kind/:kind /slid/by/:person /slid/by/:person/:month /slid/changes /slid/items /slid/items/:id /slid/units /slid/units/:serial /slid/documents /slid/documents/:id /slid/people /slid/people/:id /slid/parties /slid/parties/:id /slid/parties/:id/:month
- Рахунки модуля
- тільки базові
- Пакети правил
- stock-trace
- Привʼязка в web
- MOD_SLID
Вхідні залишки з іншої системи: ОСВ, склад по місцях, розрахунки з контрагентами. Спершу репетиція зі звіркою, потім одна проводка.
Дії, сторінки, рахунки
- Дії
- rehearse v1 · accountant Репетиція
post v1 · chief_accountant / closer Провести вхідні залишки - Сторінки
- /perenesennya
- Рахунки модуля
- тільки базові
- Пакети правил
- без правил
- Привʼязка в web
- MOD_PERENESENNYA
шар 1
Ядро
Книга, правила і єдине сховище. Про продажі, склад чи зарплату ядро нічого не знає.
- gate
Єдине сховище: база D1, міграції, іменовані запити. Записати щось можна тільки через нього.
- kernel
Книга: подія, проводка, документ. Гроші в копійках, записи не змінюються, виправляє сторно.
- rules
Рушій правил і механіка, однакова в будь-якій країні: середня собівартість, виробництво, планування.
- module-sdk
Контракт модуля: маніфест, сторінки як дані, дії з версіями.