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ó.
| Méret | Ablak és rendszer | Beépítéssel |
|---|---|---|
| 90 × 120 cm | Bukó-nyíló ablak · Aluplast IDEAL 4000 | 208 117 Ft |
| 120 × 150 cm | Bukó-nyíló ablak · Aluplast IDEAL 4000 | 289 190 Ft |
| 150 × 150 cm | Kétszárnyú nyíló + nyíló-bukó ablak · Aluplast IDEAL 4000 | 374 172 Ft |
Magyar megnevezések és lekérdezési kódok
- Ablakrendszer (system)
- Aluplast IDEAL 4000
system-1, Hevestherm Green 76system-2, Hevestherm SmartSlide / GreenSlidesystem-3 - Ablakszín (color)
- Fehér
white, Antracitanthracite, Diówalnut, Aranytölgygolden-oak - Redőnyszín (rollerColor)
- Fehér
white, Diówalnut, Antracitanthracite, Aranytölgygolden-oak - Üvegezés (glazing)
- Kétrétegű üvegezés
double, Háromrétegű üvegezéstriple - Redőny (roller)
- Nem kérek redőnyt
none, Műanyag redőnyplastic, Műanyag redőny szúnyoghálóvalplastic-combi, Alumínium redőnyaluminum· motorosanmotor=1, Alumínium redőny szúnyoghálóvalaluminum-combi· motorosanmotor=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.
- Bukó-nyíló ablak · 120 × 150 cm · beépítés nélkül · Aluplast IDEAL 4000 · Balos (belső nézet) · Kívül-belül fehér · Kétrétegű üvegezés · Redőny nélkül · Párkány nélkül · Bontás nélkül · 115 683 Ft bruttó, tájékoztató ár · JSON
- Bukó-nyíló ablak · 120 × 150 cm · beépítéssel · Aluplast IDEAL 4000 · Balos (belső nézet) · Kívül-belül fehér · Kétrétegű üvegezés · Redőny nélkül · Párkány nélkül · Bontás nélkül · 159 117 Ft bruttó, tájékoztató ár · JSON
- Bukó-nyíló ablak · 87 × 112 cm · beépítés nélkül · Aluplast IDEAL 4000 · Balos (belső nézet) · Kívül-belül fehér · Kétrétegű üvegezés · Redőny nélkül · Párkány nélkül · Bontás nélkül · 78 890 Ft bruttó, tájékoztató ár · JSON
- Kétszárnyú nyíló + nyíló-bukó ablak · 147 × 163 cm · kívül-belül aranytölgy · motoros alumínium redőny · külső párkány · beépítéssel · Hevestherm Green 76 · Balos (belső nézet) · Kívül-belül Aranytölgy · Kétrétegű üvegezés · Motoros · Alumínium redőny · Aranytölgy · külső alumínium párkány · színazonos: Aranytölgy · Bontás nélkül · 505 071 Ft bruttó, tájékoztató ár · JSON
- Kétszárnyú nyíló + nyíló-bukó ablak · 165 × 176 cm · kívül-belül antracit · beépítéssel · Aluplast IDEAL 4000 · Balos (belső nézet) · Kívül-belül Antracit · Kétrétegű üvegezés · Redőny nélkül · Párkány nélkül · Bontás nélkül · 335 205 Ft bruttó, tájékoztató ár · JSON
- Tokosztott bukó-nyíló + bukó-nyíló ablak · 165 × 176 cm · kívül-belül antracit · beépítéssel · Aluplast IDEAL 4000 · Nincs választható balos/jobbos irány · Kívül-belül Antracit · Kétrétegű üvegezés · Redőny nélkül · Párkány nélkül · Bontás nélkül · 348 462 Ft bruttó, tájékoztató ár · JSON
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.
| Kivitel | type | Pé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=doubleFuttatható 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
- 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éspriceJsonUrlmezők beépítés nélküli mintalinkek. - 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.
- 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.pathUrlcímére, vagy ennek hiányában asource.urlcí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, system | Kötelező termék- és rendszerazonosító a katalógusból. |
width, height | Kö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, glazing | Kötelező nyitásirány és üvegezés. Csak a terméknél felsorolt értékek. |
quantity | Alapérték: 1. |
color, colorSides | Alapé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, panel | Alapé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, interiorSill | Alapé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. |
format | html (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
- GET catalog: aktuális termékek, mérettartományok, rendszerazonosítók, színek, redőnyök, panelek, szabályok és
exampleItemkiindulási példák. POST https://ujnyilaszarok.hu/kalkulator/wp-json/uj-agent/v1/calculate: a kapottcatalogVersionés legfeljebb 20 tételesitemslista. 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
- Minden méret centiméterben értendő (120 × 150 cm, nem 1200 × 1500). Csak a terméknél felsorolt irány, rendszer és mérettartomány használható.
outside: kívül a választott szín, belül fehér.both: mindkét oldal azonos választott színű. Minden ábra belső nézetű.- Színes szerkezethez a katalógus szabályai szerinti alumínium redőny; motor csak arra alkalmas alumínium redőnyhöz. Redőnyelőkészítés automatikus. Az ajtókhoz nem választható párkány; kétszárnyú ajtónál a panel csak a nagy szárnyba kerül.
total.netnettó,total.vatÁFA,total.grossbruttó HUF. A tételösszeg már a darabszámmal felszorzott. A komponensek nettók:unitNetdarabonkénti,neta teljes tételre vonatkozik. A felületen egész forintra kerekítünk; ne számoljon újra a kerekített kijelzésből.status=customesetén valamelyik ár hiányzik, ezért nincs teljes végösszeg:total=null. Ez nem nulla forintos ajánlat. AtechnicalNotesésmessagestartalmát is adja át az embernek.- 409: változott az árlista, kérje le újra. 422: javítandó kivitel, ne helyettesítse csendben. 429: tartsa be a
Retry-Aftervárakozást. 503: átmeneti hiba. Hálózatonként legfeljebb 120 kérés / 15 perc; globális védelmi limit is van.
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.