Totvs Smart Analytics Agent

Para utilização do processo de envio dos dados para o Totvs Smart Analytics é necessário informar os parâmetros para o envio dos dados.

Para isto acesse menu Integração->Ferramentas-> Parâmetros -> TOTVS Business Analytics e informe os parâmetros:

• Instância: Campo utilizado para diferencias os dados extraídos de duas ou mais bases RM para uma única Fluig Smart Data. Esse campo é de preenchimento obrigatório, mesmo quando a extração for feita utilizando apenas uma base, e deve conter 2 caracteres (Ex.: 01, 02, 03, 12, 36, etc). Realizar a extração das bases sempre considerando o mesmo período no plano de extração. Ex.: Extraído dados de Janeiro de 2017 da base RM1 então deve ser extraído os dados de Janeiro de 2017 da base RM2. Após realizar a extração das bases os dados podem ser enviados para o GoodData.
• Caminho do Java.exe
• Caminho do Agent
• Caminho do my.properties
• E-mail para envio do log de conclusão do processo de envio dos dados.

Caso seja necessário habilite e informe os parâmetro de proxy para o envio dos dados para o Totvs Smart Analytics.

• Url do proxy
• Usuário do proxy
• Senha do proxy
• Porta do proxy
  
  

Estes parâmetros serão compartilhados entre todas as coligadas.

• RH – Faixa Etária

Descrição: Define faixas agrupadoras que serão exibidas no GoodData de acordo com a idade do colaborador na data de extração.

Fatos em que o parâmetro é utilizado: Banco de Horas, Folha de Pagamento, Treinamentos Colaboradores, Treinamentos por Tipo de Custo, Vida Profissional

• RH – Tempo de Casa

Descrição: Define faixas agrupadoras de acordo com a diferença de datas entre a data da extração e a data de admissão do Colaborador.

Fatos em que o parâmetro é utilizado: Banco de Horas, Folha de Pagamento, Treinamentos Colaboradores, Treinamentos por Tipo de Custo, Vida Profissional

• RH – Tempo de Cargo

Descrição: Define faixas agrupadoras de acordo com a diferença de datas entre a data da extração e a data de em que o colaborador assumiu o cargo que ocupa atualmente.

Fatos em que o parâmetro é utilizado: Banco de Horas, Folha de Pagamento, Treinamentos Colaboradores, Treinamentos por Tipo de Custo, Vida Profissional

Para cadastrar um plano de extração é necessário definir algumas informações como descrição do plano, tipo de período, tipo do extrator.

• Tipo de Período
  
  Os períodos de extração são filtros de data que serão considerados na extração das informações do ERP-RM. Ao realizar o cadastro do plano de extração é necessário informar qual será o tipo de período de extração. O tipo de período de extração pode ser:
  
  Sem período: É utilizado quando o tipo de extração for definido apenas com dimensões, onde não é necessário ser informado filtro por período.
  Período Fixo: É muito comum a utilização do período fixo quando o plano de extração dos dados for de carga inicial, ou seja ao implantar o Totvs Smart Analytics comTotvs-RM.
  Período Variável: Utilizando o período de extração variável, será considerado, o intervalo de data de extração variável conforme os valores informados, levando em consideração sempre a data atual menos um dia. Esta opção é comumente utilizada em cargas incrementais.

• Tipo de seleção do Extrator
  
  Para proceder com a extração dos dados do ERP Totvs-RM de forma segmentada é necessário informar qual será o tipo de extração para o plano, podendo ser por:
  Dimensões
  Controladoria
  Financeiro
  Comercial
  Materiais
  Recursos Humanos
  Educacional
  Personalizado: Permite ao usuário realizar a extração apenas dos fatos que julgar necessário.
  
  Observação: É obrigatório o cadastro de um plano de extração de Dimensões.

Após a definição dos parâmetros e do cadastro do plano de extração, basta executar o processo do plano de extração. Para executá-lo acesse o menu RM >> Integração >> Integração >> TOTVS Business Analytics >> Processo do Plano de Extração.

Caso seu ambiente esteja configurado em três camadas é possível realizar o agendamento da execução do plano de extração conforme sua necessidade.

Ao executar o processo de extração, o processo identifica, os planos em comum ao plano selecionado. Dessa forma, o processo emite ao usuário um alerta informando que houve em outro momento uma extração dos dados em comum ao plano selecionado, cabendo ao usuário decidir se conclui ou não o processo de extração. 

Quando o processo entra em execução é inicializado a limpeza das tabelas da Fluig Smart Data envolvidas (dimensões e fatos) conforme o tipo de extrator definido no cadastro do plano. Para realizar a limpeza das tabelas o processo leva em consideração a instância parametrizada no sistema, dessa maneira é possível trabalhar com a extração de informações de mais de uma base RM para a Fluig Smart Data pois cada extração limpará os dados relacionados apenas a instância configurada para a base.

Ao concluir a execução do processo do plano de extração, os dados foram extraídos, tratados, padronizados e então carregados no Fluig Smart Data (apenas os dados relacionados a coligadas ativas). A partir deste ponto, os dados deverão ser transportados até a nuvem ( através do processo de Envio dos Dados para o GoodData), para o Data Warehouse do TOTVS Smart Analytics. 

Todas as vezes em que um plano for executado será gerado um histórico para que o usuário possa acompanhar a movimentação da extração dos dados.

Obs.: No caso de extração relacionada ao TOTVS Educacional (dimensões ou fatos), as informações processadas serão inseridas em um arquivo .csv que será salvos em diretório a ser definido no arquivo “my.properties” (arquivo de configuração utilizado pelo Agent para enviar as informações para o TOTVS Smart Analytics) . Ao executar o processo “Envio dos Dados para o Gooddata”, os arquivos .csv presentes no diretório configurado serão enviados para o Data Warehouse do TOTVS Smart Analytics (juntamente com os dados presentes no Fluig Smart Data). Toda vez que for feito a extração da mesma fato, mesmo configurando períodos diferentes, o arquivo .csv gerado será sobreposto pelo novo arquivo gerado pela extração.

O histórico de execução do plano de extração, nos permite visualizar informações de todos os planos de extração executados em sua base, permitindo que seja efetuado analises sobre a cada item de extração do plano.

Poderão ser consultadas informações tais como o período de extração, quantidade de registros extraído de cada item do plano, usuário que executou o processo, o tempo de extração por item e o status de execução do item do plano. O status do item do plano de extração representa a ação que está ou foi executado, São eles:

• Plano em Execução
• Plano Executado
• Erro na Extração
• Enviando para GoodData
• Enviado para GoodData

1.1 Carteira de Vendas (HL3)

Extrai os itens das movimentações de Pedido de Vendas nas seguintes condições: - Pedidos com status em aberto ou parcialmente faturado; - A data do movimento (conforme parâmetro do tipo de movimento) é menor ou igual à data final do período de extração; - O código do tipo de movimento está parametrizado como “Carteira de Vendas”; - A quantidade do item de movimento é maior do que 0 (zero).

Filtro – Período de extração

O período de extração são filtros de data que serão considerados na extração das informações do ERP. Para este fato é necessário informar qual será o período de extração. O período de extração pode ser parametrizado por fato, período fixo ou variável.

Processamento

Tabela de Destino: HL3

Indicadores Diretos:

• Vl Carteira (HL3_VCARTE): indica o valor da carteira de vendas, ou seja, o valor das vendas que ainda não foram faturadas. Este valor diz respeito às movimentações dos pedidos. 
• Qtde Entregas Carteira sem Atraso: indica a quantidade de itens cujas entregas em carteira que estão em dia, ou seja, a previsão de entrega não foi ultrapassada. 
• Qtde Entregas Carteira em Atraso: indica a quantidade de itens cujas entregas em carteira que estão em atraso. 
• Qtde Entregas Carteira (Qtde Entregas Carteira sem Atraso + Qtde Entregas Carteira em Atraso): indica a quantidade total de entregas de itens em carteira. 
• Dias sem Atraso Carteira: indica o número de dias que restam para efetuar a entrega em dia, ou seja, os dias decorridos entre a data de programada para entrega do item no pedido e a data da extração. 
• Dias Atraso Carteira: indica o número de dias em atraso, ou seja, o número de dias decorridos entre a data de extração e a data programada para entrega do item no pedido. 
• Média de Atrasos Carteira (Dias Atraso Carteira / Qtde Entregas Carteira em Atraso): indica a média de atrasos, em dias, das entregas em carteira. Para uma boa performance, esta média deve tender a zero.

1.2 Vendas (HL4)

Extrai os itens das movimentações de Pedido de Vendas nas seguintes condições: - Pedidos com status em aberto, parcialmente faturado ou faturado; - A data do movimento (conforme parâmetro do tipo de movimento) está inserida entre as datas inicial e final do período de extração; - O código do tipo de movimento está parametrizado como “Vendas”.

