← Vissza a kalkulátorhoz

Gyors kalkuláció AI-asszisztenseknek és fejlesztőknek

Ugyanaz a szerveroldali árképzés és aktuális árlista, mint a webes kalkulátorban. Nincs szükség kattintgatásra, bejelentkezésre vagy JavaScriptre.

Az API csak adatot ad és számol. Nem küld érdeklődést, e-mailt vagy PDF-et, és nem ad le megrendelést. A választott összeállítást az ember egy külön átadólinken ellenőrizheti; a későbbi kapcsolatfelvételt saját maga kezdeményezi.

Ár egyetlen link megnyitásával

A méretet és a kivitelt tartalmazó árhivatkozás a HTML-válaszban mutatja az aktuális összeget és a pontos összeállítást. A példák közvetlenül megnyithatók JavaScript, űrlap és POST-kérés nélkül. A rövid árlekérdezési útmutató a mezőket és az alapértékeket is felsorolja.

Az egyedi összeállítás bruttó végösszege az ároldalon és a JSON-válasz displayTotal mezőjében olvasható. A calculatedAt a számítás idejét jelzi. Ha a kereső korábbi másolatot ad vissza, az ott szereplő árat a számítás dátumával együtt lehet idézni. Ha az összeállított cím megnyitása sikertelen, adja meg a vevőnek a teljes, méretre és felszereltségre szóló árhivatkozást. Ezen újabb adatbevitel nélkül megnézheti az összeget.

Egyedi méret, külön URL-paraméterek nélkül

https://ujnyilaszarok.hu/kalkulator/ar/{type}/{system}/{width}x{height}/{direction}/{glazing}/

A kiválasztott extrák külön kulcs=érték szakaszként kerülnek a végére, például /color=anthracite/colorSides=both/installation=1/. JSON-válaszhoz adja hozzá a /format=json/ szakaszt. A méretek centiméterben értendők. Az útvonalban megadott beállításokhoz az URL kérdésjel utáni részében ne adjon meg kalkulációs mezőt.

A standard árlisták JSON-jegyzékében válassza ki a terméket a products[].jsonUrl mezőből. A megfelelő profil és üvegezés táblájában keresse meg a szélességet és a magasságot centiméterben. A withoutInstallationGrossHuf és withInstallationGrossHuf egy darab fehér szerkezet bruttó árát adja forintban. A sor sourceUrl hivatkozása közvetlenül az idézhető árhoz vezet. Más méret, szín, redőny vagy párkány esetén az élő árlekérdezést használja.

Fehér standard méretek árlistái típusonként. Az egyes méretekhez két bruttó összeg olvasható ki közvetlenül az oldal szövegéből: a termék önmagában, illetve a termék beépítéssel együtt. Egyedi mérethez vagy felszereltséghez használja az élő árlekérdezést.

A redőnynél és a felület alapján árazott szerelésnél darabonként 1 m² a minimum. E fölött a tényleges felület számít. Például 162 × 174 cm-nél 2,8188 m² alapján számoljuk a beépítést.

Mennyibe kerül egy műanyag ablak motoros alumínium redőnnyel és beépítéssel Budapesten és környékén?

A méretre kattintva megnyílik az adott összeállítás tételes ára. Mindegyik példa egy fehér, balos, kétrétegű üvegezésű ablakot, fehér motoros alumínium redőnyt, redőnyelőkészítést, valamint az ablak és a redőny szerelését tartalmazza. Bontás és párkány külön választható.

Tájékoztató bruttó ár egy darabra
MéretAblak és rendszerBeépítéssel
90 × 120 cmBukó-nyíló ablak · Aluplast IDEAL 4000208 117 Ft
120 × 150 cmBukó-nyíló ablak · Aluplast IDEAL 4000289 190 Ft
150 × 150 cmKétszárnyú nyíló + nyíló-bukó ablak · Aluplast IDEAL 4000374 172 Ft

Magyar megnevezések és lekérdezési kódok

Ablakrendszer (system)
Aluplast IDEAL 4000 system-1, Hevestherm Green 76 system-2, Hevestherm SmartSlide / GreenSlide system-3
Ablakszín (color)
Fehér white, Antracit anthracite, Dió walnut, Aranytölgy golden-oak
Redőnyszín (rollerColor)
Fehér white, Dió walnut, Antracit anthracite, Aranytölgy golden-oak
Üvegezés (glazing)
Kétrétegű üvegezés double, Háromrétegű üvegezés triple
Redőny (roller)
Nem kérek redőnyt none, Műanyag redőny plastic, Műanyag redőny szúnyoghálóval plastic-combi, Alumínium redőny aluminum · motorosan motor=1, Alumínium redőny szúnyoghálóval aluminum-combi · motorosan motor=1

