Índice

Objetivo

Esta ferramenta extrai os  dados do ERP Microsiga Protheus® e cria toda a estrutura relacional para gerar informações gerenciais necessárias ao assunto de:

Saídas

São as tabelas com toda estrutura relacional e com os dados gerenciais extraídos do  ERP Microsiga Protheus:

Dimensões Relacionadas

HSG Status da Oportunidade (Função BIXSttOportunidade)

Visualiza as informações pelo status em que se encontra a oportunidade de venda. Ex: aberta, suspensa, ganha, etc.

Deve ser declarada no X2_UNICO da tabela fato? SIM

Dimensão: Status da Oportunidade (HSG)

Fase

Campos

Atributo Destino (Stage)

Origem

05

Business Key

HSG_STTOPO

Valor fixo atribuído ao código

Código

HSG_CODIGO

Valor Fixo

Descrição

HSG_DESC

Valor Fixo

Código

Descrição

1

Aberta

2

Perdido

3

Suspenso

9

Ganha

 Os valores fixos podem ser encontrados no componente combo correspondente ao campo AD1_STATUS.

HSH Probabilidade de Sucesso (Função BIXProbabilidade)

Visualiza as informações de acordo com a probabilidade de sucesso de finalizar uma oportunidade de venda como ganha.
Deve ser declarada no X2_UNICO da tabela fato? SIM

Dimensão: Probabilidade de Sucesso (HSH)

Fase

Campos

Atributo Destino (Stage)

Origem

05

Business Key

HSH_PROBAB

Valor fixo atribuído ao código

Código

HSH_CODIGO

Valor Fixo

Descrição

HSH_DESC

Valor Fixo

Código

Descrição

1

30%

2

60%

3

90%

Os valores fixos podem ser encontrados no componente combo correspondente ao campo AD1_FEELIN.

HSI Status da Proposta Comercial (Função BIXSttPropComercial)

 Visualiza as informações pelo status em que se encontra a proposta comercial vinculada a oportunidade de venda. Ex: Aberta, fechada, Cancelada, etc. Deve ser declarada no X2_UNICO da tabela fato? SIM

Dimensão: Status da Proposta Comercial (HSI)

Fase

Campos

Atributo Destino (Stage)

Origem

05

Business Key

HSI_STTPRO

Valor fixo atribuído ao código

Código

HSI_CODIGO

Valor Fixo

Descrição

HSI_DESC

Valor Fixo

Código

Descrição

A

Aberta

B

Fechada

C

Cancelada

D

Não Aprovada

E

Aprovada

F

Bloqueada

HSJ Status do Estágio (Função BIXSttEstagio)

Visualiza as informações pelo status em que se encontra o estágio da oportunidade de venda. Ex: Em andamento, em Atraso, etc.

Deve ser declarada no X2_UNICO da tabela fato? SIM 

Dimensão: Status do Estágio (HSJ)

Fase

Campos

Atributo Destino (Stage)

Origem

05

Business Key

HSJ_STTEST

Valor fixo atribuído ao código

Código

HSJ_CODIGO

Valor Fixo

Descrição

HSJ_DESC

Valor Fixo

Código

Descrição

1

Em Andamento

2

Em Atraso

3

Encerrado sem Atraso

4

Encerrado com Atraso

HSK Status da Atividade (Função BIXSttAtividade)

Visualiza as informações pelo status em que se encontra a atividade.

Deve ser declarada no X2_UNICO da tabela fato? SIM 

Dimensão: Status da Atividade (HSK)

Fase

Campos

Atributo Destino (Stage)

Origem

05

Business Key

HSK_STTATV

Valor fixo atribuído ao código

Código

HSK_CODIGO

Valor Fixo

Descrição

HSK_DESC

Valor Fixo

Código

Descrição

1

Não Iniciada

2

Em Andamento

3

Concluído

4

Aguardando Outros

5

Adiada

6

Pendente

7

Enviado

8

Lido

Os valores fixos podem ser encontrados no componente combo correspondente ao campo AOF_STATUS.

HSL Tipo de Atividade (Função BIXTpAtividade)

Visualiza as informações pelo tipo da atividade. As atividades são tarefas, compromissos ou e-mails gerados pelos usuários para execução de alguma ação que deve ser realizada para completar um trabalho.

Deve ser declarada no X2_UNICO da tabela fato? SIM

Dimensão: Tipo de Atividade (HSL)

Fase

Campos

Atributo Destino (Stage)

Origem

05

Business Key

HSL_TIPATV

Valor fixo atribuído ao código

Código

HSL_CODIGO

Valor Fixo

Descrição

HSL_DESC

Valor Fixo

Código

Descrição

1

Tarefa

2

Compromisso

3

E-mail

 Os valores fixos podem ser encontrados no componente combo correspondente ao campo AOF_TIPO.

HSM Oportunidade de Venda (Função BIXOportunidade)

Visualiza as informações por código ou descrição da oportunidade de venda. A oportunidade de venda é destinada ao acompanhamento de uma venda potencial, visando a geração de receita e que precisa ser monitorada através de um processo de venda até sua conclusão.
Deve ser declarada no X2_UNICO da tabela fato? NÃO

Dimensão: Oportunidade de Venda (HSM)

Fase

Campos

Atributo Destino (Stage)

Origem

05

Business Key

HSM_OPOVEN

AD1_FILIAL + AD1_NROPOR

Código

HSM_CODIGO

AD1_NROPOR

Descrição

HSM_DESC

AD1_DESCRI

Revisão

HSM_REVISA

AD1_REVISA

