Методы для работы с ответными документами
Документооборот подразумевает под собой последовательный обмен определенными документами согласно регламенту. Поэтому в ответ на получаемые от контролирующего органа документы необходимо отправлять определенные ответные документы, нагляднее в разделе Статусы и порядок документооборотов. Методы данного раздела позволяют формировать и работать с подобными технологическими документами. Также необходимые ссылки для формирования нужных документов будут появляться в работе с методом Получения документооборота.
Список методов для работы с ответными документами в ФНС и Росстат:
Методы для работы с ответными документами в ФНС и Росстат
Генерация ответного документа
Метод: POST CreateReplyDocument
Метод позволяет сгенерировать ответный документ в документооборотах ФНС, СФР и Росстата.
Ответный документ — это xml-файл документа установленного формата. Он создается в ответ на конкретный документ, поступивший налогоплательщику от ФНС. В методе необходимо указать тип документа, который нужно сгенерировать. Чтобы понять, какой именно тип документа нужно сформировать, см. Статусы и порядок документооборотов.
Параметры запроса:
accountId
— идентификатор учетной записи;docflowId
— идентификатор документооборота;documentId
— идентификатор главного документа в документообороте;documentType
— тип генерируемого документа. Нужно указывать без “urn:document:”. Пример: documentType = fns534-report-receipt;declineNoticeErrorCode
— коды ошибок, выявленные в процессе проверки требования. Поле используется только для генерации уведомления об отказе в документообороте требования ФНС (documentType = fns534-demand-acceptance-result-negative). В запросе можно передать несколько кодов, например,declineNoticeErrorCode=0300300001&declineNoticeErrorCode=040010000
;request
— параметры для генерации ответного документа:certificate-base64
(string) — сертификат в формате base64.
В ответе метод возвращает модель ответного документа. Контент можно будет скачать по идентификатору из сервиса контентов. Также в ответе метода доступна печатная форма сгенерированного документа.
Возможные коды ответов:
400 - Передан один или несколько неизвестных кодов ошибок для создания уведомления об отказе.
400 - Создание ответного документа недоступно для этого документа.
400 - Ответный документ уже отправлен для этого документа, его можно посмотреть в документообороте.
400 - Передан сертификат не в формате base64.
400 - Данные, переданные в параметре certificate-base64, не удалось преобразовать в сертификат.
400 - Передан невалидный сертификат.
400 - Передан неквалифицированный сертификат.
400 - Передан сертификат, принадлежащий ликвидированной организации.
400 - ИНН в сертификате не соответствует ИНН отправителя.
404 - Организация не найдена.
404 - Документооборот не найден.
404 - Документ не найден.
500 - Произошла внутренняя ошибка.
Просмотр документа
Метод: GET ReplyDocument
С помощью данного метода можно получить все данные и контенты ответного документа, сгенерированного в методе выше.
Редактирование контента документа
Метод: PUT ReplyDocumentContent
Добавление подписи документа
Метод: PUT ReplyDocumentSignature
Отправка ответного документа
Метод: POST SendReplyDocument
Отправка в контролирующий орган ответного документа с электронной подписью абонента под ним.
Подписание ответного документа сертификатом
Метод: POST SignReplyDocument