Ugrás a tartalomra
kassza
Hivatalos Számlázz.hu pluginv1.0.4Mind a 11 Számla Agent művelet

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.

Számla.Díjbekérő.Nyugta.Sztornó.Befizetés.PDF.Adószám.

Mindegyik egyetlen típusos függvényhívás.

Mutasd a műveleteket

Ami 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.

    1. invoices.create('REND-1001')elküldve
    2. válaszmegszakadt
    3. lekérdezés: REND-1001megvan
    4. KSZ-2026-148már kész
    5. 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:30
    Budapest2026-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.

    Érthető hibák

    Mind a 69 dokumentált hibakódhoz magyar üzenet és javítási tipp tartozik.

    Hibakezelés
    • Á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.

Amit te írsz25 sor TypeScript
szamla.ts
import { createKassza } from 'kassza'

const kassza = createKassza()

const szamla = await kassza.invoices.create({
  orderNumber: 'REND-1001',
  paid: true,
  paymentMethod: 'bankkártya',
  buyer: {
    name: 'Nagy Péter',
    zip: '1111',
    city: 'Budapest',
    address: 'Fő utca 1.',
    email: 'peter@example.hu',
  },
  items: [{
    name: 'Póló',
    quantity: 3,
    grossUnitPrice: 5_990,
    vat: 27,
  }],
})

szamla.number
szamla.pdf
Amit a Számlázz.hu kap41 sor XML
xmlagentxmlfile
<?xml version="1.0" encoding="UTF-8"?>
<xmlszamla xmlns="http://www.szamlazz.hu/xmlszamla" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.szamlazz.hu/xmlszamla https://www.szamlazz.hu/szamla/docs/xsds/agent/xmlszamla.xsd">
  <beallitasok>
    <szamlaagentkulcs>a-te-agent-kulcsod</szamlaagentkulcs>
    <eszamla>false</eszamla>
    <szamlaLetoltes>true</szamlaLetoltes>
    <valaszVerzio>2</valaszVerzio>
    <aggregator>3UMUqqWEJ7bXfJp9KXNWcrddY9sKjDVD</aggregator>
  </beallitasok>
  <fejlec>
    <keltDatum>2026-11-16</keltDatum>
    <teljesitesDatum>2026-11-16</teljesitesDatum>
    <fizetesiHataridoDatum>2026-11-16</fizetesiHataridoDatum>
    <fizmod>bankkártya</fizmod>
    <penznem>HUF</penznem>
    <szamlaNyelve>hu</szamlaNyelve>
    <rendelesSzam>REND-1001</rendelesSzam>
    <fizetve>true</fizetve>
  </fejlec>
  <elado></elado>
  <vevo>
    <nev>Nagy Péter</nev>
    <irsz>1111</irsz>
    <telepules>Budapest</telepules>
    <cim>Fő utca 1.</cim>
    <email>peter@example.hu</email>
    <sendEmail>true</sendEmail>
  </vevo>
  <tetelek>
    <tetel>

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.

Node.jsBunDeno
Cloudflare WorkersVercel EdgeNext.jsHonoExpressNuxt

0függőség.

Ugyanaz a kód fut mindenhol.

  • Cloudflare Workers
  • Vercel Edge
  • Next.js
  • Hono
  • Express
  • Nuxt

Kezdd el most.

npm i kassza