HSN Processo de Venda (Função BIXProVenda)

Visualiza as informações por código ou descrição do processo de venda. O processo de venda determina o processo para realizar uma venda de determinada organização, contendo etapas sequenciais que determinam os passos para completar a venda.

Deve ser declarada no X2_UNICO da tabela fato? NÃO 

Dimensão: Processo de Venda (HSN)

Fase

Campos

Atributo Destino (Stage)

Origem

05

Business Key

HSN_PROVEN

AC2_FILIAL + AC2_PROVEN + AC2_STAGE

Código

HSN_CODIGO

AC2_PROVEN

Descrição

HSN_DESC

AC1_DESCRI a partir de AC2_PROVEN utilizando índice 1.

Código do Estágio

HSN_CODEST

AC2_STAGE

Descrição do Estágio

HSN_DESEST

AC2_DESCRI

HSO Equipe de Venda (Função BIXEquipe)

Visualiza as informações por código ou descrição da equipe de venda. Equipe de venda é um grupo de vendedores ou representantes destinados à realização de vendas.

Deve ser declarada no X2_UNICO da tabela fato? NÃO

Dimensão: Equipe de Venda (HSO)

Fase

Campos

Atributo Destino (Stage)

Origem

05

Business Key

HSO_EQUVEN

ACA_FILIAL + ACA_GRPREP

Código

HSO_CODIGO

ACA_GRPREP

Descrição

HSO_DESC

ACA_DESCRI

HSP Unidade Comercial (Função BIXUniComercial)

Visualiza as informações por código ou descrição da unidade comercial. A unidade comercial permite o controle das unidades de negócio de uma organização ou empresa, como: filiais, franquias e revendas.

Deve ser declarada no X2_UNICO da tabela fato? NÃO 

Dimensão: Unidade Comercial (HSP)

Fase

Campos

Atributo Destino (Stage)

Origem

05

Business Key

HSP_UNICOM

ADK_FILIAL + ADK_COD

Código

HSP_CODIGO

ADK_COD

Nome

HSP_NOME

ADK_NOME

HSQ Usuário (Função BIXUsuario)

Visualiza as informações por código ou nome do usuário do CRM.

Deve ser declarada no X2_UNICO da tabela fato? NÃO 

Dimensão: Usuário (HSQ)

Fase

Campos

Atributo Destino (Stage)

Origem

05

Business Key

HSQ_USUARI

AO3_FILIAL + AO3_CODUSR

Código

HSQ_CODIGO

AO3_CODUSR

Nome

HSQ_NOME

UsrFullName()

HSR Prospect (Função BIXProspect)

Visualiza as informações por código ou descrição do prospect. O prospect é uma conta para ser trabalhada através de uma oportunidade de venda afim de gerar um cliente no futuro.

Deve ser declarada no X2_UNICO da tabela fato? NÃO 

Dimensão: Prospect (HSR)

Fase

Campos

Atributo Destino (Stage)

Origem

05

Business Key

HSR_PROSPE

US_FILIAL + US_COD + US_LOJA

Código

HSR_CODIGO

US_COD

Loja

HSR_LOJA

US_LOJA

Razão Social

HSR_RAZAO

US_NOME

Nome Fantasia

HSR_NOME

US_NREDUZ

Regra de Negócio

Para extrair os dados do Microsiga Protheus® e criar toda a estrutura para a geração de informações gerenciais na Área Distribuição e Logística, para assunto são extraídos os dados e gerados no Fluig Smart Data e por meio de regras,  em um Banco de Dados.

Todas as funções são executadas pelo BIEXTRACTOR agendado pelo Schedule

      
Especificação Física

Legenda

Fase 1

Informações direcionadas ao segmento Manufatura/Back Office

Fase 2

Novos itens do segmento Manufatura/Back Office, importantes para as linhas de produto compatibilizarem as informações do TOTVS BA com seus respectivos ERPs.

Fase 4

Novo itens para atender o Mercado Internacional.

 

HSF Atividades

Apresenta informações dos registros de atividades inseridos pelo usuários. As atividades são tarefas que devem ser executadas pelo usuários afim de finalizar um trabalho.

As tabelas de dimensões envolvidas para a análise das medidas de Atividades são:

Dimensões

Tabela Física

Fase

Empresa

HJ4

1

Estabelecimento

HKK

1

Status da Atividade

HSK

5

Tipo de Atividade

HSL

5

Representante

HJC

1

Usuário

HSQ

5

Unidade Comercial

HSP

5

Equipe de Venda

HSO

5

 Para mais informações sobre cada uma das dimensões consulte a documentação de especificação das dimensões da área de CRM ou das dimensões da fase 1 do TOTVS BA.

Indicadores: Atividades

Fluxo Principal de Origem: Atividade – AOF

Lookup de Dimensões

Origem

Fase

Empresa (HSF_EMPRES)

FWGrpCompany() +FWCompany()

5

Estabelecimento (HSF_ESTABL) 

FWFilial()

5

Status da Atividade (HSF_STTATV)

AOF_STATUS

5

Tipo de Atividade (HSF_TIPATV)

AOF_TIPO

5

Representante (HSF_REPRES)

AO3_VEND a partir de AOF_CODUSR utilizando índice 1

5

Usuário (HSF_USUARI)

AOF_CODUSR

5

Unidade Comercial (HSF_UNICOM)

AO3_CODUND a partir de AOF_CODUSR utilizando índice 1

5

Equipe de Venda (HSF_EQUVEN)

AO3_CODEQP a partir de AOF_CODUSR utilizando índice 1

5

Indicadores

Origem

Fase

