# Такском API (Такском-Касса, ОФД): Сверить чеки с учётной системой

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

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

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://<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"
```

## Базовые 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/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 | да | Номер фискального документа |

## Нюансы

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

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

- [Найти проблемные ККТ](https://mcp-everything.ru/integrations/taxcom/scenarios/nayti-problemnye-kkt.md)
- [Забирать новые чеки потоком](https://mcp-everything.ru/integrations/taxcom/scenarios/zabirat-novye-cheki-potokom.md)
- [Получить PDF чека](https://mcp-everything.ru/integrations/taxcom/scenarios/poluchit-pdf-cheka.md)

---

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