DFA John Deere

Características do Requisito

Descrição

Este conjunto de rotinas foi criado para atender a demanda de análise financeira da John Deere denominada DFA – Dealer Financial Analysis. O concessionário informará através de um conjunto de cadastros no Protheus, denominado DEF, a forma de obtenção dos valores para cada linha do plano de contas exigido pela John Deere. Por fim, será gerado um arquivo para envio a John Deere com as informações necessárias.

No Protheus, o processo consiste em cadastrar o cabeçalho do DEF com informações referentes a ele.  Nesse cadastro o usuário deve indicar quais filiais poderão gerar o DEF. Em seguida criam-se os itens do DEF representando cada linha do plano de contas disponibilizado pela John Deere. A criação dos itens é a parte mais importante e complexa do processo.

Após o cadastramento completo dos itens do DEF, o usuário deve gerá-lo indicando o período a ser levantado. Após a geração o usuário pode imprimir relatórios ou realizar consultas/alteração de valores. Uma vez que os valores estejam validados o passo final consiste em gerar o arquivo texto que será enviado à montadora.

Importante

Antes de executar o compatibilizador informe o UPDOFIOL é imprescindível:

• Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório \PROTHEUS11_DATA\DATA) e dos dicionários de dados SXs (diretório \PROTHEUS11_DATA\SYSTEM).
• Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
• Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
• Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
• O compatibilizador deve ser executado com a Integridade Referencial desativada*.

1. Em TOTVS Smart Client, digite o U_UPDOFIOL no campo Programa Inicial.
2. Clique em OK para continuar.
3. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado ou é apresentada a janela para seleção do compatibilizador. Selecione o programa xxxx().
4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
   1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
      É apresentada uma mensagem explicativa na tela.
   2. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
   3. Clique em Gravar para salvar o histórico (log) apresentado.
   4. Clique em OK para encerrar o processamento.

Atualizações do Compatibilizador

Criação de tabela no arquivo SX2– Tabelas:

Criação de Índices no arquivo SIX – Índices:

Procedimento para Configuração

CONFIGURAÇÃO DE MENUS

No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do Contabilidade Gerencial, conforme instruções a seguir:

Procedimento para Utilização

1. No Contabilidade Gerencial (SIGACTB) acesse Atualizações/DFA John Deere/Cadastro do DEF (OFIXA050).
2. Esta rotina realiza o cadastro do cabeçalho do DEF.
3. Clique em Incluir.
4. Nessa tela é possível configurar as características do DEF em questão, através dos campos listados abaixo:
   1. Descrição (VD7_DESDEF): informe aqui o nome do DEF. Texto livre utilizado pela concessionária para identificar um determinado DEF.
   2. Frequência (VD7_FREQUE): campo indica com que frequência o envio do DFA deve ser feito à montadora. Nos casos da John Deere, o envio é mensal. Este campo é importante para que o DFA seja gerado corretamente.
   3. Ativo? (VD7_ATIVO): identifica se o DEF ainda está em utilização. Se o DEF for inativado, o sistema não permitirá novas gerações, porém os históricos serão mantidos.
