--- title: "Requiply 1.2.6: Суборенда, покращення інвойсів та npm package | Requiply" description: "Requiply 1.2.6 дозволяє орендувати обладнання в постачальників і здавати його своїм клієнтам: ведіть постачальників і суборендні товари, відстежуйте кожну закупівлю від «Заплановано» до «Повернуто» та бачте витрати на постачальника, дохід і прибуток. А ще — групи рахунку для одного чітко структурованого рахунку та офіційний npm-пакет @requiply/api-sdk для створення прокатних сайтів у Lovable, Cursor чи будь-якому стеку." canonical_url: "https://requiply.com/uk/blog/1-2-6-release-notes" last_updated: 2026-07-14 locale: uk meta: "og:description": "Requiply 1.2.6 дозволяє орендувати обладнання в постачальників і здавати його своїм клієнтам: ведіть постачальників і суборендні товари, відстежуйте кожну закупівлю від «Заплановано» до «Повернуто» та бачте витрати на постачальника, дохід і прибуток. А ще — групи рахунку для одного чітко структурованого рахунку та офіційний npm-пакет @requiply/api-sdk для створення прокатних сайтів у Lovable, Cursor чи будь-якому стеку." "og:title": "Requiply 1.2.6: Суборенда, покращення інвойсів та npm package" "twitter:description": "Requiply 1.2.6 дозволяє орендувати обладнання в постачальників і здавати його своїм клієнтам: ведіть постачальників і суборендні товари, відстежуйте кожну закупівлю від «Заплановано» до «Повернуто» та бачте витрати на постачальника, дохід і прибуток. А ще — групи рахунку для одного чітко структурованого рахунку та офіційний npm-пакет @requiply/api-sdk для створення прокатних сайтів у Lovable, Cursor чи будь-якому стеку." "twitter:title": "Requiply 1.2.6: Суборенда, покращення інвойсів та npm package" --- ![Requiply 1.2.6: Суборенда, покращення інвойсів та npm package](https://requiply.com/.netlify/images?w=10&h=10&fm=webp&q=50&blur=3&url=%2Fblog%2Freleases%2F1-2-6%2Fcover.png) ## Що нового у Requiply 1.2.6? Цей реліз — про **замовлення, більші за ваш власний склад**. Requiply тепер може вести **інвентар від постачальників поруч із власним**: додавайте постачальників, створюйте суборендні товари з націнкою на ціну постачальника, проводьте кожну закупівлю через її життєвий цикл і бачте, скільки ви витрачаєте, скільки виставляєте клієнту та скільки лишається вам. А коли бронювання виростає у справжній проєкт, **групи рахунку** дозволяють поділити його на іменовані секції — етапи, локації, сцени — щоб клієнт отримав один охайний, чітко структурований рахунок замість стіни рядків чи купи окремих бронювань. Разом із релізом виходить ще один анонс: **офіційний npm-пакет `@requiply/api-sdk`** — типізований клієнт публічного API, створений для агентних інструментів на кшталт Lovable і Cursor. Про нього — нижче. --- ## 1. Суборенда — орендуйте в постачальників, продавайте зі своєю націнкою ![Форма інвентарю Requiply для суборендного товару з джерелом запасу «Суборенда», постачальником, ставкою постачальника, одиницею тарифікації та власною націнкою](https://requiply.com/.netlify/images?url=%2Fblog%2Freleases%2F1-2-6%2Fsubrental-inventory-uk.png) Кожна прокатна компанія рано чи пізно отримує замовлення, яке не може повністю покрити власним інвентарем. Досі це означало вести оренду в постачальників у таблицях — поза доступністю, рахунками та звітами. У 1.2.6 суборенда стає частиною вашого каталогу. Групи інвентарю тепер мають **джерело запасу**: **Власний** або **Суборенда**. Суборендний товар зберігає свого постачальника, ставку постачальника, погодинну/добову/місячну одиницю тарифікації та необов'язкову власну націнку — і водночас підтримує все, що ви вже використовуєте: категорії, зображення, SKU, цінові рівні та видимість у каталозі. ### Що змінилося Нове джерело запасу «Суборенда» для груп інвентарю, поруч із власними товарами Постачальники з назвою та окремими логотипами для світлої й темної теми — створюйте їх у налаштуваннях або просто з форми суборенди Загальна націнка організації з живим попереднім переглядом ціни, плюс власна націнка для окремих товарів Суборендні товари мають еластичну доступність — вони не споживають облікованих фізичних одиниць, бо запас під кожне бронювання надає постачальник Клієнти завжди бачать лише ціну з націнкою; ставки постачальників і націнки лишаються внутрішніми ### Де налаштувати Суборенда вмикається **окремо для кожної організації**. Адміністратор активує її на новій сторінці **Налаштування → Організація → Функції**; загальна націнка та постачальники живуть у **Налаштування → Бронювання → Суборенда**. Після ввімкнення суборендні товари поводяться як будь-які інші товари каталогу — зокрема й на вашому сайті, де клієнти бронюють їх, навіть не здогадуючись, що запас походить від постачальника. **Практичні сценарії:** - **Пікові перевантаження**: ваші десять обігрівачів розписані на весь грудень — додайте суборендний обігрівач із запасу партнера й продовжуйте продавати, не купуючи одинадцятий - **Ширина каталогу без капіталу**: пропонуйте генератор, сцену чи спеціальний об'єктив, яких не маєте; актив тримає постачальник, а націнку — ви - **Послідовне ціноутворення**: задайте одну загальну націнку — і кожна суборенда автоматично розрахує ціну від ставки постачальника --- ## 2. Суборенда в бронюваннях — закупівлі, які реально видно ![Деталі бронювання Requiply з таблицею суборенд: логотипи постачальників, статуси закупівлі, дати, дохід від клієнта, витрати на постачальника та прибуток](https://requiply.com/.netlify/images?url=%2Fblog%2Freleases%2F1-2-6%2Freservation-subrentals-uk.png) Суборенда — це не просто рядок у рахунку, а зобов'язання перед постачальником, яке треба замовити, підтвердити, отримати й повернути. Тепер бронювання зберігає всю цю історію. Додайте **суборенду з каталогу** (постачальник, ставка, одиниця тарифікації й націнка підставляються автоматично) або **разову суборенду** з довільною назвою для обладнання, яке ви більше ніколи не орендуватимете. В обох випадках ви задаєте кількість, ставку постачальника, одиницю тарифікації, націнку й період закупівлі та бачите попередній перегляд клієнтської ціни ще до збереження. ### Що змінилося Статус закупівлі з контрольованим рухом уперед: Заплановано → Замовлено → Підтверджено → Отримано → Повернуто, зі скасуванням до статусу «Підтверджено» включно Кожен рядок показує дохід від клієнта, витрати на постачальника та прибуток — математика націнки порахована за вас, з мінімумом в одну тарифіковану одиницю Ставка постачальника й націнка фіксуються в бронюванні, тож пізніші зміни каталогу чи налаштувань ніколи не переписують історичну економіку Скасовані суборенди автоматично випадають із підсумків, аналітики та рахунків Бронювання суборендних товарів із сайту саме створює рядок закупівлі — готовий до замовлення в постачальника Математика навмисно проста: **клієнтська ставка = ставка постачальника × (1 + націнка %)**, витрати й дохід множаться на кількість і тарифіковані одиниці, а **прибуток — це різниця** — видима і по рядку, і по бронюванню. **Практичні сценарії:** - **Замовляйте вчасно**: з наближенням події перегляньте суборенди у статусі *Заплановано* й переводьте їх у *Замовлено* після кожного дзвінка постачальнику - **Ловіть витік маржі**: колонка прибутку одразу показує, коли підвищена ставка постачальника тихо з'їла вашу націнку - **Разове обладнання**: клієнт хоче конфеті-гармату, якої ви ніколи не матимете — додайте її разово, накиньте націнку й тримайте в тому самому бронюванні та рахунку --- ## 3. Групи рахунку — одне бронювання, один чітко структурований рахунок Великі бронювання заслуговують на більше, ніж алфавітну стіну рядків. **Групи рахунку** дозволяють поділити бронювання на іменовані, впорядковані секції — *Головна сцена*, *День 2*, *Склад Б* — і призначити до них товари, послуги та суборенди. ### Що змінилося Створюйте, перейменовуйте, переставляйте й видаляйте групи просто в бронюванні — без окремих налаштувань Призначайте до групи власні товари (усі одиниці переходять разом), послуги та суборенди — або лишайте позиції без групи PDF рахунку спершу показує позиції без групи, далі — кожну групу у вашому порядку; порожні групи опускаються Видалення групи ніколи не видаляє платних позицій — вони просто лишаються без групи Суборенди виглядають у своїй групі як звичайні орендні рядки для клієнта, без жодних витрат постачальника чи націнки Ось як це бачить клієнт — позиції без групи вгорі, далі кожна іменована секція зі своїми таблицями товарів і послуг: Групи рахунку впорядковують **одне бронювання в один рахунок** — це не окремі рахунки, не графіки оплат і не замовлення постачальникам. Бронювання лишається цілим; просто клієнт нарешті його розуміє. **Практичні сценарії:** - **Події з кількома сценами**: групуйте за сценою чи зоною, щоб продакшн-менеджер клієнта звіряв кожну ділянку зі своєю секцією - **Багатоденні фестивалі**: одна група на день — і одразу видно, що було на майданчику й коли - **Етапи будівництва**: фундамент, коробка, оздоблення — кожен етап з видимою ціною в межах одного рахунку за договором --- ## 4. Аналітика — прибуток, витрати на постачальників і розумніші порівняння ![Сторінка аналітики Requiply з картками доходу, витрат і прибутку, вибором періоду та таблицею прибутковості з суборендами](https://requiply.com/.netlify/images?url=%2Fblog%2Freleases%2F1-2-6%2Fanalytics-uk.png) Тепер, коли витрати на постачальників живуть усередині Requiply, аналітика нарешті відповідає на головне питання: **не скільки ви виставили, а скільки заробили**. ### Що змінилося Витрати на постачальників додаються до витрат активностей і виплат працівникам; прибуток періоду — це дохід мінус усі три Суборенди беруть участь у топ-виконавцях, доході за категоріями та об'єднаній таблиці прибутковості товарів, послуг і суборенд — з доходом, витратами й прибутком у кожному рядку Порівняння періодів тепер включають прибуток і кількість повторних клієнтів відносно попереднього еквівалентного періоду Новий вибір періоду: поточний місяць, попередній місяць, поточний рік, попередній рік або довільний діапазон **Практичні сценарії:** - **Чи вигідна суборенда?**: порівняйте колонку прибутку суборендних рядків із власним інвентарем, перш ніж вирішувати, що купувати далі - **Чесність місяць до місяця**: дохід зріс, а прибуток ні? Розбивка витрат покаже, чи винні витрати на постачальників --- ## 5. Анонс @requiply/api-sdk — офіційний npm-пакет Ми обіцяли його в минулому релізі — і ось він: [`@requiply/api-sdk`](https://www.npmjs.com/package/@requiply/api-sdk) уже на npm — **офіційний, незалежний від фреймворків TypeScript SDK** для публічного API Requiply. Він існує з однієї причини: зробити розробку на базі Requiply максимально простою — особливо з **агентними інструментами**. Опишіть бажаний прокатний сайт у **Lovable**, **v0**, **Cursor** чи Claude Code, дайте йому SDK — і типізований клієнт сам розповість ШІ, що можливо: інвентар, доступність, розрахунок цін, заявки на бронювання, клієнти та звіти. Складні частини — розрахунок доступності, ціни, застави, планування — лишаються відповідальністю Requiply; фронтенд стає вашим (або вашого агента). ### Що всередині Повністю типізовані ресурси для всього публічного API: організація, категорії, послуги, інвентар, доступність, розрахунок цін, бронювання, клієнти та звіти Публічні ключі покривають вітринні сценарії — каталог, доступність, розрахунки цін і заявки на бронювання; секретні ключі відкривають серверне адміністрування, клієнтів і звітність Безпечний за замовчуванням: клієнт відхиляє секретні ключі в браузерному середовищі, якщо це явно не дозволено Працює в Next.js, Nuxt, Node.js, serverless-функціях і сучасних браузерах; кожен метод підтримує abort-сигнали, власні заголовки та ключі ідемпотентності ### Пакет коротко На npm [`@requiply/api-sdk`](https://www.npmjs.com/package/@requiply/api-sdk) описує себе просто: *TypeScript SDK для створення прокатних сайтів і застосунків на базі Requiply*. Він має ліцензію MIT, працює лише як ESM на Node 18+, постачається з власними типами й **не має жодної runtime-залежності** — увесь клієнт розпаковується в менш ніж 60 кБ. Вихідний код живе на [GitHub](https://github.com/Requiply/RequiplyNPM) — там же чекаємо на issues і пропозиції. Чи ви власник прокатного бізнесу, який на вихідних промптить Lovable, чи агенція, що будує вітрини для клієнтів, — один і той самий пакет покриває власні сайти, форми бронювання, клієнтські портали, внутрішні дашборди та інтеграції. Почніть з [документації для розробників](https://requiply.gitbook.io/requiply-docs/knowledge/developer-documentation/developer-docs) і API-ключа з вашого акаунта Requiply. --- ## 6. Перші кроки з SDK — налаштування та приклади коду Шлях від нуля до робочої вітрини короткий: 1. Створіть акаунт Requiply на [app.requiply.com/register](https://app.requiply.com/register) 2. Додайте в Requiply свій інвентар, категорії, ціни та доступність 3. Створіть API-ключ у своєму акаунті 4. Встановіть SDK і починайте будувати сторінки каталогу, пошук доступності, розрахунок цін і заявки на бронювання ``` npm install @requiply/api-sdk ``` ### Вітрина — публічний ключ Публічні ключі (`rq_pk_...`) безпечні для браузера й покривають публічні сценарії: каталог, доступність, розрахунок цін і заявки на бронювання. ``` import { RequiplyClient } from '@requiply/api-sdk'; const requiply = new RequiplyClient({ baseUrl: 'https://app.requiply.com', apiKey: 'rq_pk_live_...', }); // Яке обладнання вільне на дати клієнта? const inventory = await requiply.inventory.list({ startDate: '2026-07-01', endDate: '2026-07-03', }); // Порахуйте ціну вибраного ще до створення заявки const quote = await requiply.pricing.quote({ startDate: '2026-07-01', endDate: '2026-07-03', items: [{ groupId: inventory.items[0].id, quantity: 1 }], }); ``` ### Сервер — секретний ключ Секретні ключі (`rq_sk_...`) призначені лише для серверного коду й відкривають адміністративну частину: керування бронюваннями, клієнтів, звіти, стан інвентарю та зведення по організації. ``` import { RequiplyClient } from '@requiply/api-sdk'; const requiply = new RequiplyClient({ baseUrl: process.env.REQUIPLY_BASE_URL ?? 'https://app.requiply.com', apiKey: process.env.REQUIPLY_SECRET_KEY!, }); const { bookings } = await requiply.bookings.list({ dateFrom: '2026-07-01', dateTo: '2026-07-31', }); ``` Кожен метод приймає опції запиту останнім аргументом — abort `signal`, власні `headers` та `idempotencyKey` для безпечних повторів. --- ## Часті запитання ### Чи бачать клієнти ціну постачальника або мою націнку? Ні. Клієнти завжди бачать лише ціну з націнкою — у магазині, в пропозиціях і в PDF рахунку, де суборенди виглядають як звичайні орендні рядки. Ставки постачальників, націнки, витрати та прибуток — внутрішні дані, які лишаються в деталях бронювання й аналітиці. ### Як розраховується клієнтська ціна суборенди? Клієнтська ставка = ставка постачальника × (1 + націнка %). Націнка береться з власного значення товару, а якщо його немає — із загальної націнки організації. І ставка постачальника, і застосована націнка фіксуються в бронюванні, тож пізніші зміни каталогу чи налаштувань не переписують минулих бронювань. ### Що станеться, якщо пізніше вимкнути функцію суборенди? Наявні бронювання зберігають свою історію суборенд — рядки лишаються видимими зі статусами й фінансами, і їх можна видалити. Створення й редагування суборенд, постачальників і суборендних товарів блокується, поки функція вимкнена, а суборендний запас зникає з вашого сайту та публічного API. ### Групи рахунку — це окремі рахунки? Ні — це іменовані секції в межах одного рахунку за одне бронювання. Спершу друкуються позиції без групи, далі — кожна група у вибраному вами порядку, кожна зі своїми таблицями товарів і послуг. Якщо вам потрібні окремі документи чи графіки оплат — це інший сценарій. ### Чи треба бути розробником, щоб користуватися @requiply/api-sdk? Не обов'язково — у цьому й суть. SDK типізований, тож агентні інструменти на кшталт Lovable, v0, Cursor чи Claude Code можуть зібрати робочий прокатний сайт зі звичайного текстового опису. Потрібні лише акаунт Requiply та API-ключ; розробники й агенції отримують той самий пакет для власноруч написаних вітрин, порталів та інтеграцій. --- ## Що далі? Версія 1.2.6 розширює межі того, що може вмістити бронювання: інвентар постачальників із контрольованою націнкою всередині — і чітко структурований рахунок назовні. А з `@requiply/api-sdk` на npm фронтенд, який усе це продає, тепер може зібрати будь-хто й у будь-якому стеку. Ось що ми будуємо далі: **Кастомні експорти** — експорти на основі HTML для будь-якої сутності в Requiply. Створюйте власні шаблони й перетворюйте бронювання, інвентар, клієнтів чи звіти на документи, які виглядають саме так, як потрібно вашому бізнесу, — без обмежень вбудованими макетами. --- **Є питання чи пропозиції?** Пишіть нам на `info@requiply.com` — особливо хочемо почути, як ви сьогодні працюєте з інвентарем постачальників і що ви першим збудуєте з SDK. **Теги** - Requiply version - requiply - суборенда - subrentals - постачальники - групи рахунку - invoice groups - закупівлі - націнка - прибуток - аналітика - інвентар - api sdk - npm - typescript - програмне забезпечення для оренди - rental software ## Sitemap See the full [sitemap](/sitemap.md) for all pages.