O estoque é tratado como uma série temporal. Uma fotografia atual responde “o que está disponível agora”; o histórico de fotografias permite explicar ruptura, cobertura e campanhas que promoveram itens indisponíveis.
Uma linha por SKU × local de estoque × instante da fotografia.
O local pode representar centro de distribuição, loja, seller, dark store ou outro nó logístico. Use um identificador estável e declare se o saldo é físico, vendável ou calculado por canal.
| Conceito lógico | Obrigatório | Descrição |
|---|---|---|
sku_id |
Sim | Chave compatível com catálogo e itens de pedido |
location_id |
Sim | Armazém, loja, seller ou nó logístico |
snapshot_at |
Sim | Data e hora da fotografia, com fuso documentado |
on_hand_quantity |
Sim | Quantidade física conhecida pela origem |
reserved_quantity |
Sim | Quantidade comprometida e ainda não baixada |
available_quantity |
Sim | Quantidade vendável segundo a regra da origem |
in_transit_quantity |
Recomendado | Quantidade em movimentação ou recebimento |
next_replenishment_at |
Opcional | Previsão disponível na fonte, sem inferência da Audt |
lead_time |
Opcional | Prazo e unidade definidos pelo sistema de origem |
inventory_status |
Recomendado | Estado normalizado, como disponível, baixo ou indisponível |
Fotografias são preferidas para o primeiro onboarding porque simplificam reconciliação e reprocessamento. Preserve pelo menos uma fotografia diária; operações sensíveis à ruptura podem usar intervalos menores.
Movimentos podem complementar a análise quando trazem identificador, tipo, quantidade, data de competência e referência do evento. Se apenas movimentos estiverem disponíveis, precisamos também de um saldo inicial confiável e de uma política para eventos atrasados ou cancelados.
Para cada location_id, informe:
- tipo e nome do local;
- estado, região ou cluster operacional quando necessário;
- status de atividade;
- canais e modalidades de fulfillment atendidos;
- seller responsável, quando aplicável.
Endereço completo não é necessário para o escopo padrão. Use localização agregada suficiente para a análise aprovada.
| Controle | O que validar |
|---|---|
| Unicidade | Uma linha por SKU, local e instante |
| Completude | Todos os SKUs ativos e locais em escopo aparecem na carga |
| Domínio | Quantidades seguem a regra de sinal e casas decimais acordada |
| Atualidade | A fotografia chega dentro do SLA definido |
| Catálogo | Todo SKU possui correspondência no catálogo ou exceção registrada |
| Reconciliação | Totais por local e data correspondem ao relatório da origem |
| Continuidade | Lacunas e quedas abruptas são sinalizadas, não preenchidas silenciosamente |
Antes da primeira carga, confirme:
- quais locais e sellers entram no escopo;
- qual saldo representa disponibilidade comercial;
- frequência e horário de fechamento;
- retenção histórica disponível;
- tratamento de saldo negativo, bloqueado ou de segurança;
- comportamento de itens inativos e locais fechados;
- reprocessamento de fotografias corrigidas.
Com essas decisões registradas, a Audt pode relacionar disponibilidade com Catálogo de produtos, Pedidos e investimentos de mídia sem criar uma definição paralela de estoque.