Manuálna úprava predajnej ceny (kompenzácia dodávateľa)

Načo táto funkcia je#

Klasická situácia: spustíte na produkt zľavovú akciu a dodávateľ vám zľavu kompenzuje dobropisom (preto, aby ste promo neplatili vy, ale on). Margly o tom ale z importu nevie nič — vidí len zníženú predajnú cenu v e-shopovom feede, dobropis od dodávateľa nie. Výsledok: marža v Margly sa prudko prepadá, vyzerá to, že predávate pod nákupnou cenou, a Plán rastu alebo AI Poradca začnú odporúčať „prestať tento produkt predávať".

Manuálna úprava predajnej ceny je riešenie. Poviete Margly: „od 1. marca do 31. marca ber pre výpočet marže namiesto aktuálnej predajky pôvodnú cenu z cenníka — zľavu mi kompenzuje dodávateľ." Margly v danom okne prepočíta marže z tej vami zadanej ceny a v ostatných obdobiach berie normálne cenu z importu.

Kto úpravu môže nastaviť#

Tlačidlo „Upraviť cenu" vedľa marže produktu vidí Vlastník a Editor. Hosť z partnerskej firmy (cez Zdieľanie prístupu medzi účtami) má povolené úpravy dát, ale toto konkrétne tlačidlo v tabuľke produktov je v aktuálnej verzii Margly skryté pre hostí (na úrovni servera by úprava inak prešla — UI ju jednoducho nezobrazuje).

Kde úpravu nájdete#

1. 1

   Otvorte sekciu Produkty

   V ľavom menu Produkty. Tabuľka má stĺpce ABC, Kód, Názov, Množstvo, Obrat (s/bez DPH podľa vášho nastavenia), Podiel %, Marža, Marža %, Storno %, Nákupná cena, Sadzba DPH, Zákazníci.

2. 2

   Nájdite riadok konkrétneho produktu

   Hore v karte je filter Kategória, prepínač ABC (Všetko / A / B / C), prepínač Marža (Všetko / ≥ 30 % / 10–30 % / < 10 % / „Chýba nákupná cena") a vyhľadávacie pole „Hľadať kód, názov…".

3. 3

   Kliknite odkaz Upraviť cenu pod maržou

   Pri každom produkte je pod hodnotou marže malý odkaz „Upraviť cenu" (ikona zľavenky / „ticket percent"). Otvorí dialóg „Manuálna úprava predajnej ceny" s kódom a názvom produktu v podtitulku.

Vyplnenie formulára#

Dialóg obsahuje vysvetľujúci banner (zbaliteľný — zapamätá si vaše rozhodnutie v prehliadači), potom príklad (vidíte ho len do prvej vytvorenej úpravy) a nižšie samotný formulár „Pridať novú úpravu".

Polia, ktoré vyplníte#

Náhľad výpočtu#

Pod formulárom je živý „Náhľad výpočtu" — akonáhle začnete vyplňovať cenu, Margly v reálnom čase ukáže:

• Vaše zadanie — cena bez DPH aj s DPH (zvýraznená je tá, ktorú ste vyplnili).
• Aktuálna cena z importu — čo Margly aktuálne vidí v dátach z e-shopu.
• Marža pred úpravou — čo by Margly počítal bez vašej úpravy. Červeno, pokiaľ je záporná; žlto pod 10 %; zeleno od 10 % vyššie.
• Marža po úprave — čo bude Margly počítať v promo okne. Farby rovnaké.
• Rozdiel — koľko Kč/ks (alebo jednotiek vašej meny) robí zmena v marži.

Keď cena dáva nezmysel (napr. preklep o nulu), v náhľade to hneď uvidíte ešte pred uložením.

Uloženie#

Klikom na „Uložiť úpravu" Margly:

1. Vloží úpravu do databázy (oba stĺpce s DPH aj bez DPH, sadzba DPH, poznámka, vaše používateľské ID a čas).
2. Synchrónne prepočíta marže všetkých objednávok toho produktu v zadanom okne — žiadne čakanie, dashboard a tabuľka produktov hneď ukazujú nové hodnoty.
3. Aktualizuje denormalizovaný snapshot ziskovosti produktov (na pozadí).
4. Invaliduje cache dashboardu — ďalšie načítanie už ukáže nové marže.

Po uložení uvidíte hlášku „Úprava uložená. Marža produktu bola prepočítaná."

Existujúce úpravy a ich stavy#

Keď na produkt už máte uloženú úpravu (alebo aj viac), v dialógu nad formulárom uvidíte sekciu „Existujúce úpravy". Každý záznam má stavový štítok:

• Aktívna do dátum (modrý štítok) — úprava práve platí, dashboard z nej počíta marže.
• Začne dátum (žltý štítok) — naplánovaná na budúcnosť, ešte nemá vplyv na súčasné výpočty.
• Skončilo dátum (šedý štítok) — historická úprava. Dashboard z nej stále reprodukuje marže v jej pôvodnom okne (preto sa nemaže automaticky).

Pri každom zázname vidíte obdobie, cenu (zvýraznenú v aktívnom režime zobrazenia, druhú v zátvorke), poznámku, dátum a autora vytvorenia. Vpravo je ikona koša pre zmazanie.

