01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Uma medição de faturamento  que contém controle por grupo.

03. SOLUÇÃO

Conceitos

1. Introdução

Este manual foi desenvolvido para guiar você no uso do sistema de medição por grupo, incluindo as principais regras, cálculos e campos necessários para configurar e gerenciar medições. Ele descreve cada etapa do processo de medição, os campos que você deve preencher, e como o sistema irá tratar automaticamente os dados.

2. Visão Geral do Sistema

O sistema é dividido em quatro áreas principais, cada uma com sua função específica:

• Contratos: Onde você configura e define as condições de franquia do cliente.
• Cabeçalho da Medição: Configurações do período de medição (mensal).
• Itens de Medição: Onde são calculados os valores com base no consumo.
• Minutas: Detalhes do turno, configurando horas e franquias específicas.

3. Regras e Funcionalidades

3.1 Contratos

No módulo de Contratos, você configura o que chamamos de “franquia” – uma espécie de limite de consumo:

1. Franquia Compartilhada:
   • Configure a franquia compartilhada no campo FP0_XXXXX, todos os equipamentos do grupo utilizarão o mesmo pool de franquia, sendo assim . 
2. Franquia Individual:
   
   • Configure a franquia individual  no campo FP0_XXXXX, todos os equipamentos do grupo utilizarão suas franquia de forma separada.

3.2 Cabeçalho da Medição

1. Defina o Período:
   • Sempre feche o período por mês (ex.: 1 a 30/31, 20 a 19).
   • O primeiro período é inserido manualmente, e os seguintes seguem automaticamente o período anterior.
2. Ajuste de Datas:
   • Se precisar mudar o período, basta ajustar a data inicial ou final.

3.3 Itens de Medição

1. Base de Cálculo e Unidade:
   • Escolha a unidade de base: Hora, Dia, Contador ou Outros.
   • Exemplo: Se a medição for por horas, o valor será multiplicado pela quantidade de horas consumidas.
2. Totalizadores e Valores:
   • “Total de Horas”: Total de horas usadas.
   • “Horas Reais”: Total de horas excedentes, ou seja, as que estão fora da franquia.
3. Campos Importantes:
   • Valor Unitário: Por Hora, Dia, Contador ou Outros (ajusta automaticamente conforme o contrato).
   • Valor Total: Calculado pelo sistema (quantidade de horas reais x valor unitário).

3.4 Consumo de Franquia

1. Contadores de Franquia inidividual:
   • Sempre que uma franquia excede o limite, o sistema registra a quantidade como horas reais (excedentes).
2. Contadores de Franquia Compartilhada:
   • • Sempre que uma franquia excede o limite do total do grupo, o sistema registra a quantidade como horas reais (excedentes).

3.5 Minutas (Detalhamento por Turno)

1. Registro de Turnos:
   • No registro de turnos, as horas paradas e as horas totais são detalhadas, considerando o mínimo de horas para o dia, não se utiliza franquia para esse caso.

Função incluir 

Cabeçalho Campos Medição:

Tip. Medição FQK_TPMED: Define como será realizada a medição: A=AS ou G= Grupo

Projeto FQK_PROJET: Seleciona o projeto para realizar a medição

 Grup. Medição FQK_GRPMD: Seleciona o grupo de itens para realizar a medição.

 AS FQK_AS: Informa a (as) A.S vinculadas ao projeto.

Per. Medição FQK_PMEDI: Período específico para a medição

Nro. Medição FQK_COD: Sequencial das medições realizadas.

Seq. Medição FQK_MEDSEQ: Sequencial que informa quantas medições já foram realizadas no projeto.

Data Inicial FQK_DTINIC: Data inicial para o período da medição

Data Final FQK_DTFIM: Data final para o período da medição

Cabeçalho Campos Cálculo:

Min. Hrs. Mês FQK_MINMES: Informação de mínimo de horas para a medição

Franq. Calc. FQK_VLRFRA: Cálculo realizado de acordo com o período da medição informado

Qtd. Total FQK_QTDKM : Informa diferença entre a quantidade inicial e final.

Tot +/- Base FQK_DUBASE: Quantidade manipulada pelo usuário.

Qtd. Tot. Base FQK_QTDTOT: quantidade total para cobrança de medição

