Федеральная служба по надзору в сфере связи, информационных технологий и массовых коммуникаций (Роскомнадзор)

Руководство пользователя 
электронного сервиса смэв

Сервис выдачи информации о лицензиях на осуществление деятельности по изготовлению экземпляров аудиовизуальных произведений, программ для электронных вычислительных машин (программ для ЭВМ), баз данных и фонограмм на любых видах носителей

Дата: 22 июля 2011 г.
Версия: 1.0
Листов: 14

СОДЕРЖАНИЕ
1	Общие сведения
1.1 Руководящие документы
1.2 Описание электронного сервиса
1.3 Операции (методы) электронного сервиса
1.4 Сценарии использования
1.5 Схема взаимодействия
1.6 Связи с другими электронными сервисами
2	Руководство пользователя
2.1 Операция «Запрос информации из реестра плательщиков страховых взносов в государственные внебюджетные фонды»
2.1.1 Общие сведения
2.1.2 Описание входных параметров
2.1.3 Описание выходных параметров
2.1.4 Коды возвратов
2.1.5 Контрольные примеры
3	Методика испытаний
3.1 Общие условия
3.2 Параметры испытаний на тестовой среде
3.3 Параметры испытаний на продуктивной среде
3.4 Особые условия
4	Приложения
4.1 Описание сервиса (WSDL)
4.2 Описание общих структур данных
4.3 Описания справочников

изменения
Версия	Дата	Автор	Изменения	
1.0	21.07.2011	Гаврилина А. М.	Первичное создание	

				

				

				

термины/СОКРАЩЕНИя
Термин/сокращение	Описание	
СМЭВ	Система межведомственного электронного взаимодействия	
Поставщик	Организация-владелец электронного сервиса	
WSDL	Web Services Description Language — язык описания веб-сервисов.	
XSD	XML Schema definition - язык описания структуры XML документа.	
SOAP	Simple Object Access Protocol - протокол обмена структурированными сообщениями в распределённой вычислительной среде.	
XML	eXtensible Markup Language — расширяемый язык разметки.	
Роскомнадзор, РКН	Федеральная служба по надзору в сфере связи, информационных технологий и массовых коммуникаций	
ФОИВ	Федеральный орган исполнительной власти	
Реестр лицензий ВАФ		
1	
Общие сведения
1.1	Руководящие документы
Основанием для разработки данного документа является требование п. 48 Приказа Министерства связи и массовых коммуникаций Российской Федерации от 27 декабря 2010 г. № 190 «Об утверждении технических требований к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия» в соответствии с которым, для подключения информационной системы к системе межведомственного электронного взаимодействия Поставщик предоставляет Оператору СМЭВ следующие документы:
•	паспорт электронного сервиса, регистрируемого в системе взаимодействия;
•	методику испытаний электронного сервиса, регистрируемого в системе взаимодействия, включая контрольный пример обращения к электронному сервису;
•	руководство пользователя электронного сервиса, регистрируемого в системе взаимодействия.
Основанием для создания и использования электронного сервиса являются перечисленные ниже документы.
Нормативно-правовые документы:
•	Постановление Правительства Российской Федерации от 8 сентября 2010 г. № 697 «О единой системе межведомственного электронного взаимодействия»;
•	Приказ Министерства связи и массовых коммуникаций Российской Федерации от 27 декабря 2010 г. № 190 «Об утверждении технических требований к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия».
•	Постановление Правительства Российской Федерации от 28 апреля 2006 г. № 252 «О лицензировании деятельности по изготовлению экземпляров аудиовизуальных произведений, программ для электронных вычислительных машин (программ для ЭВМ), баз данных и фонограмм на любых видах носителей (за исключение случаев, если указанная деятельность самостоятельно осуществляется, обладающими правами на использование указанных объектов авторских и смежных прав в силу Федерального закона или договора)»

Технологические стандарты:
•	Методические рекомендации по разработке веб-сервисов_вер.1.5

1.2	Описание электронного сервиса
Наименование:	Выдача информации о лицензиях на осуществление деятельности по изготовлению экземпляров аудиовизуальных произведений, программ для электронных вычислительных машин (программ для ЭВМ), баз данных и фонограмм на любых видах носителей	
Назначение:	Веб-сервис предназначен для выдачи информации о лицензиях на осуществление деятельности по изготовлению экземпляров аудиовизуальных произведений, программ для электронных вычислительных машин (программ для ЭВМ), баз данных и фонограмм на любых видах носителей	
Поставщик:	Федеральная служба по надзору в сфере связи, информационных технологий и массовых коммуникаций	
Область применения:	Межведомственное взаимодействие	

