Számlázz és nyugtázzTypeScriptből.
Egy függvényhívás, és a számla kész a Számlázz.hu-n.
Példa: a kódrészlet egy 17 970 Ft összegű számlát állít ki Nagy Péter részére a Számlázz.hu-n. Fillérre pontos összegek, magyar idő, védelem a dupla számla ellen és magyar hibaüzenetek.
- 11/11Számla Agent művelet
- 69hibakód magyarul
- 28futtatható példa
- 11kész recept
- 0futásidejű függőség
11 Számla Agent művelet. Mind.
Mindegyik egyetlen típusos függvényhívás.
Mutasd a műveleteketAmi a nyers API-nál a te dolgod,
az itt már kész.
A Számla Agent szigorú: kötött XML-sorrend, saját kerekítés, magyar idő, és kitiltás jár az ismételgetésért. A kassza mindezt elintézi helyetted.
invoices.create('REND-1001')elküldveválaszmegszakadtlekérdezés: REND-1001megvanKSZ-2026-148már kész- 1 számla. Nem kettő.
Nincs dupla számla
Ha kiállítás közben megszakad a kapcsolat, a rendelésszám alapján kideríti, elkészült-e a számla. Nem kell találgatni, és nem kell sztornózni.
Pontosan egyszer- nettó egységár
- 4 716,67 Ft
- ×3 db
- 14 150 Ft
- +ÁFA 27%
- 3 820 Ft
- =bruttó
- 17 970 Ft
Fillérre pontos
A hivatalos kerekítéssel számol, számlára és nyugtára külön szabállyal.
- UTC2026-10-0722:30Budapest2026-10-0800:30
Mindig magyar idő
Europe/Budapest szerint dátumoz, így éjfél után sem csúszik el a kelt.
- 352SzamlazzError
A számla kelte csak a mai nap lehet.
A dátumot magyar idő (Europe/Budapest) szerint kell megadni, nem UTC szerint.
- Állíts ki számlát Nagy Péternek, 3 póló.
preview_invoiceBruttó 17 970 Ft, megerősítésre vár.- Mehet.
create_invoiceKSZ-2026-148 kiállítva
AI-ügynököknek is
Beépített MCP-szerver. Írni csak előnézet és megerősítés után tud, így véletlenül sem állít ki számlát.
MCP-szerver
Te ennyit írsz. A többit a kassza.
Egy típusos objektumot adsz át. Ebből épül fel a Számla Agent XML kötött sorrendben, hivatalos kerekítéssel, és ez megy el a Számlázz.hu-nak.
Fizetés után a számla magától elkészül.
Kész webhook-kezelő öt fizetési szolgáltatóhoz, aláírás-ellenőrzéssel. Ha a szolgáltató újraküldi az értesítést, akkor sem lesz két számla.
A többiek 3 műveletet tudnak.
A kassza mind a 11-et.
- kassza11/11
- szamlazz.js3/11
- @ribbery009/szamlazz-ts3/11
- @halftome/szamlazz-client3/11
- szamlazz.ts3/11
- szamlazzhu-client2/11
A publikált npm-csomagok kódjában ellenőrizve, 2026 szeptemberében: melyik Számla Agent műveletet küldik valóban.
0függőség.
Ugyanaz a kód fut mindenhol.
- Cloudflare Workers
- Vercel Edge
- Next.js
- Hono
- Express
- Nuxt