Такском API (Такском-Касса, ОФД) 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, затем причины по конкретной ККТ (истекает ФН, давно нет документов и т. п.).

Войди: 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"

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

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

Войди и получи маркер.
Получи смены ККТ за период: 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"

Забирать новые чеки потоком

Инкрементальная выгрузка всех новых фискальных документов без обхода смен. Метод дополнительный — доступ даёт Такском по запросу.

Войди и получи маркер.
Первый вызов — без id: GET /API/v2/NewDocuments (по одному договору — с an).
Сохрани id последнего документа и повторяй запрос с ним, пока не дойдёшь до последнего принятого Такскомом документа.
Дальше опрашивай не чаще раза в минуту. Окно — только документы, принятые за последние 10 суток, до 10 000 за вызов.

curl "https://<server>.taxcom.ru/API/v2/NewDocuments?an=$CONTRACT" \
  -H "Session-Token: $SESSION_TOKEN"

curl "https://<server>.taxcom.ru/API/v2/NewDocuments?an=$CONTRACT&id=$LAST_ID" \
  -H "Session-Token: $SESSION_TOKEN"

Получить PDF чека

Печатная форма документа по заводскому номеру ККТ и фискальному признаку.

Войди и получи маркер.
Найди документ (через DocumentList или NewDocuments) и возьми заводской номер ККТ и ФП.
Запроси PDF: GET /API/v2/PrintDocument/pdf?kktId={заводской номер}&fp={ФП}.

curl "https://<server>.taxcom.ru/API/v2/PrintDocument/pdf?kktId=$KKT_SERIAL&fp=$FP" \
  -H "Session-Token: $SESSION_TOKEN" -o receipt.pdf

Базовые 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/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 документов за вызов, опрос после догона — не чаще раза в минуту.

Источники

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