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.

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

• 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.net nettó, total.vat ÁFA, total.gross bruttó HUF. A tételösszeg már a darabszámmal felszorzott. A komponensek nettók: unitNet darabonkénti, net a teljes tételre vonatkozik. A felületen egész forintra kerekítünk; ne számoljon újra a kerekített kijelzésből.
• status=custom esetén valamelyik ár hiányzik, ezért nincs teljes végösszeg: total=null. Ez nem nulla forintos ajánlat. A technicalNotes és messages tartalmá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-After vá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.

Adatkezelési tájékoztató