Такском API (Такском-Касса, ОФД): Забирать новые чеки потоком

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

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

Войди и получи маркер.
Первый вызов — без 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"

Базовые 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/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 и другие дополнительные методы доступны по отдельному запросу в Такском.
Справочники моделей ККТ и ФН и сведения из реестров ФНС доступны без авторизации.

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

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