Filtro – Período de extração

O período de extração são os filtros de data que serão considerados na extração das informações do ERP. Para este fato é necessário informar qual será o período de extração. O período de extração pode ser parametrizado por fato, período fixo ou variável.

Processamento

Tabela de Destino: HL4

Indicadores Diretos:

• Qtde Vendida (HL4_QVENDA): indica a quantidade vendida na unidade de medida do item. 
• Qtde Vendida Família Comercial (HL4_QVENFC): indica a quantidade vendida na unidade de medida da família comercial, no caso da linha RM é a mesma quantidade vendida do item visto que não existe o conceito de unidade específica por família comercial que é uma tabela de classificação. 
• Qtde Vendida Família Material (HL4_QVENFM): indica a quantidade vendida na unidade de medida da família material, no caso da linha RM é a mesma quantidade vendida do item visto que não existe o conceito de unidade específica por família material que é uma tabela de classificação. 
• Vl Desconto Venda (HL4_VLDESV): indica o valor total do desconto que está sendo concedido para a venda. 
• Vl Impostos Venda (HL4_VIMPVD): indica o valor referente a impostos vinculados ao pedido de venda. 
• Vl Venda Líquida (HL4_VVNDLQ): indica o valor líquido da venda, relacionada às movimentações dos pedidos, sem os impostos IPI, PIS, COFINS, IRRF, ISS, INSS e descontos. O valor do ICMS pode estar descontado dependendo da origem da informação. Vl Venda Mercadoria (HL4_VVMERC): indica o valor líquido da mercadoria vendida, relacionado as movimentações dos pedidos. 
• Vl Venda Total (HL4_VVENDA): indica o valor bruto da venda, relacionado às movimentações dos pedidos. Esse valor corresponde ao valor de venda da mercadoria acrescido de todos os impostos e das despesas da venda. 
• % Variação Previsão Vendas ((Qtde Vendida / Qtde Prevista) - 1): Não se aplica. 
• % Desconto Venda (Vl Desconto Venda / Vl Venda Mercadoria): indica o percentual de desconto sobre a venda.

1.3 Faturamento (HL2)

Extrai os itens dos movimentos de Venda nas seguintes condições: - Movimentos com status diferente de Cancelado; - A data do movimento (conforme parâmetro do tipo de movimento) está inserida entre as datas inicial e final do período de extração; - O código do tipo de movimento está parametrizado como “Faturamento”.

Filtro – Período de extração

O período de extração são os filtros de data que serão considerados na extração das informações do ERP. Para este fato é necessário informar qual será o período de extração. O período de extração pode ser parametrizado por fato, período fixo ou variável.

Processamento

Tabela de Destino: HL2

Indicadores Diretos:

• Qtde Faturada Item (HL2_QFATIT): Indica a quantidade inserida na nota fiscal na unidade de medida do item. 
• Qtde Faturada Família Comercial (HL2_QVENFC): Indica a quantidade inserida na nota fiscal na unidade de medida da família comercial, no caso da linha RM é a mesma quantidade do item no movimento, visto que não existe o conceito de unidade específica por família comercial que é uma tabela de classificação. 
• Qtde Faturada Família Material (HL2_QVENFM): Indica a quantidade inserida na nota fiscal na unidade de medida da família material, no caso da linha RM é a mesma quantidade do item no movimento, visto que não existe o conceito de unidade específica por família material que é uma tabela de classificação. 
• Qtde Prazo Duplicata (HL2_QPRZDP): Não se aplica. 
• Vl COFINS Faturamento (HL2_VCOFIN): Indica o valor do COFINS calculado para o faturamento. 
• Vl Comissão Faturamento (HL2_VCMFAT): Indica o valor da comissão do representante baseado nos valores faturados. 
• Vl Custo Faturamento (HL2_VLCSFT): Indica o valor do custo de faturamento do item de acordo com a definição do tipo de custo que a empresa trabalha. 
• Vl Desconto Faturamento (HL2_VLDESF): Indica o valor de desconto concedido na nota fiscal de saída. 
• Vl Despesas (HL2_VDESPE): Indica o valor de despesas da nota fiscal. Somente considera o valor do seguro e das embalagens. Não considera frete. 
• Vl Faturamento Líquido (HL2_VFATLQ): Indica o valor faturado sem o valor do imposto ICMS.
• Vl Faturamento Mercadoria (HL2_VFATME): Indica o valor líquido da nota fiscal acrescido do valor do ICMS. 
• Vl Faturamento Total (HL2_VFATOT): Indica o valor faturado bruto. 
• Vl Frete NF (HL2_VFRTNF): Indica o valor do frete para a nota fiscal. 
• Vl ICMS Subst. Faturamento (HL2_VICMSS): Indica o valor do ICMS Substituto calculado para a nota fiscal. 
• Vl IRF Faturamento (HL2_VLIRFF): Indica o valor do IRF calculado na nota fiscal de saída. 
• Vl INSS Faturamento (HL2_VINSSF): Indica o valor do INSS calculado na nota fiscal de saída. 
• Peso Líquido (HL2_QTPESL): Não se aplica. 
• Peso Bruto (HL2_QTPESB): Não se aplica. 
• Vl ICMS Faturamento (HL2_VICMSF): Indica o valor do ICMS calculado para a nota fiscal. 
• Vl IPI Faturamento (HL2_VIPIFT): Indica o valor do IPI calculado para a nota fiscal. 
• Vl ISS Faturamento (HL2_VISSFT): Indica o valor do ISS calculado para a nota fiscal. 
• Vl PIS Faturamento (HL2_VPISFT): Indica o valor do imposto PIS incidente sobre o valor faturado. 
• Vl Receita Financeira (HL2_VRECFI): Não se aplica. 
• Quantidade (HL2_QTDVEN): Não se aplica. 
• Valor Unitário (HL2_VLUNIT): Indica o valor da unidade do item vendido. 
• Vl Custo de Mercadoria Vendida (HL2_VLCMEV): Não se aplica. 
• % Margem (Vl Margem / Vl Faturamento Líquido): Indica o valor, em percentual, da relação entre a margem de contribuição e o faturamento líquido. 
• % Desconto Faturamento (Vl Desconto Faturamento / Vl Faturamento Mercadoria): Indica o percentual de desconto praticado na nota fiscal de saída. 
• Vl Faturamento Líquido Sem Devoluções (Vl Faturamento Líquido - Vl Devolução Líquida): Indica o valor faturado líquido de impostos e descontos, exceto devoluções. 
• Vl Margem (Vl Faturamento Líquido - Vl Custo Faturamento - Vl Receita Financeira - Vl Comissão Faturamento): Indica o valor da margem de contribuição que corresponde ao lucro líquido. O valor de faturamento líquido está isento de impostos e descontos. 
• Vl Preço Médio Faturado (Vl Faturamento Mercadoria / Qtde Faturada Item): Indica o valor do preço médio. A análise desse valor deve ser feita por item ou por família comercial quando a família for composta de itens com a mesma unidade de medida. Vl Variação Entre Vendas x Faturamento (Vl Venda Total - Vl Faturamento Total): Indica a diferença entre o valor da venda bruto e o valor faturado bruto.

1.4 Análise de Crédito (HL0)

Extrai os dados dos Clientes/Fornecedores que estejam cadastrados como Cliente ou Ambos.

Filtro – Período de extração

Não é utilizado neste fato.

Processamento

Tabela de Destino: HL0

Indicadores Diretos:

• Vl Limite Crédito (HL0_VLMCDT): Indica o valor total do limite de crédito cedido ao cliente. 
• Vl Limite Crédito Disponível (HL0_VLMCDD): Indica o saldo do crédito disponível para o cliente considerando o valor total do limite cedido menos o valor do crédito em uso.
  

1.5 Devolução de Vendas (HL6)

Extrai os itens dos movimentos de devolução de venda nas seguintes condições: - Movimentos com status diferente de Cancelado; - A data do movimento (conforme parâmetro do tipo de movimento) está inserida entre as datas inicial e final do período de extração; - O código do tipo de movimento está parametrizado como “Devolução Venda”.

Filtro – Período de extração

O período de extração são os filtros de data que serão considerados na extração das informações do ERP. Para este fato é necessário informar qual será o período de extração. O período de extração pode ser parametrizado por fato, período fixo ou variável.

Processamento

Tabela de Destino: HL6

Indicadores Diretos:

