Методические рекомендации по внесению и получению сведений из реестра сведений о проданных билетах

(утв. Минцифры России, Минкультуры России)

МЕТОДИЧЕСКИЕ РЕКОМЕНДАЦИИ

1 Общие сведения

1.1. Методические рекомендации по внесению и получению сведений из реестра сведений о проданных билетах (далее — Методические рекомендации) разработаны на основании Правил реализации мер по социальной поддержке молодежи в возрасте от 14 до 22 лет для повышения доступности организаций культуры, утвержденных постановлением Правительства Российской Федерации от 8 сентября 2021 г. № 1521 «О социальной поддержке молодежи в возрасте от 14 до 22 лет для повышения доступности организаций культуры» (Официальный интернет-портал правовой информации (www.pravo.gov.ru), 2021, 9 сентября, № 0001202109090011) (далее — Правила программы «Пушкинская карта»).

1.2. Реестр сведений о проданных билетах ведется Министерством цифрового развития, связи и массовых коммуникаций Российской Федерации в электронном виде.

1.3. Если не указано иное, в Методических рекомендациях используются термины в значениях, определенных в Правилах программы «Пушкинская карта», а также термины и сокращения, определенные в разделе 2 Методических рекомендаций.

1.4. Методические рекомендации описывают предпочтительный порядок получения, прекращения и восстановления доступа заявителей к реестру сведений о проданных билетах для внесения и получения сведений из реестра сведений о проданных билетах.

2 Термины и сокращения

Термин/Сокращение	Определение/Расшифровка
Доступ к реестру	Организационная и технологическая возможность заявителя вносить сведения в реестр и получать сведения из реестра
Заявитель	Участник программы «Пушкинская карта» (за исключением граждан), заинтересованный во внесении и получении сведений из реестра
ИС	Информационная система
Методы работы с реестром	Методы прикладного программного интерфейса для внесения и получения сведений из реестра, реализованные в программном обеспечении, функционирующем на серверах реестра, используемые ИС заявителей для внесения и получения сведений из реестра
Оператор реестра	Участник программы «Пушкинская карта», ведущий реестр сведений о проданных билетах на основании данных, представленных организациями культуры, оператором и иными участниками программы «Пушкинская карта» — Министерство цифрового развития, связи и массовых коммуникаций Российской Федерации
Продуктивный сервер	Сервер реестра, реализующий методы работы с реестром для внесения и получения сведений из продуктивного (не тестового) экземпляра реестра
Продуктивный токен	Набор символов, уникальный для каждого заявителя, используемый для авторизации заявителя при внесении и получении сведений из реестра при работе с продуктивным сервером
Реестр	Реестр сведений о проданных билетах в электронном виде
Сервер ППТ	Сервер реестра, реализующий методы работы с реестром для внесения и получения сведений из тестового экземпляра реестра, используемый для проведения приемочного пользовательского тестирования
Токен ППТ	Набор символов, уникальный для каждого заявителя, используемый для авторизации заявителя при внесении и получении сведений из реестра при работе с сервером ППТ

3 Цели и задачи

Целью получения участниками программы «Пушкинская карта» (далее — участники программы) доступа к реестру является реализация технологической интеграции ИС участников программы с реестром для обеспечения возможности внесения и получения из реестра сведений о билетах на посещение мероприятий, купленных, возвращенных и погашенных в рамках программы «Пушкинская карта».

4 Условия получения доступа к реестру

Для внесения и получения сведений из реестра заявитель должен относиться к одной из следующих категорий участников программы:

1. билетные операторы (агрегаторы);

2. операторы;

3. организации культуры.

5 Порядок получения доступа к реестру

5.1 Для получения доступа к реестру заявителю рекомендуется последовательно выполнить следующие действия:

