Ez a dokumentáció, az onlineszámla adatszolgáltatás API-nak való megfelelőséggel kapcsolatos információkat tartalmaz.
Ez az onlineszamla adatszolgáltatás V2.0 verziójának megfelelően dokumentál.
A dokumentációban tagekkel felhívom a figyelmet azokra a pontokra ahol az implementáció a lehetséges legbővebb változathoz képest kevesebbet nyújt. Erre természetesen meg van a lehetőség, hiszen a NAV által felkínált lehetőségek közül számos nem kötelező.
Indoklásképpen a következő fő változatok lehetségesek
A rendszer egy technikai azonosítóval dolgozik.
A tokent a számla küldésének kötelezettségekor közvetlenül megigényli, A megigényelt tokent azonnal megpróbálja felhasználni, nem él az 5 perces limittel.
A jövőben lehetséges implementáció, hogy tömeges számlázáskor egy tokent igényel az egyszerre kiállított számlákhoz (trigger) ezért a tömeges számlázásnál nem emelhető meg 100 fölé az egyszerre kiállított számlák száma.
Pillanatnyilag a tömeges számlázáskor egyesével igényelt tokenekkel küldi be a számlákat.
Ha a számlák ismételt beküldése esetén (átmeneti technikai sikertelenség esetén) az újraküldésekhez már számlánként egyenként igényel tokent.
basic.pm
requestId
az onlineszamla_request_log
tábla request_id
-jéből jön. Fejlesztői környezetben kaphat prefixet az unicitás biztosítása céljából.timestamp
: onlineszamla_request_log.request_timestamp
requestVersion
: general_data→work_version
alapjánheaderVersion
: nem kötelező de megadjukKötelezően implementálva
Kötelezően implementálva
$general_data→{software}
onlineszamla→
handle_response
minden valaszt feldolgozprocess_result
ertelmezi HTTP es hibakod szinten process_response_xml
csak parsol errorCode
ujrairni amit kellÚj kötelező implementáció
Kötelezően implementálva
SQL-ből megoldva (UTC-ben is generáljuk, tároljuk)
context root verzio nélkül???
Mint 1. pontban
onlineszamla→calc_header
lásd 1.4 …
Opcionális. Nem tömörítünk.
onlineszamla→http_ua_request
setup-ban allithato az interaktiv es a batch timeout kulon kulon is.
default 5 sec.
timeout eseten sajat response kodunk van:
504 Client-side timeout átvezetni a többi mellé a doksiban
nem kötelező; oprendszer szintű megoldást itt nem dokumentálok. (Elvileg mindenhol NTP van)
ezt implementalni kellhet
logikus
1.4. szerint
Implementálva Tesztelni kell majd
Tömörítést nem használunk
Implementált tesztelés alatt
A beküldött számla adattartalmára vonatkozó információk a nav_onlineszamla_data oldalon találhatóak.
2020-02 új
Implementálva Tesztelve
batch feldolgozás és vevő oldali lekérdezés nélkül
használja-e valaki (close_trigger pl?) lásd: invoice_data !!!
Implementálva. Tesztelve
Használata még változás alatt van
batch feldolgozás és vevő oldali lekérdezés nélkül
Implementálandó
Adatszolgáltatási kötelezettség teljesítését nem akadályozza
2020-02 új
Implementálva, close_trigger hívja, mikor kell. Elvileg tesztelve, és működik
Implementálva, tesztelve
Implementált 2.0-s változások: V2-20-20
További 2.0-s változások (nem implementálva)
címadatokon belül új mezők:
Különösen nincsenek implementálva
Implementálva Tesztelve