Melhorias Cálculos com uso de...

1

Boletim Técnico

IMB – Melhorias Cálculos com uso Fórmula

Produto : RM TOTVS Incorporação 12.1.1

Processo : Reajustes

Subprocesso : Melhorias Cálculos com uso Fórmula

Data da publicação

: 30/10/13

Essa funcionalidade permite ao usuário definir novas modalidades de aluguéis, sem a necessidade de se alterar a codificação do sistema.

Para executar a funcionalidade terá que executar as seguintes etapas:

Aluguel em dobro 1ª – Habilitar o cálculo de fórmula por prioridade:

Desenvolvimento/Procedimento

Melhorias Cálculos com uso de Fórmulas

2

Boletim Técnico ‘


2ª - Marcar o parâmetro no RM Fluxus para permitir lançamentos zerados:

3ª - Cadastrar os “tipos de dados” básicos: Menu: Serviços Globais -> Metadados http://wikihelp.totvs.com.br/WikiHelp/GLB/GLB.MetadadosTipoDados.aspx

http://wikihelp.totvs.com.br/WikiHelp/GLB/GLB.MetadadosTipoDados.aspx

3

Boletim Técnico


4º - Criar a tabela de Faturamento Mensal “ZMDFATURAMENTOMENSAL” para armazenar o faturamento mensal;

4



5ª - Criar o Modelo de Negócio “Faturamento Mensal”:

5

Boletim Técnico


6 ª - Criar o Formulário para cadastro do “Faturamento Mensal”:

6



7ª - Criar um projeto “Faturamento Mensal”:

7

Boletim Técnico


8 ª - Executar o Processo “Gerar Projeto de Metadados” para o projeto:

Sempre que apagar o arquivo “broker.dat” (atualizando a versão) é necessário executar novamente

este processo para gerar o projeto.

9ª - Alimentar a tabela de “Faturamento Mensal” - A parcela do mês de agosto/2009 terá o valor do aluguel dobrado por que o campo “DOBRADO” é igual a “1”:

8



Este valor será utilizado para calcular o valor da parcela de aluguel no processo de reajuste.

Criando os campos complementares na Venda

11ª - Acesse Menu: Cadastros -> Campos Complementares -> Venda:

9

Boletim Técnico


12ª - Campo Complementar: FATURA_MIN_ANUAL(Faturamento Mínimo Anual):

- Armazena o valor do aluguel mínimo anual definido em contrato:

10



13ª - Campo Complementar: MOEDA(Moeda de Correção Monetária):

- Armazena a moeda a ser usada no cálculo da correção monetária:

14ª - Na aba Campos Complementares da Venda/Aluguel deve aparecer o campo “Faturamento Mínimo Anual” e a “Moeda de Correção Monetária”:

11

Boletim Técnico


Configurando os Tipos de Parcela

15ª - Menu: Projetos -> Imobiliário -> Cadastros -> Tipos de Parcela:

16ª - Criar um Tipo de Parcela “98 - Aluguel Complementar”:

12



17ª - Criar um Tipo de Parcela “99 - Faturamento Mensal”:

Configurando os Componentes

18ª - Menu: Projetos -> Imobiliário -> Cadastros -> Componentes:

13

Boletim Técnico


19ª - Criar o Componente “99 - Aluguel Mensal em Dobro”: - O surgimento do Componente deve ser na valorização para que a fórmula seja disparada no reajuste:

O código do componente deve ser “99” para as fórmulas funcionarem.

Entre em anexo, associe um valor de integração com RM Fluxus.

20ª - Criar o Componente “444 - Faturamento Mensal”: O surgimento do Componente deve ser na valorização para que a fórmula seja disparada no reajuste:

14



O código do componente deve ser “444” para as fórmulas funcionarem.

O tipo de parcela deve ser “99 – Faturamento Mensal” para gerar uma parcela. Entre em anexo, associe um valor de integração com RM Fluxus.

Configurando as Fórmulas 21ª - Menu: Serviços Globais -> Administração -> Fórmulas: - Pega o valor do campo complementar “XVENDACOMPL.FATURA_MIN_ANUAL”, aplica a correção monetária e divide por 12 meses:

