> ## 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.

# Format CSV

> Jak przygotować plik CSV do tworzenia masowego: wymagany nagłówek, wiersze, reguły URL i błędy walidacji.

Tworzenie masowe odczytuje prosty plik CSV: jeden wiersz nagłówka, a następnie jeden wiersz na każdy kod QR z nazwą i docelowym adresem URL. Na tej stronie wymieniono reguły, które GetQR sprawdza podczas przesyłania pliku.

## Przykładowy plik

```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
```

Ten plik startowy możesz też pobrać w aplikacji: w kroku **Add links** kliknij **Download CSV template**.

## Reguły

| Element | Reguła |
| - | - |
| Plik | Musi to być plik `.csv`. Pliki Excel i inne formaty nie są akceptowane. |
| Nagłówek | Pierwszy wiersz musi mieć dokładnie postać `name,url`: małymi literami, w tej kolejności, bez innych kolumn. |
| Wiersze | Maksymalnie 100 niepustych wierszy. Puste wiersze są ignorowane. |
| `name` | Wymagane. Staje się nazwą kodu QR. Maksymalnie 40 znaków; dłuższe nazwy są skracane do 40. |
| `url` | Wymagane. Adres internetowy zaczynający się od `http://` lub `https://`. |

### Format adresu URL

* Jeśli pominiesz schemat, GetQR doda `https://`. `example.com/menu` staje się `https://example.com/menu`.
* Adres musi zawierać prawdziwą domenę z kropką, np. `example.com`.
* Bez spacji, tabulatorów i podziałów wierszy.
* Działają tylko linki internetowe. `mailto:`, `ftp://`, `javascript:` i zwykłe adresy e-mail są odrzucane.

### Powtarzające się nazwy

Nazwy nie muszą być unikalne. Jeśli dwa wiersze mają tę samą nazwę (bez względu na wielkość liter), GetQR numeruje powtórzenia: `Menu`, `Menu 2`, `Menu 3`.

### Przecinki i cudzysłowy

Jeśli nazwa zawiera przecinek, ujmij ją w cudzysłów podwójny, np. `"Downtown, Main St"`. Arkusze kalkulacyjne robią to automatycznie podczas zapisywania w formacie CSV.

## Utwórz plik w arkuszu kalkulacyjnym

**1. Przygotuj dwie kolumny**

W pierwszym wierszu wpisz `name` w kolumnie A i `url` w kolumnie B.

**2. Dodaj jeden wiersz na każdy kod**

W każdym wierszu wpisz nazwę i link, maksymalnie 100 wierszy.

**3. Zapisz jako CSV**

Wyeksportuj lub zapisz arkusz jako CSV. W programie Excel wybierz **CSV UTF-8**. W Arkuszach Google wybierz **File > Download > Comma-separated values**.

> [!TIP]
>
> Zapisywanie w kodowaniu UTF-8 zachowuje w nazwach polskie znaki diakrytyczne i inne znaki spoza alfabetu angielskiego.

## Błędy walidacji

### Błędy pliku

Te błędy blokują cały plik. Popraw plik i prześlij go ponownie.

| Komunikat | Co zrobić |
| - | - |
| Choose a CSV file. Other file types are not supported. | Zapisz plik jako `.csv`, a nie `.xlsx` lub `.numbers`. |
| The CSV header must be exactly name,url in that order. | Pierwszy wiersz musi mieć dokładnie postać `name,url`. Sprawdź, czy nie ma wielkich liter, dodatkowych kolumn lub czy nie brakuje nagłówka. |
| Add at least one non-empty data row to the CSV. | Plik ma nagłówek, ale nie ma wierszy. Dodaj co najmniej jedną nazwę i link. |
| A CSV can contain at most 100 non-empty rows. | Podziel listę na pliki zawierające maksymalnie 100 wierszy. |
| This CSV is malformed and could not be read. | Ponownie wyeksportuj plik z arkusza kalkulacyjnego. Sprawdź, czy nie ma niezamkniętych cudzysłowów. |

### Błędy wierszy

Te błędy oznaczają pojedyncze wiersze. Możesz je poprawić i przesłać plik ponownie lub kontynuować tylko z prawidłowymi wierszami.

| Oznaczenie lub komunikat | Przyczyna |
| - | - |
| **MISSING** / Name is required | Komórka `name` jest pusta. |
| **MISSING** / URL is required | Komórka `url` jest pusta. |
| **INVALID** / Enter a valid HTTP(S) URL | Link narusza jedną z [reguł dotyczących formatu adresu URL](#format-adresu-url). |

Numeracja wierszy liczy nagłówek jako wiersz 1, więc pierwszy wiersz danych to wiersz 2 — tak samo jak w arkuszu kalkulacyjnym.

## Typowe problemy

> **Mój nagłówek wygląda poprawnie, ale nadal pojawia się błąd nagłówka**
>
> Nagłówek musi być napisany małymi literami i zawierać tylko dwie kolumny. `Name,URL` lub `name,url,notes` nie przejdą walidacji. Sprawdź też, czy w arkuszu nie ma pustych kolumn po prawej stronie kolumny `url`.

> **Link, który działa w przeglądarce, jest oznaczony jako INVALID**
>
> Link może zawierać spację lub używać schematu innego niż http lub https. Zakoduj spacje jako `%20` lub je usuń i użyj pełnego adresu internetowego.

> **Niektóre nazwy zostały skrócone**
>
> Nazwy dłuższe niż 40 znaków są skracane do 40. Skróć je w pliku, jeśli chcesz samodzielnie wybrać brzmienie.

## Co dalej

> **[Utwórz kody QR z pliku CSV](/pl/bulk/create-from-csv)**
>
> Prześlij plik i rozpocznij partię.

> **[Przegląd tworzenia masowego](/pl/bulk/overview)**
>
> Limity i sposób działania tworzenia masowego.


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