> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getqr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Формат CSV

> Как подготовить CSV-файл для массового создания: обязательный заголовок, строки, правила для URL и ошибки проверки.

Для массового создания используется простой CSV-файл: одна строка заголовка, а затем по одной строке на каждый QR-код с названием и целевым URL. На этой странице перечислены правила, которые GetQR проверяет при загрузке файла.

## Пример файла

```csv bulk-qr-template.csv theme={null}
name,url
Spring Menu,https://getqr.com/spring
Store #14,https://getqr.com/store-14
Table 7,example.com/menu?table=7
"Downtown, Main St",https://example.com/stores/downtown
```

Этот образец можно скачать и в приложении: на шаге **Add links** нажмите **Download CSV template**.

## Правила

| Элемент | Правило |
| - | - |
| Файл | Должен быть файлом `.csv`. Файлы Excel и другие форматы не принимаются. |
| Заголовок | Первая строка должна быть ровно `name,url`: строчными буквами, в этом порядке, без других столбцов. |
| Строки | До 100 непустых строк. Пустые строки игнорируются. |
| `name` | Обязательно. Становится названием QR-кода. До 40 символов; более длинные названия обрезаются до 40. |
| `url` | Обязательно. Веб-адрес, начинающийся с `http://` или `https://`. |

### Правила для URL

* Если схема не указана, GetQR добавляет `https://`. `example.com/menu` превращается в `https://example.com/menu`.
* Адрес должен содержать настоящий домен с точкой, например `example.com`.
* Без пробелов, табуляций и переносов строк.
* Работают только веб-ссылки. `mailto:`, `ftp://`, `javascript:` и обычные адреса электронной почты отклоняются.

### Повторяющиеся названия

Названия не обязательно должны быть уникальными. Если у двух строк одинаковое название (без учёта регистра), GetQR нумерует повторы: `Menu`, `Menu 2`, `Menu 3`.

### Запятые и кавычки

Если название содержит запятую, заключите его в двойные кавычки, например `"Downtown, Main St"`. Программы для работы с таблицами делают это автоматически при сохранении в CSV.

## Создание файла в таблице

**1. Создайте два столбца**

В первой строке введите `name` в столбце A и `url` в столбце B.

**2. Добавьте по строке на каждый код**

Заполните название и ссылку в каждой строке, всего до 100 строк.

**3. Сохраните в CSV**

Экспортируйте или сохраните лист в формате CSV. В Excel выберите **CSV UTF-8**. В Google Таблицах выберите **File > Download > Comma-separated values**.

> [!TIP]
>
> Сохранение в UTF-8 гарантирует, что буквы с диакритикой и другие неанглийские символы, в том числе кириллица, в названиях не исказятся.

## Ошибки проверки

### Ошибки файла

Такие ошибки блокируют весь файл. Исправьте файл и загрузите его снова.

| Сообщение | Что делать |
| - | - |
| Choose a CSV file. Other file types are not supported. | Сохраните файл в формате `.csv`, а не `.xlsx` или `.numbers`. |
| The CSV header must be exactly name,url in that order. | Первая строка должна быть ровно `name,url`. Проверьте, нет ли заглавных букв, лишних столбцов или отсутствующего заголовка. |
| Add at least one non-empty data row to the CSV. | В файле есть заголовок, но нет строк. Добавьте хотя бы одно название и ссылку. |
| A CSV can contain at most 100 non-empty rows. | Разделите список на файлы не более чем по 100 строк. |
| This CSV is malformed and could not be read. | Повторно экспортируйте файл из программы для работы с таблицами. Проверьте, нет ли незакрытых кавычек. |

### Ошибки строк

Такие ошибки помечают отдельные строки. Можно исправить их и загрузить файл повторно или продолжить только с корректными строками.

| Метка или сообщение | Причина |
| - | - |
| **MISSING** / Name is required | Ячейка `name` пуста. |
| **MISSING** / URL is required | Ячейка `url` пуста. |
| **INVALID** / Enter a valid HTTP(S) URL | Ссылка нарушает одно из [правил для URL](#url-rules). |

При нумерации строк заголовок считается строкой 1, поэтому первая строка данных — строка 2, как и в вашей таблице.

## Частые проблемы

> **Заголовок выглядит правильно, но ошибка заголовка всё равно появляется**
>
> Заголовок должен быть написан строчными буквами и содержать только два столбца. `Name,URL` или `name,url,notes` не подойдут. Также проверьте, нет ли в таблице пустых столбцов справа от `url`.

> **Ссылка, которая работает в браузере, помечена как INVALID**
>
> Возможно, ссылка содержит пробел или использует схему, отличную от http или https. Замените пробелы на `%20` или удалите их и используйте полный веб-адрес.

> **Некоторые названия сократились**
>
> Названия длиннее 40 символов обрезаются до 40. Если хотите сами выбрать формулировку, сократите их в файле.

## Что дальше

> **[Создание QR-кодов из CSV](/ru/bulk/create-from-csv)**
>
> Загрузите файл и запустите пакет.

> **[Обзор массового создания](/ru/bulk/overview)**
>
> Ограничения и принцип работы массового создания.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.