Inclusão do campo filial na contabilização TXT - CTBA500

Objetivo

Atualmente a rotina de contabilização TXT é utilizada para realizar a inclusão em lote de lançamentos contábeis, nas seguintes situações:

• Ajustes gerenciais de lançamentos em tipos de saldo ou filiais especificas
• Inclusão de lançamentos contábeis de empresas adquiridas que não estão no sistema.
• Contabilização de operações realizadas em sistema externo ao Protheus.

Esse projeto tem como objetivo as seguintes melhorias na rotina:

• Possibilidade de informar a filial de contabilização no arquivo texto.
• E-mail para informar fim do processamento da rotina.
• Opção de utilizar caminho descrito em parâmetro.

Definição da Regra de Negócio

Possibilidade de informar a filial de contabilização no arquivo texto

Atualmente a rotina de contabilização TXT realiza o processo apenas na filial corrente que a rotina está sendo executada, obrigando o usuário gerar um arquivo texto por filial e executar a rotina várias vezes.

Será criada a seguinte pergunta na rotina de contabilização TXT:

• Considera Filial no arquivo texto?
  • Sim
  • Não

Para essa melhoria ser executada, as primeiras posições do arquivo texto deverão conter o código da filial, em seguida o código do lançamento padrão onde será executada a leitura do arquivo.

Exemplo:

• Considera Filial no arquivo texto?
  • Sim
    • Arquivo Texto: (em negrito filial de um ambiente com gestão corporativa)
    • D MG 0110011001...
    • D MG 0110011001...
    • D MG 0110011001...

• Não
  • Arquivo Texto: (em negrito filial de um ambiente com gestão corporativa)
  • 10011001...
  • 10011001...
  • 10011001...

Caso o parâmetro “Quebra linha em Doc” estiver configurado como “não” o sistema irá gerar um documento a cada troca de filial.

Exemplo:

• D MG 01100...
• D MG 01100...
• D MG 01100...
  • Gera um documento na filial D MG 01
  • D MG 02100...
  • D MG 02100...
  • D MG 02100...
    • Gera um documento na filial D MG 02
    • D MG 01100...
    • D MG 01100...
    • D MG 01100...
      • Gera um documento na filial D MG 01

Para utilizar essa funcionalidade, o lançamento padrão de contabilização TXT deve levar em conta as 12 Posições de filial + 3 posições no código do LP para as funções LerVal e LerSTR.

O sistema deve validar o campo de filial. Se o campo estiver inválido ou a filial não exista no grupo de empresas, o sistema não realiza a inclusão na CT2 e armazena o arquivo no diretório indicado no parâmetro MV_CTBTERR e passa para o próximo arquivo. Se o arquivo for valido ele realiza a inclusão na CT2 e armazena o arquivo no diretório indicado no parâmetro MV_CTBTRES.

A importação por filial não verifica se o usuário tem acesso as filiais, realizando a inclusão independente da filial.

Opção de utilizar caminho descrito em parâmetro

A rotina de contabilização TXT pede no parâmetro “Arquivo Importado?” o caminho do arquivo texto no diretório local ou na rede.

Porém existem processos, como a contabilização do arquivo texto da folha de pagamento, que o ideal é o sistema buscar de um arquivo de rede, pois evita a manipulação de um arquivo sensível a empresa.

Serão criados os seguintes parâmetros de sistema para permitir essa melhoria:

• MV_CTBTPAT: Caminho do arquivo texto. Poderá ser um caminho local ou caminho de rede.
• MV_CTBTERR: Diretório onde serão copiados os arquivos texto após o processamento que não foram importados.
• MV_CTBTRES: Diretório onde serão copiados os arquivos texto após o processamento que foram importados com sucesso.
  • O arquivo copiado terá seu nome alterado com a data e hora do final do processamento.

Na rotina de processamento será criada a seguinte pergunta:

