Requiply 1.2.6: Суборенда, покращення інвойсів та npm package

Q: Чи бачать клієнти ціну постачальника або мою націнку?

Ні. Клієнти завжди бачать лише ціну з націнкою — у магазині, в пропозиціях і в PDF рахунку, де суборенди виглядають як звичайні орендні рядки. Ставки постачальників, націнки, витрати та прибуток — внутрішні дані, які лишаються в деталях бронювання й аналітиці.

Q: Як розраховується клієнтська ціна суборенди?

Клієнтська ставка = ставка постачальника × (1 + націнка %). Націнка береться з власного значення товару, а якщо його немає — із загальної націнки організації. І ставка постачальника, і застосована націнка фіксуються в бронюванні, тож пізніші зміни каталогу чи налаштувань не переписують минулих бронювань.

Q: Що станеться, якщо пізніше вимкнути функцію суборенди?

Наявні бронювання зберігають свою історію суборенд — рядки лишаються видимими зі статусами й фінансами, і їх можна видалити. Створення й редагування суборенд, постачальників і суборендних товарів блокується, поки функція вимкнена, а суборендний запас зникає з вашого сайту та публічного API.

Q: Групи рахунку — це окремі рахунки?

Ні — це іменовані секції в межах одного рахунку за одне бронювання. Спершу друкуються позиції без групи, далі — кожна група у вибраному вами порядку, кожна зі своїми таблицями товарів і послуг. Якщо вам потрібні окремі документи чи графіки оплат — це інший сценарій.

Q: Чи треба бути розробником, щоб користуватися @requiply/api-sdk?

Не обов'язково — у цьому й суть. SDK типізований, тож агентні інструменти на кшталт Lovable, v0, Cursor чи Claude Code можуть зібрати робочий прокатний сайт зі звичайного текстового опису. Потрібні лише акаунт Requiply та API-ключ; розробники й агенції отримують той самий пакет для власноруч написаних вітрин, порталів та інтеграцій.

Requiply 1.2.6 дозволяє орендувати обладнання в постачальників і здавати його своїм клієнтам: ведіть постачальників і суборендні товари, відстежуйте кожну закупівлю від «Заплановано» до «Повернуто» та бачте витрати на постачальника, дохід і прибуток. А ще — групи рахунку для одного чітко структурованого рахунку та офіційний npm-пакет @requiply/api-sdk для створення прокатних сайтів у Lovable, Cursor чи будь-якому стеку.

Що нового у Requiply 1.2.6?

Цей реліз — про замовлення, більші за ваш власний склад. Requiply тепер може вести інвентар від постачальників поруч із власним: додавайте постачальників, створюйте суборендні товари з націнкою на ціну постачальника, проводьте кожну закупівлю через її життєвий цикл і бачте, скільки ви витрачаєте, скільки виставляєте клієнту та скільки лишається вам.

А коли бронювання виростає у справжній проєкт, групи рахунку дозволяють поділити його на іменовані секції — етапи, локації, сцени — щоб клієнт отримав один охайний, чітко структурований рахунок замість стіни рядків чи купи окремих бронювань.

Разом із релізом виходить ще один анонс: офіційний npm-пакет @requiply/api-sdk — типізований клієнт публічного API, створений для агентних інструментів на кшталт Lovable і Cursor. Про нього — нижче.

1. Суборенда — орендуйте в постачальників, продавайте зі своєю націнкою

Форма інвентарю Requiply для суборендного товару з джерелом запасу «Суборенда», постачальником, ставкою постачальника, одиницею тарифікації та власною націнкою

Кожна прокатна компанія рано чи пізно отримує замовлення, яке не може повністю покрити власним інвентарем. Досі це означало вести оренду в постачальників у таблицях — поза доступністю, рахунками та звітами. У 1.2.6 суборенда стає частиною вашого каталогу.

Групи інвентарю тепер мають джерело запасу: Власний або Суборенда. Суборендний товар зберігає свого постачальника, ставку постачальника, погодинну/добову/місячну одиницю тарифікації та необов'язкову власну націнку — і водночас підтримує все, що ви вже використовуєте: категорії, зображення, SKU, цінові рівні та видимість у каталозі.

Що змінилося

Нове джерело запасу «Суборенда» для груп інвентарю, поруч із власними товарами

Постачальники з назвою та окремими логотипами для світлої й темної теми — створюйте їх у налаштуваннях або просто з форми суборенди

