II. Обмен информацией между демонстратором фильмов и оператором ЕИС

II. Обмен информацией между демонстратором фильмов

и оператором ЕИС

3. Обмен информацией между демонстратором фильмов и оператором ЕИС происходит в автоматическом режиме с использованием информационно-телекоммуникационных сетей, программно-аппаратных средств в электронном виде в формате XML-документов.

4. XML-документ, сформированный демонстратором фильма для передачи в ЕИС, должен содержать информацию о количестве реализованных билетов на один киносеанс в конкретные дату и время киносеанса и определенном кинозале. В рамках одного сеанса связи может быть передано несколько XML-документов, если к моменту передачи данных у демонстратора фильмов реализована продажа билетов на два и более киносеанса.

5. Структура XML-документа состоит из единственного корневого элемента seans, который имеет свои атрибуты и содержит необходимое количество дочерних элементов документа film (сведения о фильме) и form (бланки билетов) со своими атрибутами. Название фильма должно точно соответствовать прокатному удостоверению.

6. Обмен данными в формате XML-документа описан в приложении N 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.zip

9. XML-документы упаковываются (архивируются) в формате zip по одному файлу либо в пакет, содержащий несколько файлов.

10. Если файл-архив содержит XML-документы только одного демонстратора фильмов, то в имени файла-архива указывается код демонстратора фильмов. Если в нем содержатся XML-документы по нескольким демонстраторам фильмов, то в имени файла-архива должен указываться код киносети.

11. Код в имени XML-документа всегда должен совпадать с атрибутом "org_id" внутри файла.

12. Если XML-документы отправляются от имени киносети, то необходимо использовать пару ИМЯ ПОЛЬЗОВАТЕЛЯ/ПАРОЛЬ киносети.

13. Передача в ЕИС одноименных XML-документов не допускается.

14. Для обеспечения информационного обмена при регистрации в ЕИС каждому демонстратору фильмов присваивается уникальный идентификационный номер ID, который будет использоваться в XML-документе, для чего генерируется ИМЯ ПОЛЬЗОВАТЕЛЯ и строка-ПАРОЛЬ (длиной не менее 8 символов). Пара ИМЯ ПОЛЬЗОВАТЕЛЯ/ПАРОЛЬ автоматически, скрыто от оператора ЕИС, отправляется на электронный адрес демонстратора фильмов, указанный в регистрационной карте.

15. Передача данных в ЕИС осуществляется демонстратором фильмов по следующему адресу в сети Интернет: https://ekinobilet.ru/ekbs/upload.aspx

16. XML-документ передается на сервер ЕИС информационно-телекоммуникационными средствами демонстратора фильмов или киносети по HTTPS протоколу. Метод запроса: POST, MIME-тип: multipart/form-data в соответствии с RFC1867 (http://www.ietf.org/rfc/rfc1867.txt). Запрос должен содержать три параметра:

1) login (строка, ИМЯ ПОЛЬЗОВАТЕЛЯ);

2) password (строка, ПАРОЛЬ);

3) XMLfile (файл, XML-документ).

Значения полей 1) и 2) демонстратор фильмов получает от оператора ЕИС при регистрации в ЕИС, поле 3) - файл. Тип разрешенных на прием файлов: *.zip, *.xml.

17. В случае несоответствия XML-документа пункту 17 настоящего Порядка XML-документ не принимается ЕИС, а на запрос отправляется ответ в формате XML:

<?xml version="1.0" encoding="utf-8"?>

<files zip="ekb_000_20100429_110656_28740_ok.zip">

<result filename="ekb_000_20100429_110656_28740.xml" errcount="1" >

<error codе="5"><![CDATA[Ошибка!!! ".]]></error>

</result>

<result filename="ekb_000_20100429_110656_28741.xml" errcount="0" />

</files>

- для пакета из нескольких документов, или

<?xml version="1.0" encoding="utf-8"?>

<files>

<result filename="ekb_000_20100429_110656_28741.xml" errcount="1" >

<error code="5"><![CDATA[Ошибка!!! ".]]></error>

</result>

</files>.

- для одного документа.

18. Принятый (загруженный) в ЕИС XML-документ подлежит автоматической обработке, а демонстратору фильмов направляется сообщение в формате XML:

<?xml version-"1.0" encoding="utf-8"?>

<files zip="ekb_000_20100429_110656_28740_ok.zip">

<result filename="ekb_000_20100429_110656_28740.xml" errcount="0" />

<result fllename="ekb_000_20100429_110656_28741.xml" errcount="0" />

</files>

- для пакета из нескольких документов, или

<?xml version="1.0" encoding="utf-8"?>

<files>

<result filename="ekb_000_20100429_110656_28741.xml" errcount="0" />

</files>.

- для одного документа.

Описание ответа приведено в приложении N 2 к настоящему Порядку.

19. Если демонстратором фильмов в результате загрузки XML-документа не получено ответа, указанного в пункте 19 настоящего Порядка, то необходимо повторно отправить (загрузить) на сервер ЕИС XML-документ.

20. Принятый (загруженный) в ЕИС XML-документ проверяется и загружается в центральную базу данных, в результате чего автоматически создается файл протокола по каждому XML-документу. Протоколы загрузки формируются в папке "исходящие" для каждого демонстратора фильмов.

21. Описание протокола загрузки приведено в приложении N 3 к настоящему Порядку.

22. Если в результате обработки и загрузки XML-документа не было обнаружено ошибок, то содержимое протокола загрузки будет иметь следующий вид:

<?xml version="1.0" encoding="UTF-8"?>

<result errcount="0"/>.

23. В случае обнаружения ошибки содержимое протокола загрузки будет иметь следующий вид:

<?xml version="1.0" encoding="UTF-8"?>

<result errcount="3">

<error code="1">Ошибка 1</error>

<error code="2">Ошибка 2</error>

<error code="3">Ошибка 3</error>

</result>

24. Имя файла протокола формируется следующим образом: {имя обработанного XML-документа}(res).xml.

Пример: для XML-документа ekb_305_20100511_100845768.xml будет сформирован файл протокола с именем: ekb_305_20100511_100845768(res).xml.

25. Для загрузки содержимого папки "исходящие" с сервера ЕИС демонстратор фильмов направляет запрос по адресу в сети Интернет: https://ekinobilet.ru/ekbs/upload.aspx по HTTPS протоколу, метод: POST MIME-тип: multipart/form-data в соответствии с RFC1867 (http://www.ietf.org/rfc/rfc1867.txt). Запрос должен содержать три параметра:

1) login (строка, ИМЯ ПОЛЬЗОВАТЕЛЯ);

2) password (строка, ПАРОЛЬ);

3) get (list | all | <file_name>,<file_name>,...).

Значения 1) и 2) демонстратор фильмов получает при регистрации в системе, параметр 3) get может принимать следующие значения:

"get=list" - при этом сервер ЕИС возвращает список XML-документов, которые находятся в папке "исходящие" для данного демонстратора фильмов, в формате XML;

"get=all" - при этом сервер ЕИС вернет zip-файл, в котором будут содержаться все файлы папки "исходящие";

"get=<file_name>,<file_name>,..." - при этом сервер ЕИС вернет zip-файл, в котором будут содержаться все файлы, запрошенные командой "get".

26. Описание ответа сервера ЕИС на запрос демонстратора фильмов "list" приводится в приложении N 4 к настоящему Порядку.