Руководство пользователя
AIVIO помогает быстро создавать документы по готовому шаблону и данным из Excel. Вместо ручного копирования текста вы загружаете файлы, запускаете обработку и получаете готовый комплект документов для скачивания.
На этой странице документация разделена на отдельные сценарии: генерация документов, конвертация КА в GGE и конвертация ВОР в GGE. У каждого сценария свои правила подготовки файлов, поэтому ниже они описаны отдельно и без смешения.
Готовый документ становится основой для целой серии файлов.
Данные можно передать строками или столбцами; Aivio сам определит подходящий формат.
После обработки вы скачиваете отдельный файл или архив с полным комплектом документов.
Быстрый старт
Сначала определите, что именно вам нужно сделать: сгенерировать документы по шаблону, выполнить конвертацию КА в GGE или подготовить ВОР в формате GGE. Это разные сценарии с разными правилами подготовки Excel-файла.
Не используйте один и тот же мысленный сценарий для всего сервиса. Генерация работает с шаблоном документа и своим Excel-файлом, конвертация КА в GGE использует структуру конъюнктурного анализа, а ВОР в GGE ожидает официальный XLSX-шаблон ведомости объемов работ.
Возможности сервиса
Сервис рассчитан на повседневную работу с однотипными документами. Он избавляет от ручной подстановки данных и помогает быстрее получать итоговые файлы в нужном формате.
Сервис берет один подготовленный шаблон и автоматически подставляет в него значения из таблицы, сохраняя структуру и оформление документа.
Таблица Excel используется как источник данных. Каждая строка описывает отдельный комплект информации для генерации.
После обработки вы получаете готовые документы по всем строкам Excel. При большом объеме результат может быть собран в архив для удобной загрузки.
Отдельный режим для Excel-файлов конъюнктурного анализа. Сервис проверяет структуру файла, формирует результат в формате GGE и отдает его в ZIP-архиве.
Отдельный режим для ведомостей объемов работ. Сервис принимает официальный XLSX-шаблон ВОР, формирует GGE-файл и упаковывает результат в ZIP-архив.
Итог появляется прямо в интерфейсе: вы можете скачать отдельный файл или архив и сразу передать документы дальше по рабочему процессу.
Генерация документов
Этот блок относится только к генерации документов по шаблону. Если вам нужна конвертация КА или ВОР в GGE, используйте отдельные разделы ниже: там другие Excel-файлы и другие правила подготовки.
Используйте чистовую версию документа, которая уже содержит нужный текст, таблицы, подписи и оформление. Чем ближе шаблон к финальному виду, тем меньше ручных правок понадобится после генерации.
Соберите все значения в одной таблице. Первая строка содержит названия полей, а каждая следующая строка должна описывать отдельный документ или отдельный набор данных.
Выберите шаблон и Excel-файл в форме загрузки. Перед запуском еще раз проверьте названия файлов, чтобы случайно не использовать устаревшую версию шаблона или таблицы.
После нажатия кнопки сервис сначала проверит шаблон и Excel: сравнит плейсхолдеры, заголовки и покажет экран проверки, если найдет ошибки или предупреждения.
Если сервис показал только предупреждения, вы сможете посмотреть их и нажать «Продолжить несмотря на предупреждения». Если есть ошибки, сначала исправьте файлы и загрузите их заново.
После подтверждения или если предупреждений нет, задача перейдет в обработку. В зависимости от выбранного режима вы получите один итоговый документ или ZIP-архив с файлами для скачивания.
Если результат выглядит не так, как ожидалось, причина чаще всего находится в шаблоне или Excel-файле. Перед повторным запуском проверьте именно исходные данные.
Генерация документов
Этот раздел относится только к генерации документов. Шаблон — это основа будущего файла, в который сервис будет подставлять данные из Excel. Для конвертации КА в GGE шаблон документа не требуется.
Если шаблон уже настроен и в нем есть специальные места для автоматической подстановки данных, не удаляйте их и не меняйте их написание без необходимости.
Плейсхолдеры можно использовать и на латинице, и на кириллице: например, {{name}}, {{contract_number}}, {{ФИО}}, {{Город}}. В обычном Excel те же названия указываются в первой строке без фигурных скобок. В Excel по столбцам плейсхолдеры указываются в первом столбце, можно с фигурными скобками.
Генерация документов
Морфология работает только в генерации документов. Она нужна, когда одно и то же значение из Excel должно автоматически подставляться в разных формах: с инициалами, в нужном падеже, прописью или в специальном формате для даты и числа.
В Excel достаточно одной базовой колонки, например ФИО или Дата. В шаблоне вы можете использовать не только базовый плейсхолдер, но и его производные формы, например {{ФИО.кому}} или {{Дата.прописью}}.
Названия плейсхолдеров могут быть как на латинице, так и на кириллице. Например, одинаково допустимы {{name}}, {{client_name}}, {{ФИО}} и {{Организация}}.
Для морфологии не нужно заводить отдельные колонки под каждую форму. Если в Excel есть колонка ФИО, этого достаточно, чтобы в шаблоне использовать и {{ФИО}}, и {{ФИО.кого}}, и {{ФИО.инициалы}}.
| Тип значения | Что хранить в Excel | Примеры плейсхолдеров в шаблоне |
|---|---|---|
| ФИО | ФИО → Иванов Иван Иванович |
{{ФИО}}, {{ФИО.кому}}, {{ФИО.кого}}, {{ФИО.с_кем}}, {{ФИО.о_ком}}, {{ФИО.инициалы}}, {{ФИО.инициалы_перед}}, {{ФИО.инициалы.кому}}, {{ФИО.инициалы_перед.кому}} |
| Дата | Дата → 19.03.2026 |
{{Дата}}, {{Дата.прописью}}, {{Дата.в_родительном}}, {{Дата.в_дательном}}, {{Дата.в_творительном}}, {{Дата.в_предложном}} |
| Число | Сумма → 123 |
{{Сумма}}, {{Сумма.прописью}}, {{Сумма.цифрами_и_прописью}} |
| Организация или обычный текст | Организация → ООО «Ромашка» |
{{Организация}}, {{Организация.кому}}, {{Организация.кого}}, {{Организация.с_кем}}, {{Организация.о_ком}} |
Сначала создайте и проверьте базовый плейсхолдер, например {{ФИО}} или {{Дата}}. После этого добавляйте производные формы: {{ФИО.кому}}, {{ФИО.инициалы}}, {{Дата.прописью}} и другие.
Генерация документов
Этот Excel-файл нужен именно для генерации документов по шаблону. Aivio автоматически определяет один из двух форматов: генерацию по строкам или генерацию комплекта по столбцам.
| Клиент | Номер договора | Дата | Сумма |
|---|---|---|---|
| ООО Альфа | 15-2026 | 05.04.2026 | 125 000 |
| ООО Бета | 16-2026 | 06.04.2026 | 98 500 |
{{act_number}}, {{customer}}.| Заполнитель | Акт 001 | Акт 002 |
|---|---|---|
{{act_number}} |
001 | 002 |
{{customer}} |
ООО Альфа | ООО Бета |
{{object_name}} |
Объект 1 | Объект 2 |
{{...}}, сервис включает генерацию по столбцам.Для генерации по строкам проверьте первую строку: там должны быть названия плейсхолдеров. Для генерации по столбцам проверьте первый столбец: там должны быть плейсхолдеры, а в первой строке — названия документов.
Если вам нужна конвертация КА или ВОР в GGE, не ориентируйтесь на этот пример. Для каждого сценария конвертации используется отдельный Excel-файл со своей структурой, и они описаны в разделах «Конвертация КА в GGE» и «Конвертация ВОР в GGE» ниже.
Генерация документов
После успешной генерации сервис формирует один итоговый результат для скачивания. Его тип зависит от того, включена ли опция «Объединить документы в один файл».
Если включена опция объединения, сервис собирает один итоговый документ .docx. Если опция выключена, сервис формирует отдельные документы и упаковывает их в ZIP-архив.
После завершения обработки ссылка на скачивание появляется на странице статуса и на странице результата. Готовый результат также остается доступным в списке ваших документов.
Подождите немного дольше, особенно если таблица большая. Если итог не появился, проверьте страницу статуса, затем шаблон, Excel и раздел с частыми ошибками. После завершения результат можно скачать позже из списка документов.
Откройте хотя бы 1-2 готовых документа и убедитесь, что даты, суммы, фамилии и переносы строк выглядят именно так, как вы ожидаете получить в финальном пакете.
Отдельный сценарий
Этот раздел не относится к генерации документов по шаблону. Здесь описан отдельный сценарий, в котором сервис берет Excel-файл конъюнктурного анализа и преобразует его в формат GGE. Для этого сценария действует собственное правило структуры файла.
Сервис ориентируется на структуру таблицы, а не на фиксированный номер строки. Для нового файла используйте форму 421/пр с изменениями 30/пр на 27 граф. Формы на 20 и 26 граф распознаются как legacy и показывают предупреждение, но могут быть сконвертированы, если обязательные поля читаются.
Это штатная часть сценария. Сервис показывает предупреждения, первые строки таблицы и найденные ошибки еще до запуска конвертации, чтобы вы могли исправить файл вовремя.
Отдельный сценарий
Этот раздел относится к ведомости объемов работ. Для ВОР используется отдельный XLSX-шаблон и отдельная GGE-схема, поэтому файл КАЦ или произвольную таблицу работ сюда загружать не нужно.
Строгий режим используется по умолчанию. Черновой режим разрешает скачать только XSD-valid GGE с предупреждениями и не подставляет фиктивные реквизиты, даты или ссылки.
Проверьте файл на небольшой ведомости: заполните шапку, один раздел, блок файлов и несколько строк работ. Так проще увидеть, что структура шаблона сохранена и результат формируется ожидаемо.
API и интеграции
Если вы хотите запускать обработку документов не через обычную форму сайта, а из CRM, внутреннего портала или другого сервиса, можно использовать API. Для этого нужен отдельный API-ключ, который создаётся в профиле пользователя.
Токен API-ключа показывается только один раз в момент создания. Передавайте ключ в заголовке Authorization: Api-Key ВАШ_API_КЛЮЧ и не храните его в открытом коде, GitHub, публичных репозиториях или frontend-коде. Если ключ был раскрыт, перевыпустите его и отзовите старый.
Запуски через API расходуют квоту API-вызовы, а не квоту Документы. Это относится и к генерации, и к конвертации через маршруты /api/documents/....
API-ключ передаётся в каждом запросе через заголовок Authorization.
Authorization: Api-Key ВАШ_API_КЛЮЧИспользуйте этот же заголовок для запуска задачи, опроса статуса и скачивания готового архива.
POST /api/documents/generate/ — запуск генерации.GET /api/documents/generate/<archive_id>/status/ — статус генерации.GET /api/documents/generate/<archive_id>/download/ — скачивание архива генерации.POST /api/documents/convert/ — запуск конвертации.GET /api/documents/convert/<conversion_id>/status/ — статус конвертации.GET /api/documents/convert/<conversion_id>/download/ — скачивание архива конвертации.GET /api/documents/keys/ — список ваших ключей.Если просто открыть её в браузере, архив может не скачаться, потому что браузер не передаёт API-ключ в заголовке Authorization. Для скачивания используйте Python, curl, Postman или другой API-клиент.
POST /api/documents/convert/.conversion_type=market_analysis. Для ВОР передайте conversion_type=work_amount_sheet.status_url.status_url с тем же заголовком авторизации.status == "ok", status == "completed" или status == "completed_with_warnings", в ответе появится download_url.download_url ведёт на /api/documents/convert/<conversion_id>/download/.GET-запросом с заголовком Authorization.POST /api/documents/generate/.status_url.status_url с тем же API-ключом.status == "ok", в ответе появится download_url.download_url ведёт на /api/documents/generate/<archive_id>/download/.GET-запросом с заголовком Authorization.Передавать отдельный параметр режима не нужно. Если в Excel в первом столбце, начиная со второй строки, стоят плейсхолдеры вида {{...}}, API запустит генерацию комплекта по столбцам. В стартовом ответе будет поле generation_mode со значением column_batch. Если проверка вернёт предупреждения, в ответе также будут document_titles и excel_placeholders.
Используйте тот же маршрут POST /api/documents/convert/, что и для КА, но добавьте параметр conversion_type=work_amount_sheet. Для ВОР можно передать validation_mode=strict или validation_mode=draft; строгий режим используется по умолчанию.
import os
import time
from urllib.parse import urljoin
import requests
BASE_URL = "https://aivio.ru"
API_KEY = os.environ["AIVIO_API_KEY"]
headers = {
"Authorization": f"Api-Key {API_KEY}",
}
def make_url(path_or_url: str) -> str:
return urljoin(BASE_URL, path_or_url)
with open("source.xlsx", "rb") as source_file:
start = requests.post(
make_url("/api/documents/convert/"),
headers=headers,
files={"file": source_file},
data={"conversion_type": "market_analysis"},
timeout=60,
)
start.raise_for_status()
status_url = make_url(start.json()["status_url"])
while True:
status_response = requests.get(status_url, headers=headers, timeout=30)
status_response.raise_for_status()
status = status_response.json()
if status["status"] in {"ok", "completed"}:
download_url = make_url(status["download_url"])
archive_response = requests.get(
download_url,
headers=headers,
timeout=120,
stream=True,
allow_redirects=False,
)
archive_response.raise_for_status()
with open("converted_archive.zip", "wb") as archive_file:
for chunk in archive_response.iter_content(chunk_size=1024 * 1024):
if chunk:
archive_file.write(chunk)
print("Архив сохранён: converted_archive.zip")
break
if status["status"] == "error":
print("Ошибка:", status.get("message", "Неизвестная ошибка"))
break
time.sleep(2)Пример запускает конвертацию, опрашивает status_url и скачивает ZIP-архив отдельным авторизованным запросом.
AIVIO_API_KEY, а не хранится в коде.urljoin корректно работает и с относительными, и с абсолютными ссылками из API.allow_redirects=False помогает увидеть неожиданный редирект вместо скачивания файла.import os
import time
from urllib.parse import urljoin
import requests
BASE_URL = "https://aivio.ru"
API_KEY = os.environ["AIVIO_API_KEY"]
headers = {
"Authorization": f"Api-Key {API_KEY}",
}
def make_url(path_or_url: str) -> str:
return urljoin(BASE_URL, path_or_url)
with open("vor.xlsx", "rb") as source_file:
start = requests.post(
make_url("/api/documents/convert/"),
headers=headers,
files={"file": source_file},
data={
"title": "ВОР по объекту",
"conversion_type": "work_amount_sheet",
},
timeout=60,
)
start.raise_for_status()
status_url = make_url(start.json()["status_url"])
while True:
status_response = requests.get(status_url, headers=headers, timeout=30)
status_response.raise_for_status()
status = status_response.json()
if status["status"] in {"ok", "completed"}:
download_url = make_url(status["download_url"])
archive_response = requests.get(
download_url,
headers=headers,
timeout=120,
stream=True,
allow_redirects=False,
)
archive_response.raise_for_status()
with open("vor_gge_archive.zip", "wb") as archive_file:
for chunk in archive_response.iter_content(chunk_size=1024 * 1024):
if chunk:
archive_file.write(chunk)
print("Архив ВОР сохранён: vor_gge_archive.zip")
break
if status["status"] in {"error", "failed"}:
print("Ошибка:", status.get("message", "Неизвестная ошибка"))
break
time.sleep(2)Для ВОР используется тот же маршрут конвертации, но обязательно передаётся conversion_type=work_amount_sheet.
vor.xlsx должен быть файлом ВОР из поддерживаемого XLSX-шаблона.title необязателен, но помогает найти результат в истории.download_url с тем же заголовком Authorization.import os
import time
from urllib.parse import urljoin
import requests
BASE_URL = "https://aivio.ru"
API_KEY = os.environ["AIVIO_API_KEY"]
headers = {
"Authorization": f"Api-Key {API_KEY}",
}
def make_url(path_or_url: str) -> str:
return urljoin(BASE_URL, path_or_url)
with open("template.docx", "rb") as template_file, open("data.xlsx", "rb") as data_file:
start = requests.post(
make_url("/api/documents/generate/"),
headers=headers,
files={
"template_file": template_file,
"data_file": data_file,
},
timeout=60,
)
start.raise_for_status()
status_url = make_url(start.json()["status_url"])
while True:
status_response = requests.get(status_url, headers=headers, timeout=30)
status_response.raise_for_status()
status = status_response.json()
if status["status"] == "ok":
download_url = make_url(status["download_url"])
archive_response = requests.get(
download_url,
headers=headers,
timeout=120,
stream=True,
allow_redirects=False,
)
archive_response.raise_for_status()
with open("generated_archive.zip", "wb") as archive_file:
for chunk in archive_response.iter_content(chunk_size=1024 * 1024):
if chunk:
archive_file.write(chunk)
print("Архив сохранён: generated_archive.zip")
break
if status["status"] == "error":
print("Ошибка:", status.get("message", "Неизвестная ошибка"))
break
time.sleep(2)Пример запускает генерацию документов, ждёт готового статуса и скачивает архив через API-ссылку с тем же ключом.
template_file — шаблон DOCX для генерации.data_file — Excel-файл с данными.download_url ведёт на /api/documents/generate/<archive_id>/download/.curl -X POST \
-H "Authorization: Api-Key ВАШ_API_КЛЮЧ" \
-F "file=@vor.xlsx" \
-F "title=ВОР по объекту" \
-F "conversion_type=work_amount_sheet" \
"https://aivio.ru/api/documents/convert/"conversion_type=market_analysis или не передавайте тип вовсе.conversion_id и status_url.curl -L \
-H "Authorization: Api-Key ВАШ_API_КЛЮЧ" \
-o result.zip \
"https://aivio.ru/api/documents/convert/4/download/"4 нужно заменить на реальный conversion_id.Authorization приходит 401 или 403, это нормально.200 и Content-Disposition: attachment, архив скачивается правильно.curl -L \
-H "Authorization: Api-Key ВАШ_API_КЛЮЧ" \
-o result.zip \
"https://aivio.ru/api/documents/generate/12/download/"12 нужно заменить на реальный archive_id.ok./api/documents/convert/<conversion_id>/download/.Типичные ошибки API
Ниже приведены самые типичные HTTP-статусы для интеграций. Они помогут быстрее настроить обработку ошибок на стороне CRM, бота или внутреннего сервиса.
| Код | Описание |
|---|---|
400 — неверный запрос |
Причина: файл не прошёл предварительную проверку, отсутствуют обязательные поля, нарушен формат загрузки или есть предупреждения без подтверждения продолжения. Решение: проверьте шаблон, Excel-файл и обязательные параметры запроса. Если API вернул списки errors или warnings, исправьте данные и повторите запрос. Если возвращены только предупреждения, отправьте запрос повторно с подтверждением force_warnings=true.
|
401 — ошибка аутентификации |
Причина: API-ключ отсутствует, передан с ошибкой, отозван или пользователь, связанный с ключом, недоступен. Решение: проверьте заголовок авторизации и убедитесь, что используете действующий API-ключ. При необходимости создайте новый ключ в личном кабинете. |
403 — доступ запрещён |
Причина: файл принадлежит другому пользователю или другому API-ключу, либо у пользователя исчерпан лимит API-вызовов по тарифу. Решение: проверьте, что скачиваете результат, созданный этим же пользователем/API-ключом. Если проблема в лимите, проверьте доступную квоту в аккаунте. |
404 — объект не найден |
Причина: указан неверный ID, файл ещё не создан, задача завершилась ошибкой или объект недоступен текущему пользователю. Решение: проверьте archive_id или conversion_id, дождитесь статуса ok и только потом скачивайте архив.
|
500 — ошибка сервера |
Причина: при запуске генерации или обработке запроса на стороне сервиса произошёл внутренний сбой. Решение: повторите запрос позже. Если проблема сохраняется, передайте в поддержку текст ошибки, пример запроса и request_id, если он был возвращён.
|
503 — сервис временно недоступен |
Причина: генерация документов временно отключена администратором или сервис находится в режиме ограничения доступа. Решение: подождите и повторите запрос позже. Если доступ не восстанавливается, уточните статус сервиса у поддержки. |
Это ожидаемо для защищённой API-ссылки. Браузер не передаёт заголовок Authorization, поэтому сервис может вернуть 401 или 403. Используйте Python, curl, Postman или другой API-клиент.
Если URL выглядит как https://aivio.ruhttps://aivio.ru/..., не склеивайте BASE_URL с download_url вручную. Используйте urllib.parse.urljoin, как в примере выше.
{
"archive_id": 12,
"status": "processing",
"request_id": "req-ab12cd34",
"task_id": "celery-task-id",
"status_url": "/api/documents/generate/12/status/"
}{
"archive_id": 12,
"status": "ok",
"download_url": "/api/documents/generate/12/download/"
}{
"detail": "Файлы не прошли предварительную проверку.",
"errors": [],
"warnings": ["Лишняя колонка extra"],
"can_force": true
}{
"detail": "Неверный API ключ."
}{
"detail": "Архив не найден."
}Сначала проверьте интеграцию на тестовом шаблоне и маленьком Excel-файле из 1-2 строк. Так проще убедиться, что внешний сервис правильно формирует запросы и обрабатывает ответы API.
Частые ошибки
Большинство проблем можно решить без помощи разработчика. Ниже собраны ошибки отдельно для генерации и для конвертации, чтобы было проще быстро найти свой сценарий.
Проверьте, что файл не поврежден, полностью сохранен и открывается на вашем компьютере. Для Excel поддерживаются .xlsx и .xls, а шаблон для генерации должен быть в формате .docx.
Скорее всего, в шаблоне не хватает нужных мест для подстановки данных, случайно удалены рабочие элементы или используется старая версия документа. Возьмите проверенный шаблон и протестируйте его на небольшой таблице.
Если используете генерацию по строкам, проверьте названия столбцов в первой строке. Если используете генерацию по столбцам, проверьте плейсхолдеры в первом столбце и названия документов в первой строке. Также проверьте пустые ячейки, формат дат и отсутствие объединенных ячеек.
Для конвертации сервис ищет структуру на 27 граф по актуальной форме 421/пр с изменениями 30/пр или legacy-структуры на 20/26 граф. Если номера граф удалены, заголовки сильно переименованы или таблица содержит другой набор колонок без поддерживаемого маппинга, обязательные колонки не будут распознаны.
Убедитесь, что оба файла загружены полностью. После отправки сервис может показать страницу проверки: если там есть ошибки, их нужно исправить; если есть только предупреждения, можно проверить их и продолжить запуск.
Проверьте, что вы загрузили Excel именно в раздел конвертации. Если сервис показывает экран проверки, посмотрите ошибки по структуре файла, обязательным колонкам и значениям статуса: в этой колонке допустимы только 1 или 2.
Проверьте, что файл загружен в раздел «Конвертация ВОР» и подготовлен по официальному XLSX-шаблону. Для ВОР важны шапка ведомости, блок исходных файлов, разделы, строки работ и ссылки на страницы исходных файлов.
Чаще всего это означает, что сервису не удалось найти нужные данные в таблице или связать их с шаблоном. Проверьте соответствие шаблона и Excel, затем выполните тест на 1-2 строках.
Проверьте интернет-соединение, попробуйте скачать файл повторно и убедитесь, что браузер не блокирует загрузку. Если скачанный файл не открывается, сначала проверьте исходные файлы, а затем повторите запуск.
Не запускайте одну и ту же задачу много раз подряд без проверки файлов. Гораздо быстрее открыть шаблон и Excel, найти неточность и повторить запуск уже на исправленной версии.
FAQ
Если вам нужен быстрый ответ без длинной инструкции, начните с этого раздела. Здесь собраны вопросы, которые чаще всего возникают у пользователей при первой работе с сервисом.
Нет. В обычном формате один Excel содержит много строк, и каждая строка соответствует отдельному документу. В формате по столбцам один Excel содержит много столбцов, и каждый столбец после первого соответствует отдельному документу. Для конвертации КА и ВОР используются другие, отдельные Excel-сценарии.
Нет. Aivio определяет режим автоматически. Если плейсхолдеры вида {{...}} находятся в первом столбце начиная со второй строки, будет использован режим по столбцам. В остальных случаях используется обычный режим по строкам.
Да, но для первой проверки лучше использовать небольшой тестовый набор. Так легче убедиться, что шаблон и таблица подготовлены правильно.
Да, сервис принимает .xls и .xlsx. Для стабильной работы лучше заранее пересохранить таблицу в .xlsx.
Нет. Шаблон документа нужен для генерации. Для конвертации КА в GGE используется только корректно подготовленный Excel-файл.
Нет. ВОР и КАЦ используют разные структуры и разные GGE-схемы. Для ведомости объемов работ используйте раздел «Конвертация ВОР», а для конъюнктурного анализа — «Конвертация КА».
На текущем этапе нужен официальный фиксированный XLSX-шаблон ВОР. Произвольные таблицы могут не содержать обязательных блоков и ссылок, поэтому сервис не сможет надежно собрать GGE-файл.
Фиксированной строки больше нет. Сервис автоматически ищет структуру таблицы по номерам граф 1..27 для актуальной формы или 1..20/1..26 для legacy-форм и ключевым заголовкам. Таблица может начинаться выше или ниже, если эти признаки сохранены.
Обычно причина в формате данных в Excel. Проверьте, одинаково ли записаны даты и числа во всей таблице.
Это штатный шаг. Сервис показывает ошибки и предупреждения до запуска обработки. Ошибки нужно исправить, а при предупреждениях можно проверить их и при необходимости продолжить.
Да. Если шаблон уже проверен и дает правильный результат, лучше сохранить его как рабочий образец и использовать повторно.
Если опция включена, сервис собирает один итоговый документ. Если выключена, он формирует отдельные документы и упаковывает их в ZIP-архив.
Да, это даже желательно. Для генерации по строкам оставьте в Excel 1-2 строки данных. Для генерации по столбцам оставьте 1-2 столбца документов после первого столбца с плейсхолдерами. Выполните тестовую генерацию и только потом запускайте полный пакет.
Не обязательно. Готовый результат сохраняется в сервисе и после завершения его можно скачать повторно со страницы результата или из списка документов. Для первого запуска просто удобнее дождаться завершения в текущей вкладке.
Возьмите шаблон, Excel-файл, скриншот ошибки и короткое описание шага, на котором возникла проблема. Это значительно ускорит разбор ситуации.
Полезные советы
Эти рекомендации особенно полезны, если вы регулярно запускаете генерацию документов и хотите тратить меньше времени на перепроверку исходных файлов.
Первые запуски лучше делать на нескольких строках Excel. Так вы быстрее поймете, все ли работает правильно, и не потратите время на повторную сборку большого пакета документов.
Если шаблон уже был успешно использован, сохраните его как рабочую версию. Это снижает риск случайно загрузить старый или неполный документ.
Когда в одной колонке все значения оформлены одинаково, сервису проще корректно собрать итоговый документ. Особенно это важно для дат, номеров и сумм.
Фамилии, адреса, названия компаний и большие суммы могут вести себя иначе, чем короткие примеры. Лучше заметить это в тесте, чем после полной генерации.
Ясные названия помогают не перепутать шаблон, Excel и итоговый архив. Особенно удобно, если в названии есть дата или версия.
Не откладывайте проверку до конца дня. После скачивания откройте несколько документов сразу, пока исходные файлы и контекст задачи еще под рукой.
Помощь
Если вы уже проверили шаблон, Excel и рекомендации выше, но задача все равно не выполняется корректно, лучше сразу обратиться в поддержку с подготовленной информацией.
Обращайтесь, если загрузка проходит, но результат не формируется; если ошибка повторяется даже после исправления файлов; или если итоговый документ системно отличается от ожидаемого результата.
Чем точнее вы опишете ситуацию, тем быстрее специалисты смогут воспроизвести проблему и подсказать решение. В большинстве случаев достаточно короткого описания и исходных файлов, с которыми возникла сложность.