Veruno · Agentic API

Veruno pro AI agenty

Veřejné REST API (JSON) pro AI agenty. Dvě schopnosti: nákup produktů (agentic commerce) a rezervace pronájmu (auta, ubytování, technika). Většina čtení i vytvoření objednávky/rezervace je bez autentizace. Multi-tenant — v cestách je {tenant}.

Platby: agent nikdy nezadává platební údaje. Objednávka/rezervace se vytvoří ve stavu „čeká na platbu" a vrátí payment_url — platbu dokončí člověk.

Strojová discovery

GET

/.well-known/acp.json

Kanonický ACP manifest — schopnosti, operace, flow, příklady payloadů.

GET

/llms.txt

Textový rozcestník pro LLM (odkazy na vše důležité).

GET

/api/v1/capabilities

Přehled schopností, tenantů a endpointů.

GET

/api/v1/tenants

Seznam veřejných tenantů + odkazy.

MCP

https://mcp.veruno.cz/mcp

Remote MCP server (Streamable HTTP) — připoj se a máš nástroje bez importu OpenAPI.

1 · Nákup produktů bez auth

Agent projde katalog a vytvoří objednávku jedním POSTem (bez tokenu). Detaily a další cesty v ACP manifestu (sekce commerce_flow).

GET /api/v1/{tenant}/stock/store — produkty v nabídce (skladem, s cenou)
GET /api/v1/{tenant}/shipping/zones — mapa zóna → země → metody dopravy
POST {base}/store/{tenant}/ s _action=submit_order — vytvoření objednávky

POST https://veruno.cz/store/{tenant}/
Content-Type: application/json

{ "_action": "submit_order",
  "items": [{ "sku": "SKU_CODE", "qty": 1 }],
  "billing": { "first_name":"...", "last_name":"...", "email":"...", "phone":"...",
               "street":"...", "city":"...", "postal_code":"...", "country":"DE" },
  "shipping_same_as_billing": true,
  "shipping_method_id": 11,
  "payment_method_code": "bank_transfer" }

2 · Rezervace pronájmu bez auth

Auta, ubytování, technika. Zjisti dostupnost a cenu, pak vytvoř rezervaci — vrátí se payment_url pro člověka.

Krok 1 — dostupnost v termínu

GET https://veruno.cz/api/v1/{tenant}/rental/catalog?from=2026-10-06&to=2026-10-09
→ items[] s id, name, cenou a available (volné kusy v termínu)

Krok 2 — cena a výpočet (bez zápisu)

POST https://veruno.cz/api/v1/{tenant}/rental/quote
{ "items": [{ "item_id": 4, "quantity": 1 }], "from": "2026-10-06", "to": "2026-10-09", "coupon": "" }
→ days, lines[] (unit_price, line_total, available, enough), subtotal, discount, total, deposit, currency

Krok 3 — vytvoření rezervace

POST https://veruno.cz/api/v1/{tenant}/rental/book-public
{ "items": [{ "item_id": 4, "quantity": 1 }],
  "from": "2026-10-06", "to": "2026-10-09",
  "customer_first": "Jan", "customer_last": "Novák",
  "customer_email": "[email protected]", "customer_phone": "+420...",
  "consent_terms": true, "consent_gdpr": true }
→ { ok, booking_code, access_token, status:"pending", total_price, deposit_amount, currency, payment_url }

Podmínky: consent_terms i consent_gdpr = true; vyplň customer_email nebo customer_phone.

Krok 4 — platba a stav

Předej payment_url člověku — platbu dokončí sám. Nezaplacené rezervace se automaticky ruší.
Stav: GET /api/v1/{tenant}/rental/bookings/{booking_code}?t={access_token}

OpenAPI pro ChatGPT (Custom GPT Actions)

Hotová schémata k importu do Custom GPT (Configure → Actions → Import from URL). Auth: None.

Autopůjčovna

/openapi/rental.json

Rezervace vozů (aurent).

Ubytování

/openapi/ubytovani.json

Rezervace apartmánů/pokojů (authra).

E-shop

/openapi/store.json

Nákup produktů (magnet).

Pravidla

Formát JSON, chyby jako {"error":"...","hint":"..."} (např. consent_required, invalid_dates, rate_limited).
Rate-limit: rezervace 6 / 10 min / IP; quote 120 / 10 min.
Dostupnost se ověřuje při vytvoření — nelze přebukovat.
Zápis s plným oprávněním (operátor) vyžaduje Bearer token; veřejné cesty výše token nepotřebují.