Такском API (Такском-Касса, ОФД): Сверить чеки с учётной системой

Сценарий из mcp-everything. Актуально на 2026-10-25.

Сравни число чеков по сменам со своими данными, а по сменам с расхождением спустись до конкретных документов.

Войди и получи маркер.
Получи смены ККТ за период: GET /API/v2/ShiftList?fn={номер ФН}&begin=...&end=... — в ответе количество чеков за смену.
По смене с расхождением получи итоги и НДС: GET /API/v2/ShiftInfo?fn={номер ФН}&shift={номер смены}.
Получи чеки смены: GET /API/v2/DocumentList?fn=...&shift=...&type=3 (кассовые чеки; можно повторять type).
По номеру ФД получи полный документ: GET /API/v2/DocumentInfo?fn=...&fd={номер ФД}.

curl "https://<server>.taxcom.ru/API/v2/ShiftList?fn=$FN&begin=2017-03-20T00:00:00&end=2017-03-21T00:00:00&ps=100" \
  -H "Session-Token: $SESSION_TOKEN"

curl "https://<server>.taxcom.ru/API/v2/DocumentList?fn=$FN&shift=$SHIFT&type=3&type=31" \
  -H "Session-Token: $SESSION_TOKEN"

curl "https://<server>.taxcom.ru/API/v2/DocumentInfo?fn=$FN&fd=$FD" \
  -H "Session-Token: $SESSION_TOKEN"

Базовые 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.

Методы сценария

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

GET /API/v2/ShiftInfo — Сводные данные по смене

Даты открытия и закрытия, номера ФД отчётов, кассир, статус (Open, Close); по приходу, возврату прихода, коррекции, расходу и возврату расхода — суммы в копейках (наличные, безналичные), число чеков и позиций, разбивка по ставкам НДС.

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

Параметр	Где	Тип	Обяз.	Описание
`Session-Token`	header	string	да	Временный маркер доступа
`fn`	query	string	да	Номер ФН
`shift`	query	integer	да	Номер смены

GET /API/v2/DocumentList — Документы смены

По документу: номер ФН, смена, тип, дата и время, номер ФД, номер в смене, ФПД, кассир, система налогообложения, признак расчёта (Income, IncomeReturn, Expenditure, ExpendituReReturn), суммы в копейках.

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

Параметр	Где	Тип	Обяз.	Описание
`Session-Token`	header	string	да	Временный маркер доступа
`fn`	query	string	да	Номер ФН
`shift`	query	integer	да	Номер смены
`type`	query	integer	нет	Тип документа, можно повторять: 2 открытие смены, 21 отчёт о расчётах, 3 чек, 31 коррекция чека, 4 БСО, 41 коррекция БСО, 5 закрытие смены
`pn`	query	integer	нет	Номер страницы
`ps`	query	integer	нет	1–100, по умолчанию 100

GET /API/v2/DocumentInfo — Данные документа

Полный фискальный документ (схема DocumentInfo_Response, приложение № 7); тег documentFormatDate — дата формата ФД (05.05.2016 или 21.03.2017).

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

Параметр	Где	Тип	Обяз.	Описание
`Session-Token`	header	string	да	Временный маркер доступа
`fn`	query	string	да	Номер ФН
`fd`	query	string	да	Номер фискального документа

Нюансы

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

Другие сценарии

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