- Fórmula: “FRM0009 – CALCULA ALUGUEL MINIMO ANUAL (LOJAS AMERICANAS)”

DECL MOEDA;

EXECSQL('SQL00003');

SETVAR(MOEDA, RESULTSQL('SQL00003', 'MOEDA'));

RESULTSQL('SQL00003', 'FATURA_MIN_ANUAL') *

(1 + RECALCULACORRECAOMONETARIA(MOEDA,

DATBASE,

DATREAJUSTE,

REXPARCELAPAGAMENTO('DAT_VCTO'),

12,

0)

)

15

Boletim Técnico


22ª - Fórmula: “FRM0005 – CALCULA PERCENTUAL SOBRE O FATURAMENTO” - Multiplica o “Valor do Faturamento Mensal” e o “Percentual sobre o Faturamento” informados na tabela de meta dados:


RESULTSQL('SQL00004', 'FATURAMENTO_MENSAL') *

(RESULTSQL('SQL00004', 'PCT_FATURAMENTO') / 100)

16



23 - Fórmula: “FRM0010 – DATA INICIAL DO PERIODO ANUAL ANTERIOR” Data inicial do ano anterior.

ADICIONAMESES(DATBASE, (PERIODOANUAL) * 12)

24ª - Fórmula: “FRM0011 – DATA FINAL DO PERIODO ANUAL ANTERIOR”

Pega a data final no ano anterior.


17

Boletim Técnico


25ª - Fórmula: “FRM0013 – CALCULA ALUGUEL MENSAL (EM DOBRO)” - Executa a fórmula “FRM0009” para calcular o aluguel mínimo mensal e dobra ou não o valor da parcela:

DECL ALUGUELMINIMOMENSAL;

DECL ALUGUELDOBRADO;


SETVAR(ALUGUELDOBRADO, RESULTSQL('SQL00004', 'DOBRADO') + 1);

SETVAR(ALUGUELMINIMOMENSAL, FOR('FRM0009') / 12);

ALUGUELMINIMOMENSAL * ALUGUELDOBRADO

18



26ª - Fórmula: “FRM0018 – CALCULA FATURAMENTO MENSAL (EM DOBRO)” Calcula o valor excedente do percentual sobre o faturamento em relação ao aluguel mínimo e dobra ou não:


DECL PCTFATURAMENTO;

DECL ALUGUELDOBRADO;

SETVAR(PCTFATURAMENTO, FOR('FRM0005'));



SETVAR(ALUGUELDOBRADO, RESULTSQL('SQL00004', 'DOBRADO') + 1);

SE (PCTFATURAMENTO > ALUGUELMINIMOMENSAL)

ENTAO (PCTFATURAMENTO - ALUGUELMINIMOMENSAL) * ALUGUELDOBRADO

SENAO 0

FIMSE

19

Boletim Técnico


27ª - Fórmula: “FRM0019 – CALCULA FATURAMENTO MENSAL (SEM DOBRAR)”

- Calcula o valor excedente do percentual sobre o faturamento sem dobrar:


DECL PCTFATURAMENTO;

SETVAR(PCTFATURAMENTO, FOR('FRM0005'));


SE (PCTFATURAMENTO > ALUGUELMINIMOMENSAL)

ENTAO (PCTFATURAMENTO - ALUGUELMINIMOMENSAL)

SENAO 0

FIMSE

20



28ª - Fórmula: “NUMVENDA – Numero da Venda no reajuste”

- Utilizada para passar como parâmetro nas Consultas SQL:

29ª - Fórmula: “CODGRUPO – Grupo da parcela no reajuste”


21

Boletim Técnico


30ª - Fórmula: “NUMPARC – Numero da parcela no reajuste”


31ª - Fórmula: “DATVCTO – Vencimento da parcela no reajuste”


22



32ª - Configurando as Consultas SQL

- Acesse no Menu: Gestão -> Visões de Dados:

33ª - Consulta SQL: “SQL00002 – CALCULA TOTAL ALUGUEL MENSAL + ENCARGO COMUM”