Data de Início (HSF_DTAINI)

AOF_DTINIC

5

Hora de Início (HSF_HORAIN)

AOF_HRINIC

5

Data de Término (HSF_DTAFIM)

AOF_DTFIM

5

Hora de Término (HSF_HORAFI)

AOF_HRFIM

5

Quantidade de Atividades (HSF_QTATVI)

Valor fixo 1

5

Duração – em minutos (HSF_QTMINT)

(AOF_DTFIM – AOF_DTINIC) * 1440 + (AOF_HRFIM – AOF_HRINIC) * 60

5

No fluxo principal de dados são consideradas as informações das Atividades (AOF) com data de início (AOF_DTINIC) dentro do período indicado para extração. Além das atividades dentro do período indicado, também são consideradas as atividades abertas (AOF_STATUS com valores 1, 2, 4, 5, 6 e 7) ou que foram Concluídas/Lidas (AOF_STATUS com valores 3 e 8) após a última data de extração (AOF_DTFIM maior que a data da última extração. Esta data é armazenada na tabela HJJ por tabela fato após cada extração). Caso a não seja possível determinar a última data de extração (caso na primeira extração) esta condição não impacta no retorno das demais informações (não adicionará mais nenhum registro no retorno). As atividades abertas serão consideradas até o número de dias passados, indicado no parâmetro BIX_DIASAT, configurado através do Wizard de Configuração.

Indicadores Diretos: 

  • Quantidade de Atividades: Indica a quantidade de atividades executadas/em execução.
  • Duração – em minutos: Indica o tempo de duração em minutos de cada atividade, calculada com base na data e hora inicial e data e hora final das atividades.

Parâmetros de Extração:

A extração deve ser realizada diariamente com base no período de extração indicado. As informações serão atualizadas utilizando como parâmetro a data de início da atividade e os registros que possuem no campo HSF_STTATV os valores correspondentes aos status 1, 2, 4, 5, 6 e 7.

HST Desempenho de Vendas de Produto

Apresenta informações de propostas comerciais vinculadas a oportunidade de vendas como quantidades e valores, segregados por produtos.

As tabelas de dimensões envolvidas para a análise das medidas de Desempenho de Vendas de Produto são: 

Dimensões

Tabela Física

Fase

Empresa

HJ4

1

Estabelecimento

HKK

1

Item

HJ8

1

Família Comercial

HG1

1

Grupo de Estoque

HG3

1

Status da Proposta Comercial

HSI

5

Status da Oportunidade

HSG

5

Probabilidade de Sucesso

HSH

5

Oportunidade de Venda

HSM

5

Representante

HJC

1

Processo de Venda

HSN

5

Unidade Comercial

HSP

5

Equipe de Venda

HSO

5

Moeda

HJ6

1

Cliente

HJ7

5

Prospect

HSR

5

Região Geográfica

HJB

1

Área

HOK

5

Unidade de Medida do Item

HHW

4

 Para mais informações sobre cada uma das dimensões consulte a documentação de especificação das dimensões da área de CRM ou das dimensões da fase 1 ou 4 do TOTVS BA.

Indicadores: Desempenho de Vendas de Produtos

Fluxo Principal de Origem: Itens da Proposta Comercial - ADZ

Lookup de Dimensões

Origem

Fase

Empresa (HST_EMPRES)

FWGrpCompany() +FWCompany()

5

Estabelecimento (HST_ESTABL) 

FWFilial()

5

Item (HST_ITEM)

ADZ_PRODUT

5

Família Comercial (HST_FAMCOM)

ACV_CATEGO a partir de ADZ_PRODUT utilizando índice 5

5

Grupo de Estoque (HST_GRPEST)

B1_GRUPO a partir de ADZ_PRODUT utilizando índice 1

5

Status da Proposta Comercial (HST_STTPRO)

ADY_STATUS a partir de ADZ_PROPOS utilizando índice 1

5

Status da Oportunidade (HST_STTOPO)

AD1_STATUS a partir de ADY_OPORTU + ADY_REVISA utilizando índice 1 e ADZ_PROPOS utilizando índice 1

5

Probabilidade de Sucesso (HST_PROBAB)

AD1_FEELIN a partir de ADY_OPORTU + ADY_REVISA utilizando índice 1 e ADZ_PROPOS utilizando índice 1

5

Representante (HST_REPRES)

AO3_VEND a partir de ADY_VEND utilizando índice 2 e ADZ_PROPOS utilizando índice 1

 

Oportunidade de Venda (HST_OPOVEN)

AD1_NROPOR a partir de ADY_OPORTU + ADY_REVISA utilizando índice 1 e ADZ_PROPOS utilizando índice 1

5

Processo de Venda (HST_PROVEN)

AD1_PROVEN + AD1_STAGE a partir de ADY_OPORTU + ADY_REVISA utilizando índice 1 e ADZ_PROPOS, utilizando índice 1

5

Unidade Comercial (HST_UNICOM)

AO3_CODUND a partir de ADY_VEND utilizando índice 2 e ADZ_PROPOS utilizando índice 1

5

Equipe de Venda (HST_EQUVEN)

AO3_CODEQP a partir de ADY_VEND utilizando índice 2 e ADZ_PROPOS utilizando índice 1

5

Moeda (HST_MOEDA)

Atribuída através da função BIXGetMoeFato, considerando parâmetro do Wizard.

5

Cliente (HST_ CLIENT)

Atribuição a partir da regra especificada

5

Prospect (HST_PROSPE)

Atribuição a partir da regra especificada

5

Região Geográfica (HST_REGIAO)

