# stikls.lv Pricing API — dokumentācija AI aģentiem un integrācijām

Publisks, tikai lasāms JSON API, kas atgriež to pašu cenu, ko rēķina konfiguratori
[/stikla-veidi/](https://www.stikls.lv/stikla-veidi/) un [/spogulu-veidi/](https://www.stikls.lv/spogulu-veidi/)
un pēc kuras tiek izrakstīts rēķins. **Šis ir autoritatīvais avots aktuālai cenai** — cenas
par m² un apstrādes likmes tiek lasītas no datubāzes katrā pieprasījumā, tāpēc tās var mainīties.

Pēc cenas saņemšanas pasūtījumu noformē klients pats konfiguratorā (Klix apmaksa vai rēķins);
pasūtījuma izveide caur API ārējiem aģentiem nav paredzēta.

Bāzes URL: `https://www.stikls.lv/api/wizard-price.php`

Limits: 120 pieprasījumi minūtē no vienas IP adreses.

## Pieprasījums

### GET — viena pozīcija

```
GET https://www.stikls.lv/api/wizard-price.php?material=16&shape=rect&w=800&h=600&edge=2&qty=1
```

### POST — vairākas pozīcijas (grozs)

```
POST https://www.stikls.lv/api/wizard-price.php
Content-Type: application/json

{"positions":[
  {"material":16,"shape":"rect","w":800,"h":600,"edge":2,"qty":1},
  {"material":151,"shape":"circle","d":600,"edge":2,"film":"white","mounting":"glue","qty":2}
]}
```

## Parametri

| Parametrs | Vērtības | Piezīmes |
|---|---|---|
| `material` | material_code id (skat. tabulu zemāk) | obligāts; vienmēr nerūdītais pamata materiāls |
| `tempered` | `1` | rūdīts variants; tikai stiklam, no 250×250 mm, tikai ar `edge` 1 vai 2 |
| `shape` | `rect` (noklusēti), `circle`, `ellipse`, `arch` | |
| `w`, `h` | mm | taisnstūrim, elipsei, arkai (arkai `h` ≥ `w`/2) |
| `d` | mm | aplim (diametrs) |
| `corners` | `tl,tr,br,bl` (jebkura kombinācija) | tikai `rect`; noapaļotie stūri, prasa `edge` ≥ 1 |
| `radius` | mm (noklusēti 30) | stūru rādiuss, min 5, max puse no īsākās malas |
| `edge` | `0` nav, `1` slīpēta, `2` pulēta, `3` fasete 10 mm, `4` fasete 15 mm, `5` fasete 20 mm | izliektām formām obligāti ≥ 1; fasete tikai no 150×150 mm |
| `film` | `white`, `grey`, `black` | tikai spoguļiem — drošības plēve aizmugurē |
| `mounting` | `glue`, `hangers`, `holes` | tikai spoguļiem; `glue` kopā ar `film` nav atļauts (plēve traucē līmes saķeri) — API atbild ar kļūdu |
| `glue_tubes` | skaits | ja `mounting=glue`; tukšs = automātiski (1 tūbiņa ≈ 1,3 m²) |
| `cap` | `FURN-VACINS-*` SKU | dekoratīvie vāciņi, ja `mounting=holes` |
| `qty` | 1–50 | gabalu skaits |

### Materiālu id

| Materiāls | 4 mm | 5 mm | 6 mm | 8 mm |
|---|---|---|---|---|
| Stikls (float) | 16 | 211 | 154 | 163 |
| Stikls ClearVision (dzidrais) | 22 | — | 157 | 219 |
| Stikls bronzas | 14 | 212 | 155 | 217 |
| Stikls pelēkais | 13 | 206 | 156 | 169 |
| Stikls tumši pelēkais | 27 | — | — | 222 |
| Spogulis | 151 | 240 | 238 | — |
| Spogulis Crystal / ClearVision | 201 | — | 239 | — |
| Spogulis bronzas | 202 | — | — | — |
| Spogulis pelēkais | 203 | — | — | — |

Pilns pieejamo materiālu saraksts ar aktuālajām cenām par m²: `GET https://www.stikls.lv/api/catalog.php`.

## Atbilde

```json
{
  "ok": true,
  "currency": "EUR",
  "vat_rate": 0.21,
  "positions": [{
    "material": {"id": 16, "name": "4mm Stikls", "thickness": 4, "category": "stikls", "price_m2": 18, "is_tempered": 0},
    "shape": "rect", "label": "800×600 mm",
    "area_m2": 0.48, "billed_area_m2": 0.48, "min_area_applied": null, "qty": 1,
    "breakdown": {"base": 8.64, "edge": 8.4, "corners": 0, "film": 0, "hangers": 0, "holes": 0, "glue": 0, "caps": 0},
    "unit_excl": 17.04, "line_excl": 17.04, "total_excl": 17.04, "total_incl": 20.62,
    "lines": [{"kind": "position", "desc": "4mm Stikls 800×600 mm, Pulētas malas", "qty": 1, "unit": 17.04, "total": 17.04}],
    "rates": {"edge_per_m": 3, "film_per_m2": 0, "glue_per_tube": 8.26}
  }],
  "order": {"lines": [...], "subtotal": 17.04, "min_order_bump": 0, "vat": 3.58, "grand": 20.62},
  "rules": {"min_area_m2": 0.2, "min_area_tempered_m2": 0.3, "min_order_excl": 10, "curve_area_coef": 1.5, "curve_edge_multiplier": 3, "corner_price": 2.42, "min_mm": [150, 95], "facet_min_mm": [150, 150], "rect_max_mm": [3000, 2200], "circle_max_d_mm": 1500, "arch_max_mm": [1500, 2800], "ellipse_max_mm": [2800, 1500]}
}
```

- Visas summas EUR. `*_excl` — bez PVN, `total_incl` un `order.grand` — ar PVN 21 %.
- `order.min_order_bump` — piemaksa līdz minimālajai pasūtījuma summai (10 € bez PVN), atsevišķa rinda.
- Kļūda: `{"ok": false, "error": "…", "contact": true|false, "position": n}` ar HTTP 400. `contact: true` nozīmē,
  ka izmērs pārsniedz standarta robežu un jāsaskaņo individuāli (WhatsApp +371 25149552, tālr. +371 67803020, info@stikls.lv).

## Cenas formula

Tā pati formula darbojas konfiguratorā, API un pasūtījumā.

1. Rēķināmais laukums = max(faktiskais laukums, 0,2 m²; rūdītam 0,3 m²). Aplim un elipsei laukums ×1,5; arkai — gabarīta taisnstūris.
2. Cena bez PVN = rēķināmais laukums × cena par m² + malas garums (m) × malas apstrādes cena par m + opcijas.
   Izliektas malas (aplis, elipse, arkas loks) apstrāde ×3.
3. Opcijas: noapaļots stūris 2,42 € gab.; spoguļiem drošības plēve par rēķināmo m², savērsnis 12 € (divi, ja mala virs 1000 mm),
   urbumi 4 × 2 €; līme un vāciņi — atsevišķas rindas pēc noliktavas cenas.
4. Noapaļošana: vienības cena = round(summa / qty, 2), rinda = round(vienība × qty, 2), PVN = round(rinda × 0,21, 2) katrai rindai atsevišķi,
   kopā = Σ rindas + Σ PVN.
5. Ja Σ rindu bez PVN < 10 €, pievieno rindu "Minimālā pasūtījuma summa — piemaksa".

Malas apstrādes cena par metru ir atkarīga no biezuma; piemēram 4 mm stiklam bez PVN: slīpēta 2,00 €/m, pulēta 3,00 €/m,
fasete 10 mm 8,50 €/m. Precīzas likmes katram biezumam atgriež API laukā `rates`.

## Izmēru ierobežojumi (konfigurators)

| Forma | Standarta robeža | Lielāks izmērs |
|---|---|---|
| Taisnstūris | garākā mala ≤ 3000 mm, īsākā ≤ 2200 mm | jāsaskaņo individuāli |
| Aplis | diametrs ≤ 1500 mm | jāsaskaņo individuāli |
| Arka | platums ≤ 1500 mm, augstums ≤ 2800 mm | jāsaskaņo individuāli |
| Elipse | ≤ 1500 × 2800 mm | jāsaskaņo individuāli |

Mazākā detaļa 95 × 150 mm (īsākā × garākā mala; aplim ⌀ ≥ 150), fasete no 150 × 150 mm; rūdīšana no 250 × 250 mm, tikai ar slīpētu vai pulētu malu (fasete un neapstrādāta mala rūdītam nav pieejama). Mazākām detaļām API atbild `contact: true` — jāsaskaņo ar ražotni.
Citām produktu lapām (taisnstūra spoguļi, apaļie spoguļi, plaukti, virtuves paneļi u.c.) ir savi kalkulatori un savas robežas — tās lasāmas attiecīgajā lapā.

## Ieteicamā secība aģentam

1. Noskaidrot, kas vajadzīgs: stikls vai spogulis, veids, biezums, forma, izmēri, apstrāde.
2. Pārbaudīt ierobežojumus (tabula augstāk); ja pārsniegti — piedāvāt sazināties.
3. Saņemt cenu no API (`GET` vienai pozīcijai, `POST` vairākām).
4. Novirzīt lietotāju uz konfiguratoru ar jau aizpildītu stāvokli, piemēram
   `https://www.stikls.lv/stikla-veidi/?veids=parastais&biezums=4&forma=rect&w=800&h=600&mala=2#konfigurators`
   (parametri: `veids` = parastais | kristala | bronzas | pelekais | tumsi-pelekais, `biezums` mm, `forma`, `w`, `h`, `d`,
   `sturi`, `r`, `mala`, `rudits`; spoguļiem `pleve`, `stiprinajums`, `vacini`, `skaits`). Tur klients pievieno pozīcijas,
   ievada kontaktus un apmaksā ar Klix vai saņem rēķinu.

Dokumenta versija: 2026-09-10.