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