Adam
/
AyCode.Core
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
AyCode.Core/AyCode.Services/Nav/docs
History
Loretta b3c82d6ad2 Add FruitBank EKÁER mapping layer and validation docs 
- Introduced IFruitBankEkaerService and implementation for mapping and submitting Shipping as EKÁER tradeCards
- Added IShippingToEkaerMapper and ShippingToEkaerMapper for domain-to-NAV mapping with normalization logic
- Created EkaerMappingOptions for config-driven mapping inputs
- Added unit tests for mapping logic (ShippingToEkaerMapperTests)
- Expanded EKAER_VALIDATION.md with C# validation implementation details
- Updated README.md to clarify mapping/submission flow and project boundaries
- Improved OrderClientTests assertions for nullability and clarity
- Updated settings.local.json with new dev workflow commands
 		2026-06-02 15:45:46 +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 FruitBank EKÁER mapping layer and validation docs 2026-06-02 15:45:46 +02:00
README.md Add FruitBank EKÁER mapping layer and validation docs 2026-06-02 15:45:46 +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_INTERFACE → EKAER_TRADECARD → EKAER_OPERATIONS → EKAER_VALIDATION.

A réteg-kód

A base réteg (interfészek, auth, send-flow) doksija: ../README.md.

Az EKÁER-kód a Nav/Ekaer/-ben:

  • generált modellek: Nav/Ekaer/Models/ (+ EkaerNavAdapters.cs — az INav* interfészek a generált típusokon)
  • EkaerManageService / EkaerQueryService — NAV HTTP (manage / query)
  • EkaerTradeCardValidator — a EKAER_VALIDATION.md szabályainak ellenőrzése (séma + üzleti), hibalistával
  • EkaerSubmitService / EkaerSubmitResult — beküldés-orchestráció (validate → send)

Ez mind általános NAV/EKÁER réteg. A FruitBank-specifikus leképezés (Shipping → tradeCard) NEM itt van, hanem a fogyasztó oldalon: FruitBank.Common/Services/Ekaer/ (mapper) + FruitBank.Common.Server/Services/Ekaer/ (fogyasztó).