Kuki

Internetová televize Kuki je online televize od společnosti Netbox, která umí streamovat takřka jakýkoliv videoobsah v HD kvalitě do vašeho tabletu, telefonu, televize a dalších zařízení. Kuki aplikace nabízí i možnost automatického nahrávání seriálů z českých televizí a to až půl roku nazpět, nebo pohodlnou půjčovnu filmu. Kuki lze sledovat na set-top boxech, AndroidTV, vybraných TV nebo přes webový prohlížeč.

1. Pojmy

Pojem	Popis
Kuki ID	Sada přihlašovacích údajů zákazníka do Kuki a do systémů umožňujících sledování Kuki. V Mango je Kuki ID reprezentováno parametry zákazníka 'Kuki - přihlašovací jméno' a 'Kuki - heslo'.
Zákazník	Je základní entitou Kuki, odpovídá zákazníkovi v Mango. Kód zákazníka je v obou systémech shodný, např. 282884.
Hlavní smlouva	Představuje jednu ze základních služeb 'Kuki start', 'Kuki menší' a 'Kuki větší'. Odpovídá bázovým službám Mango. Číslo hlavní smlouvy v Kuki se skládá z ID zákazníka z Mango a ID aktivní bázové služby z Mango, např. 282884-948334.
Vedlejší smlouva	Představuje jeden z volitelných balíčků Kuki. Odpovídá závislým službám Mango. Číslo vedlejší smlouvy v Kuki se skládá z ID zákazníka z Mango, ID aktivní bázové služby z Mango a pořadového čísla, např. 282884-948334-0001. Více o pořadovém čísle viz parametr KUKI - id balíčku.

2. Obecný popis

Televize Kuki je v Mango reprezentována zařízením třídy Kuki proxy ( Více info v kapitole Kuki proxy). Aktualizace služeb mezi Mango a Kuki se provádí pomocí virtuálních zařízení Kuki klient ( Více info v kapitole Kuki klient). Tato zařízení jsou v Mango napojena přímo na Kuki proxy. Pokud zákazník využívá set-top box, tak musí být evidovaný i v Mango. Je reprezentován zařízením třídy Kuki STB ( Více info v kapitole Kuki STB). Set-top box nemusí být ve stromové struktuře zařízení umístěn přímo pod Kuki proxy, ale pomocí parametru má na něho vazbu. Pro vlastní TV služby je v Mango využitá třída služby IPTV. Mango umožňuje nadefinovat jak bázové, tak i závislé služby ( Více info v kapitole Služby v Mango) a vytvořit mezi nimi návaznosti. Ty pak umožňují v jednom kroku aktivovat celé balíčky služeb tak, jak je používá Kuki.

Portál Kuki nabízí administrátorské rozhraní, které máte k dispozici pro případnou kontrolu aktivovaných televizních služeb. Pro vaše zákazníky je k dispozici Moje Kuki s přihlašovacími údaji odpovídajícími Kuki ID.

Změny z Kuki do Mango se propisují pouze při změnách na Moje Kuki. Změny přes administrátorské rozhraní nelze provádět. Řízení Kuki se ovládá výhradně přes Mango.

Službu Kuki lze používat v lokaci, ve které jsou povoleny bytové jednotky.

Pokud byste chtěli rozhraní Kuki v Mango využívat, obraťte se na obchodníka Mango. Vlastní implementaci následně provede zákaznická podpora Mango.

3. Co pro vás připraví zákaznická podpora Mango?

Od zákaznické podpory budete mít v Mango k dispozici:

• povolené třídy zařízení Kuki proxy, Kuki klient a Kuki STB
• vytvořenou Kuki proxy
• povolené Kuki parametry definic služeb - KUKI - id balíčku a KUKI - kdo aktivoval, KUKI - kód služby
• nadefinované parametry zákazníka Kuki - přihlašovací jméno a Kuki - heslo pro uložení přístupových údajů zákazníků na portál Kuki
• nadefinované skupiny služeb 'Kuki - kanály navíc', 'Kuki menší/větší - doplňkové služby' a 'Kuki start - doplňkové služby' pro vytvoření návazností mezi bázovými a závislými službami
• nadefinované bázové i závislé Kuki služby včetně nastavení návazností mezi nimi
• nadefinované parametry pro služby s volitelnými kanály ('Kuki Navíc kanál', 'Kuki Navíc 5') - KUKI - umožňuje výběr kanálu a KUKI - kód zvoleného kanálu.

