Методические рекомендации Минцифры и Минкульта РФ по внедрению проекта «Пушкинская карта»
На данной странице собраны копии четырех технических методических рекомендаций, это все необходимые данные для внедрения проекта «Пушкинская карта», ссылки на PDF документы, источники, в конце текста.
Наша компания Цифровая фабрика, по одному из заказов, работала по программированию и настройке передачи данных в билетный реестр из существующего интернет магазина. Это материалы собранные к данному проекту.
Но также я бы рекомендовал ознакомиться с Правилами реализации проекта "Пушкинская карта", официальное название документа "Правила реализации мер по социальной поддержке молодежи в возрасте от 14 до 22 лет для повышения доступности организаций культуры" , документ написан простым и понятным языком, насколько это возможно для официального документа. Все другие документы обязательно ссылаются на правила, и фактически трактовка и объяснение правил.
Методические рекомендации по организационно-технологической подготовке организаций культуры и билетных операторов (агрегаторов) к участию в программе «Пушкинская карта»
Дан перечень шагов для участия в программе «Пушкинская карта» организаций культуры и билетных операторов, а также алгоритм работы после подключения. То есть как работает система и как к ней подключиться.
Методические рекомендации по получению сведений об устройствах терминального доступа, используемых для приема оплаты за билеты на мероприятия программы «Пушкинская карта»
Данные методические указания о получении сведений об устройствах терминального доступа необходимы только билетным операторам (агрегаторам)
Методические рекомендации по внесению и получению сведений из реестра сведений о проданных билетах
Данные методические рекомендации необходимы: билетным операторам (агрегаторам); операторам; организациям культуры. Это обмен с реестром который на Госуслугах. Важнейшая часть настройки и дальнейшей работы.
Методические рекомендации по получению сведений из реестра организаций культуры и реестра мероприятий
Методические рекомендации по организационно-технологической подготовке организаций культуры и билетных операторов (агрегаторов) к участию в программе «Пушкинская карта»
Содержание
1. Общие сведения2. Термины и сокращения3. Порядок организационно-технологической подготовки организаций культуры и билетных операторов (агрегаторов) к участию в программе «Пушкинская карта»
1. Общие сведения
1.1. Методические рекомендации по организационно-технологическойподготовке организаций культуры и билетных операторов (агрегаторов) к участию в программе «Пушкинская карта» (далее разработаны на основании Правил реализации мер по социальной поддержке молодежи в возрасте от 14 до 22 лет для повышения доступности организаций культуры, утвержденных постановлением Правительства Российской Федерации от 8 сентября 2021 г. 1521 «О социальной поддержке молодежи в возрасте от 14 до 22 лет для повышения доступности организаций культуры» (Официальный интернет-портал правовой информации (www.pravo.gov.ru), 2021, 9 сентября, 0001202109090011) (далее - Правила программы «Пушкинская карта»).
1.2. Если не указано иное, в Методических рекомендациях используютсятермины в значениях, определенных в Правилах программы «Пушкинская карта», а также термины и сокращения, определенные в разделе 2 Методических рекомендаций.
1.3. Методические рекомендации описывают предпочтительный порядокорганизационно-технологической подготовки организаций культуры и билетных операторов (агрегаторов) к участию в программе «Пушкинская карта».
2. Термины и сокращения
БО — Билетный оператор (агрегатор)ИС — Информационная системаМетоды прикладного программного интерфейса обмена идентификаторами мероприятий — Методы прикладного программного интерфейса для внесения и получения из платформы «PRO-Культура.РФ» сведений о соответствии идентификаторов мероприятийв СПКБ ОК и БО и идентификаторов мероприятий в платформе в платформе «PRO-Культура.РФ», используемые СПКБ ОК и БО для определения мероприятий, включенных в реестр мероприятий «PRO-Культура.РФ»ОК — Организация культуры Руководство пользователя платформы — Руководство платформы «PRO-Культура.РФ» в виде электронного документа, размещенного в открытом доступе в сети Интернет пользователя по адресу «https://pro.culture.ru/documentation/MR_AIS_EIPSK.pdf» Сеть Интернет — Информационно-телекоммуникационная сеть «Интернет»СПКБ - Совокупность аппаратно-программных комплексов, информационных и (или) автоматизированных систем и сайта (сайтов) в сети Интернет, используемая участником программы «Пушкинская карта» для осуществления продажи и контроля билетов на мероприятияСПКБ ОК - Совокупность следующих СПКБ: собственная СПКБ ОК в случае наличия у ОК таковой; СПКБ БО, которых ОК привлекает для обеспеченияреализации билетов на основании соответствующих договоров и (или) соглашений. Технические параметры УТД - Технические параметры УТД в соответствии с абзацем 18 пункта 3 Правил программы «Пушкинская карта»УТД - Устройство терминального доступа
3. Порядок организационно-технологической подготовки организаций культуры и билетных операторов (агрегаторов) к участию в программе «Пушкинская карта»
3.1. Для подготовки к участию в программе «Пушкинская карта» ОК и БОдолжны последовательно выполнить следующие действия:
Пункт первыйЗарегистрироваться на платформе «PRO.Культура.РФ» в соответствии с разделом «Как зарегистрироваться на платформе» руководства пользователя платформы, в случае если ОК/БО не были зарегистрированы на платформе «PRO.Культура.РФ» ранее;
Пункт второйПолучить от банка-эквайера, предоставляющего УТД для ОК/БО,технические параметры УТД, которые ОК/БО планирует использовать для приема оплаты за билеты на мероприятия, включенные в реестр мероприятий (далее - «белые» УТД);
Пункт третийВнести сведения (в том числе технические параметры) о «белых» УТД в личном кабинете ОК/БО на платформе «РКО.Культура.РФ» в соответствии с разделом «Как создать терминал» руководства пользователя платформы;
Пункт четвертыйНастроить и (или) доработать СПКБ ОК/БО для осуществления продажи билетов на мероприятия, включенные в реестр мероприятий, на сайте (сайтах) в сети Интернет, входящих в состав СПКБ ОК/БО, с использованием кнопки или ссылки «Оплатить «Пушкинской картой»;
Пункт пятыйНастроить и (или) доработать СПКБ ОК/БО для внесения и получения сведений из реестра сведений о проданных билетах в соответствии с Методическими рекомендациями по внесению и получению сведений из реестра сведений о проданных билетах;
Пункт шестойзаключить с оператором соглашение о взаимодействии. (что делать описано в пункте 3.6)
3.2. При реализации подпункта 4 пункта 3.1 настоящих Методических рекомендаций ОК/БО получает доступ к реестрам организаций и мероприятий в соответствии с Методическими рекомендациями по получению сведений из реестра организаций культуры и реестра мероприятий.
3.3. При реализации подпункта 4 пункта 3.1 настоящих Методическихрекомендаций ОК/БО может использовать Методы прикладного программного интерфейса обмена идентификаторами мероприятий в соответствии с описанием, размещенном в открытом доступе в сети Интернет по адресу «http://docs.culture.ru/exchange/
3.4. После выполнения действий, предусмотренных подпунктами 1-5 пункта 3.1 настоящих Методических рекомендаций, ОК/БО направляет по электронной почте на адрес partners@team.culture.ru уведомление в Минкультуры России об организационной и технической готовности к тестированию продажи билетов на мероприятия, включенные в реестр мероприятий, с указанием следующих сведений:
- краткое наименование организации;
- полное наименование организации;
- ИНН организации;
- тип участника программы «Пушкинская карта»:а) организация культуры;б) билетный оператор (агрегатор);
- сайт (сайты) в сети Интернет, входящие в состав СПКБ ОК/БО, на которыхможно проверить функционал оплаты билетов на мероприятия, включенные в реестр мероприятий, с использованием кнопки или ссылки «Оплатить «Пушкинской картой».
3.5. Минкультуры России в течение 3 (трех) рабочих дней проверяет факт выполнения ОК/БО действий, описанных в подпунктах 1, 3, 4, 5 пункта 3.1 настоящих Методических рекомендаций (в части подпункта 5 пункта 3.1 - во взаимодействии с Минцифры России), и в случае корректного выполнения ОК/БО всех действий:
- для ОК: включает ОК в реестр организаций культуры - участниковпрограммы «Пушкинская карта» - и сообщает об этом ОК;
- для БО: производит настройку параметров платформы «PRO.Культура.РФ» таким образом, чтобы БО и её «белые» УТД стали доступны ОК для указания в качестве способов оплаты билетов на мероприятия, включенные в реестр мероприятий, и сообщает от этом БО.
3.6. В 2021 году оператором является АО «Почта Банк», соглашениео взаимодействии с которым заключается в форме принятия оферты, текст которой в открытом доступе в сети Интернет по адресу личном размещен «https://pro.culture.ru/documentation/Conditions_of_engagement.pdf»,кабинете ОК/БО на платформе «РКО.Культура.РФ» после того, как Минкультуры России выполнит действия, описанные в подпункте 1 пункта 3.5 настоящих в Методических рекомендацией (для ОК) или действия, описанные в подпункте 2 пункта 3.5 настоящих Методических рекомендацией (для БО). Принятие оферты осуществляется путем нажатия кнопки «Согласен» в модальном окне, отображаемом в личном кабинете ОК/БО на платформе «РКО.Культура.РФ».3.7. OK после включения в реестр организаций культуры:
- заводит на платформе «РRO.Культура.РФ» мероприятия для рассмотрения экспертными советами и включения в реестр мероприятий в соответствии с разделом «Как проанонсировать событие» руководства пользователя платформы;
- действует в соответствии с Правилами программы «Пушкинская карта»и соглашением о взаимодействии, заключенным с оператором.
3.8. БО после выполнения Минкультуры России действий в соответствиис подпунктом 2 пункта 3.5 настоящих Методических рекомендаций действует в соответствии с Правилами программы «Пушкинская карта» и соглашением о взаимодействии, заключенным с оператором.
3.9. После одобрения экспертным советом как минимум одного мероприятияОК для включения в реестр мероприятий Минкультуры России во взаимодействии с ОК, оператором и Минцифры России:
- выполняет проверку возможности покупки билетов на мероприятия,включенные в реестр мероприятий, на сайте (сайтах) в сети Интернет, входящих в состав СПКБ ОК с использованием кнопки или ссылки «Оплатить «Пушкинской картой»;
- выполняет проверку корректности учета произведенных оплат и купленных билетов:а) в ИС оператора;б) в реестре сведений о проданных билетах;
- выполняет проверку возврата купленных билетов для всех билетов,купленных в ходе проверки;
- выполняет проверку корректности учета произведенных возвратов билетов:а) в ИС оператора;б) в реестре сведений о проданных билетах;
- выполняет проверку невозможности покупки билетов на мероприятия, не включенные в реестр мероприятий, на сайте (сайтах) в сети Интернет, входящих в состав СПКБ ОК, с использованием кнопки или ссылки «Оплатить «Пушкинской картой».
3.10. В случае если в ходе проверки в соответствии с пунктом 3.9 настоящихМетодических рекомендаций выявлены факты некорректного функционирования СПКБ ОК/БО в части невозможности оплаты билетов на мероприятия, включенные в реестр мероприятий, с использованием кнопки или ссылки «Оплатить «Пушкинской картой», или возможности оплаты билетов на мероприятия, не включенные в реестр мероприятий, с использованием кнопки или ссылки «Оплатить «Пушкинской картой», или некорректной передачи СПКБ ОК/БО сведений в реестр сведений о проданных билетах, Минкультуры России может:
- в случае некорректной работы собственной СПКБ ОК: исключитьвозможность использования «белых» УТД ОК для оплаты билетов на мероприятия, включенные в реестр мероприятий, до устранения некорректного функционирования собственной СПКБ ОК;
- в случае использования ОК для реализации билетов СПКБ БО: исключитьвозможность использования «белых» УТД соответствующих БО для оплаты билетов на мероприятия, включенные в реестр мероприятий, до устранения некорректного функционирования СПКБ соответствующих БО.
3.11. В случае, указанном в подпункте 1 пункта 3.10 настоящих Методическихрекомендаций, ОК устраняет причины некорректного функционированиясобственной СПКБ ОК и сообщает об этом в Минкультуры России, повторновыполняя действия, указанные в подпунктах 4 и 5 пункта 3.1 и пункте 3.4 настоящих Методических рекомендаций.
3.12. В случае, указанном в подпункте 2 пункта 3.10 настоящих Методическихрекомендаций, БО устраняет причины некорректного функционирования СПКБ БО и сообщает об этом в Минкультуры России, повторно выполняя действия, указанные в подпунктах 4 и 5 пункта 3.1 и пункте 3.4 настоящих Методических рекомендаций.
Методические рекомендации по получению сведений об устройствах терминального доступа, используемых для приема оплаты за билеты на мероприятия программы «Пушкинская карта»
Содержание
1 Общие сведения 32 Термины и сокращения3 Цели получения доступа к сведениям об УТД4 Порядок получения доступа к сведениям об УТД5 Порядок прекращения доступа к сведениям об УТД
1. Общие сведения
1.1. Методические рекомендации по получению сведений об устройствахтерминального доступа, используемых для приема оплаты за билеты на мероприятия программы «Пушкинская карта» (далее - Методические рекомендации) разработаны на основании Правил реализации мер по социальной поддержке молодежи в возрасте от 14 до 22 лет для повышения доступности организаций культуры, утвержденных постановлением Правительства Российской Федерации от 8 сентября 2021 г. 1521«О социальной поддержке молодежи в возрасте от 14 до 22 лет для повышения доступности организаций культуры» (Официальный интернет-портал правовой информации (www.pravo.gov.m), 2021, 9 сентября, 0001202109090011) (далее - Правила программы «Пушкинская карта»).
1.2. Если не указано иное, в Методических рекомендациях используютсятермины в значениях, определенных в Правилах программы «Пушкинская карта», а также термины и сокращения, определенные в разделе 2 Методических рекомендаций.
1.3. Методические рекомендации описывают предпочтительный порядокполучения сведений об устройствах терминального доступа, используемыхорганизациями культуры и билетными операторами (агрегаторами) для приема оплаты за билеты на мероприятия программы «Пушкинская карта» (далее - УТД).
2. Термины и сокращения
Доступ к сведениям об УТД — Организационная и технологическая возможность заявителя получать сведения об УТД из платформы«PRO.Культура.РФ»Заявитель — Участник программы «Пушкинская карта» (за исключением граждан), заинтересованный в получении сведений об УТДИС — Информационная системаМетоды прикладного программного интерфейса — Методы прикладного программного интерфейса для предоставления заявителям сведений об УТД, реализованные в платформе «PRO-Культура.РФ», используемые ИС заявителей для получения сведений об УТД из платформы «PRO.Культура.РФ» Набор символов, уникальный для каждого заявителя,используемый заявителем для авторизации ИС Токен авторизации заявителя при использовании методов прикладногопрограммного интерфейса
3. Цели получения доступа к сведениям об УТД
Целью получения оператором — участником программы «Пушкинская карта» — доступа к сведениям об УТД является обеспечение организационно-технологической возможности оплаты билетов на посещение мероприятий с использованием карты.
4. Порядок получения доступа к сведениям об УТД
4.1. Заявитель официальным письмом направляет в Министерство культурыРоссийской Федерации запрос на получение доступа к сведениям об УТД, указывая в запросе:
- ИНН заявителя;
- краткое наименование заявителя;
- полное наименование заявителя;
- документ-основание, которым заявитель наделен статусом оператора;
- контактные данные сотрудника, ответственного за организацию получениясведений об УТД со стороны заявителя:а) ФИО;
- должность;в) номер рабочего телефона;г) номер мобильного телефона (опционально);д) адрес рабочей электронной почты.
4.2. Минкультуры России в течение 5 (пяти) рабочих дней рассматриваетполученный запрос и, в случае указания в запросе полных и корректных данных и подтверждения статуса заявителя как оператора, направляет по адресу электронной почты, указанному в запросе, токен авторизации и параметры использования методов прикладного программного интерфейса. В случае получения запроса, содержащего неполные и (или) некорректные сведения, или запроса от заявителя, не являющегося оператором, Минкультуры России направляет заявителю официальный ответ с отказом в предоставлении доступа к сведениям об УТД и разъяснением причин отказа.
4.3. После получения токена авторизации и параметров использования методов прикладного программного интерфейса заявитель настраивает и (или) дорабатывает свою ИС для получения сведений об УТД, используя методы прикладного программного интерфейса в соответствии с описанием, размещенным в открытом доступе в информационно-телекоммуникационной сети «Интернет» по адресу https://pro.culture.ru/documentation/export_API_pushkinsCardEvents_PRO.pdf
5. Порядок прекращения доступа к сведениям об УТД
Минкультуры России прекращает доступ заявителя к сведениям об УТДв течение 1 (одного) рабочего дня после того, как заявитель утрачивает статусоператора, путем аннулирования токена авторизации, ранее выданного заявителю.
Методические рекомендациипо внесению и получению сведенийиз реестра сведений о проданных билетах
Содержание
1. Общие сведения2. Термины и сокращения3. Цели и задачи4. Условия получения доступа к реестру5. Порядок получения доступа к реестру6. Порядок приостановки доступа к реестру по инициативе заявителя7. Особые условия8. Порядок восстановления доступа к рееструПриложение 1Приложение 2Приложение 3Приложение 4
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. Условия получения доступа к реестру
Для внесения и получения сведений из реестра заявитель должен относиться к одной из следующих категорий участников программы:
- билетные операторы (агрегаторы);
- операторы;
- организации культуры.
5. Порядок получения доступа к реестру
5.1. Для получения доступа к реестру заявителю рекомендуетсяпоследовательно выполнить следующие действия:
- Доработать ИС заявителя для реализации возможности использованияметодов работы с реестром, описанных в приложении 1 к Методическимрекомендациям. Перечень методов работы с реестром, возможность использования которых должна быть обязательно реализована в ИС заявителя, зависит от типа участника программы и приведен в приложении 2 к Методическим рекомендациям. Рекомендованные сроки внесения сведений в реестр указаны в приложении 3 к Методическим рекомендациям.
- Получить токен ППТ и протестировать корректную работу доработанной ИС заявителя при использовании методов работы с реестром с использованием сервера ППТ.
- Получить продуктивный токен и переключить ИС заявителя на работус продуктивным сервером после получения от оператора реестра подтверждения успешного прохождения тестирования ИС заявителя при использовании методов работы с реестром с использованием сервера ППТ.
5.2. Для получения токена ППТ заявитель по электронной почте направляет оператору реестра на адрес culture@gosuslugi.ru заявку на получение токена ППТ с указанием следующих сведений:
- тема заявки: «Пушкинская карта: токен ППТ»;
- тип требуемого токена: токен ППТ;
- тип участника программы:а) билетный оператор (агрегатор);б) оператор;в) организация культуры;
- ИНН заявителя;
- краткое наименование заявителя;
- полное наименование заявителя;
- контактные данныеза организационное обеспечение взаимодействия с оператором реестра:а) ФИО;б) должность;в) номер рабочего телефона;г) номер мобильного телефона (опционально);д) адрес рабочей электронной почты;
- контактные данные сотрудника заявителя, ответственного за техническоеобеспечение взаимодействия с оператором реестра:а) ФИО;б) должность;в) номер рабочего телефона;г) номер мобильного телефона (опционально);д) адрес рабочей электронной почты.сотрудника заявителя, ответственного
5.3. В случае одобрения заявки оператор реестра фиксирует указанные в заявке контактные данные заявителя и направляет по адресам электронной почты, указанным в заявке (далее адреса рабочей электронной почты заявителя), следующие сведения:
- токен ППТ;
- адрес сервера ППТ.
5.4. Все дальнейшие заявки от заявителя принимаются только с адресов рабочей электронной почты заявителя.
5.5. Для изменения контактных данных заявитель с одного из текущих адресов рабочей электронной почты заявителя направляет оператору реестра на адрес culture@gosuslugi.ru заявку с указанием следующих сведений:
- тема заявки: «Пушкинская карта: изменение контактных данных»;
- ИНН заявителя;
- контактные заявителя, ответственногоза организационное обеспечение взаимодействия с оператором реестра:а) ФИО;б) должность;в) номер рабочего телефона;г) номер мобильного телефона (опционально);д) адрес рабочей электронной почты;
- контактные данные сотрудника заявителя, ответственного за техническоеобеспечение взаимодействия с оператором реестра:а) ФИО;б) должность;в) номер рабочего телефона;г) номер мобильного телефона (опционально);д) адрес рабочей электронной почты.
5.6. Оператор реестра при получении заявки на изменение контактных данных данные сотрудника заявителя выполняет следующие действия:
- если заявка поступила с адреса рабочей электронной почты заявителя,который является в настоящий момент контактным адресом электронной почты, и заявка содержит все необходимые сведения:а) одобряет заявку;б) фиксирует новые контактные данные заявителя;в) направляет по старым и по новым адресам рабочей электронной почтызаявителя уведомление об изменении контактных данных;
- если заявка поступила с адреса рабочей электронной почты заявителя,который не является в настоящий момент контактным адресом электронной почты, или в заявке отсутствуют какие-либо необходимые сведения:а) отклоняет заявку;б) направляет по текущим адресам рабочей электронной почты заявителяуведомление об отказе изменения контактных данных заявителя с разъяснением причины отказа и указанием адреса электронной почты, с которого поступила заявка.
5.7. После получения токена ППТ заявитель осуществляет тестирование доработанной ИС в части использования методов работы с реестром с использование сервера ППТ и дополнительную доработку ИС (при необходимости).
5.8. После успешного прохождения тестирования доработанной ИС с использованием сервера ППТ заявитель по электронной почте направляет оператору реестра на адрес culture@gosuslugi.ru заявку на получение продуктивного токена с указанием следующих сведений:
- тема заявки: «Пушкинская карта: продуктивный токен»;
- тип требуемого токена: продуктивный токен;
- ИНН заявителя;
- ИНН организации, проводящей мероприятия, сведения о билетах на которые будут вноситься в реестр с использованием получаемого продуктивного токена (опционально).
5.9. Оператор реестра после получения от заявителя заявки на получениепродуктивного токена выполняет следующие действия:
- проверяет результаты тестирования ИС заявителя в части использованияметодов работы с реестром с использованием сервера ППТ;
- в случае успешной реализации в ИС использования методов работыс реестром, обязательных для данного типа участника программы согласно приложению 2 к Методическим рекомендациям, и отсутствии ошибок в части использования прочих методов работы с реестром:а) фиксирует результаты тестирования;б) одобряет заявку;в) направляет по адресам рабочей электронной почты заявителя следующие сведения:
- продуктивный токен;
- адрес продуктивного сервера;
- в случае выявления по результатам тестирования ИС ошибок в частииспользования методов работы с реестром, обязательных для данного типа участника программы согласно приложению 2 к Методическим рекомендациям, и (или) наличии ошибок в части использования прочих методов работы с реестром:а) фиксирует результаты тестирования;б) отклоняет заявку;в) направляет по адресам рабочей электронной почты заявителя причинуотклонения заявки.
5.10. После получения продуктивного токена заявитель настраивает свою ИС для работы с реестром с использованием продуктивного сервера.
5.11. После настройки ИС заявителя для работы с реестром с использованием продуктивного сервера заявитель может получить неограниченное количество дополнительных продуктивных токенов.
5.12. Для получения дополнительного продуктивного токена заявитель по электронной почте направляет оператору реестра на адрес culture@gosuslugi.ru заявкуна получение дополнительного продуктивного токена с указанием следующих сведений:
- тема заявки: «Пушкинская карта: продуктивный токен (дополнительный)»;
- тип требуемого токена: продуктивный токен;
- ИНН заявителя;
- ИНН организации, проводящей мероприятия, сведения о билетах на которые будут вноситься в реестр с использованием получаемого продуктивного токена (опционально).
5.13. Оператор реестра после получения от заявителя заявки на получение дополнительного продуктивного токена выполняет следующие действия:
- проверяет у заявителя наличие действующего продуктивного токена;
- в случае наличия у заявителя хотя бы одного действующего продуктивного токена:а) фиксирует результаты проверки;б) одобряет заявку;в) направляет по адресам рабочей электронной почты заявителядополнительный продуктивный токен;
- в случае отсутствия у заявителя хотя бы одного действующегопродуктивного токена (в том числе по причине приостановки доступа к реестру в соответствии с положениями разделов 6 и 7 настоящих Методических рекомендацией):а) фиксирует результаты проверки;б) отклоняет заявку;в) направляет по адресам рабочей электронной почты заявителя причинуотклонения заявки.
6. Порядок приостановки доступа к реестру по инициативе заявителя
6.1. Заявитель по электронной почте направляет оператору реестра на адресculture@gosuslugi.ru заявку на приостановку доступа заявителя к реестру с указанием следующих сведений:
- тема заявки: «Пушкинская карта: приостановка доступа к реестру билетов»;
- ИНН заявителя;
- список продуктивных токенов, для которых следует провести приостановкудоступа (не менее одного);
- дата и время приостановки доступа заявителя к реестру с использованиемуказанных продуктивных токенов.6.2. В случае одобрения заявки оператор реестра отмечает в указанное в заявкедату и время соответствующие продуктивные токены, как недействующие.6.3. С указанного момента запросы к продуктивному серверу с использованиемуказанных в заявке продуктивных токенов будут возвращать ошибку авторизации.
7. Особые условия
7.1. В приложении 4 к Методическим рекомендациям описаны особенностивнесения заявителями обязательных сведений в реестр.
7.2. При невнесении заявителями в реестр обязательных сведений операторреестра может приостановить доступ заявителя к реестру без предварительного уведомления (далее - приостановка доступа из-за невыполнения обязательных требований).
7.3. Приостановка доступа заявителя к реестру осуществляется путем отметкивсех продуктивных токенов, выданных заявителю, как недействующих.
8. Порядок восстановления доступа к реестру
В случае если доступ заявителя к реестру по каким-то причинам былприостановлен, для восстановления доступа к реестру заявителю рекомендуется последовательно выполнить следующие действия:
8.1. Проверить работоспособность своей ИС в части использования методовработы с реестром с сервером ППТ с использованием ранее выданного токена ППТ.
8.2. Направить оператору реестра на адрес culture@gosuslugi.m заявкуна восстановление доступа к реестру с указанием следующих сведений:
- тема заявки: «Пушкинская карта: восстановление доступа к рееструбилетов»;
- ИНН заявителя;
- список продуктивных токенов, которые были ранее выданы (не менееодного).8.3. Оператор реестра после получения от заявителя заявки на восстановлениедоступа к реестру выполняет следующие действия:
- проверяет результаты тестирования ИС заявителя в части использованияметодов работы с реестром с использованием сервера ППТ;
- проверяет устранение заявителем причин приостановки доступа из-заневыполнения обязательных требований;
- в случае успешной реализации в ИС использования методов работыс реестром, обязательных для данного типа участника программы согласно приложению 2 к Методическим рекомендациям, отсутствии ошибок в части использования прочих методов работы с реестром и устранении причин приостановки доступа из-за невыполнения обязательных требований:а) фиксирует результаты тестирования и проверки;б) одобряет заявку;в) отмечает указанные в заявке продуктивные токены, как действующие;г) направляет по адресам рабочей электронной почты заявителя уведомление о восстановлении доступа к реестру;
- в случае выявления по результатам тестирования ИС заявителя ошибокв части использования методов работы с реестром, обязательных для данного типа участника программы согласно приложению 2 к Методическим рекомендациям, и (или) наличии ошибок в части использования прочих методов работы с реестром и (или) неполном устранение заявителем причин приостановки доступа из-заневыполнения обязательных требований:а) фиксирует результаты тестирования и проверки;б) отклоняет заявку;10в) направляет по адресам рабочей электронной почты заявителя причинуотклонения заявки.
Приложение 1к Методическим рекомендациям по внесению и получениюсведений из реестра сведений о проданных билетах
Описание методов работы с реестром в формате OpenAPI З.0.0
Версия от 29.10.2021Актуальная версия размещена в открытом доступе в информационно-телекоммуникационной сети « Интернет» по адресу по адресу https://docs.culture.ru/tickets/
openapi: 3.0.0
info:
title:
'Работа с билетами'
description: 'API для передачи информации в реестр сведений о билетах'
version:
'0.1.5'
servers:
- description: UAT
url: https://pushka-uat.test.gosuslugi.ru/api/vl
- description: PROD
url: https://pushka.gosuslugi.ru/api/vl/
paths:
'/tickets':
post:
summary: Добавление билета в реестр
description: Добавить в реестр информацию о билете, купленном по Пушкинской карте
tags: [ Продавцы билетов ]
requestBody:
required: true
content:
application/json:
schema:
$ref: 'tf/components/schemas/CreateTicketRequest'
responses:
'201':
description: Created
content:
application/json:
schema:
$ref: '#/components/schemas/Ticket'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse
/tickets/{id}':
get:
summary: Получение информации о билете
description: Запросить билет по ID
tags: [ Продавцы билетов ]
parameters:
- name: id
in: path
description: ID билета
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/Ticket
'400' :
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse
/tickets/{id}/refund':
put:
summary: Вернуть билет
description: Добавить информацию о возврате билета
tags: [ Продавцы билетов ]
parameters:
- name: id
in: path
description: ID билета
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/RefundTicketRequest
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/RefundResult
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse
'/tickets/{id}/visit':
put:
summary: Погасить билет
description: Добавить в билет информацию о посещении
tags: [ Продавцы билетов ]
parameters:
- name: id
in: path
description: ID билета
required: true
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/VisitTicketRequest'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/VisitResult
400’:
description: Bad Request
content:
application/json:
schema:
$ref: 'jf/components/schemas/ErrorResponse
/events/{event id}/tickets/{barcode}':
get:
summary: Получение информации о сеансе по билету
description: Получение информации о сеансе по QR и ID события
tags: [ Контролёры билетов ]
parameters:
- name: event_id
in: path
description: ID мероприятия в ПРО.Культура
required: true
schema:
type: string
- name: barcode
in: path
required: true
description: ШК билета
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: #/components/schemas/TicketInfо *
'400’:
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'/events/{event_id}/tickets/{barcode}/visit':
put:
summary: Погасить билет
description: Добавить в билет информацию о посещении
tags: [ Контролёры билетов ]
parameters:
- name: event_id
in: path
description: ID мероприятия в ПРО.Культура
required: true
schema:
type: string
- name: barcode
in: path
required: true
description: ШК билета
requestBody:
required: true
content:
application/json:
schema:
$ref: #/components/schemas/VisitTicketRequest
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/VisitResult
400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
schemas:
CreateTicketRequest:
type: object
properties:
barcode:
type: string
description: ШК билета (QR-код)
visitor:
$ref: '#/components/schemas/Visitor'
buyer:
$ref: '#/components/schemas/Buyer'
session:
$ref: '#/components/schemas/Session'
payment:
$ref: '#/components/schemas/Payment'
comment:
type: string
description: Комментарий (для билета)
required:
- barcode
- visitor
- buyer
- session
- payment
RefundTicketRequest:
type: object
properties:
refund_date:
type: integer
description: Дата возврата билета (unix timestamp)
refund_reason:
type: string
description: Причина возврата
refund_rrn:
type: string
description: RRN (Retrieval Reference Number) уникальный идентификатор
транзакции возврата
refund_ticket_price:
type: string
description: Сумма возврата
comment:
type: string
description: Комментарий
required:
- refund_date
- refund reason
VisitTicketRequest:
type: object
properties:
visit_date:
type: integer
description: Дата посещения (гашения) (unix timestamp)
comment:
type: string
description: Комментарий
required:
- visit date
Buyer:
type: object
description: Участник программы
properties:
mobile_phone:
type: string
description: Мобильный телефон (10 цифр)
required:
- mobile_phone
Visitor:
type: object
description: Посетитель мероприятия
properties:
full_name:
description: ФИО (целиком)
type: string
first_name:
description: Имя
type: string
middle_name:
description: Отчество
type: string
last_name:
description: Фамилия
type: string
required:
- full name
Session:
type: object
description: Сеанс
properties:
event_id:
type: string
description: ID мероприятия в PRO.Культура
organization_id:
type: string
description: ID организации в Про.Культура
date:
type: integer
description: Дата/Время проведения сеанса (unix timestamp)
place:
type: string
description: Адрес/описание места проведения мероприятия
params:
type: string
description: Зал+Сектор+Ряд+Место
required:
- event_id
- organization_id
- date
- ticket price
Payment:
type: object
description: Платеж
properties:
id:
type: string
description: ID платежа у Билетного оператора
rrn:
type: string
description: RRN (Retrieval Reference Number) уникальный идентификатор
транзакции
date:
type: integer
description: Дата/время совершения платежа (unix timestamp)
ticket_price:
type: string
description: Цена билета (номинал)
amount:
type: string
description: Сумма платежа по Пушкинской карте
required:
- date
- amount
Ticket:
type: object
description: Купленный билет
properties:
id:
type: string
description: ID билета
barcode:
type: string
description: ШК билета (QR-код)
status:
$ref: '#/components/schemas/Status'
visitor:
$ref: '#/components/schemas/Visitor
buyer:
$ref: '#/components/schemas/Buyer'
session:
$ref: '#/components/schemas/Session
payment:
$ref: 1 #/components/schemas/Payment
visit_date:
type: integer
description: Дата посещения (гашения) (unix timestamp)
refund_date:
type: integer
description: Дата возврата билета (unix timestamp)
refund_reason:
type: string
description: Причина возврата
refund_rrn:
type: string
description: RRN (Retrieval Reference Number) уникальный идентификатор
транзакции возврата
refund ticket_price:
type: string
description: Сумма возврата
comment:
type: string
description: Комментарий (для билета)
required:
- id
- barcode
- status
- visitor
- buyer
- session
- payment
Status:
type: string
enum:
- active
- visited
- refunded
- canceled
ErrorResponse:
type: object
properties:
code:
type: string
description: Код ошибки
required:
- code
- description
RefundResult:
type: object
description: Купленный билет
properties:
refund_date:
type: integer
description: Дата возврата билета (unix timestamp)
refund_reason:
type: string
description: Причина возврата
refund_rrn:
type: string
description: RRN (Retrieval Reference Number) уникальный идентификатор
транзакции возврата
refund_ticket_price:
type: string
description: Сумма возврата
status:
$ref: '#/components/schemas/Status
required:
- refund_date
- refund_reason
- status
VisitResult:
type: object
description: Купленный билет
properties:
visit date:
type: integer
description: Дата погашения билета (unix timestamp)
status:
$ref: 1 #/components/schemas/Status ?
required:
- visit_date
- status
Ticketlnfо:
type: object
description: Информация о билете для билетных систем
properties:
status:
$ref: '#/components/schemas/Status'
session:
$ref: '#/components/schemas/Session'
security:
- bearerAuth: [ ]
к Методическим рекомендациям по внесению и получениюсведений из реестра сведений о проданных билетах
Методы работы с реестром, реализация возможности использования которых в информационных системах участников программы является обязательной в соответствии с правилами программы «Пушкинская карта»
В таблице ниже отметки «+» на пересечении строк с названиями методовработы с реестром и столбцов с типами участников программы означают, чтодля соответствующих типов участников программы реализация в их ИС возможностииспользования соответствующих методов работы с реестром является обязательнойв соответствии с правилами программы «Пушкинская карта».Тип участника программыУказываемыепараметрыБилетный ОрганизациякультурыМетод оператор Оператор(агрегатор)Добавлениебилета в реестр <без параметров> + +Получениеинформации обилете {id} -идентификатораВернуть билет билета + +Погасить билет + +{event_id} -идентификатормероприятияПолучениеинформации осеансе побилету +{barcode} - штрих-Погасить билет код
Приложение 3к Методическим рекомендациям по внесению и получениюсведений из реестра сведений о проданных билетах
Рекомендуемые сроки внесения сведенийв реестр сведений о проданных билетах
При продаже, возврате и гашении (признании недействительным) билетаучастникам программы рекомендуется вносить соответствующие сведения в реестр в сроки, не превышающие сроки, указанные в таблице ниже.
Рекомендуемый срок с момента фактически совершеннойоперации с билетом, в течение которого участнику программырекомендуется передать сведения об операции с билетом в реестрОперация с билетом Билетный оператор (агрегатор)Организация Оператор культуры Продажа 1 час 1 час Требования непредъявляются Возврат 12 часов 12 часов Гашение 12 часов 12 часов
Приложение 4к Методическим рекомендациям по внесению и получениюсведений из реестра сведений о проданных билетах
Особенности внесения обязательных сведений в реестр сведений о проданных билетах
- При передаче сведений об объекте «Платеж» («Payment») передача атрибута «RRN (Retrieval Reference Number) - уникальный идентификатор транзакции» - является обязательной.
- Допускается в момент первичной передачи сведений об объекте «Платеж» не передавать атрибут RRN. При этом в течение 3 (трех) календарных дней ИС участника программы должна передать в реестр сведений о проданных билетах обновленную информацию о соответствующем объекте «Платеж».
Методические рекомендации по получению сведений из реестра организаций культуры и реестра мероприятий
Содержание
1 Общие сведения2 Термины и сокращения3 Цели получения доступа к реестрам организаций и мероприятий4 Порядок получения доступа к реестрам организаций и мероприятий5 Порядок прекращения доступа к реестрам организаций и мероприятий
1. Общие сведения
1.1. Методические рекомендации по получению сведений из реестраорганизаций культуры и реестра мероприятий (далее - Методические рекомендации) разработаны на основании Правил реализации мер по социальной поддержке молодежи в возрасте от 14 до 22 лет для повышения доступности организаций культуры, утвержденных постановлением Правительства Российской Федерации от 8 сентября 2021 г. 1521 «О социальной поддержке молодежи в возрасте от 14 до 22 лет для повышения доступности организаций культуры» (Официальный интернет- портал правовой информации (www.pravo.gov.ru), 2021, 9 сентября,0001202109090011) (далее - Правила программы «Пушкинская карта»).
1.2. Если не указано иное, в Методических рекомендациях используютсятермины в значениях, определенных в Правилах программы «Пушкинская карта»,а также термины и сокращения, определенные в разделе 2 Методическихрекомендаций.
1.3. Методические рекомендации описывают предпочтительный порядокполучения заявителем сведений из реестра организаций культуры и реестрамероприятий.
2. Термины и сокращения
Доступ к реестрам организаций и мероприятий — Организационная и технологическая возможность заявителя получать сведения из реестра организаций культуры и реестра мероприятий, размещенных наплатформе «Р110.Культура.РФ»Участник программы «Пушкинская карта»(за исключением граждан), заинтересованныйв получении сведений из реестра организаций культурыи реестра мероприятийЗаявительИС — Информационная системаМетоды прикладного программного интерфейса —Методы прикладного программного интерфейса для предоставления заявителям сведений из реестра организаций культуры и реестра мероприятий, реализованные в платформе «РЯО.Культура.РФ»,используемые ИС заявителей для получения сведений из реестра организаций культуры и реестра мероприятий Набор символов, уникальный для каждого заявителя, используемый заявителем для авторизации ИСТокен авторизации заявителя при использовании методов прикладногопрограммного интерфейса
3. Цели получения доступа к реестрам организаций и мероприятий
Целью получения участником программы «Пушкинская карта» (далее -участник программы) доступа к реестрам организаций и мероприятий является:
- для Министерства цифрового развития, связи и массовых коммуникаций Российской Федерации - обеспечение функционирование мобильного приложения «Госуслуги Культура»;
- для федерального казенного учреждения - ведение реестра организацийкультуры, ведение реестра мероприятий, контроль выполнения рекомендации по заполнению реестра организаций культуры и реестра мероприятий, организационное и информационное обеспечение реализации мер социальной поддержки молодежи в возрасте от 14 до 22 лет для повышения доступности организаций культуры;для организаций культуры - обеспечение реализации билетов на мероприятия, в том числе посредством сети «Интернет»;
- для билетных операторов (агрегаторов) технологической возможности оплаты картой на своих сайта в сети «Интернет» билетов на мероприятия, включенные в реестр мероприятий, проводимые организациями культуры, и недопущение оплаты картой билетов на мероприятия, не включенные в реестр мероприятий.
4. Порядок получения доступа к реестрам организаций и мероприятий
4.1. Заявитель по электронной почте направляет в Министерство культурыРоссийской Федерации на адрес partners@team.culture.ru запрос на получение доступа к реестрам организаций и мероприятий, указывая в запросе:
- Тема: Пушкинская карта: доступ к реестру организаций и мероприятий
- ИНН заявителя;
- краткое наименование заявителя;
- полное наименование заявителя;
- тип участника программы:а) Министерство цифрового развития, связи и массовых коммуникацийРоссийской Федерации;
- федеральное казенное учреждение;в) организация культуры;г) билетный оператор (агрегатор);б) контактные данные сотрудника, ответственного за организацию получениясведений из реестров организаций и мероприятий со стороны заявителя:а) ФИО;б) должность;в) номер рабочего телефона;г) номер мобильного телефона (опционально);д) адрес рабочей электронной почты.5
4.2. Минкультуры России в течение 5 (пяти) рабочих дней рассматриваетполученный запрос и, в случае указания в запросе полных и корректных данных и подтверждения статуса заявителя как участника программы заявленного типа, направляет по адресу электронной почты, указанному в запросе, токен авторизации. В случае получения запроса, содержащего неполные и (или) некорректные сведения, или запроса от заявителя, не являющегося участником программы из перечня участников программы, упомянутых в абзацах 2-5 раздела 3 настоящих Методических рекомендаций, Минкультуры России направляет заявителю ответ с отказом в предоставлении доступа к реестрам организаций и мероприятийи разъяснением причин отказа.
4.3. После получения токена авторизации заявитель настраивает и (или)дорабатывает свою ИС для получения сведений из реестров организацийи мероприятий, используя методы прикладного программного интерфейсав соответствии с описанием, размещенным в открытом доступе в информационно-телекоммуникационнойhttps://pro.culture.ru/documentation/export_API_PRO.pdf.сети «Интернет» по адресу
5. Порядок прекращения доступа к реестрам организаций и мероприятий
Минкультуры России прекращает доступ заявителя к реестрам организацийи мероприятий в течение 1 (одного) рабочего дня после того, как заявитель пересталбыть участником программы из перечня участников программы, упомянутыхв абзацах 2-5 раздела 3 настоящих Методических рекомендаций, путеманнулирования токена авторизации, ранее выданного заявителю.
Подписывайтесь на новости Цифровой фабрики в Telegram:
Журнал Цифровая фабрика — всё об использовании новых технологий в жизни, культуре и продажах
Обложка: Midjourney
Источники:
Методические рекомендации по организационно-технологической подготовке организаций культуры и билетных операторов (агрегаторов) к участию в программе «Пушкинская карта» (скачать)Методические рекомендации по получению сведений об устройствах терминального доступа, используемых для приема оплаты за билеты на мероприятия программы «Пушкинская карта» (скачать)Методические рекомендации по внесению и получению сведений из реестра сведений о проданных билетах (скачать)Методические рекомендации по получению сведений из реестра организаций культуры и реестра мероприятий (скачать)