• Qtde Devolvida Item (HL6_QDEVIT): indica a quantidade de itens devolvidos. 
• Qtde Devolvida Família Comercial (HL6_QDEVFC): Quantidade do Item no movimento na unidade de medida da família comercial. Como a linha RM Não trabalha com unidade de medida nas tabelas de classificação, utiliza-se a própria unidade de medida do item. 
• Qtde Devolvida Família Material (HL6_QDEVFM): Quantidade do Item no movimento na unidade de medida da família material. Como a linha RM Não trabalha com unidade de medida nas tabelas de classificação, utiliza-se a própria unidade de medida do item. 
• Vl COFINS Devolução (HL6_VCOFID): indica o valor referente ao imposto COFINS calculado para a devolução. 
• Vl Custo Devolução (HL6_VCSTDV): indica o valor do custo do item na devolução. IMPORTANTE: Para que essa informação possa ser utilizada, o tipo de movimento deve estar parametrizado para afetar estoque, caso contrário não é possível buscar o custo do produto. 
• Vl Devolução Líquida (HL6_VDEVLQ): indica o valor líquido da devolução. Valor líquido do item de movimento considerando descontos e despesas e subtraindo o tributo ICMS. 
• Vl Devolução Mercadoria (HL6_VDEVME): indica o valor líquido da devolução considerando descontos e despesas. 
• Vl Devolução Total (HL6_VDEVTO): indica o valor total dos itens que foram devolvidos. 
• Vl ICMS Subst. Devolução (HL6_VICMSS): indica o valor do ICMS de substituição calculado para a devolução. 
• Vl Desconto Devolução (HL6_VDESDV): indica o valor do desconto concedido no faturamento que está em devolução. É composto pela somatória dos campos TITMMOV.VALORDESC + TITMMOV.RATEIODESC, onde TITMMOV.RATEIODESC representa o rateio do desconto do movimento nos itens. 
• Vl INSS Devolução (HL6_VINSSD): indica o valor do INSS calculado para a devolução. 
• Vl ICMS Devolução (HL6_VICMSD): indica o valor do ICMS calculado para a devolução. 
• Vl IPI Devolução (HL6_VIPIDV): indica o valor do IPI calculado para a devolução. 
• Vl PIS Devolução (HL6_VPISDV): indica o valor do PIS calculado para o faturamento. 
• % Desconto Devolução (Vl Desconto Devolução / Vl Devolução Mercadoria): indica o percentual de desconto concedido na venda, estornado na devolução.

1.6 Entrega de Vendas (HL7)

Extrai os itens dos movimentos de venda nas seguintes condições: - Movimentos com status diferente de Cancelado; - A data do movimento (conforme parâmetro do tipo de movimento) está inserida entre as datas inicial e final do período de extração; - O código do tipo de movimento está parametrizado como “Vendas”; - A “Data de Entrega” do item de movimento ou do movimento estão preenchidas.

Filtro – Período de extração

O período de extração são os filtros de data que serão considerados na extração das informações do ERP. Para este fato é necessário informar qual será o período de extração. O período de extração pode ser parametrizado por fato, período fixo ou variável.

Processamento

Tabela de Destino: HL7

Indicadores Diretos:

• Dias Antecipação (HL7_QDSANT): indica o número de dias ocorridos entre a data de saída da mercadoria e a data de entrega programada no pedido. Pode ser utilizada como base para o cálculo da média de dias de antecipação. 
• Dias Atraso (HL7_QDSATR): indica o número de dias ocorridos entre a data de entrega programada no pedido e a data de saída da mercadoria. Pode ser utilizada como base para o cálculo da média de dias de atraso. 
• Nr Entregas (HL7_QNRENT): Não se aplica. 
• Lead Time Entrega (HL7_QLEADT): indica o número de dias entre a data de implantação do pedido e a data da última nota fiscal. Pode ser utilizada como base para o cálculo do lead time médio de entrega. 
• Lead Time Emissão Implantação (HL7_QDEMIP): Não se aplica. 
• Lead Time Interno (Dias Antecipação - Dias Atraso): indica o número de dias entre data de entrega programada no pedido e a data de saída da mercadoria. Um valor negativo indica atraso e um valor positivo antecipação. Zero significa entrega na data prevista. 
• Qtde Entregas Únicas: indica a quantidade de entregas únicas realizadas. Entrega única é quando ocorre a entrega total do item de uma só vez, sem haver entregas parciais. 
• Qtde Entregas Ocorridas: indica a quantidade de entregas ocorridas independentemente do número total das entregas do item. Por exemplo, quando o número de entregas do item for 3, a quantidade de entregas ocorridas será 1. 
• Qtde Entregas Atrasadas: indica a quantidade de entregas ocorridas com atraso. 
• Qtde Entregas Antecipadas: indica a quantidade de entregas ocorridas de forma antecipada. 
• % Entregas sem Atraso ((Qtde Entregas Ocorridas - Qtde Entregas Atrasadas) / Qtde Entregas Ocorridas): indica o percentual de entregas na data programada, sem atraso. 
• % Entregas Únicas ((Qtde Entregas Únicas / Qtde Entregas Ocorridas)): indica o percentual de entregas únicas. Mostra o percentual de vezes que a entrega ocorreu de forma única e não em partes. Quanto maior o percentual, menor os custos de transporte. É interessante analisar esta medida juntamente com o "% Entregas Sem Atraso", pois apesar da empresa estar entregando os pedidos de uma só vez, poderá estar fazendo com atraso. 
• Média de Antecipações ((Dias Antecipação / Qtde Entregas Antecipadas)): indica a média de antecipação das entregas em número de dias. Se esse indicador for alto, indica que os prazos poderiam ser mais curtos, tornando a empresa mais competitiva.
• Qtde Entregas na Data (Qtde Entregas Ocorridas - Qtde Entregas Atrasadas - Qtde Entregas Antecipadas): indica a quantidade de entregas realizadas na data programada. 
• Média de Atrasos (Dias Atraso / Qtde Entregas Atrasadas): indica a média de atraso das entregas em número de dias.
• Lead Time Médio de Implantação (Lead Time Emissão Implantação / Nr Entregas): Não se aplica.

1.1 Indicadores Gerenciais (HLA)

Extrai o saldo e movimentações das contas contábeis agrupadas conforme a parametrização realizada para cada indicador gerencial, conforme o período definido no plano de extração, exceto os lançamentos que pertencem aos históricos de fechamento definido nos parâmetros Menu Integração-> Ferramentas-> Parâmetros > TOTVS Business Analytics->Histórico de fechamento. Os valores dos lançamentos contábeis, são quebrados mensalmente por empresa, filial e indicador, dentro do período de extração.

Tabela de Destino: HLA

Indicadores Diretos:

• Valor do mês (HLA_VLRMES) – Trata-se do valor que foi realizado no período, ou seja, o valor do movimento contábil.
• Valor do mês acumulado (HLA_VLRMSA) – Valor de Saldo atual até o mês.
• Mês Referência (HLA_VLRMSA) – Indica o mês de referência para os indicadores que está sendo analisados.
• Indicador (HLA_INDICA) define a qual indicador ele pertence.

1.2 Contabilidade (HL9)

Extrai o saldo e as movimentações (totais de débitos e créditos) das contas contábeis conforme o período definido no plano de extração. Os valores são quebrados mensalmente, por empresa, filial, centro de custo e conta contábil, dentro do período de extração. 

Processamento

Tabela de Destino: HL9

Indicadores Diretos:

• Vl Saldo Inicial Real (HL9_VSDINI): indica o saldo inicial contábil do período.
• Vl Débito Real (HL9_VDREAL): indica o valor do movimento a debito no período.
• Vl Crédito Real (HL9_VCREAL): indica o valor do movimento a crédito no período.
• Vl Saldo Final Real (HL9_VSDFIN): indica o saldo final contábil do período.
• Vl Movimento Contábil Real (HL9_VCTBRL): indica o valor que foi realizado no período;
• Vl Apuração Resultado (HL9_VAPURA): indica o valor contábil referente à apuração de resultado. (Histórico de fechamento)

1.3 Orçamento (HLC)

Extrai os valores orçados x realizados das contas contábeis conforme o período definido no plano de extração. Os valores são quebrados mensalmente, por empresa, filial, centro de custo e conta contábil, dentro do período de extração.

Processamento

Tabela de Destino: HLC

Indicadores Diretos:

• Vl Orçado (HLC_VORCAD) - Indica o valor contábil que foi orçado para o período. 
• Vl Contábil Real (HLC_VCTBRL) - Indica o valor que foi realizado no período, ou seja, o valor do movimento contábil.

1.1 Contas a Pagar – Carteira (HLK)

O processo de extração de contas a pagar Carteira, leva em consideração apenas os lançamentos financeiros que estão compreendidos para os tipos de documento parametrizados e o saldo a pagar maior que zero. 
Caso existam faturas, serão considerados apenas os vencimentos de fatura e não os lançamentos faturados.
Para informar os tipos de documentos a pagar que serão considerados no momento da extração, acesse os parâmetros:
Menu Integração-> Ferramentas-> Parâmetros > TOTVS Business Analytics->Tipos de documentos a pagar.

