Processo DATA_PREP (large.tb_diario_de_vendas)

Objetivo:

Este documento tem como objetivo descrever regras de negócio da tabela final large.tb_diario_de_vendas.

Descrição do PROJETO:

• Este projeto tem como função trazer dados de meta, faturamento, venda e carteira com comparativos de tempo (mês, ano) bem como informações de seus representantes, hierarquia de clientes e produtos

• O surgimento desta tabela veio por meio do projeto DATA_PREP que realizava as mesmas consultas com as regras aplicadas utilizando o Tableau Prep como sistema base.

Pessoas, Processos e Sistemas Impactados:

• Comercial : Administração Comercial, Customer Excellence, IPDTV (núcleo de Dados)

Sobre tipo_indicador:

• QUANTIDADE: Volume

• VMA: Valor de Receita Líquida + 30%;

• ROL: Valor de Receita Líquida;

• USD: Valor de Receita Dólar;

Para todas as regras abaixo, deve considerar as regras acima conforme o tipo_indicador ao realizar a consulta.

Em relação às colunas de meses:

• D1: Valor D-1

• 12M: Soma de 12 meses atrás até o último dia do mes_referencia anterior

• 6M: Soma de 6 meses até o último dia do mes_referencia anterior

• 3M: Soma de 3 meses até o último dia do mes_referencia anterior

• MA: Soma do mes_referencia anterior

• AA: Soma do valor no ano anterior do mesmo mes_referencia

• MR: Soma do valor do mes_referencia

Sobre Venda:

• Venda BRUTA:

  • Considera quando status_ordem_venda da resultado comercial for VENDA, CINI ou EXPORTAÇÃO;

  • flag_venda_total = 1 (entra pro resultado de venda);

• Venda LÍQUIDA:

  • flag_venda_total = 1 (entra pro resultado de venda);

  • Traz a soma conforme o período da coluna (12 meses, 6 meses, 3 meses, mês anterior, ano anterior e mês referência) até a data_competencia;

• Para CINI, EXPORTAÇÃO, DEVOLUÇÃO e CANCELAMENTO:

  • flag_venda_total = 1 (entra pro resultado de venda);

Sobre Faturamento:

• Faturamento BRUTO:

  • Considera quando status_ordem_venda da resultado comercial for FATURAMENTO ou EXPORTAÇÃO;

  • flag_faturamento_total = 1 (entra pro resultado de faturamento);

• Faturamento LÍQUIDO:

  • flag_faturamento_total = 1;

  • Traz a soma conforme o período da coluna (12 meses, 6 meses, 3 meses, mês anterior, ano anterior e mês referência) até a data_competencia;

Sobre Carteira:

• Carteira Atual:

  • Considera quando o status da carteira é “CARTEIRA”, “LIMBO, “LIMBO PROGRAMADO” e “LIMBO PROGRAMADO”, onde o mês da data desejada de venda seja até a data atual;

• Carteira Futura:

  • Considera quando o status da carteira é “CARTEIRA”, “LIMBO, “LIMBO PROGRAMADO” e “LIMBO PROGRAMADO”, onde o mês da data desejada de venda seja após a data atual;

• Carteira Bloqueada:

  • Considera o status de carteira “Crédito” e “Bloqueio Adm.”;

• Carteira Remetido:

  • Considera o status de carteira “Remetido”;

Sobre Carteira (RC):

• Tipo_indicador:

  • Quantidade: Quantidade Pendente;

  • ROL: Valor pendente;

• Carteira Atual:

  • Considera quando o status de Carteira é “Carteira Livre” onde a data desejada de remessa seja até a data atual;

• Carteira Futura:

  • Considera o status de “Carteira Livre” onde a data desejada de remessa ;

• Carteira Bloqueada:

  • Considera o status de carteira “Crédito”, “Bloqueio Adm.” e “Bloqueio OV”;

• Carteira Remetido:

  • Considera o status “Remetido”;

• Carteira Alocado/Confirmado:

  • Considera o status “Alocado/Confirmado”;

Tarefa Jira de Desenvolvimento

https://dtxlab.atlassian.net/jira/software/projects/ADECA/boards/455?selectedIssue=ADECA-730

Script SQL utilizado na migração

Open

https://github.com/dexco-brasil/analytics-databricks-deca/blob/master/Workspace/analytics-deca-hydra/DATA_PREP/DIARIO_VENDAS.py

Origem

large.tb_resultado_comercial
large.tb_hierarquia_cliente
large.tb_metas_comercial_hierarquia_produto
large.tb_produto
stage.analytics.dim_data
analytics_prd.tb_carteira

Periodicidade Carga

1x ao dia

Tabela Destino Final

stage.large.tb_diario_de_vendas

Database em stage

large

Ação DML

INSERT

Nome do JOB Databricks:

JOB_DECA_ETL_DATA_PREP

Link do JOB Databricks

https://dbc-1d7378f1-3eb3.cloud.databricks.com/?o=3038895363325901#job/585719296262514

Agenda de Execução do JOB

Diariamente após a execução do JOB_STAGE_LARGE

tipo_indicador

string

Especifica o tipo de indicador

codigo_produto

string

Código do material

codigo_canal_distribuicao

string

Código do canal de distribuição

codigo_cliente_filho

string

Código do cliente

codigo_setor_atividade

string

Código do setor de atividade

codigo_organizacao_venda

string

Código da organização de vendas

mes_referencia

date

Data de competência

vendedor_representante

string

Especificação do Vendedor ou Representante conforme codigo_funcao_parceiro. Em caso de nulo, segue codigo_escritorio_venda na relação 'SA01' = Assistência Técnica; 'VI02' e 'OP01' = Clientes Especiais; 'VI01' = Clientes B2B; 'DJ01' = Clientes Baixados

