Общие сведения
Данный механизм предназначен для создания и получения декларации по УСН из приложения 1С.
Работа с данным механизмом осуществляется через существующий механизм - Интеграция объектов с помощью отправки команды - execute .
Запрос на установку значений производится по URL - https://{{server}}/a/{{app}}/{{tenant}}/hs/dt/storage/integration/execute
Параметры URL
Параметр | Описание | Пример |
---|---|---|
server | Адрес сервера облачного сервиса Фреш | |
app | Имя приложения пользователя | bs |
tenant | Номер приложения пользователя | 10027 |
Формат входящих параметров
В теле запроса передается JSON со следующей структурой.
Параметр | Тип | Описание |
---|---|---|
| Строка | Описание метода, который нужно выполнить. Доступны методы:
|
| Группа свойств | Список параметров выполнения метода. |
| Строка | Типа регламентированного отчета. Для декларации по УСН нужно передать type = "РегламентированныйОтчетУСН". Пока метод поддерживает только декларацию по УСН. При получении в параметрах запрос на создание другой декларации, будет выдана ошибка. |
| Группа свойств | Данные организации |
| Строка | ИНН организации – обязателен к заполнению |
| Строка | КПП организации - не обязателен к заполнению для предпринимателей (12 знаков в ИНН) |
| Строка | Дата периода декларации. Для декларации УСН может быть любой датой года. |
| Строка | Формат файла, в котором будет получена декларация. Доступны значения: Если параметр не задан, будет получена декларация в формате xml. |
Запрос выполняется асинхронно. В ответ будет получена информация о выполнении команды с кодами ответа:
- 10202 – запрос еще выполняется
- 10200 – запрос выполнен
Примеры передаваемых параметров
{ "method": "Документ/РегламентированныйОтчет/Создать", "parameters": { "entrepreneur": { "inn": "463226175247", "kpp": "" }, "date": "2024-12-31T00:00:00", "type": "РегламентированныйОтчетУСН" } }
{ "method": "Документ/РегламентированныйОтчет/Создать", "parameters": { "entrepreneur": { "inn": "463226175247", "kpp": "" }, "date": "2024-12-31T00:00:00", "type": "РегламентированныйОтчетУСН", "format": "pdf" } }
Ошибки
При использовании описанных выше методов возможно возникновение следующих ошибок:
- 10500 - При возникновении исключения
- 10400 - При возникновении ошибки, связанной с передаваемыми данными