Pokud již službu Kuki využíváte (máme v Kuki zákazníky), tak po doplnění (viz kapitola 4) zákaznická podpora zajistí:

• předání IP adresy Dx serveru do Kuki (pro povolení přístupu k API Kuki) + IP adresy 91.227.7.6
• export z Mango do Kuki (viz kapitola 1. - nastavují v Kuki):
  • Zákazník: nahrazení kódů subjektu v Kuki.
  • Hlavní smlouva: nahrazení kódu hlavní služby (v Kuki) za nové ID aktivní bázové služby z Mango, např. 282884-948334.
  • Vedlejší smlouva: nahrazení kódu vedlejší služby (v Kuki) za nové ID aktivní bázové služby z Mango a pořadového čísla, např. 282884-948334-0001.
• export z Kuki do Mango (viz kapitola 1. - nastavuje zákaznická podpora Mango):
  • Kuki ID: Kuki - přihlašovací jméno'. Kuki VM si hlídá unikátnost Kuki ID, což historicky bývala e-mailová adresa, ale kvůli GDPR je naopak žádoucí, aby to byl obecný alfanumerický řetězec. Pro samotné sledování televize na STB není Kuki ID nezbytné. Zákazník může mít v Kuki více Kuki ID. Všechny jsou platné. Mango ale podporuje pouze jedno Kuki ID. Pokud existuje někdo, kdo jich má více, je potřeba domluvit ponechání jen jednoho Kuki ID.
• • KUKI - id balíčku: pořadová čísla balíčků.
  • Kuki STB: MAC a SN (dle existujících zařízení v Kuki).. Zařízení budou k dispozici v modulu
    KONCOVÁ ZAŘÍZENÍ
    .

4. Co musíte provést vy?

• zkontrolovat definici Kuki služeb, včetně cen a předdefinovaných návazností, zda vše odpovídá vašemu obchodnímu modelu poskytování služeb Kuki
• Pokud NEMÁTE v Kuki zákazníky (se službou začínáte):
  • nastavit přístupové údaje na API Kuki formou parametrů u zařízení třídy Kuki proxy
• Pokud MÁTE v Kuki zákazníky (službu již využíváte):
  • aktivovat v Mango zákazníky (pokud už neexistují) a veškeré služby stejně, jak máte v Kuki. V Kuki neexistuje dostatek informací pro automatický import zákazníků do Mango.
  • nastavit přístupové údaje na API Kuki formou parametrů u zařízení třídy Kuki proxy (proveďte, až zákaznická podpora zajistí propojení údajů mezi Mango a Kuki, viz druhá část v kapitole 3)
• Pokud využíváte bytové jednotky:
  • V modulu
    SKUPINY PRODUKTŮ/SLUŽEB
    vytvořit skupinu typu 'dostupnost na jednotce' s názvem např. KUKI.
  • V modulu
    KONCOVÁ ZAŘÍZENÍ
    nastavit dostupnosti na jednotkách. Jednotlivě lze provést akcí "Editovat zařízení" nebo jednotlivě/hromadně akcí "Hromadná změna parametrů zařízení".
• Pokud prodáváte/pronajímáte Kuki STB:
  • postupovat dle kapitoly Další služby

5. Zákazníci v Mango

Zákazníky neaktivujte manuálně přes WM Kuki!

Před aktivací první služby nastavte pro Kuki ID hodnoty u parametrů zákazníka (modul

ZÁKAZNÍCI

, tabulka Parametry zákazníka):

• 'Kuki - přihlašovací jméno' (e-mail nebo alfanumerický řetězec), pro uvedení hodnoty v PDF šabloně smluvního dokumentu použijte proměnnou {CT_PARAM.kuki_login}. V textové šabloně typu "Text e-mailu (uživatelský)" použijte proměnnou %CT_PARAM.kuki_login.
• 'Kuki - heslo' (doporučujeme zadávat např. číslo smlouvy), pro uvedení hodnoty v šabloně smluvního dokumentu použijte proměnnou {CT_PARAM.kuki_password}. V textové šabloně typu "Text e-mailu (uživatelský)" použijte proměnnou %CT_PARAM.kuki_password.

