Objetivo: |
Este documento tem como objetivo descrever regras de negócio e de processo das tabelas do schema large:
|
Descrição do PROJETO: |
|
|
|
Descrição das regras de Negócio:
Note |
---|
A venda de ME (mercado externo) foi construída para RC igual a Deca de MI - a partir de setembro 2023 |
...
Descrição das regras de Negócio: | |
|
|
|
|
|
|
Coluna status_ordem_venda = ‘VENDA’
Considera somente Ordens de venda do Mercado Interno
Considera alguns tipos de bloqueios de remessa e faturamento(vide anexo com tipos de bloqueios)
Considera ordens bloqueadas no crédito
Considera ordens do tipo (ZASR, ZRCS, ZAVI, ZAPS, ZMPL, ZVEF, ZVPR, ZNOR, ZNRE)
Não considera na Venda as Ordens Canceladas
|
|
Flag_faturamento_total = 0 (não entra no resultado do Faturamento)
Flag_venda_total= 1 (entra pro resultado da Venda)
Flag_venda_total = 2 (vendas intercompany, foi criado com o go live pra não entrar no resultado da Venda)
Flag_venda_total =3 (vendas Inativas, foi criada com o go live pra não entrar no resultado da Venda, é uma flag de vendas Inativas e que tem justificativa do pq deve ser inativada)
Flag_venda_total = 4 (Vendas bloqueadas, foi criada com o go live a pedido da area cliente para considerar alguns tipos de bloqueio de remessa e faturamento, então as que estão dentro da flag 4 são os bloqueios que não entram no resultado.
CANCELAMENTO DECA (LS, MS, HY e LF)
Considera somente Ordens do Mercado Interno e Externo canceladas (com motivo de recusa)
Considera alguns tipos de bloqueios de remessa e faturamento (vide anexo com tipos de bloqueios)
Considera ordens bloqueadas no crédito
Considera ordens do tipo (ZASR, ZRCS, ZAVI, ZAPS, ZMPL, ZVEF, ZVPR, ZNOR, ZNRE)
Data_competencia: Ordens canceladas no mês atual e mês e ano da data desejada de remessa menor que a data de cancelamento e mês e ano da data desejada de remessa menor ou igual que ao mês e ano da data atual
Debita da venda
Flag_faturamento_total = 0 (não entra no resultado do Faturamento)
Flag_venda_total= 1 (entra pro resultado da Venda)
Flag_venda_total = 2 (vendas intercompany, foi criado com o go live pra não entrar no resultado da Venda)
Flag_venda_total =3 (vendas Inativas, foi criada com o go live pra não entrar no resultado da Venda, e que tem justificativa do pq deve ser inativada)
Flag_venda_total = 4 (Vendas bloqueadas, foi criada com o go live a pedido da area cliente para considerar alguns tipos de bloqueio de remessa e faturamento, então as que estão dentro da flag 4 são os bloqueios que não entram no resultado.
CANCELAMENTO RC (Ceusa e Portinari)
Considera somente Ordens do Mercado Interno canceladas (com motivo de recusa)
Data de criação do pedido no SAP para ME
|
|
Data_competencia: Ordens canceladas no mês atual
|
|
|
|
CINI DECA (LS, MS, HY e LF) - CARTEIRA INICIAL
Considera Ordens do Mercado Interno
Considera alguns tipos de bloqueios de remessa e faturamento (vide anexo com tipos de bloqueios)
Considera ordens bloqueadas no crédito
|
|
|
|
|
|
|
|
|
|
Considera Ordens do Mercado Externo
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
FATURAMENTO DECA (LS, MS, HY e LF)
Considera somente Ordens faturadas do Mercado Interno
Usa a fonte homologada da controladoria camada_semantica.acdoca_s4_estrutura_nova
para Hydra Aracaju a partir de 03/2023, demais negócios a partir de 07/2023
Data_competencia :data de faturamento.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Flag_venda_total= 0 (não entra da venda)
|
|
|
|
|
Usamos para RC fontes diferenciadas apenas pra evitar o tratamento dos campos como setor atividade, canal distrubuição etc…Na fonte utilizada em Deca os dados de RC já estão em uma estrutura organizacional futura que não reflete o momento do SAP HANA.
Flag_venda_total= 0 (não entra da venda)
Flag_faturamento_total =1 (entra pro resultado da Faturamento)
Flag_Faturamento_total = 2 (Faturamento intercompany, foi criado com o go live pra não entrar no resultado do faturamento, se quiser ver o faturamento com a Intercompany ai tem usar flag 1 e 2.)
DEVOLUÇÃO DECA (LS, MS, HY e LF)
Considera Ordens faturadas do Mercado Interno e Externo
Usa a fonte homologada da controladoria
camada_semantica.acdoca_s4_estrutura_nova
para Hydra Aracaju a partir de 03/2023, demais negócios a partir de 07/2023Data_competencia :data da devolução
Flag_venda_total= 1 debita da venda
Flag_faturamento_total =1 (entra pro resultado da Faturamento)
Flag_Faturamento_total = 2 (Faturamento intercompany, foi criado com o go live pra não entrar no resultado do faturamento, se quiser ver o faturamento com a Intercompany ai tem usar flag 1 e 2.)
DEVOLUÇÃO RC (Ceusa e Portinari)
Considera Ordens faturadas do Mercado Interno e Externo
Usa a fonte homologada da controladoria
STAGE.camada_semantica.acdoca_margin_s4_hist_rc
01/2023.Data_competencia :data da devolução
Usamos para RC fontes diferenciadas apenas pra evitar o tratamento dos campos como setor atividade, canal distrubuição etc…Na fonte utilizada em Deca os dados de RC já estão em uma estrutura organizacional futura que não reflete o momento do SAP HANA.
Flag_venda_total= 0 para MI não debita da Venda
Flag_venda_total= 1 para ME debita da Venda
Flag_faturamento_total =1 (entra pro resultado da Faturamento)
Flag_Faturamento_total = 2 (Faturamento intercompany, foi criado com o go live pra não entrar no resultado do faturamento, se quiser ver o faturamento com a Intercompany ai tem usar flag 1 e 2.)
ANEXOS
View file | ||
---|---|---|
|
|
|
|
|
ANEXOS
View file | ||
---|---|---|
|
Dicionário de Dados
tb_venda_faturamento | ||
---|---|---|
col_name | data_type | comment |
data_competencia | date | De acordo com status_ordem_venda, para 'VENDA', 'CINI' e 'CANCELAMENTO' segue conforme regras comerciais. Para 'EXPORTAÇÃO', 'FATURAMENTO' e 'DEVOLUÇÃO', especifica a data em que faturou/devolveu. |
empresa | string | De acordo codigo_setor_atividade, se for 'LS', 'MS', 'HY', 'NO' = Deca; 'RC', '01', '99' = RC; 'LF' = Durafloor; 'FL' = Florestal; 'CH' = Painéis |
mercado | string | Especificação de Mercado Interno ou Externo (em caso de Exportação) |
codigo_cliente_filho | string | Código do cliente |
codigo_setor_atividade | varchar(2) | Código do setor de atividade |
codigo_canal_distribuicao | string | Código do canal de distribuição |
codigo_organizacao_venda | varchar(4) | Código da organização de vendas |
numero_ordem_venda | varchar(10) | Código da Ordem de Venda conforme SAP |
numero_item_venda | decimal(18,0) | Sequencial (index) do produto no pedido |
codigo_produto | varchar(40) | Código do material |
numero_pedido_cliente | varchar(20) | Código referência do cliente |
tipo_documento_venda | varchar(4) | Especificação do Tipo de Documento de Venda |
status_ordem_venda | string | Especifica o status da OV, podendo ser 'CANCELAMENTO', 'CINI', 'DEVOLUÇÃO', 'EXPORTAÇÃO', 'FATURAMENTO' ou 'VENDA' |
bloqueio_credito | string | Especifica se houve bloqueio no crédito ou não |
bloqueio_remessa | string | Especifica se houve bloqueio na remessa ou não |
bloqueio_faturamento | string | Especifica se houve bloqueio no faturamento ou não |
nota_fiscal | string | Sequencial do número da nota fiscal |
serie_nota_fiscal | string | Sequencial do número de série da nota fiscal |
numero_fatura | varchar(10) | Sequencial do documento de faturamento |
centro | varchar(4) | Especificação do parque fabril do material |
condicao_pagamento | varchar(4) | Chave de condições de pagamento |
incoterms | varchar(3) | Identificação do tipo de frete (FOB ou CIF) |
valor_bonus | decimal(38,2) | Especificação do valor de comissionamento |
valor_avp | decimal(38,2) | Valor de AVP |
valor_pis | decimal(38,2) | Valor de PIS |
valor_cofins | decimal(38,2) | Valor de COFINS |
valor_ipi | decimal(38,2) | Valor de IPI |
valor_icms | decimal(38,2) | Valor de ICMS |
valor_icmsst | decimal(38,2) | Valor de ICMSST |
valor_receita_liquida | double | Valor de receita líquida |
volume | double | Quantidade do produto seguindo a unidade_medida_venda |
unidade_medida_venda | string | Unidade de medida básica do produto |
valor_receita_dollar | decimal(38,6) | Especificação da receita de DOLLAR em caso de Exportação |
valor_cotacao_dollar | decimal(9,5) | Especificação da cotação de DOLLAR em caso de Exportação |
cd_origem_ordem_venda | varchar(4) | Código da origem da ordem de venda |
origem_ordem_venda | varchar(20) | Especificação da origem da ordem de venda |
cnpj | string | Identificação do CPF ou CNPJ |
flag_venda_total | decimal(18,0) | Caso '0' = Não debita da venda; '1' = entra pro resultado da venda; '2' = vendas intercompany; '3' = vendas desconsideradas; '4' = vendas bloqueadas |
flag_faturamento_total | decimal(18,0) | Caso '0' = Não entra pro resultado do faturamento; '1' = entra pro resultado do faturamento; '2' = faturamento intercompany |
data_emissao_ov | date | Data da emissão da ordem de venda |
motivo_ordem | varchar(40) | Especificação dos motivos de ações conforme status_ordem_venda para as ordens de venda |
valor_mercadoria | decimal(38,2) | Valor base da mercadoria para cálculos de outros impostos |
valor_nota_fiscal | decimal(38,2) | Valor da nota fiscal com ICMSST |
numero_ordem_venda_ecc | string | Em caso de cliente migrado, especifica o número da ordem de venda do ECC |
data_insercao_registro | timestamp | Data em que o registro foi inserido na tabela |
linha_ativa | boolean | Em caso de desconsideração da OV (onde flag_venda_total = 3), será 'FALSE' |
data_inativacao_linha | timestamp | Data da desconsideração da OV |
usuario_solicitante_inativacao | string | Especificação do usuário/e-mail de quem solicitou a desconsideração |
justificativa_inativacao | string | Especificação da justificativa da desconsideração da OV |
valor_receita_bruta | decimal(38,2) | Valor do faturamento_bruto da camada semântica (resultado oficial da empresa) |
quantidade_informativa | double | Quando status_ordem_venda for FATURAMENTO, EXPORTAÇÃO ou DEVOLUÇÃO, traz a quantidade adicional de produtos |
tb_resultado_comercial | ||
---|---|---|
col_name | data_type | comment |
ambiente | string | Especificação do ambiente de uso do produto |
bairro | string | Bairro |
bloqueio_credito | string | Especifica se houve bloqueio no crédito ou não |
bloqueio_faturamento | string | Especifica se houve bloqueio no faturamento ou não |
bloqueio_remessa | string | Especifica se houve bloqueio na remessa ou não |
canal_1 | string | Especificação da gerência nacional conforme Salesforce |
canal_2 | string | Especificação do escritório de vendas conforme Salesforce |
canal_distribuicao | string | Identificação do canal de distribuição |
categoria | string | Especificação da categoria do produto |
centro | string | Especificação do parque fabril do material |
cep | string | Código Postal |
cidade | string | Local |
cliente_filho | string | Nome do cliente |
cliente_pai | string | Nome do cliente superior |
codigo_bloqueio | string | Bloqueio de Ordem para cliente (área de vendas) |
codigo_canal_distribuicao | string | Código do canal de distribuição |
codigo_cliente_filho | string | Código do cliente |
codigo_cliente_pai | string | Código do cliente superior |
codigo_coordenador | string | Código do coordenador conforme Salesforce |
codigo_equipe_venda | string | Código da equipe de vendas |
codigo_escritorio_venda | string | Código do escritório de vendas |
codigo_estado | string | Sigla da UF |
codigo_funcao_parceiro | string | Código de função dos parceiros, caso 'ZV' = Vendedor; caso 'ZB' = Representante. |
codigo_gerente | string | Código do gerente conforme Salesforce |
codigo_gerente_nacional | string | Código do gerente nacional conforme Salesforce |
codigo_grupo_conta | string | Código do grupo do cliente |
codigo_grupo_preco | string | Codigo do grupo de preço do cliente |
codigo_organizacao_venda | string | Código da organização de vendas |
codigo_pais | string | Especificação do País |
codigo_produto | string | Código do material |
codigo_segmento | string | Codificação do segmento conforme tamanho onde 'PE' = PE; 'Pequeno Formato' e 'Micro Formato' = PF; 'Médio Formato' = MF; 'Grande Formato', 'Mega Formato' e 'Lastras' = GF |
codigo_setor_atividade | string | Código do setor de atividade |
codigo_tamanho | string | Codificação conforme tamanho onde 'MCF' = Micro Formato; 'PF' = Pequeno Formato; 'MF' = Médio Formato; 'GF' = Grande Formato; 'MGF' = Mega Formato; 'LTF' = Lastras. |
codigo_vendedor_representante | string | Identificação do código do Vendedor ou Representante conforme codigo_funcao_parceiro. |
condicao_pagamento | string | Chave de condições de pagamento |
conversor | string | Caso empresa = 'RC', união das informações tipologia + formato_comercial + acabamento |
coordenador | string | Especificação do coordenador conforme Salesforce |
cor | string | Especificação da cor do material |
cpf_cnpj | string | Identificação do CPF ou CNPJ conforme tipo_pessoa |
data_competencia | date | De acordo com status_ordem_venda, para 'VENDA', 'CINI' e 'CANCELAMENTO' segue conforme regras comerciais. Para 'EXPORTAÇÃO', 'FATURAMENTO' e 'DEVOLUÇÃO', especifica a data em que faturou/devolveu. |
dcoat | string | (Atualmente informação vazia) |
diretor | string | Especificação do diretor conforme Salesforce |
ean | string | Sequência númerica que faz parte do código de barras |
empresa | string | De acordo codigo_setor_atividade, se for 'LS', 'MS', 'HY', 'NO' = Deca; 'RC', '01', '99' = RC; 'LF' = Durafloor; 'FL' = Florestal; 'CH' = Painéis |
endereco | string | Logradouro (Rua e Nº) |
equipe_venda | string | Especificação da equipe de vendas |
estado | string | Especificação da UF |
fabrica | string | Especificação do parque fabril do material |
formato | string | Caso empresa = 'RC', medidas exatas do produto |
formato_comercial | string | Caso empresa = 'RC', medidas comerciais (arredondadas) do produto |
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 |
gerente | string | Especificação do gerente conforme Salesforce |
gerente_nacional | string | Especificação do gerente nacional conforme Salesforce |
grupo_conta | string | Especificação do grupo do cliente |
grupo_preco | string | Especificação do grupo de preço do cliente |
incoterms | string | Identificação do tipo de frete (FOB ou CIF) |
justificativa_inativacao | string | Justificativa em caso de inativação (Atualmente informação vazia) |
linha_2 | string | Especificação da característica interna do produto de linha |
mercado | string | Especificação de Mercado Interno ou Externo (em caso de Exportação) |
motivo_bloqueio | string | Justificativa em caso de bloqueio (regra conforme área de vendas) |
motivo_inativacao | string | Justificativa em caso de inativação (Atualmente informação vazia) |
nota_fiscal | string | Sequencial do número da nota fiscal |
numero_fatura | string | Sequencial do documento de faturamento |
numero_item_venda | decimal(18,0) | Sequencial (index) do produto no pedido |
numero_ordem_venda | string | Código da Ordem de Venda conforme SAP |
numero_pedido_cliente | string | Código referência do cliente |
padrao | string | Especificação da característica interna do produto |
pais | string | Especificação do País |
produto | string | Especificação do material |
produto_foco | string | (Atualmente informação vazia) |
qualidade | string | Caso empresa = 'RC', segue a relação onde A (Boa qualidade); C = com defeito |
segmento | string | Especificação do segmento conforme codigo_segmento onde 'PE' = PEÇAS ESPECIAIS; 'PF' = PEQUENO FMT; 'MF' = MÉDIO FMT; 'GF' = GRANDE FMT |
serie_nota_fiscal | string | Sequencial do número de série da nota fiscal |
status_cliente | string | Especificação se o cliente é ativo ou inativo (Atualmente informação vazia) |
status_ordem_venda | string | Especifica o status da OV, podendo ser 'CANCELAMENTO', 'CINI', 'DEVOLUÇÃO', 'EXPORTAÇÃO', 'FATURAMENTO' ou 'VENDA' |
status_produto | string | Especificação se o produto é ativo ou não |
sub_categoria | string | (Atualmente informação vazia) |
supervisor | string | Especificação do Supervisor conforme Salesforce |
tamanho | string | Especificação do tamanho da peça |
tipo_documento_venda | string | Especificação do Tipo de Documento de Venda |
tipo_pessoa | string | Especificação de Pessoa Física ou Jurídica |
tipo_produto | string | (Atualmente informação vazia) |
tipologia | string | Caso empresa = 'RC', hierarquia 2 do produto |
unidade_medida_basica | string | Unidade de medida básica do produto |
unidade_medida_venda | string | Unidade de medida básica do produto |
valor_avp | decimal(38,2) | Valor de AVP |
valor_bonus | decimal(38,2) | Especificação do valor de comissionamento |
valor_cofins | decimal(38,2) | Valor de COFINS |
valor_icms | decimal(38,2) | Valor de ICMS |
valor_icmsst | decimal(38,2) | Valor de ICMSST |
valor_ipi | decimal(38,2) | Valor de IPI |
valor_pis | decimal(38,2) | Valor de PIS |
valor_receita_liquida | double | Valor de receita líquida |
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 |
vlp | string | (Atualmente informação vazia) |
volume | double | Quantidade do produto seguindo a unidade_medida_venda |
flag_venda_total | decimal(18,0) | Caso '0' = Não debita da venda; '1' = entra pro resultado da venda; '2' = vendas intercompany; '3' = vendas desconsideradas; '4' = vendas bloqueadas |
flag_faturamento_total | decimal(18,0) | Caso '0' = Não entra pro resultado do faturamento; '1' = entra pro resultado do faturamento; '2' = faturamento intercompany |
valor_receita_dollar | decimal(38,6) | Especificação da receita de DOLLAR em caso de Exportação |
valor_cotacao_dollar | decimal(9,5) | Especificação da cotação de DOLLAR em caso de Exportação |
cd_origem_ordem_venda | string | Código da origem da ordem de venda |
origem_ordem_venda | string | Especificação da origem da ordem de venda |
data_emissao_ov | date | Data da emissão da ordem de venda |
tipo_produto_ibp | string | (Atualmente informação vazia) |
motivo_ordem | string | Especificação dos motivos de ações conforme status_ordem_venda para as ordens de venda |
valor_mercadoria | decimal(38,2) | Valor base da mercadoria para cálculos de outros impostos |
valor_nota_fiscal | decimal(38,2) | Valor da nota fiscal com ICMSST |
numero_ordem_venda_ecc | string | Em caso de cliente migrado, especifica o número da ordem de venda do ECC |
data_insercao_registro | timestamp | Data em que o registro foi inserido na tabela |
valor_receita_bruta | decimal(38,2) | Valor do faturamento_bruto da camada semântica (resultado oficial da empresa) |
quantidade_informativa | double | Quando status_ordem_venda for FATURAMENTO, EXPORTAÇÃO ou DEVOLUÇÃO, traz a quantidade adicional de produtos |
passou_por_depara | string | Definição quando a informação do cliente passou pelo de/para da tabela tb_resultado_comercial_depara |
origem_informacao | string | Especifica se a informação veio do 'Hive', 'Stage' ou 'Reprocessamento RC' |
View file | ||
---|---|---|
|
Pessoas, processos e sistemas impactados: |
---|
|
Tarefa Jira de Desenvolvimento | Processo existente, vindo da Sinergia. |
Regras de cada campo: | Vide dicionário de dados abaixo. |
Origem | SAP e SalesForce |
Periodicidade Carga | 1 x ao dia |
Database no Stage | LARGE |
Nome do Notebook Databricks: | Processo STAGE LARGE TB VENDA FATURAMENTO - TB_VENDA_FATURAMENTO |
Link do Notebook Databricks | |
Nome do JOB Databricks: | JOB_STAGE_LARGE |
Link do JOB Databricks | https://dbc-9570c746-ec11.cloud.databricks.com/?o=3606981051492833#job/906265951238145 |
Agenda de Execução do JOB | Diariamente as 7h da manhã (horário de Brasília) |
Histórico de Modificações: | ||||
Versão | Nome | Função e Área | Data | Modificação |
V1 | Raquel Jung Mateus | PO - Analytics | 01/12/2022 | Criação do primeiro Script |
V2 | Carlos Henrique D Avila Fortes | Analista de Dados - Analytics | 09/10/2023 | Inclusão do Dicionário de Dados |