1.3	Операции (методы) электронного сервиса
Электронный сервис выдачи информации о лицензиях на осуществление деятельности по изготовлению экземпляров аудиовизуальных произведений, программ для электронных вычислительных машин (программ для ЭВМ), баз данных и фонограмм на любых видах носителей обеспечивает получение по запросу любого заинтересованного ФОИВ информации из реестра лицензий ВАФ. Электронный сервис включает методы, обеспечивающие:
•	приём запроса на получение информации.

Метод	Назначение	
Код: getAVLicence
Наименование: Запрос информации из реестра лицензий ВАФ	Получение информации из реестра лицензий ВАФ	

1.4	Сценарии использования
Информационная система любого заинтересованного ФОИВ вызывает сервис и получает информацию из реестра лицензий ВАФ.
Взаимодействие реализовано по синхронной схеме – в ответ на запрос возвращается результат с выгрузкой.

1.5	Схема взаимодействия
В рамках взаимодействия информационная система ФОИВ вызывает сервис. В ответ на этот вызов возвращается выгрузка реестра.

1.6	Связи с другими электронными сервисами
Данный сервис не имеет связей с другими сервисами.
2	
Руководство пользователя
2.1	Операция «Запрос информации из реестра плательщиков страховых взносов в государственные внебюджетные фонды»

2.1.1	Общие сведения
Код операции:	getAVLicence	
Наименование операции:	Запрос информации из реестра лицензий ВАФ	
Назначение операции:	Получение информации из реестра лицензий ВАФ	

2.1.2	Описание входных параметров
Входные данные: getAVLicence
№	Код параметра 	Описание параметра 	Обязательность 	Способ заполнения/Тип 	Комментарий 	
1		Идентификатор лицензии	+	xs:long		

2.1.3	Описание выходных параметров
Выходные данные: getAVLicence Response
№	Код параметра 	Описание параметра 	Обязательность 	Способ заполнения/Тип 	Комментарий 	
1		Дата выдачи лицензии		xs:long		
2		Номер лицензии		xs:long	Дублирует значение входного параметра	
3		Срок действия лицензии		xs:long		
4		Наименование владельца лицензии		xs:string		
5		Статус лицензии		xs:string		

2.1.4	Коды возвратов
№	Код возврата	Описание кода возврата	Условия возникновения	Комментарий	
1	0	реестр выдан	если по году и кварталу реестр найден		
2	1	реестр не найден	если по году и кварталу записей не найдено		
2.1.5	Контрольные примеры
Запрос
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ssm="http://ssmipfrmanager.stateservices.siei.esoft.ru/">
   <soapenv:Header/>
   <soapenv:Body>
      <ssm:getAVLicence >
         <year>2011</year>
      </ssm:getAVLicence >
   </soapenv:Body>
</soapenv:Envelope>	

Ответ на запрос в случае успешного исполнения (код возврата №1)
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:requestSsmipfrResponse xmlns:ns2="http://ssmipfrmanager.stateservices.siei.esoft.ru/">
         <return>
            <quarter>0</quarter>
            <registryData>rO0ABXQEqDw/eG1sIHZlcnNpb249IjEuMCIgZW5jb2Rpbmc9IndpbmRvd3MtMTI1MSI/Pgo8IDU1