Zákazník nemůže v Kuki měnit heslo a nejdou ani z Kuki zpětně zjistit.

Pokud nastavíte parametry pro Kuki ID pozdě, tak na vm.kuki.cz nevytvářejte Kuki ID manuálně! Postupujte tak, že vyplníte parametry dodatečně a provedete u zákazníka aktualizaci zařízení třídy Kuki klient.

6. Služby v Mango

Služby neaktivujte manuálně přes WM Kuki!

6.1. Jak Kuki účtuje služby

Kuki v rámci velkoobchodních služeb (pro Mango partnery) účtuje vedlejší služby následovně:

• aktivace 1. dne v měsíci: plná výše
• aktivace od 2. dne v měsíci až do posledního dne měsíce: vždy 1/2 měsíční ceny

6.2. Jaké periody používat pro Kuki služby

V definici služby používejte jako periodu pro billing výhradně kalendářní měsíc, případně plovoucí měsíc (používáte-li Úhrada služeb předplatným uniCredit dle splatnosti předpisu). Pokud chcete využívat obě periody, tak nastavte volbu "Perioda volená při aktivaci". Při aktivaci Kuki služeb si ale dávejte pozor, abyste nenastavili jinou periodu než kalendářní/plovoucí měsíc. Proč? Zákazník si může doaktivovat vedlejší služby (balíčky) ze samoobsluhy kdykoliv (vedlejší služby musí být proto bez oddělené aktivace od zapojení). Tyto balíčky jsou v Mango reprezentovány závislými službami a musí mít stejné periody a období jako bázové služby. Tím nedojde k rozhození DUZP a splatnosti. Tzn. že všechny služby budou placeny stejně a budou na jednom dokladu (pokud je generování dokladů povoleno v billing plánu). Pokud použijete plovoucí měsíc u služeb mimo Úhrada služeb předplatným uniCredit dle splatnosti předpisu, tak je potřeba počítat s tím, že dojde k rozhození DUZP a splatnosti a bude to mít vliv na faktury... Do probíhajícího období se proto nezasahuje. Mango najde nejbližší další předpis bázové služby a nastaví se podle něho datum 'Platit od' u závislé služby (dokoupeného balíčku). Tím také nedojde k zasáhnutí do aktuálního období, na kterou můžete mít vystavenou fakturu/inkaso/sipo. Platí výjimka, že 'Placení od' můžete mít v aktuálním období, pokud máte Billing plán nastaven s DUZP na posledního dne periody. U uniCreditu je DUZP vždy na začátku periody a splatnost je záměrně o den dřív, aby mohlo dojít rovnou k zablokování a čeká se na zaplacení. Posunem počátku periody dojde k tomu, že aktuální část neúplné periody je zdarma. Peníze od zákazníka získáte nazpět po ukončení závislé služby, kdy se nastaví platit do podle konce periody bázové služby. Pokud byste měli jinou periodu, např. roční, tak zákazník bude využívat dokoupené balíčky zdarma a k zaplacení dojde až při následující roční periodě. Při ukončení služby se nastaví placení služby na posl. den následující periody, tzn. že by za službu ještě zaplatil v následujícím roce a ještě k tomu celý rok. To je důvod, proč nelze aktivovat závislé služby k periodám jiným než měsíčním (Mango aktivaci nedovolí).

Provozovateli služby Kuki platíte za služby, nikoliv za zákazníky. Podmínka pro zjišťování množiny služeb, které se s Kuki synchronizují: DNES je mezi Datum aktivace a případným datem konce služby a služba je ve stavu Aktivní nebo Zablokovaná. Datum aktivace služby proto zadávejte až od doby, kdy má služba skutečně běžet (být aktivní), jinak provozovateli služby Kuki budete platit dříve. Je také možné využít funkci 'Oddělit aktivaci a zapojení' a službu aktivujete až v den skutečného zapojení akcí na kartě zákazníka. Pokud je u některých služeb v Kuki povoleno používání N-dní zdarma a je nutné, aby služba z Mango byla do Kuki vložena ihned, tak při aktivaci služby v Mango posuňte datum placení služby o potřebný počet dní.

