Objetivo: |
Este documento tem como objetivo descrever regras de negócio e de processo das tabelas do schema large:
|
Descrição do PROJETO: |
|
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: | |
|
Data de criação do pedido no SAP para ME
|
|
|
|
|
|
|
|
|
|
|
|
|
ANEXOS
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' |
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 |