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

 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

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

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 

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 

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

 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

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 

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

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 

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 

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 

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. 

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:

 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.

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: 

 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.

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: 

 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.

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:

• 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: 

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.

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:

• 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.