search_batteries

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).

Parameters2

query	string	optional	Hľadaný výraz (napr. 'varta 74ah', 'AGM')
limit	number	optional	Max počet výsledkov (1-25, default 10)

Raw schema

{
  "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)"
    }
  }
}

get_product

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

Parameters1

slug

string

required

Slug produktu z výsledkov vyhľadávania

Raw schema

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

list_collections

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

Parameters

No parameters.

Raw schema

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

get_collection

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

Parameters1

slug

string

required

Slug kolekcie

Raw schema

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

get_partners

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.

Parameters1

form_type

string

optional

Typ formulára: booking = rezervácia termínu výmeny (jediný s výberom termínu, default) · booking2 = objednávka tovaru bez termínu · booking3 = foto objednávka (zákazník odfotí doklady/batériu na webe) · booking5 = kalkulačka batérií a spotrebičov · baterkar = výber správnej batérie podľa vozidla

Raw schema

{
  "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 = objednávka tovaru bez termínu · booking3 = foto objednávka (zákazník odfotí doklady/batériu na webe) · booking5 = kalkulačka batérií a spotrebičov · baterkar = výber správnej batérie podľa vozidla"
    }
  }
}

get_partner_reviews

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

Parameters1

partner_code

string

required

Kód partnera (z get_partners)

Raw schema

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

request_verification

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.

Parameters1

email

string

required

E-mail zákazníka

Raw schema

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

verify_code

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.

Parameters2

email	string	required
code	string	required	6-miestny kód z e-mailu

Raw schema

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

request_booking

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.

Parameters10

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

Raw schema

{
  "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"
  ]
}

sk.sos-battery/booking