Kuki
Rozšíření systému o API zjednodušující správu klientů a jejich služeb internetové televize Kuki. Součástí je i funkce pro prvotní import klientů, služeb, zařízení a ceníku do systému ISPadmin (pokud byla služba Kuki využívána ještě před nasazením systému ISPadmin).
Terminologie
Pojmem smlouva u Kuki (hlavní smlouva) je myšlena vazba mezi klientem a službou (např. Kuki M, Kuki start apod.). Těchto smluv je možné mít pro jeden typ služby několik. V systému ISPadmin se u klienta zpravidla jedná pouze o jednu IPTV službu typu Kuki.
- Hlavní smlouva (rodičovská) – v systému ISPadmin se jedná o vytvořenou službu IPTV (typ KUKI) u vybraného klienta se zvolenou hlavní smlouvou/základním balíčkem (CZ – Kuki S/M/L/XL/start/menší/větší/extra, SK – Kuki štart/malá/veľká/extra SK).
- Podřízená smlouva (dceřiná) – jedná se o rozšiření hlavní smlouvy/základního balíčku o doplňkové služby (slevy, kanály navíc apod.).
- Zařízení (STB) – přidané zařízení (v ISPA) se v portálu Kuki VM vytvoří v sekci pro zařízení (u hlavní smlouvy) s kódem ve stejném tvaru jako podřízená smlouva. S tímto souvisí další podmínky, které je potřeba splnit (zajistit potřebný počet licencí pro zařízení pomocí další podřízené smlouvy).
- Reporting – obsahuje data/podklady z Kuki pro fakturaci IPTV služeb Kuki v systému ISPadmin za poslední uplynulý kalendářní měsíc
Podmínky pro zařízení
- CZ: jde-li o 2. fixní zařízení k jedné základní službě Kuki start/menší/větší, zákazníkovi je potřeba PŘEDEM založit doplňkovou službu – Navíc telka
- CZ: jde-li o 3. fixní zařízení k jedné základní službě Kuki start/menší/větší/S/M/L/XL, zákazníkovi PŘEDEM založit doplňkovou službu – Navíc telka (3. licence)
- SK: jde-li o 2. nebo 3. fixní zařízení k jedné základní službě Kuki štart/malá/veľká, zákazníkovi PŘEDEM založit doplňkovou službu – Naviac telka
Postup pro zprovoznění
Několik kroků pro správné nastavení komunikace mezi systémem ISPadmin a Kuki TV:
- Přidat v záložce pro konfiguraci Kuki TV získané údaje od Kuki pro přístup k API (Nastavení –> Aktivní služby –> Kuki TV –> Konfigurace).
- Prvotní synchronizace (import) dostupných služeb (ceníku) z Kuki do IPTV tarifů v systému ISPadmin (Nastavení –> Aktivní služby –> Kuki TV –> Ceník).
- Nastavení ceny u naimportovaných služeb/IPTV tarifů typu Kuki TV v (Nastavení –> Tarify –> IPTV).
- Možnost importu zákazníků a jejich služeb z Kuki do systému ISPadmin (Nastavení –> Aktivní služby –> Kuki TV –> Import).
- Automatický import a přehled dat pro fakturaci (za předchozí měsíc), možnost testu položek na základě staženého reportingu (ISPA vs. KUKI) před fakturací (Nastavení –> Aktivní služby –> Kuki TV –> Reporting).
Diagram znázorňující vztah/propojení a logiku v systému ISPadmin se systémem Kuki:
Vytvoření IPTV služby
Korektní vytvoření IPTV služby typu Kuki TV u konkrétního klienta v systému ISPadmin je podmíněno existujícím nastavením/povolením API Kuki pro fakturační skupinu, které je vybraný klient součástí! (Nastavení –> Aktivní služby –> Kuki TV –> Konfigurace)
Proces vytvoření nové IPTV služby typu Kuki TV:
- U konkrétního klienta v záložce Aktivní služby kliknout pod hlavním nadpisem na tlačítko Přidat službu (
). Zde vybrat možnost IPTV.
- V zobrazeném formuláři je na konci možné vybrat typ IPTV služby – Kuki TV.
- Následně vybrat typ hlavní smlouvy (Kuki službu) pro ISPadmin IPTV službu (např. Kuki M, Kuki L apod.).
- Možnost zvolit i podřízené smlouvy (doplňkové služby) + možnost zadat zařízení.
Zadané údaje se ihned po uložení služby propisují přes API do systému pro správu služeb Kuki.
Zařízení
Možnost ke službě přidat STB (zařízení) tlačítkem – Přidat zařízení () na konci formuláře.
Přidat nové zařízení je možné až v editaci již vytvořené služby.
- Název – zvolený název zařízení
- Sériové číslo (vyžadované) – sériové číslo STB
- MAC adresa (vyžadované) – MAC adresa STB. Musí být ve správném tvaru MAC adresy (např. aa:bb:cc:dd:ee:00)
- Maximální bitrate (nepovinné)– pokud má zákazníkův STB nestabilní konektivitu, lze tímto vynutit, jaký nejvyšší bitrate má STB přehrávat. Pokud není vyplněno, STB se vždy snaží přehrávat s nejvyšším dostupným bitratem – Neomezovat, 2, 4, 6, 8 Mbps.
- Chunků dozadu oproti live – standardní zpoždění jsou 4 chunky (1 chunk = 5 vteřin). Navýšením této hodnoty je možné zvýšit naplnění bufferu a zamezit výpadkům přehrávaného obsahu v případě nedostatečně stabilní konektivity. Přípustné hodnoty pro nastavení jsou v rozsahu 4–15.
- Req. streaming rate (maximální rychlost) – maximální rychlost v Mbps, jakou si bude zařízení stahovat data. Nastavení je vhodné použít v případě, že je využíváno bezdrátové připojení k síti. Zvolená hodnota by neměla být nižší než dvojnásobek maximálního bitrate (výše).
Zařízení AS
Zařízení evidované na AS (aplikačním serveru). Možnost přepnout platformu u zařízení typu STB (set-top-box, fix) na Kuki 1, respektive Kuki 2 nebo Kuki FullHD. U ostatních typů (např. webbrowser, mobile) je možné upravit parametry (max. bitrate, chunk, req. streaming rate).
Možnost u zařízení (STB) evidovaného na AS změnit platformu tlačítkem Platforma ().
Možnost u zařízení (mimo STB) evidovaného na AS, změnit některé parametry (viz Zařízení) tlačítkem Upravit () nebo toto zařízení odebrat tlačítkem Smazat (
).
Fakturace
UPOZORNĚNÍ
Fakturovat IPTV služby typu Kuki TV je možné pouze měsíčně (zpětně). Při vytváření IPTV služby u klienta je výběr fakturačního období omezen na možnosti – bez fakturace a měsíční. Důvodem je stahování reportingu za uplynulý kalendářní měsíc. Jiné období není možné.
Základem pro fakturaci v systému ISPadmin je stažení kompletního reportingu z Kuki!
Fakturuje se (pouze hromadná fakturace) dle dostupných podkladů za uplynulý kalendářní měsíc (reporting), který je automaticky stažen přes API z Kuki (1. den měsíce nového).
Pokud se nevygenerují data pro fakturaci služby IPTV Kuki do reportingu, tak se při fakturaci v systému ISPadmin na fakturu nepřidá ani položka IPTV Kuki.
Pro oboustrannou (Kuki <–> ISPA) kontrolu fakturovaných služeb (před samotnou fakturací) je možné využít testovací stránku viz (Nastavení –> Aktivní služby –> Kuki TV –> Reporting).
V systému ISPadmin, u IPTV služby typu Kuki, se nastavením Fakturovat od: nezohledňuje den, ale pouze měsíc pro možnost tímto zvolený měsíc vůbec v systému ISPA následně vyfakturovat (po stažení reportingu). Konkrétní položky/podklady pro fakturaci se berou na základě dat z automaticky staženého reportingu z Kuki (1. den nového měsíce).
Data pro fakturaci, co se má v ISPA fakturovat, jsou pouze ze staženého reportingu z Kuki! Co není v reportingu se nefakturuje.
Pozastavení služby
Automaticky se pozastavují hlavní smlouvy (služby), pokud existuje nezaplacená faktura za tuto službu (podřízené se pozastavují v Kuki automaticky).
Kuki ID
Změny provedné na straně KUKI VM se do systému ISPadmin propisují každý den automaticky (po půlnoci – 0:02).
Kuki ID jsou přihlašovací údaje pro koncové klienty do portálu Moje Kuki, STB, PC, Smart TV a mobilních aplikací. Nastavené heslo (od ISP) si zákazník může upravit v STB (zařízení). Změnit jej ze strany klienta však není možné.
Možnost pro klienta zvolit si (objednat) v samoobsluze z nabízených doplňkových služeb Kuki. Tyto objednané služby se stanou součástí položek měsíční fakturace konkrétního klienta – reportingu (Nastavení –> Aktivní služby –> Kuki TV –> Reporting).
Možnost přidat/vytvořit/upravit Kuki ID přímo v systému ISPadmin je u konkrétního klienta u služby typu Kuki TV možné tlačítkem Kuki ID (). Přihlašovací údaje Kuki ID mají vazbu na klienta (ne pouze na službu). Kuki ID může mít klient libovolné množství.