Публичное API kptp.ru

REST API для своих интеграций: создавайте КП из CRM, сайта или 1С по вашему каталогу, забирайте итоги и строки КП, публикуйте версии и узнавайте, открывал ли клиент предложение.

Тариф «Профессиональный» и пробный период

Что умеет интеграция

КП из вашей системы

Передайте этапы и строки — сервер посчитает итоги и сроки так же, как редактор kptp.ru, и сохранит КП. С dry_run — только расчёт без сохранения.

Цены из каталога

Позиции подставляются по nomenclature_id: единица, цена, себестоимость и темп работ берутся из вашего каталога номенклатуры.

Итоги и строки КП

Сводка с итогами min/max, сроками и этапами или все строки с ценами — для выгрузки в CRM, 1С или отчёты.

Версии и сравнение

Список версий проекта с публикацией и доступом и разница между двумя версиями: что добавлено, удалено и как изменился итог.

Публикация и просмотры

Отмечайте версию опубликованной и получайте статистику просмотров клиентом: сколько раз открыл, как долго читал, скачивал ли PDF.

Тот же токен, что для ИИ

API и MCP работают по одному личному токену с выбранными правами и сроком действия, отзывается в один клик.

Как подключить

  1. 1

    Откройте в личном кабинете «Интеграции» → «API и ИИ-ассистенты» и выпустите токен с нужными правами: kp:read — чтение, kp:write — создание КП, kp:publish — публикация.

  2. 2

    Передавайте токен в заголовке Authorization: Bearer <токен> в запросах к https://kptp.ru/api/v1.

  3. 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Неверные параметры запроса — объяснение в поле detail
400 invalid_jsonТело запроса — не JSON-объект
401 unauthorizedНет заголовка Authorization: Bearer
401 invalid_tokenТокен неверный, просрочен или отозван
403 tariff_requiredУ владельца токена нет тарифа «Профессиональный»
403 insufficient_scopeТокену не хватает права — нужное в поле required_scope
403 code_requiredЧужая КП защищена кодовым словом: передайте его в параметре code
403 forbiddenНет права на действие, например на публикацию КП команды
404 not_foundКП, проект или позиция каталога не найдены либо закрыты
405 method_not_allowedМетод HTTP не поддерживается для этого адреса
415 unsupported_media_typeТело запроса нужно передавать с Content-Type: application/json
422 unprocessableЗапрос нельзя выполнить: например, неверный cursor или qty_max меньше qty_min
429 rate_limitedБольше 60 запросов в минуту на токен — повторите через Retry-After секунд
429 too_many_failed_authСлишком много запросов с неверным токеном с одного IP
500 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.

Другие интеграции

Попробуйте kptp.ru — первое КП за несколько минут

Каталог, этапы, сроки и красивый PDF. Пробный период — бесплатно.

Попробовать бесплатно