{"openapi":"3.0.3","info":{"title":"1С интеграция УЦТ Казгиса — HTTP-сервис","description":"Сервис предоставляет данные о плановых показателях бюджета (доходы, расходы по обязательствам и платежам) и данные форм отчётности 552 и 219 за указанный период (год) в формате JSON.","version":"1.0.0"},"servers":[{"url":"https://<адрес_сервера>/имя_сервиса","description":"Базовый URL публикации сервиса (уточните у поставщика)"}],"paths":{"/plans":{"get":{"summary":"Получить плановые показатели бюджета и формы отчётности","description":"Возвращает данные о плановых доходах, расходах по обязательствам и платежам, а также формы 552 и 219 за год, определяемый параметром `date`.","operationId":"getBudgetPlans","security":[{"ApiKeyAuth":[]}],"parameters":[{"name":"date","in":"query","required":true,"description":"Дата, определяющая период выборки. Все данные выбираются за год, в который входит указанная дата (с начала года по дату включительно для отдельных разделов).","schema":{"type":"string","format":"date","example":"2026-06-01"}}],"responses":{"200":{"description":"Успешно, данные сформированы","content":{"application/json; charset=utf-8":{"schema":{"$ref":"#/components/schemas/BudgetResponse"},"example":{"date":"2026-06-01T00:00:00","plannedRevenue":[{"DSPK":"10101","IdKato":"123456","GU":"001","janAmount":100000,"febAmount":100000}],"plannedCommitmentExpenditures":[{"FUNC":"01.001.001.001","IdKato":"123456","GU":"001","janAmount":50000}],"plannedPaymentExpenditures":[],"form552":[{"FUNC":"01","IdFUNC":"0111","IdKato":"123456","ESPK":"111","expensesForPeriod":12000,"expensesYearToDate":65000}],"form219":[{"DSPK":"10101","republicanBudget":30000,"regionalBudget":20000,"localGovernmentBudget":5000,"districtBudget":1000,"consolidatedBudget":56000}]}}}},"401":{"description":"Не передан заголовок X-API-Key","content":{"text/plain":{"schema":{"type":"string"},"example":"Unauthorized: X-API-Key не передан"}}},"403":{"description":"Ключ передан, но не совпадает с ожидаемым","content":{"text/plain":{"schema":{"type":"string"},"example":"Forbidden: неверный X-API-Key"}}}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Статический ключ API, выданный поставщиком сервиса. Должен передаваться в каждом запросе."}},"schemas":{"BudgetResponse":{"type":"object","properties":{"date":{"type":"string","format":"date-time","description":"Эхо переданного параметра date, отформатированного как гггг-ММ-ддTЧЧ:мм:сс","example":"2026-06-01T00:00:00"},"plannedRevenue":{"type":"array","description":"Плановые доходы бюджета за год (помесячно)","items":{"$ref":"#/components/schemas/PlannedRevenueItem"}},"plannedCommitmentExpenditures":{"type":"array","description":"Плановые расходы по обязательствам за год (помесячно)","items":{"$ref":"#/components/schemas/PlannedExpenditureItem"}},"plannedPaymentExpenditures":{"type":"array","description":"Плановые расходы по платежам за год (помесячно). ВНИМАНИЕ: в текущей реализации выборка формируется без фильтра по периоду (весь регистр целиком).","items":{"$ref":"#/components/schemas/PlannedExpenditureItem"}},"form552":{"type":"array","description":"Данные формы 552 (кассовое исполнение расходов) на последнюю дату среза в пределах года","items":{"$ref":"#/components/schemas/Form552Item"}},"form219":{"type":"array","description":"Данные формы 219 (показатели исполнения по бюджетам) нарастающим итогом с начала года по месяц включительно","items":{"$ref":"#/components/schemas/Form219Item"}}},"required":["date","plannedRevenue","plannedCommitmentExpenditures","plannedPaymentExpenditures","form552","form219"]},"PlannedRevenueItem":{"type":"object","description":"Плановые доходы. Поля со значением NULL/«не определено» исключаются из объекта.","properties":{"DSPK":{"type":"string","description":"Код бюджетной классификации доходов: категория + класс + «-» + подкласс + специфика","example":"10101"},"IdKato":{"type":"string","description":"Код бюджета","example":"123456"},"GU":{"type":"string","description":"Код учреждения (администратора)","example":"001"},"janAmount":{"type":"number","description":"Плановая сумма за январь"},"febAmount":{"type":"number","description":"Плановая сумма за февраль"},"marAmount":{"type":"number","description":"Плановая сумма за март"},"aprAmount":{"type":"number","description":"Плановая сумма за апрель"},"mayAmount":{"type":"number","description":"Плановая сумма за май"},"junAmount":{"type":"number","description":"Плановая сумма за июнь"},"julAmount":{"type":"number","description":"Плановая сумма за июль"},"augAmount":{"type":"number","description":"Плановая сумма за август"},"sepAmount":{"type":"number","description":"Плановая сумма за сентябрь"},"octAmount":{"type":"number","description":"Плановая сумма за октябрь"},"novAmount":{"type":"number","description":"Плановая сумма за ноябрь"},"decAmount":{"type":"number","description":"Плановая сумма за декабрь"}}},"PlannedExpenditureItem":{"type":"object","description":"Плановые расходы по обязательствам / платежам. Поля со значением NULL/«не определено» исключаются из объекта.","properties":{"FUNC":{"type":"string","description":"Код функциональной/программной классификации расходов","example":"01.001.001.001"},"IdKato":{"type":"string","description":"Код бюджета","example":"123456"},"GU":{"type":"string","description":"Код учреждения","example":"001"},"janAmount":{"type":"number","description":"Плановая сумма за январь"},"febAmount":{"type":"number","description":"Плановая сумма за февраль"},"marAmount":{"type":"number","description":"Плановая сумма за март"},"aprAmount":{"type":"number","description":"Плановая сумма за апрель"},"mayAmount":{"type":"number","description":"Плановая сумма за май"},"junAmount":{"type":"number","description":"Плановая сумма за июнь"},"julAmount":{"type":"number","description":"Плановая сумма за июль"},"augAmount":{"type":"number","description":"Плановая сумма за август"},"sepAmount":{"type":"number","description":"Плановая сумма за сентябрь"},"octAmount":{"type":"number","description":"Плановая сумма за октябрь"},"novAmount":{"type":"number","description":"Плановая сумма за ноябрь"},"decAmount":{"type":"number","description":"Плановая сумма за декабрь"}}},"Form552Item":{"type":"object","description":"Данные формы 552 (кассовое исполнение расходов) на последнюю дату среза в пределах года. Поля со значением NULL/«не определено» исключаются из объекта.","properties":{"FUNC":{"type":"string","description":"Код классификации расходов","example":"01"},"IdFUNC":{"type":"string","description":"Код функциональной классификации расходов (ФКР)","example":"0111"},"IdKato":{"type":"string","description":"Код бюджета","example":"123456"},"ESPK":{"type":"string","description":"Код экономической специфики","example":"111"},"expensesForPeriod":{"type":"number","description":"Расходы за отчётный период","example":12000},"expensesYearToDate":{"type":"number","description":"Расходы нарастающим итогом с начала года","example":65000}}},"Form219Item":{"type":"object","description":"Данные формы 219 (показатели исполнения по бюджетам) нарастающим итогом с начала года по месяц включительно. Поля со значением NULL/«не определено» исключаются из объекта.","properties":{"DSPK":{"type":"string","description":"Код бюджетной классификации доходов","example":"10101"},"republicanBudget":{"type":"number","description":"Оборот по республиканскому бюджету","example":30000},"regionalBudget":{"type":"number","description":"Оборот по областному бюджету","example":20000},"localGovernmentBudget":{"type":"number","description":"Оборот по бюджету МСУ","example":5000},"districtBudget":{"type":"number","description":"Оборот по районному бюджету","example":1000},"consolidatedBudget":{"type":"number","description":"Оборот по сводному бюджету","example":56000}}}}}}