> ## 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 Sheets виберіть **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](/ua/bulk/create-from-csv)**
>
> Завантажте файл і запустіть пакет.

> **[Огляд масового створення](/ua/bulk/overview)**
>
> Обмеження та принцип роботи масового створення.


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