- Calcula o total de faturamento no ano anterior para calcular o aluguel complementar.

23

Boletim Técnico


SELECT SUM(PC.VR_COMPN) TOTAL_ANUAL

FROM XPARCELAPAGAMENTO PP (NOLOCK) JOIN

XPARCELACOMPONENTE PC (NOLOCK)

ON (PP.NUM_VENDA = PC.NUM_VENDA) AND

(PP.COD_GRUPO = PC.COD_GRUPO) AND

(PP.COD_TIPO_PARC = PC.COD_TIPO_PARC) AND

(PP.NUM_PARC = PC.NUM_PARC)

WHERE PP.NUM_VENDA = :FRM_NUMVENDA AND

PC.COD_COMPN IN (77, 222) AND

(PP.DAT_VCTO >= :FRM_FRM0010) AND

(PP.DAT_VCTO < :FRM_FRM0011) 34ª - Consulta SQL: “SQL00003 – CONSULTA CAMPOS COMPLEMENTARES DA VENDA”

- Consulta o valor dos campos complementares da venda:

SELECT *

FROM XVENDACOMPL (NOLOCK)

WHERE (NUMVENDA = :FRM_NUMVENDA)

24



35ª - Consulta SQL: “SQL00004 – CONSULTA CAMPOS DA TABELA ZMDFATURAMENTOMENSAL”

- Consulta o valor dos campos na tabela de metadados na data de vencimento da parcela:

SELECT *

FROM ZMDFATURAMENTOMENSAL (NOLOCK)

WHERE (NUM_VENDA = :FRM_NUMVENDA) AND

(YEAR(DATA) = YEAR(:FRM_DATVCTO)) AND

(MONTH(DATA) = MONTH(:FRM_DATVCTO))

25

Boletim Técnico


36ª - Criar a Modalidade “20 - Aluguel em Dobro (Mínimo + Faturamento)”:

- Esta modalidade deve dobrar o valor do boleto de aluguel mínimo e o valor boleto de faturamento mensal:

37ª - Criar a regra da modalidade “Aluguel Mensal (Em Dobro)”: - Associar o Componente: “99 – Aluguel Mensal (Em Dobro)”

26



38ª - Associar a fórmula “FRM0013 – CALCULA ALUGUEL MENSAL (EM DOBRO)” e definir a prioridade de cálculo para 1:

39ª - Criar a regra da modalidade “Faturamento Mensal”: - Associar o componente: “444 – Faturamento Mensal”: Obs: Informar o dia de vencimento da parcela de faturamento mensal (boleto complementar):

27

Boletim Técnico


40ª - Associar a fórmula “FRM0018 – CALCULA FATURAMENTO MENSAL (EM DOBRO)” e definir a prioridade de cálculo para 2:

41ª - Criar a Modalidade “21 - Aluguel em Dobro (apenas o Mínimo)” - Esta modalidade deve dobrar o valor do aluguel mínimo sem dobrar o valor do faturamento:

1. Criar a Modalidade “Aluguel em Dobro (apenas o Mínimo)”

28



42ª - Criar a regra da modalidade “Aluguel Mensal (Em Dobro)”: - Associar o Componente: “99 – Aluguel Mensal (Em Dobro)”

43ª -Associar a fórmula “FRM0013 – CALCULA ALUGUEL MENSAL (EM DOBRO)” e definir a prioridade de cálculo para

1:

29

Boletim Técnico


44ª - Criar a regra da modalidade “Faturamento Mensal”: - Associar o componente: “444 – Faturamento Mensal”: Obs: Informar o dia de vencimento da parcela de faturamento mensal(boleto complementar):

45ª - Associar a fórmula “FRM0019 – CALCULA FATURAMENTO MENSAL (SEM DOBRAR)” e definir a prioridade de cálculo para 2:

30



2. Criando um Aluguel em dobro (Mínimo + Faturamento) 46ª - Menu: Contratos -> Contratos de Vendas e Alugueis: - Criando um Aluguel em Dobro (Mínimo + Faturamento): - Associar a modalidade de venda: “Aluguel em Dobro (Mínimo + Faturamento)”

