analytics_prd.tb_carteira

Objetivo:

Este documento tem como objetivo descrever regras de negócio da tabela final analytics_prd.tb_carteira.

Descrição do PROJETO:

• Este Projeto tem como objetivo apresentar todas as ordens de venda que estão pendente de faturamento, seja total ou parcial. Tais ordens recebem o status de carteira e no momento em que esse pedido fatura totalmente, não constará mais na tabela.

• Os dados são vivos ou seja retratam a atual carteira de pedidos.

Escopo:

• Objetivo é montar uma tabela física de consulta dos pedidos que estão pendente de faturamento e é atualizada todo dia às 5h,12h e 16h.

• Como esse processo é específico Deca, consideramos os setores de atividade: ('LS','MS','LF','HY','01','99')

Ben Hur Neves

Guilherme Okamoto

Rafael do Nascimento Berto

Bruna Ferreira de Araujo

Bruno Brito Oliveira

Danilo Hayek Gomes

Script SQL utilizado na migração

Open

Workspace/staging/analytics/vencidos/carteira/carteira.py

 Origem

• stage.analytics_prd.tb_ordem_pendente > lista das ordens que estão pendente de faturamento

• stage.large.tb_produto > hierarquia de produtos

• stage.large.tb_hierarquia_cliente > hierarquia de cliente

• ingest.sap.VBAP > dados de item da ordem de venda

• ingest.sap.VBAK > dados de cabeçalho da ordem de venda

• ingest.sap.TVAKT > tipos de documentos para ordens de venda

• ingest.sap.VBEP > divisão de remessa da ordem de venda

• ingest.sap.VBKD > dados de cabeçalho da ordem de venda

• ingest.sap.mara > dados de produtos

• ingest.sap.TVAUT > motivo da ordem de vendas

Periodicidade Carga

3 x ao dia

Tabela Destino Final

stage.analytics_prd.tb_carteira

Database em stage

analytics_prd

Ação DML

INSERT, DELETE e UPDATE

Nome do JOB Databricks:

JOB_CARTEIRA

Link do JOB Databricks

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

Agenda de Execução do JOB

Diariamente as 5h, 12h e 16h (horário de Brasíla)

col_name

data_type

comment

cd_setor_atividade

string

Código do setor de atividade

cd_organizacao_vendas

string

Código da organização de vendas

cd_centro

string

Código do centro

nm_ordem_venda

decimal(10,0)

Numero da ordem de venda

nm_ordem_venda

decimal(6,0)

Numero do item da ordem de venda

status

string

Status da carteira (conforme SAP)

tp_doc_ordem_venda

string

Tipo da ordem de venda

dc_doc_ordem_venda

string

Descrição do tipo da ordem de venda

dt_digitacao_pedido

date

Data que o pedido entrou no sistema

dt_desejada_venda

date

Data escolhida pelo cliente

dt_prazo_atual

date

Maior data desejada de remessa para ordem de venda - item

xx_fornecimento_completo

string

Indica se a ordem precisa ser fornecida completamente, se for null é permitido fornecimentos parciais

cd_produto

string

Código do produto para o item da ordem

produto

string

Nome do produto para o item da ordem

tamanho

string

Indica se o produto é peça grande ou pequena

categoria

string

Categoria do produto para o item da ordem

linha_2

string

Linha do produto para o item da ordem

nm_pedido_cliente

string

Nome do pedido

xx_itinerario

string

Código da Rota de entrega

codigo_cliente_filho

string

Código do emissor da ordem

cliente_filho

string

Nome do emissor da ordem

canal_1

string

Nome da gerencia Nacional conforme  Sales Force

canal_2

string

Nome do Escritório de Vendas conforme Sales Force

estado

string

Nome da UF

cidade

string

Local

codigo_equipe_venda

string

Código da Equipe de vendas

equipe_venda

string

Equipe de vendas

vendedor_representante

string

Nome do parceiro ZB ou ZV

supervisor

string

Nome do Supervisor conforme Sales Force

coordenador

string

Nome do coordenador conforme Sales Force

gerente

string

Nome do gerente conforme Sales Force

gerente_nacional

string

Nome do gerente nacional conforme Sales Force

unidade_medida_basica

string

Unidade de medida do produto

cd_condicao_pagamento

string

Código da condição de pagamento

volume

decimal(13,3)

Volume do item

quantidade

decimal(17,3)

Quantidade que está pendente de faturamento

nm_nota_fiscal

string

**campos não mais utilizados

dt_nota_fiscal

date

**campos não mais utilizados

valor_receita

decimal(15,2)

Valor que está pendente de faturamento

aging_vs_dt_pedido

int

Data atual menos a data do pedido

aging_vs_dt_prometida

int

Data atual menos a data desejada de remessa

status_ajustado

string

Regra que o time comercial estipulou

consta no bloco abaixo

chave

string

Número da ordem + item

dt_prazo_original

date

Menor data desejada de remessa

dt_preparacao_material

date

Data estipulada para a preparação do material

dt_max_venda_vs_prazo

timestamp

SE

a menor data desejada de remessa for MAIOR que a data do pedido + 60 dias, ENTÃO retorna menor data desejada de remessa

SENÃO

Retorna a maior data desejada de remessa

ou

a data do pedido + 60 dias

aging_atraso

int

Data atual menos dt_max_venda_vs_prazo

status_atendimento

string

Se dt_max_venda_vs_prazo for maior que a data atual, ENTÃO “No prazo”, SENÃO “Em atraso”

cd_canal_distribuicao

string

Código do canal de distribuição

data_competencia

date

Se LF então data de saída mercadoria

Se HY, MS ou CS então data desejada de remessa

status_ordem

string

Status da ordem

status_carteira_comercial

string

Se a data desejada de remessa for para o mês vigente ou anterior, então “Carteira atual”, se for para um próximo mês “Carteira Futura”

codigo_motivo_ordem

string

Código do motivo da ordem de venda

motivo_ordem

string

Descrição do motivo da ordem de venda

peso_bruto

decimal(13,3)

Peso bruto total do item

peso_liquido

decimal(13,3)

Peso líquido total do item

dt_prazo_atp

date

Primeira data desejada de remessa gravada no sistema

dt_preparacao_material_atp

date

Primeira data de preparação do material gravada no sistema

dt_saida_mercadoria_atp

date

Primeira data de saída mercadoria gravada no sistema

ordens_incompletas_cabecalho

string

Status de ordem/cabeçalho incompletos

ordens_incompletas_item

string

Status de ordem/item incompletos

criado_por

string

Usuário que criou a ordem

valor_unitario

decimal(11,2)

Valor por produto

valor_moeda_original

float

Valor pendente de faturamento convertido para a moeda original da ordem de venda

taxa_cambio

float

Taxa de cambio obtida no momento de criação da ordem de venda

data_atualizacao

timestamp

data em que o registro foi inserido na tabela

Histórico de Modificações:

Versão

Nome

Função e Área

Data

Modificação

V1

Amanda Urbano

Analista de Dados - Analytics

05/10/2023

Documentação das regras de negócio