AyCode.Core/AyCode.Services/Nav/docs
Loretta a4cd8f3f0f Add NAV/EKÁER reporting layer to AyCode.Services
- Nav/ base layer: INav* interfaces, NavAuthHelper (SHA-512 passwordHash +
  requestSignature in UTC), NavXmlHelper (UTF-8 XML), NavReportServiceBase
  (HTTP POST + (de)serialize + error handling), NavReportException.
- Nav/Ekaer/: 62 XSD-generated models (Models/ + Models/Common/ — separate
  namespaces resolve the TradeCardType enum-vs-class clash), 5 partial adapters
  binding the generated types to the Nav interfaces, EkaerManageService +
  EkaerQueryService.
- Nav/docs/: ekaermanagement.xsd + common.xsd + LLM-friendly extracts
  (INTERFACE / TRADECARD / OPERATIONS / VALIDATION).
- AyCode.Services.Tests/Nav/: NavAuthHelper verified against the official EKÁER
  PDF test vector + adapter interface-mapping tests (10 pass).
- csproj: register Nav/docs *.xsd and *.md.
2026-06-01 15:40:35 +02:00
..
EKAER_INTERFACE.md Add NAV/EKÁER reporting layer to AyCode.Services 2026-06-01 15:40:35 +02:00
EKAER_OPERATIONS.md Add NAV/EKÁER reporting layer to AyCode.Services 2026-06-01 15:40:35 +02:00
EKAER_TRADECARD.md Add NAV/EKÁER reporting layer to AyCode.Services 2026-06-01 15:40:35 +02:00
EKAER_VALIDATION.md Add NAV/EKÁER reporting layer to AyCode.Services 2026-06-01 15:40:35 +02:00
README.md Add NAV/EKÁER reporting layer to AyCode.Services 2026-06-01 15:40:35 +02:00
common.xsd Add NAV/EKÁER reporting layer to AyCode.Services 2026-06-01 15:40:35 +02:00
eKAERManagementService_2.2.pdf Add NAV/EKÁER reporting layer to AyCode.Services 2026-06-01 15:40:35 +02:00
ekaermanagement.xsd Add NAV/EKÁER reporting layer to AyCode.Services 2026-06-01 15:40:35 +02:00

README.md

Nav/docs — NAV referencia-anyagok és kivonatok

A NAV adatszolgáltatás (jelenleg EKÁER) hivatalos forrásai + LLM-barát kivonatok. A kivonatok célja: ne kelljen a 2.2 MB-os PDF-et olvasni a gyakori feladatokhoz (token-takarékos, kereshető, a docs-discovery skill megtalálja).

Hiteles források

Fájl Mit ad
eKAERManagementService_2.2.pdf A hivatalos EKÁER 2.2 interfész-leírás (NAV). Ütközésnél ez + az XSD a mérvadó.
ekaermanagement.xsd A management-séma — a generált modellek (Nav/Ekaer/Models/) forrása. XSD-validációhoz is ez.
common.xsd Közös EKÁER-séma: BasicHeaderType, UserHeaderType, BaseResultType, és a teljes ReasonCodeType (~150 hibakód).

Kivonatok (kezdd ezekkel)

Fájl Téma Mikor
EKAER_INTERFACE.md Transport, endpoint, auth-algoritmus (teszt-vektorral), üzenet-váz A kommunikáció bekötésekor (megvan a kódban)
EKAER_TRADECARD.md A payload: tradeType, fejrész, címadat, vehicle, deliveryPlan, tétel, tradeReason A Shipping → TradeCard mapping (3. réteg) írásakor
EKAER_OPERATIONS.md Műveletek (create/modify/delete/finalize/correction) + státusz-életciklus A bejelentés-folyamat implementálásakor
EKAER_VALIDATION.md Validációs szabályok (tradeType-függő) + hibakód-kategóriák Hibakezelés / mező-kötelezőség eldöntésekor

Olvasási sorrend új belépőnek: EKAER_INTERFACEEKAER_TRADECARDEKAER_OPERATIONSEKAER_VALIDATION.

A réteg-kód

A base réteg (interfészek, auth, send-flow) doksija: ../README.md. A generált modellek: Nav/Ekaer/Models/.