v2.0.2

• Config osztály példányosításánál user paraméterben password helyett mostantól passwordHash is átadható opcionálisan, lásd példafájlt és kapcsolódó PR-t: #22
• Typo fix Config osztályban: $verifySLL javítva $verifySSL-re (v2.x-ben a régi név is használható) PR: #21

v2.0.1: `ns2` namespace eltávolítása a `queryTaxpayer` válaszából

• Breaking change*: ns2 namespace eltávolítása a queryTaxpayer válaszából a könnyebb feldolgozhatóság végett. Lásd #20

*a breaking change akkor érint téged, ha használod a queryTaxpayer kérés válaszából a címadatokat. Ilyenkor lehetőséged van vagy átírni a saját kódod, vagy kikapcsolni ezt a funkciót a $config->removeNamespaces false-ra állításával.

v2.0.0: átállás a NAV 2.0-ás API verzióra

Breaking change:

• Átállás NAV 2.0-ás API verzióra

New feature:

• Naplózást és hibakeresést segítő $reporter->getLastRequestData() metódus, lásd a példafájlt

ℹ️ A NAV 2.0-ás API teszt és éles környezetben is elérhető már.

⚠️ 2020. április 1-jétől kizárólag a 2.0-ás API lesz alkalmazható az éles környezetben (forrás)

A 2.0.0-ás verzióval csak a 2.0-ás NAV interfészt lehet használni. Az 1.1-es NAV interfész használatához kérlek, az 1.1.0-ás verziójú modult használd.

---

Leírás a frissítéshez

A 2.0-ás nav-online-invoice modulra való frissítés után a következő módosításokat kell végrehajtanod:

• NavOnlineInvoice\Config példányosításakor:
  • apiUrl a következőre változott: https://api-test.onlineszamla.nav.gov.hu/invoiceService/v2, illetve "-test" rész nélkül éles környezetben,
  • software adatok megadása kötelező lett,
• SHA3-512-es hash algoritmust kell használni, melyhez PHP 7.1.0-ás verzió, vagy újabb szükséges. Ha ennél régebbit használsz, akkor külső könyvtárat kell betölteni, melyet nem tartalmaz a nav-online-invoice modul:
  • n-other/php-sha3, MIT license (packagist),
  • vagy desktopd/php-sha3-streamable, LGPL 3+ license,
  • a fenti kettő könyvtár közül elég az egyiket telepítened/behivatkoznod, s azt automatikusan használni fogja a nav-online-invoice.
• technikai érvényesítést mostantól nem a manageInvoice() hívással, hanem manageAnnulment() hívással kell beküldened,
• a státusz lekérdezés metódus át lett nevezve queryInvoiceStatus()-ról queryTransactionStatus()-ra,
• a queryInvoiceData() metódus változott: ezzel mostantól csak egy számla adatait lehet lekérni számlaszám alapján (kiállító és vevő oldalról is), keresni pedig az új queryInvoiceDigest() metódussal lehet,
• a queryTaxpayer() metódus visszatérési értékében a címadatokat más formában adja vissza a NAV, illetve kibővül más információkkal is,
• továbbá a 2.0-ás API-n új operációk is elérhetőek lettek: queryTransactionList és queryInvoiceChainDigest, lásd a leírást és példákat.

Új funkció a nav-online-invoice modulban:

• naplózást és hibakeresést segítő $reporter->getLastRequestData() metódus, lásd a példafájlt, illetve a leírást.

Ha ezekkel megvagy, akkor már csak az adatsémákat kell átírnod, melyhez segítséget a NAV-os dokumentációkban, illetve fórumokon találsz, de ha megpróbálod beküldeni a régi adat XML-t, akkor az interfész is ki fogja írni a sémavalidálási hibát. NAV-os changelog: CHANGELOG_2.0

---

Változás az RC1-hez képest:

• XSD frissítése,
• új operációk bevezetése: queryTransactionList és queryInvoiceChainDigest,
• PR: #17

v2.0.0-RC1: átállás a NAV 2.0-ás API verzióra

Breaking change:

• Átállás NAV 2.0-ás API verzióra

New feature:

• Naplózást és hibakeresést segítő $reporter->getLastRequestData() metódus, lásd a példafájlt

ℹ️ A NAV 2.0-ás teszt környezete már elérhető tesztelésre, viszont éles környezetre legkorábban 2020. februárban lehet számítani. Egész eddig a dátumig a nav-online-invoice modul 2.0.0-ás verziója "RC" verzióban lesz elérhető. Az RC és a végleges kiadás között nincs tervben breaking change, csak új funkcionalitást hozzáadására lehet számítani a NAV-os interfész bővülése esetén.