Processamento

Tabela de Destino: HLK

Indicadores Diretos:

• Vl a Pagar (HLK_VPAGAR): indica o valor do saldo atual disponível para o lançamento a pagar

• Prazo Vencimento Carteira (HLK_PRZVCT): essa medida indica a diferença em dias entre a data de vencimento e a data de emissão do lançamento em carteira.

• Prazo Vencimento Carteira (HLK_PRZVCT): Não se aplica.

1.2 Contas a Pagar – Pagamento (HLI)

O processo de extração do contas a pagar pagamento, leva em consideração apenas os lançamentos financeiros a pagar que tiveram baixas parciais ou total que estão compreendidos para os tipos de documento parametrizado e conforme o período definido no plano de extração, utilizando como filtro, a data de baixa. 
Caso existam faturas, serão considerados apenas os vencimentos de fatura e não os lançamentos faturados.
Para informar os tipos de documentos a pagar que serão considerados no momento da extração, acesse os parâmetros:
Menu Integração-> Ferramentas-> Parâmetros > TOTVS Business Analytics->Tipos de documentos a pagar.

Processamento

Tabela de Destino: HLI

Indicadores Diretos:

• Vl Pago (HLI_VPAGO): indica o total dos valores vencidos. Este valor representa o quanto à empresa ficou inadimplente com seus fornecedores.
• Vl Juros Pagos (HLI_VJUPAG): indica o valor total dos juros pagos, inclusive multa.
• Vl Desconto Recebido (HLI_VDESCR): indica o valor total de todos os descontos obtidos.
• Prazo Pagamento (HLI_PRZPAG): essa medida indica a diferença em dias entre a data de pagamento e a data de emissão do título.
• Vl Substituição Pagamento (HLI_VSUBPG): Não se aplica

1.3 Contas a Pagar – Vencimento (HLD)

O processo de extração para o contas a pagar vencimento, leva em consideração apenas os lançamentos financeiros com saldo a pagar que estão compreendidos para os tipos de documento parametrizado e dentro do período definido no plano de extração, utilizando como filtro, a data de vencimento dos lançamentos. 
Caso existam faturas, serão considerados apenas os vencimentos de fatura e não os lançamentos faturados.
Para informar os tipos de documentos a pagar que serão considerados no momento da extração, acesse os parâmetros:
Menu Integração-> Ferramentas-> Parâmetros > TOTVS Business Analytics->Tipos de documentos a pagar.

Processamento

Tabela de Destino: HLD

Indicadores Diretos:

• Vl Vencimento (HLD_VVECTO): indica o valor a pagar ou o saldo que a empresa tem a pagar junto aos seus fornecedores.
• Vl Comprado (HLD_VCOMPR): essa medida indica o valor dos títulos implantados.
• Prazo Vencimento (HLD_PRZVCT): essa medida indica a diferença em dias entre a data de vencimento e a data de emissão do título.
• Vl Substituição Vencimento (HLD_VSUBVC): Não se aplica

1.4 Contas a Receber – Carteira (HLL)

O processo de extração para o contas a receber, leva em consideração apenas os lançamentos financeiros que estão compreendidos para os tipos de documento parametrizados cujo o saldo a receber seja maior que zero. 
Caso existam faturas, serão considerados apenas os vencimentos de fatura e não os lançamentos faturados.
Para informar os tipos de documentos a receber que serão considerados no momento da extração, acesse os parâmetros:
Menu Integração-> Ferramentas-> Parâmetros > TOTVS Business Analytics->Tipos de documentos a receber.

Processamento

Tabela de Destino: HLL

Indicadores Diretos:

• Vl a Receber Carteira (HLL_VRECEB): indica o valor do saldo atual disponível para o título a receber.
• Prazo Vencimento Carteira (HLL_ PRZREC): essa medida indica a diferença em dias entre a data de vencimento e a data de emissão do título em carteira.
• Vl Substituição Carteira (HLL_VSUBCT): Não se aplica

1.5 Contas a Receber – Recebimento (HLJ)

O processo de extração de contas a receber - recebimento, leva em consideração apenas os lançamentos financeiros a receber que tiveram baixas parciais ou totais que estão compreendidos para os tipos de documento a receber parametrizado e conforme o período definido no plano de extração sendo filtrado pela data de baixa.
Caso existam faturas, serão considerados apenas os vencimentos de fatura e não os lançamentos faturados.
Para informar os tipos de documentos a receber que serão considerados no momento da extração, acesse os parâmetros:
Menu Integração-> Ferramentas-> Parâmetros > TOTVS Business Analytics->Tipos de documentos a receber.

Processamento

Tabela de Destino: HLJ

Indicadores Diretos:

• Vl Recebido (HLJ_VRCBDO): indica o valor recebido pelas cobranças feitas junto aos clientes.
• Vl Desconto Concedido (HLJ_VDESCC): indica o valor total de desconto concedido.
• Vl Juros Recebidos (HLJ_VJUREC): indica o valor total dos juros cobrados.
• Prazo Recebimento (HLJ_PRZREC): essa medida indica a diferença em dias entre a data de recebimento e a data de emissão do título.
• Vl Substituição Recebimento (HLJ_VSUBRC): Não se aplica

1.6 Contas a Receber – Vencimento (HLE)

O processo de extração do contas a receber - Vencimento, leva em consideração apenas os lançamentos financeiros com saldo a receber que estão compreendidos para os tipos de documento parametrizado  e conforme o período definido no plano de extração filtrando a data de vencimento dos lançamentos.
Caso existam faturas, serão considerados apenas os vencimentos de fatura e não os lançamentos faturados.
Para informar os tipos de documentos a receber que serão considerados no momento da extração, acesse os parâmetros:
Menu Integração-> Ferramentas-> Parâmetros > TOTVS Business Analytics->Tipos de documentos a receber.

Processamento

Tabela de Destino: HLE

Indicadores Diretos:

• Vl Vencimento (HLE_VVECTO): indica o valor a receber ou o saldo que a empresa tem a receber junto aos seus clientes. 

• Vl Substituição Vencimento (HLE_VSUBVC): Não se aplica

• Vl Faturado (HLE_VFATUR): essa medida indica o valor dos títulos implantados.

• Prazo Vencimento (HLE_PRZVCT): essa medida indica a diferença em dias entre a data de vencimento e a data de emissão do título.

1.1 Carteira de Compras (HKQ)

Extrai os itens das Ordens de Compra nas seguintes condições:
- Ordens de Compra com status em aberto ou parcialmente faturada;
- A data do movimento (conforme parâmetro do tipo de movimento) é menor ou igual à data final do período de extração;
- O código do tipo de movimento está parametrizado como “Carteira de Compras”;
- A quantidade do item de movimento é maior do que 0 (zero).

Filtro – Período de extração

O período de extração são filtros de data que serão considerados na extração das informações do ERP. Para este fato é necessário informar qual será o período de extração. O período de extração pode ser parametrizado por fato, período fixo ou variável.

Processamento

Tabela de Destino: HKQ

Indicadores Diretos:

• Qtde Carteira (HKQ_QCARTE): Indica a quantidade do item que está em carteira, ou seja, que ainda não foi entregue pelos fornecedores.
• Vl Carteira (HKQ_VCARTE): Indica o valor total dos itens que estão em carteira, ou seja, que ainda não foi entregue pelos fornecedores.
• Dias Atrasados Carteira (HKQ_QDSATR): Indica a quantidade de dias de atraso relacionada à data prevista para entrega da compra.
• Qtde Entregas Carteira em Atraso (HKQ_QENTAT): Indica o número de entregas em carteira atrasadas.
• Qtde Entregas Carteira sem Atraso (HKQ_QENTAN): Indica o número de entregas em carteira que estão sem atraso.
• Dias sem Atraso Carteira (HKQ_QDSANT): Indica a quantidade de dias sem atraso relacionado à data prevista para entrega da compra.
• Qtde Entregas Carteira: Qtde Entregas Carteira sem Atraso + Qtde Entregas Carteira em Atraso.

1.2 Gestão de Compras (HKO)

Extrai os itens das Ordens de Compra nas seguintes condições:
- Ordens de Compra com status em aberto, parcialmente faturada ou faturada;
- A data do movimento (conforme parâmetro do tipo de movimento) está compreendida entre as datas inicial e final do período de extração;
- O código do tipo de movimento está parametrizado como “Ordem de Compra”.

Filtro – Período de extração

O período de extração são filtros de data que serão considerados na extração das informações do ERP. Para este fato é necessário informar qual será o período de extração. O período de extração pode ser parametrizado por fato, período fixo ou variável.

