Central de ajuda

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.

Time Navify 3 min de leitura

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:

ColunaO que vai nela
idDeixe vazia para pontos novos. Vem preenchida na exportação, para atualizar um ponto
external_idO seu código para o ponto, como o do seu ERP. Opcional e único
name, category, statusNome, nome da categoria e published ou draft (padrão)
address_line1, street_number, address_line2, neighbourhood, city, region, postal_code, country_codeO endereço. País com código de duas letras, como BR
latitude, longitudeOpcionais. Sem elas, o endereço é localizado automaticamente
phone, whatsapp, email, site, instagram, booking_urlContatos
photo_urlLink público https de uma imagem (PNG, JPG, WEBP ou GIF, até 5 MB)
descriptionTexto simples
tagsNomes das tags separados por |
mon … sunUm 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.

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.