> ## Documentation Index
> Fetch the complete documentation index at: https://ajuda.brendi.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Insumos

> Cadastre os insumos das fichas técnicas com unidade e custo, monte a sub-receita dos beneficiados e atualize os preços pelo XML da nota fiscal.

Na aba **Insumos** você cadastra tudo que entra nas fichas técnicas dos produtos, com a unidade e o custo de cada item. A seção **Ficha Técnica / Ingredientes** de cada produto usa esses custos para calcular o custo do prato e a margem. <Badge>Em liberação</Badge>

<Note>
  **Insumos** está em liberação, e o acesso é dado loja por loja. Se a aba não aparece no **Editor de cardápio**, sua loja ainda não tem acesso. A mesma liberação mostra a seção **Ficha Técnica / Ingredientes** dos produtos e a aba **Custos Fixos** em **Administrar loja**. Com o acesso liberado, todos os papéis abrem a aba e mudam os insumos: Dono, Gerente, Gestor de Tráfego e Operador.
</Note>

## Onde encontrar

**Editor de cardápio › Insumos**, a última aba do editor, depois de **Estoque**. A mesma lista de insumos alimenta a janela **Adicionar insumos**, aberta pela ficha técnica de um produto — o que acontece com a ficha depois está em [Produtos](/funcionalidades/editor-de-cardapio/produtos#adicionar-insumos).

## Lista de insumos

A lista traz **Insumo**, **Tipo**, **Unidade**, **Custo** (por unidade, como R\$ 12,50/kg — **Calculado** nos beneficiados, **Sem preço** no comprado sem custo informado), **Status** e **Ações**. Use **Buscar insumo** e os filtros **Todos**, **Comprados**, **Beneficiados** e **Sem preço** (cada um mostra quantos insumos tem) para achar o que precisa; **Mostrar inativos** (desligado por padrão) também traz os insumos removidos.

Clique na linha, ou no lápis (**Editar insumo**), para alterar o cadastro. Na coluna **Ações** ficam também o ícone de lista (**Compor sub-receita**, só nos beneficiados) e a lixeira (**Remover insumo**). Quando algum insumo comprado está sem custo, um aviso mostra quantos são — os produtos que os usam ficam com custo parcial — e **Ver só esses** filtra para eles.

## Cadastro do insumo

Existem dois tipos: o **comprado**, que você compra e usa como está (o custo é o que você informa), e o **beneficiado**, que a cozinha prepara a partir de outros insumos — como a peça de carne que vira carne moída —, cujo custo vem da sub-receita dele. **Novo insumo** (ou clicar num insumo da lista, para editar) abre a janela com o **Nome** (obrigatório, até 200 caracteres — vale para todos os produtos que usam o insumo) e o **Tipo**.

No **cliente**, o nome aparece em **Ingredientes** na página do produto (um beneficiado aparece como um ingrediente só, sem os componentes, sem quantidades ou custos). No **comprado**, informe a **Unidade base** (kg, g, l, ml, un ou cm) e o **Custo por (unidade base)**: o custo aceita só centavos inteiros por unidade base, então para insumos baratos como farinha use kg ou l como base e g ou ml na ficha do prato. Mudar o custo atualiza todos os beneficiados e produtos que usam o insumo — também dá para mudar pela ficha técnica do produto, em [Custo unitário](/funcionalidades/editor-de-cardapio/produtos#custo-unit%C3%A1rio). Na ficha técnica e na sub-receita, o insumo pode ser usado em outra unidade do mesmo tipo de medida (kg aceita g, l aceita ml) — veja [Unidade](/funcionalidades/editor-de-cardapio/produtos#unidade) em Produtos.

<Warning>
  O custo é gravado como está no campo: um insumo salvo com R\$ 0,00 entra no custo dos pratos como zero, não como **Sem preço**, e a ficha do prato parece completa.
</Warning>

Ainda no comprado, o **Fator de perda (%)** é quanto se perde no preparo (o bacon encolhe ao fritar, por exemplo): com 30% de perda, 100 g no prato custam o mesmo que cerca de 143 g crus — vazio significa sem perda. No **beneficiado**, em vez disso, você preenche o **Rendimento** (obrigatório, maior que zero) e a **Unidade** em que ele é usado nos pratos: o custo por unidade é o total da sub-receita dividido pelo rendimento — 1 kg de carne a R\$ 40,00 rendendo 0,8 kg de carne moída dá R\$ 50,00 o kg. A perda do beneficiado entra assim, pelo rendimento, e não por um fator próprio.

Trocar um comprado para beneficiado apaga o custo e o fator de perda dele ao salvar. A chave **Ativo** só reflete o status atual: ela não desativa o insumo ao salvar — para isso, use **Remover insumo**.

## Sub-receita dos beneficiados

**Compor sub-receita**, na linha de um beneficiado, abre a lista de componentes que formam a receita — é ela que dá o custo do beneficiado, e cada mudança é gravada na hora. Escolha o **Componente** (um insumo ativo, incluindo outros beneficiados, menos o próprio — cada um entra uma vez só), a **Qtd** e a **Un** (só aceita unidade do mesmo tipo de medida do componente) e clique no botão de mais para adicionar; a lixeira remove. Sem componente, o beneficiado fica sem custo — os produtos que o usam ficam com custo parcial.

<Warning>
  Não feche um círculo entre beneficiados, como A na sub-receita de B e B na sub-receita de A. A tela aceita, mas o custo dos produtos que usam esses insumos deixa de ser calculado — a ficha técnica deles mostra um erro, e o ponto de equilíbrio de **Custos Fixos** também não é calculado.
</Warning>

## Importar nota (XML)

**Importar XML** atualiza o custo dos insumos a partir do arquivo XML de uma nota fiscal eletrônica (NF-e) de compra — a Brendi lê os itens e usa IA para achar, para cada um, o insumo cadastrado correspondente, mesmo quando o nome não é idêntico. Itens sem descrição, preço ou unidade ficam de fora.

Revise cada item em **Casar com**: escolha um insumo da lista (atualiza só o custo dele), **Criar novo** (cadastra um insumo comprado com o nome do item, na **Unidade** e custo que você escolher) ou **Ignorar**. O **Custo por unidade** já vem sugerido, convertido para a unidade do insumo — se a Brendi não conseguiu converter (insumo não encontrado, ou unidade da nota fora de kg/g/l/ml/un/cm, ou de tipo diferente), o item mostra **revisar unidade** e o campo começa em R\$ 0,00: preencha antes de aplicar.

<Warning>
  Confira o custo antes de aplicar: um item aplicado com R\$ 0,00 grava o insumo com custo zero, e não como **Sem preço**.
</Warning>

Clique em **Aplicar** para atualizar os custos e cadastrar os insumos novos de uma vez — itens em **Ignorar** ficam de fora. Se algum falhar, os que deram certo continuam aplicados e você pode tentar de novo só os que faltaram.

## Adicionar insumos a um produto

Na seção **Ficha Técnica / Ingredientes** de um produto, **Adicionar insumos** (ou **+ Adicionar insumo**) abre a lista dos insumos ativos que ainda não estão na ficha — marque os que o prato usa e clique em **Adicionar**. **Buscar insumo** filtra pelo nome, e **+ Novo insumo** cadastra um insumo na hora, já ligado à ficha do produto.

## Como fazer

### Cadastrar um insumo comprado

<Steps>
  <Step title="Abra a janela">
    Em **Editor de cardápio › Insumos**, clique em **Novo insumo**.
  </Step>

  <Step title="Preencha os campos">
    Informe o nome, deixe o tipo em **Comprado (matéria-prima)**, escolha a unidade base e digite o custo. Se o insumo perde peso no preparo, preencha o **Fator de perda (%)**.
  </Step>

  <Step title="Salve">
    Clique em **Salvar**. Aparece **Insumo criado** e o insumo entra na lista.
  </Step>
</Steps>

### Cadastrar um beneficiado e montar a sub-receita

<Steps>
  <Step title="Cadastre os componentes">
    Todo componente da sub-receita precisa estar cadastrado como insumo. Cadastre antes os que faltam.
  </Step>

  <Step title="Cadastre o beneficiado">
    Clique em **Novo insumo**, dê o nome, escolha **Beneficiado (preparado na casa)** e preencha o rendimento e a unidade. Clique em **Salvar**.
  </Step>

  <Step title="Abra a sub-receita">
    Na linha do beneficiado, clique no ícone de lista (**Compor sub-receita**).
  </Step>

  <Step title="Adicione os componentes">
    Para cada um, escolha o componente, informe a quantidade e a unidade e clique no botão de mais. Cada componente é gravado na hora.
  </Step>

  <Step title="Feche">
    Clique em **Fechar**. O custo do beneficiado passa a valer em todos os produtos que o usam.
  </Step>
</Steps>

### Atualizar os preços pela nota fiscal

<Steps>
  <Step title="Importe o arquivo">
    Clique em **Importar XML** e escolha o arquivo XML da nota.
  </Step>

  <Step title="Revise cada item">
    Confira em **Casar com** o insumo de cada item, ou escolha **Criar novo** ou **Ignorar**. Nos itens com **revisar unidade**, digite o custo você mesmo.
  </Step>

  <Step title="Aplique">
    Clique em **Aplicar**. Aparece **Preços atualizados**.
  </Step>
</Steps>

### Informar o custo que falta

<Steps>
  <Step title="Filtre os insumos sem custo">
    Clique em **Ver só esses**, no aviso de insumos sem preço, ou no filtro **Sem preço**.
  </Step>

  <Step title="Informe o custo">
    Clique no insumo, digite o custo e clique em **Salvar**. Repita com os outros.
  </Step>
</Steps>

### Remover um insumo

<Steps>
  <Step title="Clique na lixeira">
    Na linha do insumo, clique no ícone de lixeira (**Remover insumo**).
  </Step>

  <Step title="Confirme">
    Na janela **Remover insumo?**, clique em **Remover**. Aparece **Insumo removido**.
  </Step>
</Steps>

O insumo fica inativo: sai da lista e das janelas de escolha (volta a aparecer com **Mostrar inativos** ligado), mas continua na ficha técnica dos produtos e nas sub-receitas em que já estava, com o custo contando — e o cliente continua vendo o nome dele em **Ingredientes**. Para tirá-lo de um prato, remova a linha na ficha do produto: veja [Remover insumo](/funcionalidades/editor-de-cardapio/produtos#remover-insumo) em Produtos. Não há como reativar pela tela: cadastre de novo se precisar.

## Dúvidas frequentes

<AccordionGroup>
  <Accordion title="Por que o prato está com custo parcial se nenhum insumo está Sem preço?">
    O custo também fica parcial quando um beneficiado usado no prato não tem componente na sub-receita, ou tem componente sem quantidade ou sem custo, ou quando uma linha da ficha do produto está sem quantidade ou usa unidade de outro tipo de medida. O beneficiado aparece como **Calculado** mesmo assim: confira a sub-receita dele.
  </Accordion>

  <Accordion title="Apareceram insumos Sem preço que eu não cadastrei. De onde vieram?">
    A Brendi pode sugerir com IA os insumos de um produto a partir da descrição dele, e os insumos que ela cadastra entram sempre sem preço. Informe o custo de cada um.
  </Accordion>

  <Accordion title="Posso importar a nota em PDF?">
    Não. A importação lê o arquivo XML da nota fiscal eletrônica; o PDF da nota não serve.
  </Accordion>

  <Accordion title="A aba Insumos controla o estoque?">
    Não. A aba guarda a unidade e o custo de cada insumo, não a quantidade que você tem. O estoque é controlado pelo Código PDV dos itens, na aba [Estoque](/funcionalidades/editor-de-cardapio/estoque).
  </Accordion>

  <Accordion title="Dá para usar insumos em sabores de pizza ou em complementos?">
    Não. Só os produtos têm a seção **Ficha Técnica / Ingredientes**: os sabores de [Pizzas](/funcionalidades/editor-de-cardapio/pizzas) e as opções de [Complementos](/funcionalidades/editor-de-cardapio/complementos) não têm ficha técnica.
  </Accordion>

  <Accordion title="Não vejo a aba Insumos. Por quê?">
    Ela está em liberação e só aparece nas lojas que a Brendi já liberou. A mesma liberação mostra a seção **Ficha Técnica / Ingredientes** dos produtos.
  </Accordion>
</AccordionGroup>

## Relacionados

<CardGroup cols={2}>
  <Card title="Produtos" href="/funcionalidades/editor-de-cardapio/produtos">
    Monte a ficha técnica de cada produto e veja o custo do prato e a margem.
  </Card>

  <Card title="Custos Fixos" href="/funcionalidades/administrar-loja/custos-fixos">
    Use o custo dos pratos para calcular o ponto de equilíbrio da loja.
  </Card>

  <Card title="Estoque" href="/funcionalidades/editor-de-cardapio/estoque">
    Controle a quantidade em estoque dos itens pelo Código PDV.
  </Card>
</CardGroup>
