StockConciliation (Conciliacao de Estoque)
O StockConciliation representa o processo de inventario e ajuste de estoque fisico versus sistema.
Descricao
A conciliacao de estoque permite comparar a contagem fisica dos produtos com o estoque registrado no sistema, identificando divergencias e realizando ajustes.
Dados
Informacoes da Conciliacao
| Campo | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
| reference | Texto | Auto | Codigo de referencia |
| status | Selecao | Sim | Status da conciliacao |
| start_date | Data | Sim | Data de inicio |
| end_date | Data | Nao | Data de conclusao |
| notes | Texto | Nao | Observacoes |
Status
| Status | Descricao |
|---|---|
| draft | Rascunho |
| in_progress | Contagem em andamento |
| review | Em revisao |
| approved | Aprovada |
| applied | Ajustes aplicados |
| canceled | Cancelada |
Relacionamentos
Pertence a
| Entidade | Obrigatorio | Descricao |
|---|---|---|
| Account | Sim | Conta do petshop |
| Store | Sim | Filial |
| Deposit | Nao | Deposito especifico |
| User | Sim | Usuario responsavel |
Possui
| Entidade | Descricao |
|---|---|
| ConciliationItems | Itens contados |
| ConciliationAdjustments | Ajustes gerados |
ConciliationItem
Dados
| Campo | Tipo | Descricao |
|---|---|---|
| sale_product_id | Referencia | Produto |
| system_quantity | Decimal | Quantidade no sistema |
| counted_quantity | Decimal | Quantidade contada |
| difference | Decimal | Diferenca (contado - sistema) |
| unit_cost | Monetario | Custo unitario |
| total_difference_value | Monetario | Valor da diferenca |
| status | Selecao | Status do item |
| notes | Texto | Observacoes |
Status do Item
| Status | Descricao |
|---|---|
| pending | Aguardando contagem |
| counted | Contado |
| reviewed | Revisado |
| adjusted | Ajuste aplicado |
| skipped | Ignorado |
Ciclo de Vida
Fluxo de Conciliacao
Selecao de Produtos
Opcoes de Selecao
| Opcao | Descricao |
|---|---|
| Todos | Todos os produtos ativos |
| Categoria | Produtos de uma categoria |
| Fornecedor | Produtos de um fornecedor |
| Deposito | Produtos em um deposito |
| Lista | Lista especifica de produtos |
| Aleatorio | Amostragem aleatoria |
Filtros Adicionais
| Filtro | Descricao |
|---|---|
| Com estoque | Apenas com estoque maior que zero |
| Sem movimento | Sem movimento em X dias |
| Alto valor | Acima de valor especifico |
Contagem
Metodos de Contagem
| Metodo | Descricao |
|---|---|
| Manual | Digitacao da quantidade |
| Leitor | Leitura de codigo de barras |
| Importacao | Importar de planilha |
Contagem Cega
Opcao de ocultar quantidade do sistema durante contagem para evitar vies.
Recontagem
Se diferenca significativa, sistema pode solicitar recontagem:
Se |diferenca| > 10% do estoque: solicitar recontagem
Revisao
Analise de Divergencias
| Divergencia | Classificacao |
|---|---|
| Ate 1% | Aceitavel |
| 1% a 5% | Atencao |
| Acima de 5% | Critica |
Justificativas
| Tipo | Descricao |
|---|---|
| Erro de contagem | Recontagem necessaria |
| Furto/Extravio | Perda nao registrada |
| Erro de lancamento | Sistema incorreto |
| Avaria | Produto danificado |
| Vencimento | Produto descartado |
Aplicacao de Ajustes
Geracao de Movimentacoes
Ao aplicar ajustes, o sistema gera:
Para cada item com diferenca != 0:
Se diferenca > 0 (sobra):
StockTransaction tipo "entry" (ajuste de inventario)
Se diferenca < 0 (falta):
StockTransaction tipo "exit" (ajuste de inventario)
Impacto no Custo
| Situacao | Impacto |
|---|---|
| Sobra | Aumenta estoque, nao altera custo medio |
| Falta | Reduz estoque, registra perda no valor do custo |
Relatorios
Relatorio de Conciliacao
| Secao | Conteudo |
|---|---|
| Resumo | Totais, percentual de acerto |
| Divergencias | Itens com diferenca |
| Por categoria | Resumo por categoria |
| Por valor | Maiores divergencias em valor |
Indicadores
| Indicador | Calculo |
|---|---|
| Acuracia | Itens sem divergencia / Total |
| Valor divergente | Soma absoluta das diferencas |
| Perda | Soma das diferencas negativas |
| Sobra | Soma das diferencas positivas |
Validacoes
| Campo | Regra |
|---|---|
| store_id | Obrigatorio |
| start_date | Obrigatorio |
| items | Minimo 1 item |
Regras de Negocio
Bloqueio de Movimentacoes
Durante conciliacao em andamento:
- Movimentacoes dos produtos podem ser bloqueadas
- Ou registradas separadamente para ajuste posterior
Aprovacao
Conciliacoes com divergencia acima de limite requerem:
- Aprovacao de supervisor
- Justificativa obrigatoria
Historico
Todas as conciliacoes ficam registradas com:
- Data/hora
- Usuario responsavel
- Itens e ajustes
- Valor total de ajuste
Agendamento
Conciliacao Periodica
| Frequencia | Recomendacao |
|---|---|
| Diaria | Produtos de alto giro |
| Semanal | Produtos de medio giro |
| Mensal | Produtos de baixo giro |
| Trimestral | Inventario geral |
Permissoes
| Acao | Descricao |
|---|---|
| Criar | Iniciar conciliacao |
| Contar | Registrar contagens |
| Revisar | Revisar divergencias |
| Aprovar | Aprovar conciliacao |
| Aplicar | Aplicar ajustes |
| Cancelar | Cancelar conciliacao |