Árajánlat

LS2 termékek — ár-stabilizálás és élő készlet-szinkron

Az Önök két visszajelzésére adott célzott megoldás: az LS2 termékek HUF árait stabilizáljuk a Factory Motors boltban (megszűnik az árfolyam-vezérelt napi sodródás, az árak pontosan az LS2 forrás-árakat tükrözik), és automatikus készlet-szinkront építünk az LS2 hivatalos készletadat-API-jához kapcsolódva.

Egy mondatban

Két dolgot szállítunk: az LS2 termékek HUF árait stabilizáljuk a Factory Motors boltban (a Shopify Hungary piac jelenleg napi árfolyam + felár + kerekítés alapján számolja a HUF árat — ezt a sodródást szüntetjük meg az LS2 SKU-knál), és automatikus készlet-szinkront építünk az LS2 hivatalos készletadat-API-jához kapcsolódva.

A komponens · Egyszeri stabilizálás

Ár-stabilizálás (LS2 fix HUF árak a Hungary katalógusban)

Az LS2 SKU-knál fix HUF árakat írunk be a Hungary piaci katalógusba. A fix ár felülírja a dinamikus árfolyam-átváltást, felárat és kerekítést kizárólag az LS2 termékeknél; a katalógus összes többi termékére semmi hatása nincs. Az EU és egyéb piacokon (pl. eurós árazás) semmi nem változik: a termék szintű EUR árak és azok piaci szabályai érintetlenek maradnak.

B komponens · Automatikus

Készlet-szinkron API-n

Háttér-rendszer szinkronizálja az LS2 készletet a Shopifyba az LS2 hivatalos készletadat-API-ján keresztül. Idempotens, naplózott, hibajelzéssel — óránkénti ütemezéssel (módosítható) és manuális futtatási lehetőséggel.

Hogyan néz ki a megoldás

A két komponens ugyanazokhoz a forrásokhoz kapcsolódik (LS2 oldali készletnyilvántartó rendszer + Factory Motors Shopify bolt), de eltérő céllal és üzemmódban:

A komponens Egyszeri stabilizálás

Ár-stabilizálás — fix HUF árak a Hungary katalógusban

Forrás LS2 forrás-árak (a normalizált adat, már a rendszerünkben)
↓
Eszköz Fix HUF ár-felülírások (1605 SKU) — API-n keresztül
↓ Egyszeri írás a meglévő Hungary katalógusba
Cél Factory Motors → Hungary katalógus LS2 SKU-k (fix HUF, drift-mentes)

A fix árak felülírják a piac szintű automatikus átváltást, felárat és kerekítést — kizárólag az LS2 SKU-knál a Hungary piacon. A Hungary katalógus többi terméke (más márkák) változatlanul fut a jelenlegi dinamikus szabályok szerint, még ha azokhoz is tartoznának felülírások. Az EU és egyéb piacok a termék szintű EUR árakat és az adott piac szabályait használják — az írás erre nincs hatással.

B komponens Automatikus

Készlet-szinkron

Forrás LS2 hivatalos készletadat-API (Full-Gas)
↓
Háttér-szolgáltatás Python szinkron, idempotens, naplózott — óránkénti GitHub Actions cron
↓
Cél Factory Motors → Készletszintek a Shopifyban

Csak a tényleges készletváltozást írjuk át; hiba esetén automatikus jelzés (GitHub issue). A cron gyakorisága konfigurálható a repóban; manuális futtatás bármikor elindítható a GitHub Actions felületről.

A komponens — Ár-stabilizálás

A megoldandó probléma

A Factory Motors bolt EUR-bázisú, ezt a Shopify nem teszi lehetővé módosítani. A magyar piac jelenleg a beépített napi árfolyam × 1,02 felár → 100 Ft-ra kerekítés szabályt használja, ami azt jelenti, hogy az LS2 termékek HUF ára az árfolyam mozgásával együtt naponta változik. Ettől csúsznak el az árak az LS2 forrás-árakhoz képest.