Processamento

Tabela de Destino: HKO

Indicadores Diretos:

• Qtde Ordens Compra (HKO_QORDCP): Indica a quantidade total de itens em ordens emitidas no período selecionado.
• Qtde Comprada (HKO_QCOMPR): Indica a quantidade dos itens que foram comprados em um determinado período em análise.
• Qtde Comprada Família Material (HKO_QCPMAT): Indica a quantidade comprada, convertida para a família de material em um determinado período em análise.
• Vl Comprado (HKO_VCOMPR): Indica o valor dos itens que foram comprados em um determinado período em análise.
• Vl IPI Comprado (HKO_VIPICP): Indica o valor do IPI dos itens que foram comprados.
• Vl ICMS Comprado (HKO_VICMCP): Indica o valor do ICM dos itens que foram comprados.
• Preço Médio Compra (Valor Comprado / Qtde Comprada): Indica o preço médio dos itens comprados, que se obtém pela seguinte fórmula: Vl Comprado /Qtde Comprada.
• Tempo Ressuprimento Interno (Data Emissão Pedido - Data Emissão Ordem): Não se aplica.
• Tempo Ressuprimento Previsto (Data Entrega - Data Emissão Ordem): Indica a quantidade de dias de ressuprimento previsto (data de entrega da ordem de compra - data da ordem de compra).
• Média Ressuprimento Interno ((Data Emissão Pedido - Data Emissão Ordem) / Qtde Ordens Compra): Não se aplica.
• Média Ressuprimento Previsto ((Data Entrega - Data Emissão Ordem) / Qtde Ordens Compra): Indica a média de dias de ressuprimento previsto por ordem de compra.

1.3 Devolução de Compras (HKL)

Extrai os itens das NF de Devolução Compra nas seguintes condições:

- Status do movimento diferente de Cancelado;
- A data do movimento (conforme parâmetro do tipo de movimento) está compreendida entre as datas inicial e final do período de extração;
- O código do tipo de movimento está parametrizado como “Devolução de Compra”.

Filtro – Período de extração

O período de extração são filtros de data que serão considerados na extração das informações do ERP. Para este fato é necessário informar qual será o período de extração. O período de extração pode ser parametrizado por fato, período fixo ou variável.

Processamento

Tabela de Destino: HKL

Indicadores Diretos:

• Qtde Devolvida (HKL_QDEVOL): Indica a quantidade dos itens que foram devolvidas.
• Qtde Devolvida Família Material (HKL_QDVFMT): Indica a quantidade devolvida, convertida para a unidade da família de material.
• Vl Devolvido (HKL_VDEVOL): Indica o valor dos itens que foram devolvidos.
• Qtde Ordens Devolvidas (HKL_QORDDV): Indica a quantidade total de itens de ordens de compras devolvidas.
• % Qtde Devolvida: Fórmula Qtde Devolvida / Qtde Recebida.

1.4 Recebimento de Compras (HKM)

Extrai os itens das NF de Devolução Compra nas seguintes condições:
- Status do movimento diferente de Cancelado;
- A data do movimento (conforme parâmetro do tipo de movimento) está compreendida entre as datas inicial e final do período de extração;
- O código do tipo de movimento está parametrizado como “Nota Fiscal Compra”.

Filtro – Período de extração

O período de extração são filtros de data que serão considerados na extração das informações do ERP. Para este fato é necessário informar qual será o período de extração. O período de extração pode ser parametrizado por fato, período fixo ou variável.

Processamento

Tabela de Destino: HKM

Indicadores Diretos:

• Dias Antecipação (HKM_QDIAAN): Indica o número de dias ocorridos entre a data real de entrega (saída da mercadoria) e a data programada no pedido.
• Dias Atrasado (HKM_QDIAAT): Indica o número de dias ocorridos entre a data programada no pedido e a data real de entrega (saída da mercadoria).
• Qtde Recebida (HKM_QRECEB): Indica a quantidade dos itens que foram recebidos.
• Qtde Recebida Família Material (HKM_QRECFM): Indica a quantidade recebida, convertida para família de material.
• Vl Recebido (HKM_VRECEB): Indica o valor líquido dos itens que foram recebidos.
• Qtde Recebimentos Antecipados (HKM_QRECAN): Indica o número de recebimentos realizados antecipadamente, ou seja, antes da data programada.
• Qtde Recebimentos em Atraso (HKM_QRECAT): Indica o número de recebimentos realizados em atraso, ou seja, depois da data programada.
• Qtde Recebimentos em Dia (HKM_QRECDT): Indica o número de recebimentos realizados em dia, ou seja, na data programada.
• Qtde Recebimentos Únicos (HKM_QRECUN): Indica o número de recebimentos realizados onde todo o pedido foi entregue de uma só vez, sem recebimentos parciais.
• Lead Time Entrega (Dias Antecipação - Dias Atrasado): Indica o número de dias ocorridos entre a data real de entrega (entrega da mercadoria) e a data programada no pedido.
• Tempo Ressuprimento Real (Data do Recebimento do Pedido de Compra – Data da Emissão da Ordem de Compra): Indica o tempo total gasto para completar o ciclo desde o momento em que uma ordem de compra é gerada até a entrega total dos produtos comprados. (Data Recebimento – Data Ordem Compra).
• Tempo Ressuprimento Previsto (Data da Previsão da Entrega do Pedido de Compra – Data da Emissão da Ordem de Compra): Não se aplica.
• % Recebimentos Antecipados (Qtde Recebimentos Antecipados / Qtde Recebimentos): Indica o percentual de recebimentos antecipados em relação a todos os recebimentos.
• % Recebimentos Atrasados (Qtde Recebimentos Atrasados / Qtde Recebimentos): Indica o percentual de recebimentos atrasados em relação a todos os recebimentos.
• % Recebimentos em Dia (Qtde Recebimentos em Dia / Qtde Recebimentos): Indica o percentual de recebimentos na data prevista em relação a todos os recebimentos.
• % Recebimentos sem Atraso (Qtde Recebimentos Antecipados + Qtde Recebimentos em Dia / Qtde Recebimentos): Indica o percentual de recebimentos sem atraso em relação a todos os recebimentos.
• % Recebimentos Únicos (Qtde Recebimentos Únicos / Qtde Recebimentos): Indica o percentual de recebimentos únicos em relação a todos os recebimentos.
• Média de Antecipações (Dias Antecipação / Qtde Recebimentos Antecipados): Indica a média de dias de antecipação das compras recebidas de forma antecipada.
• Média de Atrasos (Dias Atrasados / Qtde Recebimentos em Atraso): Indica a média de dias de atraso das compras recebidas com atraso.
• Qtde Recebimentos (Qtde Recebimentos Antecipados + Qtde Recebimentos em Atraso + Qtde Recebimentos em Dia): Indica o número total de recebimentos, considerando atrasados, antecipados e em dia.
• Lead Time Interno (Data Emissão do Pedido - Datas Emissão da Ordem): Indica o número de dias entre a data de abertura de uma solicitação de compras e o dia em que o pedido de compras originado da mesma foi aprovado. Avalia o tempo de trâmites internos, e o processo de cotação e desenvolvimento de novos fornecedores.

1.5 Estoque Diário (HKS)

Extrai os dados das movimentações de estoque (movimentos parametrizados para afetar o saldo 2) no período de extração determinado, utilizando como base para extração a data do movimento (conforme parâmetro do tipo de movimento).

Filtro – Período de extração

O período de extração são filtros de data que serão considerados na extração das informações do ERP. Para este fato é necessário informar qual será o período de extração. O período de extração pode ser parametrizado por fato, período fixo ou variável.

Processamento

Tabela de Destino: HKS

Indicadores Diretos:

• Qtde Entrada (HKS_QENTRA): Indica a quantidade total de entrada para o item no estoque.
• Qtde Saída (HKS_QSAIDA): Indica a quantidade total de saída para o item no estoque.
• Vl Entradas (HKS_VENTRA): Indica o valor total de entrada para o item no estoque.
• Vl Saídas (HKS_VSAIDA): Indica o valor total de saída para o item no estoque.
• Qtde Saldo Médio (HKS_QSDMED): Não se aplica.
• Qtde Saída Acumulada (HKS_QSAIAC): Não se aplica.
• Vl Saldo Médio (HKS_VSDMED): Indica o saldo médio relativo aos valores de entrada e saída, movimentadas no período de análise.
• Dias de Giro (HKS_QGIRO): Não se aplica.
• Vl Material no Estoque (HKS_VMATES): Não se aplica.
• Vl Mão de Obra no Estoque (HKS_VMOBES): Não se aplica.
• Vl GGF no Estoque (HKS_VGGFES): Não se aplica.
• % Giro (Qtde Saída/Qtde Saldo Médio): Não se aplica.
• Qtde Movimentos (Count(Qtde Saldo Médio)): Não se aplica.

