Такском API (Такском-Касса, ОФД): 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

Базовые URL

Авторизация

Тип: Другое

Три способа: сертификат, логин и пароль, 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.

Нюансы

Сценарии с этим методом


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