O TOTVS Smart Analytics é solução dos produtos TOTVS para extrair dados da base RM, transforma-los, alimentar a STAGE Smart Data e transporta-los para a ferramenta de Business Analytics Gooddata.
Abaixo, apresentamos a documentação particionada em "Passos" para que seja possível implantar as funcionalidades e localizar informações para "Help".

1.1 - Importar Conceitos

Os conceitos são recursos de integrações do RM com fontes externas. Para o funcionamento da extração de dados do RM, esses recursos foram utilizados e é primordial realizar a importação de todos os Conceitos atualizados, que estão disponibilizados na pasta de instalação do RM: C:\totvs\CorporeRM\ObjetosGerenciais\Conceito\Gooddata

1.2 - Ativar a Integração e Criar Base Stage

No Parametrizador, existe o recurso "Salvar Processo Como", que cria o arquivo XML com as parametrizações. O arquivo exportado, poderá ser carregado em qualquer coligada, por meio do recurso "Carregar Processo", localizado também no Parametrizador da integração.
Atenção: Deverá utilizar a funcionalidade quando os dados das parametrizações da coligada origem forem idênticos na coligada de destino.
Para localizar os parâmetros abaixo, acesse no módulo Integração: Ferramentas / Parâmetros / 50.08 - TOTVS Business Analytics

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

Estes parâmetros deverão ser configurados individualmente para cada coligada.

RH – Eventos de Proventos do Custo da Folha

Descrição: Na coluna da esquerda estarão todos os eventos de Proventos do módulo de Folha de Pagamento, e deverá ser feita a seleção, enviando para o campo da direita “Eventos Selecionados” os eventos que deverão ser considerados na métrica correspondente aos Proventos de Custo da Folha no GoodData.

Fato em que o parâmetro é utilizado: Folha de Pagamento

RH – Eventos de Desconto do Custo da Folha

Descrição: Na coluna da esquerda estarão todos os eventos de Desconto do módulo de Folha de Pagamento, e deverá ser feita a seleção, enviando para o campo da direita “Eventos Selecionados” os eventos que deverão ser considerados na métrica correspondente aos Descontos de Custo da Folha no GoodData.

Fato em que o parâmetro é utilizado: Folha de Pagamento

RH – Eventos de Base de Cálculo do Custo da Folha

Descrição: Na coluna da esquerda estarão todos os eventos de Base de Cálculo do módulo de Folha de Pagamento, e deverá ser feita a seleção, enviando para o campo da direita “Eventos Selecionados” os eventos que deverão ser considerados na métrica correspondente aos Base de Cálculo de Custo da Folha no GoodData.

Fato em que o parâmetro é utilizado: Folha de Pagamento

RH – Eventos de Hora Trabalhada do Custo da Folha

Descrição: Na coluna da esquerda estarão todos os eventos de Provento do módulo de Folha de Pagamento, e deverá ser feita a seleção, enviando para o campo da direita “Eventos Selecionados” os eventos que deverão ser considerados na métrica correspondente à soma de Horas Trabalhadas no Custo da Folha no GoodData.

Fato em que o parâmetro é utilizado: Folha de Pagamento

RH – Eventos de Hora Extra do Custo da Folha

Descrição: Na coluna da esquerda estarão todos os eventos de Provento do módulo de Folha de Pagamento, e deverá ser feita a seleção, enviando para o campo da direita “Eventos Selecionados” os eventos que deverão ser considerados na métrica correspondente à soma de Horas Extras no Custo da Folha no GoodData.

Fato em que o parâmetro é utilizado: Folha de Pagamento

RH – Eventos Especiais do Custo da Folha

Descrição: Na coluna da esquerda estarão todos os eventos do módulo de Folha de Pagamento, e deverá ser feita a seleção, enviando para o campo da direita “Eventos Selecionados” os eventos que não são recorrentes no pagamento da folha e que pode ser parametrizado de forma personalizada a critério do cliente com o que for considerado custo especial. Exemplos: PLR, Bonificação, Gratificação, etc.

Fato em que o parâmetro é utilizado: Folha de Pagamento

RH – Encargos Pagos pelo Colaborador

Descrição: Na coluna da esquerda estarão todos os encargos do módulo de Folha de Pagamento, e deverá ser feita a seleção, enviando para o campo da direita “Encargos Selecionados” os encargos que deverão ser considerados na métrica correspondente aos Encargos da Folha do Colaborador, Pagos pelo Colaborador, no GoodData.

Fato em que o parâmetro é utilizado: Folha de Pagamento

RH – Encargos Pagos pela Empresa

