Přenos dat pokladní systémy -> DisFilm

Změněno 2018/11/14 12:25 od Administrator — Kategorizován jako: API

Pro import výsledků z pokladních systémů lze použít XML soubor CRESULTS.XML. 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
http://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
http://www.disfilm.cz/xsd/cresults.xml - vzorový soubor obsahuje dva výsledky, jeden nulový s neúčastí diváků

Element EXPORT- hlavička souboru
Element EXPORT definuje parametry exportu. Element je povinný, v exportním souboru se může vyskytovat pouze jednou. Povinné položky jsou označené červeně.

Položka	Popis položky
code	Kód kina dle specifikace UFD.
cinema	Název kina pro kontrolu
securityCode	Bezpečnostní kontrolní kód.
exportDate	Datum a čas exportu.

Element RESULT- výsledek
Element RESULT obsahuje výsledek za odehrané představení. Povinné položky jsou označené červeně.

Položka	Popis položky
date	Datum a čas představení
screenNr	Číslo sálu
filmCode	Číslo filmu dle specifikace UFD
title	Titul filmu
copyCode	Číslo kopie
format	Formát projekce (DCI2D,DCI3D apod)
boxOffice	Hrubá tržba za odehrané představení
boxOfficeNet	Tržba bez DPH
admissions	Počet diváků (včetně volných vstupenek)
performanceType	Typ představení (např dětské představení, filmový klub apod. Výběr z předdefinovaných hodnot, bližší info viz schéma)
price	Výchozí vstupné za představení
language	Jazyková úprava (Výběr z předdefinovaných hodnot, bližší info viz schéma)
cancel	Kód stornování představení (výběr z předdefinovaných hodnot, bližší info viz schéma)
priceAdmissions	Rozklad vstupného za odehrané představení (diváci x vstupné)
discounts	Přehled poskytnutých slev (více informací viz discountsType)

type discountType
Type pro reportování slev, poskytnutých k danému představení.

Položka	Popis položky
cardID	Jedinečný kód slevové karty (např T111222333444E apod)
discountDate	Datum a čas poskytnutí slevy. Datum ve tvaru YYYY-MM-DDTHH:MM:SS.
discountName	Název poskytnuté slevy
ticketPrice	Plná cena vstupenek, na kterou byla poskytnuta sleva
ticketPriceWODiscount	Cena vstupenek bez poskytnuté slevy