1.6 Estoque Mensal (HKR)

Extrai os dados das movimentações de estoque (movimentos parametrizados para afetar o saldo 2) no período de extração determinado, utilizando como base para extração a data do movimento (conforme parâmetro do tipo de movimento).

Filtro – Período de extração

O período de extração são filtros de data que serão considerados na extração das informações do ERP. Para este fato é necessário informar qual será o período de extração. O período de extração pode ser parametrizado por fato, período fixo ou variável.

Processamento

Tabela de Destino: HKR

Indicadores Diretos:

• Qtde Saldo Inicial (HKR_QINISD): Indica o saldo de quantidades antes da movimentação no estoque.
• Qtde Saldo Final (HKR_QFINSD): Indica o saldo de quantidades após a movimentação no estoque.
• Vl Saldo Inicial (HKR_VINISD): Indica o saldo de valores antes da movimentação no estoque.
• Vl Saldo Final (HKR_VFINSD): Indica o saldo de valores após a movimentação no estoque.
• Qtde Saldo Médio (HKR_QSDMED): Não se aplica.
• Vl Saldo Médio (HKR_VSDMED): Não se aplica.
• Qtde Consumo Real (HKR_QEREAL): Indica a quantidade de consumo real do item.
• Vl Consumo Previsto (HKR_VEPREV): Não se aplica.
• Vl Consumo Real (HKR_VEREAL): Indica o valor de consumo real do item.
• Vl Estoque de Segurança (HKR_VESEGU): Não se aplica.
• Qtde Consumo Previsto (HKR_QEPREV): Não se aplica.
• % Variação Vl Consumo ((Vl Consumo Real/Vl Consumo Previsto) – 1): Não se aplica.
• Qtde Movimentos (Count(Qtde Saldo Médio)): Não se aplica.
• Vl Preço Unitário (Vl Final do Saldo / Qtde Final do Saldo): Indica o valor do preço unitário do item baseado no saldo do estoque. (Vl Final do Saldo / Qtde Final do Saldo).

1.7 Saldo de Estoque Diário (HKT)

Extrai os dados das movimentações de estoque (movimentos parametrizados para afetar o saldo 2) no período de extração determinado, utilizando como base para extração a data do movimento (conforme parâmetro do tipo de movimento).

Filtro – Período de extração

O período de extração são filtros de data que serão considerados na extração das informações do ERP. Para este fato é necessário informar qual será o período de extração. O período de extração pode ser parametrizado por fato, período fixo ou variável.

Processamento

Tabela de Destino: HKT
Indicadores Diretos:

• Qtde Saldo Inicial (HKT_QINISD): Indica o saldo de quantidades antes da movimentação no estoque.
• Qtde Saldo Final (HKT_QFINSD): Indica o saldo de quantidades após a movimentação no estoque.
• Vl Saldo Inicial (HKT_VINISD): Indica o saldo de valores antes da movimentação no estoque.
• Vl Saldo Final (HKT_VFINSD): Indica o saldo de valores após a movimentação no estoque.
• Vl Preço Unitário (Vl Final do Saldo / Qtde Final do Saldo): Indica o valor do preço unitário do item baseado no saldo do estoque.

1.1 Fato Folha de Pagamento (HLP)

 As regras de extração, os campos atributos da fato folha de pagamento e os campos que geram dados para métricas diretas, estão descritas abaixo:

Processamento

Tabela de Destino: HLP

Indicadores Diretos:

• Qtde Dependentes (HLP_QDEPEN) - Indica a quantidade de dependentes relacionada a cada colaborador. O valor inclui os colaboradores demitidos no mesmo período.

 Regra: A extração considera a quantidade de dependentes de IR.

• Qtde Horas Extras (HLP_QHREXT) - Indica a quantidade total de horas extras realizadas pelos colaboradores e pagas na folha de pagamento.

Regra: No Parametrizador de Integrações, os eventos parametrizados como eventos de Horas Extras, serão recuperados na ficha financeira dos funcionários e serão somadas as Referências dos respectivos eventos a fim de compor o valor da Qtde de Horas Extras

• Qtde Horas Previstas (HLP_QHRPRV) - Indica a quantidade de horas de trabalho previstas para os colaboradores de acordo com o turno.

Regra: Na extração será recuperada a Jornada de trabalho da época.

• Qtde Colaboradores Calculados (HLP_QCBCAL) - Indica o total de colaboradores que tiveram a folha de pagamento calculada.

Regra: A extração é realizada a partir da existência de eventos na Ficha Financeira (folha de pagamento calculada), para os colaboradores.

• Qtde Colaboradores Não Calculados (HLP_QCBNCA) – Ausente no RM.

• Qtde Horas Trabalhadas (HLP_QHRTRB) - Indica a quantidade total de horas trabalhadas pelos colaboradores.

Regra: No Parametrizador de Integrações, os eventos parametrizados como eventos de Salário, serão recuperados na ficha financeira dos funcionários e serão somadas as Referências dos respectivos eventos a fim de compor a Qtde de Horas Pagas. Caso o evento seja do tipo Dia, o valor encontrado de Referência será dividido por 30 e multiplicado pela Jornada Mensal da época.

• Vl Benefícios Colaborador (HLP_VBENCB) - Indica o valor total de benefícios pagos pelos colaboradores.

Regra: No Parametrizador de Integrações, os eventos parametrizados como eventos de Benefícios, serão recuperados na ficha financeira dos funcionários e serão somados os Valores dos respectivos eventos a fim de compor o Vl Benefícios Colaborador.

• Vl Benefícios Empresa (HLP_VBENEM) - Indica o valor total de benefícios pagos pela empresa aos colaboradores.

Regra: No Parametrizador de Integrações, os eventos parametrizados como eventos de Benefícios da Empresa, serão recuperados na ficha financeira dos funcionários e serão somados os Valores dos respectivos eventos a fim de compor o Vl Benefícios Empresa.

• Vl Desconto Folha Pagamento (HLP_VDESFP) - Indica o valor dos descontos na folha de pagamento dos colaboradores.

Regra: Na extração serão recuperados os eventos do tipo desconto para somar os valores de descontos. Com exceção dos eventos Código de Cálculo 43 - Líquido de Férias e do evento de Líquido de rescisão do tipo Desconto, que tiver associado ao Parametrizador do Sistema, em Rescisão | Líquido de Rescisão - campo Evento Desconto Líquido Rescisão.

• Vl Encargos Colaborador (HLP_VENCCB) - Indica o valor total de encargos sociais pagos pelo colaborador.

Regra: No Parametrizador de Integrações, os encargos parametrizados como encargos do Colaborador, serão recuperados em encargos calculados e serão somados os respectivos valores por funcionário a fim de compor o Vl Encargos Colaborador.

• Vl Encargos Empresa (HLP_VENCEM) - Indica o valor total de encargos sociais pagos pela empresa.

Regra: No Parametrizador de Integrações, os encargos parametrizados como encargos da Empresa, serão recuperados e somados os respectivos valores por funcionário a fim de compor o Vl Encargos Empresa.

• Vl Eventos Especiais (HLP_VEVESP) - Indica o valor dos eventos especiais da folha de pagamento.

Regra: No Parametrizador de Integrações, os encargos parametrizados como encargos da Empresa, serão recuperados e somados os respectivos valores por funcionário a fim de compor o Vl Eventos Especiais.

• Vl Folha Pagamento (HLP_VFLHPG) - Indica o valor dos eventos da folha de pagamento dos colaboradores. Quando totalizado por colaborador, possui o valor recebido por este.

Regra: O total de proventos menos o total de descontos compõe o valor dessa métrica. Os eventos de Proventos e Descontos devem estar parametrizados no Parametrizador da Integração.

• Vl Horas Extras (HLP_VHREXT) - Indica o valor total de horas extras realizadas pelos colaboradores e pagas na folha de pagamento.

Regra: No Parametrizador de Integrações, os eventos parametrizados como eventos de Horas Extras, serão recuperados na ficha financeira dos funcionários e serão somados os Valores dos respectivos eventos a fim de compor o valor de Horas Extras

• Vl Horas Trabalhadas (HLP_VHRTRB) - Indica o valor total de horas trabalhadas pelos colaboradores.

Regra: No Parametrizador de Integrações, os eventos parametrizados como eventos de Horas Trabalhadas, serão recuperados na ficha financeira dos funcionários e serão somados os Valores dos respectivos eventos a fim de compor o valor de Vl Horas Trabalhadas.

1.2 Fato Vida Profissional (HLQ)

As regras de extração, os campos atributos da vida profissional e os campos que geram dados para métricas diretas, estão descritas abaixo:

