Mango.Nop.Plugins/Nop.Plugin.Misc.AIPlugin/docs/EKAER/EKAER_ISSUES.md

EKÁER — Known Issues

Companion to README.md. Topic EKAER, prefix MGFBANKPLUG → entry IDs MGFBANKPLUG-EKAER-I-<RAND> (issue) / -B- (confirmed bug). ID format, Status vocabulary, type codes and archival → ../../.github/TOPIC_CODES.md (→ framework registry).

Scope: a FruitBank EKÁER-bejelentés szerver-oldali / nopCommerce-integrációs problémái — VTSZ-forrás, adatmodell-megfeleltetések, NAV-hívás kiszolgálása.

Active entries

MGFBANKPLUG-EKAER-I-T3X8: A Product.Gtin átmenetileg a VTSZ-t tárolja — szétválasztandó

Status: Closed (2026-06-02) — superseded · Priority: P3 · Type: I (adatmodell / átmeneti megoldás)

Resolution

Áthelyezve az általános adatmodell-topicba: FBANKAPP-DMODEL-I-P6X4 (FruitBank.Common/docs/DATAMODEL/DATAMODEL_ISSUES.md#fbankapp-dmodel-i-p6x4). Indok: a GTIN/VTSZ szétválasztás általános adatmodell-kérdés, nem EKÁER-specifikus — az EKÁER csak felhasználója. A követés ott folytatódik; az alábbi leírás referencia.

Az EKÁER tradeCardItem.productVtsz (kötelező, 8 jegyű vámtarifaszám) forrása jelenleg a nopCommerce Product.Gtin oszlop (a ProductDto.Gtin-en keresztül). A GTIN és a VTSZ fogalmilag különböző:

• GTIN — globális kereskedelmi cikkszám (vonalkód-azonosító, EAN/UPC).
• VTSZ — vámtarifaszám (a termék vám-/statisztikai besorolása).

Egy termékhez a kettő nem azonos; a Gtin oszlop VTSZ-ként való használata átmeneti megoldás az EKÁER-integráció beindításához.

Hatás: jelenleg nincs üzemszerű gond (a Gtin mező szabad, és a VTSZ-t tölthetjük bele). Hosszú távon viszont, ha a valódi GTIN-re is szükség lesz, a kettő ütközik.

Javítási irány (hosszú táv): külön Vtsz mező/GenericAttribute a Product-on, és a ShippingToEkaerMapper onnan olvasson — a Gtin maradjon a valódi GTIN.

Affected:

• FruitBank.Common/Dtos/ProductDto.cs → Gtin property (a [Column(nameof(Product.Gtin))] jelöléssel, summary-ban megjelölve)
• jövőbeli: ShippingToEkaerMapper (FruitBank.Common/Services/Ekaer/) — a productVtsz-t a külön Vtsz mezőből olvassa