Přenos výsledků (pokladní systémy -> DisFilm)
Přenos výsledků (pokladní systémy -> DisFilm)
Pro import výsledků z pokladních systémů lze použít XML soubor (např. CRESULTS.XML, na názvu souboru nezáleží). Validní soubor se odesílá na stanovenou emailovou adresu (Česko na adresu vysledky@disfilm.cz, Slovensko na adresu vysledky@disfilm.sk), ze které se automaticky vyčítá do databáze DisFilm. Výsledky se importují na DisFilm jako neuzamčené, po odehrání filmového týdne a kontrole se musí uzamknout přímo na DisFilmu. Soubor se generuje po uzávěrce prodeje a musí být odeslaný nejpozději do 09 hod dopoledne následujícího dne. Kino hlásí výsledky za všechny tituly, tedy i včetně těch distributorů, kteří nemají propojení s portálem DisFilm.CZ(SK) a titulů s alternativním obsahem!
- Validační schéma souboru CRESULTS.XSD
https://www.disfilm.cz/xsd/cresults.xsd - importní soubor musí být zvalidován podle tohoto schématu. Validační schéma obsahuje podrobnější popis jednotlivých elementů. - Vzorový soubor CRESULTS.XML
https://www.disfilm.cz/xsd/cresults.xml - vzorový soubor obsahuje dva výsledky, jeden nulový s neúčastí diváků
Popis struktury souboru
Popis vybraných elementů v exportním souboru. Povinné položky jsou označeny *.
Element export definuje parametry exportu. Element je povinný, v exportním souboru se může vyskytovat pouze jednou.
| Položka | Popis |
|---|---|
| code * | kód kina dle specifikace UFD |
| cinema | název/místo kina pro kontrolu |
| securityCode * | bezpečnostní kontrolní kód |
| exportDate * | datum a čas exportu (ISO 8601) |
Element result obsahuje výsledek za odehrané představení. Povinné položky jsou označené červeně.
| Položka | Popis |
|---|---|
| date * | datum a čas představení |
| screenNr * | číslo sálu |
| filmCode * | číslo filmu dle specifikace UFD |
| title * | titul filmu |
| copyCode | číslo kopie/disku filmu |
| format * | formát projekce (výběr z předdefinovaných hodnot, bližší info viz schéma) |
| language * | jazyková úprava (výběr z předdefinovaných hodnot, bližší info viz schéma) |
| performanceType | typ představení (výběr z předdefinovaných hodnot, bližší info viz schéma) |
| price * | výchozí vstupné za představení |
| cancel * | příčina neuskutečnění představení (výběr z předdefinovaných hodnot, bližší info viz schéma) |
| admissions * | počet diváků (včetně volných vstupenek) |
| boxOffice * | hrubá tržba za odehrané představení |
| boxOfficeNet | tržba bez DPH |
| priceAdmissions | rozklad vstupného za odehrané představení (diváci x vstupné) |
| discounts | přehled poskytnutých slev (více informací viz discountsType) |
Element priceAdmission slouží pro rozklad vstuppného za odehrané představení
| Položka | Popis |
| admissions * | počet diváků za dané vstupné |
| price * | výše daného vstupného (pro volné vstupenky se hodnota 0) |
| ticketName | název vstupného (např. plné vstupné, vstupné děti apod) |
Element discount pro reportování slev, poskytnutých k danému představení.
| Položka | Popis |
|---|---|
| cardID * | jedinečný kód slevové karty (např T111222333444E apod) |
| discountDate * | datum a čas poskytnutí slevy |
| discountName * | název poskytnuté slevy |
| ticketPrice * | plná cena vstupenek, na kterou byla poskytnuta sleva |
| ticketPriceWODiscount * | cena vstupenek bez poskytnuté slevy |