Atribuição a partir da regra especificada

5

Área (HST_AREA)

Atribuição a partir da regra especificada

5

Unidade de Medida do Item (HST_UNITEM)

B1_UM a partir de ADZ_PRODUT, utilizando índice 1

5

Indicadores

Origem

Fase

Proposta Comercial (HST_PROCOM)

ADZ_PROPOS

5

Revisão da Proposta Comercial (HST_REVPRO)

ADZ_REVISA

5

Quantidade de Itens (HST_QTITEM)

Valor fixo 1

5

Quantidade de Produto (HST_QTPROD)

ADZ_QTDVEN

5

Preço de Venda (HST_VLVEND)

ADZ_PRCVEN com base em ADZ_MOEDA e data de conversão conforme regra especificada.

5

Preço de Tabela (HST_VLTABE)

ADZ_PRCTAB com base em ADZ_MOEDA e data de conversão conforme regra especificada.

5

Valor Total (HST_VLRTOT)

ADZ_TOTAL com base em ADZ_MOEDA e data de conversão conforme regra especificada.

5

Desconto em % (HST_VLPDES)

ADZ_DESCON

5

Valor de Desconto (HST_VLDESC)

ADZ_VALDES com base em ADZ_MOEDA e data de conversão conforme regra especificada.

5

Data de Início (HST_DTAINI)

AD1_DTINI a partir de ADY_OPORTU + ADY_REVISA utilizando índice 1 e ADZ_PROPOS utilizando índice 1

5

Data de Fechamento (HST_DTAFIM)

Atribuição a partir da Regra Especificada

5

No fluxo principal de dados são consideradas as informações de cada item das propostas comerciais com data de início (AD1_DTINI a partir de ADY_OPORTU + ADY_REVISA utilizando índice 1 e ADZ_PROPOS utilizando índice 1) entre o período indicado para extração. Além destes itens da proposta comercial, também são considerados todos os itens de oportunidades de vendas Abertas ou Suspensas (AD1_STATUS a partir de ADY_OPORTU + ADY_REVISA utilizando índice 1 e ADZ_PROPOS utilizando índice 1, com valor 1 ou 3) ou que foram Ganhas ou Perdidas (AD1_STATUS a partir de ADY_OPORTU + ADY_REVISA utilizando índice 1 e ADZ_PROPOS utilizando índice 1, com valor 2 ou 9) após a data da última extração executada (armazenada na tabela HJJ por tabela fato após cada extração). Caso a não seja possível determinar a última data de extração (caso na primeira extração) esta condição não impacta no retorno das demais informações (não adicionará mais nenhum registro no retorno). Os itens das propostas comerciais abertas ou suspensas serão considerados até o número de dias passados, indicado no parâmetro BIX_DIASPR, configurado através do Wizard de Configuração.

 Especificação das Regras:

  • Para o preenchimento do campo Cliente deve-se verificar se a entidade da proposta comercial é o cliente (ADY_ENTIDA = 1, a partir de ADZ_PROPOS utilizando índice 1). Caso a entidade seja o cliente utiliza-se os campos ADY_CODIGO + ADY_LOJA, caso contrário, o campo de cliente será preenchido com INDEFINIDO e o campo de Prospect terá seu valor preenchido.
  • Para o preenchimento do campo Prospect deve-se verificar se a entidade da proposta comercial é o prospect (ADY_ENTIDA = 2, a partir de ADZ_PROPOS utilizando índice 1). Caso a entidade seja o prospect utiliza-se os campos ADY_CODIGO + ADY_LOJA, caso contrário, o campo de prospect será preenchido com INDEFINIDO e o campo de Cliente terá seu valor preenchido.
  • Para o preenchimento do campo Região Geográfica é necessário determinar qual o tipo da entidade da proposta comercial: Cliente ou o Prospect. Após determinar a entidade, a origem das informações de Região Geográfica seguem 3 níveis de validação onde, passa-se a próxima validação apenas se a anterior falhar:
  1. Relacionamento com a tabela de Municípios do IBGE (CC2).
  2. Relacionamento com a tabela de Estados Padrões do País (SX5).
  3. Caso o relacionamento 2 não seja possível ou seja realizado através do estado “EX”, deve ser realizada o relacionamento com a tabela de Países (SYA).

Caso a entidade da proposta comercial seja o Cliente (ADY_ENTIDA = 1, a partir de ADZ_PROPOS utilizando índice 1), utiliza-se os campos (a partir de ADY_CODIGO + ADY_LOJA utilizando índice 1):

  1. A1_COD_MUN
  2. A1_EST
  3. A1_PAIS

