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

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.

...

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_GRPMED: 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: Sequencial das medições realizadas.

Seq. Medição: 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: Informação de mínimo de horas para a medição

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

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

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

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

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

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

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

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

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

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

Vlr. ISS: valor informado se for serviço

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

Tot. Mão Obra: 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 FQFFQK_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

...

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. 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_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_KMINIKMFIM: 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.

...

Montagem FQL_MONTAG: valor de 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.

...

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.

Campos Aba Minuta:

Código FPF_COD

Campos Aba Minuta:

Código FPF_COD

Descrição FPF_Descrição FPF_DESC

Frota FPF_FROTA: Informação do bem

...

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

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.

...

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".
   • 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çãoEste processo assegura que o pedido de venda seja corretamente revertido, permitindo a revisão ou correção necessária na medição.