Описание сервиса выгрузки XML файлов со списками записавшихся в инспекцию налогоплательщиков на следующий день.

Введение.

Каждый день в 24:00 по местному времени во всех часовых поясах Российской Федерации происходит генерирование для всех инспекций текущего часового пояса двух файлов с записавшимися налогоплательщиками:

• 
  xls файл, который посылается по электронной почте в инспекцию
  
• 
  xml файл, который хранится в базе данных и готов к отправке через веб-сервис
  

Таким образом, xml файл готов к отгрузке через веб-сервис после процедуры генерации всех файлов, т.е. примерно в 01:00 по местному времени.

Точка доступа.

Существует две точки доступа к сервису:

• 
  Из сети Интернет
  
• 
  Из ведомственной сети ФНС России (СТК ФНС РФ)
  

Для поддержки обратной совместимости, каждая версия сервиса имеет свой отдельный адрес URL. Каждая версия после официального выпуска не будет никак изменяться и будет продолжать работать так же как и в момент официального выпуска.

Доступ из сети Интернет.

Текущая версия сервиса расположена по адресу: https://order.nalog.ru/services/v01.asmx

WSDL описание сервиса расположено по адресу: https://order.nalog.ru/services/v01.asmx?WSDL

Имя сервиса order.nalog.ru должно разрешаться в IP адрес 81.177.34.245.

Доступ должен осуществляться по порту 80. Этот порт открыт для всех сетей интернет.

Доступ из ведомственной сети ФНС.

Текущая версия сервиса расположена по адресу: https://order.tax.nalog.ru/services/v01.asmx

WSDL описание сервиса расположено по адресу: https://order.tax.nalog.ru/services/v01.asmx?WSDL

Имя сервиса order.tax.nalog.ru должно разрешаться в IP адрес 10.251.1.89.

Доступ должен осуществляться по порту 80.

Общее описание сервиса

Если зайти браузером по адресу сервиса, то появится страница описания сервиса. Из него видно, что имя сервиса - OrderService, и что сервис имеет три типа методов:

• 
  LoadXML_*** - Загрузка сведений о записавшихся налогоплательщиках на следующий день
  
• 
  LoadReference_*** - Загрузка справочников
  
• 
  ***Version*** - Версионный контроль.
  

Если зайти по ссылке в любой из методов, то можно увидеть подробные примеры запросов к сервису из двух версий протокола SOAP.

LoadXML

Входные параметры

В всех методах LoadXML_*** входные параметры одинаковы:

• 
  FNSCodeSOUN – строковый идентификатор инспекции, представляется в виде четырехразрядного кода (код налогового органа в соответствии со Справочником кодов обозначений налоговых органов для целей учета налогоплательщиков - СОУН). Например "3435". Список возможных кодов можно получить из справочника FNS
  
• 
  FileDate – дата файла в формате dateTime (например "2012-07-05T00:00:00")
  

Выходные параметры

Первый возвращаемый параметр одинаков для всех методов - ResultCode

Он может содержать следующие значения:

• 
  Ok - Файл выгружен успешно. Можно забирать данные из второго выходного параметра XMLFile
  
• 
  UnexpectedError - Произошла неожиданная ошибка. Надо обратиться к разработчику
  
• 
  NoSuchFile - Файла с запрошенными данными нет. Надо запросить другой файл или запрошенный файл пока еще не сгенерирован.
  
• 
  FileDateIsWrong - Дата файла неверна. Значит она раньше 04.07.2012 или позже текущего времени.
  
• 
  FNSCodeSOUNIsWrong - Код ФНС из справочника СОУН указан неверно. Он не удовлетворяет регулярному выражению ^\d{4}$
  

Второй возвращаемый параметр для всех методов – XMLFile.

В разных методах он возвращается разного типа:

Для метода LoadXML_AsByteArray тип параметра – массив байтов (файл)

Для метода LoadXML_AsString тип параметра – строка

Для метода LoadXML_AsObject тип параметра – набор объектов, которые получаются методом десериализации XML файла из первых двух методов

LoadReference

LoadReference_FNS

Возвращает двухуровневый справочник подразделений ФНС России. На первом уровне располагаются Управления. На втором уровне располагаются Инспекции, относящиеся к выбранному Управлению. Код СОУН, необходимый для вызова функций LoadXML_*** располагаются в поле CodeSOUN на втором уровне справочника, т.к. второй уровень – это уровень Иснспекций. На данный момент для использования в функциях LoadXML_*** доступны следующие коды: 3401, 3407, 3411, 3414, 3417, 3418, 3419, 3420, 3422, 3423, 3425, 3435, 3439, 3443, 3444, 3452, 3453, 3454, 3455, 3456, 3457, 3458, 3459, 3460, 3461, 4801, 4802, 4804, 4807, 4808, 4811, 4813, 4815, 4816, 4821, 4823, 4824, 4825, 4826.

LoadReference_Region

Возвращает возможные идентификаторы и названия регионов, в которых располагаются Управления и Инспекции из справочника FNS (поле Region_ID).

LoadReference_Service

Возвращает двухуровневый справочник Услуг, предоставляемых инспекциями. На первом уровне располагается группировка услуг, на втором – подробное описание услуги. Наименования услуг могут дублироваться, т.к. оказываются разным типам лиц (юр. Лиц, физ. Лиц, ИП). Признак лица содержится в поле Face_ID, а расшифровка этого идентификатора в справочнике Face.

LoadReference_Face

Возвращает справочник лиц для расшифровки поля Face_ID в справочнике Service.

Version

LoadAvailableVersions

Возвращает список доступных на данный момент версий сервиса с конкретными адресами точек доступа.

LoadVersion

Возвращает текущую версию сервиса

Обратная связь

Разработчик данного сервиса – Аксенов Алексей Геннадьевич.

Телефон +7 (495) 913 0000 добавочный 3019

Email: [email protected]