Skip to content

v3.0.0-RC1: átállás 3.0-as API-ra

Compare
Choose a tag to compare
@pzs pzs released this 18 Oct 21:14
· 30 commits to master since this release
6305eba

Változások:

  • Átállás a NAV v3.0-ás API-jára 🔥
  • A boríték XML-ből a namespace-eket automatikusan törli a modul, erről (és segédletről a namespace-ekhez) itt találsz leírást: XML namespace-ek.
  • Elektronikus számlázásról (electronicInvoiceHash és completenessIndicator) lásd a manageInvoice_electronic_invoice.php példafájlt és az Elektronikus számlázás támogatása leírást.
  • Config osztályban a $verifySSL értéke alapértelmezetten true lett, így ha bármi rosszul beállított certificate miatt nem kapcsolódna a modul a NAV-hoz, $config->verifySSL = false;-ra állításával ki tudod kapcsolni a cURL-ben az SSL ellenőrzést.
  • $reporter->getLastRequestData()-en belül a lastRequestId át lett nevezve requestId-ra.

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

  • $reporter->getLastResponseXml() metódus, mely visszaadja az utolsó válasz XML-t (ez a namespace nélküli változat, lásd XML namespace-ek).

ℹ️ A v3.0.0-RC1 release véglegesnek tekinthető és integrálható/tesztelhető. v3.0.0-ás verziószámmal várhatóan egy hónap múlva készítek el egy újabb release-t további tesztelések és szükség szerinti hibajavítások után.


Leírás a frissítéshez

v3.0-ás nav-online-invoice modulra történő frissítés után - a modult érintően - csak az URL-t kell átírnod v3-asra, más teendőd nincs, ha elolvastad a fenti változtatásokat.

  • NavOnlineInvoice\Config példányosításakor:
    • apiUrl a következőre változott: https://api-test.onlineszamla.nav.gov.hu/invoiceService/v3, illetve "-test" rész nélkül éles környezetben,
    • Esetleg használhatod a beépített NavOnlineInvoice\Config::TEST_URL és NavOnlineInvoice\Config::PROD_URL változókat, így a jövőben nem kell bajlódni az URL átírásával,

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_3.0