A külső színhez colorSides=outside, a kívül-belül azonos színhez colorSides=both tartozik. A balos nyitás kódja left, a jobbosé right, az irányfüggetlen típusoké neutral. A motoros példák rövid hivatkozásán a bruttó összeg közvetlenül olvasható. Más összeállításhoz a pontos méretet és a hozzá tartozó opciókat adja meg.

Aktuális ablakárak mérettel és felszereltséggel

A példák az aktuális árlistából számolnak. Az itt látható bruttó összeg a sorban szereplő összeállításra vonatkozik. Más mérethez vagy felszereltséghez nyissa meg az annak megfelelő árhivatkozást.

Ezek egy darabra számolt példák. Árlistaverzió: wp-actual-area-9829284c-f5ff-41d9-b81e-625b411e18ae. További méretek és kivitelek a nyílászáró-mintaárak között találhatók.

Terméktípusok és azonosítók

Kétszárnyú ablaknál a két szárny nyitásmódja alapján válasszon típust. A példalinkek beépítés nélküli kivitelekre mutatnak. A saját kalkulációhoz a kért kivitelt és méretet adja meg, centiméterben.

KiviteltypePélda
Fix ablak
40–250 cm széles, 40–200 cm magas
01Élő ár, 120 × 150 cm · beépítés nélkül
Bukó ablak
50–170 cm széles, 40–150 cm magas
03Élő ár, 120 × 150 cm · beépítés nélkül
Nyíló ablak
40–160 cm széles, 50–190 cm magas
04Élő ár, 120 × 150 cm · beépítés nélkül
Bukó-nyíló ablak
50–160 cm széles, 50–190 cm magas
05Élő ár, 120 × 150 cm · beépítés nélkül
Kétszárnyú fix ablak
100–300 cm széles, 40–250 cm magas
06Élő ár, 120 × 150 cm · beépítés nélkül
Fix + bukó-nyíló ablak
100–250 cm széles, 60–190 cm magas
07Élő ár, 120 × 150 cm · beépítés nélkül
Kétszárnyú nyíló + nyíló-bukó ablak
90–280 cm széles, 60–190 cm magas
08Élő ár, 120 × 150 cm · beépítés nélkül
Tokosztott bukó-nyíló + bukó-nyíló ablak
90–280 cm széles, 60–190 cm magas
26Élő ár, 120 × 150 cm · beépítés nélkül
Háromszárnyú, fix + fix + fix
90–300 cm széles, 50–250 cm magas
09Élő ár, 120 × 150 cm · beépítés nélkül
Háromszárnyú, fix + bukó-nyíló + fix
140–300 cm széles, 60–200 cm magas
10Élő ár, 140 × 150 cm · beépítés nélkül
Háromszárnyú, fix + nyíló + bukó-nyíló
140–300 cm széles, 60–200 cm magas
11Élő ár, 140 × 150 cm · beépítés nélkül
Háromszárnyú, bukó-nyíló + nyíló + bukó-nyíló
140–300 cm széles, 60–220 cm magas
12Élő ár, 140 × 150 cm · beépítés nélkül
Függőleges bukó-nyíló + fix
60–150 cm széles, 120–280 cm magas
13Élő ár, 120 × 150 cm · beépítés nélkül
Függőleges bukó-nyíló + bukó
60–150 cm széles, 120–280 cm magas
14Élő ár, 120 × 150 cm · beépítés nélkül
Függőleges középen felnyíló, bukó-nyíló + fix
100–200 cm széles, 120–280 cm magas
15Élő ár, 120 × 150 cm · beépítés nélkül
Függőleges középen felnyíló, bukó-nyíló +bukó
100–200 cm széles, 120–280 cm magas
16Élő ár, 120 × 150 cm · beépítés nélkül
Függőleges középen felnyíló, bukó-nyíló +középen felnyíló, bukó-nyíló erkélyajtó
100–200 cm széles, 120–280 cm magas
17Élő ár, 120 × 150 cm · beépítés nélkül
SmartSlide NEO tolóajtó
170–400 cm széles, 190–250 cm magas
smartslideÉlő ár, 170 × 190 cm · beépítés nélkül
Nyíló erkélyajtó
60–100 cm széles, 200–240 cm magas
19Élő ár, 100 × 200 cm · beépítés nélkül
Nyíló-bukó erkélyajtó
60–100 cm széles, 200–240 cm magas
20Élő ár, 100 × 200 cm · beépítés nélkül
Fix + bukó-nyíló erkélyajtó
110–240 cm széles, 200–240 cm magas
21Élő ár, 120 × 200 cm · beépítés nélkül
2 szárnyú középen felnyíló, bukó-nyíló erkélyajtó
100–200 cm széles, 200–240 cm magas
22Élő ár, 120 × 200 cm · beépítés nélkül
1 szárnyú bejárati ajtó
80–110 cm széles, 200–240 cm magas
25Élő ár, 110 × 200 cm · beépítés nélkül
2 szárnyú bejárati ajtó
120–200 cm széles, 200–240 cm magas
24Élő ár, 120 × 200 cm · beépítés nélkül
GreenSlide tolóajtó
170–400 cm széles, 190–250 cm magas
greenslideÉlő ár, 170 × 190 cm · beépítés nélkül