5. A parte inferior da tela será preenchida automaticamente com todas as filiais constantes no sistema. A partir daí, o usuário pode identificar quais filiais serão consideradas na geração do DEF em questão. Para indicar se as filiais serão ou não consideradas na geração, o usuário deve alterar na linha da tela inferior o campo Ativo (VD8_ATIVO) de acordo com a necessidade.
6. Ainda na parte inferior, o usuário poderá indicar qual é a rotina de geração dos itens do DEF classificadas como Calculadas (este conceito será explicado adiante) através do campo Fun.Geração (VD8_FUNGER). Esta rotina é uma função de usuário que permite a geração/customização dos cálculos destes itens.
7. ATENÇÃO! Como pode ser observado, esta rotina possui dois campos e dois conceitos de Ativo. O campo Ativo (VD7_ATIVO) do cabeçalho (parte superior da tela) refere-se à atividade do DEF no sistema como um todo. O campo Ativo (VD8_ATIVO) das linhas (parte inferior da tela) refere-se à atividade do DEF em uma determinada filial.
8. Acesse Atualizações/DFA John Deere/Itens do DEF (OFIXA051).
9. Após o cadastro do cabeçalho do DEF, o usuário deve cadastrar os itens do DEF, ou seja, cada uma das linhas do plano de contas do DFA disponibilizado pela John Deere.
10. Clique em Incluir.
11. A rotina possui três partes divididas horizontalmente. Na parte superior encontra-se o cabeçalho do item do DEF com informações gerais sobre a item. Na parte central, o usuário pode escolher em quais filiais o item do DEF está ativada. Na parte inferior o usuário pode escolher as contas contábeis a serem consideradas. A parte inferior somente será disponibilizada para utilização caso o usuário escolha algum tipo de item que envolva informações contábeis, conforme será explicado adiante.
12. Na parte superior o usuário deve preencher os campos a seguir:
    1. Código DEF (VD9_CODDEF): informe o código do DEF conforme cadastrado anteriormente.
    2. Cód.Conta (VD9_CONCTA) e Desc.Conta (VD9_DESCRI): estes campos são apenas informativos. Utilize-os apenas como referência ao código e descrição da conta contábil do plano de contas do DFA da John Deere.
    3. Ativo? (VD9_ATIVO): informe se este item do DEF está ativo ou não.
    4. Campo DEF (VD9_CPODEF): é o identificador da linha no Plano de Contas do DFA (fornecido pela John Deere). Este campo deve ser preenchido com 5 dígitos para que a conta contábil da John Deere seja forma a partir desta informação. A conta contábil da John Deere possui a seguinte estrutura:
       1. 3 primeiros dígitos do campo Campo DEF (VD9_CPODEF);
       2. 00;
       3. 2 últimos dígitos do campo Campo DEF (VD9_CPODEF);
       4. 2 últimos dígitos da filial levantada.

Exemplo: para a filial 01, informando o conteúdo 30110 no campo Campo DEF (VD9_CPODEF), a conta contábil a ser levada para o DFA da John Deere será 301001001.

Além disso, o conteúdo deste campo pode ser utilizado para campos acumuladores e expressões, conforme será explicado mais adiante.

1. Tipo? (VD9_TIPO): informe de que maneira os valores para este código DEF será obtido do sistema. As opções disponíveis são:
   1. 0=Sintético: um item classificado como sintética não possui qualquer valor ou cálculo envolvido. Trata-se apenas de uma descrição e quebra no arquivo. Este item é utilizado no DEF para sinalizar mudanças de blocos de linhas, como por exemplo ATIVO, PASSIVO, NOVOS, USADOS.
   2. 1=Calculado: os campos calculados são aqueles que requerem desenvolvimento de programas para a sua geração. Este cálculo é realizado por programa de usuário e cada concessionária deve personalizá-lo de acordo com a sua necessidade. O funcionamento dos campos calculados deve seguir a seguinte regra:

O programa de usuário cadastrado no DEF através do campo Fun.Geração (VD8_FUNGER), conforme citado anteriormente no cadastro da rotina Cadastro do DEF (OFIXA050), será executado automaticamente no momento da execução da rotina Geração do DEF (OFIXA052). Este programa obrigatoriamente deve retornar um vetor com o(s) valor(es) a ser(em) lançado(s). O índice/ posição de cada valor existente no vetor deve ser relacionado corretamente através do campo Ind.Valor (VD9_CODFOR) no cabeçalho da tela. Exemplo: no campo Fun.Geração (VD8_FUNGER), foi cadastrada a rotina GERADEF no campo de uma determinada filial. Neste caso, deve haver um programa de usuário (GERADEF.PRW) compilado no sistema. Quando o usuário solicitar a geração do DEF – Geração do DEF (OFIXA052) – esta rotina retornará um vetor com – por exemplo – dez valores correspondentes a dez linhas do plano de contas do DEF. Em cada uma dessas linhas cadastradas no Itens do DEF (OFIXA051), o número do índice da célula do vetor correspondente à informação da linha deve ser cadastrada no campo Ind.Valor (VD9_CODFOR).