1. Доработать ИС заявителя для реализации возможности использования методов работы с реестром, описанных в приложении 1 к Методическим рекомендациям. Перечень методов работы с реестром, возможность использования которых должна быть обязательно реализована в ИС заявителя, зависит от типа участника программы и приведен в приложении 2 к Методическим рекомендациям. Рекомендованные сроки внесения сведений в реестр указаны в приложении 3 к Методическим рекомендациям.

2. Получить токен ППТ и протестировать корректную работу доработанной ИС заявителя при использовании методов работы с реестром с использованием сервера ППТ.

3. Получить продуктивный токен и переключить ИС заявителя на работу с продуктивным сервером после получения от оператора реестра подтверждения успешного прохождения тестирования ИС заявителя при использовании методов работы с реестром с использованием сервера ППТ.

5.2. Для получения токена ППТ заявитель по электронной почте направляет оператору реестра на адрес culture@gosuslugi.ru заявку на получение токена ППТ с указанием следующих сведений:

1. тема заявки: «Пушкинская карта: токен ППТ»;

2. тип требуемого токена: токен ППТ;

3. тип участника программы:

а) билетный оператор (агрегатор);

б) оператор;

в) организация культуры;

4. ИНН заявителя;

5. краткое наименование заявителя;

6. полное наименование заявителя;

7. контактные данные сотрудника заявителя, ответственного за организационное обеспечение взаимодействия с оператором реестра:

а) ФИО;

б) должность;

в) номер рабочего телефона;

г) номер мобильного телефона (опционально);

д) адрес рабочей электронной почты;

8. контактные данные сотрудника заявителя, ответственного за техническое обеспечение взаимодействия с оператором реестра:

а) ФИО;

б) должность;

в) номер рабочего телефона;

г) номер мобильного телефона (опционально);

д) адрес рабочей электронной почты.

5.3. В случае одобрения заявки оператор реестра фиксирует указанные в заявке контактные данные заявителя и направляет по адресам электронной почты, указанным в заявке (далее — адреса рабочей электронной почты заявителя), следующие сведения:

1. токен ППТ;

2. адрес сервера ППТ.

5.4. Все дальнейшие заявки от заявителя принимаются только с адресов рабочей электронной почты заявителя.

5.5. Для изменения контактных данных заявитель с одного из текущих адресов рабочей электронной почты заявителя направляет оператору реестра на адрес culture@gosuslugi.ru заявку с указанием следующих сведений:

1. тема заявки: «Пушкинская карта: изменение контактных данных»;

2. ИНН заявителя;

3. контактные данные сотрудника заявителя, ответственного за организационное обеспечение взаимодействия с оператором реестра:

а) ФИО;

б) должность;

в) номер рабочего телефона;

г) номер мобильного телефона (опционально);

д) адрес рабочей электронной почты;

4. контактные данные сотрудника заявителя, ответственного за техническое обеспечение взаимодействия с оператором реестра:

а) ФИО;

б) должность;

в) номер рабочего телефона;

г) номер мобильного телефона (опционально);

д) адрес рабочей электронной почты.

5.6 Оператор реестра при получении заявки на изменение контактных данных заявителя выполняет следующие действия:

1. если заявка поступила с адреса рабочей электронной почты заявителя, который является в настоящий момент контактным адресом электронной почты, и заявка содержит все необходимые сведения:

а) одобряет заявку;

б) фиксирует новые контактные данные заявителя;

в) направляет по старым и по новым адресам рабочей электронной почты заявителя уведомление об изменении контактных данных;

2. если заявка поступила с адреса рабочей электронной почты заявителя, который не является в настоящий момент контактным адресом электронной почты, или в заявке отсутствуют какие-либо необходимые сведения:

а) отклоняет заявку;

б) направляет по текущим адресам рабочей электронной почты заявителя уведомление об отказе изменения контактных данных заявителя с разъяснением причины отказа и указанием адреса электронной почты, с которого поступила заявка.

5.7. После получения токена ППТ заявитель осуществляет тестирование доработанной ИС в части использования методов работы с реестром с использованием сервера ППТ и дополнительную доработку ИС (при необходимости).

