# Importar pontos por planilha

> Cadastre ou atualize até 1.000 pontos de uma vez com um arquivo CSV: o modelo, as regras de cada coluna e como funcionam as atualizações.

Source: https://navify.tech/pt-br/central-de-ajuda/importar-pontos-por-planilha/
Date: 2026-11-04 · Pontos

---

Com uma planilha você cadastra muitos pontos de uma vez, ou atualiza os que já tem. Tudo acontece na tela **Importar e exportar**.

## 1. Prepare categorias e tags

Categorias e tags do arquivo precisam **já existir** no app, com o mesmo nome. Crie antes em **Categorias e tags**. A importação nunca cria categoria, então um erro de digitação não enche sua loja de categorias soltas.

## 2. Baixe o modelo

Use **Baixar modelo**. É um CSV só com os cabeçalhos das colunas:

| Coluna | O que vai nela |
|---|---|
| `id` | Deixe vazia para pontos novos. Vem preenchida na exportação, para atualizar um ponto |
| `external_id` | O seu código para o ponto, como o do seu ERP. Opcional e único |
| `name`, `category`, `status` | Nome, nome da categoria e `published` ou `draft` (padrão) |
| `address_line1`, `street_number`, `address_line2`, `neighbourhood`, `city`, `region`, `postal_code`, `country_code` | O endereço. País com código de duas letras, como `BR` |
| `latitude`, `longitude` | Opcionais. Sem elas, o endereço é localizado automaticamente |
| `phone`, `whatsapp`, `email`, `site`, `instagram`, `booking_url` | Contatos |
| `photo_url` | Link público `https` de uma imagem (PNG, JPG, WEBP ou GIF, até 5 MB) |
| `description` | Texto simples |
| `tags` | Nomes das tags separados por `\|` |
| `mon` … `sun` | Um período como `09:00-18:00`, ou `closed` |

Os cabeçalhos ficam em inglês em todos os idiomas, para o mesmo arquivo servir em qualquer admin.

## 3. Entenda como funcionam as atualizações

- Linha com `id` atualiza aquele ponto. Linha só com `external_id` atualiza o ponto com esse código, ou cria.
- Qualquer outra linha cria um ponto novo.
- **Célula vazia mantém o valor salvo.**
- A célula `tags` substitui a lista inteira de tags do ponto.
- **Pontos que não estão no arquivo nunca são apagados.**
- Pontos novos ficam como rascunho, a não ser que o `status` diga `published`.

## 4. Envie o arquivo

Escolha ou arraste o arquivo e envie. O limite é **1.000 linhas e 5 MB** por arquivo, e roda uma importação por vez em cada loja. Arquivos separados por vírgula ou ponto e vírgula funcionam.

O resultado aparece no histórico: pontos criados, atualizados e linhas com erro. Use **Ver erros** para achar a linha e o motivo. Uma linha com problema é pulada; as outras são salvas.

## 5. Espere a localização

Pontos sem coordenadas são localizados em segundo plano, cerca de um por segundo, então 1.000 pontos levam pelo menos 17 minutos. Depois confira na lista de **Pontos de venda** os que ficaram com localização aproximada, como em [Corrigir a localização de um ponto](https://navify.tech/pt-br/central-de-ajuda/corrigir-localizacao-do-ponto/).

## Exporte antes

Antes de uma atualização grande, exporte seus pontos em **Importar e exportar**. A exportação usa as mesmas colunas, então dá para editar e importar de volta. Importar de novo uma exportação sem mudanças não altera nada.