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

# Formato do CSV

> Como preparar o arquivo CSV para a criação em massa: cabeçalho obrigatório, linhas, regras de URL e erros de validação.

A criação em massa lê um arquivo CSV simples: uma linha de cabeçalho e, depois, uma linha por QR code com um nome e uma URL de destino. Esta página lista as regras que o GetQR verifica quando você envia o arquivo.

## Arquivo de exemplo

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

Você também pode baixar esse ponto de partida no app: na etapa **Add links**, clique em **Download CSV template**.

## Regras

| Parte | Regra |
| - | - |
| Arquivo | Deve ser um arquivo `.csv`. Arquivos do Excel e outros formatos não são aceitos. |
| Cabeçalho | A primeira linha deve ser exatamente `name,url`: em minúsculas, nessa ordem, sem outras colunas. |
| Linhas | Até 100 linhas não vazias. Linhas vazias são ignoradas. |
| `name` | Obrigatório. Torna-se o nome do QR code. Até 40 caracteres; nomes mais longos são cortados em 40. |
| `url` | Obrigatório. Um endereço da web que comece com `http://` ou `https://`. |

### Regras de URL

* Se você omitir o protocolo, o GetQR adiciona `https://`. `example.com/menu` se torna `https://example.com/menu`.
* O endereço deve incluir um domínio real com ponto, como `example.com`.
* Sem espaços, tabulações ou quebras de linha.
* Apenas links da web funcionam. `mailto:`, `ftp://`, `javascript:` e endereços de e-mail simples são rejeitados.

### Nomes duplicados

Os nomes não precisam ser únicos. Se duas linhas tiverem o mesmo nome (sem diferenciar maiúsculas e minúsculas), o GetQR numera as repetições: `Menu`, `Menu 2`, `Menu 3`.

### Vírgulas e aspas

Se um nome contiver uma vírgula, coloque-o entre aspas duplas, como em `"Downtown, Main St"`. Os apps de planilha fazem isso automaticamente ao salvar como CSV.

## Criar o arquivo em uma planilha

**1. Configure duas colunas**

Na primeira linha, digite `name` na coluna A e `url` na coluna B.

**2. Adicione uma linha por código**

Preencha um nome e um link em cada linha, até 100 linhas.

**3. Salve como CSV**

Exporte ou salve a planilha como CSV. No Excel, escolha **CSV UTF-8**. No Google Sheets, escolha **File > Download > Comma-separated values**.

> [!TIP]
>
> Salvar em UTF-8 mantém intactos os acentos e outros caracteres especiais nos seus nomes.

## Erros de validação

### Erros de arquivo

Esses erros bloqueiam o arquivo inteiro. Corrija o arquivo e envie-o novamente.

| Mensagem | O que fazer |
| - | - |
| Choose a CSV file. Other file types are not supported. | Salve o arquivo como `.csv`, não como `.xlsx` ou `.numbers`. |
| The CSV header must be exactly name,url in that order. | Faça com que a primeira linha seja exatamente `name,url`. Verifique se há letras maiúsculas, colunas extras ou cabeçalho ausente. |
| Add at least one non-empty data row to the CSV. | O arquivo tem cabeçalho, mas nenhuma linha. Adicione pelo menos um nome e um link. |
| A CSV can contain at most 100 non-empty rows. | Divida a lista em arquivos de até 100 linhas. |
| This CSV is malformed and could not be read. | Exporte o arquivo novamente do seu app de planilha. Procure aspas não fechadas. |

### Erros de linha

Esses erros marcam linhas individuais. Você pode corrigi-las e enviar o arquivo de novo, ou continuar apenas com as linhas válidas.

| Selo ou mensagem | Causa |
| - | - |
| **MISSING** / Name is required | A célula `name` está vazia. |
| **MISSING** / URL is required | A célula `url` está vazia. |
| **INVALID** / Enter a valid HTTP(S) URL | O link viola uma das [regras de URL](#regras-de-url). |

A numeração das linhas conta o cabeçalho como linha 1, então a primeira linha de dados é a linha 2, igual à sua planilha.

## Problemas comuns

> **Meu cabeçalho parece correto, mas ainda recebo o erro de cabeçalho**
>
> O cabeçalho deve estar em minúsculas e conter apenas duas colunas. `Name,URL` ou `name,url,notes` não funcionam. Verifique também se há colunas vazias à direita de `url` na sua planilha.

> **Um link que funciona no meu navegador está marcado como INVALID**
>
> O link pode conter um espaço ou usar um protocolo diferente de http ou https. Codifique os espaços como `%20` ou remova-os e use um endereço da web completo.

> **Alguns nomes foram encurtados**
>
> Nomes com mais de 40 caracteres são cortados em 40. Encurte-os no arquivo se quiser escolher o texto.

## Próximos passos

> **[Criar QR codes a partir de um CSV](/pt-br/bulk/create-from-csv)**
>
> Envie seu arquivo e inicie o lote.

> **[Visão geral da criação em massa](/pt-br/bulk/overview)**
>
> Limites e como a criação em massa funciona.


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