analytics_prd.tb_ordem_pendente

Objetivo:

Este documento tem como objetivo descrever regras de negócio da tabela final analytics_prd.tb_ordem_pendente, que é a tabela necessária para alimentar a carteira Deca.

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')

Times

Stakeholders

Logística Deca

Ben Hur Neves

Guilherme Okamoto

IBP

Rafael do Nascimento Berto

Comercial

Bruna Ferreira de Araujo

Bruno Brito Oliveira

Danilo Hayek Gomes

Script SQL utilizado na migração	Workspace/staging/analytics/vencidos/ordem_pendente/ordem_pendente.py
Origem	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 ingest.sap.LIPS> dados de item da remessa ingest.sap.LIKP> dados de cabeçalho da remessa ingest.sap.KNA1> dados gerais de cliente ingest.sap.marm > dados de conversão de produtos ingest.sap._scmtms_d_torrot > dados de transporte stage.large.tb_produto > hierarquia de produtos stage.large.tb_hierarquia_cliente > hierarquia de cliente
Periodicidade Carga	3 x ao dia
Tabela Destino Final	`stage.analytics_prd.ordem_pendente`
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)

Dicionário de Campos

col_name	data_type	comment
cd_empresa	string	Código da empresa
nm_ordem_venda	string	Numero da ordem de venda
nm_seq_item_ordem_venda	string	Numero do item da ordem de venda
cd_organizacao_vendas	string	Código da organização de vendas
cd_canal_distribuicao	string	Código do canal de distribuição
cd_setor_atividade	string	Código do setor de atividade
cd_escritorio_vendas	string	Código do escritório de vendas
cd_equipe_vendas	string	Código da equipe de vendas
cd_emissor_ordem	string	Código do cliente emissor
dt_primeira_remessa	date	Data da primeira remessa
dt_emissao	date	Data da emissão da ordem de venda
dt_pedido_cliente	date	Data do pedido do cliente
xx_motivo_recusa	string	Código do motivo de recusa
tp_doc_ordem_venda	string	Tipo da ordem de venda
qt_item	decimal(38,6)	Quantidade pendente de faturamento
quantidade_faturada_ordem	decimal(38,6)	Quantidade faturada da ordem
quantidade_pendente	decimal(38,6)	Quantidade pendente de faturamento
valor_liquido	decimal(38,6)	Valor total dos itens menos o que foi faturado
valor_faturado_ordem	decimal(38,6)	Valor total dos itens que foi faturado
valor_pendente	decimal(38,6)	Valor total dos itens menos o que foi faturado
status_faturamento	string	Status que indica se o item foi ou não faturado
xx_bloqueio_remessa_para_cliente	string	Indica se o cliente possui bloqueio
st_verificacao_credito	string	Status da verificação de crédito para a ordem/cliente
status_carteira	string	**Regra abaixo
cd_produto	string	Código do produto
dc_produto	string	Descrição do produto
dt_atualizacao	timestamp	data em que o registro foi inserido na tabela
remessa	string	Número da remessa da ordem de venda
dt_desejada_remessa	date	Data desejada de remessa
status_recusa	string	Status de recusa da ordem
cd_centro	string	Centro
status_ordem	string	Status da ordem de venda (concluída ou não)
ordem_frete	string	Número da ordem de frete (documento de frete).

Regra do status carteira:

Regras:

Tipos de carteiras possíveis:

Limbo;
Limbo Progr.;
Crédito;
Carteira;
Programado;
Recusado;
Remetido;
Bloqueio Adm ;
Não Classificado.

Limbo: São os pedidos que de alguma forma necessitam de aprovação.

Neste caso ocorre quando:

O Motivo recusa (vbap.abgru) = ‘ZE’ (Em aprovação na Pol Coml (ZITRSD018)) está marcado dentro do Item;

ou

Que exista um tipo de bloqueio de remessa (vbak.lifsk) e ele não seja ‘ZV’ ou ‘Z2’ (Bloqueio para venda)

