1. Finalidade
A funcionalidade Atualização de Pedidos da VT Soluções permite importar um arquivo TXT fornecido pela VT Soluções contendo os valores efetivamente creditados para cada colaborador, atualizando automaticamente os Registros de Pedido de Vale Transporte no módulo Benefícios do SIRH.
Esse processo garante que:
- A quantidade final de vales considerada para desconto em folha seja exatamente a quantidade efetivamente adquirida.
- O cálculo reflita corretamente ajustes realizados pela VT Soluções em função de saldos existentes no cartão dos colaboradores.
2. Pré‑requisitos
2.1 Diretriz obrigatória
Para habilitar o recurso, é necessário ativar a diretriz:
Menu: Benefícios > Arquivo > Diretrizes do Módulo
Diretriz: Integração com VT Soluções
Opções: Sim / Não (Padrão)
Se a diretriz estiver configurada como Não, ao tentar acessar a funcionalidade será exibida a mensagem:
A diretriz de módulo "Integração com VT Soluções" está inativa.
A tela será disponibilizada apenas quando a opção estiver marcada como “Sim”.
3. Acesso à funcionalidade
Com a diretriz habilitada, o menu é exibido:
Menu: Benefícios > Importação > Atualização de Pedidos da VT Soluções
4. Funcionamento geral
A rotina funciona no formato Wizard, liberando as abas conforme o usuário avança:
- Arquivo
- Conferência
- Seleção do Cálculo/Pedido
- Resultado
Cada etapa é descrita abaixo.
5.Aba 1 — Arquivo
Objetivo
Importar e validar o arquivo TXT gerado pela VT Soluções.
Campos e botões
- Informe o arquivo a importar
Aceita somente arquivos .TXT - Iniciar Importação
Executa as primeiras validações
Caso haja falha, mensagens possíveis:
- O arquivo informado deve ser no formato arquivo.txt
- Arquivo vazio
- Não foi possível identificar nenhum dos campos
Somente após validações bem‑sucedidas o sistema libera a próxima aba.
6. Aba 2 — Conferência
Objetivo
Permitir que o usuário visualize e valide os dados contidos no arquivo TXT antes da atualização.
Recursos
- Grid de Conferência
Apresenta todas as colunas mapeadas (12 colunas), conforme o layout do arquivo fornecido pela VT Soluções. - Filtros nas colunas
Permite você conferir dados por colaborador, CPF, linha, valores, etc. - Total de Registros no Arquivo
Exibido acima da grid para indicar quantas linhas foram lidas com sucesso.
Botões
- Retornar – Permite voltar e carregar outro arquivo.
- Avançar – Libera a próxima etapa.
7. Aba 3 — Seleção do Cálculo/Pedido de VT
Objetivo
Selecionar um único cálculo de VT para atualização.
Componentes da tela
Grid de cálculos/pedidos
✅ Importante: a grid exibe com ordenação, cálculo mais recente primeiro.
- Filtro de período
Nesta tela é permitido a seleção de apenas um cálculo, por vez. Ícone de ajuda (?)
Mensagem do hint:Para cada registro do arquivo, o sistema irá buscar a combinação
CPF + Cartão + Código Oficial da Linha de Transporte no cálculo/pedido selecionado
e, quando houver correspondência, atualizará o saldo no SIRH conforme os valores informados no arquivo.
Botões
- Retornar – volta à aba anterior.
- Confirmar – inicia a atualização dos registros do pedido.
8. Aba 4 — Resultado
Objetivo
Apresenta ao usuário o resultado do processamento do arquivo, do período da tela anterior.
Processamento realizado pelo sistema
Para cada linha do arquivo:
O sistema localiza o Registro de Pedido no cálculo selecionado, obedecendo a seguinte prioridade:
1. Pelo Número do Cartão (se não nulo) + CPF + Código Oficial da Linha
2. Apenas por CPF + Código Oficial da Linha
3. Caso não encontre:
O registro é listado como não importado, com a mensagem:Não foi possível localizar o Registro de Pedido deste Beneficiário, Empresa e Linha no cálculo selecionado.
- Se localizado, o sistema verifica se a quantidade de passes entregues no cálculo difere da quantidade calculada a partir do arquivo (Valor Creditado / Valor Unitário).
- Se houver divergência, realiza atualização:
- Passes/Necessários = Valor Total Solicitado / Valor Unitário
- Passes/Saldo = Valor Retido / Valor Unitário
- Passes/Entregue = Valor Creditado / Valor Unitário
- Origem = “Alterado”
- Uma grid apresenta:
- Registros atualizados
- Total de registros alterados
- Registros não localizados e respectivas mensagens
Ícone de ajuda (?)
Mensagem:
Registros importados: atualizados com base no arquivo.
Registros não importados: CPF, cartão ou código oficial não encontrados no cálculo.
Revise o arquivo, ajuste e importe novamente se necessário.
10. Observações importantes
- O arquivo deve conter os campos separados por TAB (Chr(9)).
- Apenas arquivos TXT são aceitos.
- As colunas do arquivo devem seguir rigorosamente o layout definido pela VT Soluções.
11. Onde conferir os dados após a atualização
Após concluir o processo na aba Resultado, o usuário pode validar as informações atualizadas diretamente no módulo Benefícios, utilizando as mesmas telas utilizadas para consulta dos pedidos de Vale Transporte.
Menu: Benefícios > Vale-transporte > Pedidos de Vale Transporte
Nesta tela, o usuário poderá:
- Selecionar o colaborador e o cálculo/pedido atualizado
- Visualizar os campos:
- Passes/Necessários
- Passes/Saldo
- Passes/Entregue
- Origem (deve aparecer como Alterado para registros ajustados)
- Confirmar se os valores correspondem aos enviados pela VT Soluções
- Conferir a linha de transporte e o número do cartão utilizado na identificação