Программный интерфейс помощника оплаты фиксированных страховых взносов

Поддерживается в конфигурации 1С:Бухгалтерия начиная с версии 3.0.63.

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

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

В результате выполнения запроса возвращается файл с разметкой JSON, содержащий следующие данные:

  • Таблица с информацией по взносам с суммой к оплате.
  • Общая сумма взносов к оплате
  • Массив публикуемых ссылок
    • Ссылка для перехода в приложение 1С для проверки расчета.
    • Ссылка на закрытие соответствующей задачи в списке задач.
    • Ссылки для вызова веб-сервиса Получение реквизитов для уплаты налогов и взносов, необходимых для формирования платежных поручений.

Помощник построен на механизме Асинхронное получение данных. 

  • Адрес получения данных - https://{{server}}/a/{{app}}/{{tenant}}/hs/dt/storage/async.
  • Идентификатор данных - self_insurance_payments

Таким образом отправка запросов на получение данных помощника производится по адресу: https://{{server}}/a/{{app}}/{{tenant}}/hs/dt/storage/async/self_insurance_payments.

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

При выполнении запроса к данным помощника внешняя система должна передать в теле запроса параметры в виде JSON со структурой:

  • organization – необязательный – организация или индивидуальный предприниматель. Если не указано, данные будут получены по основной организации
    • inn – ИНН организации (10 символов) или индивидуального предпринимателя (12 символов)
    • kpp – КПП организации. Имеет смысл только для юридических лиц. Не заполняется для ИП
  • date – дата, на которую необходимо рассчитать страховые взносы к уплате.

Пример настроек

{
  "organization": {
    "inn": "501800056008",
    "kpp": ""
  },
  "date": "2018-01-01T00:00:00"
}

Ответы при формировании файла данных

Ответ формируется в задании. В результате запроса состояния задания внешняя система может получить ответ от задания с кодами ответов:

Код ответа

Ответ

Описание

10200ВыполненоЕсли все рассчитали и не возникло предупреждений, то ответ будет содержать информацию о сформированном файле с данными помощника (см. ниже).
10240Выполнено с предупреждениямиЕсли не заполнены реквизиты, необходимые для оплаты взносов. В результате также будет возвращена информация о сформированном файле с данными помощника (см. ниже).
10400Ошибка данныхЕсли переданы некорректные настройки или не нашли организацию в области.
10500Внутренняя ошибкаЕсли расчет страховых взносов за указанный период не поддерживается.

Структура файла ответа

Файл формируется с разметкой JSON следующей структуры:

  • links – массив публикуемых ссылок. Содержит ссылки для перехода в 1С и на публикуемый API, связанный с помощником.
    • name – идентификатор ссылки в файле
    • type – тип ссылки - одно из значений: anchor - "якорь" - ссылка, которая открывает помощник в 1С;  endpoint - публикуемый сервис внешнего API)
    • title - надпись ссылки
    • address - адрес для вызова из внешней системы
    • settings - настройки, связанные с публикуемым endpoint'ом. Состав настроек свой для каждого endpoint'а
  • payments – массив взносов с суммой к оплате.
    • type - тип взноса: ПФР, ПФРсДоходов, ФФОМС, ФСС
    • title - интерфейсное представление типа взноса
    • description - доп. описание к взносу. К примеру, формула расчета взноса. Необязательное
    • sum - сумма взноса к оплате
    • link описание ссылки получения реквизитов платежа для уплаты взноса:
      • name – идентификатор ссылки в файле
      • type – тип ссылки - значение "endpoint" - публикуемый сервис внешнего API
      • title - надпись ссылки
      • address - адрес для вызова из внешней системы
      • settings - настройки, связанные с публикуемым endpoint'ом. Состав настроек см. в API реквизитов уплаты налогов и взносов
  • total - общая сумма взносов к оплате

Пример ответа

 Развернуть
{
  "links": [{
      "name": "goto1C",
      "type": "anchor",
      "title": "Проверить расчет в 1С",
      "address": "e1cib/data/РегистрСведений.ПубликуемыеНавигационныеСсылки?Идентификатор=2044203c-bacf-4832-bc90-f4c01786a1dd"
    },
    {
      "name": "tasks_status",
      "type": "endpoint",
      "title": "Уже оплачено",
      "address": "hs/api/v1/tasks/status",
      "settings": {
        "id": "4FAADF44D45480745DE7CB2F397D1874",
        "done": true
      }
    }
  ],
  "payments": [{
      "type": "ПФР",
      "title": "ПФР фиксированный",
      "sum": 6636.25,
      "link": {
        "name": "tax_payment_details",
        "type": "endpoint",
        "title": "Оплатить взнос ПФР",
        "address": "hs/dt/storage/async/tax_payment_details",
        "settings": {
          "organization": {
            "inn": "779955555519",
            "kpp": ""
          },
          "date": "2018-03-31T23:59:59",
          "tax": "ФиксированныеВзносы_ПФР_СтраховаяЧасть",
          "liability": "Налог"
        }
      }
    },
    {
      "type": "ПФРсДоходов",
      "title": "ПФР с доходов",
      "description": "Рассчитывается как 1% от дохода свыше 300 000 рублей ( 2 000 000,00 - 300 000,00 ) x 1%",
      "sum": 17000,
      "link": {
        "name": "tax_payment_details",
        "type": "endpoint",
        "title": "Оплатить взнос ПФР с доходов",
        "address": "hs/dt/storage/async/tax_payment_details",
        "settings": {
          "organization": {
            "inn": "779955555519",
            "kpp": ""
          },
          "date": "2018-03-31T23:59:59",
          "tax": "ФиксированныеВзносы_ПФР_СтраховаяЧасть",
          "liability": "ВзносыСвышеПредела"
        }
      }
    },
    {
      "type": "ФФОМС",
      "title": "ФФОМС",
      "sum": 1460,
      "link": {
        "name": "tax_payment_details",
        "type": "endpoint",
        "title": "Оплатить взнос ФФОМС",
        "address": "hs/dt/storage/async/tax_payment_details",
        "settings": {
          "organization": {
            "inn": "779955555519",
            "kpp": ""
          },
          "date": "2018-03-31T23:59:59",
          "tax": "ФиксированныеВзносы_ФФОМС",
          "liability": "Налог"
        }
      }
    }
  ],
  "total": 25096.25
}

Пример визуализации в клиентском коде