Nevezéktani szótár

A partner 11 jegyű magyar adószáma xxxxxxxx-y-zz formátumban. A QUiCK a beküldés előtt normalizálja és ellenőrzőösszeggel validálja.

"tax_number": "12345678-2-42"

A tételre alkalmazott áfa mértéke százalékban vagy speciális kulcs kódként (`AAM`, `TAM`, `KBAET`). A QUiCK a NAV által elfogadott kulcskészletet fogadja el.

"vat_rate": 27

Egy külső szállítótól érkezett, könyvelésre váró számla. A rendszer bejövő számlaként rögzíti azokat a bizonylatokat, amelyek szállítói NAV bejelentésből vagy manuális feltöltésből származnak.

GET /v1/invoices?direction=inbound&status=open

Az áfát is tartalmazó egységár. Ha csak bruttó árat adsz meg, a QUiCK visszaszámolja a nettót az adott `vat_rate` alapján.

"gross_unit_price": 15875.00

Az a nap, ameddig a vevőnek ki kell egyenlítenie a számlát. A rendszer ez alapján számítja a késedelmes tételek listáját és a fizetési emlékeztetőket.

"payment_due_date": "2026-07-15"

Kliens által generált, egyedi HTTP fejléc, amely megelőzi a véletlen duplikált POST hívásokat. A QUiCK 24 órán át emlékszik a kulcs eredményére.

Idempotency-Key: 3f5c9d7a-2b8f-4e11-9d43-6b0a1e5c2d8f

A vállalkozás által kiállított értékesítési számla. Kimenő számla esetén a QUiCK automatikusan gondoskodik a NAV Online Számla bejelentésről.

POST /v1/invoices { "direction": "outbound", ... }

Az EU-n belüli áfás kereskedelemhez használt adószám, országkód prefixszel (pl. HU12345678). A rendszer VIES ellenőrzést végez a beküldéskor.

"eu_tax_number": "HU12345678"

Egy korábbi számla részleges módosítása — pl. hibás mennyiség vagy egységár javítása. A rendszer külön bizonylatként tartja nyilván az eredeti számlára hivatkozva.

POST /v1/invoices/{id}/corrective

Egy tétel áfa nélküli egységre vetített ára a számla pénznemében. A számla nettó összegét a rendszer a tételek `net_unit_price * quantity` szorzatából állítja elő.

"net_unit_price": 12500.00

A vállalkozás egy vevője vagy szállítója. A partner törzsadat egyszer kerül létrehozásra, és minden későbbi számla erre hivatkozik.

GET /v1/partners/{id}

Egy számlán szereplő termék vagy szolgáltatás sora, saját megnevezéssel, mennyiséggel, egységgel és áfakulccsal. Egy számla minimum egy line_item-et tartalmaz.

"line_items": [{ "name": "Konzultáció", "quantity": 2, ... }]

Egy korábbi számla teljes érvénytelenítése. A sztornó bizonylat pontosan az eredeti tételekkel, negatív előjellel kerül kiállításra és a NAV-nak bejelentésre.

POST /v1/invoices/{id}/storno

A gazdasági esemény tényleges megvalósulásának dátuma, amely az áfa keletkezésének időpontja. A magyar szabályozás szerint kötelező mező minden kimenő számlán.

"fulfillment_date": "2026-07-01"

A webhook payload HMAC-SHA256 aláírása, a `X-QUiCK-Signature` fejlécben. A fogadó oldalon a shared secret-tel újraszámolva ellenőrizhető a hitelesség.

X-QUiCK-Signature: sha256=9b1c...