p_SALES_CLUSTERMOVIMENTOPERIODO

Retorna o movimento por cluster, comparado com um período anterior.

Cluster é um agrupamento livre de lojas definido na plataforma (por exemplo: regional, supervisor, grupo de shoppings). Uma mesma loja pode pertencer a mais de um cluster.

---

Assinatura

exec dbo.p_SALES_CLUSTERMOVIMENTOPERIODO
     @Tipo            = 'RANGE',        -- RANGE | EXTRACT
     @DataInicio      = '2026-01-01',
     @DataFim         = '2026-01-31',
     @Cluster         = null,
     @ComparacaoTipo  = 'ANO_ANTERIOR',
     @ComparacaoValor = 1,
     @DataInicioLY    = null,
     @DataFimLY       = null;

Filtro	Tipo	Descrição
@Cluster	varchar(50)	Código do cluster. Quando NULL, retorna todos os clusters ativos

Os demais parâmetros seguem o contrato descrito em Visão geral.

---

Granularidade do retorno

@Tipo	Linhas retornadas
RANGE	Uma linha por cluster
EXTRACT	Uma linha por cluster e por dia

Somatório entre clusters

Como uma loja pode estar em mais de um cluster, não some as linhas deste retorno para obter o total da rede. Para o consolidado, use p_SALES_MOVIMENTOPERIODO.

---

Colunas retornadas

Contrato idêntico ao de p_SALES_MOVIMENTOPERIODO, acrescido das colunas de identificação:

Coluna	Tipo	Descrição
CLUSTER	varchar	Código do cluster
CODE	varchar	Mesmo valor de CLUSTER (legado)
CLUSTER_NAME	varchar	Nome do cluster
ORDER	int	Legado — retorna sempre 1

Neste nível, algumas colunas listadas como legado no contrato base são preenchidas com valores reais:

Coluna	Descrição
TICKETS_CANCELED_TY / TICKETS_CANCELED_LY	Tickets cancelados
MARGIN_TY / MARGIN_LY	Margem
DISCOUNT_DAY_TY2 / DISCOUNT_DAY_LY2	Desconto — segunda categoria
DISCOUNT_DAY_TY3 / DISCOUNT_DAY_LY3	Desconto — terceira categoria

---

Exemplos

Comparativo entre clusters no mês

exec dbo.p_SALES_CLUSTERMOVIMENTOPERIODO
     @Tipo       = 'RANGE',
     @DataInicio = '2026-01-01',
     @DataFim    = '2026-01-31';

Evolução diária de um cluster

exec dbo.p_SALES_CLUSTERMOVIMENTOPERIODO
     @Tipo       = 'EXTRACT',
     @DataInicio = '2026-01-01',
     @DataFim    = '2026-01-31',
     @Cluster    = 'REGIONAL_SUL';