47ª - O reajuste deve ser realizado mensalmente após informar o faturamento mensal na tabela de metadados.

Obs: antes de reajustar o contrato é necessário alimentar a tabela de metadados “Faturamento Mensal”.

31

Boletim Técnico


48ª - Informe nos campos complementares do aluguel o faturamento Mínimo Anual e a moeda de Correção Monetária:

49ª - No mês de agosto/2009 o valor da parcela foi dobrado:

32



50ª - O gráfico em vermelho são as parcelas de “faturamento mensal” (boleto complementar):

33

Boletim Técnico


Aluguel mínimo anual

1ª - Habilitar o cálculo de fórmula por prioridade:

1.

2ª - Marcar o parâmetro no RM Fluxus para permitir lançamentos zerados:

34



3ª - Cadastrar os “tipos de dados” básicos:

- Menu: Serviços Globais -> Metadados

- http://wikihelp.totvs.com.br/WikiHelp/GLB/GLB.MetadadosTipoDados.aspx

4ª - Criar a tabela de Faturamento Mensal “ZMDFATURAMENTOMENSAL” para armazenar o faturamento mensal;

http://wikihelp.totvs.com.br/WikiHelp/GLB/GLB.MetadadosTipoDados.aspx

35

Boletim Técnico


Obs: Defina os campos NUM_VENDA e DATA como chave primária. 5ª - Criar o Modelo de Negócio “Faturamento Mensal”:

36



6ª - Criar o Formulário para cadastro do “Faturamento Mensal”:

37

Boletim Técnico


7ª - Criar um projeto “Faturamento Mensal”:

38



39

Boletim Técnico


8ª - Executar o Processo “Gerar Projeto de Metadados” para o projeto:

Obs: sempre que apagar o arquivo _broker.dat é necessário executar novamente este processo.

9ª - Alimentar a tabela de “Faturamento Mensal”:

40



Obs: Este valor será utilizado para calcular o valor da parcela de aluguel no processo de reajuste. 10ª - Criando os campos complementares na Venda - Menu: Cadastros -> Campos Complementares -> Venda:

41

Boletim Técnico


11ª - Campo Complementar: FATURA_MIN_ANUAL(Faturamento Mínimo Anual): - Armazena o valor do aluguel mínimo anual definido em contrato:

42



12ª - Campo Complementar: MOEDA(Moeda de Correção Monetária): - Armazena a moeda a ser usada no cálculo da correção monetária:

13ª - Na aba Campos Complementares da Venda/Aluguel deve aparecer os campos “Faturamento Mínimo Anual” e a “Moeda de Correção Monetária”:

43

Boletim Técnico


14ª - Menu: Projetos -> Imobiliário -> Cadastros -> Tipos de Parcela: - Criar o Tipo de Parcela “98 –Aluguel Complementar”:

15ª - Criar o Tipo de Parcela “99 –Faturamento Mensal”:

44



16ª - Menu: Projetos -> Imobiliário -> Cadastros -> Componentes: - Criar o Componente “77 -Aluguel Mensal (Americanas)”: - O surgimento do Componente deve ser na valorização para que a fórmula seja disparada no reajuste:

Obs: O código do componente deve ser “77” para as fórmulas funcionarem.

45

Boletim Técnico


17ª - Criar o Componente “66 - Encargo Comum”: O surgimento do Componente deve ser na valorização para que a fórmula seja disparada no reajuste:


46



18ª - Criar o Componente “222 - Fundo Promoção”: O surgimento do Componente deve ser na valorização para que a fórmula seja disparada no reajuste:


47

Boletim Técnico


19ª - Criar o Componente “444 – Faturamento Mensal”: - O surgimento do Componente deve ser na valorização para que a fórmula seja disparada no reajuste:


48



20ª - Criar o Componente “55 – Aluguel Complementar(America.)”: - O surgimento do Componente deve ser na valorização para que a fórmula seja disparada no reajuste:


49

Boletim Técnico