Hogyan oldjuk meg

  1. Kinyerjük az aktuális, pontos HUF árakat az LS2 forrás-oldaláról (ugyanazzal a megoldással, amivel az első projektben). Ez 1605 sort jelent, mindegyik SKU-hoz egy fix HUF árral.
  2. A fix ár-felülírásokat a Shopify Admin GraphQL API-n keresztül írjuk be a Hungary katalógusba. Ezzel a Shopify az LS2 SKU-knál a fix HUF árat használja, és figyelmen kívül hagyja a piac szintű árfolyam-átváltást, felárat, kerekítést. A Hungary katalógus többi terméke érintetlen marad.
  3. Termékszintű ellenőrzés (5–10 SKU spot-check), hogy a factorymotors.hu oldalon a HUF ár pontosan megegyezik az LS2 forrás-árával — drift nélkül.
  4. Másik 5–10 nem-LS2 termék ellenőrzése, hogy bizonyítja: a többi márka árazása változatlanul, a meglévő szabályok szerint fut.

Mit szállítunk

  • Fix HUF ár-felülírások beírva a Hungary katalógusba, ellenőrzött állapotban (1605 LS2 SKU).
  • Dokumentált eljárást arra az esetre, ha az LS2 a jövőben (várhatóan ritkán) változtatna az árain — az ár-felülírások ugyanezzel az eljárással újragenerálhatók és újra alkalmazhatók.
  • Visszafordítási szkript (ls2-sync clear-price-overrides): egy paranccsal eltávolítja az összes LS2 ár-felülírást a Hungary katalógusból — csak az LS2 SKU-kat érinti, a többi termék érintetlen marad.

Miért ez a megoldás a megfelelő

A fix ár-felülírások kizárólag az LS2 SKU-kat érintik a Hungary piacon — a bolt többi terméke érintetlen marad, és nem kell új katalógust létrehozni (a Basic csomag korlátait sem nyomja meg). Az EU és egyéb piacokon a termék szintű EUR árazás és a piaci szabályok változatlanok. Nincs mellékhatás és nincs külső szolgáltatás-függőség. Visszafordítás: egyetlen CLI-parancs, API-n keresztül, kizárólag az LS2 SKU-kra.

B komponens — Készlet-szinkron

Indító lépés — felfedezés és validálás

Az API hozzáférés megérkezésekor első körben nem a kódolással kezdünk, hanem egy gyors, célzott felmérést végzünk: átolvassuk a kapott dokumentációt, készítünk néhány próbahívást, és pontosan feltérképezzük az adatszerkezetet, mielőtt a teljes szinkron logikát megírnánk.

  • Az API dokumentáció áttekintése, a használható végpontok és a hitelesítés pontos megértése.
  • Próbahívások néhány LS2 cikkszámra: validáljuk, hogy a kapott válasz tartalmaz-e mindent, amire a szinkronnak szüksége van (cikkszám-egyezés, készlet-mező értelmezése, többes raktár-kezelés stb.).
  • Eddigi feltételezéseink — amelyek közvetett forrásokból származnak — konkrét válasz-mintán igazolva.
  • Ha a feltérképezés során váratlan részlet merül fel (pl. eltérő cikkszám-formátum, több raktár-szempontú készlet), visszajelezzük és közösen rögzítjük a kezelését a fejlesztés előtt.

Ez tipikusan a fejlesztés első fél napja. Pici időbefektetés, ami sokat ér: így nem feltételezések alapján építünk, hanem a valódi adatra.

Hogyan működik

  1. A háttér-szolgáltatás óránként (alapbeállítás) lekérdezi az LS2 aktuális készletét az LS2 hivatalos készletadat-API-ján keresztül.
  2. Összehasonlítja a Shopifyban szereplő készletszintekkel — csak azokat a SKU-kat írja át, amelyeknél tényleges változás történt.
  3. A Shopify API-n keresztül frissíti a készletet (inventorySetQuantities) — pontosan egy LS2-hez rendelt készlethelyen, hogy más beszállítók készletét véletlenül se érintse.
  4. Minden futást naplóz: időpont, érintett SKU-k, változások. Ha bármi hiba van (LS2 API leáll, Shopify token lejár, stb.), automatikus jelzést küld.