Os campos calculados devem ser utilizados quando a informação não pode ser extraída diretamente do plano de contas da contabilidade ou requererem processamentos particulares, por exemplo rateios e acertos.

1. 2=Expressão: os itens do DEF classificados como Expressão são calculadas a partir de outros itens de DEF. Para esse tipo de item não é possível a alteração dos valores calculados. Se algum desses valores apresentar incoerência é preciso saber quais outros itens o compõe para que eles possam ser corrigidos. A expressão a ser calculada deve ser cadastrada no campo Expressão (VD9_EXPRES). Para referenciar os itens do DEF para serem utilizadas no cálculo, será utilizado o conteúdo informado no utilizam o campo Campo DEF (VD9_CPODEF) Este código deve ser precedido do caractere @ para diferenciá-lo do valor literal, conforme o exemplo dado a seguir. Todas as operações aritméticas básicas (adição, subtração, divisão e multiplicação) podem ser utilizadas. Também é possível a utilização de parênteses:

Exemplo: um item do DEF Campo DEF (VD9_CPODEF) = 31110 calcula a média entre quatro outros itens do DEF (Campo DEF (VD9_CPODEF) = 311101, 31102, 31103, 31104). Para montar a expressão devemos operar da seguinte forma: ( @311101+ @31102+ @31103+ @31104) / 4. Note que para que o sistema não confunda o valor 4 com o DEF 4, utilizamos o @. Como o valor quatro não tem o @, o sistema interpretará o valor como o número quatro e não como o DEF 4, como no caso dos campos 311101, 31102, 31103, 31104.

1. 3=CCTERP: um item do DEF que deva conter valores calculados a partir do plano de conta da contabilidade deve utilizar essa classificação. Essa é o único tipo que habilita a parte inferior da tela para utilização. Neste tipo de item podemos realizar operações simples (soma e subtração) utilizando valores contábeis obtidos das contas e centros de custos. Ao escolher esta opção, o campo Cent.Custos? (VD9_CCUSTS) do cabeçalho também será habilitado. Informe neste campo os centros de custos, separados por vírgula, a serem considerados para a conta contábil. Se deixar o campo vazio, serão considerados todos os centros de custo. Para informar a conta contábil e suas configurações, utilize a parte inferior da janela:
   1. Código CC (VDE_CCTERP): informe o código da conta contábil do plano de contas do concessionário a ser considerado.
   2. Operação (VDE_OPER): a operação indica se o campo terá seu sinal invertido, 2=Subtração, ou permanecerá com seu sinal natural, 1=Soma. Esta possibilidade é necessária já que certos resultados contábeis (negativos, principalmente) precisam ser invertidos antes de serem apresentados ao DEF.  Além disso, existe certa quantidade de linhas que exigem expressões envolvendo resultados contábeis. Nesses casos pode-se somar uma conta e subtrair outras para que o valor seja corretamente gerado.
   3. Tipo de Sald (VDE_TIPSAL): o campo tipo de saldo possui duas opções disponíveis para a John Deere: 1=Sld.Atu. (Saldo Atual) ou 2=Dbt.Data (Movimento). Caso o usuário escolha 1=Sld.Atu., o sistema irá utilizar o saldo da conta contábil como valor de referência. Na opção 2=Dbt.Data, será lançado o movimento no período (Saldo Final menos Saldo Inicial).
   4. Cent.Custo (VDE_CCUSTO): esta operação permite que um valor contábil possa ser tomado para apenas um centro de custo específico. Ela funciona em conjunto com a lista de centros de custo do cabeçalho da rotina. No cabeçalho é possível digitar uma lista de centros de custo separados por vírgula através do campo Cent.Custos? (VD9_CCUSTS). Se o campo do cabeçalho for digitado o sistema calculará os valores apenas para os centros especificados. Se o campo estiver vazio o valor é calculado sobre todos os centros de custo. Se o usuário, preencher o campo Cent.Custo (VDE_CCUSTO), esta opção se sobrepõe aos centros de custo informados no cabeçalho, campo Cent.Custos? (VD9_CCUSTS), e é caracterizada como exceção. Nesse caso, o campo Cent.Custo (VDE_CCUSTO) permite apenas um centro de custo por linha contábil.
   5. 4=Acumulado: acumula, no item em questão, desde o começo do ano do parâmetro na geração do DEF, o item do DEF descrita no campo Acumulador (VD9_ACUMUL). Esse campo faz referência ao item do DEF a ser acumulado a partir do campo Campo DEF (VD9_CPODEF).
   6. 6=Zerado: o valor receberá o valor zero no plano do DEF.
   7. 7=Extra-Contábil: o valor não é obtido via sistema. Esse valor primeiramente é gerado com zero e deve receber manutenção do usuário através da rotina Cons/Alteração DEF (OFIXA053).
   8. 8=Bloqueado: itens com este atributo não são editáveis nem contém valores. A planilha do DEF possui esses campos para uso futuro. Não afetam nada no sistema.
   9. 9=Sem Definição: trata da situação que deve ser definida futuramente. É passada com valor zerado. Essa classificação apenas existe para organizar o trabalho do usuário.