Загальна націнка організації з живим попереднім переглядом ціни, плюс власна націнка для окремих товарів

Суборендні товари мають еластичну доступність — вони не споживають облікованих фізичних одиниць, бо запас під кожне бронювання надає постачальник

Клієнти завжди бачать лише ціну з націнкою; ставки постачальників і націнки лишаються внутрішніми

Де налаштувати

Суборенда вмикається окремо для кожної організації. Адміністратор активує її на новій сторінці Налаштування → Організація → Функції; загальна націнка та постачальники живуть у Налаштування → Бронювання → Суборенда. Після ввімкнення суборендні товари поводяться як будь-які інші товари каталогу — зокрема й на вашому сайті, де клієнти бронюють їх, навіть не здогадуючись, що запас походить від постачальника.

Практичні сценарії:

Пікові перевантаження: ваші десять обігрівачів розписані на весь грудень — додайте суборендний обігрівач із запасу партнера й продовжуйте продавати, не купуючи одинадцятий
Ширина каталогу без капіталу: пропонуйте генератор, сцену чи спеціальний об'єктив, яких не маєте; актив тримає постачальник, а націнку — ви
Послідовне ціноутворення: задайте одну загальну націнку — і кожна суборенда автоматично розрахує ціну від ставки постачальника

2. Суборенда в бронюваннях — закупівлі, які реально видно

Деталі бронювання Requiply з таблицею суборенд: логотипи постачальників, статуси закупівлі, дати, дохід від клієнта, витрати на постачальника та прибуток

Суборенда — це не просто рядок у рахунку, а зобов'язання перед постачальником, яке треба замовити, підтвердити, отримати й повернути. Тепер бронювання зберігає всю цю історію.

Додайте суборенду з каталогу (постачальник, ставка, одиниця тарифікації й націнка підставляються автоматично) або разову суборенду з довільною назвою для обладнання, яке ви більше ніколи не орендуватимете. В обох випадках ви задаєте кількість, ставку постачальника, одиницю тарифікації, націнку й період закупівлі та бачите попередній перегляд клієнтської ціни ще до збереження.

Що змінилося

Статус закупівлі з контрольованим рухом уперед: Заплановано → Замовлено → Підтверджено → Отримано → Повернуто, зі скасуванням до статусу «Підтверджено» включно

Кожен рядок показує дохід від клієнта, витрати на постачальника та прибуток — математика націнки порахована за вас, з мінімумом в одну тарифіковану одиницю

Ставка постачальника й націнка фіксуються в бронюванні, тож пізніші зміни каталогу чи налаштувань ніколи не переписують історичну економіку

Скасовані суборенди автоматично випадають із підсумків, аналітики та рахунків

Бронювання суборендних товарів із сайту саме створює рядок закупівлі — готовий до замовлення в постачальника

Математика навмисно проста: клієнтська ставка = ставка постачальника × (1 + націнка %), витрати й дохід множаться на кількість і тарифіковані одиниці, а прибуток — це різниця — видима і по рядку, і по бронюванню.

Практичні сценарії:

Замовляйте вчасно: з наближенням події перегляньте суборенди у статусі Заплановано й переводьте їх у Замовлено після кожного дзвінка постачальнику
Ловіть витік маржі: колонка прибутку одразу показує, коли підвищена ставка постачальника тихо з'їла вашу націнку
Разове обладнання: клієнт хоче конфеті-гармату, якої ви ніколи не матимете — додайте її разово, накиньте націнку й тримайте в тому самому бронюванні та рахунку

3. Групи рахунку — одне бронювання, один чітко структурований рахунок

Великі бронювання заслуговують на більше, ніж алфавітну стіну рядків. Групи рахунку дозволяють поділити бронювання на іменовані, впорядковані секції — Головна сцена, День 2, Склад Б — і призначити до них товари, послуги та суборенди.

Що змінилося

Створюйте, перейменовуйте, переставляйте й видаляйте групи просто в бронюванні — без окремих налаштувань

Призначайте до групи власні товари (усі одиниці переходять разом), послуги та суборенди — або лишайте позиції без групи

PDF рахунку спершу показує позиції без групи, далі — кожну групу у вашому порядку; порожні групи опускаються

Видалення групи ніколи не видаляє платних позицій — вони просто лишаються без групи

