Skip to Content
PMS CoreEstoque

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:

CategoriaExemplos
FOODIngredientes de cozinha, frutas, laticeos, carnes
BEVERAGEAgua, refrigerante, cerveja, vinho, destilados
SUPPLIESProdutos de limpeza, detergente, desinfetante
AMENITIESShampoo, condicionador, sabonete, kit dental
MINIBARItens do frigobar (chocolate, suco, snacks)
OTHERItens 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

CampoDescricao
CodigoCodigo interno do item (obrigatorio; o sistema nao bloqueia codigos repetidos)
NomeNome descritivo (ex: “Agua Mineral 500ml”)
CategoriaFOOD, BEVERAGE, SUPPLIES, AMENITIES, MINIBAR ou OTHER
Unidade de medidaTexto livre (ex: UN, KG, LT, PCT, CX)
Estoque atualQuantidade em estoque (atualizada automaticamente)
Custo medioCusto medio ponderado (calculado nas entradas)
Estoque minimoQuantidade minima antes de gerar alerta
Estoque maximoQuantidade maxima recomendada
Ponto de ressuprimentoQuando pedir reposicao (entre minimo e maximo); apenas informativo, nao gera alerta
PerecivelSe o item tem prazo de validade
Dias de validadePrazo de vencimento apos compra

Vinculo com o financeiro

Cada item pode ser vinculado a contas contabeis para rastreamento automatico de custos:

VinculoDescricao
Conta COGSConta do Plano de Contas para Custo de Mercadoria Vendida
Conta de EstoqueConta patrimonial de estoque
Centro de Custo padraoDepartamento 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)

TipoDescricao
PURCHASECompra de fornecedor (entrada principal)
TRANSFER_INRecebimento de transferencia de outra propriedade
ADJUSTMENT_INAjuste positivo (inventario fisico encontrou mais)
RETURNDevolucao de item previamente consumido

Saidas (reduzem estoque)

TipoDescricao
SALEVenda direta (ex: minibar cobrado do hospede)
CONSUMPTIONConsumo interno (limpeza, cozinha, amenities)
TRANSFER_OUTEnvio para outra propriedade
ADJUSTMENT_OUTAjuste negativo (inventario fisico encontrou menos)
SPOILAGEPerda por vencimento, dano ou descarte

Registrando uma movimentacao

A movimentacao e registrada pela API (a tela de Estoque ainda nao tem esse formulario), informando:

  1. O item, a propriedade e a data
  2. O tipo (compra, consumo, ajuste, etc.)
  3. A quantidade e o custo unitario
  4. 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:

  1. Cria uma movimentacao de tipo CONSUMPTION por item consumido
  2. Decrementa o estoque (e recusa o registro se o estoque for insuficiente)
  3. Usa o custo medio atual do item
  4. 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

TipoDescricao
SALEConsumo vinculado a venda para hospede
INTERNALConsumo interno (limpeza, manutenacao)
WASTEPerda (item vencido, quebrado)
RECIPEConsumo 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.

CampoDescricao
CodigoIdentificador da receita
NomeNome do produto (ex: “Omelete Especial”)
CategoriaFOOD, BEVERAGE, AMENITY_KIT, OTHER
RendimentoQuantidade produzida por execucao
Preco de vendaValor de venda ao hospede
Custo calculadoSoma dos custos dos ingredientes
Custo por unidadeCusto dividido pelo rendimento
MargemPercentual 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:

  1. O item na propriedade de origem
  2. A propriedade de destino e o item correspondente
  3. A quantidade

O sistema cria:

  • Uma movimentacao TRANSFER_OUT na origem (reduz estoque)
  • Uma movimentacao TRANSFER_IN no 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 Medio

Relatorio 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:

TipoQuantidadeCusto Total
PURCHASE500 unR$ 2.500
CONSUMPTION320 unR$ 1.600
SPOILAGE15 unR$ 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

  1. Vincule ao catalogo global — Todo item deve estar vinculado a um produto do catalogo. Itens sem vinculo (“legado”) sao bloqueados para novas operacoes
  2. Configure estoque minimo — Alertas so funcionam se o estoque minimo estiver configurado
  3. Registre todas as perdas — Use SPOILAGE para itens vencidos ou danificados. Nao ajuste silenciosamente
  4. Faca inventario fisico periodico — Compare o estoque do sistema com a contagem real e use ADJUSTMENT_IN/ADJUSTMENT_OUT para corrigir
  5. Vincule as contas COGS e de Estoque — Sem elas, o registro de consumo e recusado
  6. Use receitas para F&B — Controle custos de pratos e drinks com receitas. A margem calculada ajuda na precificacao
  7. 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)
Last updated on