ATENÇÃO! As classificações 6=Zerado, 7=Extra-Contábil e 9=Sem Definição passam valor zero para a planilha do DEF. O comportamento dessas três classificações é o mesmo. A diferença é simplesmente organizacional.

1. Cadastre todos os itens do DEF, com base nas contas exigidas pelas John Deere para o DFA.
2. Depois de todas os itens do DEF cadastrados, há duas opções disponíveis no menu de Ações Relacionadas para gerenciamento das contas e das linhas do DEF: Conf. Def p/ Cta Contab e Ctas Ctbs não relac.
   1. Conf. Def p/ Cta Contab: Esta opção deve ser utilizada para visualizar em quais linhas do DEF existe uma determinada conta contábil. Acesse a opção em Ações relacionadas/Conf. Def p/ Cta Contab. Preencha os parâmetros conforme segue:
      1. Código do DEF: Neste campo informe o código do DEF para buscar determinada conta em um DEF específico. É opcional, deixe-o em branco para buscar em todos os DEF’s.
      2. Conta Contábil: Neste campo informe o código da conta contábil a ser localizada.
      3. Considera Ativo: Selecione Sim para considerar Ativos ou Não para não considerar. É opcional, deixe-o em branco para não fazer essa restrição.
      4. Em seguida confirme a tela de parâmetros e observe uma lista com as linhas do DEF as quais estão relacionadas com a conta previamente informada. É possível imprimir ou exportar para XML os dados através dos botões posicionados no topo da tela.
   2. Ctas Ctbs não relac.: Esta opção deve ser utilizada para visualizar todas as contas contábeis (Tabela CT1) que não estão relacionadas no DEF (Tabela VDE). Acesse a opção em Ações Relacionadas/Ctas Ctbs não relac.  Preencha os parâmetros conforme segue:
      1. Considera Ativo: Selecione Sim para considerar ativos ou Não para não considerar. É opcional, deixe-o em branco para não fazer essa restrição.
      2. Tipo de Conta: Selecione o tipo de conta a ser considerado entre Sintética e Analítica. É opcional, deixe-o em branco para não fazer essa restrição.
      3. Em seguida confirme a tela de parâmetros e observe a lista de contas contábeis que não estão relacionadas no DEF. É possível imprimir ou exportar para XML os dados através dos botões posicionados no topo da tela.
