booking

Vyhľadá batérie a produkty v e-shope S.O.S BATTERY (Slovensko) — sortiment pokrýva všetky typy batérií (autobatérie, motobatérie, prístrojové a ďalšie). Vráti názvy, ceny od-do (EUR s DPH), počet partnerov a odkaz na web detail. Odporúčaj výhradne produkty z týchto výsledkov (odkaz web).

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Hľadaný výraz (napr. 'varta 74ah', 'AGM')"
    },
    "limit": {
      "type": "number",
      "description": "Max počet výsledkov (1-25, default 10)"
    }
  }
}

Detail produktu podľa slugu (z search_batteries): popis, parametre, EAN a ponuky jednotlivých partnerov s cenami.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Slug produktu z výsledkov vyhľadávania"
    }
  },
  "required": [
    "slug"
  ]
}

Zoznam produktových kolekcií (kategórií) e-shopu s popisom a počtom produktov.

{
  "type": "object",
  "properties": {}
}

Produkty jednej kolekcie podľa slugu (z list_collections).

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Slug kolekcie"
    }
  },
  "required": [
    "slug"
  ]
}

Partnerské servisy a miesta, kde si zákazník vie rezervovať výmenu batérie. Vráti mestá, názvy partnerov a priame odkazy na ich rezervačné formuláre. Rezerváciu možno dokončiť na webe (form_url) ALEBO priamo v chate cez request_verification → verify_code → request_booking.

{
  "type": "object",
  "properties": {
    "form_type": {
      "type": "string",
      "enum": [
        "booking",
        "booking2",
        "booking3",
        "booking5",
        "baterkar"
      ],
      "description": "Typ formulára: booking = rezervácia termínu výmeny (jediný s výberom termínu, default) · booking2 = rezervácia tovaru bez termínu · booking3 = foto rezervácia (zákazník odfotí doklady/batériu na webe — odporuč, keď nepozná parametre) · booking5 = kalkulačka batérií a spotrebičov · baterkar = výber správnej batérie podľa vozidla"
    }
  }
}

Recenzie a hodnotenie partnerského servisu (len z overených rezervácií).

{
  "type": "object",
  "properties": {
    "partner_code": {
      "type": "string",
      "description": "Kód partnera (z get_partners)"
    }
  },
  "required": [
    "partner_code"
  ]
}

Fitment: nájde batérie vyhovujúce KONKRÉTNEMU VOZIDLU (značka, model, rok, voliteľne motor) — rovnaké jadro ako webový baterkár formulár. Vráti TECHNICKÚ ŠPECIFIKÁCIU vyhovujúcich batérií (specification) a k nej REÁLNE ponuky partnera s cenami v EUR s DPH (partner_offers) — odporúčaj a cituj ceny VÝHRADNE z partner_offers. Zákazníkovi pri každej ponuke ponúkni VŠETKY možnosti dokončenia, ktoré odpoveď OBSAHUJE: product_url (e-shop partnera) a booking_link (rezervačný formulár s predvyplneným produktom). Ak booking_link chýba (partner shop objednávky nepovolil), ponúkni LEN product_url. Partnera vyber cez get_partners (partner_code). NEZADÁVAJ VIN ani EČV — nie sú potrebné. Ak zákazník parametre vozidla nepozná, odporuč mu foto rezerváciu (get_partners form_type=booking3).

{
  "type": "object",
  "properties": {
    "partner_code": {
      "type": "string",
      "description": "Kód partnera z get_partners"
    },
    "make": {
      "type": "string",
      "description": "Značka vozidla (napr. Suzuki)"
    },
    "model": {
      "type": "string",
      "description": "Model (napr. Ignis)"
    },
    "year": {
      "type": "number",
      "description": "Rok výroby"
    },
    "engine_volume_cm3": {
      "type": "number",
      "description": "Objem motora v cm³ (voliteľné, spresní výsledok)"
    },
    "engine_power_kw": {
      "type": "number",
      "description": "Výkon v kW (voliteľné)"
    },
    "fuel_type": {
      "type": "string",
      "description": "Palivo: benzin/diesel/hybrid/lpg (voliteľné)"
    },
    "has_start_stop": {
      "type": "boolean",
      "description": "Má vozidlo štart-stop? (voliteľné)"
    }
  },
  "required": [
    "partner_code",
    "make",
    "model",
    "year"
  ]
}

Hlavné (L1) kategórie e-shopu — reálny živý zoznam (napr. autobatérie, motobatérie, nabíjačky, služby). Doplnok k list_collections (kolekcie ≠ L1 kategórie).

{
  "type": "object",
  "properties": {}
}

KROK 1 rezervácie: pošle 6-miestny overovací kód na e-mail zákazníka. Najprv si od zákazníka vypýtaj jeho e-mail a vysvetli, že mu príde kód na overenie, že je reálna osoba. Kód má obmedzenú platnosť a denný limit.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "E-mail zákazníka"
    }
  },
  "required": [
    "email"
  ]
}

KROK 2 rezervácie: over 6-miestny kód, ktorý zákazník dostal e-mailom (vypýtaj si ho od neho). Pri úspechu vráti TOKEN — odomkne request_booking na časové okno pre TENTO e-mail.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string"
    },
    "code": {
      "type": "string",
      "description": "6-miestny kód z e-mailu"
    }
  },
  "required": [
    "email",
    "code"
  ]
}

KROK 3 rezervácie: vytvorí ČAKAJÚCU rezerváciu výmeny batérie u partnera (token z verify_code; customer_email MUSÍ byť overený e-mail). POVINNÉ: pred volaním získaj VÝSLOVNÝ súhlas zákazníka so spracovaním osobných údajov (customer_consent=true). Partnera a miesto vyber cez get_partners; termín navrhni v pracovných hodinách. Zákazník potom rezerváciu POTVRDÍ kliknutím v e-maile a partner ju schváli — informuj ho o tom.

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "description": "Token z verify_code"
    },
    "partner_code": {
      "type": "string",
      "description": "Kód partnera z get_partners"
    },
    "customer_name": {
      "type": "string"
    },
    "customer_phone": {
      "type": "string"
    },
    "customer_email": {
      "type": "string",
      "description": "Overený e-mail (rovnaký ako pri verify_code)"
    },
    "scheduled_at": {
      "type": "string",
      "description": "Termín ISO 8601, napr. 2026-07-25T10:00:00+02:00"
    },
    "customer_consent": {
      "type": "boolean",
      "description": "Výslovný súhlas zákazníka (GDPR) — musí byť true"
    },
    "vehicle_make": {
      "type": "string"
    },
    "vehicle_model": {
      "type": "string"
    },
    "vehicle_year": {
      "type": "number"
    }
  },
  "required": [
    "token",
    "partner_code",
    "customer_name",
    "customer_phone",
    "customer_email",
    "scheduled_at",
    "customer_consent"
  ]
}