ARR- Importação do Cofre da Preserve através de arquivo CSV

• Módulo: Arrecadação (ARR).

• Caminho de acesso:
  
                   Cadastros >> Relacionamento genérico
  

                          Guia >> Importação de Dados >> Parâmetros de importação cofre CSV

                          Guia >> Importação de Dados >> Importação cofre CSV

Foi criado um novo tipo de importação de cofre que irá gravar os valores depositados pelos funcionários a partir da leitura de um arquivo do tipo CSV (Valores Separados por Vírgula). Para esta rotina, uma nova tela de parametrização também foi implementada conforme a imagem do exemplo abaixo:

              Menu Guia >> Importação de Dados >> Importação cofre CSV

A tela dos parâmetros só poderá ser gravada quando os campos obrigatórios (destacados com cores na imagem acima) estiverem devidamente preenchidos.

O cadastro é feito em função da Empresa/Filial informada no cabeçalho (campos em laranja). Depois temos os campos de Cofre e Funcionário (em azul), onde serão inseridos os códigos do relacionamento genérico utilizados. Na tela de Relacionamento Genérico, a opção para o tipo de informação "Cofre" foi adicionada, como observamos abaixo. O tipo "Funcionário" já existia para outras importações.

Tipo de Informação "Cofre" adicionada na tela do Relacionamento Genérico. À direita, exemplo de cofres relacionados

No caso do relacionamento do Cofre, o usuário deverá apenas relacionar o código externo com um outro código qualquer (não há cadastro) que será utilizado pelo Globus para gravar os lançamentos.

Temos ainda os campos Documento e Empresa (em amarelo). O campo da Empresa serve para a validação do arquivo que será importado, conforme veremos posteriormente. Já o campo de Documento é necessário para qualquer lançamento de crédito ou débito de funcionário no sistema, mesmo os manuais. Seu cadastro é simples e realizado na tela abaixo:

Menu Cadastros >> Tipo de Documento

Por fim, os dois últimos campos da tela de Parâmetros que não são obrigatórios servem para desconsiderar tipos de depósito e status específicos que vierem no arquivo. Os "nomes" que neles forem inseridos não serão processados no momento da gravação. É possível incluir mais de um, separando-os por "vírgula" (não deve ser inserido espaço depois).

Validação do arquivo
 

Na tela de importação, o usuário deverá informar a empresa/filial, marcar a opção "Importação", inserir a data de movimento e carregar o arquivo CSV clicando no botão indicado na imagem seguinte:

Menu Guia >> Importação de Dados >> Importação cofre CSV

Ao carregá-lo no campo, o sistema imediatamente fará a validação do nome do arquivo. Os três primeiros dígitos devem receber o mesmo número informado no campo Empresa da tela de parâmetros, seguido de "_", o número do cofre correspondente ao movimento, seguido novamente de "_" e então a data do movimento (AAAAMMDD), conforme exemplificamos abaixo com um arquivo do dia 22 de agosto de 2024.

Exemplo de padrão de nome do arquivo para carregar na tela de Importação

Vale ressaltar que o nome precisa atender a validação do sistema a fim de dar continuidade ao processo de importação. Dessa forma, o sistema irá verificar o número da empresa, o número do cofre e se a data é a mesma informada no campo data de movimento e se ela está em um formato válido. Em um cenário onde essas quatro validações não foram satisfeitas, o sistema irá exibir a crítica conforme exemplo abaixo:

Arquivo do exemplo: 002_2332_01082022.csv

Crítica exibida mostrando apontando as quatro inconsistências possíveis no nome do arquivo

Importação do arquivo 

Com a nomenclatura do arquivo em conformidade à validação do sistema, o usuário poderá clicar em "Importar" para dar início ao processo.

Na primeira etapa, o sistema fará a leitura de todos os registros do arquivo. As datas do movimento no documento não precisam ser necessariamente a mesma daquela do nome do arquivo. Os valores depositados devem conter apenas algarismos e "vírgula"; por exemplo: 1050,20. Caso encontre nas colunas correspondentes alguma informação irregular, as críticas serão exibidas da seguinte maneira:

Críticas referentes à data e valor inválidos. O mesmo registro do arquivo pode apresentar as duas situações

Não havendo dados inválidos no processo de leitura, o sistema passa a validar os relacionamentos dos funcionários para efetuar a gravação dos lançamentos. Após conclusão do processo, os lançamentos serão gravados e as matrículas e/ou número de cofres não relacionados (se houver) serão listados no grid de críticas, conforme a imagem abaixo. De qualquer forma, o arquivo de importação ficará gravado no módulo.

Sistema exibindo lançamentos não importados devido à falta de relacionamento genérico.

Após importação, o usuário poderá conferir o lançamento do funcionário na tela de lançamentos ou no relatório de Vales Pendentes RD, como no seguinte exemplo: 

Lançamento indicando origem no Cofre 1 (relacionamento) CSV. Na segunda imagem, temos a emissão do Relatório de Vales Pendentes RD (modelo 024C)

Exclusão do arquivo 

Não é possível fazer a importação de um arquivo com o mesmo nome, mesmo que nele haja lançamentos diferentes daqueles que foram importados. Por isso é necessário fazer a exclusão do documento para uma reimportação dos valores. Este procedimento é executado na própria tela de Importação, clicando no botão "Exclusão". A seguir, temos a sequência de ações para efetuar a exclusão do CSV importado. Quando o usuário selecionar a opção "Exclusão" e preencher o campo "Data do movimento", o foco deve ir para o botão "Consultar". Após o usuário selecionar o movimento a ser excluído e clicar em "Excluir", o sistema deve exibir mensagem de confirmação para a exclusão. Ao finalizar a exclusão, o foco deve retornar ao botão "Consultar".

Obs: Ao navegar na tela com a opção de exclusão marcada, o campo de "Arquivo para importação" ficará desabilitado. 

Exemplo de consulta do arquivo para fazer a exclusão