3. Ainda visando um melhor gerenciamento e análise do DEF, é possível exportar um determinado DEF. Para isso, acesse a opção Exportação no menu de Ações Relacionadas.
4. Informe o código do DEF a ser exportado, na tela e parâmetros e confirme.
5. Ao confirmar será apresentada uma tela com a lista dos das linhas do DEF desejado.
6. Para imprimir ou exportar para XML, selecione os registros desejados com um duplo clique na linha de forma a marcar a caixa de seleção, em seguida clique nas opções Imprimir ou Exportar XML.
7. Outra funcionalidade disponibilizada pelo Protheus é o Acelerador DFA que tem a função de fazer o cadastro do DEF de forma automática, de acordo a importação de uma planilha do tipo .csv. A planilha deve seguir o seguinte layout:

1. Exemplo: Abaixo o exemplo de uma das linhas que podem ser criadas. No exemplo abaixo,
2. 000000003 é o código da conta contábil (VD9ConCta) na Jonh Deere. Em função de o campo possuir tamanho 50, foi necessário digitar o código 000000003 acrescido de 41 espaços.
3. Conta Ctb 6 é a descrição da conta contábil na John Deere (VD9Descri). Em função de o campo possuir tamanho 150, foi necessário digitar a descrição Conta Ctb 6 acrescido de 139 espaços.
4. 000003 é o código do DEF (VD9CpoDef). Em função de esse campo possuir tamanho 6 bastou digitar 000003.
5. 8005,8009, são os códigos dos centros de custos (VD9Ccusts). Digite o código dos centros de custos separados por vírgulas. Podem ser digitados vários códigos, limitando-se a 250 caracteres. No exemplo abaixo, foram digitados os códigos 8005 e 8009 separados por vírgulas, e foi necessário acrescentar mais 240 espaços em branco, em função de o campo ter tamanho 250.
6. 0000000005 é o código da conta no ERP (VDECctErp). Em função de o campo possuir tamanho 20, foi digitado 0000000005 acrescido de 10 espaços em branco.
7. 2 está relacionado com a operação (VDEOper). No exemplo foi utilizado o código 2 pois trata-se de uma Subtração. Deve ser utilizado 1 para Soma e 2 para subtração.
8. 1 está relacionado com o tipo de saldo (VDETipSal). No exemplo foi utilizado o código 1 por se tratar de um Saldo Atual. Deve ser digitado 1 para Saldo Atual e 2 para Débito da Data.
9. 8009 é o código do Centro de Custo dos grupos de conta (VDECcusto). Quando informado, ele sobrepõe os demais centros de custo. É opcional. Em função de possuir tamanho 9 foi digitado 8009 acrescido de 5 espaços em branco.

EXEMPLO:

000000003                                         Conta Ctb 6                                                                                                                                           0000038005,8009,                                                                                                                                                                                                                                                 0000000005          218009    

ATENÇÃO: Os quatro primeiros campos do Layout são referentes ao cabeçalho do Cadastro de Contas do DEF e os últimos quatro campos representam os campos da última grid da tela.

1. Antes da importação do arquivo, será necessária a criação do cabeçalho do DEF (OFIXA051). Acesse a rotina Atualizações/DFA John Deere/ Itens do DEF (OFIXA051).

1. Clique em Incluir e informe pelo menos o campo Código do DEF (VD9_CODDEF).
2. Com o arquivo preparado, será necessário importá-lo. Para isso, acesse a rotina Acelerador DFA em Atualizações/DFA John Deere/Acelerador DFA (OFIIJD01).
3. Será apresentada uma tela de parâmetros para importação. Preencha da seguinte forma:
   1. Código DEF: Neste campo informe o código do DEF cadastrado previamente.
   2. Arquivo: Neste campo informe o diretório e o arquivo a ser importado. Se preferir, clique no botão Procurar navegue pela árvore de pastas e selecione o arquivo.
