Importação e Exportação
O MeuCardapio.ai permite importar produtos em massa a partir de arquivos CSV e exportar dados de produtos, contatos e vendas para análise em planilhas. Isso agiliza a montagem do cardápio e facilita relatórios fora da plataforma.
O que pode ser importado
| Tipo | Formato | Descrição |
|---|---|---|
| Produtos | CSV | Cadastro em massa de produtos com nome, preço, categoria, descricão, código PDV, imagem e adicionais |
| Precos de produtos | CSV | Atualização em massa de precos por código PDV |
| Cardápio do iFood | Automático | Importação direta do cardápio publicado no iFood |
| Cardápio do Anota Ai | Automático | Importação do cardápio via link do Anota Ai |
| Cardápio do Olaclick | Automático | Importação assistida por IA do cardápio do Olaclick |
| Cardápio Web | Automático | Importação assistida por IA a partir de URL de cardápio web |
O que pode ser exportado
| Tipo | Formato | Descrição |
|---|---|---|
| Produtos | CSV | Lista completa com id, nome, preço, categoria, código PDV, descricão e link da imagem |
| Contatos | CSV | Base de clientes com nome, telefone, e-mail, data de nascimento, ultima visita e dados de fidelidade |
| Vendas por produto | CSV | Detalhamento de vendas por produto com dados do pedido, cliente e endereço |
| Vendas por cupom | CSV | Relatório de utilização de cupons com quantidade e faturamento |
| Vendas por promoção | CSV | Relatório de promoções utilizadas com quantidade e faturamento |
Importando produtos via CSV
Passo 1: Prepare o arquivo CSV
Crie um arquivo CSV (separado por vírgula ou ponto e vírgula) com os dados dos produtos. A primeira linha deve conter os cabeçalhos.
O arquivo deve ter a extensão .csv. Outros formatos (Excel .xlsx, .xls) não são aceitos diretamente. Exporte o arquivo do Excel como CSV antes de importar.
Passo 2: Acesse a tela de importação
No menu lateral, acesse Produtos > Importar Produtos ou clique no botão Importar na tela de produtos.
Passo 3: Selecione a origem
Escolha Arquivo CSV como origem da importação.
Passo 4: Envie o arquivo
Arraste o arquivo CSV ou clique para selecionar no computador.
Passo 5: Mapeie as colunas
O sistema exibirá as colunas encontradas no CSV. Associe cada coluna ao campo correspondente:
| Campo do sistema | Descrição | Obrigatório |
|---|---|---|
| Nome | Nome do produto | Sim |
| Preço | Valor unitário | Sim |
| Categoria | Categoria do produto (se não existir, será criada automáticamente) | Não |
| Descrição | Descricão detalhada do produto | Não |
| CódigoPDV | Código de referência para integrações com PDV | Não |
| LinkImagem | URL da imagem do produto (será baixada automáticamente) | Não |
| NomeAdicional | Nome do grupo de adicionais (ex: "Extras") | Não |
| OpçãoAdicional | Nome da opção dentro do grupo de adicionais | Não |
Selecione também o separador decimal utilizado no campo de preço:
| Separador | Exemplo |
|---|---|
| Ponto (.) | 29.90 |
| Vírgula (,) | 29,90 |
Passo 6: Revise e confirme
O sistema exibirá um resumo dos produtos que serão importados. Revise os dados e clique em Importar.
Estrutura do arquivo CSV
CSV básico (produtos simples)
Nome;Preço;Categoria;Descrição;CódigoPDV;LinkImagem
X-Burger;25.90;Lanches;Pão, hambúrguer, queijo e salada;001;https://exemplo.com/xburger.jpg
X-Salada;22.90;Lanches;Pão, hambúrguer, queijo, alface e tomate;002;https://exemplo.com/xsalada.jpg
Coca-Cola 350ml;7.00;Bebidas;Refrigerante lata 350ml;010;https://exemplo.com/coca.jpg
Açaí 300ml;18.90;Sobremesas;Açaí com granola e banana;020;https://exemplo.com/acai.jpg
CSV com adicionais
Para incluir adicionais, adicione linhas extras abaixo do produto. Deixe o campo Nome vazio e preencha NomeAdicional e OpçãoAdicional:
Nome;Preço;Categoria;Descrição;CódigoPDV;LinkImagem;NomeAdicional;OpçãoAdicional
X-Burger;25.90;Lanches;Pão, hambúrguer, queijo e salada;001;;;
;5.00;;;;;Extras;Bacon extra
;3.00;;;;;Extras;Queijo cheddar
;2.00;;;;;Extras;Ovo
X-Salada;22.90;Lanches;Pão, hambúrguer, alface e tomate;002;;;
;4.00;;;;;Adicionais;Bacon
;3.50;;;;;Adicionais;Cheddar
- Cada linha com o campo Nome preenchido cria um novo produto.
- Linhas sem Nome mas com NomeAdicional e OpçãoAdicional adicionam opções de adicionais ao último produto criado.
- Se o NomeAdicional mudar, um novo grupo de adicionais é criado automáticamente.
CSV para atualização de preços
Para atualizar apenas os preços de produtos existentes, use um CSV com três colunas:
Nome;Preço;CódigoPDV
X-Burger;27.90;001
X-Salada;24.90;002
Coca-Cola 350ml;8.00;010
Na atualização de preços, o campo CódigoPDV é obrigatório. O sistema localiza o produto pelo código PDV para aplicar o novo preço.
Importando do iFood
O MeuCardapio.ai importa produtos diretamente do iFood de duas formas:
Via API Oficial do iFood
- Acesse Produtos > Importar > iFood Oficial
- Selecione a loja vinculada ao iFood
- Escolha o catálogo a importar
- O sistema listará os produtos encontrados separados em:
- Novos produtos - Produtos que não existem no seu cardápio
- Produtos para atualizar - Produtos existentes com diferenças de preço ou imagem
- Selecione os produtos desejados e clique em Importar
Via link do iFood
- Acesse Produtos > Importar > iFood (por link)
- Cole o link do seu restaurante no iFood (ex:
https://www.ifood.com.br/delivery/cidade/restaurante) - O sistema fará a leitura automática do cardápio
A importação do iFood traz produtos, categorias, preços, imagens e adicionais automáticamente. Após importar, revise os dados e ajuste o que for necessário.
Exportando dados
Exportar produtos
- Acesse Produtos
- Aplique filtros se desejar exportar apenas parte do catálogo
- Clique no botão Exportar CSV
O arquivo CSV gerado conterá:
| Coluna | Descrição |
|---|---|
| id | Identificador único do produto |
| ordem | Posição do produto na listagem |
| nome | Nome do produto |
| valor unitário | Preço do produto (para produtos com tamanhos, uma linha por tamanho) |
| categoria id | Identificador da categoria |
| categoria nome | Nome da categoria |
| descrição | Descricão do produto |
| tamanho | Tamanho do produto (quando aplicavel) |
| unidade medida | UND (unidade) ou sigla da unidade de peso |
| código pdv | Código de referência PDV |
| link imagem | URL da imagem do produto |
Exportar contatos
- Acesse CRM > Contatos
- Aplique filtros se desejar (nome, telefone, status)
- Clique em Exportar CSV
O arquivo CSV gerado conterá:
| Coluna | Descrição |
|---|---|
| id | Identificador único do contato |
| nome | Nome do cliente |
| telefone | Número de telefone |
| Endereço de e-mail | |
| dataNascimento | Data de nascimento (DD/MM/AAAA) |
| ultimaVisita | Data da ultima compra (DD/MM/AAAA) |
| sexo | Genero do contato |
| status | Status do contato (ativo/inativo) |
| plano / pontos | Dados de fidelidade: plano, pontos acumulados, resgatados e visitas |
Exportar vendas por produto
- Acesse Financeiro > Relatório de Vendas
- Defina o período desejado
- Clique em Exportar CSV
O arquivo CSV gerado conterá:
| Coluna | Descrição |
|---|---|
| Pedido | Número do pedido |
| Data | Data do pedido (DD/MM/AAAA) |
| Mes | Mes do pedido |
| Cliente | Nome do cliente |
| Telefone | Telefone do cliente |
| Bairro | Bairro de entrega |
| Logradouro | Rua de entrega |
| Número | Número do endereço |
| Complemento | Complemento do endereço |
| Produto | Nome do produto |
| Qtde | Quantidade vendida |
| Total | Valor total do item |
| Forma De Pagamento | Meio de pagamento utilizado |
| Data Fechamento | Data de fechamento do pedido |
| Mes Fechamento | Mes de fechamento |
| Status | Status final do pedido |
| Pago | Sim ou Não |
Exportar vendas por cupom
- Acesse Financeiro > Relatório de Vendas
- Defina o período e selecione a aba Cupons
- Clique em Exportar CSV
| Coluna | Descrição |
|---|---|
| CódigoLoja | Identificador da loja |
| NomeLoja | Nome da loja |
| Cupom | Código do cupom utilizado |
| Qtde | Quantidade de vezes que o cupom foi utilizado |
| Faturamento | Valor total gerado com o cupom |
Erros comuns na importação
"Linha X inválida, não tem preço definido"
A linha indicada do CSV não possui valor no campo de preço. Verifique:
- Se a coluna de preço foi mapeada corretamente
- Se o valor não está vazio ou com caracteres inválidos
- Se o separador decimal está correto (ponto ou vírgula)
"Linha X inválida, não tem código PDV definido"
Ao importar preços (modo atualização), cada linha precisa ter o código PDV. Preencha o campo CódigoPDV em todas as linhas.
"Não temos suporte a arquivos do tipo xlsx"
O sistema aceita apenas arquivos .csv. Abra o arquivo no Excel, vá em Salvar como e escolha CSV (separado por vírgula) ou CSV (separado por ponto e vírgula).
"Diretório upload de arquivo CSV não existe"
Erro interno do servidor. Entre em contato com o suporte técnico.
"Houve um erro ao baixar as imagens"
Uma ou mais URLs de imagem no campo LinkImagem estão inválidas ou inacessíveis. Verifique:
- Se as URLs começam com
http://ouhttps:// - Se as imagens estão acessíveis publicamente
- Se os links não estão quebrados
Produtos importados sem categoria
Quando o campo Categoria não é informado no CSV, todos os produtos são criados na categoria padrão "IMPORTADOS". Após a importação, mova os produtos para as categorias desejadas na tela de Produtos.
Caracteres especiais aparecem errados
O arquivo CSV deve estar codificado em UTF-8. No Excel, ao salvar como CSV, selecione CSV UTF-8 como formato.
Boas práticas
- Faça backup antes: Exporte os produtos atuais antes de importar novos, para ter uma cópia de segurança
- Comece pequeno: Teste a importação com 5 a 10 produtos antes de importar o catálogo completo
- Revise os preços: Confirme que o separador decimal está correto para evitar precos errados
- Use imagens validas: Prefira URLs de imagens hospedadas em servidores confiáveis (ex: Google Drive, Imgur)
- Preencha o código PDV: Esse campo facilita integrações futuras e a atualização de preços em massa
Perguntas frequentes
Posso importar produtos em formato Excel (.xlsx)?
Não diretamente. Exporte o arquivo do Excel como CSV antes de importar. No Excel, use Salvar como > CSV UTF-8 (separado por vírgulas).
A importação substitui produtos existentes?
Não. A importação via CSV sempre cria novos produtos. Para atualizar preços de produtos existentes, use a opção de importação de preços por CSV (que localiza pelo código PDV).
Qual o limite de produtos por importação?
Não há limite rígido, mas recomenda-se importar no máximo 500 produtos por vez para garantir a estabilidade do processo.
O CSV pode usar ponto e vírgula como separador?
Sim. O sistema aceita tanto vírgula (,) quanto ponto e vírgula (;) como separador de colunas.
Posso importar adicionais junto com os produtos?
Sim. Use o formato de CSV com adicionais descrito acima, com as colunas NomeAdicional e OpçãoAdicional. As opções de adicionais são criadas como grupo de múltipla escolha.
A exportação inclui produtos inativos?
Sim. A exportação respeita os filtros aplicados na tela. Se a aba Inativos estiver selecionada, os produtos inativos serão incluídos no CSV.
Como exportar dados de um período específico?
Para vendas, defina o período nos filtros do relatório antes de clicar em Exportar CSV. Para produtos e contatos, aplique os filtros desejados na tela correspondente.