Суборенди виглядають у своїй групі як звичайні орендні рядки для клієнта, без жодних витрат постачальника чи націнки

Ось як це бачить клієнт — позиції без групи вгорі, далі кожна іменована секція зі своїми таблицями товарів і послуг:

Групи рахунку впорядковують одне бронювання в один рахунок — це не окремі рахунки, не графіки оплат і не замовлення постачальникам. Бронювання лишається цілим; просто клієнт нарешті його розуміє.

Практичні сценарії:

Події з кількома сценами: групуйте за сценою чи зоною, щоб продакшн-менеджер клієнта звіряв кожну ділянку зі своєю секцією
Багатоденні фестивалі: одна група на день — і одразу видно, що було на майданчику й коли
Етапи будівництва: фундамент, коробка, оздоблення — кожен етап з видимою ціною в межах одного рахунку за договором

4. Аналітика — прибуток, витрати на постачальників і розумніші порівняння

Сторінка аналітики Requiply з картками доходу, витрат і прибутку, вибором періоду та таблицею прибутковості з суборендами

Тепер, коли витрати на постачальників живуть усередині Requiply, аналітика нарешті відповідає на головне питання: не скільки ви виставили, а скільки заробили.

Що змінилося

Витрати на постачальників додаються до витрат активностей і виплат працівникам; прибуток періоду — це дохід мінус усі три

Суборенди беруть участь у топ-виконавцях, доході за категоріями та об'єднаній таблиці прибутковості товарів, послуг і суборенд — з доходом, витратами й прибутком у кожному рядку

Порівняння періодів тепер включають прибуток і кількість повторних клієнтів відносно попереднього еквівалентного періоду

Новий вибір періоду: поточний місяць, попередній місяць, поточний рік, попередній рік або довільний діапазон

Практичні сценарії:

Чи вигідна суборенда?: порівняйте колонку прибутку суборендних рядків із власним інвентарем, перш ніж вирішувати, що купувати далі
Чесність місяць до місяця: дохід зріс, а прибуток ні? Розбивка витрат покаже, чи винні витрати на постачальників

5. Анонс @requiply/api-sdk — офіційний npm-пакет

Ми обіцяли його в минулому релізі — і ось він: @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 описує себе просто: TypeScript SDK для створення прокатних сайтів і застосунків на базі Requiply. Він має ліцензію MIT, працює лише як ESM на Node 18+, постачається з власними типами й не має жодної runtime-залежності — увесь клієнт розпаковується в менш ніж 60 кБ. Вихідний код живе на GitHub — там же чекаємо на issues і пропозиції.

Чи ви власник прокатного бізнесу, який на вихідних промптить Lovable, чи агенція, що будує вітрини для клієнтів, — один і той самий пакет покриває власні сайти, форми бронювання, клієнтські портали, внутрішні дашборди та інтеграції. Почніть з документації для розробників і API-ключа з вашого акаунта Requiply.

6. Перші кроки з SDK — налаштування та приклади коду

Шлях від нуля до робочої вітрини короткий:

Створіть акаунт Requiply на app.requiply.com/register
Додайте в Requiply свій інвентар, категорії, ціни та доступність
Створіть API-ключ у своєму акаунті
Встановіть 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 для безпечних повторів.

Часті запитання

Чи бачать клієнти ціну постачальника або мою націнку?

Як розраховується клієнтська ціна суборенди?

Що станеться, якщо пізніше вимкнути функцію суборенди?

Групи рахунку — це окремі рахунки?

Чи треба бути розробником, щоб користуватися @requiply/api-sdk?

Що далі?

Версія 1.2.6 розширює межі того, що може вмістити бронювання: інвентар постачальників із контрольованою націнкою всередині — і чітко структурований рахунок назовні. А з @requiply/api-sdk на npm фронтенд, який усе це продає, тепер може зібрати будь-хто й у будь-якому стеку.

Ось що ми будуємо далі:

Кастомні експорти — експорти на основі HTML для будь-якої сутності в Requiply. Створюйте власні шаблони й перетворюйте бронювання, інвентар, клієнтів чи звіти на документи, які виглядають саме так, як потрібно вашому бізнесу, — без обмежень вбудованими макетами.

Є питання чи пропозиції? Пишіть нам на info@requiply.com — особливо хочемо почути, як ви сьогодні працюєте з інвентарем постачальників і що ви першим збудуєте з SDK.