p_SALES_MARCAMOVIMENTOPERIODO

Retorna o movimento por marca, consolidando todos os canais, comparado com um período anterior.

---

Assinatura

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

Filtro	Tipo	Descrição
@Marca	varchar(120)	Código da marca. Quando NULL, retorna todas as marcas

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

---

Granularidade do retorno

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

---

Colunas retornadas

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

Coluna	Tipo	Descrição
BRAND	varchar	Código da marca
BRAND_NAME	varchar	Nome da marca (com emoji, quando configurado)

Meta neste nível

Neste nível, TOTAL_TARGET_TY e TOTAL_TARGET_PARTIAL_TY retornam o mesmo valor.

---

Exemplos

Total do mês por marca

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

Evolução diária de uma marca

exec dbo.p_SALES_MARCAMOVIMENTOPERIODO
     @Tipo       = 'EXTRACT',
     @DataInicio = '2026-01-01',
     @DataFim    = '2026-01-31',
     @Marca      = 'MARCA_A';