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

> Como preparar o ficheiro 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 ficheiro CSV simples: uma linha de cabeçalho e, depois, uma linha por código QR com um nome e um URL de destino. Esta página lista as regras que o GetQR verifica quando o carrega.

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

Também pode transferir este ponto de partida na aplicação: no passo **Add links**, clique em **Download CSV template**.

## Regras

| Parte | Regra |
| - | - |
| Ficheiro | Tem de ser um ficheiro `.csv`. Não são aceites ficheiros Excel nem outros formatos. |
| Cabeçalho | A primeira linha tem de ser exatamente `name,url`: em minúsculas, por esta ordem, sem outras colunas. |
| Linhas | Até 100 linhas não vazias. As linhas vazias são ignoradas. |
| `name` | Obrigatório. Torna-se o nome do código QR. Até 40 caracteres; os nomes mais longos são cortados para 40. |
| `url` | Obrigatório. Um endereço web que comece por `http://` ou `https://`. |

### Regras de URL

* Se omitir o esquema, o GetQR adiciona `https://`. `example.com/menu` passa a `https://example.com/menu`.
* O endereço tem de incluir um domínio real com um ponto, como `example.com`.
* Sem espaços, tabulações nem quebras de linha.
* Só funcionam links web. `mailto:`, `ftp://`, `javascript:` e endereços de email simples são rejeitados.

### Nomes duplicados

Os nomes não têm de ser únicos. Se duas linhas tiverem o mesmo nome (ignorando 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"`. As aplicações de folhas de cálculo fazem isto automaticamente quando guardam em CSV.

## Criar o ficheiro numa folha de cálculo

**1. Configurar duas colunas**

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

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

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

**3. Guardar como CSV**

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

> [!TIP]
>
> Guardar em UTF-8 mantém intactas as letras acentuadas e outros caracteres não ingleses nos seus nomes.

## Erros de validação

### Erros de ficheiro

Estes erros bloqueiam o ficheiro inteiro. Corrija o ficheiro e carregue-o novamente.

| Mensagem | O que fazer |
| - | - |
| Choose a CSV file. Other file types are not supported. | Guarde o ficheiro 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 a mais ou se falta o cabeçalho. |
| Add at least one non-empty data row to the CSV. | O ficheiro tem cabeçalho, mas não tem linhas. Adicione pelo menos um nome e um link. |
| A CSV can contain at most 100 non-empty rows. | Divida a lista em ficheiros com até 100 linhas. |
| This CSV is malformed and could not be read. | Exporte novamente o ficheiro a partir da sua aplicação de folhas de cálculo. Procure aspas por fechar. |

### Erros de linha

Estes erros assinalam linhas individuais. Pode corrigi-las e carregar novamente o ficheiro, ou continuar apenas com as linhas válidas.

| Indicador 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, por isso a primeira linha de dados é a linha 2, tal como na sua folha de cálculo.

## Problemas comuns

> **O meu cabeçalho parece correto, mas continuo a receber o erro de cabeçalho**
>
> O cabeçalho tem de estar em minúsculas e conter apenas duas colunas. `Name,URL` ou `name,url,notes` falham. Verifique também se existem colunas vazias à direita de `url` na sua folha de cálculo.

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

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

## Próximos passos

> **[Criar códigos QR a partir de um CSV](/pt/bulk/create-from-csv)**
>
> Carregue o seu ficheiro e inicie o lote.

> **[Visão geral da criação em massa](/pt/bulk/overview)**
>
> Limites e funcionamento da criação em massa.


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