5.8. После успешного прохождения тестирования доработанной ИС с использованием сервера ППТ заявитель по электронной почте направляет оператору реестра на адрес culture@gosuslugi.ru заявку на получение продуктивного токена с указанием следующих сведений:

1. тема заявки: «Пушкинская карта: продуктивный токен»;

2. тип требуемого токена: продуктивный токен;

3. ИНН заявителя;

4. ИНН организации, проводящей мероприятия, сведения о билетах на которые будут вноситься в реестр с использованием получаемого продуктивного токена (опционально).

5.9. Оператор реестра после получения от заявителя заявки на получение продуктивного токена выполняет следующие действия:

1. проверяет результаты тестирования ИС заявителя в части использования методов работы с реестром с использованием сервера ППТ;

2. в случае успешной реализации в ИС использования методов работы с реестром, обязательных для данного типа участника программы согласно приложению 2 к Методическим рекомендациям, и отсутствии ошибок в части использования прочих методов работы с реестром:

а) фиксирует результаты тестирования;

б) одобряет заявку;

в) направляет по адресам рабочей электронной почты заявителя следующие сведения:

• продуктивный токен;
• адрес продуктивного сервера;

3. в случае выявления по результатам тестирования ИС ошибок в части использования методов работы с реестром, обязательных для данного типа участника программы согласно приложению 2 к Методическим рекомендациям, и (или) наличии ошибок в части использования прочих методов работы с реестром:

в) направляет по адресам рабочей электронной почты заявителя причину отклонения заявки.

5.10. После получения продуктивного токена заявитель настраивает свою ИС для работы с реестром с использованием продуктивного сервера.

5.11. После настройки ИС заявителя для работы с реестром с использованием продуктивного сервера заявитель может получить неограниченное количество дополнительных продуктивных токенов.

5.12. Для получения дополнительного продуктивного токена заявитель по электронной почте направляет оператору реестра на адрес culture@gosuslugi.ru заявку на получение дополнительного продуктивного токена с указанием следующих сведений:

1. тема заявки: «Пушкинская карта: продуктивный токен (дополнительный)»;

2. тип требуемого токена: продуктивный токен;

3. ИНН заявителя;

4. ИНН организации, проводящей мероприятия, сведения о билетах на которые будут вноситься в реестр с использованием получаемого продуктивного токена (опционально).

5.13. Оператор реестра после получения от заявителя заявки на получение дополнительного продуктивного токена выполняет следующие действия:

2. в случае наличия у заявителя хотя бы одного действующего продуктивного токена:

а) фиксирует результаты проверки;

б) одобряет заявку;

в) направляет по адресам рабочей электронной почты заявителя дополнительный продуктивный токен;

3. в случае отсутствия у заявителя хотя бы одного действующего продуктивного токена (в том числе по причине приостановки доступа к реестру в соответствии с положениями разделов 6 и 7 настоящих Методических рекомендацией):

в) направляет по адресам рабочей электронной почты заявителя причину отклонения заявки.

6 Порядок приостановки доступа к реестру по инициативе заявителя

6.1. Заявитель по электронной почте направляет оператору реестра на адрес culture@gosuslugi.ru заявку на приостановку доступа заявителя к реестру с указанием следующих сведений:

1. тема заявки: «Пушкинская карта: приостановка доступа к реестру билетов»;

2. ИНН заявителя;

3. список продуктивных токенов, для которых следует провести приостановку доступа (не менее одного);

4. дата и время приостановки доступа заявителя к реестру с использованием указанных продуктивных токенов.

6.2. В случае одобрения заявки оператор реестра отмечает в указанные в заявке дату и время соответствующие продуктивные токены как недействующие.

6.3. С указанного момента запросы к продуктивному серверу с использованием указанных в заявке продуктивных токенов будут возвращать ошибку авторизации.

7 Особые условия