E

A Venda (considera a data da primeira remessa) esteja classificada para dentro do mês atual ou menor que o mês atual

E o Status global de crédito (vbuk.cmgst) seja diferente de B (Verificação de Crédito foi efetuada, operação não ok) e diferente de nulo.

Limbo Programado

Neste caso ocorre quando:

O Motivo recusa (vbap.abgru) = ‘ZE’ (Em aprovação na Pol Coml (ZITRSD018)) está marcado dentro do Item;

ou

Que exista um tipo de bloqueio de remessa (vbak.lifsk) e ele não seja ‘ZV’ ou ‘Z2’ (Bloqueio para venda)

E

A Venda (considera a data da primeira remessa) esteja classificada para próximo mês

E

o Status global de crédito (vbuk.cmgst) seja diferente de B (Verificação de Crédito foi efetuada, operação não ok) e diferente de nulo.

Crédito

Neste caso ocorre quando:

Se o Status global das verificações de crédito (vbuk.cmgst) for igual a:

‘B’ (Verif.crédito foi efetuada, operação não oK)

‘C’ (Verif.crédito efetuada, operação não oK, liberação parcial)

Carteira

Neste caso ocorre quando:

(Código de bloqueio de nota de remessa (VBAK.LIFSK) for diferente de vazio ou ‘ZV’ ou ‘Z2’

E

Status global de crédito (vbuk.cmgst) seja diferente de B (Verificação de Crédito foi efetuada, operação não ok).

E

A quantidade confirmada for menor ou igual a quantidade do item

E

A Venda (considera a data da primeira remessa) esteja classificada para dentro do mês atual ou menor que o mês atual)

Ou

(Código de bloqueio de nota de remessa (VBAK.LIFSK) for diferente de vazio ou ‘ZV’ ou ‘Z2’

E

Status global de crédito (vbuk.cmgst) seja nulo.

E

A quantidade confirmada for nula ou igual a 0

E

A Venda (considera a data da primeira remessa) esteja classificada para dentro do mês atual ou menor que o mês atual)

Ou

(Código de bloqueio de nota de remessa (VBAK.LIFSK) for diferente de vazio ou ‘ZV’ ou ‘Z2’

E

Status global de crédito (vbuk.cmgst) seja = ‘A' ou 'D’.

E

A quantidade confirmada for nula ou igual a 0

E

A Venda (considera a data da primeira remessa) esteja classificada para dentro do mês atual ou menor que o mês atual)

Programado

Neste caso ocorre quando:

Código de bloqueio de nota de remessa (VBAK.LIFSK) for diferente de vazio ou ‘ZV’ ou ‘Z2’

E

Status global de crédito (vbuk.cmgst) seja diferente de B (Verificação de Crédito foi efetuada, operação não ok) e diferente de nulo.

E

A Venda (considera a data da primeira remessa) esteja classificada para ao próximo mês.

Recusado - Não entra na carteira, pois são as ordens que tem o motivo de recusa preenchido e são diferente de ‘ZE’
Remetido

Considera os itens que possuem remessa criada e não faturada.

Bloqueio ADM

Neste caso ocorre quando:

Se o Bloqueio de remessa for igual a ‘ZV’ ou ‘Z2’ (vbak.lifsk -Bloqueio para venda)

Ou

Se existir algum registro do Cliente dentro da tabela zittsd113 para o período atual

Ou

Se existir Bloqueio de remessa centralizado para cliente dentro do cadastro geral (kna1.aufsd, kna1.cassd, kna1.lifsd)

Ou

Se existir Bloqueio de remessa centralizado para cliente dentro do cadastro de vendas (knvv.lifsd)

Histórico de Modificações:
Versão	Nome	Função e Área	Data	Modificação
V1	Amanda Urbano	Analista de Dados - Analytics	09/10/2023	Documentação das regras de negócio