Beküldések

Egy beküldés (submission) egy jelentés egy konkrét NAV felé történő beküldési kísérletét reprezentálja, a NAV gépi nyugtaadat-szolgáltatás felé küldött és onnan kapott válasz részleteivel együtt. Egy jelentéshez több beküldés is tartozhat, ha újrapróbálkozás történt.

Beküldések listázása

A lista report_id, taxpayer_id és status szerint szűrhető, kurzor alapú lapozással — lásd a Lapozás szakaszt.

curl https://api.fiscon.hu/v1/submissions \
    -H "Authorization: Bearer fis_live_xxxxxxxxxxxxxxxx"

Egy beküldés lekérdezése

{
    "id": "sub_01hz3k9c8v0000000000000000",
    "report_id": "rpt_01hz3k9c8v0000000000000000",
    "gateway": "nav-online-invoice",
    "gateway_version": "3.0",
    "status": "accepted",
    "external_submission_id": "NAV-2026-000123456",
    "submitted_at": "2026-09-02T23:58:00+02:00",
    "completed_at": "2026-09-02T23:59:10+02:00",
    "last_error_code": null,
    "last_error_message": null
}

Állapotok (status)

ÉrtékJelentés
pendingA beküldés még nem indult el.
submittingFolyamatban a NAV felé küldés.
submittedA NAV fogadta a kérést, a feldolgozás eredménye még nem ismert.
acceptedA NAV elfogadta az adatszolgáltatást.
rejectedA NAV elutasította — a hiba részletei a last_error_code/last_error_message mezőkben.
retry_scheduledÁtmeneti hiba történt, a Fiscon automatikusan újrapróbálja.
failedA beküldés véglegesen sikertelen, automatikus újrapróbálkozás nélkül.
invalidatedA mögöttes jelentés érvénytelenítve lett.

Sikertelen beküldésekről submission.rejected és submission.failed webhook eseményeket is küldünk, így nem szükséges aktívan lekérdezni az állapotot.