Descrição: Na coluna da esquerda estarão todos os encargos do módulo de Folha de Pagamento, e deverá ser feita a seleção, enviando para o campo da direita “Encargos Selecionados” os encargos que deverão ser considerados na métrica correspondente aos Encargos da Folha do Colaborador, Pagos pela Empresa, no GoodData.

Fato em que o parâmetro é utilizado: Folha de Pagamento

RH – Benefícios Pagos pelo Colaborador

Descrição: Na coluna da esquerda estarão todos os eventos do módulo de Folha de Pagamento, e deverá ser feita a seleção, enviando para o campo da direita “Eventos Selecionados” os eventos que deverão ser considerados na métrica correspondente aos Valores de Benefícios do Colaborador, Pagos pelo Colaborador, no GoodData.

Fato em que o parâmetro é utilizado: Folha de Pagamento

RH – Benefícios Pagos pela Empresa

Descrição: Na coluna da esquerda estarão todos os eventos do módulo de Folha de Pagamento, e deverá ser feita a seleção, enviando para o campo da direita “Eventos Selecionados” os eventos que deverão ser considerados na métrica correspondente aos Valores de Benefícios do Colaborador, Pagos pela Empresa, no GoodData.

Fato em que o parâmetro é utilizado: Folha de Pagamento

RH – Tipo Benefício Bolsa - Colaborador

Descrição: Na coluna da esquerda estarão todos os tipos de benefício do módulo de Folha de Pagamento, e deverá ser feita a seleção, enviando para o campo da direita “Tipo de Benefício Selecionados” os tipos de benefício que deverão ser considerados na(s) métrica(s) do GoodData que correspondem ou existência de benefício.

Fatos em que o parâmetro é utilizado: Treinamentos Colaboradores, Treinamentos por Tipo de Custo

Ao finalizar, clicando em Concluir, todas as configurações feitas serão salvas e estarão prontas para utilização dos conceitos (Fatos) do modulo de Recursos Humanos.

Parâmetro – Carteira de Compra

É dever do usuário informar quais são os tipos de movimento que serão considerados na extração dos dados para este indicador.

Em “Integração >> Parâmetros >> TOTVS Business Analytics >> Parâmetros por Empresa >> Materiais >> Mov – Carteira de Compra” você deverá selecionar quais são os tipos de movimento cujos dados devem ser levados em consideração na fato ‘Carteira de Compras’ que irá espelhar os dados das suas Ordens de Compra que ainda estão em aberto ou parcialmente recebidas.

Na coluna do lado esquerdo o sistema apresentará todos os tipos de movimento de Ordens de Compras (1.1.XX) existentes na sua base de dados.

Leve para a coluna da direita os tipos de movimento que você deseja selecionar. Para isso basta marcar o tipo de movimento na coluna da esquerda e clicar em >, ou então clicar em >> caso deseje que os dados de todos os movimentos do tipo 1.1 sejam considerados na consulta.

Parâmetro – Ordem de Compra

É dever do usuário informar quais são os tipos de movimento que serão considerados na extração dos dados para este indicador.

Em “Integração >> Parâmetros >> TOTVS Business Analytics >> Parâmetros por Empresa >> Materiais >> Mov – Ordem de Compra” você deverá selecionar quais são os tipos de movimento cujos dados devem ser levados em consideração na fato ‘Gestão de Compras’ que irá espelhar os dados das suas Ordens de Compra.

Na coluna do lado esquerdo o sistema apresentará todos os tipos de movimento de Ordens de Compras (1.1.XX) existentes na sua base de dados.

Leve para a coluna da direita os tipos de movimento que você deseja selecionar. Para isso basta marcar o tipo de movimento na coluna da esquerda e clicar em >, ou então clicar em >> caso deseje que os dados de todos os movimentos do tipo 1.1 sejam considerados na consulta.

Parâmetro – Devolução de Compra

É dever do usuário informar quais são os tipos de movimento que serão considerados na extração dos dados para este indicador.

Em “Integração >> Parâmetros >> TOTVS Business Analytics >> Parâmetros por Empresa >> Comercial >> Mov – Devolução Compra” você deverá selecionar quais são os tipos de movimento cujos dados devem ser levados em consideração na fato ‘Devolução de Compras’ que irá espelhar os dados relativos a todas as devoluções de compra efetuadas por sua empresa.

Na coluna do lado esquerdo o sistema apresentará todos os tipos de movimento de Devolução de Compra existentes na sua base de dados. Para determinar os tipos de movimento que são de Devolução de Venda o sistema irá verificar a parametrização dos tipos de movimento 1.2 e mostrará na tela apenas aqueles cujo campo ‘Usar Cópia de Movimentos por referência’ estiver marcado e cujo motivo de referência seja o 4 (Devolução de Compra de Mercadorias).

