Публичное API kptp.ru
REST API для своих интеграций: создавайте КП из CRM, сайта или 1С по вашему каталогу, забирайте итоги и строки КП, публикуйте версии и узнавайте, открывал ли клиент предложение.
Тариф «Профессиональный» и пробный период
Что умеет интеграция
КП из вашей системы
Передайте этапы и строки — сервер посчитает итоги и сроки так же, как редактор kptp.ru, и сохранит КП. С dry_run — только расчёт без сохранения.
Цены из каталога
Позиции подставляются по nomenclature_id: единица, цена, себестоимость и темп работ берутся из вашего каталога номенклатуры.
Итоги и строки КП
Сводка с итогами min/max, сроками и этапами или все строки с ценами — для выгрузки в CRM, 1С или отчёты.
Версии и сравнение
Список версий проекта с публикацией и доступом и разница между двумя версиями: что добавлено, удалено и как изменился итог.
Публикация и просмотры
Отмечайте версию опубликованной и получайте статистику просмотров клиентом: сколько раз открыл, как долго читал, скачивал ли PDF.
Тот же токен, что для ИИ
API и MCP работают по одному личному токену с выбранными правами и сроком действия, отзывается в один клик.
Как подключить
- 1
Откройте в личном кабинете «Интеграции» → «API и ИИ-ассистенты» и выпустите токен с нужными правами:
kp:read— чтение,kp:write— создание КП,kp:publish— публикация. - 2
Передавайте токен в заголовке
Authorization: Bearer <токен>в запросах кhttps://kptp.ru/api/v1. - 3
Проверьте подключение запросом
GET /me— он вернёт владельца токена, тариф и права. Остальные методы можно попробовать прямо на этой странице: кнопка «Authorize» в документации ниже.
Например, список проектов:
curl https://kptp.ru/api/v1/projects -H "Authorization: Bearer <токен>"
Методы API
GET /meВладелец токена, тариф и праваGET /projectsСписок проектов с поискомGET /projects/{id}/versionsВерсии проекта и их публикацияGET /kp/{hash}КП: итоги, этапы или все строкиGET /kp/{a}/diff/{b}Сравнение двух версийGET /kp/{hash}/statsПросмотры КП клиентомPOST /kpСоздание КП (с dry_run — только расчёт)PUT / DELETE /kp/{hash}/publicationПубликация версииGET /nomenclatureПоиск по каталогу номенклатурыGET /templatesШаблоны КПGET /guidelinesВаши правила составления КПДокументация
Чтобы выполнить запрос прямо здесь, нажмите «Authorize» и вставьте токен. Запросы уходят от вашего имени — с токеном на запись тестовые КП сохранятся в ваш кабинет.
Загрузка документации… Спецификация: /api/v1/openapi.yaml
Коды ошибок
400 invalid_paramsНеверные параметры запроса — объяснение в поле detail400 invalid_jsonТело запроса — не JSON-объект401 unauthorizedНет заголовка Authorization: Bearer401 invalid_tokenТокен неверный, просрочен или отозван403 tariff_requiredУ владельца токена нет тарифа «Профессиональный»403 insufficient_scopeТокену не хватает права — нужное в поле required_scope403 code_requiredЧужая КП защищена кодовым словом: передайте его в параметре code403 forbiddenНет права на действие, например на публикацию КП команды404 not_foundКП, проект или позиция каталога не найдены либо закрыты405 method_not_allowedМетод HTTP не поддерживается для этого адреса415 unsupported_media_typeТело запроса нужно передавать с Content-Type: application/json422 unprocessableЗапрос нельзя выполнить: например, неверный cursor или qty_max меньше qty_min429 rate_limitedБольше 60 запросов в минуту на токен — повторите через Retry-After секунд429 too_many_failed_authСлишком много запросов с неверным токеном с одного IP500 internalОшибка сервера — повторите позжеКак устроено API
API отвечает в JSON, ошибки — в формате RFC 9457 (application/problem+json) с постоянным кодом в поле code. Списки отдаются страницами: если в ответе есть next_cursor, передайте его в параметр cursor.
Суммы — в рублях. Итог КП бывает диапазоном: поле mode показывает, что видит клиент (range — «от и до», fixed — одна сумма), а client_total — сумму в этом режиме. Полная спецификация — openapi.yaml: её можно импортировать в Postman или сгенерировать по ней клиент.
Вопросы и ответы
Чем API отличается от MCP?
MCP — для ИИ-ассистентов (Claude, ChatGPT, Cursor), API — для ваших программ: CRM, сайта, 1С, скриптов. Данные и права одни и те же, токен тоже один.
Какие лимиты у API?
60 запросов в минуту на токен, общий лимит с MCP. Остаток виден в заголовке X-RateLimit-Remaining.
Можно ли через API удалять КП или менять каталог?
Пока нет: API читает КП, каталог и шаблоны, создаёт новые КП и публикует версии. Существующие КП не перезаписываются — каждая новая сохраняется отдельным проектом.
На каком тарифе доступно API?
На тарифе «Профессиональный» и в пробном периоде.
Демо и связь с разработчиком
Интеграцию «Публичное API» разрабатывает и поддерживает команда kptp.ru. Покажем её в работе или ответим на вопрос по подключению и настройке.
- Демо — 30 минут онлайн: соберём КП на ваших товарах и услугах, покажем шаблоны, PDF и Публичное API в связке.
- Вопрос разработчику — подключение, права, доработки под ваш процесс, ошибки.
Ответим в течение рабочего дня. Или напишите сразу: Telegram, studio@a-de.ru.
Другие интеграции
Интеграция с Битрикс24
Вкладка KPTP.RU в сделках, лидах, контактах и компаниях. Ссылка и PDF КП — в полях CRM, товары — между сделкой и КП.
Виджет для amoCRM
Кнопка «Создать КП» в сделках, контактах и компаниях. ID и ссылка на КП заполняются в полях карточки автоматически.
КП через ИИ-ассистентов (MCP)
MCP-сервер для Claude, ChatGPT, Cursor и VS Code: ассистент собирает КП по вашему каталогу и правилам.
Онлайн-подписание КП с OkiDoki
Кнопка «Подписать онлайн» в КП: клиент подписывает PDF по коду из SMS, документ приходит обеим сторонам.
Уведомления о КП в MAX
Бот присылает в MAX сообщения «КП создано», «КП просмотрено», «КП скачано» (PDF, XLSX, DOCX) и о неверном кодовом слове.
Ваша интеграция
Нужна связка с вашей CRM или ERP — или вы развиваете сервис и хотите партнёрскую интеграцию? Оставьте заявку.
Попробуйте kptp.ru — первое КП за несколько минут
Каталог, этапы, сроки и красивый PDF. Пробный период — бесплатно.
Попробовать бесплатно