# Ověřený E-Shop – Kompletní AI Agent & LLM Příručka (Full Edition)

> Tato kompletní strojová specifikace slouží pro AI agenty (např. Claude, ChatGPT, Cursor, lokální agenty), kteří asistují uživateli s výběrem zboží, sestavením nákupního košíku, uplatněním slevových kódů, kalkulací DPH a dokončením objednávky.

---

## 1. Základní parametry a obchodní pravidla

- **Měna a ceny:** Všechny ceny zboží a služeb jsou uváděny v českých korunách (CZK) a jsou konečné včetně 21% DPH.
- **Doprava zdarma:** Pevná hranice **1 500 Kč** hodnoty zboží v košíku. Jakmile součet cen položek dosáhne nebo překročí 1 500 Kč, cena poštovného je automaticky 0 Kč.
- **Slevové kupóny:**
  - `SLEVA10`: 10 % sleva na zboží (přepočítává základ daně a DPH 21 % z reálně zaplacené částky).
  - `PRVNI100`: 100 Kč fixní sleva na nákup.
  - `DOPRAVA`: 100% sleva na přepravné.
- **Platební metody:**
  - `cod` (Dobírka): Úhrada hotově nebo platební kartou kurýrovi při převzetí zásilky. Objednávka vzniká okamžitě bez nutnosti platební brány.
  - `comgate` (Online platba): Zákazník je přesměrován na bezpečnou platební bránu Comgate.
  - Bankovní převod & **Česká QR Platba**: Standard ČBA SPD 1.0 pro okamžité zaplacení přes mobilní bankovnictví české banky (účet: `2100000000/2010`, Fio banka).
- **Dopravce:** Zaslat.cz (GLS, DPD) – doručení kurýrem na zadanou adresu nebo do výdejních míst a parcel boxů.
- **Firemní údaje (B2B):** Při nákupu na IČO e-shop automaticky validuje firmu přes registr ARES MFČR a doplní oficiální název, DIČ a sídlo.
- **Odstoupení od smlouvy:** Spotřebitel má zákonné právo odstoupit od kupní smlouvy do 14 dnů bez udání důvodu dle § 1820 NOZ přes formulář `/odstoupeni`.

---

## 2. Návod pro nákupního AI agenta (Průchod krok za krokem)

Agent může za člověka připravit nebo dokončit nákup dvěma způsoby:

### Možnost A: Prostřednictvím Model Context Protocol (Buyer MCP: https://mcp.profiderm.cz/mcp)
1. **Vyhledání produktů:** Nástroj `search_products` nebo `read_product_detail`.
2. **Vytvoření košíku:** Nástroj `create_buyer_cart` (vrátí `cart_id`).
3. **Vložení zboží:** Nástroj `put_buyer_cart_item` s `variant_id` a `quantity`.
4. **Získání kalkulace (Quote):** Nástroj `quote_buyer_cart` s dodací adresou. Zahrnuje přepočet DPH, dopravu zdarma nad 1 500 Kč i slevu.
5. **Odeslání objednávky:** Nástroj `start_buyer_checkout`.
6. **Předání rekapitulace člověku:** Číslo objednávky, bankovní údaje, řetězec pro QR Platbu a odkaz na stažení PDF faktury.

### Možnost B: Prostřednictvím REST API
1. **Košík:** `POST https://next.profiderm.cz/checkout-api/carts` -> vrátí košík a session cookie.
2. **Přidání položky:** `PUT https://next.profiderm.cz/checkout-api/carts/{cart_id}/items` s `{ variant_id, quantity }`.
3. **Kalkulace ceny a kupón:** `POST https://next.profiderm.cz/checkout-api/carts/{cart_id}/quote` s adresou a volitelným `coupon_code`.
4. **Odeslání objednávky:** `POST https://next.profiderm.cz/checkout-api/carts/{cart_id}/checkout` s `quote_id`, `payment_method: "cod"`, jménem, e-mailem a přijetím podmínek.
5. **Stažení PDF faktury:** `GET https://next.profiderm.cz/checkout-api/orders/{order_id}/invoice.pdf`.

---


