# Такском API (Такском-Касса, ОФД): 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 | нет | ИД последнего полученного документа; без него — самые ранние доступные |

## Базовые 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`.

## Нюансы

- Все методы синхронные; ответы — JSON по схемам из архива приложений (`https://files.taxcom.ru/files/Taxcom_API.zip`).
- Суммы — в копейках.
- Списки постраничные: `pn` (номер страницы) и `ps` (1–100, по умолчанию 100).
- Результаты зависят от прав сотрудника в «Такском-Кассе»; договоры без доступа в `AccountList` не попадают.
- `NewDocuments` и другие дополнительные методы доступны по отдельному запросу в Такском.
- Справочники моделей ККТ и ФН и сведения из реестров ФНС доступны без авторизации.

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

- [Забирать новые чеки потоком](https://mcp-everything.ru/integrations/taxcom/scenarios/zabirat-novye-cheki-potokom.md)

---

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