A 2.0.0-ás verzióval csak a 2.0-ás NAV interfészt lehet használni. Az 1.1-es NAV interfész használatához kérlek, az 1.1.0-ás verziójú modult használd.

---

Leírás a frissítéshez

A 2.0-ás nav-online-invoice modulra való frissítés után a következő módosításokat kell végrehajtanod:

• NavOnlineInvoice\Config példányosításakor:
  • apiUrl a következőre változott: https://api-test.onlineszamla.nav.gov.hu/invoiceService/v2, illetve "-test" rész nélkül éles környezetben,
  • software adatok megadása kötelező lett,
• SHA3-512-es hash algoritmust kell használni, melyhez PHP 7.1.0-ás verzió, vagy újabb szükséges. Ha ennél régebbit használsz, akkor külső könyvtárat kell betölteni, melyet nem tartalmaz a nav-online-invoice modul:
  • n-other/php-sha3, MIT license (packagist),
  • vagy desktopd/php-sha3-streamable, LGPL 3+ license,
  • a fenti kettő könyvtár közül elég az egyiket telepítened/behivatkoznod, s azt automatikusan használni fogja a nav-online-invoice.
• technikai érvényesítést mostantól nem a manageInvoice() hívással, hanem manageAnnulment() hívással kell beküldened,
• a státusz lekérdezés metódus át lett nevezve queryInvoiceStatus()-ról queryTransactionStatus()-ra,
• a queryInvoiceData() metódus változott: ezzel mostantól csak egy számla adatait lehet lekérni számlaszám alapján (kiállító és vevő oldalról is), keresni pedig az új queryInvoiceDigest() metódussal lehet.

Ha ezekkel megvagy, akkor már csak az adatsémákat kell átírnod, melyhez segítséged a NAV-os dokumentációkban, illetve fórumokon találsz, de ha megpróbálod beküldeni a régi adat XML-t, akkor az interfész is ki fogja írni a sémavalidálási hibát. NAV-os changelog: CHANGELOG_2.0

1.1-es API vezióra átállás, XML séma frissítés

• Frissítés 1.1-es XML sémákra (2019.02.06.)
• Átállás 1.1-es API verzióra (requestVersion mezőben 1.1 küldése)

⚠️ Ahhoz, hogy a 1.1-es verzióra átállj, a beküldendő számláidnak (XML-eknek) meg kell felelnie a NAV által kiadott v1.1-es invoiceData.xsd séma leírásnak.

ℹ️ 2018. decemberi hír szerint az 1.0-ás API verzió "2019. áprilisig használható lesz"

1.0-ás karbantartási verzió

• Ez a verzió tartalmilag teljes mértékben megegyezik az előző, v0.7.1 kiadással
• Támogatott NAV-os API és XML séma verzió: 1.0
• Ettől a verziótól a nav-online-invoice verziószáma (major és minor) követni fogja a támogatott NAV-os API/séma verziót

Fix: Http 1.0 verzió használata

2018.08.01-es frissítés óta a NAV teszt szerveren csak HTTP 1.0-ás kérések működnek (HTTP 1.1-re 500-as hiba érkezik).
Ez a frissítés ezt javítja, mostantól mindig HTTP 1.0-át küld a nav-online-invoice interfész.

Megjegyzés: jelenleg (2018.08.03-án) az éles rendszer a HTTP 1.0-át és 1.1-et is elfogadja.

queryInvoiceData metódus javítása

• $reporter->queryInvoiceData() fix, most már ez a metódus is működik és használható (köszi a tippet @veghnandor)
• ⚠️ Változott a queryInvoiceData() metódus visszatérési értéke, mostantól a visszakapott XML queryResults részét adja vissza (SimpleXMLElement) a teljes XML válasz helyett. Lásd a példákat: queryInvoiceData_invoiceQuery.php és queryInvoiceData_queryParams.php

XML séma frissítése

• invoiceData.xsd XML séma frissítése 2018.06.14-i verzióra

TechnicalAnnulment automatikus felismerése és PHPDoc javítások

• ⚠️ Ettől a verziótól a invoiceOperations/technicalAnnulment értéke automatikusan felismerésre és beállításra kerül a számlák operation értéke alapján, így a setTechnicalAnnulment() metódust már nem kell kézileg meghívni ANNUL esetén. Ez a metódus deprecated lett emiatt, használata esetén figyelmeztetés fog megjelenni.
• PHPDoc javítások (@webprogramozo, PR #8)