Общие сведения
Данный механизм предназначен для создания и получения декларации по УСН из приложения 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 - При возникновении ошибки, связанной с передаваемыми данными