supervisor

string

Especificação do Supervisor conforme Salesforce

coordenador

string

Especificação do coordenador conforme Salesforce

gerente

string

Especificação do gerente conforme Salesforce

gerente_nacional

string

Especificação do gerente nacional conforme Salesforce

diretor

string

Especificação do diretor conforme Salesforce

funcao_parceiro

string

Especificação da função conforme codigo_funcao_parceiro. Em caso de nulo, segue codigo_escritorio_venda na relação 'SA01' = Assistência Técnica; 'VI02' e 'OP01' = Clientes Especiais; 'VI01' = Clientes B2B; 'DJ01' = Clientes Baixados

codigo_vendedor_representante

string

Identificação do código do Vendedor ou Representante conforme codigo_funcao_parceiro.

canal_2

string

Especificação do escritório de vendas conforme Salesforce

canal_1

string

Especificação da gerência nacional conforme Salesforce

equipe_venda

string

Especificação da equipe de vendas

bairro

string

Bairro

cidade

string

Local

estado

string

Especificação da UF

pais

string

Especificação do País

grupo_preco

string

Especificação do grupo de preço do cliente

mercado

string

Especificação de Mercado Interno ou Externo (em caso de Exportação)

status_cliente

string

Especificação se o cliente é ativo ou inativo (Atualmente informação vazia)

cpf_cnpj

string

Identificação do CPF ou CNPJ conforme tipo_pessoa

tipo_pessoa

string

Especificação de Pessoa Física ou Jurídica

cliente_filho

string

Nome do cliente

codigo_cliente_pai

string

Código do cliente superior

data_inativacao

timestamp

Data em que a inativação foi realizada (Atualmente informação vazia)

data_cadastro

timestamp

Data em que o cliente foi cadastrado conforme SAP

unidade_medida_basica

string

Unidade de medida básica do produto

conversor

string

Caso empresa = 'RC', união das informações tipologia + formato_comercial + acabamento

tipologia

string

Caso empresa = 'RC', hierarquia 2 do produto

tipo_produto

string

(Atualmente informação vazia)

categoria

string

Especificação da categoria do produto

segmento

string

Especificação do segmento conforme codigo_segmento onde 'PE' = PEÇAS ESPECIAIS; 'PF' = PEQUENO FMT; 'MF' = MÉDIO FMT; 'GF' = GRANDE FMT

tamanho

string

Especificação do tamanho da peça

status_produto

string

Especificação se o produto é ativo ou não

ean

string

Sequência númerica que faz parte do código de barras

produto

string

Especificação do material

fabrica

string

Especificação do parque fabril do material

empresa

string

De acordo codigo_setor_atividade, se for 'LS', 'MS', 'HY' = Deca; 'LF' = Durafloor; '01', '99' = RC

faturamento_liquido_mr

float

Total de faturamento líquido do mês conforme mes_referencia

faturamento_liquido_aa

float

Total de faturamento líquido do mesmo mês no ano anterior

faturamento_liquido_ma

float

Total de faturamento líquido do mês anterior

faturamento_liquido_03m

float

Valor acumulado de faturamento líquido dos últimos 3 meses

faturamento_liquido_06m

float

Valor acumulado de faturamento líquido dos últimos 6 meses

faturamento_liquido_12m

float

Valor acumulado de faturamento líquido dos últimos 12 meses

venda_liquida_mr

float

Total de venda líquida do mês conforme mes_referencia

venda_liquida_aa

float

Total de venda líquida do mesmo mês no ano anterior

venda_liquida_ma

float

Total de venda líquida do mês anterior

venda_liquida_03m

float

Valor acumulado de venda líquida dos últimos 3 meses

venda_liquida_06m

float

Valor acumulado de venda líquida dos últimos 6 meses

venda_liquida_12m

float

Valor acumulado de venda líquida dos últimos 12 meses

faturamento_bruto_mr

float

Valor de faturamento bruto do mês, conforme mes_referencia

cancelamento_mr

float

Valor de cancelamento do mês, conforme mes_referencia

venda_bruta_mr

float

Valor de venda bruta do mês, conforme mes_referencia

devolucao_mr

float

Valor de devolucação do mês, conforme mes_referencia

exportacao_mr

float

Valor de exportação do mês, conforme mes_referencia

cini_mr

float

Valor de CINI do mês, conforme mes_referencia

venda_liquida_d1

float

Valor de Venda Líquida D-1

venda_bruta_d1

float

Valor de Venda Bruta D-1

meta_poa_mr

float

Valor de Meta POA do mês, conforme mes_referencia

meta_pev_mr

float

Valor de Meta PEV do mês, conforme mes_referencia

carteira_atual

decimal(38,3)

Valor de Carteira Atual considerando status 'Carteira', 'Limbo', 'Limbo Programado' e 'Programado'

carteira_futura

decimal(38,3)

Valor de Carteira Futura quando a data desejada de remessa é maior que o mês atual para RC / até o próximo mês para os demais

carteira_bloqueada

decimal(38,3)

Valor de Carteira quando status for 'Bloqueio Adm', 'Bloqueio OV' e 'Crédito para RC / 'Crédito' e 'Bloqueio Adm.' para demais

carteira_remetido

decimal(38,3)

Valor de Carteira quando status for Remetido

meta_rvv_mr

float

Valor de Meta de RVV do mês, conforme mes_referencia

meta_sop_mr

float

Valor de Meta de SOP do mês, conforme mes_referencia

dt_atualizacao

timestamp

Data de atualização da tabela

Versão

Nome

Função e Área

Data

Modificação

V1

Carlos Henrique D Avila Fortes

Analista de Dados - Analytics

Documentação das regras de negócio