Estoque (Inventario)
O modulo de Estoque do Opero controla todos os itens consumiveis e suprimentos da propriedade: produtos de minibar, materiais de limpeza, roupas de cama, amenities, insumos de cozinha e qualquer outro item que precise de controle de quantidade e custo.
O Estoque fica em Financeiro → Estoque e e um add-on pago (Inventory, financial.inventory), contratado na Loja Opero. Sem ele, o item nao aparece no menu e a API recusa as chamadas. A tela lista os itens, com filtro por categoria e os totais de itens, alertas de estoque baixo e valoracao. Movimentacoes, receitas, transferencias, consumo e relatorios ainda nao tem tela: sao feitos pela API.
O que e Controlado
O estoque e organizado em seis categorias:
| Categoria | Exemplos |
|---|---|
| FOOD | Ingredientes de cozinha, frutas, laticeos, carnes |
| BEVERAGE | Agua, refrigerante, cerveja, vinho, destilados |
| SUPPLIES | Produtos de limpeza, detergente, desinfetante |
| AMENITIES | Shampoo, condicionador, sabonete, kit dental |
| MINIBAR | Itens do frigobar (chocolate, suco, snacks) |
| OTHER | Itens que nao se encaixam nas categorias acima |
Cada item de estoque esta vinculado a uma propriedade e a um produto do catalogo global (Global Product). Esse vinculo garante padronizacao entre propriedades e integra com o sistema de classificacao fiscal.
Classificacao fiscal (NCM / HS Code)
Cada produto do catalogo global possui um codigo HS6 (6 digitos, padrao internacional) que o classifica segundo o Harmonized System da Organizacao Mundial das Alfandegas. Para operacoes no Brasil/Mercosul, o produto tambem tem o codigo NCM (8 digitos), obrigatorio para emissao de NF-e.
- HS Code (6 digitos) — classificacao universal de mercadorias para comercio internacional
- NCM (8 digitos) — extensao do HS Code para o Mercosul (os 6 primeiros digitos sao identicos ao HS Code)
- O sistema vem com 10.515 codigos NCM oficiais da Receita Federal e 132 produtos hoteleiros pre-cadastrados
O item de estoque nao guarda codigo fiscal proprio: a classificacao fiscal (HS6/NCM) e a do produto do catalogo ao qual ele esta vinculado.
Para mais detalhes, consulte Classificacao de Produtos.
Itens de Estoque
Campos principais
| Campo | Descricao |
|---|---|
| Codigo | Codigo interno do item (obrigatorio; o sistema nao bloqueia codigos repetidos) |
| Nome | Nome descritivo (ex: “Agua Mineral 500ml”) |
| Categoria | FOOD, BEVERAGE, SUPPLIES, AMENITIES, MINIBAR ou OTHER |
| Unidade de medida | Texto livre (ex: UN, KG, LT, PCT, CX) |
| Estoque atual | Quantidade em estoque (atualizada automaticamente) |
| Custo medio | Custo medio ponderado (calculado nas entradas) |
| Estoque minimo | Quantidade minima antes de gerar alerta |
| Estoque maximo | Quantidade maxima recomendada |
| Ponto de ressuprimento | Quando pedir reposicao (entre minimo e maximo); apenas informativo, nao gera alerta |
| Perecivel | Se o item tem prazo de validade |
| Dias de validade | Prazo de vencimento apos compra |
Vinculo com o financeiro
Cada item pode ser vinculado a contas contabeis para rastreamento automatico de custos:
| Vinculo | Descricao |
|---|---|
| Conta COGS | Conta do Plano de Contas para Custo de Mercadoria Vendida |
| Conta de Estoque | Conta patrimonial de estoque |
| Centro de Custo padrao | Departamento que consome o item por padrao (ex: Cozinha, Governanca) |
Movimentacoes
Toda entrada e saida de estoque e registrada como uma movimentacao. O Opero suporta os seguintes tipos:
Entradas (aumentam estoque)
| Tipo | Descricao |
|---|---|
| PURCHASE | Compra de fornecedor (entrada principal) |
| TRANSFER_IN | Recebimento de transferencia de outra propriedade |
| ADJUSTMENT_IN | Ajuste positivo (inventario fisico encontrou mais) |
| RETURN | Devolucao de item previamente consumido |
Saidas (reduzem estoque)
| Tipo | Descricao |
|---|---|
| SALE | Venda direta (ex: minibar cobrado do hospede) |
| CONSUMPTION | Consumo interno (limpeza, cozinha, amenities) |
| TRANSFER_OUT | Envio para outra propriedade |
| ADJUSTMENT_OUT | Ajuste negativo (inventario fisico encontrou menos) |
| SPOILAGE | Perda por vencimento, dano ou descarte |
Registrando uma movimentacao
A movimentacao e registrada pela API (a tela de Estoque ainda nao tem esse formulario), informando:
- O item, a propriedade e a data
- O tipo (compra, consumo, ajuste, etc.)
- A quantidade e o custo unitario
- Opcionalmente, o fornecedor, o centro de custo e um documento de referencia
Saidas que deixariam o estoque negativo sao recusadas.
O sistema atualiza automaticamente:
- Estoque atual do item
- Custo medio ponderado (recalculado nas entradas)
- Ultimo preco de compra (quando tipo = PURCHASE)
Custo Medio Ponderado
O Opero utiliza o metodo de custo medio ponderado para calcular o valor do estoque. A cada entrada (compra, transferencia recebida, ajuste positivo ou devolucao), o custo medio e recalculado com o custo unitario da entrada:
Custo Medio = (Estoque Anterior x Custo Medio Anterior + Quantidade da Entrada x Custo Unitario)
/ (Estoque Anterior + Quantidade da Entrada)Exemplo:
- Estoque: 100 unidades a R$ 5,00 (custo medio) = R$ 500
- Compra: 50 unidades a R$ 6,00 = R$ 300
- Novo custo medio: (500 + 300) / (100 + 50) = R$ 5,33
Registro de Consumo
O consumo de um item (ou de uma receita) e registrado pela API. Cada registro, numa unica operacao:
- Cria uma movimentacao de tipo
CONSUMPTIONpor item consumido - Decrementa o estoque (e recusa o registro se o estoque for insuficiente)
- Usa o custo medio atual do item
- Cria o lancamento de COGS no financeiro (veja abaixo)
Opcionalmente, o consumo pode ser vinculado a uma reserva. O consumo nao e automatico: lancar um servico ou uma cobranca na reserva nao baixa o estoque.
Tipos de consumo
| Tipo | Descricao |
|---|---|
| SALE | Consumo vinculado a venda para hospede |
| INTERNAL | Consumo interno (limpeza, manutenacao) |
| WASTE | Perda (item vencido, quebrado) |
| RECIPE | Consumo via receita (desdobra em ingredientes) |
Receitas
Uma receita combina multiplos itens de estoque para produzir um produto final. Exemplo: um prato do restaurante consome ingredientes especificos do estoque.
| Campo | Descricao |
|---|---|
| Codigo | Identificador da receita |
| Nome | Nome do produto (ex: “Omelete Especial”) |
| Categoria | FOOD, BEVERAGE, AMENITY_KIT, OTHER |
| Rendimento | Quantidade produzida por execucao |
| Preco de venda | Valor de venda ao hospede |
| Custo calculado | Soma dos custos dos ingredientes |
| Custo por unidade | Custo dividido pelo rendimento |
| Margem | Percentual de margem sobre o preco de venda |
Ao consumir uma receita, o sistema cria movimentacoes CONSUMPTION para cada ingrediente, decrementando o estoque de todos os itens proporcionalmente.
Transferencias entre Propriedades
Para redes com multiplas propriedades, o Opero permite transferir estoque. A transferencia e feita pela API, informando:
- O item na propriedade de origem
- A propriedade de destino e o item correspondente
- A quantidade
O sistema cria:
- Uma movimentacao
TRANSFER_OUTna origem (reduz estoque) - Uma movimentacao
TRANSFER_INno destino (aumenta estoque) - O custo unitario da transferencia usa o custo medio da origem
Alertas de Estoque Baixo
Um item ativo fica em alerta quando:
- Estoque atual < Estoque minimo — Item abaixo do nivel critico
O ponto de ressuprimento nao entra nessa regra, e nenhuma notificacao e enviada. Na tela de Estoque, o card Alertas de Estoque Baixo mostra quantos itens estao em alerta; a lista desses itens, filtravel por propriedade, e obtida pela API.
COGS (Custo da Mercadoria Vendida)
Cada consumo gera automaticamente um lancamento contabil no razao do modulo financeiro. O item precisa ter conta COGS e conta de Estoque, e o consumo precisa de um centro de custo (o informado ou o padrao do item); sem isso, o consumo e recusado:
Debito: Conta COGS (despesa)
Credito: Conta de Estoque (ativo)
Valor: Quantidade x Custo MedioRelatorio de COGS
O relatorio de COGS mostra o custo total de mercadorias consumidas agrupado por mes. Disponivel pela API (ainda sem tela). Filtros disponiveis:
- Propriedade — Filtra por propriedade especifica
- Periodo — Data inicial e final
Relatorio de Movimentacoes
Disponivel pela API (ainda sem tela), com filtros de propriedade e periodo. Resume o volume total de cada tipo de movimentacao no periodo, com quantidade e custo total:
| Tipo | Quantidade | Custo Total |
|---|---|---|
| PURCHASE | 500 un | R$ 2.500 |
| CONSUMPTION | 320 un | R$ 1.600 |
| SPOILAGE | 15 un | R$ 75 |
Valorizacao do Estoque
O relatorio de valorizacao (pela API) mostra o valor total do estoque ativo (quantidade x custo medio) para cada item e o total consolidado da propriedade. Na tela de Estoque, o card Valoracao Total mostra o total.
Boas Praticas
- Vincule ao catalogo global — Todo item deve estar vinculado a um produto do catalogo. Itens sem vinculo (“legado”) sao bloqueados para novas operacoes
- Configure estoque minimo — Alertas so funcionam se o estoque minimo estiver configurado
- Registre todas as perdas — Use
SPOILAGEpara itens vencidos ou danificados. Nao ajuste silenciosamente - Faca inventario fisico periodico — Compare o estoque do sistema com a contagem real e use
ADJUSTMENT_IN/ADJUSTMENT_OUTpara corrigir - Vincule as contas COGS e de Estoque — Sem elas, o registro de consumo e recusado
- Use receitas para F&B — Controle custos de pratos e drinks com receitas. A margem calculada ajuda na precificacao
- Nao exclua itens com estoque — O sistema bloqueia exclusao de itens com estoque > 0. Zere o estoque primeiro com ajuste
Integracao com outros modulos
- Financeiro → Lancamentos COGS automaticos (a cada consumo) na conta contabil configurada
- Produto Catalog → Itens vinculados ao catalogo global (NCM, classificacao fiscal)
- Fornecedores → Movimentacoes de compra referenciando o fornecedor
- Relatorios → COGS mensal, valorizacao de estoque e resumo de movimentacoes ficam na API do Estoque (nao aparecem em Relatorios Financeiros)