Dev okénkov1.19–v1.21Dev okénko6 min čtení20. listopadu 2026

Dev okénko: Týden vývoje podle požadavků půjčoven (v1.19–v1.21) – napojení webu přes widget, QR štítky, Check-In a Fakturoid v3

Týden jsme ladili funkce podle postřehů půjčoven: jednoduché napojení stávajícího webu přes widget, QR štítky, pultový Check-In, Fakturoid v3 a průvodce.
Martin AndrášiZakladatel Circly.cz
Dev okénko: Týden vývoje podle požadavků půjčoven (v1.19–v1.21) – napojení webu přes widget, QR štítky, Check-In a Fakturoid v3
Rychlé shrnutí v kostce
Poslední týden jsme zapracovali sérii konkrétních postřehů a požadavků od půjčoven a vydali je v balíku verzí v1.19.0 až v1.21.0. Hlavní novinkou je plovoucí rezervační widget pro jednoduché napojení vašeho stávajícího webu (včetně beta párování produktů i přesného napojení přes kód). Přibyly také QR štítky se skenováním mobilem, samoobslužný Check-In na tabletu, Fakturoid API v3 a 4krokový průvodce startem.

Ráno v sedm se u pultu sejdou čtyři řemeslníci najednou. Jeden diktuje IČO, druhý čeká na vydání vibrační desky, třetímu potřebujete doúčtovat den navíc a čtvrtý volá, jestli máte na víkend volný přívěs. Přesně na tyhle situace naráželi naši zákazníci a během posledních týdnů nám k nim poslali spoustu praktických postřehů a požadavků.

Poslední týden jsme nad nimi seděli v kuse a během posledních dvou dnů (19. a 20. listopadu) jsme celý balík nasadili do produkce ve verzích v1.19.0 až v1.21.0. Tady je přehled toho nejdůležitějšího – bez omáčky a s vysvětlením, jak to v praxi šetří čas na pobočce, na webu i v účetnictví.

1. Jednoduché napojení vašeho stávajícího webu přes plovoucí widget

Jedním z nejčastějších požadavků bylo, jak dostat online rezervace z Circly na zavedený web půjčovny (WordPress, Shoptet i vlastní řešení), aniž byste museli celý web předělávat nebo přijít o pozice v Googlu. Přesně to řeší nové plovoucí rezervační okénko (widget.js) s generátorem přímo v administraci – vyberete si barvu, polohu v rohu obrazovky, text tlačítka, přidáte povolenou doménu a vložíte jediný skript.

  • Chytré párování produktů na webu (beta): Widget umí ze stránky vašeho webu automaticky rozpoznat konkrétní stroj, na který se zákazník právě dívá, a rovnou ho nasměrovat na jeho kartu v katalogu Circly. Protože je ale každý web postavený jinak a kvalita kódu napříč platformami se dost liší, je automatické párování zatím v beta verzi a nelze u něj zaručit 100 % úspěšnost na každém webu. Pokud však váš web dodržuje základní sémantiku HTML (hlavně čistý nadpis <h1> a titulek stránky), párování si s tím poradí.
  • Stoprocentní jistota přes kód produktu: Nejlepší cesta bez ohledu na platformu je zadat kód produktu přímo ve skriptu přes atribut data-circly-code (nebo na prvku na stránce). Jakmile máte stejný kód uložený i v katalogu Circly, spárování funguje vždy a přesně.
2. Tisk QR štítků na stroje a skenování mobilem (PWA)

Doteď musela obsluha při výdeji nebo vrácení stroj vyhledávat v seznamu podle názvu nebo inventárního čísla. Nově si přímo z karty vybavení vytisknete QR nebo čárové štítky pro jednotlivé kusy techniky a nalepíte je přímo na rám stroje nebo kufr.

Při výdeji a vrácení pak stačí vzít do ruky běžný telefon nebo napojit USB/Bluetooth HID čtečku, pípnout kód a systém okamžitě otevře správný kus i navázanou výpůjčku.

  • Funguje jako mobilní aplikace (PWA): Přidali jsme kompletní sadu ikon a webový manifest. Circly si jedním klepnutím připnete na plochu telefonu a chová se jako nativní aplikace bez adresního řádku prohlížeče.
  • Dekódování fotek QR 100 % v telefonu: Při testování na mobilech (hlavně na iOS) jsme narazili na zamrzání prohlížeče u fotek ve vysokém rozlišení a na zkreslení z orientace EXIF. Nakonec jsme přepsali dekodér tak, aby obrázek zmenšil na 320px/240px s vysokým kontrastem a dekódoval ho kompletně na straně klienta – bez posílání fotek na server a bez zasekávání.
