{"name":"Такском API (Такском-Касса, ОФД)","vendor":"Такском","industry":"accounting","summary":"API личного кабинета пользователя ККТ «Такском-Касса» (оператор фискальных данных Такском). Даёт чтение структуры кабинета (подразделения, торговые точки, ККТ, фискальные накопители), смен и фискальных документов, печать документа в HTML или PDF, мониторинг проблем ККТ, а также регистрацию, перерегистрацию и снятие ККТ с учёта в ФНС. Запросы выполняются от имени сотрудника и с учётом его прав в кабинете. Доступ к базовым методам — только при наличии Integrator-ID (выдаёт Такском по запросу) и прав в «Такском-Кассе».","docsUrl":"https://lk-ofd.taxcom.ru/ApiHelp/","coverage":{"included":["Вход по логину и паролю, временный маркер `Session-Token`","Список договоров (личных кабинетов) и прав пользователя","Подразделения, торговые точки, ККТ и признак проблем по ним","Сводные данные по ККТ: срок ФН, последний документ, статус смены","Смены за период и сводные данные по смене (суммы, НДС)","Документы смены, данные документа, печать в PDF","Поток новых документов за 10 суток (дополнительный метод)"],"excluded":["Вход по сертификату и OAuth (подробно)","Регистрация, перерегистрация и снятие ККТ с учёта в ФНС","Подключение ККТ по отчётам о регистрации, отчёты, мониторинг (Dashboard)","Справочники моделей ККТ и ФН, сведения из реестров ФНС","JSON-схемы запросов и ответов (архив `https://files.taxcom.ru/files/Taxcom_API.zip`)","Создание чеков и фискализация — через API не описаны"]},"scenarios":[{"id":"nayti-problemnye-kkt","title":"Найти проблемные ККТ","summary":"Обход кабинета сверху вниз: подразделения → торговые точки → ККТ, на каждом уровне фильтр `np=Problem`, затем причины по конкретной ККТ (истекает ФН, давно нет документов и т. п.).","steps":["Войди: 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={номер ФН} — смотри состояние ФН, дату окончания ФН, «Последний документ» и его дату."],"code":"curl \"https://<server>.taxcom.ru/API/v2/DepartmentList?np=Problem\" \\\n  -H \"Session-Token: $SESSION_TOKEN\"\n\ncurl \"https://<server>.taxcom.ru/API/v2/OutletList?id=$DEPARTMENT_ID&np=Problem\" \\\n  -H \"Session-Token: $SESSION_TOKEN\"\n\ncurl \"https://<server>.taxcom.ru/API/v2/KKTList?id=$OUTLET_ID&np=Problem\" \\\n  -H \"Session-Token: $SESSION_TOKEN\"\n\ncurl \"https://<server>.taxcom.ru/API/v2/KKTInfo?fn=$FN\" \\\n  -H \"Session-Token: $SESSION_TOKEN\"","language":"bash","methods":["POST /API/v2/Login","GET /API/v2/DepartmentList","GET /API/v2/OutletList","GET /API/v2/KKTList","GET /API/v2/KKTInfo"]},{"id":"sverit-cheki-s-uchetnoy-sistemoy","title":"Сверить чеки с учётной системой","summary":"Сравни число чеков по сменам со своими данными, а по сменам с расхождением спустись до конкретных документов.","steps":["Войди и получи маркер.","Получи смены ККТ за период: 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={номер ФД}."],"code":"curl \"https://<server>.taxcom.ru/API/v2/ShiftList?fn=$FN&begin=2017-03-20T00:00:00&end=2017-03-21T00:00:00&ps=100\" \\\n  -H \"Session-Token: $SESSION_TOKEN\"\n\ncurl \"https://<server>.taxcom.ru/API/v2/DocumentList?fn=$FN&shift=$SHIFT&type=3&type=31\" \\\n  -H \"Session-Token: $SESSION_TOKEN\"\n\ncurl \"https://<server>.taxcom.ru/API/v2/DocumentInfo?fn=$FN&fd=$FD\" \\\n  -H \"Session-Token: $SESSION_TOKEN\"","language":"bash","methods":["GET /API/v2/ShiftList","GET /API/v2/ShiftInfo","GET /API/v2/DocumentList","GET /API/v2/DocumentInfo"]},{"id":"zabirat-novye-cheki-potokom","title":"Забирать новые чеки потоком","summary":"Инкрементальная выгрузка всех новых фискальных документов без обхода смен. Метод дополнительный — доступ даёт Такском по запросу.","steps":["Войди и получи маркер.","Первый вызов — без `id`: GET /API/v2/NewDocuments (по одному договору — с `an`).","Сохрани `id` последнего документа и повторяй запрос с ним, пока не дойдёшь до последнего принятого Такскомом документа.","Дальше опрашивай не чаще раза в минуту. Окно — только документы, принятые за последние 10 суток, до 10 000 за вызов."],"code":"curl \"https://<server>.taxcom.ru/API/v2/NewDocuments?an=$CONTRACT\" \\\n  -H \"Session-Token: $SESSION_TOKEN\"\n\ncurl \"https://<server>.taxcom.ru/API/v2/NewDocuments?an=$CONTRACT&id=$LAST_ID\" \\\n  -H \"Session-Token: $SESSION_TOKEN\"","language":"bash","methods":["GET /API/v2/NewDocuments"]},{"id":"poluchit-pdf-cheka","title":"Получить PDF чека","summary":"Печатная форма документа по заводскому номеру ККТ и фискальному признаку.","steps":["Войди и получи маркер.","Найди документ (через DocumentList или NewDocuments) и возьми заводской номер ККТ и ФП.","Запроси PDF: GET /API/v2/PrintDocument/pdf?kktId={заводской номер}&fp={ФП}."],"code":"curl \"https://<server>.taxcom.ru/API/v2/PrintDocument/pdf?kktId=$KKT_SERIAL&fp=$FP\" \\\n  -H \"Session-Token: $SESSION_TOKEN\" -o receipt.pdf","language":"bash","methods":["GET /API/v2/PrintDocument/pdf"]}],"baseUrls":[{"label":"Боевой","url":"https://<server>.taxcom.ru"},{"label":"Документация задаёт адрес шаблоном ; конкретное имя сервера в публичной документации не указано.","url":"https://<server>.taxcom.ru/API/v2/..."}],"auth":{"type":"other","description":"Три способа: сертификат, логин и пароль, OAuth. Для входа по логину и паролю: POST /API/v2/Login с заголовком `Integrator-ID` (ИД интегратора, выдаёт Такском) и телом по схеме `Login_Request` (приложение № 1). В ответе — временный маркер доступа; его передают в заголовке `Session-Token` всех следующих запросов. Маркер живёт 5 минут с момента получения или последнего использования; просроченный — ошибка HTTP 401. Повторный вызов Login не создаёт новый маркер, пока прежний действует.\n\nOAuth включается Такскомом вручную для зарегистрированного приложения: авторизация на `https://auth-<server>.taxcom.ru/core/connect/authorize` (`client_id`, `response_type=code`, `scope=api`), обмен кода на POST `https://<server>.taxcom.ru/core/connect/token`.","example":""},"methods":[{"id":"POST /API/v2/Login","title":"Вход по логину и паролю","httpMethod":"POST","path":"/API/v2/Login","description":"Тело и ответ описаны схемами `Login_Request.jsonscheme` и `Login_Response.jsonscheme` (приложение № 1, архив JSON-схем).","params":[{"name":"Integrator-ID","in":"header","type":"string","required":true,"description":"ИД интегратора"},{"name":"Content-Type","in":"header","type":"string","required":true,"description":"application/json"}],"requestExample":"","responseExample":"","docsUrl":"https://lk-ofd.taxcom.ru/ApiHelp/login_i_parol.html"},{"id":"GET /API/v2/AccountList","title":"Договоры и права пользователя","httpMethod":"GET","path":"/API/v2/AccountList","description":"В ответе: дата формирования, число записей, номер договора текущего ЛК; по каждому договору — номер, организация, ИНН, КПП, права (администратор, разделы «Управление», «Мониторинг», «Аналитика», «Отчёты», просмотр фискальных документов).","params":[{"name":"Session-Token","in":"header","type":"string","required":true,"description":"Временный маркер доступа"}],"requestExample":"","responseExample":"","docsUrl":"https://lk-ofd.taxcom.ru/ApiHelp/lichnye_kabinety.html"},{"id":"GET /API/v2/DepartmentList","title":"Подразделения кабинета","httpMethod":"GET","path":"/API/v2/DepartmentList","description":"По подразделению: ИД, название, код, родительское подразделение, признак проблемы (`OK`, `Warning`, `Problem`).","params":[{"name":"Session-Token","in":"header","type":"string","required":true,"description":"Временный маркер доступа"},{"name":"np","in":"query","type":"string","required":false,"description":"Фильтр по проблеме: OK, Warning, Problem"},{"name":"pn","in":"query","type":"integer","required":false,"description":"Номер страницы; по умолчанию первая"},{"name":"ps","in":"query","type":"integer","required":false,"description":"Записей на странице, 1–100 (по умолчанию 100)"}],"requestExample":"","responseExample":"","docsUrl":"https://lk-ofd.taxcom.ru/ApiHelp/spisok_podrazdelenij_lk.html"},{"id":"GET /API/v2/OutletList","title":"Торговые точки","httpMethod":"GET","path":"/API/v2/OutletList","description":"Точки подразделения и его дочерних подразделений, без `id` — все. По точке: подразделение, ИД, название, код, адрес, признак проблемы.","params":[{"name":"Session-Token","in":"header","type":"string","required":true,"description":"Временный маркер доступа"},{"name":"id","in":"query","type":"string","required":false,"description":"ИД подразделения"},{"name":"np","in":"query","type":"string","required":false,"description":"OK, Warning, Problem"},{"name":"pn","in":"query","type":"integer","required":false,"description":"Номер страницы"},{"name":"ps","in":"query","type":"integer","required":false,"description":"1–100, по умолчанию 100"}],"requestExample":"","responseExample":"","docsUrl":"https://lk-ofd.taxcom.ru/ApiHelp/spisok_torgovykh_tochek.html"},{"id":"GET /API/v2/KKTList","title":"ККТ торговой точки","httpMethod":"GET","path":"/API/v2/KKTList","description":"По ККТ: название, рег. и заводской номер, номер ФН, состояние (`Active`, `Expires`, `Expired`, `Inactive`, `Activation`, `Deactivation`, `FNChange`, `FNSRegistration`, `FNSRegistrationError`), признак проблемы.","params":[{"name":"Session-Token","in":"header","type":"string","required":true,"description":"Временный маркер доступа"},{"name":"id","in":"query","type":"string","required":true,"description":"ИД торговой точки"},{"name":"np","in":"query","type":"string","required":false,"description":"OK, Warning, Problem"},{"name":"pn","in":"query","type":"integer","required":false,"description":"Номер страницы"},{"name":"ps","in":"query","type":"integer","required":false,"description":"1–100, по умолчанию 100"}],"requestExample":"","responseExample":"","docsUrl":"https://lk-ofd.taxcom.ru/ApiHelp/spisok_kkt_po_torgovoj_tochke.html"},{"id":"GET /API/v2/KKTInfo","title":"Сводные данные по ККТ","httpMethod":"GET","path":"/API/v2/KKTInfo","description":"В ответе: модель, номера ККТ и ФН, дата регистрации и срок ФН, статус смены (`Open`, `Close`, `NoData`), состояние ККТ и ФН, «оплачена по», последний документ (`OK`, `Warning`, `Problem`) и его дата, торговая точка, партнёр.","params":[{"name":"Session-Token","in":"header","type":"string","required":true,"description":"Временный маркер доступа"},{"name":"fn","in":"query","type":"string","required":true,"description":"Номер фискального накопителя"}],"requestExample":"","responseExample":"","docsUrl":"https://lk-ofd.taxcom.ru/ApiHelp/svodnye_dannye_po_kkt.html"},{"id":"GET /API/v2/ShiftList","title":"Смены ККТ за период","httpMethod":"GET","path":"/API/v2/ShiftList","description":"Смены, которые полностью или частично попали в период: номер ФН, номер смены, даты открытия и закрытия, число чеков.","params":[{"name":"Session-Token","in":"header","type":"string","required":true,"description":"Временный маркер доступа"},{"name":"fn","in":"query","type":"string","required":true,"description":"Номер ФН"},{"name":"begin","in":"query","type":"string","required":true,"description":"Начало периода, например 2017-03-20T10:47:00"},{"name":"end","in":"query","type":"string","required":true,"description":"Окончание периода"},{"name":"pn","in":"query","type":"integer","required":false,"description":"Номер страницы"},{"name":"ps","in":"query","type":"integer","required":false,"description":"1–100, по умолчанию 100"}],"requestExample":"","responseExample":"","docsUrl":"https://lk-ofd.taxcom.ru/ApiHelp/spisok_smen_za_period_po_kkt.html"},{"id":"GET /API/v2/ShiftInfo","title":"Сводные данные по смене","httpMethod":"GET","path":"/API/v2/ShiftInfo","description":"Даты открытия и закрытия, номера ФД отчётов, кассир, статус (`Open`, `Close`); по приходу, возврату прихода, коррекции, расходу и возврату расхода — суммы в копейках (наличные, безналичные), число чеков и позиций, разбивка по ставкам НДС.","params":[{"name":"Session-Token","in":"header","type":"string","required":true,"description":"Временный маркер доступа"},{"name":"fn","in":"query","type":"string","required":true,"description":"Номер ФН"},{"name":"shift","in":"query","type":"integer","required":true,"description":"Номер смены"}],"requestExample":"","responseExample":"","docsUrl":"https://lk-ofd.taxcom.ru/ApiHelp/svodnye_dannye_po_smene.html"},{"id":"GET /API/v2/DocumentList","title":"Документы смены","httpMethod":"GET","path":"/API/v2/DocumentList","description":"По документу: номер ФН, смена, тип, дата и время, номер ФД, номер в смене, ФПД, кассир, система налогообложения, признак расчёта (`Income`, `IncomeReturn`, `Expenditure`, `ExpendituReReturn`), суммы в копейках.","params":[{"name":"Session-Token","in":"header","type":"string","required":true,"description":"Временный маркер доступа"},{"name":"fn","in":"query","type":"string","required":true,"description":"Номер ФН"},{"name":"shift","in":"query","type":"integer","required":true,"description":"Номер смены"},{"name":"type","in":"query","type":"integer","required":false,"description":"Тип документа, можно повторять: 2 открытие смены, 21 отчёт о расчётах, 3 чек, 31 коррекция чека, 4 БСО, 41 коррекция БСО, 5 закрытие смены"},{"name":"pn","in":"query","type":"integer","required":false,"description":"Номер страницы"},{"name":"ps","in":"query","type":"integer","required":false,"description":"1–100, по умолчанию 100"}],"requestExample":"","responseExample":"","docsUrl":"https://lk-ofd.taxcom.ru/ApiHelp/spisok_dokumentov_po_smene.html"},{"id":"GET /API/v2/DocumentInfo","title":"Данные документа","httpMethod":"GET","path":"/API/v2/DocumentInfo","description":"Полный фискальный документ (схема `DocumentInfo_Response`, приложение № 7); тег `documentFormatDate` — дата формата ФД (05.05.2016 или 21.03.2017).","params":[{"name":"Session-Token","in":"header","type":"string","required":true,"description":"Временный маркер доступа"},{"name":"fn","in":"query","type":"string","required":true,"description":"Номер ФН"},{"name":"fd","in":"query","type":"string","required":true,"description":"Номер фискального документа"}],"requestExample":"","responseExample":"","docsUrl":"https://lk-ofd.taxcom.ru/ApiHelp/dannye_dokumenta.html"},{"id":"GET /API/v2/PrintDocument/pdf","title":"Печать документа в PDF","httpMethod":"GET","path":"/API/v2/PrintDocument/pdf","description":"Ответ — PDF-файл. Есть также печать в HTML.","params":[{"name":"Session-Token","in":"header","type":"string","required":true,"description":"Временный маркер доступа"},{"name":"kktId","in":"query","type":"string","required":true,"description":"Заводской номер ККТ"},{"name":"fp","in":"query","type":"string","required":true,"description":"Фискальный признак документа"}],"requestExample":"","responseExample":"","docsUrl":"https://lk-ofd.taxcom.ru/ApiHelp/pechat_dokumenta_v_pdf_formate.html"},{"id":"GET /API/v2/NewDocuments","title":"Новые документы","httpMethod":"GET","path":"/API/v2/NewDocuments","description":"Документы, принятые Такскомом за последние 10 суток, по времени приёма, до 10 000 за вызов. Типы: открытие и закрытие смены, отчёт о расчётах, кассовый чек и коррекция, БСО и коррекция.","params":[{"name":"Session-Token","in":"header","type":"string","required":true,"description":"Временный маркер доступа"},{"name":"an","in":"query","type":"string","required":false,"description":"Номер договора; без него — по всем доступным кабинетам"},{"name":"id","in":"query","type":"string","required":false,"description":"ИД последнего полученного документа; без него — самые ранние доступные"}],"requestExample":"","responseExample":"","docsUrl":"https://lk-ofd.taxcom.ru/ApiHelp/novye_dokumenty.html"}],"codeExamples":[],"errors":[{"code":"401","description":"Маркер доступа отсутствует или истёк (HTTP)"},{"code":"2203","description":"Некорректный ИД документа (NewDocuments)"},{"code":"3101","description":"Документ не найден"},{"code":"3102","description":"Торговая точка не найдена"},{"code":"3103","description":"ККТ не найдена (не найден ФН)"},{"code":"3104","description":"Подразделение не найдено"},{"code":"3105","description":"Смена не найдена"},{"code":"3106","description":"Не найдено ни одной ККТ, доступной пользователю"}],"limits":"- Маркер `Session-Token` живёт 5 минут с последнего использования.\n- До 100 записей на страницу в списках.\n- `NewDocuments`: окно 10 суток, до 10 000 документов за вызов, опрос после догона — не чаще раза в минуту.","gotchas":["Все методы синхронные; ответы — JSON по схемам из архива приложений (`https://files.taxcom.ru/files/Taxcom_API.zip`).","Суммы — в копейках.","Списки постраничные: `pn` (номер страницы) и `ps` (1–100, по умолчанию 100).","Результаты зависят от прав сотрудника в «Такском-Кассе»; договоры без доступа в `AccountList` не попадают.","`NewDocuments` и другие дополнительные методы доступны по отдельному запросу в Такском.","Справочники моделей ККТ и ФН и сведения из реестров ФНС доступны без авторизации."],"slug":"taxcom","version":1,"updatedAt":"2026-10-25T06:02:50.486Z","sources":[{"title":"Такском API — техническое описание","url":"https://lk-ofd.taxcom.ru/ApiHelp/","kind":"research","addedAt":"2026-10-25T06:01:51.421Z"},{"title":"Перечень методов","url":"https://lk-ofd.taxcom.ru/ApiHelp/perechen_metodov.html","kind":"research","addedAt":"2026-10-25T06:01:51.421Z"},{"title":"Сценарии использования API","url":"https://lk-ofd.taxcom.ru/ApiHelp/stsenarii_ispolzovaniya_api.html","kind":"research","addedAt":"2026-10-25T06:01:51.421Z"},{"title":"Логин и пароль","url":"https://lk-ofd.taxcom.ru/ApiHelp/login_i_parol.html","kind":"research","addedAt":"2026-10-25T06:01:51.421Z"},{"title":"OAuth","url":"https://lk-ofd.taxcom.ru/ApiHelp/oauth.html","kind":"research","addedAt":"2026-10-25T06:01:51.421Z"},{"title":"Новые документы","url":"https://lk-ofd.taxcom.ru/ApiHelp/novye_dokumenty.html","kind":"research","addedAt":"2026-10-25T06:01:51.421Z"},{"title":"JSON-схемы запросов и ответов","url":"https://lk-ofd.taxcom.ru/ApiHelp/json_skhemy_zaprosov_i_otvetov.html","kind":"research","addedAt":"2026-10-25T06:01:51.421Z"},{"title":"Вставленный текст","url":"","kind":"import","addedAt":"2026-10-25T06:01:51.421Z"}],"logoUrl":null}