Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Objetivo:

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

Descrição do PROJETO:

  • Este Projeto tem como objetivo trazer todos os clientes Mercado Interno e Externo que estão cadastrados no SAP HANA e sua hierarquia de venda (Sales Force/SAP)

  • Data de validade da hierarquia do cliente do SAP = ou menor que 31-12-9999

  • Os dados são vivos ou seja retratam a atual hierarquia do momento

Escopo:

  • Objetivo é montar uma tabela física de consulta da hierarquia do cliente que primeiramente será atualizada todo dia as 07h da manhã.

  • Não são considerados todos os clientes do SAP somente os do setor de atividade ('LS','MS','LF','HY','01','99)

  • Temos uma coluna que trás o código do cliente_ecc (para os que migram pro hana)

Pessoas, processos e sistemas impactados:

  • Comercial : Administração Comercial, Customer Excellence, Dados IPDT

  • Logística Deca

Info

Incluir campos de motivo da inativação que vem do Sales Force :

Jira Legacy
serverSystem Jira
serverId3c628e15-bebb-3e5d-b7fa-7d519db57e40
keyADECA-639

Tarefa Jira de Desenvolvimento

Jira Legacy
serverSystem Jira
serverId3c628e15-bebb-3e5d-b7fa-7d519db57e40
keyADECA-641

Script SQL utilizado na migração

View file
nameSTAGE_LARGE_TB_HIERARQUIA_CLIENTE.py

https://github.com/dexco-brasil/analytics-databricks-etl-diario/blob/master/Workspace/analytics-etl-diario/etl-large/STAGE_LARGE_TB_HIERARQUIA_CLIENTE.py

 Origem

  • sap.KNVV > dados_area_vendas

  • sap.T188T > sd_grupo_preco_cliente

  • sap.TVTWT > canal_distribuicao

  • sap.KNA1 > dados_gerais

  • sap.T077X > contas

  • sap.T005T > paises

  • sap.T005U > estados

  • sap.KNVH > hierarquia_cliente

  • sap.KNVP > funcoes_parceiro

  • sap.LFA1 > fornecedor

  • sap.BUT000 > grupo_contas

  • sap.TB004T > grupo_contas_descricao

  • sap.TVGRT > equipe_vendas

  • stage.analytics_prd.t_sfc_hierarquia_venda

Periodicidade Carga

1 x ao dia

Tabela Destino Final

stage.large.tb_hierarquia_cliente

Database em stage

large

Ação DML

INSERT, DELETE e UPDATE

Nome do JOB Databricks:

JOB_STAGE_LARGE

Link do JOB Databricks

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

Agenda de Execução do JOB

Diariamente as 7h da manhã (horário de Brasíla)

Dicionário de Campos

col_name

data_type

comment

codigo_cliente_pai

string

Código do cliente superior

cliente_pai

varchar(35)

Cliente Superior

Nome do cliente superior

codigo_cliente_filho

string

Código do cliente

cliente_filho

varchar(35)

Nome do

Cliente

cliente

tipo_pessoa

string

Se é pesso física ou jurídica

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

cpf_cnpj

string

CPF para pesso Física e CNP para pessoa juródica

Identificação do CPF ou CNPJ conforme tipo_pessoa

codigo_grupo_conta

string

Código do grupo do cliente

grupo_conta

string

Descrição

Especificação do grupo do cliente

status_cliente

string

Se

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

motivo_inativacao

string

O por que cliente foi inativado

Justificativa em caso de inativação (Atualmente informação vazia)

justificativa_inativacao

string

O por que cliente foi inativado

Justificativa em caso de inativação (Atualmente informação vazia)

data_inativacao

string

data

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

codigo_bloqueio

varchar(2)

Bloqueio de

ordem

Ordem para cliente (área de vendas)

motivo_bloqueio

string

Motivo do bloqueis

Justificativa em caso de bloqueio (regra conforme área de vendas)

codigo_canal_distribuicao

varchar(2)

Código do

Canal

canal de distribuição

canal_distribuicao

string

Canal

Identificação do canal de distribuição

codigo_setor_atividade

string

Código do setor de atividade

codigo_organizacao_venda

varchar(4)

Organização

Código da organização de vendas

mercado

string

Se é mercado intero ou clinete

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

empresa

string

Se setor de atividae for  (

De acordo com codigo_setor_atividade, se for 'LS', 'MS', 'HY'

) = DECA, Se for  (

= Deca; 'LF'

) = DURAFLOOR e se for (

= Durafloor; '01', '99'

)

= RC

codigo_grupo_preco

varchar(2)

Grupo

Codigo do grupo de preço do cliente

grupo_preco

string

Identifica o

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

codigo_pais

varchar(3)

Código chave do País

pais

string

Nome

Especificação do País

codigo_estado

string

Sigla da UF

estado

string

Nome

Especificação da UF

cidade

varchar(35)

Local

bairro

varchar(35)

Bairro

endereco

varchar(35)

Logradouro (Rua e

Nº)

cep

varchar(10)

Código

postal

Postal

codigo_equipe_venda

varchar(3)

Código da

Equipe

equipe de vendas

equipe_venda

string

Equipe

Especificação da equipe de vendas

codigo_escritorio_venda

varchar(4)

Código do

Escritório

escritório de vendas

canal_1

string

Nome da gerencia Nacional conforme  Sales Force

Especificação da gerência nacional conforme Salesforce

canal_2

string

Nome

Especificação do

Escritório

escritório de

Vendasc

vendas conforme

Sales Force

Salesforce

codigo_vendedor_representante

string

Código do parceiro ZB ou ZV

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

vendedor_representante

string

Nome do parceiro ZB ou ZV

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

codigo_funcao_parceiro

varchar(2)

Função do parceiro se é ZB ou ZV

Código de função dos parceiros, caso 'ZV' = Vendedor; caso 'ZB' = Representante.

funcao_parceiro

string

Se é representante ou vendedor

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

supervisor

string

Nome

Especificação do Supervisor

conforme  Sales Force

conforme Salesforce

codigo_coordenador

string

Código do

Coordenador  conforme  Sales Force

coordenador conforme Salesforce

coordenador

string

Nome

Especificação do coordenador conforme

Sales Force

Salesforce

codigo_gerente

string

Código do gerente conforme

Sales Force

Salesforce

gerente

string

Nome

Especificação do gerente

confofme Sales Force

conforme Salesforce

codigo_gerente_nacional

string

Código do gerente nacional conforme

Sales Force

Salesforce

gerente_nacional

string

Nome

Especificação do gerente nacional conforme

Sales Force

Salesforce

diretor

string

Nome

Especificação do

Diretor

diretor conforme

Sales Force

Salesforce

data_atualizacao

date

data em que o registro foi inserido na

Data de atualização da tabela

data_cadastro

date

Data

do cadastro do cliente 

em que o cliente foi cadastrado conforme SAP

zona_transporte

varchar(15)

Domicílio

Especificação do domicílio fiscal

marcado_eliminacao_vendas

varchar(1)

Marcação

p/eliminar -

central para eliminação do cliente (nível Vendas e Distribuição)

marcado_eliminacao_geral

varchar(1)

Marcação central para eliminação do registro mestre

cpf_cnpj_cliente_pai

string

Identificação do CPF

para pesso Física e CNP para pessoa juródica do cliente

ou CNPJ para o cliente_pai

codigo_cliente_ecc

string

Se

Em caso de cliente

é

migrado,

traz o código dele no ecc

especifica o código de cliente do ECC

codigo_categoria_cliente

varchar(3)

Código da categoria do cliente

categoria_cliente

varchar(20)

Complementa o grupo_preco com a categoria do cliente

Excel
nameAMOSTRA CAMPOS CLIENTES.xlsx

Histórico de Modificações:

Versão

Nome

Função e Área

Data

Modificação

V1

Raquel Jung Mateus

PO - Analytics

08/08/2023

Documentação das regras de negócio

V2

Carlos Henrique D Avila Fortes

Analista de Dados - Analytics

09/10/2023

Inclusão do dicionário de dados