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

• O: Nem kötelező implementálni
  • O1: Az eVir-ben az adott feature nincs biztosítva, így a(z adat)szolgáltatás során nem merül fel a használata
  • O2: Nem élünk a(z adat)szolgáltatás lehetőségével
  • O3: Az implementáció időzítése alapján nem fejeződött be. (bármit is jelentsen ez :)

• [ ] Implementálandó v. Implementálható
• [.] Implementálás alatt
• [t] Implementált, de tesztelni kell
• [X] Implementált, tesztelt

• [t] manageAnnulment
• [t] manageInvoice
  • [.] nav_onlineszamla_data
• [ ] queryInvoiceChainDigest
• [X] queryInvoiceCheck
• [X] queryInvoiceData
• [ ] queryInvoiceDigest
• [ ] queryTransactionList
• [t] queryTransactionStatus
• [X] queryTaxpayer
• [X] tokenExchange

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

• 1) 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.
• 2) timestamp: onlineszamla_request_log.request_timestamp
• 3) requestVersion: general_data→work_version alapján
• 4) headerVersion: nem kötelező de megadjuk

Kötelezően implementálva

Kötelezően implementálva

$general_data→{software}

onlineszamla→

• handle_response minden valaszt feldolgoz
• process_result ertelmezi HTTP es hibakod szinten
• process_response_xml csak parsol

• 1) nem használtuk
• 2) errorCode ujrairni amit kell
• 3) message behozása a hibakezelésbe

Új kötelező implementáció

• manageInvoice tesztelve, működik
• manageAnnulment Opcionális O3

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

• cím adatok kinyerése HQ-ra partnerek modulban
• Ez tesztelve is van v_2 esetére

További 2.0-s változások (nem implementálva)

• taxpayerShortName
• vatGroupMembership

címadatokon belül új mezők:

• region
• lotNumber

Különösen nincsenek implementálva

Implementálva Tesztelve