QUJAICI4Pz0iIRwYIiAUMEIwIT5BQjAyOzU9OE8dMD0iMTUuMDQuMjAxMSI+PBcwPzhBTCEcGCAU
MEIwEj01QTU9OE89IjI0LjAzLjIwMTEiIB0+PDVAPSIwMi0wMDAwMSI+PB87MEI1O0xJODogHhMg
HT0iMTAyMDIwMzIyMDE4MCIgGB0dPSIwMjc4MDg3MTk1IiAgNTMdPjw1QB8kID0iMDAyLTg3OC0w
MDg3MTkiPjweQDMwPTg3MEY4TyAdMDg8NT0+MjA9ODU9Ih4xSTVBQjI+IEEgPjNAMD04RzU9PT45
ID5CMjVCQUIyNT09PkFCTE4gIiI1OzU6Pjw8Qz04OjBGOD49PUs1ICE1QjggETBIOj5AQj5BQjA9
MCIgIiAhPjpAHTA4PDU9PjIwPTg1PSIeHh4gIiIhESIiIB5AMx9AMDIkPkA8MD0iHjFJNUFCMj4g
QSA+M0AwPThHNT09PjkgPkIyNUJBQjI1PT0+QUJMTiI+PC8eQDMwPTg3MEY4Tz48Lx87MEI1O0xJ
ODo+PB81QDVHNT1MIRwYPjwhHBggHTA3MjA9ODU9IiIiNTs1Oj48PEM9ODowRjg+PT1LNSBBNUI4
IBEwSDo+QEI+QUIwPTAiICgiIiERIikiPjwjR0A1NDhCNTtMIB0wODw1PT4yMD04NT0iHh4eICIi
IREiIj48LyNHQDU0OEI1O0w+PC8hHBg+PC8fNUA1RzU9TCEcGD48LxcwPzhBTCEcGD48FzA/OEFM
IRwYIBQwQjASPTVBNT04Tz0iMjkuMDMuMjAxMSIgHT48NUA9IjAzLTAwMDAxIj48HzswQjU7TEk4
OiAeEyAdPSIxMDIwMzAwNTM1NzE2IiAYHR09IjAzMDMwMDQ3ODAiICA1Mx0+PDVAHyQgPSIwMDMt
MDAzLTAwMDcxIj48HkAzMD04NzBGOE8gHTA4PDU9PjIwPTg1PSIgNTQwOkY4TyBAMDk+PT0+OSAz
MDc1QksgEThHQ0BBOjg5IEU7NTE+QD4xIiAhPjpAHTA4PDU9PjIwPTg1PSIgNTQwOkY4TyAzMDc1
QksgIhE4R0NAQTo4OSBFOzUxPkA+MSIiIB5AMx9AMDIkPkA8MD0iI0dANTY0NT04NSI+PC8eQDMw
PTg3MEY4Tz48Lx87MEI1O0xJODo+PB81QDVHNT1MIRwYPjwhHBggHTA3MjA9ODU9IhE4R0NAQTo4
OSBFOzUxPkA+MSI+PCNHQDU0OEI1O0wgHTA4PDU9PjIwPTg1PSIQNDw4PThBQkAwRjhPIDxDPThG
OD8wO0w9PjM+ID4xQDA3PjIwPThPICIROEdDQEE6ODkgQDA5Pj0iIj48LyNHQDU0OEI1O0w+PCNH
QDU0OEI1O0wgHTA4PDU9PjIwPTg1PSIgNTQwOkY4TyAzMDc1QksgIhE4R0NAQTo4OSBFOzUxPkA+
MSIiPjwvI0dANTQ4QjU7TD48LyEcGD48Lx81QDVHNT1MIRwYPjwvFzA/OEFMIRwYPgo8LyA1NUFC
QD4=</registryData>
            <resultCode>0</resultCode>
            <resultText>реестр выдан</resultText>
            <year>2011</year>
         </return>
      </ns2:requestSsmipfrResponse>
   </S:Body>
</S:Envelope>	

Ответ на запрос с кодом возврата №2
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:requestSsmipfrResponse xmlns:ns2="http://ssmipfrmanager.stateservices.siei.esoft.ru/">
         <return>
            <quarter>0</quarter>            
            <resultCode>1</resultCode>
            <resultText> реестр не найден </resultText>
            <year>2011</year>
         </return>
      </ns2:requestSsmipfrResponse>
   </S:Body>
</S:Envelope>	

