Общие сведения

Данный механизм предназначен для создания и получения декларации по УСН из приложения 1С.

Работа с данным механизмом осуществляется через существующий механизм - Интеграция объектов с помощью отправки команды - execute .

Запрос на установку значений производится по URL - https://{{server}}/a/{{app}}/{{tenant}}/hs/dt/storage/integration/execute

Параметры URL

Параметр

Описание

Пример

server

Адрес сервера облачного сервиса Фреш

stage.1cfresh.com

app

Имя приложения пользователя

bs

tenant

Номер приложения пользователя

10027

Формат входящих параметров

В теле запроса  передается JSON со следующей структурой.

Параметр

Тип

Описание

method

Строка

Описание метода, который нужно выполнить. Доступны методы:

  • Документ/РегламентированныйОтчет оздать

parameters

Группа свойств

Список параметров выполнения метода.

  • type

Строка

Типа регламентированного отчета. Для декларации по УСН нужно передать type =  "РегламентированныйОтчетУСН". Пока метод поддерживает только декларацию по УСН. При получении в параметрах запрос на создание другой декларации, будет выдана ошибка.

  • organization

Группа свойств

Данные организации

inn

Строка

ИНН организации – обязателен к заполнению

kpp

Строка

КПП организации - не обязателен к заполнению для предпринимателей (12 знаков в ИНН)

  • date

Строка

Дата периода декларации. Для декларации УСН может быть любой датой года.

  • format

Строка

Формат файла, в котором будет получена декларация. Доступны значения:

  • pdf

Если параметр не задан, будет получена декларация в формате xml.

Запрос выполняется асинхронно. В ответ будет получена информация о выполнении команды с кодами ответа:

  • 10202 – запрос еще выполняется
  • 10200 – запрос выполнен

Примеры передаваемых параметров

Получение декларации в формате xml
{
  "method": "Документ/РегламентированныйОтчет/Создать",
  "parameters": {
    "entrepreneur": {
      "inn": "463226175247",
      "kpp": ""
    },
    "date": "2024-12-31T00:00:00",
    "type": "РегламентированныйОтчетУСН"
  }
}
Получение декларации в формате pdf
{
  "method": "Документ/РегламентированныйОтчет/Создать",
  "parameters": {
    "entrepreneur": {
      "inn": "463226175247",
      "kpp": ""
    },
    "date": "2024-12-31T00:00:00",
    "type": "РегламентированныйОтчетУСН",
    "format": "pdf"
  }
}

Ошибки

При использовании описанных выше методов возможно возникновение следующих ошибок:

  • 10500 - При возникновении исключения
  • 10400 - При возникновении ошибки, связанной с передаваемыми данными