Processamento

Tabela de Destino: HLQ

Indicadores Diretos:

• Qtde Aumento Salarial (HLQ_QAMSAL) - Indica a quantidade de colaboradores que receberam aumento salarial.

Regra: A extração irá atribuir valor 1 neste campo, no mês que o funcionário tiver aumento salarial e na mesma tiver alteração de função.

• Qtde Colaboradores (HLQ_QCOLAB) - Indica a quantidade de colaboradores que trabalharam considerando admitidos e demitidos no mesmo período.

Regra: Na extração, para todos os funcionários será atribuído 1 no campo Qtde Colaboradores, exceto: No mês que o funcionário for transferido de Localidade (transferência de filial ou coligada)

• Qtde Colaboradores Admitidos (HLQ_QCBADM) - Indica a quantidade de colaboradores que ingressaram na empresa.

Regra: Na extração, para no mês que o funcionário for admitido, receberá valor 1 neste campo.

• Qtde Colaboradores Demitidos (HLQ_QCBDEM) - Indica a quantidade de colaboradores que foram desligados da empresa.

Regra: Na extração, no mês que o funcionário for demitido, receberá valor 1 neste campo.

• Qtde Dependentes (HLQ_QDEPEN) - Indica a quantidade de dependentes relacionada a cada colaborador. O valor inclui os colaboradores demitidos no mesmo período.

Regra: A extração considera a quantidade de dependentes de IR.

• Qtde Dias Férias (HLQ_QDFERI) - Indica o saldo de dias de férias dos colaboradores.

Regra: Quantidade de dias de férias gozadas no mês.

• Qtde Dias Férias a Vencer (HLQ_QDFAVC) - Indica a quantidade de dias de férias, a vencer, que os colaboradores terão direito.

Regra: A extração soma os avos do mês atual até o mês de fim do período aquisitivo.

• Qtde Dias Férias Vencidas (HLQ_QDFVCD) - Indica a quantidade de dias de férias, já vencidos, que os colaboradores têm direito.

Regra: A extração soma os avos vencidos que ainda não foram gozados.

• Qtde Horas Afastamento (HLQ_QHRAFT) - Indica a quantidade de horas que os colaboradores ficaram afastados da empresa.

Regra: De acordo com o histórico de afastamento do funcionário, o sistema irá multiplicar a quantidade de dias de afastamento pela jornada diária do funcionário.

• Qtde Horas Previstas (HLQ_QHRPRV) - Indica a quantidade de horas de trabalho previstas para os colaboradores de acordo com o turno.

Regra: A extração considera a jornada mensal do funcionário e realiza o cálculo de horas de jornada relativas a quantidade de dias do mês.

• Qtde Promovidos (HLQ_QPROMO) - Indica a quantidade de colaboradores que foram promovidos, ou seja, mudaram de cargo com aumento salarial.

Regra: A extração atribuirá valor 1 nesse campo quando houver alteração de Função e Alteração salarial com mesma data.

• Qtde Realocação (HLQ_QRELOQ) - Indica a quantidade de colaboradores que mudaram de cargo.

Regra: A extração atribuirá valor 1 nesse campo quando houver alteração de Função sem que tenha havido alteração salarial.

• Qtde Transferência Setor (HLQ_QTRANS) – Indica a quantidade de colaboradores que foram transferidos de setor.

Regra: Na extração será atribuído valor 1 nesse campo, caso no mês, o funcionário tenha sido alterado de seção pertencente a mesma filial da seção origem.

• Qtde Transferência Localidade (HLQ_QTRANL) – Indica a quantidade de colaboradores que foram transferidos de localidade geográfica.

Regra: será atribuído valor 1 nesse campo, caso no mês, o funcionário tenha sido transferido para outra filial ou coligada pelos tipos: 5 – Transferência sem ônus para cedente ou; 6 – transferência com ônus para cedente.

• Vl Aumento Salarial (HLQ_VAMSAL) - Indica o valor de aumento salarial recebido pelos colaboradores.

Regra: No mês do aumento salarial, a extração irá calcular a diferença do novo salarial pelo salário anterior e irá atribuir o valor a este campo.

• Vl Custo Bruto Demissão (HLQ_VCBDEM) – Indica o valor do custo bruto relacionado à demissão de colaboradores.

Regra: A extração irá somar o valor dos proventos constantes na Rescisão do funcionário e somará o valor da Multa do FGTS, se existir.

• Vl Custo Líquido Demissão (HLQ_VCLDEM) – Indica o valor do custo líquido relacionado à demissão de colaboradores.

Regra: A extração irá fazer a diferença do total de proventos pelo total de descontos calculados na rescisão e irá atribuir a este campo.

• Absenteísmo (HLQ_ABSENT) - Indica em horas, a relação do grau de ausência ao trabalho por horas trabalhadas.

Regra: A extração irá considerar o total de atrasos e faltas dos eventos CC8 descontados no mês.

• Vl Calculado Absenteísmo (HLQ_VLABST) - Indica a valorização do absenteísmo pelo salário/hora.

Regra: A extração irá calcular neste campo o valor da hora trabalhada do funcionário. O cálculo do valor do absenteísmo é calculado pela métrica.

1.3 Fato Banco de Horas (HLO)

As regras de extração, os campos atributos de banco de horas e os campos que geram dados para métricas diretas, estão descritas abaixo:

Processamento

Tabela de Destino: HLO

Indicadores Diretos:

• Qtde Horas Banco Horas (HLO_QBCOHR) - Indica a quantidade de horas alocadas no banco de horas dos colaboradores.

Regra: No RM, a extração irá considerar os valores da tabela ABANCOHOR, sendo que a extração é mensal (por período), e para essa métrica é calculado o valor do saldo do mês do banco de horas: TOTAL de extras (menos) TOTAL de atrasos (menos) TOTAL faltas.

• Vl Horas Banco Horas (HLO_VBCOHR) - Indica o valor das horas alocadas no banco de horas dos colaboradores.

Regra Condicional: A compensação do banco de horas, depende de cálculos de aplicação de percentual de acréscimo incidentes sobre o valor hora normal.
Dessa forma, o extrator do RM irá enviar o valor hora do funcionário para o Gooddata, apenas se o TOTVS Automação de Ponto estiver com o banco de horas parametrizado para considerar o percentual de acréscimo e armazenar essas horas no banco já acrescidas.

O percentual de acréscimo em Banco de Horas é aplicado no TOTVS Automação de Ponto em 2 situações:

(1)     Quando estiver parametrizado nos sindicatos para calcular o acréscimo na hora efetivada: Somente nessa situação, o Extrator do RM enviará para o Gooddata o valor Hora do Banco.

(2) Quando não estiver parametrizado serão aplicados os acréscimos na compensação e pagamento do banco na folha: Não situação, o Extrator do RM não enviará para o Gooddata o valor Hora do Banco, pois se o saldo do banco for multiplicado pelo valor/hora do salário do funcionário sem acréscimos, não representaria o valor real devido daquele banco de horas.

Saldo do Banco acumulado (_livre0) Saldo do banco anterior + atual: Métrica Customizada: A extração do saldo de horas do banco de cada mês é guardada no campo _livre0 da Stage. A métrica irá considerar sempre o último valor relativo ao filtro que for passado no relatório do Gooddata, por exemplo: Se o filtro for janeiro, será apresentado o saldo do banco de janeiro. Se o filtro de janeiro a dezembro, o saldo será relativo a dezembro.

1.4 Fato Recrutamento (HLG)

As regras de extração, os campos atributos de recrutamento e os campos que geram dados para métricas diretas, estão descritas abaixo:

Processamento

Tabela de Destino: HLG

Indicadores Diretos:

• Qtde de Dias para Contratação (HLG_QTDIAC) - Indica a quantidade de dias entre a data de abertura da requisição e a data de Admissão.

Regra: A extração totalizará a quantidade de dias entre o início do processo seletivo e a data de admissão dos funcionários participantes do processo.

• Potencial Desenvolvimento (HLG_QPOTDV) - Indica o potencial de desenvolvimento que é calculado pela média ponderada da graduação exigida para a função e a graduação obtida pelo colaborador.

Regra: A extração calculará a média da avaliação de desempenho do funcionário considerado a graduação exigida e a obtida.

• Valor Salário (HLG_VLSAL) - Indica o valor do salário do colaborador.

Regra: A extração considerará o valor do salário no cadastro do funcionário.

1.5 Fato Treinamento por Colaborador (HLM)

As regras de extração, os campos atributos de treinamento por colaborador e os campos que geram dados para métricas diretas, estão descritas abaixo:

Processamento

Tabela de Destino: HLM

Indicadores Diretos:

