A NAV változhat.
A te integrációd ne.
A Fiscon egy stabil API-réteg a magyar adózási rendszerek fölött. Te JSON-t küldesz; mi kezeljük a validációt, aggregációt, beküldést és a retry-t — a NAV oldali változásoktól függetlenül.
A NAV technikai követelményei nem adnak értéket a termékedhez. A Fiscon leválasztja ezt a teljes réteget az alkalmazásodról — a szabályok változhatnak, a te integrációd nem.
Egyetlen stabil interfész. Minden más a háttérben.
A partner API-d állandó marad, függetlenül attól, mi történik a NAV oldalán. Amit a NAV megkövetel — a validációtól az újraküldésig —, azt a Fiscon belső rétege intézi, a te alkalmazásod pedig sosem szembesül vele közvetlenül.
Rendszerállapot egy pillantásra
Egy dashboardon látod a nyugtaszámot, a bruttó árbevételt, a sikeres beküldési arányt és a hibákat — szervezetenként.
Valós idejű állapotkövetés
Minden nyugta, jelentés és beküldés életciklusa végigkövethető, a beérkezéstől a NAV-elfogadásig.
Egy felület minden adózóhoz
Több adózó, több szervezet, egy felület — nem kell külön eszközt tanulnod NAV-partnerenként.
Minden esemény összekötve.
Nyugta, jelentés, beküldés és webhook — egy adatmodellben, egy API mögött.
Nyugták fogadása
Canonical JSON API, idempotency és üzleti validáció — NAV-specifikus mezők nélkül.
Jelentés-aggregáció
Napi jelentés, sorszámtartomány, áfakategóriák, NAV-kompatibilis XML automatikusan.
Beküldés és retry
Automatikus újrapróbálkozás ideiglenes hibákra, stabil státuszok NAV-verziótól függetlenül.
Webhook események
Receipt, report és submission események egy helyen — signed payloaddal, valós időben.
API kulcsok
Külön sandbox és production kulcsok, environment szerint elkülönítve.
Multi-tenant szervezetek
Egy fiókból több szervezet és adózó kezelhető, egymástól elkülönített adatokkal.
Kiszámítható folyamat, az első kéréstől az élesítésig.
01 · Sandbox kulcs
Kérj egy sandbox API kulcsot, és próbáld ki a teljes felületet éles adatok nélkül.
02 · Első kérés
Küldj egy nyugtát JSON-ként, kapj vissza egy stabil, dokumentált választ.
03 · Webhook feliratkozás
Iratkozz fel a receipt, report és submission eseményekre signed payloaddal.
04 · Production váltás
Cseréld a sandbox kulcsot production kulcsra — ugyanazzal az API felülettel.
curl -X POST https://api.fiscon.hu/v1/receipts \
-H "Authorization: Bearer fis_live_xxxxxxxxxxxxxxxx" \
-H "Idempotency-Key: 6f1e2c2a-2a3b-4d3e-9c1a-8b2f6e6c2b21" \
-H "Content-Type: application/json" \
-d '{
"external_id": "order-1242",
"taxpayer_id": "txp_01hz3k9c8v0000000000000000",
"receipt_number": "ABC-000125",
"issued_at": "2026-09-01T14:31:42+02:00",
"currency": "HUF",
"totals": [
{ "vat_category": "27%", "gross": "12990.00" }
]
}'
$payload = [
'external_id' => 'order-1242',
'taxpayer_id' => 'txp_01hz3k9c8v0000000000000000',
'receipt_number' => 'ABC-000125',
'issued_at' => '2026-09-01T14:31:42+02:00',
'currency' => 'HUF',
'totals' => [
['vat_category' => '27%', 'gross' => '12990.00'],
],
];
$curl = curl_init('https://api.fiscon.hu/v1/receipts');
curl_setopt_array($curl, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode($payload),
CURLOPT_HTTPHEADER => [
'Authorization: Bearer fis_live_xxxxxxxxxxxxxxxx',
'Idempotency-Key: 6f1e2c2a-2a3b-4d3e-9c1a-8b2f6e6c2b21',
'Content-Type: application/json',
],
]);
$response = curl_exec($curl);
curl_close($curl);
use Illuminate\Support\Facades\Http;
use Illuminate\Support\Str;
$response = Http::withToken(config('services.fiscon.key'))
->withHeader('Idempotency-Key', (string) Str::uuid())
->post('https://api.fiscon.hu/v1/receipts', [
'external_id' => 'order-1242',
'taxpayer_id' => 'txp_01hz3k9c8v0000000000000000',
'receipt_number' => 'ABC-000125',
'issued_at' => '2026-09-01T14:31:42+02:00',
'currency' => 'HUF',
'totals' => [
['vat_category' => '27%', 'gross' => '12990.00'],
],
]);
$receipt = $response->json();
const response = await fetch('https://api.fiscon.hu/v1/receipts', {
method: 'POST',
headers: {
Authorization: 'Bearer fis_live_xxxxxxxxxxxxxxxx',
'Idempotency-Key': crypto.randomUUID(),
'Content-Type': 'application/json',
},
body: JSON.stringify({
external_id: 'order-1242',
taxpayer_id: 'txp_01hz3k9c8v0000000000000000',
receipt_number: 'ABC-000125',
issued_at: '2026-09-01T14:31:42+02:00',
currency: 'HUF',
totals: [
{ vat_category: '27%', gross: '12990.00' },
],
}),
});
const receipt = await response.json();
Lásd, mielőtt használnád.
Az irányítópult, ahol a nyugtákat, jelentéseket és webhookokat kezeled.
Moduláris felépítés, ami bírja a terhelést.
A Fiscon domain modulokra bontva épül — a nyugták, jelentések, beküldés és webhookok önállóan skálázhatók.
Idempotens feldolgozás
Minden nyugta egyedi azonosítóval érkezik — a duplikált kérések biztonságosan, adatvesztés nélkül eldobásra kerülnek.
Automatikus újrapróbálkozás
Átmeneti NAV-oldali hibák esetén a beküldés automatikusan újraütemeződik, emberi beavatkozás nélkül.
NAV-verziófüggetlen absztrakció
A NAV interfészváltozásai a gateway rétegben csapódnak le — a partner API-d stabil marad.
Auditnapló minden eseményről
Minden állapotváltozás naplózva van — visszakövethető, ha egy nyugta vagy jelentés sorsát kell rekonstruálnod.
Kezdd egy adózóval. Skálázz több ezerig.
Egy adózóhoz, amikor most vezeted be a NAV-integrációt, és éles forgalmon szeretnéd kipróbálni.
- 1 aktív adózó
- 10 000 nyugta / hó
- Production API-hozzáférés
- Webhookok valós idejű státuszkövetéshez
- Automatikus újrapróbálkozás NAV-hiba esetén
- E-mail támogatás
Több adózóhoz, amikor már napi szinten futnak nagy tételben a nyugták és jelentések.
- 5 aktív adózó
- 100 000 nyugta / hó
- Kiemelt újraküldés átmeneti NAV-hibáknál
- 90 napos auditnapló minden eseményről
- Webhookok + részletes kézbesítési log
- Kiemelt e-mail és chat támogatás
Korlátlan adózóhoz, amikor a Fiscon a saját terméked NAV-rétegeként fut több ügyfél alatt.
- Multi-tenant architektúra
- Korlátlan aktív adózó, adózónkénti díjjal
- Advanced logs, 365 napos audit-megőrzés
- Kiemelt, 600/perc API rate limit
- Dedikált onboarding és priority support
Kell hozzá NAV-specifikus tudás?
Nem. A Fiscon egyetlen canonical JSON API-t ad, és a NAV interfészének minden részlete — XML, XSD-validáció, requestSignature — a mi belső rétegünkben él.
Mi történik, ha a NAV megváltoztatja az interfészét?
Mi frissítjük a Fiscon belső rétegét. A partner API-d, amivel te dolgozol, stabil marad — nem kell hozzányúlnod az integrációdhoz.
Van sandbox környezet éles adatok nélkül?
Igen, minden csomaghoz jár ingyenes sandbox kulcs, amivel a teljes felületet kipróbálhatod NAV felé történő beküldés nélkül.
Hogyan értesülök egy nyugta vagy jelentés állapotáról?
Webhookokon keresztül, valós időben — minden receipt, report és submission státuszváltozásra feliratkozhatsz, signed payloaddal.
Mennyi idő alatt tudok élesbe állni?
A sandbox kulcstól az első NAV-kompatibilis beküldésig jellemzően néhány óra, a lépéseket a Fejlesztőknek szekció mutatja.
A termékedet építsd. A NAV-ot bízd ránk.
Stabil infrastruktúra magyar szoftverekhez — egyszerű API, kiszámítható integráció.