--- slug: "taxcom" name: "Такском API (Такском-Касса, ОФД)" vendor: "Такском" industry: "accounting" docsUrl: "https://lk-ofd.taxcom.ru/ApiHelp/" version: 1 updatedAt: "2026-10-25" --- # Такском API (Такском-Касса, ОФД) Отрасль: Учёт и ERP. Актуально на 2026-10-25. API личного кабинета пользователя ККТ «Такском-Касса» (оператор фискальных данных Такском). Даёт чтение структуры кабинета (подразделения, торговые точки, ККТ, фискальные накопители), смен и фискальных документов, печать документа в HTML или PDF, мониторинг проблем ККТ, а также регистрацию, перерегистрацию и снятие ККТ с учёта в ФНС. Запросы выполняются от имени сотрудника и с учётом его прав в кабинете. Доступ к базовым методам — только при наличии Integrator-ID (выдаёт Такском по запросу) и прав в «Такском-Кассе». ## Охват Есть: - Вход по логину и паролю, временный маркер `Session-Token` - Список договоров (личных кабинетов) и прав пользователя - Подразделения, торговые точки, ККТ и признак проблем по ним - Сводные данные по ККТ: срок ФН, последний документ, статус смены - Смены за период и сводные данные по смене (суммы, НДС) - Документы смены, данные документа, печать в PDF - Поток новых документов за 10 суток (дополнительный метод) Нет — смотри официальную документацию: - Вход по сертификату и OAuth (подробно) - Регистрация, перерегистрация и снятие ККТ с учёта в ФНС - Подключение ККТ по отчётам о регистрации, отчёты, мониторинг (Dashboard) - Справочники моделей ККТ и ФН, сведения из реестров ФНС - JSON-схемы запросов и ответов (архив `https://files.taxcom.ru/files/Taxcom_API.zip`) - Создание чеков и фискализация — через API не описаны ## Сценарии ### Найти проблемные ККТ Обход кабинета сверху вниз: подразделения → торговые точки → ККТ, на каждом уровне фильтр `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" ``` ### Сверить чеки с учётной системой Сравни число чеков по сменам со своими данными, а по сменам с расхождением спустись до конкретных документов. 1. Войди и получи маркер. 2. Получи смены ККТ за период: GET /API/v2/ShiftList?fn={номер ФН}&begin=...&end=... — в ответе количество чеков за смену. 3. По смене с расхождением получи итоги и НДС: GET /API/v2/ShiftInfo?fn={номер ФН}&shift={номер смены}. 4. Получи чеки смены: GET /API/v2/DocumentList?fn=...&shift=...&type=3 (кассовые чеки; можно повторять `type`). 5. По номеру ФД получи полный документ: GET /API/v2/DocumentInfo?fn=...&fd={номер ФД}. ```bash curl "https://.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://.taxcom.ru/API/v2/DocumentList?fn=$FN&shift=$SHIFT&type=3&type=31" \ -H "Session-Token: $SESSION_TOKEN" curl "https://.taxcom.ru/API/v2/DocumentInfo?fn=$FN&fd=$FD" \ -H "Session-Token: $SESSION_TOKEN" ``` ### Забирать новые чеки потоком Инкрементальная выгрузка всех новых фискальных документов без обхода смен. Метод дополнительный — доступ даёт Такском по запросу. 1. Войди и получи маркер. 2. Первый вызов — без `id`: GET /API/v2/NewDocuments (по одному договору — с `an`). 3. Сохрани `id` последнего документа и повторяй запрос с ним, пока не дойдёшь до последнего принятого Такскомом документа. 4. Дальше опрашивай не чаще раза в минуту. Окно — только документы, принятые за последние 10 суток, до 10 000 за вызов. ```bash curl "https://.taxcom.ru/API/v2/NewDocuments?an=$CONTRACT" \ -H "Session-Token: $SESSION_TOKEN" curl "https://.taxcom.ru/API/v2/NewDocuments?an=$CONTRACT&id=$LAST_ID" \ -H "Session-Token: $SESSION_TOKEN" ``` ### Получить PDF чека Печатная форма документа по заводскому номеру ККТ и фискальному признаку. 1. Войди и получи маркер. 2. Найди документ (через DocumentList или NewDocuments) и возьми заводской номер ККТ и ФП. 3. Запроси PDF: GET /API/v2/PrintDocument/pdf?kktId={заводской номер}&fp={ФП}. ```bash curl "https://.taxcom.ru/API/v2/PrintDocument/pdf?kktId=$KKT_SERIAL&fp=$FP" \ -H "Session-Token: $SESSION_TOKEN" -o receipt.pdf ``` ## Базовые 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/AccountList — Договоры и права пользователя В ответе: дата формирования, число записей, номер договора текущего ЛК; по каждому договору — номер, организация, ИНН, КПП, права (администратор, разделы «Управление», «Мониторинг», «Аналитика», «Отчёты», просмотр фискальных документов). Документация: https://lk-ofd.taxcom.ru/ApiHelp/lichnye_kabinety.html | Параметр | Где | Тип | Обяз. | Описание | |---|---|---|---|---| | `Session-Token` | header | string | да | Временный маркер доступа | ### 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 | да | Номер фискального накопителя | ### 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 | да | Номер фискального документа | ### GET /API/v2/PrintDocument/pdf — Печать документа в PDF Ответ — PDF-файл. Есть также печать в HTML. Документация: https://lk-ofd.taxcom.ru/ApiHelp/pechat_dokumenta_v_pdf_formate.html | Параметр | Где | Тип | Обяз. | Описание | |---|---|---|---|---| | `Session-Token` | header | string | да | Временный маркер доступа | | `kktId` | query | string | да | Заводской номер ККТ | | `fp` | query | string | да | Фискальный признак документа | ### GET /API/v2/NewDocuments — Новые документы Документы, принятые Такскомом за последние 10 суток, по времени приёма, до 10 000 за вызов. Типы: открытие и закрытие смены, отчёт о расчётах, кассовый чек и коррекция, БСО и коррекция. Документация: https://lk-ofd.taxcom.ru/ApiHelp/novye_dokumenty.html | Параметр | Где | Тип | Обяз. | Описание | |---|---|---|---|---| | `Session-Token` | header | string | да | Временный маркер доступа | | `an` | query | string | нет | Номер договора; без него — по всем доступным кабинетам | | `id` | query | string | нет | ИД последнего полученного документа; без него — самые ранние доступные | ## Нюансы - Все методы синхронные; ответы — JSON по схемам из архива приложений (`https://files.taxcom.ru/files/Taxcom_API.zip`). - Суммы — в копейках. - Списки постраничные: `pn` (номер страницы) и `ps` (1–100, по умолчанию 100). - Результаты зависят от прав сотрудника в «Такском-Кассе»; договоры без доступа в `AccountList` не попадают. - `NewDocuments` и другие дополнительные методы доступны по отдельному запросу в Такском. - Справочники моделей ККТ и ФН и сведения из реестров ФНС доступны без авторизации. ## Ошибки | Код | Описание | |---|---| | `401` | Маркер доступа отсутствует или истёк (HTTP) | | `2203` | Некорректный ИД документа (NewDocuments) | | `3101` | Документ не найден | | `3102` | Торговая точка не найдена | | `3103` | ККТ не найдена (не найден ФН) | | `3104` | Подразделение не найдено | | `3105` | Смена не найдена | | `3106` | Не найдено ни одной ККТ, доступной пользователю | ## Ограничения - Маркер `Session-Token` живёт 5 минут с последнего использования. - До 100 записей на страницу в списках. - `NewDocuments`: окно 10 суток, до 10 000 документов за вызов, опрос после догона — не чаще раза в минуту. ## Источники - [Такском API — техническое описание](https://lk-ofd.taxcom.ru/ApiHelp/) - [Перечень методов](https://lk-ofd.taxcom.ru/ApiHelp/perechen_metodov.html) - [Сценарии использования API](https://lk-ofd.taxcom.ru/ApiHelp/stsenarii_ispolzovaniya_api.html) - [Логин и пароль](https://lk-ofd.taxcom.ru/ApiHelp/login_i_parol.html) - [OAuth](https://lk-ofd.taxcom.ru/ApiHelp/oauth.html) - [Новые документы](https://lk-ofd.taxcom.ru/ApiHelp/novye_dokumenty.html) - [JSON-схемы запросов и ответов](https://lk-ofd.taxcom.ru/ApiHelp/json_skhemy_zaprosov_i_otvetov.html) --- Если этого недостаточно — официальная документация: https://lk-ofd.taxcom.ru/ApiHelp/ JSON: https://mcp-everything.ru/api/integrations/taxcom. MCP: https://mcp-everything.ru/mcp