VARICA
digital proposal bureau
VARICA / Документация v2

Создание страницы КП

Создаёт публичную страницу по шаблону, принимает обычные поля и табличные строки, возвращает URL и slug страницы.

МетодPOST Endpoint/api/v2/pages АвторизацияX-Api-Key Входmultipart/form-data Выходapplication/json
01 / Раздел

Назначение

Метод нужен для внешней генерации страницы КП. Клиентская система передаёт template_id, source_entity_id, поля data.* и табличные строки rows.*.

Сервис подставляет данные в шаблон, разворачивает таблицы и создаёт отдельную публичную страницу.

02 / Раздел

Поля

  • `template_id` - обязательное поле, ID шаблона.
  • `source_entity_id` - обязательное поле, ID сущности во внешней системе.
  • `page_slug` - необязательное поле, желаемый slug страницы.
  • `data.` - обычные переменные шаблона.
  • `rows.` - табличные переменные шаблона.
03 / Раздел

Правила таблиц

  • Разделитель строк в таблицах - только `|`.
  • Запятые внутри значений допустимы и не делят строки.
  • Если в одном поле 3 значения, а в другом 5, сервис создаёт 5 строк.
  • Если значений меньше, оставшиеся ячейки остаются пустыми.
04 / Раздел

Пример запроса

cURL
curl -X POST "http://varica.ru/api/v2/pages" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -F "template_id=54" \
  -F "source_entity_id=9999999" \
  -F "page_slug=zinker_offer_9999999" \
  -F "data.bud_full=100 765" \
  -F "data.bud_m=2 343" \
  -F "data.bud_t=102" \
  -F "data.compan_name=Название компании \"Рога и копыта\"" \
  -F "data.data_kp=01.02.2026" \
  -F "data.price=10000" \
  -F "data.resp=Я" \
  -F "data.terms_of_delivery=Доставка" \
  -F "rows.tables.count=1|2|3" \
  -F "rows.tables.name=первый|второй|третий" \
  -F "rows.tables.position_price=100,20|200,30|1,40" \
  -F "rows.tables.price_kg=3,2|5,7|8,1"
05 / Раздел

Пример ответа

JSON
{
  "page_id": 48,
  "url": "https://varica.ru/K7x_9Q.template_lab.zinker",
  "pdf_url": "https://varica.ru/K7x_9Q.template_lab.zinker/download.pdf",
  "page_slug": "kp45d51041"
}
06 / Раздел

Памятка для ИИ

Краткая инструкция
Нужно отправить POST /api/v2/pages.
Формат входа только multipart/form-data.
Обязательные поля: template_id, source_entity_id.
Необязательное поле: page_slug.
Обычные переменные передаются как data.<mask>.
Табличные переменные передаются как rows.<mask>.
Разделитель строк таблиц: |.
Ответ сервиса всегда JSON: page_id, url, pdf_url, page_slug. pdf_url открывает и начинает скачивание PDF.