Tot. Cob. Base FQK_QTDHR: valor que excede a franquia;

Vlr. Tot. Medi FQK_VLRTOT: valor total da medição.

Vlr. Desconto FQK_VLRDES: valor do desconto se informado na medição.

Vlr. Acresc. FQK_VLRACR: valor acréscimo se informado na medição.

Vlr. Frete FQK_VLRMOB: valor do Frete se informado na medição

Vlr. Seguro FQK_VALSEG: valor seguro se informado na medição. 

Vlr. ISS FQK_VLAISS: valor informado se for serviço

Vlr. Serviço FQK_VALSER: valor total do serviço.

Tot. Mão Obra FQK_VLTOTM: campo para informação do valor da mão de obra.  

Vlr. Extr FQK_VREXTR: se houver valor extra será informado.

Tot. Máquina FQK_VLMAQ: campo para informação do valor da máquina. 

Cabeçalho Campos Administrativo:

Cliente FQK_CLIENT: número do cliente origem

Loja FQK_LOJA:  campo com a informação de loja do cliente de origem.

Nome Cliente FQK_NOMAGE:  campo com a informação cliente de origem.

Cond. Pgto FQK_CONDPA:  condição de pagamento a ser aplicada na cobrança

Situação FQK_SITUAC:  situação em que se encontra a medição

Natureza FQK_NATUR: Campo com informação da natureza fiscal utilizada.

Tipo FQK_TIPO: Tipo da medição

Cód. Vendedor FQK_CODVEN: Código do vendedor informado no projeto

Nom. Vendedor FQK_NOMVEM:  Nome do vendedor informado no projeto

Cli. Fat. FQK_CLIFAT: Quando preenchido será usado como cliente no faturamento automático.

Loj. Cli. Fat. FQK_LOJFAT:  campo com a loja do cliente Faturamento.

Nom.Cli.Fat FQK_NOMFAT: campo com o nome do cliente de Faturamento

Int. Contador FQK_INTCON: Integrador Sim/ Não (Gerenciamento de Bens, contador bem)

Tp. Cons. Fran FQK_TPFRAN: Indicação do tipo de consumo da franquia

Obra FQK_OBRA: campo contendo a numeração sequencial da obra

Viagem FQK_VIAGEM: Campo com o número da viagem

Observação FQK_OBS:  campo para inclusão de observações sobre a medição

Obs. Desc. FQK_OBSDES: campo para inclusão de observações sobre a medição

Obs. Acresc. FQK_OBSACR:  campo para inclusão de observações sobre a medição

TES Mão Obra FQK_TESMAO: campo para informação de TES específica para mão de obra

TES Máquina FQK_TESMAQ: campo para informação de TES específica para máquina

Campos Aba Itens da Medição:

Item FQL_ITEM: sequência do item para a medição

Ordem FQL_ORDEM: sequencial dos itens da medição

AS FQL_AS: A.S informada no projeto

Dt. Medição FQL_DTMEDI: Data em que a medição está sendo realizada.

Dt. Expedição FQL_DTSAID: Campo para informação do início da medição

Dt. Dev FQL_DTENT: Campo para informação de devolução do bem.

Bem FQL_FROTA: Campo que informa o bem do projeto para medição  

Descrição FQL_DESCEQ: Descrição do bem

Min. Hrs. Dia FQL_MINDIA: Campo para informação de mínimo de horas dia.

Hr.Parada FQL_HRPARA: Informação de horas paradas para a medição.

Base Cálculo FQL_BASE: Informa qual tipo de cálculo será realizado na medição

Grp. Medição FQL_GRPMD: grupo em que foi realizado a medição.

Franquia FQL_BFRANQ: Base da Franquia informada no projeto

Franquia FQL_FRKM: valor referente a franquia

Franq. Calc FQL_VLRFRA: franquia calculada de acordo com o período conforme as datas (Data Inicial FQK_DTINIC: Data inicial  e  Data Final FQK_DTFIM: Data final para o período da medição) do períodos informado no cabeçalho e base (mensal ou diária). 

Qtd. Inicial FQL_KMINI: quantidade inicial do contados do bem, a partir da sequência 002 o sistema irá coletar a quantidade final da medição anterior.

Qtd. Final FQL_KMFIM: quantidade final referente a medição realizada no período.

