Translation. Original: README.md

KSeF 2.0 - Руководство для Интеграторов

22.12.2025

Данный документ представляет собой компендиум знаний для разработчиков, аналитиков и интеграторов систем, которые реализуют интеграцию с Национальной системой электронных счетов-фактур (KSeF) версии 2.0. Руководство сосредоточено на технических и практических аспектах, связанных с коммуникацией с API системы KSeF.

Введение в KSeF 2.0

Национальная система электронных счетов-фактур (KSeF) — это центральная телеинформационная система, предназначенная для выставления и получения структурированных счетов-фактур в электронном виде.

Содержание

Руководство разделено на тематические разделы, соответствующие ключевым функциям и интеграционным областям в API KSeF:

• Обзор ключевых изменений в KSeF 2.0
• Журнал изменений
• Аутентификация
  • Получение доступа
  • Управление сессиями
• Разрешения
• Сертификаты KSeF
• Офлайн режимы
  • Офлайн режимы
  • Техническая коррекция
• QR-коды
• Интерактивная сессия
• Пакетная сессия
• Получение счетов-фактур
  • Получение счетов-фактур
  • Инкрементальное получение счетов-фактур
• Управление токенами KSeF
• Лимиты
• Тестовые данные

Для каждой области предусмотрено:

• детальное описание работы,
• пример вызова на языках C# и Java,
• связи со спецификацией OpenAPI и кодом справочной библиотеки.

Примеры кода, представленные в руководстве, подготовлены на основе официальных open source библиотек:

• ksef-client-csharp – библиотека на языке C#
• ksef-client-java – библиотека на языке Java

Обе библиотеки поддерживаются и развиваются командами Министерства финансов и предоставляются публично на условиях open source. Они обеспечивают полную поддержку функциональности API KSeF 2.0, включая обработку всех endpoints, моделей данных и примерных сценариев вызовов. Использование этих библиотек позволяет значительно упростить процесс интеграции и минимизирует риск неправильной интерпретации контрактов API.

Среды системы

Перечень сред KSeF API 2.0 описан в документе Среды KSeF API 2.0