3	
Методика испытаний
3.1	Общие условия
Проведение контрольных испытаний при регистрации электронного сервиса регламентировано Приказом Министерства связи и массовых коммуникаций Российской Федерации от 27 декабря 2010 г. № 190 «Об утверждении технических требований к взаимодействию информационных систем в единой системе межведомственного электронного взаимодействия».
Порядок проведения типовых испытаний предполагает следующие этапы:
•	Проверка комплектности предоставленной документации;
•	Проверка сетевой связности между узлом СМЭВ и точкой размещения электронного сервиса;
•	Регистрация сервиса и тестирование сервиса на контрольном примере.
3.2	Параметры испытаний на тестовой среде
Проведение испытаний на тестовой среде перед регистрацией электронного сервиса в продуктивной среде СМЭВ является необходимым действием, обеспечивающим повышение качества и эффективности процесса и позволяющим выявлять ошибки и несоответствия разработанного сервиса заранее, а не в продуктивном контуре.
•	Контактное лицо: Гаврилина Анастасия Михайловна, e-mail: a.gavrilina@rsoc.ru, тел:  (495) 987-68-99 (32-94)
•	Адрес тестового экземпляра: http://89.179.128.50:19090/SsmipfrManager?wsdl
•	Режим функционирования тестовой среды: 24/365 (круглосуточно). Особых условий доступности не определено.
•	Для того чтоб протестировать сервис, необходимо:
•	зарегистрировать сервис на тестовой среде во время ее доступности согласно режиму функционирования,
•	протестировать все операции на основании контрольных примеров.
3.3	Параметры испытаний на продуктивной среде
•	Контактные сведения о лице, ответственном со стороны поставщика за решение вопросов, необходимых для обеспечения регистрации сервиса в продуктивном контуре СМЭВ – Гаврилина Анастасия Михайловна, e-mail: a.gavrilina@rsoc.ru, тел.: 8(495) 987-68-99 (32-94)
•	http://172.16.90.14:7777/gateway/services/SID0003006 
•	тестирование сервиса на контрольном примере.
3.4	Особые условия
нет
4	
Приложения
4.1	Описание сервиса (WSDL)
<?xml version = '1.0' encoding = 'UTF-8'?>
<wsdl:definitions name="SsmipfrManagerService" targetNamespace="http://ssmipfrmanager.stateservices.siei.esoft.ru/" xmlns:ns1="http://schemas.xmlsoap.org/wsdl/soap/http" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://ssmipfrmanager.stateservices.siei.esoft.ru/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <wsdl:types>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="unqualified" targetNamespace="http://ssmipfrmanager.stateservices.siei.esoft.ru/" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:complexType name="requestSsmipfr">
<xs:sequence>
<xs:element name="year" type="xs:long"/>
<xs:element name="quarter" type="xs:long"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="requestSsmipfrResponse">
<xs:sequence>
<xs:element minOccurs="0" name="return" type="tns:ssmipfr"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="ssmipfr">
<xs:sequence>
<xs:element name="quarter" type="xs:long"/>
<xs:element minOccurs="0" name="registryData" type="xs:string"/>
<xs:element name="resultCode" type="xs:long"/>
<xs:element minOccurs="0" name="resultText" type="xs:string"/>
<xs:element name="year" type="xs:long"/>
</xs:sequence>
</xs:complexType>
<xs:element name="requestSsmipfr" nillable="true" type="tns:requestSsmipfr"/>
<xs:element name="requestSsmipfrResponse" nillable="true" type="tns:requestSsmipfrResponse"/>
</xs:schema>
  </wsdl:types>
  <wsdl:message name="requestSsmipfr">
    <wsdl:part element="tns:requestSsmipfr" name="parameters">
    </wsdl:part>
  </wsdl:message>
  <wsdl:message name="requestSsmipfrResponse">
    <wsdl:part element="tns:requestSsmipfrResponse" name="parameters">
    </wsdl:part>
  </wsdl:message>
  <wsdl:portType name="SsmipfrManager">
    <wsdl:operation name="requestSsmipfr">
      <wsdl:input message="tns:requestSsmipfr" name="requestSsmipfr">
    </wsdl:input>
      <wsdl:output message="tns:requestSsmipfrResponse" name="requestSsmipfrResponse">
    </wsdl:output>
    </wsdl:operation>
  </wsdl:portType>
  <wsdl:binding name="SsmipfrManagerServiceSoapBinding" type="tns:SsmipfrManager">
    <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
    <wsdl:operation name="requestSsmipfr">
      <soap:operation soapAction="" style="document"/>
      <wsdl:input name="requestSsmipfr">
        <soap:body use="literal"/>
      </wsdl:input>
      <wsdl:output name="requestSsmipfrResponse">
        <soap:body use="literal"/>
      </wsdl:output>
    </wsdl:operation>
  </wsdl:binding>
  <wsdl:service name="SsmipfrManagerService">
    <wsdl:port binding="tns:SsmipfrManagerServiceSoapBinding" name="SsmipfrManagerImplPort">
      <soap:address location="http://oraas.rt.ru:7777/gateway/services/SID0003122"/>
    </wsdl:port>
  </wsdl:service>
</wsdl:definitions>	

4.2	Описание общих структур данных
1.	getAVLicence
№	Код параметра 	Описание параметра 	Обязательность 	Способ заполнения/Тип 	Комментарий 	
1		Идентификатор лицензии		xs:long		
2.	getAVLicenceResponse
№	Код параметра 	Описание параметра 	Обязательность 	Способ заполнения/Тип 	Комментарий 	
1		Результат обработки документа		tns:ssmipfr		
2.1.	Параметр комплексного типа: tns:ssmipfr
№	Код параметра 	Описание параметра 	Обязательность 	Способ заполнения/Тип 	Комментарий 	
1		Дата выдачи лицензии		xs:long		
2		Номер лицензии		xs:long	Дублирует значение входного параметра	
3		Срок действия лицензии		xs:long		
4		Наименование владельца лицензии		xs:string		
5		Статус лицензии		xs:string		
4.3	Описания справочников
Нет