Caso a entidade da proposta comercial seja o Prospect (ADY_ENTIDA = 2, a partir de ADZ_PROPOS utilizando índice 1), utiliza-se os campos (a partir de ADY_CODIGO + ADY_LOJA utilizando índice 1):

  1. US_COD_MUN
  2. US_EST
  3. US_PAIS 
  4.  Para o preenchimento do campo Área deve-se verificar qual a entidade da proposta comercial. Caso a entidade seja o Cliente (ADY_ENTIDA = 1, a partir de ADZ_PROPOS utilizando índice 1), a Área receberá o valor do campo A1_REGIAO (a partir de ADY_CODIGO + ADY_LOJA). Caso a entidade seja o Prospect (ADY_ENTIDA = 2, a partir de ADZ_PROPOS utilizando índice 1), a Área receberá o valor do campo US_REGIAO (a partir de ADY_CODIGO + ADY_LOJA).
  5. Para determinar a data a ser utilizada na conversão de moedas deve-se verificar o status da oportunidade de venda (AD1_STATUS a partir de ADY_OPORTU + ADY_REVISA utilizando índice 1 e ADZ_PROPOS utilizando índice 1). Caso o status encontre-se como Aberto ou Suspenso (1 ou 3) a data a ser utilizada é a data de extração, caso contrário a data a ser utilizada é a AD1_DTFIM (AD1_STATUS a partir de ADY_OPORTU + ADY_REVISA utilizando índice 1 e ADZ_PROPOS utilizando índice 1).
  6. Para o preenchimento do campo Data de Fechamento deve-se verificar o status da oportunidade de venda (AD1_STATUS a partir de ADY_OPORTU + ADY_REVISA utilizando índice 1 e ADZ_PROPOS utilizando índice 1). Caso o status encontre-se como Aberto ou Suspenso (1 ou 3) a data a ser utilizada é a AD1_DTPENC (AD1_STATUS a partir de ADY_OPORTU + ADY_REVISA utilizando índice 1 e ADZ_PROPOS utilizando índice 1), caso contrário a data a ser utilizada é a AD1_DTFIM (AD1_STATUS a partir de ADY_OPORTU + ADY_REVISA utilizando índice 1 e ADZ_PROPOS utilizando índice 1).

 Indicadores Diretos:

  • Quantidade de Itens: Indica a quantidade de itens envolvidos na proposta.
  • Quantidade de Produtos: Indica a quantidade produtos para cada item.
  • Preço de Venda: Indica o preço aplicado no momento da venda do produto.
  • Preço de Tabela: Indica o preço tabelado do produto.
  • Valor Total: Indica o valor total do item vendido, considerando todas as unidades pendidas.
  • % de Desconto: Indica o percentual de desconto aplicado na venda do produto.
  • Valor de Desconto: Indica o valor de desconto aplicado na venda do produto.

Indicadores Calculados: 

  • Quantidade de Propostas ( Count( Distinct ( Oportunidades ) ) ): Indica a quantidade de propostas comerciais agrupadas pelo código da proposta comercial, sem considerar os itens das propostas (propostas contadas uma única vez)

Parâmetros de Extração:

A extração deve ser realizada diariamente com base no período de extração indicado. As informações serão atualizadas utilizando como parâmetro a data de início da proposta e os registros que possuem no campo HST_STTOPO os valores correspondentes aos status 1 e 3.

HSE Desempenho do Time de Vendas

Apresenta informações de oportunidades de vendas com quantidades e receitas rateadas pelo time de vendas.

As tabelas de dimensões envolvidas para a análise das medidas de Desempenho do Time de Vendas são: 

Dimensões

Tabela Física

Fase

Empresa

HJ4

1

Estabelecimento

HKK

1

Status da Oportunidade

HSG

5

Probabilidade de Sucesso

HSH

5

Oportunidade de Venda

HSM

5

Processo de Venda

HSN

5

Moeda

HJ6

1

Representante

HJC

1

Unidade Comercial

HSP

5

Equipe de Venda

HSO

5

Cliente

HJ7

1

Prospect

HSR

5

Região Geográfica

HJB

1

Área

HOK

5

 Para mais informações sobre cada uma das dimensões consulte a documentação de especificação das dimensões da área de CRM ou das dimensões da fase 1 do TOTVS BA.

Indicadores: Desempenho do Time de Vendas

Fluxo Principal de Origem: Oportunidade de Venda – AD1

Lookup de Dimensões

Origem

Fase

Empresa (HSE_EMPRES)

FWGrpCompany() +FWCompany()

5

Estabelecimento (HSE_ESTABL) 

FWFilial()

5

Status da Oportunidade (HSE_STTOPO)

AD1_STATUS

5

Probabilidade de Sucesso (HSE_PROBAB)

AD1_FEELIN

5

Oportunidade de Venda (HSE_OPOVEN)

AD1_NROPOR

5

Processo de Venda (HSE_PROVEN)

AD1_PROVEN + AD1_STAGE

5

Representante (HSE_REPRES)

Atribuição a partir da regra especificada.

5

Unidade Comercial (HSE_UNICOM)

AO3_CODUND a partir de HSE_REPRES utilizando índice 1

5

Equipe de Venda (HSE_EQUVEN)

AO3_CODEQP a partir de HSE_REPRES utilizando índice 1

5

Cliente (HSE_CLIENT)

Se preenchido AD1_CODCLI + AD1_LOJCLI, senão AUSENTE, conforme especificação da regra

5

Prospect (HSE_PROSPE)

Se preenchido AD1_PROSPE + AD1_LOJPRO, senão AUSENTE, conforme especificação da regra

5

Região Geográfica (HSE_REGIAO)

Atribuição a partir da regra especificada

5

Moeda (HSE_MOEDA)

Atribuída através da função BIXGetMoeFato, considerando parâmetro do Wizard.

5

Área (HSE_AREA)

Atribuição a partir da regra especificada

5

Indicadores

Origem

Fase

Quantidade (HSE_QTDADE)

Valor fixo 1

5

Receita (HSE_VRECEI)

Valor de Receita * (%Part.Vendedor/100) com base em AD1_MOEDA e DataConversao, de acordo com a regra especificada

5

Percentual de Participação (HSE_PARTIC)

Atribuição a partir da regra especificada

5

Percentual de Sucesso (HSE_SUCESS)

Atribuição a partir da regra especificada

5

Percentual do Processo de Venda (HSE_PROCES)

AC2_RELEVA a partir de AD1_PROVEN + AD1_STAGE utilizando índice 1

5

Data de Início (HSE_DTAINI)