V tabulce máte přehled změn, které budou v Kuki provedeny dle různých situací.

Situace	Párování zařízení	Nahrané	Rozkoukané	Kuki kino	Poznámka
Změna smlouvy přes webové rozhraní Kuki	Zachováno	Zachováno*	Zachováno*	Zachováno	* Zachováno jen v případě, kdy po změně smlouvy zůstane zachován kanál, u kterého došlo k pořízení záznamu. Přes webové rozhraní se mění jen parametry (poskytnuté kanály,...). Tuto změnu může provést pouze Mango partner, nikoliv koncový zákazník.
Změna kanálů přes samoobsluhu Kuki	Zachováno	Zachováno*	Zachováno*	Zachováno	* Zachováno jen v případě, kdy si zákazník nezrušil kanál, u kterého došlo k pořízení záznamu. Tuto změnu může provést pouze koncový zákazník.
Editace služby přes Mango	Zachováno	Zachováno	Zachováno	Zachováno	Pouhá editace služby (např. změna ceny) nezpůsobí změnu v Kuki.
Změna služby přes Mango na jinou (přechodem nebo ukončením)	Zrušeno**	Zrušeno	Zrušeno	Zrušeno	** Zákazník musí provést nové spárování zařízení.

6.3. Bázové služby v Mango

Bázové služby Mango odpovídají hlavním smlouvám v Kuki. Jejich definici vám v rámci implementace připraví zákaznická podpora. Součástí implementace je i nastavení odpovídajících hodnot parametru KUKI - kód služby.

Pokud si v budoucnu budete vytvářet nové definice služby, tak parametr KUKI - kód služby nevzniká oproti jiným parametrům automaticky. Proto si jej přidejte manuálně.

Bázová služba	Kód Kuki
Kuki start	tvb_sta
Kuki menší	tvb_mensi
Kuki větší	tvb_vetsi

6.4. Závislé služby v Mango

Závislé služby Mango odpovídají vedlejším smlouvám v Kuki. Jejich definici vám v rámci implementace připraví zákaznická podpora. Součástí implementace je i nastavení odpovídajících hodnot parametru KUKI - kód služby a návazností na bázové služby. Návaznosti jsou nadefinované tak, aby odpovídali balíčkům v Kuki. Pokud si zákazník přidá balíček přes Kuki, dojde k přenosu informace do Mango. Smluvní závazek se vyplňuje z Kuki (doba, do kdy nelze balíček ukončit).

Pokud si v budoucnu budete vytvářet nové definice služby, tak parametr KUKI - kód služby nevzniká oproti jiným parametrům automaticky. Proto si jej přidejte manuálně.

Závislá služba	Kód Kuki	Skupina služeb	max. počet k jedné bázové službě
Kuki Navíc kanál	tvc_plus1	Kuki - kanály navíc	999
Kuki Navíc 5	tvc_plus5	Kuki - kanály navíc	1
Kuki Nahrávám 100	rec_100	Kuki menší/větší - doplňkové služby	999
Kuki Nahrávám 50	rec_050	Kuki menší/větší - doplňkové služby	999
Kuki Navíc Cinemax	tvc_cinemax	Kuki menší/větší - doplňkové služby	1
Kuki Navíc HBO balíček	tvc_hbo	Kuki menší/větší - doplňkové služby	1
Kuki Navíc kino plus	svod_kino_plus	Kuki menší/větší - doplňkové služby	1
Kuki Navíc kino	svod_kino	Kuki menší/větší - doplňkové služby	1
Kuki Navíc seriály	ser_3m	Kuki menší/větší - doplňkové služby	1
Kuki Navíc seriály zdarma	ser_3m_free	Kuki menší/větší - doplňkové služby	1
Kuki Navíc telka	lic_kuki	Kuki menší/větší - doplňkové služby, Kuki start - doplňkové služby	2

Při aktivaci balíčku 'Kuki Navíc telka' přidejte i aktivaci služby 'Kuki prodej STB' (jednorázová služba) nebo 'Kuki pronájem STB' (periodická služba).

Parametry aktivních závislých služeb:

