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

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


Введение.


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

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

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

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


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

  • Из сети Интернет доступен только контур разработки
  • Из ведомственной сети ФНС России (СТК ФНС РФ) доступен промышленный контур

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

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

Из сети Интернет доступен только контур разработки

Информационные материалы расположены по адресу: https://dev-order.nalog.ru/services/v05.asmx

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

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

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

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

Информационные материалы расположены по адресу: http://order.tax.nalog.ru/services/v05.asmx

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

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

Доступ должен осуществляться по порту 80. В будущем доступ будет осуществляться по протоколу https по порту 443

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

Сервис имеет четыре типа методов:

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

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 файла из первых двух методов

UploadXML


UploadXML_TaxPayer (начиная с v03)

Принимает сведения для анализа обслуживания налогоплательщиков в течение дня. При повторной загрузке файла с теми же параметрами инспекции и даты, старый файл перезаписывается. Файл должен быть в кодировке Windows-1251

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

Входные параметры одинаковы для всех методов UploadXML_***.

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

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

Возвращаемый параметр одинаков для всех методов UploadXML_*** - UploadResult

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

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

При загрузке загружаемый файл проверяется по XSD-схеме, если файл проверку не проходит, ответ в параметре Error возвращается текст ошибки XML файла, из-за которой проверка не прошла. В передаваемом файле запрещены внешние ENTITY


UploadXML_Operator (начиная с v03)

Принимает сведения для анализа работы операторов в течение дня. При повторной загрузке файла с теми же параметрами инспекции и даты, старый файл перезаписывается. Файл должен быть в кодировке Windows-1251


UploadXML_Anket (начиная с v04)

Принимает сведения c результатами анкетирования. При повторной загрузке файла с теми же параметрами инспекции и даты, старый файл перезаписывается. Файл должен быть в кодировке Windows-1251

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. Если у услуги на втором уровне установлен флаг IsFirst – то эта услуга должна быть отображена на первом уровне (Подробное описание по работе с флагом IsFirst описано ниже в документе).


LoadReference_FNSService (начиная с v02)

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

LoadReference_Face

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

LoadReference_Service_For_Anket (начиная с v04)

Возвращает список услуг доступных для проведения анкетирования.


LoadReference_Anket_Question (начиная с v04)

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

Version


LoadAvailableVersions

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


LoadVersion

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


Подробное описание изменений, связанных с добавлением свойства IsFirst

В функции, возвращающие список услуг:


LoadReference_Service - Загрузка общего двухуровневого справочника услуг,

LoadReference_FNSService - Загрузка двухуровневого справочника услуг, используемого в конкретной инспекции, на конкретную дату,

LoadReference_Service_For_Anket - Загрузка справочника услуг доступных для проведения анкетирования,


внесены изменения в возвращаемые типы Service и FNSService в части добавления нового поля IsFirst.

Терминал СУО должен позволять осуществлять запись заявителей на часть услуг первого уровня. В новой версии web-сервиса – v05 услуги, на которые необходима запись на первом уровне, отмечены отдельным признаком.

Часть услуг второго уровня должна отображаться в терминале СУО как услуги первого уровня. В структуру описания услуг добавлено дополнительное поле IsFirst, принимающее значение True для тех услуг, которые необходимо отображать на первом уровне.

В web-сервисе v4 все услуги возвращаются в виде двухуровневого дерева, где записаться можно только на услуги второго уровня. Кроме одного исключения – услуги «Сверка», которая находится на первом уровне. В web-сервисе v5 услуга «Сверка» перенесена на второй уровень и обрабатывать её специальными алгоритмами не требуется.

В web-сервисе v05 услуги возвращаются так же в виде двухуровневого дерева. В связи с чем у части услуг первого уровня на втором уровне лежат одноименные услуги, но разбитые на три услуги по категориям налогоплательщиков (как это реализовано по всем остальным услугам). Для этих услуг необходимо выбирать одноименную услугу на втором уровне в зависимости от выбранной категории налогоплательщиков и выводить её для записи на первом уровне.


Пример:


Стандартные услуги:

Name   Face

1 уровень: Приём/выдача документов, информирование

2 уровень:   Приём документов по контрольным мероприятиям ФЛ

       Приём документов по контрольным мероприятиям ЮЛ

       Приём документов по контрольным мероприятиям ИП

       Приём/выдача документов (заявления, обращения, справки) ФЛ

       Приём/выдача документов (заявления, обращения, справки) ЮЛ

       Приём/выдача документов (заявления, обращения, справки) ИП  


Одноименные услуги:

1 уровень: Урегулирование задолженности

2 уровень: Урегулирование задолженности ФЛ

Урегулирование задолженности ИП

Урегулирование задолженности ЮЛ


До настоящего момента на экране терминала СУО после определения категории налогоплательщика (ФЛ, ЮЛ или ИП) отображается сначала услуга первого уровня, затем услуга второго уровня и только на неё у заявителя появляется возможность записаться.

После модернизации программного обеспечения СУО на экране терминала:

Услуги первого уровня, которые имеют услуги на втором уровне, но они не одноименные (или стандартные услуги) отображаются как прежде. Заявитель может взять талон, только выбрав услугу второго уровня.

Для услуг первого уровня, имеющих одноименные услуги второго уровня, ситуация меняется. На экране терминала СУО на первом уровне отображается только одна услуга второго уровня и у заявителя есть возможность взять талон на её получение.

Заявитель на экране терминала СУО должен видеть только одну услугу «Урегулирование задолженности» и иметь возможность взять талон для её получения с первого уровня.



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


