> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hypesquad.store/llms.txt
> Use this file to discover all available pages before exploring further.

# Importar produtos por planilha

> Aprenda a importar produtos em massa para a Hyper usando uma planilha e a migrar catálogo de outras plataformas.

Esta página é para lojistas que querem adicionar muitos produtos de uma só vez na Hyper, seja começando do zero ou trazendo o catálogo de outra plataforma. Você vai aprender como funciona a importação por planilha e o processo de migração.

## O que é a importação por planilha

A importação por planilha é uma forma de cadastrar vários produtos ao mesmo tempo, sem precisar adicionar um por um na tela. Você organiza os dados em uma planilha, envia para a Hyper e o sistema cria ou atualiza os produtos automaticamente. A Hyper também oferece migração de catálogo, clientes e histórico de pedidos a partir de uma planilha ou exportação da maioria das plataformas de e-commerce.

## Para que serve

A importação é útil quando:

* Você já tem uma lista de produtos em outro sistema
* Quer começar a loja com dezenas ou centenas de itens de uma vez
* Está mudando de outra plataforma para a Hyper
* Precisa atualizar preços ou estoques em massa

## Como fazer

### Importar produtos por planilha

<Steps>
  <Step title="Acesse a área de importação">
    No painel da sua loja, procure por importar produtos, catálogo em massa ou similar. Os nomes exatos das opções podem variar conforme a versão do painel e o plano contratado.
  </Step>

  <Step title="Baixe o modelo disponível">
    A Hyper fornece um modelo de planilha com as colunas corretas. Use sempre esse modelo para evitar erros de formatação.
  </Step>

  <Step title="Preencha os dados">
    Abra o modelo em um editor de planilhas, como Excel, Google Planilhas ou LibreOffice. Preencha as colunas conforme as instruções exibidas no painel. Geralmente incluem nome, descrição, preço, imagem, disponibilidade e opções.
  </Step>

  <Step title="Revise antes de enviar">
    Confira se não há linhas em branco, preços com vírgula em vez de ponto ou textos fora do lugar. Pequenos erros de formatação podem impedir a importação.
  </Step>

  <Step title="Envie a planilha">
    Faça o upload do arquivo no painel e aguarde o processamento. O tempo varia conforme a quantidade de produtos.
  </Step>

  <Step title="Verifique o resultado">
    Depois da importação, confira se os produtos apareceram corretamente na vitrine. Abra alguns itens para verificar nome, preço e imagem.
  </Step>
</Steps>

<Note>
  Os nomes exatos das opções no painel podem variar conforme a versão da plataforma e o plano contratado. Sempre use o modelo e as instruções exibidos no painel para garantir que as colunas estejam corretas.
</Note>

<Warning>
  Não invente colunas ou mude a ordem do modelo fornecido. Planilhas fora do padrão podem ser rejeitadas ou importar dados de forma incorreta.
</Warning>

### Migrar de outra plataforma

<Steps>
  <Step title="Exporte os dados da plataforma antiga">
    Na plataforma de origem, procure por exportar catálogo, produtos ou backup. Salve o arquivo no formato compatível, geralmente CSV ou Excel.
  </Step>

  <Step title="Ajuste para o modelo da Hyper">
    Compare as colunas da exportação com o modelo da Hyper. Renomeie ou reorganize para que os dados caiam nos campos certos.
  </Step>

  <Step title="Importe pela mesma ferramenta">
    Siga os mesmos passos da importação por planilha descritos acima.
  </Step>

  <Step title="Valide tudo na vitrine">
    Confira preços, imagens, descrições e opções. Ajuste manualmente o que não ficou perfeito.
  </Step>
</Steps>

<Tip>
  Se você tem muitos produtos ou dados complexos, considere fazer a importação em partes. Comece com uma dezena de produtos para testar, depois envie o restante.
</Tip>

## O que acontece depois

Depois da importação, os produtos aparecem no catálogo da sua loja. Você pode editar um a um depois, criar coleções, ajustar preços e organizar a vitrine. Se algo saiu errado, é possível corrigir individualmente ou refazer a importação, dependendo da funcionalidade disponível no seu plano.

## Problemas comuns

<AccordionGroup>
  <Accordion title="A planilha foi rejeitada">
    Verifique se você usou o modelo fornecido pelo painel. Confira se não há colunas extras, linhas em branco no meio do arquivo ou caracteres especiais que possam quebrar a leitura.
  </Accordion>

  <Accordion title="Os preços apareceram errados">
    Use ponto como separador decimal, não vírgula. Por exemplo: 29.90 em vez de 29,90. Verifique também se não há espaços antes ou depois dos números.
  </Accordion>

  <Accordion title="As imagens não carregaram">
    A importação pode exigir URLs de imagem hospedadas na internet, não arquivos locais. Verifique se os links estão acessíveis e começam com https\://.
  </Accordion>

  <Accordion title="Alguns produtos sumiram ou ficaram duplicados">
    Verifique se há códigos de identificação únicos na planilha. Produtos sem identificador podem ser criados como novos em vez de atualizados.
  </Accordion>

  <Accordion title="A importação demorou muito">
    Planilhas com centenas de linhas e muitas imagens podem levar alguns minutos. Aguarde a mensagem de conclusão no painel antes de tentar enviar de novo.
  </Accordion>
</AccordionGroup>

## Quando pedir ajuda

Se a importação falhar mesmo depois de revisar a planilha, ou se você não conseguir encontrar a ferramenta no painel, fale pelo [chat do painel](/suporte/canais-de-atendimento) ou pela [Central de ajuda](https://hypesquad.store/ajuda). Anexe a planilha que você tentou enviar e descreva o erro que apareceu.

<CardGroup cols={2}>
  <Card title="Cadastrar produtos" icon="box" href="/produtos/cadastrar-produto">
    Aprenda a adicionar produtos um a um, com dicas de descrição e imagem.
  </Card>

  <Card title="Organizar e editar" icon="tags" href="/produtos/organizar-e-editar">
    Veja como criar coleções e gerenciar produtos depois da importação.
  </Card>

  <Card title="Produtos digitais" icon="file-arrow-down" href="/produtos/produtos-digitais">
    Saiba como configurar a entrega automática de arquivos digitais.
  </Card>

  <Card title="Canais de atendimento" icon="life-ring" href="/suporte/canais-de-atendimento">
    Encontre o canal certo para tirar dúvidas sobre importação.
  </Card>
</CardGroup>


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