Qtd. Complem FQL_COMPLE: quantidade complementar

Qtd. Total FQL_QTDKM: Informa diferença entre a quantidade inicial e final.

Qtd. +/- Base FQL_DUBASE: Alteração manipulada pelo usuário da Qtd. Cob, base (FQL_QTDHR) .

Qtd. Tot. Base FQL_HORTOT: quantidade total para cobrança de medição.

Vlr. Uni. Base FQL_VALHOR: valor informado para cálculo da medição

Qtd. Cob. Base FQL_QTDHR: valor que excede a franquia;

Qtd. Compart. FQL_QTDHR2: valor complementar se houver

Vlr. Tot.Item FQL_VLTOHR: valor a ser cobrado da medição

Vlr. Tot.Medi FQL_VLRTOT: valor total da medição.

% Desc FQL_PERD: porcentagem de desconto na medição

Vlr. Desconto FQL_DESC: informação de desconto na medição se houver.

% Acresc. FQL_PERA: porcentagem de acréscimo na medição

Vlr. Acresc. FQL_ACRES: informação de valor de acréscimo medição se houver.

Vl. Mobiliz FQL_VLRMOB: valor informado de mobilização

Vlr. DesmobIL FQL_VLRDES: valor informado de desmobilização

Tipo Seguro FQL_TIPO: tipo de seguro se informado

% Seguro FQL_PERSEG: porcentagem de seguro na medição

Vlr. Base Seg. FQL_VLBSEG: porcentagem da base do seguro

Vlr. Seguro FQL_VALSEG: valor informado referente ao seguro

Tipo ISS FQL_TPISS: se for serviço

%ISS FQL_PERISS: porcentagem de ISS serviço

Vlr. ISS FQL_VALISS: valor ISS serviço

% Mão Obra FQL_PERMO: porcentagem destinada a mão de obra

Vlr. Mão Obra FQL_VLTOTM: valor referente a porcentagem informada mão de obra

Trans./ Peso FQL_TRSPES: valor referente a cobrança extra de serviço.

Ancoragem FQL_ANCORA: valor referente a cobrança extra de serviço.

Telescopagem FQL_TELESC: valor referente a cobrança extra de serviço.

Montagem FQL_MONTAG: valor se houver montagem

Desmontagem FQL_DESMON: valor se houver desmontagem

Vlr. Acessor FQL_ACESSO: valor referente a cobrança extra de serviço.

Centro Lucro FQL_CCUSTO: relacionado ao centro de custo que irá para o pedido e venda

% Máquina FQL_PERMAQ: porcentagem destinada a máquina

Vlr. Máquina FQL_VLMAQ: valor referente a porcentagem informada máquina

Obra FQL_OBRA: obra realizada na medição

Turno FQL_TURNO: se informado traz a sequencial

Nro. Medição FQL_COD: número da sequência da medição

Tp.AS FQL_TPAS: Tipo informado no projeto

Tp. Contador FQL_TPCONT:  Informa o contador que será utilizado no equipamento

Cód. Produto FQL_PROD: Informação sobre o código do produto.

Bem Reserva FQL_BEMRES: informa se o é bem reserva.

Passos para o item da Medição 

1. Preenchimento das Datas:
   • Preencha as datas de início (FQK_DTINIC) e fim da medição (FQK_DTFIM). Isso permitirá o cálculo da franquia referente ao período inserido.
   • Exemplo 1: Em um período de 30 dias com franquia de 100, se o campo FPA_BASFRA (Base da Franquia) for "mensal", teremos o valor de FPA_VLRFRA (Franquia calculada) = 100.
   • Exemplo 2: Em um período de 30 dias com franquia de 100, se o campo FPA_BASFRA (Base da Franquia) for "diária", teremos o valor de FPA_VLRFRA (Franquia calculada) = 3000.
2. Validação da Data de Expedição e devolução:
   • Após preencher as datas do cabeçalho da medição, valide a data de expedição, que pode ser a data de início do cabeçalho ou a data da geração da NF de remessa, conforme configurado pelo parâmetro acionado pela tecla F12 e a mesma regra se aplica a data de devolução que pode trazer a data final da medição ou a data da NF de retorno dependendo do parâmetro da tecla F12.
