Skip to main content

p_SALES_MOVIMENTOPERIODO

Retorna o movimento consolidado da rede (todos os canais, marcas e lojas) para um período, comparado com um período anterior.

É o nível mais alto da família de Movimento — não possui filtros de dimensão, apenas período e comparação.

Assinatura​

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

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

Exemplos​

Acumulado do mês contra o mesmo mês do ano anterior​

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

Retorna uma linha com o total do período.

Evolução diária do mês contra o mês anterior​

exec dbo.p_SALES_MOVIMENTOPERIODO
     @Tipo            = 'EXTRACT',
     @DataInicio      = '2026-01-01',
     @DataFim         = '2026-01-31',
     @ComparacaoTipo  = 'MES_ANTERIOR',
     @ComparacaoValor = 1;

Retorna uma linha por dia, com a coluna adicional DATE_LY indicando o dia comparativo.

Comparação com um período customizado​

exec dbo.p_SALES_MOVIMENTOPERIODO
     @Tipo         = 'RANGE',
     @DataInicio   = '2026-11-20',
     @DataFim      = '2026-11-30',
     @DataInicioLY = '2025-11-21',
     @DataFimLY    = '2025-12-01';

Útil para comparar eventos móveis, como Black Friday.

Colunas retornadas​

Identificação do período​

ColunaTipoDescrição
DATEdateEm RANGE, corresponde a @DataFim. Em EXTRACT, é o dia da linha
DATE_LYdateDia comparativo. Somente em EXTRACT
TYPEINTERVALchar(1)Sempre D (base diária)
DATESINTERVALvarcharIntervalo TY formatado (dd/MM/yyyy • dd/MM/yyyy)
DATESINTERVAL_LYvarcharIntervalo LY formatado
DAYNAMEvarcharLegado — retorna vazio neste nível
HOLIDAYNAMEvarcharLegado — retorna vazio neste nível
LASTUPDATEdatetimeÚltima atualização dos dados de movimento do período TY

Indicadores do período (TY)​

ColunaDescrição
TOTAL_TYVenda bruta total do período
TICKETS_TYQuantidade de tickets (cupons/vendas)
PRODUCTS_TYQuantidade de produtos vendidos
CUSTOMERS_TYClientes identificados
CUSTOMERS_NEW_TYClientes novos
CUSTOMERS_RETURN_TYClientes recorrentes
TOTAL_TARGET_TYMeta total do período
TOTAL_TARGET_PARTIAL_TYMeta parcial até a hora atual do dia, quando disponível. Caso contrário, é igual à meta total
RETURNS_DAY_TYValor de devoluções
RETURNS_TKT_TYTickets de devolução
RETURNS_PROD_TYProdutos devolvidos
DISCOUNT_DAY_TYValor de descontos
FREIGHT_DAY_TYValor de frete
TOTALORDERDAY_TYValor total de pedidos

Indicadores do período comparativo (LY)​

Espelham os indicadores TY, com o sufixo _LY:

TOTAL_LY, TICKETS_LY, PRODUCTS_LY, CUSTOMERS_LY, CUSTOMERS_NEW_LY, CUSTOMERS_RETURN_LY, TOTAL_TARGET_LY, TOTAL_TARGET_PARTIAL_LY, RETURNS_DAY_LY, RETURNS_TKT_LY, RETURNS_PROD_LY, DISCOUNT_DAY_LY, FREIGHT_DAY_LY, TOTALORDERDAY_LY.

Colunas legado​

Existem por compatibilidade com o contrato do aplicativo, retornam sempre zero ou vazio neste nível e serão removidas futuramente:

TICKETS_CANCELED_TY, TICKETS_CANCELED_LY, DISCOUNT_DAY_TY2, DISCOUNT_DAY_TY3, DISCOUNT_DAY_LY2, DISCOUNT_DAY_LY3, MARGIN_TY, MARGIN_LY, TOTAL_PARTIAL_LY, STOREFLOW, PEDIDOSOMNI_TY, STOCK_TY, SALES_PERIOD_TY, SALES_PERIOD_LY, OPERATIONS_TY, OPERATIONS_LY, AVG_TIME_ATTEND_TY, AVG_TIME_ATTEND_LY, TOTAL_HOURS_TY, TOTAL_HOURS_LY.

LEGADO

Não construa cálculos sobre as colunas legado. Elas não representam informação e serão descontinuadas.

Boas práticas​

  • Venda líquida: TOTAL_TY é o valor bruto. Para obter o líquido, subtraia as devoluções:

    TOTAL_TY - RETURNS_DAY_TY as VENDA_LIQUIDA_TY
    TOTAL_LY - RETURNS_DAY_LY as VENDA_LIQUIDA_LY

  • Períodos longos: prefira RANGE quando precisar apenas do total; o EXTRACT retorna uma linha por dia e é mais custoso.

  • Atingimento de meta: use TOTAL_TARGET_PARTIAL_TY para acompanhamento durante o dia e TOTAL_TARGET_TY para o fechamento.

  • Conferência com o app: os números devem bater exatamente com a tela de Movimento do aplicativo para o mesmo período e a mesma comparação.