Requiply 1.2.6: podnajem sprzętu, lepsze faktury i pakiet npm

Co nowego w Requiply 1.2.6?

Ta wersja jest o zleceniach większych niż Twój własny magazyn. Requiply obsługuje teraz sprzęt od dostawców obok Twojego własnego: prowadzisz listę dostawców, tworzysz pozycje z podnajmu z marżą doliczaną do ceny dostawcy, śledzisz każde zamówienie przez cały jego cykl i dokładnie widzisz, ile wydajesz, ile pobierasz od klienta i ile zostaje dla Ciebie.

A gdy rezerwacja rozrasta się w prawdziwy projekt, grupy na fakturze pozwalają podzielić ją na nazwane sekcje (etapy, miejsca, fazy), żeby klient dostał jedną przejrzystą, uporządkowaną fakturę zamiast ściany pozycji albo stosu osobnych rezerwacji.

Razem z tą wersją ogłaszamy jeszcze jedno: oficjalny pakiet npm @requiply/api-sdk, typowany klient publicznego API stworzony z myślą o narzędziach agentowych AI, takich jak Lovable i Cursor. Więcej o nim niżej.

1. Podnajem: wynajmuj od dostawców, sprzedawaj z własną marżą

Każda wypożyczalnia prędzej czy później dostaje rezerwację, której nie da się w pełni obsłużyć własnym sprzętem. Do tej pory oznaczało to prowadzenie wynajmu od dostawców w arkuszach, poza dostępnością, fakturami i raportami. W wersji 1.2.6 podnajem staje się częścią Twojego katalogu.

Grupy pozycji mają teraz źródło sprzętu: Owned (własny) lub Subrental (podnajem). Pozycja z podnajmu przechowuje dostawcę, stawkę dostawcy, jednostkę rozliczeniową (godzina, doba lub miesiąc) i opcjonalną własną marżę, a przy tym zachowuje wszystko, z czego już korzystasz: kategorie, zdjęcia, kody SKU, progi cenowe i widoczność w katalogu.

Co się zmieniło w ewidencji sprzętu

Gdzie włączyć podnajem

Podnajem włącza się osobno w każdej organizacji. Administrator robi to na nowej stronie Settings → Organization → Features (Ustawienia → Organizacja → Funkcje), a domyślna marża i lista dostawców są w Settings → Reservations → Subrentals (Ustawienia → Rezerwacje → Podnajem). Po włączeniu pozycje z podnajmu działają jak każda inna pozycja w katalogu, także na Twojej stronie internetowej, gdzie klienci mogą je rezerwować i nigdy się nie dowiedzą, że sprzęt pochodzi od dostawcy.

Praktyczne zastosowania:

• Szczyt sezonu: Twoich dziesięć nagrzewnic jest zarezerwowanych na cały grudzień. Dodaj nagrzewnicę z podnajmu od partnera i sprzedawaj dalej bez kupowania jedenastej
• Szerszy katalog bez inwestycji: oferuj agregat prądotwórczy, scenę czy specjalistyczny obiektyw, których nie masz. Dostawca utrzymuje sprzęt, a Ty zarabiasz na marży
• Spójne ceny: ustaw jedną marżę dla całej organizacji, a każda pozycja z podnajmu sama wyliczy cenę ze stawki dostawcy

2. Podnajem w rezerwacjach: zamówienia u dostawców pod kontrolą

Podnajem to nie tylko kolejna pozycja na liście. To zobowiązanie wobec dostawcy: sprzęt trzeba zamówić, potwierdzić, odebrać i oddać. Rezerwacje pokazują teraz całą tę historię.

Dodaj podnajem z katalogu (dostawca, stawka, jednostka rozliczeniowa i marża uzupełnią się same) albo jednorazowy podnajem z dowolną nazwą dla sprzętu, którego potrzebujesz tylko raz. W obu przypadkach ustawiasz ilość, stawkę dostawcy, jednostkę rozliczeniową, marżę i okres podnajmu, a przed zapisaniem widzisz podgląd stawki dla klienta.

Co się zmieniło w rezerwacjach

Rachunek jest celowo prosty: stawka dla klienta = stawka dostawcy × (1 + marża %), koszt dostawcy i przychód mnoży się przez ilość i liczbę jednostek rozliczeniowych, a zysk to różnica widoczna dla każdej pozycji i całej rezerwacji.

Praktyczne zastosowania:

• Zamawiaj we właściwym momencie: w miarę zbliżania się eventu filtruj podnajem w statusie Planned i przestawiaj go na Ordered, gdy dzwonisz do kolejnych dostawców
• Pilnuj marży: kolumna zysku od razu pokazuje, kiedy podwyżka stawki u dostawcy po cichu zjadła Twoją marżę
• Sprzęt na jeden raz: klient chce armatkę konfetti, której nigdy nie kupisz. Dodaj ją jako jednorazowy podnajem, dolicz marżę i trzymaj w tej samej rezerwacji i na tej samej fakturze

3. Grupy na fakturze: jedna rezerwacja, jedna przejrzysta faktura

Duże rezerwacje zasługują na coś lepszego niż alfabetyczna ściana pozycji. Grupy na fakturze pozwalają podzielić rezerwację na nazwane sekcje w wybranej kolejności (Scena główna, Dzień 2, Magazyn B) i przypisać do nich sprzęt, usługi i podnajem.

Co się zmieniło na fakturach

Tak widzi to klient: pozycje bez grupy na górze, a pod nimi każda nazwana sekcja z własną tabelą sprzętu i usług:

Grupy na fakturze porządkują jedną rezerwację na jednej fakturze. Nie są osobnymi fakturami, harmonogramami płatności ani zamówieniami u dostawców. Rezerwacja pozostaje całością, a klient wreszcie ją rozumie.