Üzemeltetési alapelvek

  • Idempotens — kétszer lefutva nem okoz duplikált változást vagy churn-t a Shopifyban.
  • Csak a tényleges változásokat írja — nem terheli sem az LS2, sem a Shopify API-t fölöslegesen.
  • Automatikus újrapróbálkozás — ha egy futás átmeneti hiba miatt nem sikerül, a következő óránkénti futás automatikusan megpróbálja újra.
  • Audit napló — minden futás SKU-szinten dokumentált, visszakereshető (GitHub Actions naplókban, alapértelmezetten 90 napig megőrizve).
  • Hibajelzés — ha egy futás nem sikerül, GitHub issue nyílik (naplókkal és futás-azonosítóval); a GitHub automatikusan e-mail értesítést küld a repó tulajdonosának. A futásnaplók 90 napig megőrzöttek.

Mit szállítunk

  • Python szinkron-szolgáltatás (LS2 oldali API kliens + Shopify GraphQL kliens + diff-logika).
  • Szükséges infrastruktúra: egyedi Shopify app (az API hozzáféréshez), GitHub Actions ütemezés — nincs Factory Motors-oldali hosting, nincs platform-díj.
  • Üzemeltetési és átadási dokumentáció (mit kell csinálni, ha hiba van; hogyan lehet manuálisan futtatni; hogyan lehet leállítani szezonális karbantartáskor).
  • Automatizált tesztek a kritikus szinkron-logikára.

Mi kell az induláshoz

A munkát az alábbi tétel megérkezésével azonnal el tudjuk kezdeni:

  1. API hozzáférés a Full-Gas Kft.-től az LS2 készletadat-rendszerhez. Már egyeztetés alatt van, a megérkezését hamarosan várjuk. Ezzel párhuzamosan a Shopify telepítő link fogadásához szükséges tulajdonosi email cím már rendelkezésünkre áll, így amint a hozzáférés megvan, a szinkron-app telepítése egyetlen kattintással megtörténhet.

Az A komponens azonnal indítható

Az ár-stabilizálás kizárólag a már nálunk lévő termékadatokra és a Shopify app telepítésére támaszkodik — a Full-Gas API hozzáférés megérkezésére nem kell várnunk. Amint a telepítő linket az áruház tulajdonosa fogadja (egy kattintás), az A komponens azonnal futtatható.

Becsült díj és időigény

Várható átfutási idő: az API hozzáférés megérkezésétől számított 10 munkanapon belül.

Csomag elem Mit tartalmaz Becsült időigény
Indító lépés — felfedezés és validálás LS2 API dokumentáció áttekintése, mintahívások, adatszerkezet és cikkszám-egyezés rögzítése. 2 — 5 óra
A — Ár-stabilizálás
Fix HUF árak a meglévő Hungary katalógusba		 Fix HUF ár-felülírások előállítása forrásadatból (1605 SKU), API-n keresztüli beírás a Hungary katalógusba, validálás, visszafordítási szkript, eljárás dokumentálása. 5 — 8 óra
B — Készlet-szinkron + infrastruktúra LS2 API kliens, ütemezett szinkron (GitHub Actions), idempotencia, naplózás, hibajelzés, egyedi Shopify app + infrastruktúra, tesztek, átadási dokumentáció. 18 — 22 óra
Becsült összes — A + B + indító lépés 25 — 35 óra

Ajánlatunk

A két komponensre, egyetlen, összefüggő projektként:

380 000 Ft

Egyszeri fix fejlesztési díj. Nincs havi platform-díj, nincs szoftverlicensz, nincs külső SaaS előfizetés. A teljes rendszer a Factory Motors tulajdonába kerül.

A fix díj a fenti scope-ra és a jelenleg ismert feltételekre vonatkozik.

Opcionális — karbantartás és jövőbeli módosítások

A rendszer átadása után az alapvető működés automatikus, és nem igényel napi felügyeletet. Ha a jövőben bármilyen módosításra van szükség (pl. az LS2 árainak ismételt változása miatti újrakalkulálás, vagy az LS2/Shopify rendszerek jövőbeli változása miatti kódmódosítás), ezeket igény szerint, 16 000 Ft / óra díjon végezzük el.

Mikor mondjuk, hogy „kész"

A komponens — kész