3. Samoobslužný Check-In na pultovém tabletu i přes mobilní QR

Ruční přepisování adresy, telefonu a údajů z občanky patří k největším brzdám při odbavení nového zákazníka. Nově můžete na pult postavit tablet (nebo zákazníkovi ukázat QR kód pro jeho vlastní telefon) a nechat ho údaje vyplnit samostatně.

  • Firmy přes ARES jedním kliknutím: Zákazník zadá IČO a název, sídlo i DIČ se doplní samy.
  • Čisté rozdělení jména a příjmení: U fyzických osob jsme rozdělili jméno a příjmení do samostatných polí, aby se lépe řadilo v seznamech a seděly údaje na smlouvách i fakturách.
  • Rovnou k digitálnímu podpisu: Po uložení údajů obsluha jen zkontroluje doklad a zákazník na tom samém tabletu rovnou podepíše předávací protokol.
4. Zálohové faktury, dobropisy a Fakturoid API v3

Fakturace v půjčovně není jen jedna konečná faktura. Potřebujete vybrat zálohu předem, občas výpůjčku stornovat, vystavit dobropis nebo po vrácení doúčtovat čištění, poškození či den zpoždění. Celý tenhle stavový automat jsme dotáhli a provázali s Fakturoid API v3 (přes OAuth 2.0).

  • Zálohové faktury (proformy), dobropisy a doplatky: Systém hlídá návaznost dokladů. Když stornujete výpůjčku s nezaplacenou zálohovou fakturou, proforma se automaticky stornuje.
  • Číselné řady a variabilní symboly z Fakturoidu: Circly se nepere s vaším účetním číslováním – číselnou řadu i variabilní symbol přebírá přímo z Fakturoidu a ukládá přímý odkaz na vystavený doklad.
  • Automatické párování plateb přes webhooky: Jakmile zákazník zaplatí a Fakturoid platbu spáruje s bankou, stav úhrady se v Circly sám propíše k výpůjčce.
5. Jasné 3 tarify, 30 dní naplno a 4krokový start bez bloudění

Spolu s velkým balíkem funkcí jsme zpřesnili ceník i první minuty po registraci nové půjčovny:

  • Tři přehledné tarify: Starter (590 Kč/měsíc), Pro (1 190 Kč/měsíc) a Enterprise (2 490 Kč/měsíc). Během 30denního zkušebního provozu (Trial) máte odemčené všechny funkce včetně Enterprise, abyste si mohli v klidu vyzkoušet vše od plovoucího widgetu a QR štítků až po API a MCP server.
  • 4krokový průvodce nastavením (v1.21.0): Nová půjčovna po registraci projde čtyřmi jasnými kroky – firemní údaje přes ARES, bankovní spojení a fakturace, provozní doba a vzhled veřejné výlohy.
  • Interaktivní Product Tour a „Co je nového“: Přímo na živých obrazovkách vás průvodce provede hlavními sekcemi administrace (kdykoliv si ho znovu pustíte z uživatelského menu vlevo dole) a okno „Co je nového“ po každém větším vydání ukáže novinky srozumitelnou češtinou.
Co řešíme dál

Tenhle týdenní sprint uzavřel celou první velkou fázi naší produktové roadmapy – a většina změn vznikla přesně díky tomu, že nám půjčovny píšou, co je v každodenním provozu zdržuje. Pokud vám u widgetu, QR štítků, Check-Inu nebo Fakturoidu cokoliv chybí, napište mi. Drobné úpravy nasazujeme průběžně podle toho, co vám nejvíc pomůže.

Vyzkoušejte nové funkce na vlastní půjčovně

V 30denním zkušebním provozu máte odemčený kompletní tarif Enterprise včetně QR štítků, pultového Check-Inu, widgetu i napojení na Fakturoid.

01.
Smlouvy a protokoly na 1 kliknutí

Všechny údaje ze skladové karty i zákazníka z ARESu se propíší do PDF protokolu automaticky.

02.
Biometrický podpis na tabletu i mobilu

Zákazník podepíše protokol prstem přímo u pultu nebo na dvoře bez tisku papírů.

03.
Přehled kaucí, kalendáře a revizí

Okamžitě vidíte volnou kapacitu stroje, složenou kauci i blížící se servisní prohlídku.

Prvních 30 dní zdarma bez platební karty, poté od 590 Kč měsíčně.

Vyzkoušet na 30 dní zdarma
Časté dotazy z praxe půjčoven

Odpovědi na otázky, které s majiteli půjčoven řešíme nejčastěji.