Такском API (Такском-Касса, ОФД): Найти проблемные ККТ

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

Обход кабинета сверху вниз: подразделения → торговые точки → ККТ, на каждом уровне фильтр np=Problem, затем причины по конкретной ККТ (истекает ФН, давно нет документов и т. п.).

Войди: POST /API/v2/Login с заголовком Integrator-ID, сохрани временный маркер.
Получи подразделения с проблемами: GET /API/v2/DepartmentList?np=Problem.
Для каждого подразделения получи торговые точки с проблемами: GET /API/v2/OutletList?id={ИД подразделения}&np=Problem.
Для каждой точки получи проблемные ККТ: GET /API/v2/KKTList?id={ИД торговой точки}&np=Problem.
По номеру ФН получи подробности: GET /API/v2/KKTInfo?fn={номер ФН} — смотри состояние ФН, дату окончания ФН, «Последний документ» и его дату.

curl "https://<server>.taxcom.ru/API/v2/DepartmentList?np=Problem" \
  -H "Session-Token: $SESSION_TOKEN"

curl "https://<server>.taxcom.ru/API/v2/OutletList?id=$DEPARTMENT_ID&np=Problem" \
  -H "Session-Token: $SESSION_TOKEN"

curl "https://<server>.taxcom.ru/API/v2/KKTList?id=$OUTLET_ID&np=Problem" \
  -H "Session-Token: $SESSION_TOKEN"

curl "https://<server>.taxcom.ru/API/v2/KKTInfo?fn=$FN" \
  -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.

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

POST /API/v2/Login — Вход по логину и паролю

Тело и ответ описаны схемами Login_Request.jsonscheme и Login_Response.jsonscheme (приложение № 1, архив JSON-схем).

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

Параметр	Где	Тип	Обяз.	Описание
`Integrator-ID`	header	string	да	ИД интегратора
`Content-Type`	header	string	да	application/json

GET /API/v2/DepartmentList — Подразделения кабинета

По подразделению: ИД, название, код, родительское подразделение, признак проблемы (OK, Warning, Problem).

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

Параметр	Где	Тип	Обяз.	Описание
`Session-Token`	header	string	да	Временный маркер доступа
`np`	query	string	нет	Фильтр по проблеме: OK, Warning, Problem
`pn`	query	integer	нет	Номер страницы; по умолчанию первая
`ps`	query	integer	нет	Записей на странице, 1–100 (по умолчанию 100)

GET /API/v2/OutletList — Торговые точки

Точки подразделения и его дочерних подразделений, без id — все. По точке: подразделение, ИД, название, код, адрес, признак проблемы.

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

Параметр	Где	Тип	Обяз.	Описание
`Session-Token`	header	string	да	Временный маркер доступа
`id`	query	string	нет	ИД подразделения
`np`	query	string	нет	OK, Warning, Problem
`pn`	query	integer	нет	Номер страницы
`ps`	query	integer	нет	1–100, по умолчанию 100

GET /API/v2/KKTList — ККТ торговой точки

По ККТ: название, рег. и заводской номер, номер ФН, состояние (Active, Expires, Expired, Inactive, Activation, Deactivation, FNChange, FNSRegistration, FNSRegistrationError), признак проблемы.

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

Параметр	Где	Тип	Обяз.	Описание
`Session-Token`	header	string	да	Временный маркер доступа
`id`	query	string	да	ИД торговой точки
`np`	query	string	нет	OK, Warning, Problem
`pn`	query	integer	нет	Номер страницы
`ps`	query	integer	нет	1–100, по умолчанию 100

GET /API/v2/KKTInfo — Сводные данные по ККТ

В ответе: модель, номера ККТ и ФН, дата регистрации и срок ФН, статус смены (Open, Close, NoData), состояние ККТ и ФН, «оплачена по», последний документ (OK, Warning, Problem) и его дата, торговая точка, партнёр.

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

Параметр	Где	Тип	Обяз.	Описание
`Session-Token`	header	string	да	Временный маркер доступа
`fn`	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