aegro-reconciliacao-estoque
GitHub识别并解释系统库存、现场活动消耗与财务记录之间的差异，用于审计、投入品控制和农季结算。通过对比理论库存与实际库存，定位未登记入库、出库或消耗不一致等问题。
Trigger Scenarios
Install
npx skills add NeverSight/learn-skills.dev --skill aegro-reconciliacao-estoque -g -y
SKILL.md
Frontmatter
{
"name": "aegro-reconciliacao-estoque",
"version": "0.5.1",
"description": "Identificar e explicar divergencias entre estoque fisico, atividades e financeiro"
}
Reconciliacao de Estoque
Objetivo
Identificar e explicar divergencias entre o estoque registrado no sistema, o consumo em atividades de campo e os lancamentos financeiros. Essencial para auditoria, controle de insumos e fechamento de safra.
Quando Usar
- Cliente reclama "estoque nao bate"
- Antes de fechamento de safra
- Auditoria periodica de insumos
- Compra registrada mas estoque nao aumentou
- Aplicacao feita mas estoque nao baixou
Pre-requisitos de Conhecimento
Para detalhes dos comandos e regras de negocio:
/aegro-estoquista-- locais, itens, movimentacoes, entradas, saidas/aegro-agronomo-- atividades, realizacoes (consumo de insumos)
Formula de Reconciliacao
Estoque Teorico = Estoque Inicial
+ Entradas (compras, devolucoes)
+ Transferencias recebidas
- Consumo em atividades (realizacoes)
- Transferencias enviadas
- Saidas manuais (perdas, ajustes)
DIVERGENCIA = Estoque Atual (sistema) - Estoque Teorico
Se divergencia = 0, estoque esta conciliado. Se divergencia != 0, investigar causas.
Sequencia de Passos
1. Mapear locais de estoque
Listar armazens/depositos e guardar location_keys.
2. Identificar insumo alvo
Listar elementos por categoria (DEFENSIVE, FERTILIZER, SEED). Se usuario especificou insumo, filtrar por nome. Priorizar insumos criticos (alto valor ou uso frequente).
3. Verificar posicao atual
Buscar itens em estoque para o elemento selecionado. Registrar quantidade atual por local e unidade de medida.
Sinal de alerta: Quantidade negativa indica problema de registro.
4. Levantar historico de movimentacoes
Buscar logs de estoque no periodo da safra e classificar:
| Tipo de movimentacao | Direcao |
|---|---|
| MANUAL_ENTRY | Entrada (compras) |
| MANUAL_REMOVAL | Saida (perdas, ajustes) |
| TRANSFER | Entrada ou saida (entre locais) |
| ACTIVITY_CONSUMPTION | Saida (uso em campo) |
Calcular totais de entrada e saida.
5. Cruzar com consumo em atividades
Buscar realizacoes no periodo e filtrar as que usaram o elemento. Calcular total consumido em atividades. Comparar com ACTIVITY_CONSUMPTION dos logs.
6. Calcular divergencia
Aplicar a formula de reconciliacao e quantificar a divergencia.
7. Investigar causas (se divergencia != 0)
Listar atividades que consomem o insumo (APPLICATION, FERTILIZATION, SOWING). Verificar:
- Atividade planejada mas sem realizacao
- Realizacao registrada mas sem baixa de estoque
- Quantidade aplicada vs quantidade baixada
Como Identificar Divergencias
| Divergencia | Significado | Causa mais provavel | Onde investigar |
|---|---|---|---|
| Atual > Teorico | Estoque "sobrando" | Entrada nao registrada | NFs de compra pendentes |
| Atual < Teorico | Estoque "faltando" | Saida nao registrada | Realizacoes sem baixa |
| Diverge por local | Deslocamento fisico | Transferencia nao feita | Movimentacoes entre locais |
| Quantidade negativa | Erro de registro | Saida antes da entrada | Ordem cronologica dos lancamentos |
Diagnostico rapido:
- Se diferenca corresponde a uma realizacao especifica, provavelmente e baixa nao registrada
- Se diferenca corresponde a um valor de NF, provavelmente e entrada nao registrada
- Se diferenca e pequena e difusa, pode ser arredondamento ou perda natural
Formato de Resposta
## Reconciliacao de Estoque: {{nome_insumo}}
### Posicao Atual
| Local | Quantidade | Unidade |
|-------|------------|---------|
| Armazem Central | 150 | L |
| Deposito Campo | 30 | L |
| **Total** | **180 L** | |
### Movimentacoes ({{inicio}} a {{fim}})
| Tipo | Quantidade |
|------|------------|
| Entradas (compras) | +500 L |
| Consumo em aplicacoes | -280 L |
| Ajustes/perdas | -20 L |
| **Saldo movimentado** | **+200 L** |
### Reconciliacao
| Item | Valor |
|------|-------|
| Estoque inicial | 50 L |
| + Movimentacoes | +200 L |
| = **Estoque teorico** | **250 L** |
| Estoque atual | 180 L |
| **DIVERGENCIA** | **-70 L** |
### Causa Provavel
- Aplicacao em 15/03 consumiu 50L sem baixa de estoque
### Acoes Recomendadas
1. Verificar realizacao de 15/03
2. Conferir fisicamente o estoque
3. Registrar ajuste se confirmado
Proximos Workflows
| Situacao | Proximo workflow |
|---|---|
| Corrigir lancamentos financeiros | /aegro-lancamento-financeiro |
| Verificar aplicacoes | /aegro-monitoramento-pragas |
| Visao geral da fazenda | /aegro-visao-geral |
| Fechar safra | /aegro-fechamento-safra |
Version History
- e0220ca Current 2026-07-05 23:34
