p_SALES_CANALMARCALOJAVENDEDORMOVIMENTOPERIODO

Retorna o movimento por vendedor, dentro de canal, marca e loja, comparado com um período anterior.

É o nível mais detalhado da família de Movimento.

---

Assinatura

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

Filtro	Tipo	Descrição
@Canal	varchar(120)	Código do canal. Quando NULL, retorna todos
@Marca	varchar(120)	Código da marca. Quando NULL, retorna todas
@Loja	varchar(15)	CNPJ da loja (somente dígitos). Quando NULL, retorna todas
@CodVendedor	int	Código agrupador do vendedor. Quando NULL, retorna todos

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

---

Agrupamento de vendedores

Um mesmo vendedor pode ter cadastros distintos em lojas diferentes. Esta procedure consolida os cadastros pelo código agrupador, e associa o resultado ao canal e à loja principal do vendedor.

Consequências práticas:

• SELLER é o código agrupador, e não o código de cadastro em cada loja;
• SOCIALID e CHANNEL refletem a loja/canal principal do vendedor, mesmo que parte da venda tenha ocorrido em outra loja;
• @CodVendedor também deve ser informado com o código agrupador.

Desempenho

Este é o nível mais pesado da família. Sempre que possível, informe @Marca — é o filtro aplicado mais cedo no processamento.

---

Granularidade do retorno

@Tipo	Linhas retornadas
RANGE	Uma linha por vendedor (dentro de canal + marca + loja)
EXTRACT	Uma linha por vendedor e por dia

---

Colunas retornadas

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

Coluna	Tipo	Descrição
CHANNEL	varchar	Código do canal
CHANNEL_NAME	varchar	Nome do canal
BRAND	varchar	Código da marca
BRAND_NAME	varchar	Nome da marca
SOCIALID	varchar	CNPJ da loja
STORE_NAME	varchar	Nome da loja
SELLER	int	Código agrupador do vendedor
SELLERNAME	varchar	Nome do vendedor

Colunas legado adicionais neste nível

Além das colunas legado já listadas no contrato base, CUSTOMERS_NEW_TY, CUSTOMERS_RETURN_TY, CUSTOMERS_NEW_LY e CUSTOMERS_RETURN_LY retornam sempre zero neste nível.

---

Exemplos

Ranking de vendedores de uma marca no mês

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

Evolução diária de um vendedor

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