.. _`POST BuildDocument`: https://developer.kontur.ru/doc/extern.drafts/method?type=post&path=%2Fv1%2F%7BaccountId%7D%2Fdrafts%2F%7BdraftId%7D%2Fdocuments%2F%7BdocumentId%7D%2Fbuild
.. _`POST BuildDocumentContent`: https://developer.kontur.ru/doc/extern.drafts/method?type=post&path=%2Fv1%2F%7BaccountId%7D%2Fdrafts%2F%7BdraftId%7D%2Fbuild-document


Методы генерации файлов отчетов в черновике
===========================================

Список доступных методов:

* `Создание файла в документе по контракту`_
* `Создание и замена документа по контракту`_

Некоторые формализованные документы для ФНС и СФР можно создать прямо в черновике, а не загружать уже готовые. По :doc:`контрактам</test/contracts>` методы данного раздела формируют документы в черновике. Контракт указывает на тип и формат документа, а также содержит информацию, которая будет передана в ФНС или СФР. 

**Список форм, которые доступны для формирования:**

* запрос на сверку с налоговой (ИОН запрос);
* заявление на подключение к ЭДОК;
* подписка оператора на организацию по РНС для СЭДО СФР.

Существует семь видов ИОН запросов:

* ИОН 3 – Перечень налоговых деклараций (расчетов) и бухгалтерской отчетности.
* ИОН 4 – Акт сверки принадлежности сумм денежных средств.
* ИОН 5 – Справка об исполнении налогоплательщиком обязанности по уплате налогов, сборов, пеней, штрафов.
* ИОН 6 – Справка о принадлежности сумм денежных средств, перечисленных в качестве ЕНП.
* ИОН 7 – Справка о наличии по состоянию на дату формирования справки сальдо ЕНС налогоплательщика.
* ИОН 8 – Сведения о наличии (отсутствии) задолженности в размере отрицательного сальдо ЕНС.
* ИОН 9 – Справка о принадлежности сумм денежных средств, перечисленных в качестве ЕНП (агрегированные данные).

.. note:: С 1 января 2023 ФНС перестала принимать следующие ИОН запросы:

            * ИОН 1 – Справка о состоянии расчетов по налогам, сборам, пеням и штрафам (Форма N39-1).
            * ИОН 2 – Выписка операций по расчетам с бюджетом.

Согласно :doc:`порядку работы с черновиками</drafts/work-order-drafts>`, методы нужно использовать на шаге наполнения черновика. После создания файла установленного формата в документе черновика нужно добавить подпись к файлу. 

В результате для ИОН запроса будет создан документооборот с типом urn:docflow:fns534-ion, для заявления на подключение к ЭДОК — urn:docflow:pfr-ancillary, дя подписок СЭДО — urn:docflow:fss-sedo-provider-subscription.


Создание файла в документе по контракту
---------------------------------------

Метод: `POST BuildDocument`_

Данный метод позволяет создать файл установленного формата в указанном документе черновика.  

**Описание параметров метода:**

    * В параметре ``type`` необходимо указать тип документа:
        
        * ``ION3`` — ИОН 3; 
        * ``ION4`` — ИОН 4; 
        * ``ION5`` — ИОН 5;
        * ``ION6`` — ИОН 6;
        * ``ION7`` — ИОН 7;
        * ``ION8`` — ИОН 8;
        * ``ION9`` — ИОН 9;
        * ``ZPED`` — заявление на подключение к ЭДОК с СФР;
        * ``fssSedoProviderSubscriptionForRegistrationNumber`` — подписка оператора на организацию по РНС.

    * Параметр ``version`` означает версию контракта: 
     
        - Для ИОН запросов версия всегда равна 3. 
        - В заявлении на подключение к ЭДОК не используется.
    
**В теле запроса** необходимо передать :doc:`контракт</manuals/contracts>` в формате валидного JSON. 

На основании переданного контракта будет сформирован файл отчета. Если файл успешно создан, его контент появится в документе черновика, и метод вернет пустой ответ 200.

Метод можно использовать после создания черновика и пустого документа в нем. В результате вызова метода в документе появится контент файла установленного формата. 

.. _rst_markup_BuildDocumentContent:

Создание и замена документа по контракту
----------------------------------------

Метод: `POST BuildDocumentContent`_

С помощью этого метода можно создать документ в черновике, который будет содержать контент файла установленного формата. 

**Описание параметров метода:**

    * В параметре ``type`` необходимо указать тип документа:
        
        * ``ION3`` — ИОН3; 
        * ``ION4`` — ИОН4; 
        * ``ION5`` — ИОН5;
        * ``ION6`` — ИОН6;
        * ``ION7`` — ИОН7;
        * ``ZPED`` — заявление на подключение к ЭДОК;
        * ``fssSedoProviderSubscriptionForRegistrationNumber`` — подписка оператора на организацию по РНС.

    * Параметр ``version`` означает версию контракта: 
     
        - Для ИОН запросов версия всегда равна 3. 
        - В заявлении на подключение к ЭДОК не используется.
    
**В теле запроса** необходимо передать :doc:`контракт</manuals/contracts>` в формате валидного JSON. 

Если файл успешно создан, метод вернет ответ 200 и сформированный в черновике документ.