Дополнительные документы Обмен информацией между демонстратором фильма и ЕАИС Порядок обмена информацией между демонстратором фильма и оператором единой федеральной автоматизированной системы сведений о показах фильмов в кинозалах, включая формы ее запроса и предоставл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кция (балкон, ложа,...), если есть деление зала на секциицена продажи билета (с учетом скидки, в руб.коп., в случае возврата - цена отрицательная)скидка на стоимость билета (в руб.коп., в случае возврата - скидка отрицательная)тип билета(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"Список файлов в папке "исходящие"ФайлИмя файлаРазмер файла в байт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 создано больше одного кинотеатра, то вам понадобится переключаться между ними. Например, при изменении настроек, формировании отчетов и т.д. Для того, чтобы сменить кинотеатр, нажмите на название кинотеатра, выбранного в данный момент (слева под главным меню). Затем выберите другой кинотеатр из списка: После того, как название активного кинотеатра изменилось, можно применять другие настройки, редактировать расписание и др.