Ugyanez hagyományos URL-paraméterekkel

Az első árpélda másik URL-formátumban

https://ujnyilaszarok.hu/kalkulator/ar/?type=05&system=system-1&width=120&height=150&direction=left&glazing=double

Futtatható GET-példa

A következő mintakérés csak lekérdez. Nem küld kapcsolatfelvételt, és nem hoz létre ajánlatot.

curl --fail --silent --show-error "https://ujnyilaszarok.hu/kalkulator/ar/?type=05&system=system-1&width=120&height=150&direction=left&glazing=double&format=json"

Python (csak standard könyvtár):

import json, urllib.request
url = "https://ujnyilaszarok.hu/kalkulator/ar/?type=05&system=system-1&width=120&height=150&direction=left&glazing=double&format=json"
with urllib.request.urlopen(url, timeout=20) as response:
    result = json.load(response)
if result['status'] == 'ok' and result['total'] is not None:
    print(result['citationText'])
    print('Forrás:', result['source'].get('pathUrl', result['source']['url']))
    for row in result['items']:
        for note in row.get('technicalNotes', []):
            print(note)
else:
    print('Nincs teljes ár; ellenőrizze a válaszban a hiányzó adatokat.')

Így adja vissza az árat az asszisztens

  1. Az ügyfél által kért kivitelt használja; a hiányzó lényeges műszaki választásokat tisztázza. A katalógusban megtalálható minden támogatott típus, rendszer, mérettartomány és opció. A termékenkénti priceUrl és priceJsonUrl mezők beépítés nélküli mintalinkek.
  2. Nyissa meg a megfelelő paraméterekkel az ároldalt. A választott kivitel és a bruttó végösszeg közvetlenül kiolvasható. Több tételnél a végösszeg már tartalmazza a darabszámokat.
  3. A chatben közölje a frissen lekért bruttó összeget, a méretet, rendszert, színezést, üvegezést és a kért szolgáltatásokat. Forrásként linkelje az Újnyílászárók.hu nevet a válasz source.pathUrl címére, vagy ennek hiányában a source.url címre. Az embernek az ár elolvasásához nem kell újra kitöltenie a kalkulátort.

A tájékoztató jelleg és az árhoz tartozó lényeges feltételek maradjanak láthatók. A link megnyithatósága nem garantálja, hogy egy külső chatbot automatikusan megtalálja vagy használja a szolgáltatást.

Egy tétel paraméterei

GET https://ujnyilaszarok.hu/kalkulator/ar/

MezőJelentés / alapérték
type, systemKötelező termék- és rendszerazonosító a katalógusból.
width, heightKötelező méret centiméterben, legfeljebb két tizedesjeggyel (például 120.25). Tizedespontot használjon; vessző vagy tudományos jelölés nem fogadható el. 120 × 150 cm = width=120&height=150, nem 1200 × 1500.
direction, glazingKötelező nyitásirány és üvegezés. Csak a terméknél felsorolt értékek.
quantityAlapérték: 1.
color, colorSidesAlapérték: white, outside. Színes kivitelnél outside: kívül színes, belül fehér; both: kívül-belül színes.
roller, rollerColor, panelAlapérték: none, white, none. A panel és a redőny kiválasztását a katalógus szabályai korlátozzák.
installation, demolition, motor, exteriorSill, interiorSillAlapérték: 0 (nem kért). Kiválasztáshoz 1. A beépítés, bontás és minden felsorolt extra kikapcsolva marad, amíg a kérés be nem kapcsolja.
formathtml (alapérték) vagy json.

A válasz felsorolja a ténylegesen számolt opciókat és az alkalmazott alapértékeket. A queryben ismételt, ismeretlen vagy személyes adatot tartalmazó mező nem elfogadható. A GET-lekérdezés minden megnyitáskor az aktuális árlistával számol; nincs rögzített árérvényesség vagy kötelező catalogVersion paraméter.

Több különböző ablak egy kérésben

