Importar a partir de CSV ou Excel

O que é

Importar a partir de CSV ou Excel converte uma folha de cálculo em receitas do AreaCacao. Cabe-lhe a si preparar o ficheiro e decidir o que significa cada coluna; o importador cria (ou atualiza) as receitas. Nenhuma IA intervém na leitura do ficheiro e não são consumidos créditos.

• Caminho: https://app.areacacao.com/import-recipe, separador Enviar novo.
• Como se chega lá: barra lateral → FORMULAÇÃO → Importar receitas → separador Enviar novo. O cartão está por baixo da zona de envio de fotografias/PDF.
• Disponibilidade: ativa por predefinição em todos os planos. A única exceção é a conta gratuita limitada (aquela em que a conta pode ficar quando o período experimental de 14 dias termina sem subscrição): ao clicar em Importar CSV/Excel, verá o aviso «A importação a partir de Excel ou CSV está incluída nos planos Starter e Pro.» com o botão Ver planos.

Em que difere de importar uma fotografia ou um PDF

A única parte em que a IA pode intervir é opcional e é escolhida por si: completar os ingredientes que não existam no seu catálogo (ver a secção Ingredientes que não correspondem ao catálogo, mais abaixo).

O cartão e os seus dois botões

O cartão intitula-se «CSV ou Excel (sem créditos)» e o texto é: «Importe as suas receitas a partir de uma folha de cálculo. Não consome créditos e não tem limite de utilização. Importe uma ou várias receitas de uma vez.»

Tem dois botões e um painel expansível:

• Importar CSV/Excel — abre o assistente.
• Transferir modelo — transfere o ficheiro diretamente, sem passar pelo servidor.
• Guia rápido: como preparar o seu ficheiro — um painel expansível com as regras de preenchimento, a lista de valores válidos de filling_type e os valores de recipe_type.

O modelo

O botão Transferir modelo gera areacacao-modelo-receitas.csv no seu computador. É um CSV com BOM UTF-8 (para que o Excel respeite os acentos) e traz o cabeçalho canónico e três receitas de exemplo, escolhidas para mostrar os três padrões que o importador entende:

1. Ganache de maracujá — recheio simples: cinco linhas partilham recipe_name e a última leva os passos. Quatro ingredientes estão associados por ingredient_code e um (a polpa de maracujá) apenas pelo nome.
2. Trufa clássica de cacau — recheio com camadas: a coluna part separa «Interior» de «Acabamento».
3. Tablete 70% cacau — receita de chocolate: usa chocolate_type e cocoa_percent e deixa filling_type vazio.

O modelo segue o idioma da interface: com a aplicação em português europeu, o ficheiro chama-se areacacao-modelo-receitas.csv e os nomes das receitas, dos ingredientes, das secções e dos passos vêm em português; os cabeçalhos e os identificadores (ganache_bombon, negro…) são sempre os mesmos. Os custos de exemplo são por quilo (cost_unit = kg) e em euros (EUR).

Não é obrigado a usar o modelo: pode importar a sua própria folha com os seus próprios cabeçalhos e indicar, no passo de correspondência, o que é cada coluna.

Colunas

O modelo traz 17 colunas, por esta ordem:

recipe_name, recipe_type, chocolate_type, filling_type, cocoa_percent, part, ingredient_code, ingredient_name, quantity, unit, weight_g, cost_per_unit, cost_unit, cost_currency, is_supply, supply_code, steps

No assistente pode fazer a correspondência de 18 campos: os 17 do modelo mais recipe_id (ID da receita), que existe como destino de correspondência embora não venha no modelo.

Como se agrupam as linhas

As linhas agrupam-se por recipe_name normalizado: minúsculas, sem acentos e com os espaços internos reduzidos a um só. Ou seja, «Ganache de Maracujá» e «ganache de maracuja» acabam na mesma receita.

Regras de preenchimento que o importador aplica