AD1_DTINI

5

Data de Fechamento (HSE_DTAFEC)

Atribuição a partir da regra especificada

5

No fluxo principal de dados são consideradas as informações de cada Oportunidade de Venda (AD1) com data de início (AD1_DTINI) no período indicado para extração. A tabela de Time de Vendas (AD2) é utilizada como subfluxo, onde esta torna-se a tabela mandatória da quantidade de registros da tabela fato, ou seja, será gerado na tabela fato um registro para cada vendedor do time de venda e as informações da oportunidade de venda serão repetidas para cada vendedor. Caso não haja time de venda para a oportunidade de venda, apenas um registro será gerado na tabela fato.

São consideradas todos oportunidades de vendas Abertas ou Suspensas (AD1_STATUS com valor 1 ou 3) ou que foram Ganha ou Perdidas (AD1_STATUS com valor 2 ou 9) após a data da última extração executada (armazenada na tabela HJJ por tabela fato após cada extração). Caso a não seja possível determinar a última data de extração (caso na primeira extração) esta condição não impacta no retorno das demais informações (não adicionará mais nenhum registro no retorno). As oportunidade de vendas abertas ou suspensas serão consideradas até o número de dias passados, indicado no parâmetro BIX_DIASTM, configurado através do Wizard de Configuração.

Especificação das Regras: 

  • Para o preenchimento do campo Representante, primeiramente verifica-se se há time de venda (AD2) para a oportunidade de venda (a partir de AD1_NROPOR + AD1_REVISA utilizando índice 1). Caso haja time de venda, utiliza-se o campo AD2_VEND, caso contrário utiliza-se AD1_VEND.
  • O preenchimento dos campos Cliente e Prospect corresponde ao tipo da entidade a qual a oportunidade de venda está relacionada. Apenas uma das duas entidades será preenchida, ou seja, quando o Cliente estiver preenchido, o Prospect estará como Ausente e quando o Prospect estiver preenchido, o Cliente estará Ausente.
  • Para o preenchimento do campo Região Geográfica é necessário determinar qual o tipo da entidade da oportunidade de venda: Cliente ou o Prospect. Após determinar a entidade, a origem das informações de Região Geográfica seguem 3 níveis de validação onde, passa-se a próxima validação apenas se a anterior falhar:
  1. Relacionamento com a tabela de Municípios do IBGE (CC2) 
  2. Relacionamento com a tabela de estados padrões do país (SX5).Caso o relacionamento 2 não seja possível ou seja realizado através do estado “EX”, deve ser realizada o relacionamento com a tabela de países (SYA).
  3. Caso a entidade da oportunidade de venda seja o Cliente (HSE_CLIENT preenchido com valor diferente de Ausente), utiliza-se os campos (a partir de AD1_CODCLI + AD1_LOJCLI utilizando índice 1):
  • A1_COD_MUN
  • A1_EST
  • A1_PAIS

Caso a entidade da oportunidade de venda seja o Prospect (HSE_PROSPE preenchido com valor diferente de Ausente), utiliza-se os campos (a partir de AD1_CODPRO + AD1_LOJPRO utilizando índice 1):

  1. US_COD_MUN
  2. US_EST
  3. US_PAIS
  • Para o preenchimento do campo Área é necessário determinar qual o tipo da entidade da oportunidade de venda: Cliente ou Prospect. Caso a entidade seja o Cliente (HSE_CLIENT preenchido com valor diferente de Ausente), utiliza-se o campo A1_REGIAO (a partir de AD1_CODCLI + AD1_LOJCLI utilizando índice 1). Caso a entidade seja o Prospect (HSE_PROSPE preenchido com valor diferente de Ausente), utiliza-se o campo US_REGIAO (a partir de AD1_CODPRO + AD1_LOJPRO utilizando índice 1).
  • O preenchimento do campo Receita é definido através do cálculo “Valor de Receita * (%Part.Vendedor/100) com base em AD1_MOEDA e DataConversao”, onde as variáveis Valor de Receita, %Part.Vendedor e DataConversao são definidas da seguinte forma:

Valor de Receita: caso o status da proposta de venda seja Aberta ou Suspensa (AD1_STATUS com valor 1 ou 3) o campo a ser utilizado é AD1_VERBA, caso o contrário o campo utilizado é AD1_RCREAL.

%Part.Vendedor:  caso seja possível determinar o time vendas (AD2) para a oportunidade de venda (a partir de AD1_NROPOR + AD1_REVISA utilizando índice 1) utiliza-se o campo AD2_PERC caso contrário considera-se como 100%. 

DataConversao: caso o status da proposta de venda seja Aberta ou Suspensa (AD1_STATUS com valor 1 ou 3) utiliza-se a data da extração, caso o contrário o campo utilizado é AD1_DTFIM

  • Para o preenchimento do campo Percentual de participação, quando há vínculo com o time vendas (AD2) para a oportunidade de venda (a partir de AD1_NROPOR + AD1_REVISA utilizando índice 1) utiliza-se o campo AD2_PERC caso contrário considera-se como 100%.
  • Para o preenchimento do Percentual de Sucesso utiliza-se o campo AD1_FEELIN para o seguinte mapeamento:

Se AD1_FEELIN:

HSE_SUCESS receberá:

1

30

2

60

3

90

  • Para o preenchimento do campo Data de Fechamento deve-se verificar o status da oportunidade de venda (AD1_STATUS). Caso o status encontre-se como Aberto ou Suspenso (1 ou 3) a data a ser utilizada é a AD1_DTPENCE, caso contrário a data a ser utilizada é a AD1_DTFIM.

