3.2 KiB

Raw Blame History

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: Open · Priority: P3 · Type: I (adatmodell / átmeneti megoldás)

Újranyitva (2026-06-15): a probléma továbbra is fennáll — a Gtin jelenleg is a VTSZ-t tárolja, a szétválasztás nem történt meg. A 2026-06-02-i FBANKAPP-DMODEL-I-P6X4-be (DATAMODEL) helyezés visszavonva; a követés ITT (EKÁER) folytatódik. (A FBANKAPP-DMODEL-I-P6X4 ennek megfelelően lezárva — DATAMODEL.)

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

MGFBANKPLUG-EKAER-I-M6Y2: A számla-pénznem a Partnerből jön — jobb lenne a ShippingDocument-en

Status: Open · Priority: P3 · Type: I (adatmodell)

Az EKÁER tétel-érték HUF-ra számításához a forrás-pénznem jelenleg a Partner.Currency-ből jön (a beszállító alap-devizája). Most 100%-ban megbízható — a partner egyértelműen meghatározza a devizát.

Hatás: működik; de a pénznem konceptuálisan a szállítmányhoz / dokumentumhoz tartozik, nem a partnerhez (egy partner elvileg többféle devizában is számlázhat).

Javítási irány: külön Currency oszlop a ShippingDocument-en, és az EkaerValueCalculator / ShippingToEkaerMapper onnan olvasson; a Partner.Currency maradjon fallback. Nem prioritás — a jelenlegi partner-alapú forrás elegendő.