Praktyczne zastosowania:

• Eventy z kilkoma scenami: grupuj według sceny lub strefy, żeby kierownik produkcji po stronie klienta mógł porównać każdy obszar z jego sekcją na fakturze
• Kilkudniowe festiwale: jedna grupa na każdy dzień jasno pokazuje, co i kiedy było na miejscu
• Etapy budowy: fundamenty, stan surowy, wykończenie. Każdy etap z widoczną ceną na jednej fakturze do umowy

4. Analityka: zysk, wydatki na dostawców i lepsze porównania

Skoro koszty dostawców są już w Requiply, analityka może wreszcie odpowiedzieć na najważniejsze pytanie: nie tylko ile zafakturowano, ale ile zostało w kieszeni.

Co się zmieniło w analityce

Praktyczne zastosowania:

• Czy podnajem się opłaca? Porównaj kolumnę zysku w wierszach podnajmu z własnym sprzętem, zanim zdecydujesz, co kupić w następnej kolejności
• Uczciwe porównanie miesiąc do miesiąca: przychód rośnie, a zysk stoi w miejscu? Podział kosztów pokaże, czy przyczyną są wydatki na dostawców

5. Przedstawiamy @requiply/api-sdk, oficjalny pakiet npm

Obiecaliśmy to w poprzedniej wersji i oto jest: @requiply/api-sdk jest już w npm. To oficjalne SDK dla TypeScriptu, niezależne od frameworka, do publicznego API Requiply.

Powstało z jednego powodu: żeby budowanie na Requiply było banalnie proste, zwłaszcza z narzędziami agentowymi AI. Opisz wymarzoną stronę wypożyczalni w Lovable, v0, Cursor albo Claude Code, wskaż SDK, a typowany klient powie AI dokładnie, co jest możliwe: sprzęt, dostępność, wyceny, zapytania o rezerwację, klienci i raporty. Najtrudniejsze elementy (obliczanie dostępności, ceny, kaucje, harmonogramy) pozostają po stronie Requiply, a frontend kształtujesz Ty (albo Twój agent).

Co zawiera SDK

Pakiet w skrócie

W npm @requiply/api-sdk opisuje się po prostu jako SDK dla TypeScriptu do budowania stron i aplikacji wypożyczalni sprzętu z Requiply. Ma licencję MIT, obsługuje wyłącznie ESM, działa na Node 18+, zawiera własne definicje typów i ma zero zależności w czasie działania: cały klient po rozpakowaniu zajmuje mniej niż 60 kB. Kod źródłowy jest na GitHubie, gdzie chętnie przyjmujemy zgłoszenia i sugestie.

Niezależnie od tego, czy prowadzisz wypożyczalnię i w weekend testujesz Lovable, czy budujesz w agencji sklepy dla klientów, ten sam pakiet sprawdzi się przy stronach na zamówienie, formularzach rezerwacji, portalach klienta, wewnętrznych panelach i integracjach. Zacznij od dokumentacji dla programistów i klucza API ze swojego konta Requiply.

6. Pierwsze kroki z SDK: konfiguracja i przykłady kodu

Droga od zera do działającego sklepu jest krótka:

1. Załóż konto Requiply na app.requiply.com/register
2. Dodaj w Requiply swój sprzęt, kategorie, ceny i dostępność
3. Utwórz klucz API na swoim koncie
4. Zainstaluj SDK i zacznij budować strony katalogu, wyszukiwanie dostępności, wyceny i zapytania o rezerwację

npm install @requiply/api-sdk

Sklep w przeglądarce: klucz publiczny

Klucze publiczne (rq_pk_...) można bezpiecznie używać w przeglądarce. Obsługują publiczne ścieżki: katalog, dostępność, wyceny i zapytania o rezerwację.

import { RequiplyClient } from '@requiply/api-sdk';

const requiply = new RequiplyClient({
  baseUrl: 'https://app.requiply.com',
  apiKey: 'rq_pk_live_...',
});

// Który sprzęt jest wolny w terminie klienta?
const inventory = await requiply.inventory.list({
  startDate: '2026-07-01',
  endDate: '2026-07-03',
});

// Wyceń wybrany sprzęt przed utworzeniem zapytania o rezerwację
const quote = await requiply.pricing.quote({
  startDate: '2026-07-01',
  endDate: '2026-07-03',
  items: [{ groupId: inventory.items[0].id, quantity: 1 }],
});

Serwer: klucz tajny

Klucze tajne (rq_sk_...) należą wyłącznie do kodu serwerowego i odblokowują część administracyjną: zarządzanie rezerwacjami, klientów, raporty, status sprzętu i podsumowania organizacji.

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',
});

Każda metoda przyjmuje jako ostatni argument opcje żądania: signal do przerwania, własne headers i idempotencyKey do bezpiecznego ponawiania.

Najczęściej zadawane pytania

Co dalej?

Wersja 1.2.6 przesuwa granicę tego, co mieści rezerwacja: w środku sprzęt od dostawców z kontrolowaną marżą, na zewnątrz przejrzysta faktura. A dzięki pakietowi @requiply/api-sdk frontend, który to wszystko sprzedaje, może teraz zbudować każdy i w dowolnej technologii.

Oto, nad czym teraz pracujemy:

Własne eksporty: eksporty oparte na HTML dla dowolnego obiektu w Requiply. Projektuj własne szablony i zamieniaj rezerwacje, sprzęt, klientów czy raporty w dokumenty, które wyglądają dokładnie tak, jak potrzebuje Twoja firma, bez ograniczania się do wbudowanych układów.

Masz pytania lub sugestie? Napisz do nas na info@requiply.com. Szczególnie chętnie dowiemy się, jak dziś pozyskujesz sprzęt od dostawców i co najpierw zbudujesz z SDK.