> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fire.rest/llms.txt
> Use this file to discover all available pages before exploring further.

# Receitas

> Defina como vendas e produção consomem inventário: receitas, subreceitas, o ciclo rascunho-publicação e o simulador de venda.

Receitas conectam o que você **vende** com o que você **estoca**. Quando um pedido é vendido, o BOH busca a receita de cada produto e deduz os ingredientes do inventário automaticamente.

**Onde você trabalha:** a seção **Receitas** do menu BOH — **Todas as receitas** (`/boh/admin/recipes`), **Subreceitas** (`/boh/admin/subrecipes`) e **Simular venda por produto** (`/boh/admin/recipes/effective`).

## Tipos de receita

| Tipo                  | O que faz                                                                                                                            | Exemplo                                                  |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------- |
| **Sales recipe**      | Vinculada a um produto vendável. Consumida automaticamente quando o produto é vendido.                                               | "Classic Burger" consome pão, carne, queijo…             |
| **Production recipe** | Produz um item estocado a partir de outros itens, via um [lote de produção](/pt/manuals/boh/transfers-production#lotes-de-producao). | "Molho BBQ" consome tomate, açúcar… e gera molho.        |
| **Subrecipe**         | Composição reutilizável usada dentro de outras receitas. Não tem estoque próprio.                                                    | "Base de burger" usada por todos os burgers do cardápio. |

As linhas de receita podem consumir:

* Um **item** específico (ex.: 120 g de queijo da marca X).
* Uma **etiqueta de item** (ex.: 80 g de qualquer `TOMATO`) — o BOH escolhe o membro conforme sua [estratégia de seleção](/pt/manuals/boh/catalog#etiquetas-de-itens--itens-intercambiaveis).
* Uma **subreceita** (ex.: 1 porção de "Base de burger"), expandida recursivamente no momento do consumo.

<Frame>
  <img src="https://mintcdn.com/firepos/BrdVCD37uC_Sgwgg/images/manuals/boh/recipes/01-recipes-list.png?fit=max&auto=format&n=BrdVCD37uC_Sgwgg&q=85&s=90f41b0835320ee2d3bf4764c032d041" alt="Lista de receitas com filtro de tipo" width="2918" height="1516" data-path="images/manuals/boh/recipes/01-recipes-list.png" />
</Frame>

## Ciclo de vida: rascunho, publicada, arquivada

Receitas são **versionadas**. Cada versão passa por três estados:

| Estado        | Significado                                           |
| ------------- | ----------------------------------------------------- |
| **Draft**     | Editável. Não usada por vendas.                       |
| **Published** | Imutável e ativa — é a versão que as vendas consomem. |
| **Archived**  | Histórica. Mantida para auditar consumo passado.      |

Publicar uma nova versão arquiva automaticamente a publicada anterior, então **só existe uma versão publicada por produto e loja** por vez.

<Warning>
  Vendas só consomem receitas **publicadas**. Um produto com receita apenas em rascunho não deduz inventário quando vendido.
</Warning>

## Criar e publicar uma receita

<Steps>
  <Step title="Abra o formulário de receita">
    **Recipes → Create** (`/boh/admin/recipes/new`).
  </Step>

  <Step title="Escolha o tipo e o alvo">
    Para receita de venda, selecione o produto vendável e a loja. Para receita de produção, selecione o item de saída. Para subreceita, defina um code.
  </Step>

  <Step title="Adicione as linhas">
    Cada linha: o que consumir (item, etiqueta ou subreceita), a quantidade e a unidade.
  </Step>

  <Step title="Salve o rascunho e revise">
    Na página de detalhe (`/boh/admin/recipes/{id}`) você pode revisar linhas e o histórico de versões.
  </Step>

  <Step title="Publique">
    Pressione **Publish**. O rascunho vira a versão ativa.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/firepos/BrdVCD37uC_Sgwgg/images/manuals/boh/recipes/02-recipe-form.png?fit=max&auto=format&n=BrdVCD37uC_Sgwgg&q=85&s=f4d0e9dd06e4f240e10d6198585a2662" alt="Formulário de receita de venda com linhas de consumo de item, etiqueta e subreceita" data-path="images/manuals/boh/recipes/02-recipe-form.png" />
</Frame>

O mesmo formulário cobre os três tipos de receita — o que muda é o **alvo**: um produto vendável e loja para receitas de venda, um item de saída para receitas de produção e um código para subreceitas.

<Frame>
  <img src="https://mintcdn.com/firepos/BrdVCD37uC_Sgwgg/images/manuals/boh/recipes/05-production-recipe-form.png?fit=max&auto=format&n=BrdVCD37uC_Sgwgg&q=85&s=2478a428dc3e621e989752026625e10d" alt="Formulário de receita de produção com item de saída e quantidade produzida" width="2940" height="2094" data-path="images/manuals/boh/recipes/05-production-recipe-form.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/firepos/BrdVCD37uC_Sgwgg/images/manuals/boh/recipes/06-subrecipe-form.png?fit=max&auto=format&n=BrdVCD37uC_Sgwgg&q=85&s=c728ad70967f112960085db3bba171ec" alt="Formulário de subreceita com código reutilizável" width="2940" height="1672" data-path="images/manuals/boh/recipes/06-subrecipe-form.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/firepos/BrdVCD37uC_Sgwgg/images/manuals/boh/recipes/03-recipe-detail.png?fit=max&auto=format&n=BrdVCD37uC_Sgwgg&q=85&s=efafbd67ace5a3e96b0c7e97de649a64" alt="Detalhe de receita com histórico de versões e ação de publicar" width="2940" height="1842" data-path="images/manuals/boh/recipes/03-recipe-detail.png" />
</Frame>

## Linhas com escopo por canal

Existe uma única receita publicada por produto e loja. As linhas que só se aplicam a um canal específico (delivery, drive-thru, consumo no local…) são modeladas **por linha** usando o campo opcional `service_codes`:

| Configuração da linha                       | Quando se aplica                                            |
| ------------------------------------------- | ----------------------------------------------------------- |
| `service_codes` ausente ou vazio            | **Sempre** — a linha é geral e se aplica a todos os canais. |
| `service_codes: ["DELIVERY"]`               | Somente quando o canal do pedido é `DELIVERY`.              |
| `service_codes: ["DELIVERY", "DRIVE_THRU"]` | Quando o canal é `DELIVERY` **ou** `DRIVE_THRU`.            |

<Tip>
  Modele embalagens de delivery, kits de talheres e sacolas como linhas com escopo `DELIVERY` em vez de colocá-los na receita base — pedidos dine-in não os consumirão.
</Tip>

Ao simular uma venda (**Recipes → Simulate sale by product**), selecione o tipo de serviço para ver exatamente quais linhas serão consumidas para aquele canal — linhas gerais são sempre exibidas; linhas com escopo por canal, apenas quando o código corresponde.

## Simular uma venda

Antes de ir ao ar, verifique o que um produto realmente deduzirá: **Recipes → Simulate sale by product** (`/boh/admin/recipes/effective`). Escolha uma loja, um produto e um tipo de serviço, e o BOH mostra a lista expandida de itens e quantidades que uma venda consumiria — incluindo expansão de subreceitas e resolução de etiquetas.

<Frame>
  <img src="https://mintcdn.com/firepos/BrdVCD37uC_Sgwgg/images/manuals/boh/recipes/04-simulate-sale.png?fit=max&auto=format&n=BrdVCD37uC_Sgwgg&q=85&s=1aa9615acb3b5bc45a75b16d399a01ae" alt="Simulação de venda mostrando consumo expandido de ingredientes para um produto" width="2940" height="2922" data-path="images/manuals/boh/recipes/04-simulate-sale.png" />
</Frame>

Próximo: [Abastecimento](/pt/manuals/boh/procurement).