• Processa arquivo?
  • Rotina
    • Será processado o arquivo da pergunta “Arquivo Importado?”
    • Parâmetro interno
      • Serão processados todos os arquivos que estão no diretório indicado no parâmetro interno MV_CTBTPAT.

Após a confirmação do processamento, o sistema deve mostrar a seguinte mensagem dependendo da seleção:

• Processa arquivo?
  • Rotina
    • “Será processado o arquivo – XXX. Confirma? “
      • XXX é o conteúdo da pergunta “Arquivo Importado?”
      • Parâmetro interno
        • “Serão processados os arquivos contidos na pasta interna. Confirma?”

E-mail para informar fim do processamento da rotina.

Será desenvolvido um e-mail a partir do Protheus, informando ao usuário chave configurado as seguintes informações:

• Processamento concluído.
• Parâmetros utilizados.
• Usuário que iniciou o processamento da contabilização TXT
• Data e hora do Início do processamento.
• Data e hora do fim do processamento.

Para esse desenvolvimento, deverá ser utilizada a funcionalidade de EventView, onde através da funcionalidade do Messenger do Protheus é possível configurar o usuário ou grupo de usuários que irão receber o e-mail/mensagem. 

Tabelas Utilizadas

• CT5 – Lançamento Padrão.
• CT2 – Lançamento Contábil. 

Fluxo do Processo

Dicionário de Dados 

Grupo de Perguntas 

Nome: CTB500 

Parâmetro

Arquivo: SX5 – E3 – Eventos do M- Messenger (Genérica) 

Descrição Caso de Uso

1. 1.      Casos de Uso

Premissas: As configurações definidas a seguir são premissas para a execução de todos os casos de uso definidos nesta especificação.

1. Efetuar o cadastro de um plano de contas que contemple minimamente as seguintes informações:

1. Configurar o seguinte lançamento padrão

1. Incluir os seguintes arquivo texto:

Filial.TXT

Arquivo1.TXT

Arquivo2.TXT

1. Configurar os parâmetros:

1. Configurar o evento 060 no Messenger.

1º. Contabilização de um Arquivo texto com filiais na linha.

Objetivo: Incluir lote de lançamento para cada filial informada no arquivo

Pré-requisitos:

1. Realizar as Premissas.
2. Executar a rotina CTBA500
3. Selecionar os seguintes parâmetros:

Condições de sucesso: O sistema deve gerar 2 documentos contábeis um na filial D MG 01 e outro na D MG 02

Condições de falha:

• Não incluir o lançamento 

Inicializador: Acesso a rotina “Contabilidade Gerencial -> Miscelâneas -> Processamentos -> Contabilização TXT”

2º. Contabilização de um Arquivo texto no parâmetro interno

Objetivo: Incluir lote de lançamento

Pré-requisitos:

1. Realizar as Premissas.
2. Copiar os arquivos Arquivo1.TXT e Arquivo2.TXT na pasta configurada no parâmetro MV_CTBTPAT
3. Executar a rotina CTBA500
4. Selecionar os seguintes parâmetros:

Condições de sucesso: O sistema deve gerar 2 documentos contábeis e copiar os arquivos na pasta configurada do parâmetro MV_CTBTRES.

Condições de falha:

• Não incluir o lançamento

Inicializador: Acesso a rotina “Contabilidade Gerencial -> Miscelâneas -> Processamentos -> Contabilização TXT”

2º. Mensagem de fim de processamento

Objetivo: Incluir lote de lançamento

Pré-requisitos:

1. Realizar as Premissas.
2. Copiar os arquivos Arquivo1.TXT e Arquivo2.TXT na pasta configurada no parâmetro MV_CTBTPAT
3. Ativar o evento 060 no Messenger
4. Executar a rotina CTBA500
5. Selecionar os seguintes parâmetros:

Condições de sucesso:

• O sistema deve gerar 2 documentos contábeis e copiar os arquivos na pasta configurada do parâmetro MV_CTBTRES.
• O sistema irá enviar o e-mail/mensagem para o grupo/usuário configurado.

Condições de falha:

• Não incluir o lançamento