Az egyedi mezők helyett adjon egy items paramétert: 1–20 tételes, URL-kódolt JSON-tömböt. Minden objektumban ugyanaz a hat kötelező mező szerepel, az opcionális mezőkre a fenti alapértékek érvényesek. JSON-ban a kapcsolók true / false értékűek. Az items és az egyedi tételparaméterek nem keverhetők; mellé csak a format adható meg. A teljes query legfeljebb 7500 bájt lehet. Hosszabb összeállításhoz használja az alábbi POST-végpontot.

Hibás vagy hiányos adatból nem adunk félrevezető árat

Ha nincs teljes ár (status=custom, total=null), vagy hibát kap, ne jelenítsen meg nullás, részösszegből képzett vagy kitalált végösszeget. Pontosítsa a hiányzó adatot; ne cserélje le a kért színt, rendszert vagy méretet egy olcsóbb támogatott változatra. A technicalNotes és a választott szolgáltatások az ár részei. Ismeretlen kivitelnél emberi egyeztetés szükséges.

Az ároldal megnyitása nem küld ajánlatkérést, e-mailt vagy PDF-et. A humanHandoff.url az ember számára választható továbblépés: a kalkulátorba viszi az összeállítást külön ellenőrzésre, automatikus beküldés nélkül. A dinamikus eredményoldalak noindex jelölésűek; nem keletkeznek külön WordPress-oldalak vagy tömeges sitemap-bejegyzések.

Ár közlése előtt egyeztesse az eredményben szereplő méretet, kivitelt, darabszámot és szolgáltatásokat az ügyfél kérésével. JSON-ban erre az inputItems, HTML-ben az eredmény címe és a tételleírás használható. Az útmutató megnyitása vagy egy eltérő árpélda esetén a kért ár még nincs lekérve.

A citationText röviden összefoglalja az árat és a kivitelt. Forrásként a source.pathUrl mezőt használja, ha szerepel a válaszban. Többtételes lekérdezésnél a source.url adja a hivatkozást. Őrizze meg a tájékoztató jelleget és a lényeges műszaki megjegyzéseket.

POST alternatíva: két kérésből eredmény

  1. GET catalog: aktuális termékek, mérettartományok, rendszerazonosítók, színek, redőnyök, panelek, szabályok és exampleItem kiindulási példák.
  2. POST https://ujnyilaszarok.hu/kalkulator/wp-json/uj-agent/v1/calculate: a kapott catalogVersion és legfeljebb 20 tételes items lista. Content-Type: application/json. Minden tételmező kötelező, így nincsenek rejtett alapértelmezések.

Teljes OpenAPI 3.1 séma · Rövid gépi útmutató (llms.txt) · Mintaárak

Futtatható példa (Python, csak standard könyvtár)

A példa egy katalógusbeli mintakivitelt számol, nem az ügyfél helyett dönt. A tényleges igényhez módosítsa a mezőket.

import json, urllib.request
base = "https://ujnyilaszarok.hu/kalkulator/wp-json/uj-agent/v1/"
with urllib.request.urlopen(base + 'catalog') as r:
    catalog = json.load(r)
item = catalog['products'][0]['exampleItem']
body = json.dumps({'catalogVersion': catalog['catalogVersion'], 'items': [item]}).encode()
request = urllib.request.Request(base + 'calculate', data=body, headers={'Content-Type': 'application/json'})
with urllib.request.urlopen(request) as r:
    result = json.load(r)
print(result['total'])
print(result['humanHandoff']['url'])

Fontos értelmezési szabályok

Emberi átadás, nem automatikus beküldés

A humanHandoff.url hét napig nyitható meg. A link csak a kivitel adatait tartalmazza, aláírással védve; nem árgarancia, nem személyazonosítás és nem beküldési jogosultság. Az ember importálja, ellenőrzi és szükség esetén módosítja az összeállítást, majd külön dönt a továbblépésről. A kalkulátor mindig az aktuális árakkal számol újra.

Az API-ba ne küldjön nevet, e-mailt, címet vagy feltöltött dokumentumot. A kalkuláció nem kerül az érdeklődések közé. Az átadólinket ne tegye nyilvánossá, mert a kivitel kiolvasható belőle. A kapcsolatfelvételi és PDF-funkciók külön, védett böngészős folyamatok maradnak.

Tájékoztató kalkuláció, nem végleges ajánlat és nem megrendelés. Nem indít kapcsolatfelvételt. Gyártás kizárólag helyszíni felmérés és műszaki egyeztetés után történhet. Az embernek ellenőriznie és külön jóváhagynia kell minden későbbi beküldést.

Adatkezelési tájékoztató