3. Preenchimento das Quantidades:
   • Preencha o campo FQL_KMINI (Quantidade inicial) e FQL_KMFIM (Quantidade final) para especificar o quanto foi usado do equipamento. O resultado da utilização será apresentado no campo FQL_QTDKM(Qtd.Total).
   • Ao realizar a sequência 002, o campo  FQL_KMINI (Quantidade inicial) será igual ao campo FQL_KMFIM (Quantidade final) da sequência 001.
4. Validação da Quantidade Cobrada:
   • Valide o campo FQL_QTDHR (Quantidade cob. base), que é o resultado da subtração entre Qtd.Total e Franquia calculada. Este campo indica o valor do excedente da utilização do equipamento.
5. Cálculo do Valor Total:
   • O valor total do campo FQL_VLTOHR (Vlr.Tot.Item) será calculado multiplicando FQL_QTDHR(Quantidade cob. base) por FQL_VALHOR (Vlr.Uni.Base).
   • O campo FQL_VLRTOT (Vlr.Tot.Medi) representa o valor total da medição, incluindo acréscimos como mobilização, desmobilização, ISS, seguro, desconto, transporte/peso, ancoragem, telescopagem, montagem, desmontagem e valor dos acessórios.
6. Distribuição de Custos:

Os campos FQL_PERMAQ (%Máquina) e FQL_PERMO (%Mão de obra) serão utilizados para designar a porcentagem do valor total da medição que foi utilizado em mão de obra e em máquina.

Passos para o item da Medição.mp4

Campos Aba Minuta:

Código FPF_COD

Descrição FPF_DESC

Frota FPF_FROTA: Informação do bem

Número AS FPF_AS: informada no projeto

Data FPF_DATA: data  da minuta

Minuta FPF_MINUTA: número sequencial da minuta

Projeto FPF_PROJET: Número do projeto

Obra FPF_OBRA: obra referente ao projeto

Minuta Manual FPF_MINUTM: número de a minuta for realizada manualmente

Nro Medição FPF_NROMED: número sequencial da medição

Hora Inicial FPF_HORAI: hora início informada no projeto

Hora Final FPF_HORAF: hora final informada no projeto

Hora Parada FPF_HRPARA: Informa a quantidade e horas paradas durante a medição.

Mot. Parada FPF_MOTIVO: motivo informado para a parada

Mot. Canc. FPF_MOTCAN: Motivo do cancelamento da Minuta.

Status FPF_STATUS: Informa em que status está a minuta.

Tipo Bem FPF_TIPOSE: Tipo informado no contrato.

Jantar Ini FPF_BXJANI: se informado hora inicial do intervalo da janta

Jantar Fim FPF_BXJANF: se informado hora inicial do intervalo da janta

Obs Baixa: informação complementares.

Almoço Ini FPF_BXALMI: se informado hora inicial do intervalo de almoço

Almoço Fim FPF_BXALMF: se informado hora final do intervalo de almoço

Real Ini FPF_HREALI:  hora inicial

Real Fm FPF_HREALF: hora final

Emissão: data de emissão.

Dt Ocorrenci FPF_DTOCOR: se houver ocorrência a data é informada.

H.Tot.Baixada:  hora total

Tot. Realiz: hora total realizada

Min. Dia: quantidade de horas mínimo dia

Turno: se informado traz a sequencial.

Função Manutenção

Dentro da rotina de medição por grupo, existe o botão de manutenção, que só pode ser utilizado quando a medição estiver com o status “digitado”. A funcionalidade de manutenção permite alterar os dados da medição conforme necessário.

Na seção de manutenção, em "outras ações", estão disponíveis as seguintes funcionalidades:

1. Imprime Cadastro:
   • Gera um relatório contendo todos os dados do cabeçalho da medição selecionada para manutenção.
2. Visualizar Projeto:
   • Permite ao usuário visualizar todas as abas do projeto, incluindo a parte de turnos, acessível através de "outras ações".
3. Histórico do Contador:
   • Proporciona ao usuário a possibilidade de acompanhar o histórico do contador do equipamento que está posicionado na medição.
4. Atualizar:
   • Se um novo item for adicionado ao contrato ou se um item deletado precisar ser reinserido, o botão "Atualizar" realiza a atualização do grid com os novos itens, reiniciando todo processo de digitação.

Mudança de situação

Mudança de Situação na Rotina de Medição