Ár-stabilizálás ellenőrzött szállítás

  • Fix HUF ár-felülírások beírva a Hungary katalógusba (1605 LS2 SKU), ellenőrzött és dokumentált állapotban.
  • 5–10 LS2 termék manuális spot-check a factorymotors.hu oldalon (incognito), az ár pontosan megegyezik az LS2 forrás-árával.
  • 5–10 nem-LS2 termék manuális spot-check, az ár változatlan (a meglévő szabályok szerint fut).
  • Futási útmutató átadva későbbi újrafutáshoz (ha az LS2 valaha változtat az árain).
  • Visszafordítási recept dokumentálva.
B komponens — kész

Készlet-szinkron éles üzem

  • A Shopify app telepítve a Factory Motors boltjában; az óránkénti cron aktív és fut.
  • Smoke teszt: kézzel állítunk egy LS2 termék készletét az LS2 forrás-rendszerben, és igazoljuk, hogy a következő szinkron-ablakban a Shopifyban is megjelenik a változás.
  • Idempotencia teszt: a futás kétszer egymás után nem okoz változást, ha az LS2 oldalon semmi sem változott közben.
  • Hibajelzés tesztelve — szándékosan kiváltunk egy hibát, a GitHub issue létrejön.
  • Átadási dokumentáció átadva (üzemeltetési útmutató, manuális futtatás GitHub Actionsből, leállítás, monitoring).

Kockázatok és kölcsönös felelősségek

Mi a mi felelősségünk

  • A kód minőségéért, teszteléséért, dokumentálásáért, a vállalt határidőért.
  • A szinkron-app megfelelő működéséért az átadás után 30 napig — ha bármi hiba van, díjmentesen javítjuk.
  • Az adatkezelési biztonságért: API kulcsokat soha nem tárolunk a kódban, csak titkosított környezeti változókban; a forráskód nyilvános repóba nem kerül.

Mi az Önök felelőssége

  • A Shopify telepítő linkre rákattintás a tulajdonosi fiókkal (egy-kattintás).
  • Ha az LS2 oldal API-elérése megszűnik, vagy a Full-Gas leállítja a hozzáférést, a szinkron működése értelemszerűen megszakad — ezt jelezzük, és közösen rendezzük az új alapokat.
  • Karbantartás nélkül a hibák észlelése és jelzése automatikus, de az esetleges Shopify- vagy LS2-oldali változások kezelése (pl. új API hozzáférés, beállítás-módosítás) az Önök oldalán marad, vagy igény szerint mi vesszük át 16 000 Ft / óra díjon.

Mi a következő lépés

Az ajánlat elfogadása után a következő sorrendben tudunk haladni:

  1. Ajánlat formális elfogadása. Email-ben írásos megerősítés elegendő. Ezzel a 380 000 Ft fix díj rögzítve van.
  2. API hozzáférés megérkezése. Az emailes kérés kiküldésre került; amint megérkezik a válasz, onnantól indul a 25 — 35 órás fejlesztési munka.
  3. Felfedezés és validálás. API dokumentáció áttekintése, néhány próbahívás, az adatszerkezet és a cikkszám-egyezés megerősítése. Ha váratlan részlet merül fel, azt a fejlesztés megkezdése előtt egyeztetjük.
  4. Fejlesztés és tesztelés. A fejlesztés alatt heti egyszer tájékoztatjuk Önöket az aktuális állapotról.
  5. Átadás és élesítés. Shopify alkalmazás telepítése az admin fiókkal, smoke teszt mindkét komponensre, dokumentáció átadása, óránkénti sikeres futás megfigyelése. Ezután a rendszer önmagát üzemelteti.

Készen állunk az indulásra

Amint az API hozzáférés megérkezik, a fejlesztést azonnal el tudjuk kezdeni. A javasolt rendszer egyszerű, célzott, és pontosan az Önök igényét tükrözi. Bármilyen kérdés esetén állunk rendelkezésre.

Ajánlattevő

[Víg Márton, / MV Solutions]

+33780760195

Érvényesség

Ez az ajánlat 30 napig érvényes a kiállítás dátumától. A díj egyszeri, fix; a megadott időkeret az API hozzáférés megérkezésétől számít.