Pravidlá pre obdobie#

• Koniec musí byť striktne po začiatku (kontrola na klientovi aj serveri — inak hláška „Neplatné obdobie úpravy. Dátum konca musí byť po dátume začiatku.").
• Pre jeden produkt sa obdobie nesmie prekrývať. Pokiaľ skúsite uložiť úpravu, ktorej okno zasahuje do už existujúcej úpravy rovnakého produktu, Margly vráti hlášku „Zadané obdobie sa prekrýva s inou existujúcou úpravou pre tento produkt." Toto pravidlo stráži databáza, takže sa nedá obísť.
• Cena musí byť ≥ 0, sadzba DPH v rozmedzí 0–30 %.

Keď máte aktívnu úpravu, ale dodávateľ medzitým zmenil cenník v e-shope#

V dialógu uvidíte modrý informačný prúžok:

Aktuálna cena z importu je X. Vaša úprava (Y) má prednosť vo výpočte marže do dátumu konca. Importy váš záznam neprepíšu.

Margly tým hovorí: cena v e-shope sa zmenila (napr. po skončení promo už máte v cenníku inú hodnotu), ale vaša úprava má v rámci svojho obdobia prednosť. Žiadne prekvapenie, žiadny tichý prepis.

Zmazanie úpravy#

Klikom na ikonu koša pri zázname sa objaví vnútorný potvrdzovací rámček s textom podľa stavu úpravy:

Po zmazaní Margly znova spustí prepočet marží (synchrónne) a invaliduje cache dashboardu. Toast hláška potvrdí, čo sa stalo.

Ako sa úprava prejaví v dashboarde#

Keď máte aktívnu úpravu, uvidíte v Margly tieto vizuálne stopy:

• V tabuľke Produkty vedľa marže produktu sa objaví modrý štítok „Manuálna cena" a pod maržou monospace text „Z upravenej ceny: X". Najazdenie myšou ukáže tooltip: „Marža produktu sa počíta z vami zadanej upravenej predajnej ceny (X) namiesto z aktuálnej ceny v importe (Y). Kompenzácia od dodávateľa za poskytnutú zľavu. Platnosť: od – do."
• Keď úprava skončila, ale historicky ovplyvnila marže vo vybranom období dashboardu, štítok je šedý: „Promo v období" (s informačným tooltipom).
• V sekcii Marže (ľavé menu → Marže, ikona trend up) sa pod riadkom COGS rozbalí mini-rozpad „Surové COGS", „Promo kompenzácia dodávateľa" (s mínusovou sumou v zelenej) a „Efektívne COGS po kompenzácii" (kurzívou). Pod tým malá poznámka s odkazom späť do Produktov.
• AI Poradca používa pre analýzy marží tie isté RPC, ktoré úpravu zohľadňujú (get_margin_cascade vracia už efektívne COGS, get_top_products načítava selling_price_uplift_per_unit z položiek objednávok). Odporúčania a rebríčky produktov v Poradcovi teda nebudú v promo mesiaci skreslené.

Čo úprava NErobí (a prečo)#

• Nemení tržby. Zákazníci zaplatili zlacnenú cenu, to je fakt. Účtovne aj v reportoch tržieb to zostáva.
• Neprepisuje dáta z e-shopu. Šet (Shoptet / Shopify / Upgates / CSV feedy) o tabuľke úprav vôbec nevie — synchronizácia produktov nikdy nezapíše ani neprečíta z product_selling_price_overrides. Je to čisto „nadstavbová vrstva", ktorú kontroluje merchant.
• Nezmaže sa sama po skončení promo. Historické záznamy zostávajú, aby šli presne reprodukovať historické marže (na hodnoty z okamihu, kedy ich dashboard alebo Poradca videl).
• Neovplyvňuje COGS mimo nastaveného okna. Mimo valid_from – valid_to Margly berie normálne aktuálnu nákupnú cenu aj predajnú cenu z importu.
• Neprepočítava iba produkty bez úprav — keď nemáte úpravu, nič sa nemení (nemusíte sa báť, že by funkcia „zanechala odtlačok" na ostatných produktoch).

Bezpečné rozsahy a limity#

• Rate limit: 30 uložení a 30 zmazaní za 5 minút na účet (každá akcia má vlastné samostatné okno — POST a DELETE sa nepočítajú dohromady). Väčšie dávky rozložte do času.
• Poznámka max 500 znakov.
• Sadzba DPH 0–30 %, cena ≥ 0 (validácia klient aj server).
• Cena uložená s presnosťou na 4 desatinné miesta v databáze (zobrazenie sa zaokrúhľuje na 2).
• Časové pásmo úprav je tenant-wide — okno sa porovnáva s dátumom objednávky prevedeným do časového pásma vášho účtu (odvodené z fakturačnej krajiny).

Časté chyby a čo s nimi#

Čo ďalej#

• Pochopenie marží — ako Margly počíta hrubú maržu, CM1 a čistú maržu
• Nastavenie DPH — ako prepínač zobrazovania ovplyvňuje pole „Zadávate cenu" v dialógu úpravy
• Aktualizácia dát — kedy sa nová úprava premietne, pokiaľ dáta ešte nepritečené