Такском API (Такском-Касса, ОФД): GET /API/v2/ShiftList — Смены ККТ за период

Смены, которые полностью или частично попали в период: номер ФН, номер смены, даты открытия и закрытия, число чеков.

Документация: https://lk-ofd.taxcom.ru/ApiHelp/spisok_smen_za_period_po_kkt.html

Параметр	Где	Тип	Обяз.	Описание
Session-Token	header	string	да	Временный маркер доступа
fn	query	string	да	Номер ФН
begin	query	string	да	Начало периода, например 2017-03-20T10:47:00
end	query	string	да	Окончание периода
pn	query	integer	нет	Номер страницы
ps	query	integer	нет	1–100, по умолчанию 100

Базовые URL

• Боевой: https://<server>.taxcom.ru
• Документация задаёт адрес шаблоном ; конкретное имя сервера в публичной документации не указано.: https://<server>.taxcom.ru/API/v2/...

Авторизация

Тип: Другое

Три способа: сертификат, логин и пароль, OAuth. Для входа по логину и паролю: POST /API/v2/Login с заголовком Integrator-ID (ИД интегратора, выдаёт Такском) и телом по схеме Login_Request (приложение № 1). В ответе — временный маркер доступа; его передают в заголовке Session-Token всех следующих запросов. Маркер живёт 5 минут с момента получения или последнего использования; просроченный — ошибка HTTP 401. Повторный вызов Login не создаёт новый маркер, пока прежний действует.

OAuth включается Такскомом вручную для зарегистрированного приложения: авторизация на https://auth-<server>.taxcom.ru/core/connect/authorize (client_id, response_type=code, scope=api), обмен кода на POST https://<server>.taxcom.ru/core/connect/token.

Нюансы

• Все методы синхронные; ответы — JSON по схемам из архива приложений (https://files.taxcom.ru/files/Taxcom_API.zip).
• Суммы — в копейках.
• Списки постраничные: pn (номер страницы) и ps (1–100, по умолчанию 100).
• Результаты зависят от прав сотрудника в «Такском-Кассе»; договоры без доступа в AccountList не попадают.
• NewDocuments и другие дополнительные методы доступны по отдельному запросу в Такском.
• Справочники моделей ККТ и ФН и сведения из реестров ФНС доступны без авторизации.

Сценарии с этим методом

• Сверить чеки с учётной системой

---

Если этого недостаточно — официальная документация: https://lk-ofd.taxcom.ru/ApiHelp/spisok_smen_za_period_po_kkt.html Вся интеграция одним документом: https://mcp-everything.ru/integrations/taxcom.md