21ª - Menu: Serviços Globais -> Administração -> Fórmulas:

Fórmula: “FRM0001 – CALCULA ALUGUEL MENSAL”

DECL ALUGUELMINIMOANUAL;


SETVAR(ALUGUELMINIMOANUAL, FOR('FRM0009'));

SETVAR(ALUGUELMINIMOMENSAL, ALUGUELMINIMOANUAL / 12);

ALUGUELMINIMOMENSAL

50



22ª - Fórmula: “FRM0002 – CALCULA ENCARGO COMUM”

- Pega o valor do Encargo informado na tabela de metadados:


RESULTSQL('SQL00004', 'ENCARGO_COMUM');

51

Boletim Técnico


23ª - Fórmula: “FRM0003 – CALCULA FUNDO DE PROMOÇÃO” - Pega o valor do Fundo de Promoção informado na tabela de metadados:


RESULTSQL('SQL00004', 'FUNDO_PROMOCAO');

52



24ª - Fórmula: “FRM0005 – CALCULA PERCENTUAL SOBRE FATURAMENTO”

- Aplica o percentual de faturamento sobre o faturamento mensal do cliente:


RESULTSQL('SQL00004', 'FATURAMENTO_MENSAL') *

(RESULTSQL('SQL00004', 'PCT_FATURAMENTO') / 100)

53

Boletim Técnico


25ª - Fórmula: “FRM0006 – CALCULA ALUGUEL COMPLEMENTAR ANUAL (LOJAS AMERICANAS)” - De ano em ano calcula o aluguel complementar.

SE (MESDT(DATVCTO) = MESDT(DATBASE)) E

(DATVCTO > DATBASE)

ENTAO

FOR('FRM0008')

SENAO

0

FIMSE

54



26ª - Fórmula: “FRM0008 – CALCULA TOTAL ALUGUEL MENSAL + ENCARGO COMUM” - Utilizada para calcular o valor do “aluguel complementar anual” em janeiro:

DECL ALUGUELMINIMOANUAL;

DECL TOTALALUGUELANUAL;

SETVAR(ALUGUELMINIMOANUAL, FOR('FRM0009'));


SETVAR(TOTALALUGUELANUAL, RESULTSQL('SQL00002', 'TOTAL_ANUAL'));

SE (ALUGUELMINIMOANUAL > TOTALALUGUELANUAL)

ENTAO

ALUGUELMINIMOANUAL - TOTALALUGUELANUAL

SENAO

0

FIMSE

55

Boletim Técnico


27ª - Fórmula: “FRM0009 – CALCULA ALUGUEL MINIMO ANUAL (LOJAS AMERICANAS)” - Corrige o valor do campo complementar “XVENDACOMPL.FATURA_MIN_ANUAL” até o vencimento da parcela:

DECL MOEDA;


SETVAR(MOEDA, RESULTSQL('SQL00003', 'MOEDA'));

RESULTSQL('SQL00003', 'FATURA_MIN_ANUAL') *

(1 + RECALCULACORRECAOMONETARIA(MOEDA,

DATBASE,

DATREAJUSTE,

REXPARCELAPAGAMENTO('DAT_VCTO'),

12,

0)

)

56



28ª - Fórmula: “FRM0010 – DATA INICIAL DO PERIODO ANUAL ANTERIOR” Data inicial do ano anterior.


57

Boletim Técnico


29ª - Fórmula: “FRM0011 – DATA FINAL DO PERIODO ANUAL ANTERIOR”

- Pega a data final no ano anterior.


58



30ª - Fórmula: “FRM0016 – CALCULA FATURAMENTO MENSAL”

- Se for maior que zero então gera uma parcela (boleto complementar):

59

Boletim Técnico


31ª - Fórmula: “NUMVENDA – Numero da Venda no reajuste” - Utilizada para passar como parâmetro nas Consultas SQL:

60



32ª - Fórmula: “CODGRUPO – Grupo da parcela no reajuste” - Utilizada para passar como parâmetro nas Consultas SQL:

61

Boletim Técnico


33ª - Fórmula: “NUMPARC – Numero da parcela no reajuste”