Разработчик данного сервиса – .

Email: aksenov@gnivc.ru

Организационные вопросы по данному сервису – Прокопьев Олег

Email:  prokopjev@gnivc.ru




Подпишитесь на рассылку:

Проекты по теме:

Россия - темы, архивы, порталы
XXI век в планах:
Основные порталы, построенные редакторами

Домашний очаг

ДомДачаСадоводствоДетиАктивность ребенкаИгрыКрасотаЖенщины(Беременность)СемьяХобби
Здоровье: • АнатомияБолезниВредные привычкиДиагностикаНародная медицинаПервая помощьПитаниеФармацевтика
История: СССРИстория РоссииРоссийская Империя
Окружающий мир: Животный мирДомашние животныеНасекомыеРастенияПриродаКатаклизмыКосмосКлиматСтихийные бедствия

Справочная информация

ДокументыЗаконыИзвещенияУтверждения документовДоговораЗапросы предложенийТехнические заданияПланы развитияДокументоведениеАналитикаМероприятияКонкурсыИтогиАдминистрации городовПриказыКонтрактыВыполнение работПротоколы рассмотрения заявокАукционыПроектыПротоколыБюджетные организации
МуниципалитетыРайоныОбразованияПрограммы
Отчеты: • по упоминаниямДокументная базаЦенные бумаги
Положения: • Финансовые документы
Постановления: • Рубрикатор по темамФинансыгорода Российской Федерациирегионыпо точным датам
Регламенты
Термины: • Научная терминологияФинансоваяЭкономическая
Время: • Даты2015 год2016 год
Документы в финансовой сферев инвестиционнойФинансовые документы - программы

Техника

АвиацияАвтоВычислительная техникаОборудование(Электрооборудование)РадиоТехнологии(Аудио-видео)(Компьютеры)

Общество

БезопасностьГражданские права и свободыИскусство(Музыка)Культура(Этика)Мировые именаПолитика(Геополитика)(Идеологические конфликты)ВластьЗаговоры и переворотыГражданская позицияМиграцияРелигии и верования(Конфессии)ХристианствоМифологияРазвлеченияМасс МедиаСпорт (Боевые искусства)ТранспортТуризм
Войны и конфликты: АрмияВоенная техникаЗвания и награды

Образование и наука

Наука: Контрольные работыНаучно-технический прогрессПедагогикаРабочие программыФакультетыМетодические рекомендацииШколаПрофессиональное образованиеМотивация учащихся
Предметы: БиологияГеографияГеологияИсторияЛитератураЛитературные жанрыЛитературные героиМатематикаМедицинаМузыкаПравоЖилищное правоЗемельное правоУголовное правоКодексыПсихология (Логика) • Русский языкСоциологияФизикаФилологияФилософияХимияЮриспруденция

Мир

Регионы: АзияАмерикаАфрикаЕвропаПрибалтикаЕвропейская политикаОкеанияГорода мира
Россия: • МоскваКавказ
Регионы РоссииПрограммы регионовЭкономика

Бизнес и финансы

Бизнес: • БанкиБогатство и благосостояниеКоррупция(Преступность)МаркетингМенеджментИнвестицииЦенные бумаги: • УправлениеОткрытые акционерные обществаПроектыДокументыЦенные бумаги - контрольЦенные бумаги - оценкиОблигацииДолгиВалютаНедвижимость(Аренда)ПрофессииРаботаТорговляУслугиФинансыСтрахованиеБюджетФинансовые услугиКредитыКомпанииГосударственные предприятияЭкономикаМакроэкономикаМикроэкономикаНалогиАудит
Промышленность: • МеталлургияНефтьСельское хозяйствоЭнергетика
СтроительствоАрхитектураИнтерьерПолы и перекрытияПроцесс строительстваСтроительные материалыТеплоизоляцияЭкстерьерОрганизация и управление производством

Каталог авторов (частные аккаунты)

Авто

АвтосервисАвтозапчастиТовары для автоАвтотехцентрыАвтоаксессуарыавтозапчасти для иномарокКузовной ремонтАвторемонт и техобслуживаниеРемонт ходовой части автомобиляАвтохимиямаслатехцентрыРемонт бензиновых двигателейремонт автоэлектрикиремонт АКППШиномонтаж

Бизнес

Автоматизация бизнес-процессовИнтернет-магазиныСтроительствоТелефонная связьОптовые компании

Досуг

ДосугРазвлеченияТворчествоОбщественное питаниеРестораныБарыКафеКофейниНочные клубыЛитература

Технологии

Автоматизация производственных процессовИнтернетИнтернет-провайдерыСвязьИнформационные технологииIT-компанииWEB-студииПродвижение web-сайтовПродажа программного обеспеченияКоммутационное оборудованиеIP-телефония

Инфраструктура

ГородВластьАдминистрации районовСудыКоммунальные услугиПодростковые клубыОбщественные организацииГородские информационные сайты

Наука

ПедагогикаОбразованиеШколыОбучениеУчителя

Товары

Торговые компанииТоргово-сервисные компанииМобильные телефоныАксессуары к мобильным телефонамНавигационное оборудование

Услуги

Бытовые услугиТелекоммуникационные компанииДоставка готовых блюдОрганизация и проведение праздниковРемонт мобильных устройствАтелье швейныеХимчистки одеждыСервисные центрыФотоуслугиПраздничные агентства

Блокирование содержания является нарушением Правил пользования сайтом. Администрация сайта оставляет за собой право отклонять в доступе к содержанию в случае выявления блокировок.