7.1. В приложении 4 к Методическим рекомендациям описаны особенности внесения заявителями обязательных сведений в реестр.

7.2. При невнесении заявителями в реестр обязательных сведений оператор реестра может приостановить доступ заявителя к реестру без предварительного уведомления (далее — приостановка доступа из-за невыполнения обязательных требований).

7.3. Приостановка доступа заявителя к реестру осуществляется путем отметки всех продуктивных токенов, выданных заявителю, как недействующих.

8 Порядок восстановления доступа к реестру

3. список продуктивных токенов, которые были ранее выданы (не менее одного).

8.3. Оператор реестра после получения от заявителя заявки на восстановление доступа к реестру выполняет следующие действия:

1. проверяет результаты тестирования ИС заявителя в части использования методов работы с реестром с использованием сервера ППТ;

2. проверяет устранение заявителем причин приостановки доступа из-за невыполнения обязательных требований;

3. в случае успешной реализации в ИС использования методов работы с реестром, обязательных для данного типа участника программы согласно приложению 2 к Методическим рекомендациям, отсутствии ошибок в части использования прочих методов работы с реестром и устранении причин приостановки доступа из-за невыполнения обязательных требований:

а) фиксирует результаты тестирования и проверки;

б) одобряет заявку;

в) отмечает указанные в заявке продуктивные токены как действующие;

г) направляет по адресам рабочей электронной почты заявителя уведомление о восстановлении доступа к реестру;

4. в случае выявления по результатам тестирования ИС заявителя ошибок в части использования методов работы с реестром, обязательных для данного типа участника программы согласно приложению 2 к Методическим рекомендациям, и (или) наличии ошибок в части использования прочих методов работы с реестром и (или) неполном устранении заявителем причин приостановки доступа из-за невыполнения обязательных требований:

а) фиксирует результаты тестирования и проверки;

б) отклоняет заявку;

в) направляет по адресам рабочей электронной почты заявителя причину отклонения заявки.

Приложение 1 к Методическим рекомендациям по внесению и получению сведений из реестра сведений о проданных билетах

ОПИСАНИЕ МЕТОДОВ РАБОТЫ С РЕЕСТРОМ В ФОРМАТЕ OPENAPI 3.0.0

Версия от 29.10.2021

Актуальная версия размещена в открытом доступе в информационно-телекоммуникационной сети «Интернет» по адресу: https://docs.culture.ru/tickets/.

В таблице ниже отметки «+» на пересечении строк с названиями методов работы с реестром и столбцов с типами участников программы означают, что для соответствующих типов участников программы реализация в их ИС возможности использования соответствующих методов работы с реестром является обязательной в соответствии с правилами программы «Пушкинская карта».

Метод	Указываемые параметры	Тип участника программы
		Билетный оператор (агрегатор)	Организация культуры	Оператор
Добавление билета в реестр	<без параметров>	+	+
Получение информации о билете	{id} — идентификатора билета
Вернуть билет		+	+
Погасить билет		+	+
Получение информации о сеансе по билету	{event_id} — идентификатор мероприятия + {barcode} — штрихкод
Погасить билет

сведений из реестра сведений о проданных билетах

Операция с билетом	Рекомендуемый срок с момента фактически совершенной операции с билетом, в течение которого участнику программы рекомендуется передать сведения об операции с билетом в реестр
	Билетный оператор (агрегатор)	Организация культуры	Оператор
Продажа	1 час	1 час	Требования не предъявляются
Возврат	12 часов	12 часов
Гашение	12 часов	12 часов

1. При передаче сведений об объекте «Платеж» («Payment») передача атрибута «RRN (Retrieval Reference Number) — уникальный идентификатор транзакции» — является обязательной.

2. Допускается в момент первичной передачи сведений об объекте «Платеж» не передавать атрибут RRN. При этом в течение 3 (трех) календарных дней ИС участника программы должна передать в реестр сведений о проданных билетах обновленную информацию о соответствующем объекте «Платеж».

---