NAV Online Számla API v3 Integráció #221

Closed
opened 2026-06-07 21:49:36 +02:00 by kincses · 2 comments
Owner

Mérföldkő: API Fejlesztés
Cél: Opten API terv elvetése, helyette hivatalos NAV Online Számla API v3 queryTaxpayer végpont integrálása

🔗 Függőségek (Dependencies)

  • Bemenet (Mikre támaszkodik): .env (NAV_API_USER, NAV_API_PASSWORD, NAV_API_SIGN_KEY, NAV_API_EXCHANGE_KEY), httpx, hashlib (SHA-512, SHA3-512)
  • Kimenet (Mik támaszkodnak rá): GET /api/v1/organizations/lookup-tax/{tax_number} végpont, CorpOnboardIn séma

📝 Elemzés

A korábbi Opten API integrációs terv elvetésre került. Az új implementáció a hivatalos NAV Online Számla API v3 rendszerét használja a queryTaxpayer végponton keresztül. A NavService osztály kezeli a NAV specifikus kriptográfiát (SHA-512 passwordHash, SHA3-512 requestSignature), az XML kérés/válasz feldolgozást, és a hibakezelést. A végpont mock adatait valós NAV lekérdezés váltotta fel.

**Mérföldkő:** API Fejlesztés **Cél:** Opten API terv elvetése, helyette hivatalos NAV Online Számla API v3 queryTaxpayer végpont integrálása ### 🔗 Függőségek (Dependencies) - **Bemenet (Mikre támaszkodik):** .env (NAV_API_USER, NAV_API_PASSWORD, NAV_API_SIGN_KEY, NAV_API_EXCHANGE_KEY), httpx, hashlib (SHA-512, SHA3-512) - **Kimenet (Mik támaszkodnak rá):** GET /api/v1/organizations/lookup-tax/{tax_number} végpont, CorpOnboardIn séma ### 📝 Elemzés A korábbi Opten API integrációs terv elvetésre került. Az új implementáció a hivatalos NAV Online Számla API v3 rendszerét használja a queryTaxpayer végponton keresztül. A NavService osztály kezeli a NAV specifikus kriptográfiát (SHA-512 passwordHash, SHA3-512 requestSignature), az XML kérés/válasz feldolgozást, és a hibakezelést. A végpont mock adatait valós NAV lekérdezés váltotta fel.
kincses added the Type: FeatureStatus: In Progress labels 2026-06-07 21:49:41 +02:00
kincses started working 2026-06-07 21:49:41 +02:00
Author
Owner

▶️ Munka megkezdve: 2026-06-07 21:49:41

▶️ **Munka megkezdve:** 2026-06-07 21:49:41
kincses added Status: Done and removed Status: In Progress labels 2026-06-07 21:49:48 +02:00
kincses worked for 7 seconds 2026-06-07 21:49:48 +02:00
Author
Owner

Munka befejezve: 2026-06-07 21:49:48

Technikai Összefoglaló:
NAV Online Számla API v3 integráció elkészült. NavService osztály SHA-512/SHA3-512 kriptográfiával, XML kérés/válasz feldolgozással. GET /api/v1/organizations/lookup-tax/{tax_number} végpont mock-ról valós NAV hívásra váltva. Config, .env, history.md frissítve.

⏱️ Az idő rögzítve.

✅ **Munka befejezve:** 2026-06-07 21:49:48 **Technikai Összefoglaló:** NAV Online Számla API v3 integráció elkészült. NavService osztály SHA-512/SHA3-512 kriptográfiával, XML kérés/válasz feldolgozással. GET /api/v1/organizations/lookup-tax/{tax_number} végpont mock-ról valós NAV hívásra váltva. Config, .env, history.md frissítve. ⏱️ *Az idő rögzítve.*
Sign in to join this conversation.