• Um ingrediente por linha. Não escreva a lista completa de ingredientes numa única célula: o importador não consegue separá-la.
• Passos com |. Basta preencher steps numa linha qualquer da receita.
• Camadas com part. O mesmo recipe_name em todas as linhas e o nome da camada em part. Se a receita tiver uma só camada, deixe part vazia.
• filling_type com o identificador exato, em minúsculas e com underscores. ganache, sem mais nada, não é um valor válido; a ganache clássica de bombom é ganache_bombon. A lista completa está no painel Guia rápido do próprio ecrã.

O assistente, passo a passo

O assistente intitula-se «Importar receitas a partir de CSV» e tem cinco ecrãs.

Ingredientes que não correspondem ao catálogo

O importador resolve cada linha assim: se houver ingredient_code, procura essa ficha exata; caso contrário, pesquisa pelo nome no seu catálogo. Se o nome corresponder a várias fichas, a linha fica pendente com uma lista curta de candidatas para escolher na receita; se a ficha foi deduzida retirando uma marca ou uma percentagem do nome, a linha fica assinalada para a verificar. Quando não encontra nada, aplica a opção que escolheu no passo Opções:

• Criar os ingredientes em falta como pendentes (sem custo) — «Os ingredientes que não encontrarmos são adicionados como pendentes, sem dados nutricionais nem de custo. Poderá completá-los mais tarde. Não consome créditos.» É a opção predefinida.
• Completar com IA os ingredientes em falta — 5 créditos por ingrediente — «Para cada ingrediente que não encontrarmos, a IA estima os macros, os alergénios e os dados de custo. São cobrados 5 créditos por ingrediente novo.»

Consumíveis

As linhas marcadas com is_supply ou com supply_code são tratadas como consumíveis. São associadas apenas pelo código ao seu catálogo de consumíveis. Se o código não existir, a linha é importada na mesma, mas fica marcada para revisão, e a contagem Consumíveis não encontrados da pré-visualização avisa-o antes. A importação nunca cria consumíveis novos — nem sequer no modo IA, que só se aplica a ingredientes.

Criar ou atualizar

• Sem recipe_id → é sempre criada uma receita nova.
• Com recipe_id → se esse id existir e for seu, a receita é atualizada. Se não existir ou não for seu, é criada uma receita nova.
• Quando é criada uma receita cujo nome já existe no seu catálogo, o AreaCacao diferencia o nome automaticamente em vez de o duplicar às cegas. Isto só se aplica ao criar, nunca ao atualizar.
• Uma receita que falha não interrompe o lote: fica marcada com o respetivo erro e o importador passa à seguinte.

Limites

Se tentar lançar uma importação enquanto outra ainda está em fila ou em processamento, o servidor rejeita-a: é preciso esperar que a anterior termine.

O que NÃO faz

• Não lê o seu ficheiro com IA. A correspondência das colunas é sua e a análise do ficheiro é determinista.
• Não aparece no separador Histórico. Esse separador lista as importações de fotografias e PDF. Embora o assistente diga «Pode fechar esta janela; a importação continua e poderá vê-la no Histórico.», hoje as importações a partir de folha de cálculo não são listadas em nenhum ecrã: o seu estado só é visível na janela do assistente enquanto a tiver aberta. Se a fechar, a importação continua, mas para verificar o resultado terá de consultar As minhas receitas.
• Não pode ser cancelada. Depois de clicar em Importar, não há botão para cancelar; o assistente só permite fechar a janela.
• Não cria consumíveis novos.
• Não lê mais do que uma folha de um livro do Excel.
• Não importa a partir de uma ligação do Google Sheets nem de um URL: é preciso enviar o ficheiro. Para importar a partir de uma página web existe outra via, ver Importar receita por URL.
• Não valida o filling_type por si. Se escrever um identificador que não existe, a receita é importada sem validação técnica de recheio.

Próximos passos