• Qtde Colaboradores Treinados (HLM_QCTREI) - Indica a quantidade de colaboradores que participaram de treinamentos já concluídos. Para a apresentação da informação correta desta medida é necessário que sua análise seja realizada em conjunto com a dimensão Curso.

Regra: A extração irá atribuir a quantidade de colaboradores inscritos nos treinamentos cuja a vigência corresponda ao mês.

• Qtde Horas Treinamento (HLM_QHTREI) - Indica a quantidade de horas registradas referente aos treinamentos.

Regra: A extração irá totalizar a carga horária definida nas turmas que tiverem vigente no mês.

• Vl Investimento Empresa (HLM_VINVEP) - Indica o valor do investimento pago pela empresa quando o treinamento se tratar de bolsa de estudo.

Regra: A extração irá totalizar os benefícios definidos com bolsa na parametrização da Integração.

• Vl Investimento Colaborador (HLM_VINVCL) - Indica o valor do investimento pago pelo colaborador bolsista quando o treinamento se tratar de bolsa de estudo.

Regra: A extração irá totalizar o valor do evento de desconto/provento do funcionário referente ao evento parametrizado como bolsa de estudo.

• Qtde Dias Bolsa Estudo (HLM_DBOLSA) - Indica a quantidade total de dias de bolsa de estudos.

Regra: Não se aplica.

• Qtde Colaboradores Bolsistas (HLM_QBOLSA) - Indica a quantidade de colaboradores com bolsa de estudo.

Regra: A extração irá totalizar a quantidade de colabores que possuírem desconto/provento de bolsa na folha de pagamento.

• Vl Treinamento (HLM_VTREIN) - Indica o valor do custo dos treinamentos.

Regra: A extração irá totalizar o valor do treinamento definido no cadastro de turmas.

1.6 Fato Treinamento por Custo (HQV)

As regras de extração, os campos atributos de treinamento por custo e os campos que geram dados para métricas diretas, estão descritas abaixo:

Processamento

Tabela de Destino: HQV

1.7 Reclamações Trabalhistas (HLF)

As regras de extração, os campos atributos de reclamações trabalhistas e os campos que geram dados para métricas diretas, estão descritas abaixo:

Processamento

Tabela de Destino: HLF

Indicadores Diretos:

• Qtde Reclamações (HLF_QTRECL) - Indica o número de reclamações trabalhistas.

Regra: A extração totalizará no mês a quantidade de reclamações trabalhista incluídas.

Atenção

1.1 Fato de Alunos (HHF)

Extrai informações sobre os alunos matriculados na instituição de ensino conforme o período definido no plano de extração. Os valores são quebrados mensalmente por empresa, filial, nível de ensino, curso, habilitação, período letivo, turno, modalidade, área de conhecimento e tipo do curso. Para correta visualização das informações no TOTVS Smart Analytics, fica obrigatório o preenchimento dos campos "Data de Início" e "Data de Término" ou "Previsão de Término" no cadastro do período letivo, e dos campos "Modalidade", "Área" (apnas Ensino Superior), "Presencial/Distância" (apnas Ensino Superior) no cadastro de curso. Além disso, é importante que no projeto do TOTVS Smart Analytics o filtro de "Período (Datas)" equivalha ao período letivo selecionado no filtro "Período Letivo"

Processamento:

Tabela de Destino: HHF

Indicadores Diretos:

• Quantidade de Alunos Base (HHF_QTDBAS) – Indica a quantidade de alunos ativos no primeiro mês do período de datas selecionado e que estavam ativos no mês anterior.
  Regra: A extração considera:
  • Parametrização de alunos ativos, curso educacional, período letivo.
  • Data da matrícula deve ser menor que a data final de extração (alterada mês na mês até a data final escolhida na extração).
  • Data da matrícula deve estar dentro das datas início e término ou início e previsão de término do período letivo.
  • Data final de extração deve estar dentro das datas início e término ou início e previsão de término do período letivo.

• Quantidade de Alunos Evadidos (HHF_QTDEVA) – Indica a quantidade de alunos que evadiram da instituição de ensino no mês.
  Regra: A extração considera:
  • Parametrização de alunos evadidos, curso educacional, período letivo.
  • Data de alteração deve estar dentro do período de extração (alterada mês a mês até a data final escolhida na extração).
  • Data inicial e final do período de extração deverão estar dentro das datas início e término ou início e previsão de término do período letivo.

• Quantidade de Alunos Bolsistas (HHF_QTDBOL) – Indica a quantidade de alunos ativos na instituição que possui algum tipo de bolsa ativa (inclusive FIES).
  Regra: A extração considera:
  • Parametrização de alunos ativos, curso educacional, período letivo.
  • Data da matrícula deve ser menor que a data final de extração (alterada mês na mês até a data final escolhida na extração).
  • Data da matrícula deve estar dentro das datas início e término ou início e previsão de término do período letivo.
  • Data final de extração deve estar dentro das datas início e término ou início e previsão de término do período letivo.

• Quantidade de Alunos com FIES (HHF_QTDFIE) – Indica a quantidade de alunos ativos na instituição que possui financiamento do curso através do FIES.
  Regra: A extração considera:
  
  • Parametrização de alunos ativos, curso educacional, período letivo.
  • Marcação da flag “FIES” no cadastro de bolsa no TOTVS Educacional.
  • Data da matrícula deve ser menor que a data final de extração (alterada mês na mês até a data final escolhida na extração).
  • Data da matrícula deve estar dentro das datas início e término ou início e previsão de término do período letivo.
  • Data final de extração deve estar dentro das datas início e término ou início e previsão de término do período letivo.

• Quantidade de Alunos Formados (HHF_QTDFOR) – Indica a quantidade de alunos formados no mês.
  Regra: A extração considera:
  • Parametrização de egresso de alunos, curso educacional, período letivo.
  • Data de conclusão de curso deve estar dentro do período de extração quando o parâmetro "Considerar a Data de Conclusão de Curso" para indicar Egresso do Aluno ao invés da Situação de Matrícula (apenas Ensino Superior)" estiver marcado.
  • Data de alteração deve estar dentro do período de extração (alterada mês a mês até a data final escolhida na extração).
  • Data inicial e final do período de extração deverão estar dentro das datas início e término ou início e previsão de término do período letivo.

• Quantidade de Novos Alunos (HHF_QTDNOV) – Indica a quantidade de novos alunos (calouros) no mês.
  Regra: A extração considera:
  • Parametrização curso educacional, período letivo.
  • Data de matrícula deve estar dentro do período de extração (alterada mês a mês até a data final escolhida na extração).
  • Data inicial e final do período de extração deverão estar dentro das datas início e término ou início e previsão de término do período letivo.
  • Não deve existir matrícula em outro período letivo para o aluno.

• Quantidade de Alunos Ativos (HHF_QTDTOT) – Indica a quantidade de alunos ativos no mês.
  Regra: A extração considera:
  • Parametrização de alunos ativos, curso educacional, período letivo.
  • Data da matrícula deve ser menor que a data final de extração (alterada mês na mês até a data final escolhida na extração).
  • Data da matrícula deve estar dentro das datas início e término ou início e previsão de término do período letivo.
  • Data final de extração deve estar dentro das datas início e término ou início e previsão de término do período letivo.

• Obs.: Os dados a cima são gerados pelo extrator a partir da base RM considerando o tratamento dos registros presentes na tabela SLOGPLETIVO. Por isso, a data inicial do período de extração da fato ALUNO deve ser maior ou igual que a menor data registrada no campo SLOGPLETIVO.DTALTERACAO e essa tabela nunca deve ter seus registros apagados.

1.2 Fato de Contabilidade do Educacional (HL9)

Extração do saldo e movimentações das contas contábeis conforme o período definido no plano de extração. Os valores são quebrados mensalmente por empresa, filial, centro de custo e conta contábil dentro do período de extração. 

Processamento:

Tabela de Destino: HL9

Indicadores Diretos:

• Vl Saldo Inicial Real (HL9_VSDINI) – Indica o saldo inicial contábil do período.

• Vl Débito Real (HL9_VDREAL) – Indica o valor do movimento a debito no período.

• Vl Crédito Real (HL9_VCREAL) – Indica o valor do movimento a crédito no período.

• Vl Saldo Final Real (HL9_VSDFIN) – Indica o saldo final contábil do período.

• Vl Movimento Contábil Real (HL9_VCTBRL) – Indica o valor que foi realizado no período.

• Vl Apuração Resultado (HL9_VAPURA) – Indica o valor contábil referente à apuração de resultado (histórico de fechamento).

Obs.: É necessário configurar variáveis no TOTVS Smart Analytics para representar indicadores na montagem de DRE (Demonstração do Resultado do Exercício) das instituições de ensino. Essas variáveis funcionam como agrupadores de contas contábeis.