„B" melléklet --- Architektúra

Butlers Hungary (Vidámnyik Kft.) --- Ajánlattételi felhívás: E-kereskedelmi fulfillment és webáruház-platform szolgáltatások

v1.0 --- 2026-09-04 --- BIZALMAS --- kizárólag ajánlatkészítéshez

B.1 Kontextus röviden

A jelenlegi működést a fődokumentum 2. fejezete írja le. Architektúra-szempontból:

1. Egy webshop-instancia szolgálja ki mindhárom piacot (HU elsődleges; CZ/SK kapcsolt shopok, saját devizával és tartalommal).
2. Ma az online készlet elsődleges nyilvántartása a fulfillment-szolgáltató, és ő indítja a vevői számlázást; a webshop az értékesítést, bevételezéseket és készletet visszaszinkronizálja az offline ERP-be, amely az árakat szinkronizálja vissza. Ez a csatolás a célállapotban megszűnik --- az ajánlattevők ebből semmit nem vesznek át.
3. A Társaság saját termékadat-hubot üzemeltet („Beforg"), egy házon belül fejlesztett, napi éles használatban lévő rendszert. Ma a webshop-motor a heti Butlers Germany feedből termék-vázakat (item shell) hoz létre, amelyeket aztán a Beforgon keresztül töltünk fel árazással és tartalommal; a Beforg az áruátvételi folyamatot is kiszolgálja.
4. Az offline rendszerek (POS, ERP, CRM --- magyar és cseh) a fizikai üzleteket szolgálják és mindkét rész szempontjából scope-on kívüliek.

B.2 Célmodell

Jelmagyarázat: A piros színnel jelölt "Webáruház-platform" és a hozzávezető "TERMÉKFEED" a rendszer új, központi elemét és fő adatkapcsolatát emeli ki. A szaggatott vonal visszacsatolást jelöl.

1. Az online készlet elsődleges nyilvántartása a webáruház-platform. A készletkönyvet mozgásokból vezeti; a fulfillment-szolgáltató jelenti a bevételezéseket (a várható beszállításokkal szemben), a kiszállításokat, korrekciókat és visszárut, valamint fizikai leltárt ad a periodikus egyeztetéshez. A készletkönyv az irányadó.
2. A termékadat a Társaságtól érkezik, elsődlegesen a Beforgon keresztül. A munkamegosztás rugalmas, a kiválasztott partnerrel kerül véglegesítésre --- mindkét modell elfogadható: (a) a platform teljes termékfeedet fogyaszt a Beforgból; (b) a platform a Butlers Germany feedből termék-vázakat hoz létre, amelyeket a Beforgból töltünk fel (a mai működő modell). Az ajánlattevő jelezze, mely modell(eke)t támogatja és melyiket preferálja.
3. A platform állítja ki a NAV-kompatibilis számlákat és övé az összes vevőkommunikáció; a fulfillment-szolgáltatónak nincs számlázási és vevőkapcsolati feladata.
4. A két rész bizonyított konnektoron keresztül kapcsolódik, ahol létezik, egyébként dokumentált API-kon (B.3).
5. Offline rendszerek: az ajánlattevőktől nem várunk integrációt.

B.3 A Társaságtól elérhető adatok / interfész-elvárások

A Beforgból (formátum JSON/CSV, lehúzás vagy push; a részletek a szerződéskötés során kerülnek egyeztetésre): cikkszám (elsődleges kulcs; 18 jegyű örökölt forma is elérhető) és EAN; többnyelvű nevek, leírások és kategóriák (HU/CS/SK --- a CZ/SK tartalmat a Társaság cseh csapata gondozza); képek (társasági CDN); piaconkénti fogyasztói árak és akciós árak; nettó beszerzési árak (az ELÁBÉ-hoz a fődokumentum 5.1.4 szerint); státusz és logisztikai attribútumok; várható beszállítások előre (szállítmány-hivatkozás, tételek mennyiséggel és egységnyi beszerzési árral) --- a bevételezés ezekkel szemben kerül visszaigazolásra, így kapnak a bevételezések beszerzési értéket. Készletet a feed nem szolgáltat --- a készlet forrása a platform készletkönyve.

A két rész között (eseményvezérelt, mindkét irányban): rendelés-átadás utánvét-összeggel és futárszolgáltatással; bolti gyűjtőcsomag-utasítások; várható beszállítás átadása; bevételezés-visszaigazolások; kiszállítási státusz követőszámmal; készletkorrekciók okkóddal; visszáru visszakészletezés/leírás döntéssel; periodikus leltár-egyeztetés; utánvét-elszámolás a Társaság felé. Kombinált ajánlatnál ezek a folyamok élesben kerülnek bemutatásra; megosztott odaítélésnél az integráció koordinációját a 2. rész szállítója vezeti.

B.4 Havi könyvelési zárás --- elvárt struktúra

A Társaság könyvelése havonta, egységenként mozgásnem szerinti összesítést kap mennyiség · bruttó érték · könyvelt beszerzési érték · árrés % oszlopokkal, az alábbi tartalommal: szállítói bevételezések; átadás-átvétel saját egységekkel; egyéb készletnövekedés/-csökkenés; gyártási/csomag-összeállítási mozgások; selejtezés/leírás; beszerzésiérték-korrekciók; számlázott web-értékesítés (termék árréssel; szolgáltatás/szállítás külön). Az új platformnak ezt a tartalmat piaconként (HU/CZ/SK) és összesítve kell reprodukálnia, kiegészítve a hó végi, beszerzési áras készletértékkel és a szállítói számlákkal szembeni kontrollpontként használható bevételezési kimutatással. Az ERP jelenleg FIFO beszerzési árat könyvel; az új felállás készletértékelési módszere a Társaság könyvelésével kerül egyeztetésre (fődokumentum 5.1.4).