Сгенерировать документ с изображениями и печатями

Выберите инструмент для разработки с AI-агентом:

используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации

Изображения, печати и подписи для плейсхолдеров шаблона передаются в метод documentgenerator.document.add ссылками на файлы в values. Файлы скачиваются по указанному URL и вставляются в документ при генерации.

Когда использовать

Нужно вставить изображение по внешней ссылке
Нужно добавить печать или подпись в поле шаблона

Что передавать в запросе

В values передайте абсолютные URL файлов. URL файла должен быть доступен Битрикс24 без дополнительной авторизации
В fields для кода поля укажите тип:
- IMAGE — поле изображения
- STAMP — поле печати или подписи
Коды полей в values и fields должны совпадать с кодами плейсхолдеров в шаблоне

Пример

$data = [
            'templateId' => 203,
            'providerClassName' => 'Bitrix\\DocumentGenerator\\DataProvider\\Rest',
            'value' => 'ORDER_1024',
            'values' => [
                'Stamp' => 'https://myrestapp.example/upload/stamp.png', // внешний путь к файлу печати
                'Image' => 'https://myrestapp.example/upload/image.jpg', // внешний путь к файлу изображения
            ],
            'fields' => [
                'Stamp' => ['TYPE' => 'STAMP'], // тип поля - печать
                'Image' => ['TYPE' => 'IMAGE'], // тип поля - изображение
            ]
        ];
        $url = $webHookUrl.'documentgenerator.document.add/';