Importar de CSV ou Excel

O que é

Importar de CSV ou Excel transforma uma planilha em receitas do AreaCacao. Você prepara o arquivo, você decide o que significa cada coluna, e o importador cria (ou atualiza) as receitas. Nenhuma IA participa da leitura do arquivo e nenhum crédito é consumido.

• Rota: https://app.areacacao.com/import-recipe, aba Enviar novo.
• Como chegar: barra lateral → FORMULAÇÃO → Importar receitas → aba Enviar novo. O cartão fica abaixo da área de envio de fotos/PDF.
• Disponibilidade: ativa por padrão em todos os planos. A única exceção é a conta gratuita limitada (a que pode restar quando o teste de 14 dias termina sem assinatura): ao clicar em Importar CSV/Excel, você verá o aviso “A importação de Excel ou CSV está incluída nos planos Starter e Pro.” com o botão Ver planos.

Em que difere de importar uma foto ou um PDF

A única parte em que a IA pode participar é opcional, e quem escolhe é você: completar os ingredientes que não existam no seu catálogo (veja a seção Ingredientes que não batem com o catálogo, mais abaixo).

O cartão e seus dois botões

O cartão se chama “CSV ou Excel (sem créditos)” e o texto dele é: “Importe suas receitas de uma planilha. Não consome créditos e não tem limite de uso. Importe uma ou várias receitas de uma vez.”

Ele tem dois botões e um painel expansível:

• Importar CSV/Excel — abre o assistente.
• Baixar modelo — baixa o arquivo diretamente, sem passar pelo servidor.
• Guia rápido: como preparar seu arquivo — 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 Baixar 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 mais 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 compartilham recipe_name, e a última traz as etapas. Quatro ingredientes vêm vinculados por ingredient_code e um (a polpa de maracujá) só pelo nome.
2. Trufa clássica de cacau — recheio com camadas: a coluna part separa “Interior” de “Acabamento”.
3. Barra 70% cacau — receita de chocolate: usa chocolate_type e cocoa_percent, e deixa filling_type vazio.

O modelo segue o idioma da interface: com o app em português do Brasil, o arquivo se chama areacacao-modelo-receitas.csv e os nomes das receitas, dos ingredientes, das seções e das etapas 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 reais (BRL).

Você não é obrigado a usar o modelo: pode importar a sua própria planilha, com os seus próprios cabeçalhos, e indicar na etapa de mapeamento o que é cada coluna.

Colunas

O modelo traz 17 colunas, nesta 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 você pode mapear 18 campos: os 17 do modelo mais recipe_id (ID da receita), que existe como destino de mapeamento, embora não venha no modelo.

Como as linhas são agrupadas

As linhas são agrupadas pelo recipe_name normalizado: em 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 em uma única célula: o importador não consegue separá-la.
• Etapas com |. Basta preencher steps em qualquer linha 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 sublinhados. Só ganache não é um valor válido; a ganache clássica de bombom é ganache_bombon. A lista completa está no painel Guia rápido da própria tela.

O assistente, passo a passo

O assistente se chama “Importar receitas de CSV” e tem cinco telas.

Ingredientes que não batem com o catálogo

O importador resolve cada linha assim: se houver ingredient_code, procura essa ficha exata; se não, procura pelo nome no seu catálogo. Se o nome bater com várias fichas, a linha fica pendente com uma lista curta de candidatas para você escolher na receita; se a ficha foi deduzida tirando uma marca ou uma porcentagem do nome, a linha fica sinalizada para você conferir. Quando não encontra nada, aplica a opção que você escolheu na etapa Opções:

• Criar os ingredientes que faltam como pendentes (sem custo) — “Os ingredientes que não encontrarmos são adicionados como pendentes, sem dados nutricionais nem de custo. Você poderá completá-los depois. Não consome créditos.” É a opção padrão.
• Completar com IA os ingredientes que faltam — 5 créditos por ingrediente — “Para cada ingrediente que não encontrarmos, a IA estima macros, alergênicos e dados de custo. São cobrados 5 créditos por ingrediente novo.”

Insumos

As linhas marcadas com is_supply ou com supply_code são tratadas como insumos. Elas são vinculadas somente pelo código ao seu catálogo de insumos. Se o código não existir, a linha é importada mesmo assim, mas fica marcada para revisão, e a contagem Insumos não encontrados da prévia avisa você antes. A importação nunca cria insumos novos — nem mesmo 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 você já tem no seu catálogo, o AreaCacao diferencia o nome automaticamente em vez de duplicá-lo às cegas. Isso só vale ao criar, nunca ao atualizar.
• Uma receita que falha não interrompe o lote: ela é marcada com o erro e o importador segue para a próxima.

Limites

Se você tentar iniciar uma importação enquanto outra ainda está na fila ou em processamento, o servidor a rejeita: é preciso esperar a anterior terminar.

O que NÃO faz

• Não lê o seu arquivo com IA. O mapeamento das colunas é seu e a leitura é determinística.
• Não aparece na aba Histórico. Essa aba lista as importações de foto e PDF. Embora o assistente diga “Você pode fechar esta janela; a importação continua e você a verá no Histórico.”, hoje as importações de planilha não são listadas em nenhuma tela: o status delas só aparece na janela do assistente enquanto ela estiver aberta. Se você fechá-la, a importação continua, mas para conferir o resultado será preciso olhar em Minhas receitas.
• Não pode ser cancelada. Depois que você clica em Importar, não há botão de cancelar; o assistente só permite fechar a janela.
• Não cria insumos novos.
• Não lê mais de uma aba de uma pasta de trabalho do Excel.
• Não importa de um link do Planilhas Google nem de uma URL: é preciso enviar o arquivo. Para importar de uma página da web existe outra opção, veja Importar receita por URL.
• Não valida o filling_type por você. Se você escrever um identificador que não existe, a receita é importada sem validação técnica de recheio.

Próximos passos