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

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

В результате выполнения запроса возвращается файл с разметкой 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"
}

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

Файл формируется с разметкой 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/РегистрСведений.ПубликуемыеНавигационныеСсылки?Идентификатор=cf858a02-1f4d-4590-bc79-eb192a64ff1a"
    }
  ],
  "payments": [
    {
      "type": "ЕдиныйТариф",
      "title": "По единому тарифу",
      "description": "Срок уплаты фиксированной части взносов - 31 декабря, но для уменьшения авансового платежа по УСН рекомендуется оплата взносов равными долями каждый квартал",
      "sum": 11460.5,
      "link": {
        "name": "tax_payment_details",
        "type": "endpoint",
        "title": "Оплатить взнос по единому тарифу",
        "address": "hs/dt/storage/async/tax_payment_details",
        "settings": {
          "organization": {
            "inn": "771578598630",
            "kpp": ""
          },
          "date": "2023-03-31T23:59:59",
          "tax": "ФиксированныеВзносы_СтраховыеВзносыЕдиныйТариф",
          "liability": "Налог",
          "overdue_payment": false
        }
      }
    },
    {
      "type": "ПФРсДоходов",
      "title": "ПФР с доходов",
      "description": "Рассчитывается как 1% от дохода свыше 300 000 рублей: (0,00 - 300 000) x 1%",
      "sum": 0,
      "link": {
        "name": "tax_payment_details",
        "type": "endpoint",
        "title": "Оплатить взнос ПФР с доходов",
        "address": "hs/dt/storage/async/tax_payment_details",
        "settings": {
          "organization": {
            "inn": "771578598630",
            "kpp": ""
          },
          "date": "2023-03-31T23:59:59",
          "tax": "ФиксированныеВзносы_ПФР_СтраховаяЧасть",
          "liability": "ВзносыСвышеПредела",
          "overdue_payment": false
        }
      }
    }
  ],
  "total": 11460.5
}

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