Para verificar essa parametrização nos tipos de movimento da sua empresa vá em “Backoffice > Gestão de Estoque, Compras e Faturamento > Ambiente > Parâmetros > Gestão de Estoque, Compras e Faturamento > 04.09 – Outras Movimentações > Tipo de Movimento > Mov – Outros Dados”.

Parâmetro – Nota Fiscal Compra

É dever do usuário informar quais são os tipos de movimento que serão considerados na extração dos dados para este indicador.

Em “Integração >> Parâmetros >> TOTVS Business Analytics >> Parâmetros por Empresa >> Comercial >> Mov – Nota Fiscal Compra” você deverá selecionar quais são os tipos de movimento cujos dados devem ser levados em consideração na fato ‘Nota Fiscal Compra’ que irá espelhar os dados das compras da sua empresa.

Na coluna do lado esquerdo o sistema apresentará todos os tipos de movimento de saída (1.2.XX) existentes na sua base de dados.

Leve para a coluna da direita os tipos de movimento que você deseja selecionar. Para isso basta marcar o tipo de movimento na coluna da esquerda e clicar em >, ou então clicar em >> caso deseje que os dados de todos os movimentos do tipo 1.2 sejam considerados na consulta.

Parâmetro - Solicitação de Compras

É dever do usuário informar quais são os tipos de movimento de Solicitação de Compras.

Em “Integração >> Parâmetros >> TOTVS Business Analytics >> Parâmetros por Empresa >> Comercial >> Mov – Solicitação Compra” você deverá selecionar quais são os tipos de movimento cujos dados devem ser levados em consideração nas fatos que utilizam informações de Solicitação de Compras.

Na coluna do lado esquerdo o sistema apresentará todos os tipos de movimento de Solicitação de Compras (1.1.XX) existentes na sua base de dados.

Leve para a coluna da direita os tipos de movimento que você deseja selecionar. Para isso basta marcar o tipo de movimento na coluna da esquerda e clicar em >, ou então clicar em >> caso deseje que os dados de todos os movimentos do tipo 1.1 sejam considerados na consulta.

Parâmetro - Aprovação Ordem de Compra

Durante a extração das Fatos Gestão de Compras e Carteira de Compras, o sistema verificará a parametrização referente a Aprovação da Ordem de compra, é dever do usuário definir quais tipos de movimentos utilizarão tal filtro.

Em “Integração >> Parâmetros >> TOTVS Business Analytics >> Parâmetros por Empresa >> Comercial >> Mov – Aprovação Ordem Compra”, serão exibidos os tipos de movimento e, caso parametrizado, seu tipo de Aprovação (Fórmula e Aprovação por WorkFlow), basta selecionar o registro e marcar a opção "Enviar somente aprovadas".

Parâmetro - Carteira de Vendas

É dever do usuário informar quais são os tipos de movimento que serão considerados na extração dos dados para este indicador.

Em “Integração >> Parâmetros >> TOTVS Business Analytics >> Parâmetros por Empresa >> Comercial >> Mov – Carteira Vendas” você deverá selecionar quais são os tipos de movimento cujos dados devem ser levados em consideração na6 fato ‘Carteira de Vendas’ que irá espelhar os dados dos seus Pedidos de Venda que ainda estão em aberto ou parcialmente faturados.

Na coluna do lado esquerdo o sistema apresentará todos os tipos de movimento de Pedido de Vendas (2.1.XX) existentes na sua base de dados.

Leve para a coluna da direita os tipos de movimento que você deseja selecionar. Para isso basta marcar o tipo de movimento na coluna da esquerda e clicar em >, ou então clicar em >> caso deseje que os dados de todos os movimentos do tipo 2.1 sejam considerados na consulta.

Parâmetro - Vendas

É dever do usuário informar quais são os tipos de movimento que serão considerados na extração dos dados para este indicador.

Em “Integração >> Parâmetros >> TOTVS Business Analytics >> Parâmetros por Empresa >> Comercial >> Mov –Vendas” você deverá selecionar quais são os tipos de movimento cujos dados devem ser levados em consideração na fato ‘Vendas’ que irá espelhar os dados dos seus Pedidos de Venda independente do status dos mesmos, ou seja, nesta consulta serão considerados tanto os pedidos de venda que ainda estão em aberto, como os pedidos de venda que já foram faturados.

Na coluna do lado esquerdo o sistema apresentará todos os tipos de movimento de Pedido de Vendas (2.1.XX) existentes na sua base de dados.

Leve para a coluna da direita os tipos de movimento que você deseja selecionar. Para isso basta marcar o tipo de movimento na coluna da esquerda e clicar em >, ou então clicar em >> caso deseje que os dados de todos os movimentos do tipo 2.1 sejam considerados na consulta.

