{"schema_version":"1.0","name":"Číslárna","description":"Český e-shop s domovními tabulkami s číslem popisným, orientačním a evidenčním na míru. Tabulky se navrhují v konfigurátoru s živým náhledem a vyrábějí z probarveného plastu pro venkovní použití.","url":"https://cislarna.cz","contact":{"email":"info@cislarna.cz","address":"č.p. 100, 338 08 Cekov","form":"https://cislarna.cz/kontakt"},"area_served":"CZ","languages":["cs"],"commerce":{"currency":"CZK","price_from":490,"shipping_from":89,"dispatch_days":3,"custom_made_returns":false},"capabilities":{"read_only":false,"checkout":true,"customer_approval_required":true,"payment_by_agent":false,"protocol":"custom-json"},"documents":{"llms_txt":"https://cislarna.cz/llms.txt","sitemap":"https://cislarna.cz/sitemap.xml","configurator":"https://cislarna.cz/navrhnout-tabulku","openapi":"https://cislarna.cz/api/v1/agent/openapi.json","agent_options":"https://cislarna.cz/api/v1/agent/options","agent_quote":"https://cislarna.cz/api/v1/agent/quote","agent_checkouts":"https://cislarna.cz/api/v1/agent/checkouts","pickup_point":"https://cislarna.cz/vydejni-misto"},"workflow":[{"step":1,"actor":"agent","method":"GET","url":"https://cislarna.cz/api/v1/agent/options","mutating":false,"description":"Načtěte aktuální typy, barvy, písma, rozměry, montáž a limity. Barvu se soldOut=true nelze objednat."},{"step":2,"actor":"agent","method":"POST","url":"https://cislarna.cz/api/v1/agent/quote","mutating":false,"description":"Pošlete JSON s objektem configuration. Povinná pole: type, background, text, font a size s hodnotami z kroku 1. number posílejte jako řetězec, například \"583\". Volitelná pole: frame (null = bez rámečku), spacing, lines (seznam textových řádků), style a mounting. Cena nezahrnuje dopravu ani kupón. Příklad těla: {\"configuration\":{\"type\":\"descriptive\",\"number\":\"583\",\"background\":\"modra\",\"text\":\"bila\",\"frame\":\"bila\",\"font\":\"tinos\",\"size\":\"200x150\",\"mounting\":\"glue\"}}. Odpověď vrací cenu v haléřích (unitPriceCents, currency CZK), sellable, issues, náhled svg, configuration tak, jak ji obchod přijal, a configuratorUrl. Endpoint jen počítá, objednávku ani platbu nevytváří. Při sellable=false návrh objednat nelze, důvody jsou v issues s level=error."},{"step":3,"actor":"agent","method":"POST","url":"https://cislarna.cz/api/v1/agent/checkouts","mutating":true,"creates_order":false,"description":"Pošlete JSON s položkami (items), kontaktem, fakturační adresou, dopravou (shipping_method) a platbou (payment_method) z kroku 1. Tabulka má kind=plate a configuration jako v kroku 2, příslušenství kind=accessory a accessoryId. Odpověď 201 vrací token, quoteToken, konečnou cenu totalCents včetně dopravy, náhledy a expiresAt. Objednávka ani platba tím nevzniká. Ceny počítá obchod, ceny z požadavku nepřijímá."},{"step":4,"actor":"customer","description":"Zákazník zkontroluje souhrn z kroku 3 včetně náhledů, adres a konečné ceny a výslovně ho schválí spolu s obchodními podmínkami. Souhlas získává asistent, obchod ho sám neověřuje."},{"step":5,"actor":"agent","method":"POST","url":"https://cislarna.cz/api/v1/agent/checkouts/{token}/complete","mutating":true,"creates_order":true,"requires_customer_approval":true,"description":"Až po souhlasu zákazníka pošlete quoteToken (vazba na souhrn předložený ke schválení), terms_accepted=true a preview_confirmed=true. Vznikne závazná objednávka, právě jedna i při opakování požadavku. Když se nabídka mezitím změnila, odpověď je 409 a objednávka nevznikne."},{"step":6,"actor":"customer","description":"Zákazník zaplatí sám: přes odkaz redirectUrl na platební bránu, nebo převodem podle nextAction.bankTransfer. Agent platbu neprovádí. Stav objednávky a platby vrací GET na urls.self."}],"alternative":"Bez nákupu přes asistenta: předejte zákazníkovi configuratorUrl z kroku 2. Otevře konfigurátor se stejným návrhem, zákazník zkontroluje náhled a může návrh upravit. Zákazník pak sám vloží tabulku do košíku, vyplní objednávku a zaplatí."}