Indicadores Diretos: 

  • Quantidade: Indica a quantidade de oportunidade do vendedor.
  • Receita: Indica a receita estimada para as oportunidades abertas ou suspensas ou a receita real para as oportunidade perdidas ou ganhas, rateada por vendedor.
  • Percentual de Participação: Indica o percentual de participação do vendedor sobre a receita da oportunidade.
  • Percentual de Sucesso: Indica o percentual atribuído pelo vendedor referente a possibilidade de fechamento da oportunidade como ganha.
  • Percentual do Processo de Venda: Indica o percentual de evolução do processo de venda na oportunidade.

 Indicadores Calculados:

  • Quantidade de Oportunidades (Count(distinct, oportunidades)): Indica o número de oportunidade agrupadas pelo código da oportunidade, sem considerar o vendedor (oportunidades contadas uma única vez).
  • Receita de Probabilidade de Sucesso (Receita * Percentual de Sucesso / 100): Indica a receita da oportunidade calculada com base no percentual de sucesso.
  • Receita de Contribuição (Receita * Percentual do Processo de Venda / 100): Indica a receita da oportunidade calculada com base no percentual do processo de venda.

 Parâmetros de Extração:

A extração deve ser realizada diariamente com base no período de extração indicado. As informações serão atualizadas utilizando como parâmetro a data de início da proposta e os registros que possuem no campo HSE_STTOPO os valores correspondentes aos status 1 e 3.

HSS Evolução de Venda  

Apresenta informações da evolução do processo de venda da oportunidade, tais como quantidades e receita por estágio do processo de vendas.
As tabelas de dimensões envolvidas para a análise das medidas de Evolução de Venda são: 

Dimensões

Tabela Física

Fase

Empresa

HJ4

1

Estabelecimento

HKK

1

Status da Oportunidade

HSG

5

Status  do Estágio

HSJ

5

Oportunidade de Venda

HSM

5

Processo de Venda

HSN

5

Unidade Comercial

HSP

5

Equipe de Venda

HSO

5

Cliente

HJ7

1

Prospect

HSR

5

Região Geográfica

HJB

1

Área

HOK

5

Para mais informações sobre cada uma das dimensões consulte a documentação de especificação das dimensões da área de CRM ou das dimensões da fase 1 do TOTVS BA.

Indicadores: Evolução da Venda

Fluxo Principal de Origem: Evolução de Venda – AIJ

Lookup de Dimensões

Origem

Fase

Empresa (HSS_EMPRES)

FWGrpCompany() +FWCompany()

5

Estabelecimento (HSS_ESTABL) 

FWFilial()

5

Status da Oportunidade (HSS_STTOPO)

AD1_STATUS a partir de AIJ_NROPRO + AIJ_REVISA utilizando índice 1

5

Status do Estágio (HSS_STTEST)

Atribuição a partir da regra especificada

5

Oportunidade de Venda (HSS_OPOVEN)

AD1_NROPOR a partir de AIJ_NROPO + AIJ_REVISA utilizando índice 1

5

Processo de Venda (HSS_PROVEN)

AD1_PROVEN + AD1_STAGE a partir de AIJ_NROPO + AIJ_REVISA utilizando índice 1

5

Unidade Comercial (HSS_UNICOM)

AO3_CODUDN a partir de AD1_VEND utilizando índice 2 e a partir de AIJ_NROPO + AIJ_REVISA utilizando índice 1

5

Equipe de Venda (HSS_EQUVEN)

AO3_CODEQP a partir de AD1_VEND utilizando índice 2 e a partir de AIJ_NROPO + AIJ_REVISA utilizando índice 1

5

Cliente (HSS_CLIENT)

Se preenchido AD1_CODCLI + AD1_LOJCLI, senão AUSENTE, conforme especificação da regra

5

Prospect (HSS_PROSPE)

Se preenchido AD1_PROSPE + AD1_LOJPRO, senão AUSENTE, conforme especificação da regra

5

Região Geográfica (HSS_REGIAO)

Atribuição a partir da regra especificada

5

Área (HSS_AREA)

Atribuição a partir da regra especificada

5

Indicadores

Origem

Fase

Quantidade (HSS_QTDADE)

Valor fixo 1

5

Duração em minutos (HSS_QTMINT)

Diferença entre (AIJ_DTENCE + AIJ_HRENCE) e (AIJ_DTINIC + AIJ_HRINIC). Caso a data de encerramento seja nula, utiliza-se para o cálculo a data de extração.

5

Data de Início do Estágio (HSS_DTINIE)

AIJ_DTINIC

5

Hora de Início do Estágio (HSS_HRINIE)

AIJ_HRINIC

5

Data de Encerramento do Estágio (HSS_DTFIME)

AIJ_DTENCE

5

Hora de Encerramento do Estágio (HSS_HRFIME)

AIJ_HRENCE

5

Último estágio da Oportunidade? (HSS_ULTEST)

Atribuição a partir da regra especificada

5

Data de Início da Oportunidade (HSS_DTINIO)

AD1_DTINI a partir da AIJ_NROPOR + AIJ_REVISA utilizando índice 1

5

Data de Término da Oportunidade (HSS_DTFIMO)

Atribuição a partir da regra especificada

5

