# Такском API (Такском-Касса, ОФД): Найти проблемные ККТ Сценарий из mcp-everything. Актуально на 2026-10-25. Обход кабинета сверху вниз: подразделения → торговые точки → ККТ, на каждом уровне фильтр `np=Problem`, затем причины по конкретной ККТ (истекает ФН, давно нет документов и т. п.). 1. Войди: POST /API/v2/Login с заголовком `Integrator-ID`, сохрани временный маркер. 2. Получи подразделения с проблемами: GET /API/v2/DepartmentList?np=Problem. 3. Для каждого подразделения получи торговые точки с проблемами: GET /API/v2/OutletList?id={ИД подразделения}&np=Problem. 4. Для каждой точки получи проблемные ККТ: GET /API/v2/KKTList?id={ИД торговой точки}&np=Problem. 5. По номеру ФН получи подробности: GET /API/v2/KKTInfo?fn={номер ФН} — смотри состояние ФН, дату окончания ФН, «Последний документ» и его дату. ```bash curl "https://.taxcom.ru/API/v2/DepartmentList?np=Problem" \ -H "Session-Token: $SESSION_TOKEN" curl "https://.taxcom.ru/API/v2/OutletList?id=$DEPARTMENT_ID&np=Problem" \ -H "Session-Token: $SESSION_TOKEN" curl "https://.taxcom.ru/API/v2/KKTList?id=$OUTLET_ID&np=Problem" \ -H "Session-Token: $SESSION_TOKEN" curl "https://.taxcom.ru/API/v2/KKTInfo?fn=$FN" \ -H "Session-Token: $SESSION_TOKEN" ``` ## Базовые URL - Боевой: `https://.taxcom.ru` - Документация задаёт адрес шаблоном ; конкретное имя сервера в публичной документации не указано.: `https://.taxcom.ru/API/v2/...` ## Авторизация Тип: Другое Три способа: сертификат, логин и пароль, OAuth. Для входа по логину и паролю: POST /API/v2/Login с заголовком `Integrator-ID` (ИД интегратора, выдаёт Такском) и телом по схеме `Login_Request` (приложение № 1). В ответе — временный маркер доступа; его передают в заголовке `Session-Token` всех следующих запросов. Маркер живёт 5 минут с момента получения или последнего использования; просроченный — ошибка HTTP 401. Повторный вызов Login не создаёт новый маркер, пока прежний действует. OAuth включается Такскомом вручную для зарегистрированного приложения: авторизация на `https://auth-.taxcom.ru/core/connect/authorize` (`client_id`, `response_type=code`, `scope=api`), обмен кода на POST `https://.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://mcp-everything.ru/integrations/taxcom/scenarios/sverit-cheki-s-uchetnoy-sistemoy.md) - [Забирать новые чеки потоком](https://mcp-everything.ru/integrations/taxcom/scenarios/zabirat-novye-cheki-potokom.md) - [Получить PDF чека](https://mcp-everything.ru/integrations/taxcom/scenarios/poluchit-pdf-cheka.md) --- Если этого недостаточно — официальная документация: https://lk-ofd.taxcom.ru/ApiHelp/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/taxcom.md