4. Confirme a tela de parâmetros.
5. Observe que a rotina irá importar arquivos externos para a criação automatizada do cadastro dos itens do DEF. Confirme tal importação e aguarde até que a mensagem de sucesso seja apresentada na tela.
6. A importação irá criar registros relacionados ao cadastro do DEF (Tabela VD9), Filial Conta DEF (Tabela VDA) e Grupos de Conta DEF (Tabela VDE).
7. Acesse Atualizações/DFA John Deere/Geração do DEF (OFIXA052).
8. A rotina realiza a geração das informações do DEF no sistema. Essa rotina utiliza as informações cadastradas nas rotinas Cadastro do DEF (OFIXA050) e Itens do DEF (OFIXA051). A tabela VDC será alimentada com os valores gerados.
9. Clique em Param.
10. A rotina permite a escolha do DEF a ser gerado e a data final da geração. A data sempre deve ser o último dia de um determinado mês. A partir das informações de frequência, campo Frequência (VD7_FREQUE), o período será calculado e os valores gerados.
11. Preencha os parâmetros e confirme a geração.
12. Acesse Atualizações/DFA John Deere/ Cons/Alteração DEF (OFIXA053).
13. A rotina permite a consulta e impressão de um DEF gerado. Caso o usuário opte pelo relatório, o sistema irá gerar um relatório padrão com cada uma dos itens, suas classificações, centros de custo e valor.
14. Na opção Alterar o usuário poderá realizar operações manuais de lançamento, como o preenchimento de campos gerados a partir de tipos Extra-Contábeis por exemplo, ou ajustes antes de gerar o arquivo DFA e enviá-lo para a John Deere.
15. Acesse Atualizações/DFA John Deere/ Geração Arq DFA JD (OFIXN051).
16. Esta rotina irá gerar o arquivo DFA nos padrões de layout exigido pela John Deere.
17. Clique em Param.
18. Preencha os parâmetros conforme instruções a seguir:
    1. Diretório: informe em que diretório será gerado o arquivo [13000384 MMIL-7586 DT - Correção seleção de diretório na geração do arquivo DFA pela rotina Geração Arq DFA JD (OFIXN051) - Linha Microsiga Protheus - TDN (totvs.com)].
    2. Nome do Arquivo: informe o nome do arquivo DFA a ser criado.
    3. Código do DFA: informe o código DEF – Código DEF (VD7_CODDEF) que será considerado para geração do arquivo.
    4. Data DFA: informe o mês do DFA a ser gerado no arquivo.
    5. Filial: selecione se o arquivo será gerado para Filial Logada, Selec. Filiais ou Todas Filiais [12812652 MMIL-7534 DT - Melhorias DEF Protheus - Linha Microsiga Protheus - TDN (totvs.com)].
19. Confirme o preenchimento dos parâmetros.
20. Clique em OK para iniciar a geração do arquivo.
21. Após a finalização, o arquivo está pronto para ser enviado a John Deere para validação.
22. ATENÇÃO! Lembrando que o layout do arquivo será gerado com a seguinte estrutura:
    1. Conta John Deere: a conta John Deere é formada da seguinte maneira:
       1. 3 primeiros dígitos do campo Campo DEF (VD9_CPODEF);
       2. 00;
       3. 2 últimos dígitos do campo Campo DEF (VD9_CPODEF);
       4. 2 últimos dígitos da filial levantada.
       5. Exemplo: para a filial 01, informando o conteúdo 30110 no campo Campo DEF (VD9_CPODEF), a conta contábil a ser levada para o DFA da John Deere será 301001001.
    2. Ponto e vírgula.
    3. Valor da Conta.
       1. Exemplo: 301001001;15985