Parâmetro – Faturamento

É dever do usuário informar quais são os tipos de movimento que serão considerados na extração dos dados para este indicador.

Em “Integração >> Parâmetros >> TOTVS Business Analytics >> Parâmetros por Empresa >> Comercial >> Mov – Faturamento” você deverá selecionar quais são os tipos de movimento cujos dados devem ser levados em consideração na fato ‘Faturamento’ que irá espelhar os dados do faturamento da sua empresa.

Na coluna do lado esquerdo o sistema apresentará todos os tipos de movimento de saída (2.2.XX) existentes na sua base de dados.

Leve para a coluna da direita os tipos de movimento que você deseja selecionar. Para isso basta marcar o tipo de movimento na coluna da esquerda e clicar em >, ou então clicar em >> caso deseje que os dados de todos os movimentos do tipo 2.2 sejam considerados na consulta.

Parâmetro - Devolução de Vendas

É dever do usuário informar quais são os tipos de movimento que serão considerados na extração dos dados para este indicador.

Em “Integração >> Parâmetros >> TOTVS Business Analytics >> Parâmetros por Empresa >> Comercial >> Mov – Devolução Venda” você deverá selecionar quais são os tipos de movimento cujos dados devem ser levados em consideração na consulta Devolução de Vendas que irá espelhar os dados relativos a todas as devoluções de venda recebidas por sua empresa.

Na coluna do lado esquerdo o sistema apresentará todos os tipos de movimento de Devolução de Venda existentes na sua base de dados. Para determinar os tipos de movimento que são de Devolução de Venda o sistema irá verificar a parametrização dos tipos de movimento 2.2 e mostrará na tela apenas aqueles cujo campo ‘Usar Cópia de Movimentos por referência’ estiver marcado e cujo motivo de referência seja o 5 (Devolução de Venda de Mercadorias).

Para verificar essa parametrização nos tipos de movimento da sua empresa vá em “Backoffice > Gestão de Estoque, Compras e Faturamento > Ambiente > Parâmetros > Gestão de Estoque, Compras e Faturamento > 04.09 – Outras Movimentações > Tipo de Movimento > Mov – Outros Dados”.

Apresentamos abaixo, conforme o modelo de áreas do projeto padrão TOTVS Smart Analytics/Gooddata as respectivas Fatos e Indicadores.

Carteira de Vendas

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

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.

Vendas

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

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.

Faturamento

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

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.

Análise de Crédito

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

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.

Devolução de Vendas

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

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.

Entrega de Vendas

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

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

Campo	Descrição
Empresa (HLP_EMPRES)	Código de Coligada.
Estabelecimento (HLP_ESTABL)	Código de Filial.
Unidade de Negócio (HLP_UNDNEG)	Ausente
Moeda (HLP_MOEDA)	"R$"
Sindicato (HLP_SINDIC)	Código de Sindicato vinculado ao funcionário.
Turno (HLP_TURNO)	Código de horário de trabalho do funcionário.
Evento (HLP_EVENTO)	Código do Evento da Ficha Financeira.
Mão de Obra (HLP_TIPMOB)	Ausente
Plano Centro Custo (HLP_PLCCST)	Ausente
Centro de Custo (HLP_CCUSTO)	Centro de Custo da Seção do funcionário.
Colaborador (HLP_COLABR)	Código de Pessoa.
Cargo(HLP_CARGO)	Código de Função.
Nível Hierárquico (HLP_NIVHIE)	Código do Cargo do funcionário.
Faixa Salarial (HLP_FXASAL)	Tabela Salarial do funcionário.
Categoria Salarial (HLP_CATSAL)	Código de recebimento
Região (HLP_REGIAO)	Código de Município + Código de UF
Estado Civil (HLP_ESTCIV)	Estado Civil do funcionário
Faixa Etária (HLP_FXAETA)	Faixa Etária do Colaborador de acordo com faixas determinadas em parâmetro.
Grau de Instrução (HLP_GRAINS)	Código do grau de Instrução da Pessoa.
Tempo Casa (HLP_TPCASA)	Tempo total desde que o funcionário foi admitido, até a data atual.
Tempo Cargo (HLP_TPCARG)	Tempo total em que o funcionário ocupa o cargo atual.
Relação Trabalho (HLP_RELTRB)	Tipo do Cadastro do funcionário.
Situação Colaborador (HLP_SITCLB)	Código de situação do funcionário.
Localidade (HLP_LOCALI)	Ausente
Prestador Serviço (HLP_PRESRV)	Ausente
Plano Lotação (HLP_PLOTAC)	Ausente
Unidade Lotação (HLP_ULOTAC)	Ausente
Seção (HLP_SECAO)	Código de seção a qual o funcionário pertence.

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.