AreaCacaoDocs
Análise sensorialLotes

Lotes

Rastreabilidade bean-to-bar dos seus lotes de cacau, ingredientes e produto acabado, vinculados a avaliações e estudos de vida útil.

O que é

Um lote é a unidade de estoque que você registra e vincula às suas avaliações e estudos de vida útil. Cada lote registra a origem, o fornecedor, a quantidade e o status de uma partida de cacau, de um ingrediente ou de um produto acabado, para que você possa demonstrar de qual partida específica vem cada perfil sensorial. É a base da rastreabilidade bean-to-bar.

Plano Pro ou superior. Lotes faz parte do módulo de análise sensorial: no plano Starter, o módulo inteiro fica bloqueado com uma mensagem de upgrade que convida a passar para o Pro; ao fechá-la, você volta ao hub de Análise sensorial. Pro e Studio têm acesso completo.

Os Lotes do módulo sensorial são uma unidade de rastreabilidade bean-to-bar: servem para vincular cada partida de cacau, ingrediente ou produto acabado às suas degustações e estudos. Não são um sistema de gestão de estoque nem de pedidos.

Como acessar

  • URL: https://app.areacacao.com/sensory-analysis/batches
  • Como chegar: em Análise sensorial, abra Lotes.

Lista de lotes

A tela principal mostra:

  • Cabeçalho com o título Lotes, o subtítulo “Rastreabilidade bean-to-bar: cada lote é a unidade de estoque que você vincula a avaliações e estudos de vida útil.” e o botão Novo lote.
  • Filtros:
    • Tipo: Todos, Cacau em amêndoas, Massa de cacau, Ingrediente, Produto acabado.
    • Status: Todos, Cotação, Amostra recebida, Aprovado, Recebido, Em uso, Esgotado, Rejeitado.
    • Buscar (nome, código, origem): filtra pelo nome comercial, pelo código interno ou pela origem (placeholder Madagascar 70%, MAD-2026...).
  • Lista de cartões: cada cartão mostra o nome comercial, o tipo, o código interno, o fornecedor, a origem geográfica, a data da última atualização e um selo (badge) com o status. A cor do selo ajuda você a ler o status de relance: verde para Aprovado e Recebido, chocolate para Em uso, vermelho para Rejeitado e cinza para os demais.
  • Link ← Voltar à Análise sensorial.

Clique em um cartão para abrir o detalhe do lote.

Se você ainda não criou nenhum lote, verá a mensagem Ainda não há lotes com o botão Criar o primeiro lote. O sistema convida você a criar o seu primeiro lote de cacau, ingrediente ou produto acabado para começar a vincular avaliações e estudos.

Se a lista não carregar, você verá o aviso “Não foi possível carregar os lotes”; ao abrir para edição um lote que não carrega, “Não foi possível carregar o lote”. Normalmente isso se resolve recarregando a página.

Criar um lote

Clique em Novo lote

Abre o formulário de cadastro. O cabeçalho indica “Crie uma unidade de estoque para vinculá-la a avaliações e estudos de vida útil.”

Preencha o formulário

Os campos marcados com asterisco são obrigatórios:

  • Tipo (por padrão, Cacau em amêndoas).
  • Status (por padrão, Cotação). No cadastro você só pode escolher entre: Cotação, Amostra recebida, Aprovado, Recebido e Em uso.
  • Nome comercial (placeholder Madagascar 70% Sambirano).
  • Código interno (opcional, por exemplo MAD-2026-Q1-001).
  • Fornecedor (opcional).
  • Origem geográfica (opcional, por exemplo Vale do Sambirano, Madagascar).
  • Quantidade e Unidade (por padrão, kg).
  • Data de recebimento.
  • Validade recomendada (opcional).
  • Observações (opcional): safra, observações do fornecedor, condições de transporte.

Clique em Criar lote

Se o nome comercial estiver vazio, o botão fica desabilitado e, ao tentar salvar, você verá “O nome comercial é obrigatório.” Ao salvar, o AreaCacao leva você direto ao detalhe do lote recém-criado. Se preferir não criar o lote, clique em Cancelar para voltar à lista sem salvar.

Os status Esgotado e Rejeitado não aparecem ao criar um lote: você só pode atribuí-los depois, ao editá-lo.

Detalhe do lote

Ao abrir um lote, você vê:

  • Cabeçalho com o nome do lote como título, o tipo e o código interno como subtítulo (por exemplo Cacau em amêndoas · MAD-2026-Q1-001), o selo de status e os botões Editar e Excluir.
  • Ficha Dados do lote: Tipo, Fornecedor, Origem geográfica, Quantidade (com a sua unidade), Data de recebimento e Validade recomendada.
  • Observações, se houver.
  • Linha do tempo cronológica: registra os marcos do lote: a criação do lote, as suas edições, as avaliações que você vincula, o início de estudos de vida útil e as receitas criadas com esse lote. É a leitura visual da sua rastreabilidade bean-to-bar.
  • Link ← Voltar à lista.

Editar um lote

Clique em Editar para abrir o formulário já preenchido com os mesmos campos do cadastro. A diferença é que aqui o seletor Status inclui todos os status, inclusive Esgotado e Rejeitado. Clique em Salvar alterações para confirmar ou em Cancelar para voltar ao detalhe sem salvar.

Excluir um lote

Clique em Excluir. Aparece uma confirmação com o nome comercial do lote entre aspas retas e o aviso “Esta ação pode ser revertida pelo painel de administração.” Ao confirmar, o lote deixa de aparecer na lista.

A exclusão é lógica (soft delete): o lote não se perde e só pode ser recuperado pelo painel de administração.

Se você abrir um lote que não existe mais (ou que foi excluído), verá Lote não encontrado com o aviso “O lote solicitado não existe ou foi excluído.”

Por que é importante

  • Rastreabilidade regulatória. Se um cliente B2B quiser saber de qual lote específico vem um bombom, você consegue responder.
  • Qualidade por lote. Comparar os perfis sensoriais do mesmo cacau em lotes diferentes ao longo do ano revela variações de safra ou de processamento.
  • Decisões de blend. Saber quais lotes A e B, misturados, dão o perfil que você procura.

Próximos passos

Nesta página