No fluxo principal de dados são consideradas as informações de cada item da evolução da venda correspondente a última revisão (AIJ_REVISA = AD1_REVISA, a partir de AIJ_NROPOR + AIJ_REVISA utilizando índice 1) e com data de início (AIJ_DTINIC) entre o período indicado para extração. Também são considerados todos os itens de evolução com status do estágio Em Andamento e Em Atraso (AIJ_STATUS = vazio) ou com status de estágio com valor 1 e 2 cuja data e hora de encerramento do estágio (AIJ_DTENCE) seja maior que a última data e hora da extração executada (armazenada na tabela HJJ por tabela fato após cada extração). Caso a não seja possível determinar a última data de extração (caso na primeira extração) esta condição não impacta no retorno das demais informações (não adicionará mais nenhum registro no retorno). Os itens de evolução de venda com status do estágio Em Andamento e Em Atraso serão considerados até o número de dias passados, indicado no parâmetro BIX_DIASEV, configurado através do Wizard de Configuração.

Especificação das Regras:

  • O preenchimento do campo Status do Estágio segue as seguintes verificações:

Se:

HSS_STTEST receberá:

Significado:

AIJ_STATUS vazio

AIJ_DTLIMI + AIJ_HRLIMI > Data Extração + Hora Extração

1

Em andamento

AIJ_STATUS vazio

AIJ_DTLIMI + AIJ_HRLIMI < Data Extração + Hora Extração

2

Em atraso

AIJ_STATUS = 1

3

Encerrado sem Atraso

AIJ_STATUS = 2

4

Encerrado com Atraso

 

  • O preenchimento dos campos Cliente e Prospect corresponde ao tipo da entidade a qual a oportunidade de venda está relacionada. Apenas uma das duas entidades será preenchida, ou seja, quando o Cliente estiver preenchido, o Prospect estará como Ausente e quando o Prospect estiver preenchido, o Cliente estará Ausente.
  • Para o preenchimento do campo Região Geográfica é necessário determinar qual o tipo da entidade da oportunidade de venda: Cliente ou o Prospect. Após determinar a entidade, a origem das informações de Região Geográfica seguem 3 níveis de validação onde, passa-se a próxima validação apenas se a anterior falhar:
  1. relacionamento com a tabela de Municípios do IBGE (CC2)
  2. relacionamento com a tabela de estados padrões do país (SX5).
  3. caso o relacionamento 2 não seja possível ou seja realizado através do estado “EX”, deve ser realizada o relacionamento com a tabela de países (SYA).

Caso a entidade da oportunidade de venda seja o Cliente (HSS_CLIENT preenchido com valor diferente de Ausente), utiliza-se os campos (a partir de AD1_CODCLI + AD1_LOJCLI utilizando índice 1 e a partir de AIJ_NROPO + AIJ_REVISA utilizando índice 1):

  1. A1_COD_MUN
  2. A1_EST
  3. A1_PAIS

Caso a entidade da oportunidade de venda seja o Prospect (HSS_PROSPE preenchido com valor diferente de Ausente), utiliza-se os campos (a partir de AD1_CODPRO + AD1_LOJPRO utilizando índice 1 e a partir de a partir de AIJ_NROPO + AIJ_REVISA utilizando índice 1):

  1. US_COD_MUN
  2. US_EST 
  3. US_PAIS
  • Para o preenchimento do campo Área é necessário determinar qual o tipo da entidade da oportunidade de venda: Cliente ou Prospect. Caso a entidade seja o Cliente (HSS_CLIENT preenchido com valor diferente de Ausente), utiliza-se o campo A1_REGIAO (a partir de AD1_CODCLI + AD1_LOJCLI utilizando índice 1 e a partir de AIJ_NROPO + AIJ_REVISA utilizando índice 1). Caso a entidade seja o Prospect (HSS_PROSPE preenchido com valor diferente de Ausente), utiliza-se o campo US_REGIAO (a partir de AD1_CODPRO + AD1_LOJPRO utilizando índice 1 e a partir de AIJ_NROPO + AIJ_REVISA utilizando índice 1).
  • Para o preenchimento do campo Último Estágio da Oportunidade deve-se verificar se AIJ_PROVEN é igual a AD1_PROVEN e se AIJ_STAGE é igual a AD1_STAGE. Caso ambos os campos sejam iguais, o campo recebe valor fixo igual a “Sim”, caso contrário recebe valor fixo igual a “Não”.
  • Para o preenchimento do campo Data de Término da Oportunidade deve-se verificar o status da oportunidade de venda (AD1_STATUS). Caso o status encontre-se como Aberto ou Suspenso (1 ou 3) a data a ser utilizada é a AD1_DTPENC (partir de AIJ_NROPO + AIJ_REVISA utilizando índice 1), caso contrário a data a ser utilizada é a AD1_DTFIM (partir de AIJ_NROPO + AIJ_REVISA utilizando índice 1).

Indicadores Diretos:

  • Quantidade: Indica a quantidade de estágios da venda.
  • Duração em minutos: Indica o tempo de duração do estágio em minutos, calculado com base na data e hora inicial e data e hora de encerramento. Caso o estágio ainda não esteja finalizado, a data de encerramento considerada é a data e hora da extração.

Parâmetros de Extração:

A extração deve ser realizada diariamente com base no período de extração indicado. As informações serão atualizadas utilizando como parâmetro a data de início do estágio da venda e os registros que possuem no campo HSS_STTEST os valores correspondentes aos status 1 e 2.

HL5 Cotas de Vendas

Apresenta informações relacionadas às cotas de vendas cadastradas permitindo analise de cotas previstas e realizadas.

Esta tabela fato foi desenvolvida na fase 1 do TOTVS Business Analytics para a área Comercial. Neste momento ela será disponibilizada também através da área de CRM, sem alterações de conteúdo. Para maiores informações, consulte a especificação de requisitos da fase 1 da área Comercial.