Jelentések
A beküldött nyugták adóalanyonként és napi bontásban jelentésekbe (report) aggregálódnak — ez felel meg a NAV gépi nyugtaadat-szolgáltatás napi összesítő adatszolgáltatásának. A jelentések csak olvashatók az API-n keresztül, létrehozásuk automatikus.
Jelentések listázása
A lista taxpayer_id és status szerint szűrhető, kurzor alapú lapozással — lásd a Lapozás szakaszt.
curl https://api.fiscon.hu/v1/reports \
-H "Authorization: Bearer fis_live_xxxxxxxxxxxxxxxx"$curl = curl_init('https://api.fiscon.hu/v1/reports');
curl_setopt_array($curl, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer fis_live_xxxxxxxxxxxxxxxx',
],
]);
$response = curl_exec($curl);
curl_close($curl);use Illuminate\Support\Facades\Http;
$reports = Http::withToken(config('services.fiscon.key'))
->get('https://api.fiscon.hu/v1/reports')
->json();const response = await fetch('https://api.fiscon.hu/v1/reports', {
headers: {
Authorization: 'Bearer fis_live_xxxxxxxxxxxxxxxx',
},
});
const reports = await response.json();Egy jelentés lekérdezése
{
"id": "rpt_01hz3k9c8v0000000000000000",
"taxpayer_id": "txp_01hz3k9c8v0000000000000000",
"report_date": "2026-09-02",
"currency": "HUF",
"first_receipt_number": "A/2026/00001",
"last_receipt_number": "A/2026/00042",
"receipt_count": 42,
"number_of_sale_document": 40,
"number_of_modifying_document": 2,
"total": "1834200.00",
"revision": 1,
"status": "accepted",
"due_at": "2026-09-03T00:00:00+02:00",
"submitted_at": "2026-09-02T23:58:00+02:00",
"accepted_at": "2026-09-02T23:59:10+02:00",
"invalidated_at": null,
"totals": [
{ "vat_category": "27%", "gross": "1270000.00" },
{ "vat_category": "AAM", "gross": "564200.00" }
]
}Állapotok (status)
| Érték | Jelentés |
|---|---|
building | A jelentés még nyitott, aznapi nyugták folyamatosan kerülnek bele. |
ready | A jelentés lezárva, beküldésre kész. |
scheduled | A beküldés ütemezve van (jellemzően a nap végi feldolgozási ablakra). |
submitting | A beküldés éppen folyamatban van a NAV felé. |
submitted | A NAV fogadta a kérést, a végleges eredmény még nem ismert. |
accepted | A NAV elfogadta a jelentést. |
retry_scheduled | Átmeneti hiba történt, a Fiscon automatikusan újrapróbálja a beküldést. |
rejected | A NAV elutasította — lásd a kapcsolódó beküldést a hiba részleteiért. |
invalidation_pending | Az érvénytelenítés kérése el lett indítva, folyamatban van a NAV felé. |
invalidated | A jelentés utólag érvénytelenítve lett. |
failed | A beküldés véglegesen sikertelen, automatikus újrapróbálkozás nélkül. |
A jelentés csak ready vagy annál későbbi állapotban érvényteleníthető — egy még building állapotú, illetve már folyamatban lévő érvénytelenítésű jelentésen az érvénytelenítés hívása 409 REPORT_NOT_INVALIDATABLE hibát ad.
Jelentés érvénytelenítése
Egy már beküldött jelentés csak az érvénytelenítés végponton keresztül vonható vissza — ez egy helyesbítő adatszolgáltatást indít a NAV felé:
curl -X POST https://api.fiscon.hu/v1/reports/rpt_01hz3k9c8v0000000000000000/invalidate \
-H "Authorization: Bearer fis_live_xxxxxxxxxxxxxxxx"$curl = curl_init('https://api.fiscon.hu/v1/reports/rpt_01hz3k9c8v0000000000000000/invalidate');
curl_setopt_array($curl, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer fis_live_xxxxxxxxxxxxxxxx',
],
]);
$response = curl_exec($curl);
curl_close($curl);use Illuminate\Support\Facades\Http;
Http::withToken(config('services.fiscon.key'))
->post('https://api.fiscon.hu/v1/reports/rpt_01hz3k9c8v0000000000000000/invalidate');await fetch('https://api.fiscon.hu/v1/reports/rpt_01hz3k9c8v0000000000000000/invalidate', {
method: 'POST',
headers: {
Authorization: 'Bearer fis_live_xxxxxxxxxxxxxxxx',
},
});