Дополнительные документы
Обмен информацией между демонстратором фильма и ЕАИС
Порядок обмена информацией между демонстратором фильма и оператором единой федеральной автоматизированной системы сведений о показах фильмов в кинозалах, включая формы ее запроса и предоставлI. Общие положения1. Порядок обмена информацией между демонстратором фильма и оператором единой информационной системы сведений о показах фильмов в кинозалах (далее соответственно - Порядок, ЕИС) определяет состав информации, формы и форматы документов, которыми обмениваются участники информационного обмена.2. Участниками информационного обмена являются оператор ЕИС и демонстраторы фильмов. Пользователи ЕИС получают информацию, содержащуюся в ЕИС, на условиях, установленных постановлением Правительства Российской Федерации от 18 октября 2010 года № 837 "О функционировании единой федеральной автоматизированной информационной системы сведений о показе фильмов в кинозалах" (Собрание законодательства Российской Федерации, 2010, № 43, ст. 5508).II. Обмен информацией между демонстратором фильмов и оператором ЕИС3. Обмен информацией между демонстратором фильмов и оператором ЕИС происходит в автоматическом режиме с использованием информационно-телекоммуникационных сетей, программно-аппаратных средств в электронном виде в формате XML-документов.4. XML-документ, сформированный демонстратором фильма для передачи в ЕИС, должен содержать информацию о количестве реализованных билетов на один киносеанс в конкретные дату и время киносеанса и определенном кинозале. В рамках одного сеанса связи может быть передано несколько XML-документов, если к моменту передачи данных у демонстратора фильмов реализована продажа билетов на два и более киносеанса.5. Структура XML-документа состоит из единственного корневого элемента seans, который имеет свои атрибуты и содержит необходимое количество дочерних элементов документа film (сведения о фильме) и form (бланки билетов) со своими атрибутами. Название фильма должно точно соответствовать прокатному удостоверению.6. Обмен данными в формате XML-документа описан в приложении № 1 к настоящему Порядку.7. В случае необходимости удаления или замены данных по реализованным билетам, демонстратор фильмов направляет в ЕИС XML-документ, содержащий сведения об удаляемых билетах, идентичные переданным по этим билетам первоначально, за исключением цены и скидки, которые должны быть указаны со знаком "-" (минус). Скорректированные сведения направляются демонстратором фильмов в соответствии с пунктами 5-7 настоящего Порядка. Первоначально переданные сведения из ЕИС не удаляются, а получают статус неактуальных и не учитываются в статистических данных по кассовым сборам.8. XML-документы, подготовленные демонстратором фильмов к передаче в ЕИС, именуются: <префикс>_<идентификатор>_<дата>_<время>.<тип>, где:1) <префикс> - всегда "ekb";2) <идентификатор> уникальный идентификатор, получаемый демонстратором фильмов от оператора ЕИС при регистрации;3) <дата> - дата создания документа в формате ГГГТММДД: ГГГГ - год, ММ - месяц (01-12), ДД - день (01-31);4) <время> - время создания документа в формате ЧЧММССННН: ЧЧ - часы (00-24), ММ - минуты (00-59), СС - секунды (00-59), ННН - миллисекунды (000-999);5) <тип> - "xml" или "zip", если XML-документы передаются в упакованном виде.Пример:ekb_305_20100511 100845768.xml или ekb_1677_20100511_185526897.zip9. XML-документы упаковываются (архивируются) в формате zip по одному файлу либо в пакет, содержащий несколько файлов.10. Если файл-архив содержит XML-документы только одного демонстратора фильмов, то в имени файла-архива указывается код демонстратора фильмов. Если в нем содержатся XML-документы по нескольким демонстраторам фильмов, то в имени файла-архива должен указываться код киносети.11. Код в имени XML-документа всегда должен совпадать с атрибутом "org_id" внутри файла.12. Если XML-документы отправляются от имени киносети, то необходимо использовать пару ИМЯ ПОЛЬЗОВАТЕЛЯ/ПАРОЛЬ киносети.13. Передача в ЕИС одноимённых XML-документов не допускается.14. Для обеспечения информационного обмена при регистрации в ЕИС каждому демонстратору фильмов присваивается уникальный идентификационный номер ID, который будет использоваться в XML-документе, для чего генерируется ИМЯ ПОЛЬЗОВАТЕЛЯ и строка-ПАРОЛЬ (длиной не менее 8 символов). Пара ИМЯ ПОЛЬЗОВАТЕЛЯ/ПАРОЛЬ автоматически, скрыто от оператора ЕИС, отправляется на электронный адрес демонстратора фильмов, указанный в регистрационной карте.15. Передача данных в ЕИС осуществляется демонстратором фильмов по следующему адресу в сети Интернет: https://ekinobilet.ru/ekbs/upload.aspx16. XML-документ передается на сервер ЕИС информационно-телекоммуникационными средствами демонстратора фильмов или киносети по HTTPS протоколу. Метод запроса: POST, MIME-тип: multipart/form-data в соответствии с RFC 1867 (http://www.ietf.org/rfc/rfcl867.txt). Запрос должен содержать три параметра:1) login (строка, ИМЯ ПОЛЬЗОВАТЕЛЯ);2) password (строка, ПАРОЛЬ);3) XMLfile (файл, XML-документ).Значения полей 1) и 2) демонстратор фильмов получает от оператора ЕИС при регистрации в ЕИС, поле 3) - файл. Тип разрешенных на прием файлов: *.zip, *.xml.17. В случае несоответствия XML-документа пункту 17 настоящего Порядка XML-документ не принимается ЕИС, а на запрос отправляется ответ в формате XML: - для пакета из нескольких документов, или <еrrоr соdе="5"> .- для одного документа.18. Принятый (загруженный) в ЕИС XML-документ подлежит автоматической обработке, а демонстратору фильмов направляется сообщение в формате XML: - для пакета из нескольких документов, или .23. В случае обнаружения ошибки содержимое протокола загрузки будет иметь следующий вид:Ошибка lОшибка 2Ошибка 3 24. Имя файла протокола формируется следующим образом: {имя обработанного XML-документа} (res).xml.Пример: для XML-документа ekb_305_20100511_100845768.xml будет сформирован файл протокола с именем: ekb_305_2010051 l_100845768(res).xml.25. Для загрузки содержимого папки "исходящие" с сервера ЕИС демонстратор фильмов направляет запрос по адресу в сети Интернет: https://ekinobilet.ru/ekbs/upload.aspx по HTTPS протоколу, метод: POST MIME-тип: multipart/form-data в соответствии с RFC 1867 (http://www.ietf.org/rfc/rfcl867.txt). Запрос должен содержать три параметра:1) login (строка, ИМЯ ПОЛЬЗОВАТЕЛЯ);2) password (строка, ПАРОЛЬ);3) get (list I all: ,,... ).Значения 1) и 2) демонстратор фильмов получает при регистрации в системе, параметр 3) get может принимать следующие значения:"get=list" - при этом сервер ЕИС возвращает список XML-документов, которые находятся в папке "исходящие" для данного демонстратора фильмов, в формате XML;"get=all" - при этом сервер ЕИС вернет zip-файл, в котором будут содержаться все файлы папки "исходящие";"get=,,..." - при этом сервер ЕИС вернет zip-файл, в котором будут содержаться все файлы запрошенные командой "get".26. Описание ответа сервера ЕИС на запрос демонстратора фильмов "list" приводится в приложении № 4 к настоящему Порядку.III. Предоставление информации, содержащейся в ЕИС, пользователям27. С целью получения информации, содержащейся в ЕИС, в полном объеме и в отношении конкретного фильма, пользователь оформляет у оператора ЕИС регистрационную карту на бумажном носителе, после чего получает от оператора ЕИС идентификационный номер (ID пользователя), а также необходимые атрибуты для входа в эту систему (логин, пароль).28. Пользователь оформляет запрос на предоставление информации по форме, представленной в приложении № 5 к настоящему Порядку.29. Оператор ЕИС оформляет запрашиваемую пользователем информацию по форме, представленной в приложении № 6 к настоящему Порядку.Приложение № 1 к ПорядкуСхема бланка XML-документа обмена даннымидата и время в формате: "ГГГГММДД ЧЧ:HH"дата и время в формате:"ГГГГММДД ЧЧ:HH:CC"бланк билeтaмecтoрядCeкция (балкон, ложа,...), если есть деление зала на секциихs:documentation>цена продажи билета (с учетом скидки, в руб.коп., в случае возврата - цена отрицательная)скидка на стоимость билета (в руб.коп., в случае возврата - скидка отрицательная)хs:documentation>тип билета(VIР, студенческий, детский,. ..)дата и время продажи в формате: "ГГГГММДД ЧЧ:НН:СС". Например: "20080708 12:56:43"Элемент описывает один из фильмов данного сеанса. Т.е. если в течение сеанса демонстрируется несколько фильмов, тогда их надо описывать данными элементами. Содержимое элемента - название фильма, соответствующее прокатному yдостоверению.номep прокатного удостоверения (в случае отсутствия передается 0)элемент описывает совокупность данных зал-сеанс. Сеанс однозначно определяется набором из 3-х полей: org_id, showroom, seans_dateЭлемент описывает один из фильмов данного сеанса. Т.е. если в течение сеанса демонстрируется несколько фильмов, тогда их надо описывать данными элементами. Содержимое элемента - название фильма, соответствующее прокатному удостоверению элемент описывает совокупность данных по бланку билeтaуникальный идентификатор Демонстратора фильмов, получаемый при peгистрацииназвание заладата и время начала сеанса в формате: "ГГГГММДД ЧЧ:НН". Например: "20080708 12:56"название сеанса (заполняется для сеансов, в которых демонстрируется несколько фильмов)<хs: documentation>Приложение № 2 к Порядку Схема ответа на POST-запрос загрузки файлаПротокол обработки ekb-файлаошибка при загрузке. Таких ошибок может быть несколько и разных типов.Koд ошибкиИмя файла в котором обнаружены ошибки. Присутствует если это протокол проверки файла на корректность в синхронном режиме.Kоличество ошибок всего. Если 0 значит файл обработан и загружен без ошибок.Имя файла zip-apxиваПриложение № 3 к Порядку Схема протокола загрузкиПротокол обработки ekb-файлаОшибка при загрузке. Таких ошибок может быть несколько и разных типов.Код ошибкиИмя файла в котором обнаружены ошибки. Присутствует если это протокол проверки файла на корректность в синхронном режиме. Количество ошибок всего. Если 0 значит файл обработан и загружен без ошибок.Приложение № 4 к Порядку Схема ответа "list"Список файлов в папке "исходящие"хs:documentation>ФайлИмя файлаРазмер файла в байтaxОбщее кол-во файловОбщий размер файлов в байтax
Коды ошибок при отправке данных в ЕАИС
Справочник ошибок, которые могут быть возвращены сервером:
Код ошибки
Описание
900
На сервере произошла непредвиденная ошибка. Повторите попытку позже. Мы занимаемся устранением неисправности.
101
Запрошенный список файлов не найден на сервере.
102
Нет файлов для загрузки.
9
Отказ в доступе к функции удаления/восстановления пакетов. Для получения доступа на удаление/восстановление пакетов обратитесь в службу поддержки ЕАИС: eais_support@fond-kino.ru
10
Не найден файл с данными!
11
Ошибка при сохранении входящего файла "{Имя файла}". Сообщение: "{Сообщение}".
111
Ошибочный запрос
12
Данный вид запроса может быть сделан только по протоколу HTTPS.
13
Данная служба принимает только POST-запросы.
14
Параметры "Имя пользователя" и "Пароль" должны быть указаны обязательно!
15
Код в имени файла "{Имя файла}" не может принимать значение "{Код}" для пользователя "{Имя пользователя}".
16
Плохой архив! Сообщение: {Сообщение}"
17
Ошибка при распаковке файла {Имя файла}! Сообщение: {Сообщение}
18
Неверное имя файла {Имя файла}! Сообщение: {Сообщение}
2
Ошибка в имени пользователя и пароля.
300
Ошибка при открытии файла. Сообщение: {Сообщение}
311
Ошибки в структуре файла.
312
Ошибка в билете (ряд:{0}; место:{1}). {Сообщение}
3131
Ошибка! Должен быть указан обязательно атрибут "seans_title".
3132
Ошибка! Должен быть указан обязательно либо атрибут "seans_title", либо "Название фильма" в элементе .
3133
Ошибка в описании фильма (индекс:{индекс элемента }). Для сеансов типа "Нонстоп", название фильма должно быть указано обязательно.
3134
Сеанс зарегистрирован в системе для фильма "{Название фильма}"(ПУ:{номер ПУ}). Для изменения название фильма необходимо сначала аннулировать сеанс.
3135
Сеанс зарегистрирован в системе для фильмов "{Список фильмов}". Для изменения списка фильмов необходимо сначала аннулировать сеанс.
3141
Код "org_id" внутри файла "{код организации внутри файла}" не соответствует коду в имени файла "{код организации в имени файла}".
3142
Код "org_id" внутри файла не может принимать значение "{код организации внутри файла }" для пользователя "{Имя пользователя}"")]
315
Для "org_id"={код организации} кинозал с именем "{Имя кинозала}" не зарегистрирован.
33
Пакет "{Имя файла}" был загружен ранее и не может быть загружен повторно.
35
Ошибка в имени файла "{Имя файла}".
Некоторые ошибки похожи, но они возникают на разных этапах проверки, поэтому у них разные коды.
1. Сколько времени может пролежать файл в очереди? И какой максимальный таймаут ответа после отправки файла?Среднее время которое файл стоит в очереди на обработку – 1-2 мин, в зависимости от загрузки сервера. Время обработки xml-файла – около 300 мсекМаксимальное время ожидания файла в очереди не должно превышать 15-20 мин. Но могут быть режимы работы системы, когда время обработки файла может достигать нескольких часов, например, в момент проведения профилактических работ или наката обновлений.
2. Ситуация, когда продаются билеты на фильм, к которому еще не получено прокатное удостоверение - отправляем фильм с прокатным удостоверением = 0 и система распознает фильм по названию (посимвольно). Потом получаем прокатное удостоверение - и теперь отправляем фильм с тем же названием и с прокатным удостоверением. В таком случае, по какому параметру система будет распознавать фильм? У чего приоритет - название или прокатное удостоверение? Система работает примерно так: сначала запускается некий эвристический алгоритм, который пытается идентифицировать фильм по ПУ+название, если нет ПУ, то только по названию. Если в результате работы автоматической выверки фильм однозначно идентифицировать не удалось, то он попадает на ручную выверку к оператору.3. Файлы при отправке складываются в очередь. Система обрабатывает их в том же порядке?Да. Файлы обрабатываются в порядке поступления.4. Ситуация - отправили файл с продажей, файл не обработался (внутренняя ошибка или еще что-то). Следующим файлом отправляем возврат билета - как это воспримется системой? Ведь по сути будет возврат билета, который не купили. Все билеты загружаются в систему с тем знаком, который указан в пакете, далее происходит суммирование по сеансам, таким образом учитываются возвраты. Если сначала пришел возврат, затем сам билет, то ничего страшного, они учтутся на этапе загрузки билета. Все сеансы удачно загруженные в систему проходят доп проверку на предмет дублей, отрицательных сумм, некорректных дат сеансов и продаж.Настройка reCaptcha
При установке галочки капчи и ввода секретного и открытого ключа (которые необходимо сформировать при создании капчи на сайте https://www.google.com/recaptcha/admin/create):
На сайте при покупках авторизованным пользователем и вводе номера на экране посетителя отобразится следующий значок:
Пользователи смогут ввести капчу для подтверждения авторизации:
После прохождения проверки отобразится окно для ввода кода подтверждения (из смс) и далее ввод нового пароля.
При создании нового пользователя: после ввода номера телефона сразу отобразится проверка с картинками, после ввода которых откроется окно ввода кода подтверждения (из смс) и заполнения профиля пользователя (заполнить и подтвердить почтовый адрес).
Выбор кинотеатра
Если в вашем аккаунте Cinemabox создано больше одного кинотеатра, то вам понадобится переключаться между ними. Например, при изменении настроек, формировании отчетов и т.д.
Для того, чтобы сменить кинотеатр, нажмите на название кинотеатра, выбранного в данный момент (слева под главным меню). Затем выберите другой кинотеатр из списка:
После того, как название активного кинотеатра изменилось, можно применять другие настройки, редактировать расписание и др.