Parametr	Význam
KUKI - id balíčku	Slouží pro interní potřebu. Je v něm uloženo pořadové číslo balíčku, které je v Kuki použito pro jeho identifikaci. Pořadové číslo se může vytvářet jak na straně Mango (při aktivaci služby), tak v Kuki, podle toho, kde se balíček aktivoval. Synchronizace s Kuki se provádí po 60 minutách.
KUKI - kdo aktivoval	Nabývá hodnot “mango” (po aktivaci služby) nebo “kuki” (synchronizace po 60 minutách) podle toho, zda byla služba aktivována z Mango nebo ze samoobsluhy Kuki. V současnosti má význam pouze informační.

6.5. Volitelné kanály

U služeb Kuki Navíc kanál, Kuki Navíc 5 je možné nastavit volitelné kanály . V Mango jsou kanály nadefinované jako číselník. K dané aktivní službě je pak možné pomocí parametru KUKI - kód zvoleného kanálu ( zvolit odpovídající počet volitelných kanálů. V Mango se nepředpokládá, že tyto kanály bude uživatel nastavoval, ale že si je bude nastavovat koncový zákazník přímo v rozhraní Kuki. V případě potřeby lze v Mango nastavit kanály v modulu

KARTA ZÁKAZNÍKA

, na záložce "Parametry", v tabulce 'Další parametry produktu nebo služby'.

6.6. Kuki kino (VOD)

Kuki nabízí i videopůjčovnu. Některé filmy jsou zdarma, některé placené. Nabídka je závislá na dané bázové službě a případně volitelných závislých službách Navíc kino a Navíc kino plus. Report v Kuki je k dispozici za předchozí kalendářní měsíc v reportu. Mango tyto reporty stahuje . Pokud report obsahuje nevalidní data (záznam pro uživatele, který není v Mango), tak se report vůbec nestáhne. Data za minulý měsíc jsou k dispozici v modulu

VIDEO ON DEMAND

. Na začátku následujícího měsíce musíte provést uzávěrku těchto služeb. Tím vzniknou interní daňové doklady (předpisy) a následně můžete služby fakturovat.

Pro správné zobrazení na faktuře a na koncových stránkách je potřeba:

• v definici služby u bázových služeb nemít vyplněnou hodnotu položky 'Název pro EU'.
• k definicim služby u bázových služeb nastavit parametr "Název variabilní složky služby", např. s hodnotou TVoD.
• u billing plánu k těmto službám si nechte ověřit, že máte nastavený rozpad předpisu na dvě složky (paušál a var.cena). Díky tomu bude možné zobrazovat doplňkový text ke službě.

Nastavením parametru dojde k aktualizaci zařízení.

6.7. Další služby

Zde uvedené služby nejsou součástí implementace, nastavení je individuální. Služby na prodej/pronájem Kuki STB se definují pod třídou 'Obecná služba' (prodej jako jednorázová služba, pronájem jako periodická služba). Službu lze aktivovat i samostatně, pokud je nastavena jako bázová. Při nastavení jako závislá služba vytvořte v modulu

SKUPINY PRODUKTŮ/SLUŽEB

skupinu typu 'ostatní' s názvem např. 'Kuki zařízení' a přiřaďte služby do této skupiny. U bázových služeb Kuki nastavte pro tuto skupinu návaznost typu 'Návazné volitelné služby' s minimálním počtem 0 a maximálním počtem 3. Nastavení provedete v modulu

PRODUKTY/SLUŽBY

na záložce Ceny, v tabulce 'Seznam návazností'.

7. Zařízení v Mango

7.1. Kuki proxy

Je nositelem parametrů s přihlašovacími údaji k API Kuki. Kromě těchto parametrů musí mít parametr “Infrastruktura” (INFRA_LOC) s hodnotou odpovídající danými lokacím a musí mít status AP pro obsluhované lokace. Pod toto zařízení jsou připojována zařízení Kuki klient a mohou pod něho být zapojena i zařízení Kuki STB. Vazba na Kuki proxy je ale řešena pomocí parametru. Z principu nemusí být tedy umístěna přímo pod Kuki proxy.

Zařízení je vytvořeno v rámci implementace.

Parametr	Význam
Infrastruktura	Lokace, ve které je zařízení využíváno.
Přihlašovací jméno	Přihlašovací jméno k API
Heslo	Heslo k API

7.2. Kuki klient

Jedná se o virtuální zařízení automaticky vznikající pro každého zákazníka s aktivní bázovou Kuki službou při její aktivaci (nikoliv za stavu služby 'K zapojení'). Pomocí tohoto zařízení jsou prováděny aktualizace, jimiž se synchronizuje nastavení do Kuki. Parametry tohoto zařízení není potřeba řešit, jejich správu provádí Mango automaticky.

Parametr	Význam
KUKI - kódy služeb	Zajišťuje aktualizaci Kuki při změně služeb zákazníka.
Čas poslední synchronizace	Je využíván interně pro synchronizaci mezi aktualizacemi z Mango a zpětným přenosem změn prováděných v Moje Kuki.

7.3. Kuki STB

Zařízení reprezentuje fyzický set-top box nebo smart TV - fixní zařízení pro sledování Kuki na zařízeních, která nepodporují její sledování přímo.

Počet set-top boxů je dán počtem licencí závislé služby Navíc telka:

• 1 licence je vždy v ceně bázové služby
• 2 licence lze dokoupit přes závislou službu Navíc telka

Set-top box musí být do Mango přidán a jeho aktualizace proběhnout předtím, než ho zákazník dostane do ruky. V opačném případě dojde k chybné registraci a Mango partner se musí obrátit přímo na Kuki. Set-top box lze založit přes modul

WIZARD

, v seznamu služeb pod tlačítkem Zařízení > Přidat. Set-top box lze založit i přes modul

KONCOVÁ ZAŘÍZENÍ

, akce "Vložení zařízení".

Na jeden Kuki STB může být navázána pouze jedna hlavní smlouva (bázová služba Mango). Případné další set-top boxy lze přidat po zakoupení služeb 'Kuki Navíc telka'.

Fyzický set-top box a smart TV se obsluhují v Kuki odlišně. Přes API Kuki nelze vyčíst smart TV a Mango je ani při provádění synchronizace nevidí. Smart TV si zakládá koncový uživatel sám. V případě problémů se smart TV je možné bitrate a další parametry nastavit přímo na vm.kuki.cz.

Parametr	Význam
Sériové číslo	Sériové číslo set-top boxu (nejméně 10 znaků 0-9 A-Z a a-z)
MAC adresa	MAC adresa set-top boxu
Maximální bitrate	Maximální bitrate v kbps - lze omezit při nestabilní konektivitě. Kuki akceptujte tyto hodnoty: 0 (neomezovat), 2000000 (2 Mbps) 4000000 (4 Mbps), 6000000 (6 Mbps), 8000000 (8 Mbps).
Zpoždění proti live	Počet bufferovaných chunků (1 odpovídá 5 vteřinám). Při špatné konektivitě lze navýšit.
Maximální rychlost streamování	Jakou nejvyšší rychlostí v Mbps může zařízení stahovat. Nejméně dvojnásobek max. bitrate. Vhodné nastavit na bezdrátech. Kuki akceptujte tyto hodnoty: 0 (nenastaveno) 250 (2 Mbps), 1000 (8 Mbps), 1500 (12 Mbps), 2000 (16 Mbps), 2500 (20 Mbps), 3000 (24 Mbps), 3500 (28 Mbps), 4000 (32 Mbps), 8000 (64 Mbps).

7.4. Události ze zařízení

V modulu

KONCOVÁ ZAŘÍZENÍ

a tabulce 'Události zařízení' můžete sledovat stav proběhnuté aktualizace.

  Dokumentaci průběžně doplňujeme  

• Ignoring change of ... - it's a base service: Informace se zobrazuje v případě, kdy v logu narazíme na záznam o aktivaci "hlavní smlouvy". Ty přes samoobsluhu aktivovat nejdou, takže nás v této chvíli nezajímají. Záznam má pouze informativní charakter a nejde o chybu.
• User ... is not ... and does not concern us now. Skipping: Když Mango dělá aktualizaci jednoho uživatele, tak neřešíme všechny ostatní (takže se taky aktualizace nemůže rozbít kvůli případné chybě u někoho jiného). Záznam má pouze informativní charakter a nejde o chybu.