Essa funcionalidade permite alterar a situação da medição selecionada, com as seguintes opções:

• Digitado: A medição foi criada e está pronta para ser preenchida com dados, aguardando a próxima etapa.
• Em Aprovação: A medição foi finalizada e enviada ao cliente, sem possibilidade de novas alterações. Estamos aguardando a geração do pedido de venda para faturamento ou o retorno ao status 'Digitado', caso sejam necessárias correções. Se não houver excedentes, o sistema alterará automaticamente a legenda para 'Sem Excedente'.
• Não Aprovado: A medição foi preenchida, mas não foi aprovada para a geração do pedido de venda.
• Cancelado: A medição foi cancelada por algum motivo e não pode ser recuperada.

Essa funcionalidade assegura um controle rigoroso sobre o estado de cada medição, facilitando a gestão e o acompanhamento de todo o processo.

Mudança de situação.mp4

Legenda

• Digitado: A medição foi criada e pode ser preenchida com dados, pronta para a próxima etapa.
• Em Aprovação: A medição foi preenchida e aguarda a geração do pedido de venda, sem aceitar alterações.
• Cancelado: A medição foi cancelada e não pode ser recuperada.
• Medido: Foi gerado o pedido de venda da medição.
• Não Aprovado: A medição foi preenchida, mas não foi aprovada para a geração do pedido de venda.
• Sem Excedente: A medição não possui valor a ser cobrado, pois a utilização não excedeu a franquia.

Esses status permitem um controle eficiente e preciso das medições.

Gerar pedido de venda

Antes de gerar o pedido de venda da medição por grupo, é essencial revisar as abas de Cálculos e Administrativa e configurar os seguintes parâmetros:

• MV_LOCX063: Produto equipamento para medição.
• MV_LOCX064: Produto para MDO de medição (usando percentual de MDO).

Esses parâmetros garantem que o pedido de venda inclua apenas dois itens: um para equipamentos e outro para mão de obra.

Aba de Cálculos

• Apresenta o valor total da medição, que pode ser separado entre valor de mão de obra e valor de máquina.
• Os valores podem ser ajustados pelos campos % Mão de Obra (FQL_PERMO) e % Máquina (FQL_PERMAQ).

Aba Administrativa

• Permite selecionar a condição de pagamento, natureza, código do vendedor, cliente para faturamento, TES de mão de obra e TES de máquina.

Após a revisão, a medição deve ser enviada para o status "Em Aprovação", indicando se há excedentes a serem cobrados. Finalmente, o pedido de venda pode ser gerado acessando "Gerar Pedido de Vendas" em "Outras Ações".

Os detalhes dos itens cobrados podem ser validados dentro do pedido de vendas na opção de "Complementos de Locação" em "Outras Ações".

Custo extra

• Se Houve um custo extra liberado para faturamento o sistema irá faturar também em um pedido separado.

Estorno do pedido de venda

O estorno do pedido de venda só pode ser realizado em medições com o status "Medido". Para efetuar o estorno:

1. Botão "Estornar Pedido de Venda":
   • Acesse o botão "Estornar Pedido de Venda" em "Outras Ações".
   • Isso excluirá o pedido de venda gerado, retornando a medição ao status "Em Aprovação".
2. Rotina de Exclusão de Pedido de Venda:
   • Acesse a rotina de exclusão de pedido de vendas no módulo (05 Faturamento).
   • Realize a exclusão do pedido de venda pela rotina, e o status da medição retornará para "Em Aprovação".

Este processo assegura que o pedido de venda seja corretamente revertido, permitindo a revisão ou correção necessária na medição.

04. DEMAIS INFORMAÇÕES

Para os campos Mob / Desmob, onde os campos FPA_VRMOB e FPA_VRDES não estão marcados como "usado", a alteração deve ser realizada via Configurador(link abaixo) sempre que necessário.

Esses campos estão disponíveis para edição diretamente no Configurador, garantindo que qualquer ajuste seja feito conforme a necessidade específica do cliente.

https://centraldeatendimento.totvs.com/hc/pt-br/articles/360001052008-Framework-Linha-Protheus-Definir-campo-como-obrigat%C3%B3rio

05. ASSUNTOS RELACIONADOS

Cadastro de Calendário de Medições

Cadastro de período de Medição