62



34ª - Fórmula: “DATVCTO – Vencimento da parcela no reajuste”


63

Boletim Técnico


35ª - Configurando as Consultas SQL - Menu: Gestão -> Visões de Dados:

64



36ª - Consulta SQL: “SQL00002 – CALCULA TOTAL ALUGUEL MENSAL + ENCARGO COMUM” - Somatório dos componentes Aluguel Mensal e Encargo Comum do ano anterior ao vencimento da parcela:

SELECT SUM(PC.VR_COMPN) TOTAL_ANUAL

FROM XPARCELAPAGAMENTO PP (NOLOCK) JOIN

XPARCELACOMPONENTE PC (NOLOCK)

ON (PP.NUM_VENDA = PC.NUM_VENDA) AND

(PP.COD_GRUPO = PC.COD_GRUPO) AND

(PP.COD_TIPO_PARC = PC.COD_TIPO_PARC) AND

(PP.NUM_PARC = PC.NUM_PARC)

WHERE PP.NUM_VENDA = :FRM_NUMVENDA AND

PC.COD_COMPN IN (77, 222) AND

(PP.DAT_VCTO >= :FRM_FRM0010) AND

(PP.DAT_VCTO < :FRM_FRM0011)

65

Boletim Técnico


37ª - Consulta SQL: “SQL00003 – CONSULTA CAMPOS COMPLEMENTARES DA VENDA” - Consulta o valor dos campos complementares da venda:

SELECT *

FROM XVENDACOMPL (NOLOCK)

WHERE (NUMVENDA = :FRM_NUMVENDA)

66



38ª - Consulta SQL: “SQL00004 – CONSULTA CAMPOS DA TABELA ZMDFATURAMENTOMENSAL” - Consulta o valor dos campos na tabela de metadados:

SELECT *

FROM ZMDFATURAMENTOMENSAL (NOLOCK)

WHERE (NUM_VENDA = :FRM_NUMVENDA) AND

(YEAR(DATA) = YEAR(:FRM_DATVCTO)) AND

(MONTH(DATA) = MONTH(:FRM_DATVCTO))

67

Boletim Técnico


3. Configurando a Modalidade de Aluguel “17 - Aluguel Mínimo Anual (Lojas Americanas)”

68



39ª - Criar a regra da modalidade “77 - Aluguel Mensal”:

40ª - Associar a fórmula “FRM0001 – CALCULA ALUGUEL MENSAL (LOJAS AMERICANAS)” e definir a prioridade de cálculo para 1:

69

Boletim Técnico


41ª - Associar a fórmula “FRM0002 – CALCULA ENCARGO COMUM” e definir a prioridade de cálculo para 2:

42ª - Criar a regra da modalidade “222 - Fundo de Promoção”:

70



43ª - Associar a fórmula “FRM0003 – CALCULA FUNDO PROMOÇÃO” e definir a prioridade de cálculo para 3:

44ª - Criar a regra da modalidade “444 – Faturamento Mensal”:

71

Boletim Técnico


45ª - Criar a regra da modalidade “55 – Aluguel Complementar (America.)”:

72



73

Boletim Técnico


46ª - Criando um Aluguel (Lojas Americanas): - Menu: Contratos -> Contratos de Vendas e Alugueis: - Criar um contrato de aluguel: - Associar a modalidade de venda: “Aluguel Mínimo Anual(Lojas Americanas)”

74



47ª - Informar o “Faturamento Mínimo Anual” e a “Moeda de Correção” definido em Contrato: - Obs: Antes de reajustar é necessário informar o “Faturamento mínimo anual” e a moeda de correção monetária definido em contrato.

48ª - Alimentar a tabela de “Faturamento Mensal”: Obs: Antes de reajustar é necessário alimentar a tabela de metadados “Faturamento Mensal”.

75

Boletim Técnico


49ª - Reajustar o contrato de aluguel:

76



50ª - Anualmente será cobrado o aluguel complementar em vermelho:

Melhorias Cálculos com uso de...

Documents

Transcript of Melhorias Cálculos com uso de...