Manual Importação de funcionários do VT Client
O objetivo deste manual é tornar o uso do sistema mais simples possível por isso é importante ler antes de seu uso.
Tipo do arquivo
No momento o arquivo suportado e testado são arquivos .XLSX criados pelo excel ou libreoffice calc.
Nome da planilha
O nome da planilha é algo de extrema importancia pois o sistema irá buscar a planilha de nome padrão do Excel que é Planilha1.
O nome de planilha não se refere ao nome do arquivo e sim o nome da planilha que fica na parte de baixo do excel.
Cabeçalho do arquivo
O cabeçalho do arquivo é a parte mais importante do arquivo já que o sistema irá identificar os campos através dele.
O cabeçalho constitui a primeira linha da sua planilha que devem ser nomeados de acordo com padrão estabelecido para cada sistema individualmente.
Os titulos do cabeçalho não devem conter caracteres especiais como mostrado nos exemplos abaixo.
| CPF | NOME | NASCIMENTO | MAE | ESTADO | ENDERECO | NUMERO | BAIRRO | CIDADE | CEP |
|---|---|---|---|---|---|---|---|---|---|
A ordem das colunas não fará diferença contanto que o nome no cabeçalho esteja correto como o solicitado e os dados também estejam em seus devidos lugares.
Não deve haver nenhuma linha acima do cabeçalho como nome de planilhas etc.
Problemas com o cabeçalho do arquivo
Esta mensagem irá ocorrer caso o cabeçalho não esteja na primeira linha ou os nomes(valores do cabeçalho) estejam diferentes do solicitado.
Os dados das colunas
Os dados das colunas seguem algumas regras simples porém importantes
CPF
- Precisa ter obrigatoriamente 11 digitos numéricos;
- Pode ter pontos e separador pois o sistema irá removelos automaticamente;
- Cuidado ao aplicar mascaras no cpf pois pode não enviar os zeros a esquerda;
| CPF | NOME | NASCIMENTO | MAE | ESTADO | ENDERECO | NUMERO | BAIRRO | CIDADE | CEP |
|---|---|---|---|---|---|---|---|---|---|
| 00000000000 | |||||||||
| 000.000.000-00 |
Nome
- Nome obrigatoriamente é um campo de texto;
- O sistema irá remover os espaços caso haja espaços em branco antes do nome ou depois do ultimo sobrenome;
| CPF | NOME | NASCIMENTO | MAE | ESTADO | ENDERECO | NUMERO | BAIRRO | CIDADE | CEP |
|---|---|---|---|---|---|---|---|---|---|
| Nome do Cliente |
Nascimento
- Nascimento é obrigatoriamento um campo tipo data.
- O formato obrigatório é 01/10/2022. dia dois digitos, mês dois digitos e ano com quatro digitos.
- Se o formato estiver diferente do padrão irá gerar erro no seu arquivo de retorno então cuidado.
| CPF | NOME | NASCIMENTO | MAE | ESTADO | ENDERECO | NUMERO | BAIRRO | CIDADE | CEP |
|---|---|---|---|---|---|---|---|---|---|
| 01/10/2022 |
Mãe
- Nome mãe obrigatoriamente é um campo de texto;
- O sistema irá remover os espaços caso haja espaços em branco antes do nome ou depois do ultimo sobrenome;
| CPF | NOME | NASCIMENTO | MAE | ESTADO | ENDERECO | NUMERO | BAIRRO | CIDADE | CEP |
|---|---|---|---|---|---|---|---|---|---|
| Nome da mãe do Cliente |
Estado
- O estado é a sigla do estado do funcionário.
| CPF | NOME | NASCIMENTO | MAE | ESTADO | ENDERECO | NUMERO | BAIRRO | CIDADE | CEP |
|---|---|---|---|---|---|---|---|---|---|
| SP |
Endereço
- O endereço da casa do cliente, apenas o nome da rua.
| CPF | NOME | NASCIMENTO | MAE | ESTADO | ENDERECO | NUMERO | BAIRRO | CIDADE | CEP |
|---|---|---|---|---|---|---|---|---|---|
| Rua João Pessoa |
Numero
- Numero da casa do cliente.
| CPF | NOME | NASCIMENTO | MAE | ESTADO | ENDERECO | NUMERO | BAIRRO | CIDADE | CEP |
|---|---|---|---|---|---|---|---|---|---|
| 150 |
Bairro
- Bairro da casa do cliente.
| CPF | NOME | NASCIMENTO | MAE | ESTADO | ENDERECO | NUMERO | BAIRRO | CIDADE | CEP |
|---|---|---|---|---|---|---|---|---|---|
| São Paulo |
Cidade
- Cidade da casa do cliente.
| CPF | NOME | NASCIMENTO | MAE | ESTADO | ENDERECO | NUMERO | BAIRRO | CIDADE | CEP |
|---|---|---|---|---|---|---|---|---|---|
| São Paulo |
CEP
- CEP da casa do cliente.
| CPF | NOME | NASCIMENTO | MAE | ESTADO | ENDERECO | NUMERO | BAIRRO | CIDADE | CEP |
|---|---|---|---|---|---|---|---|---|---|
| 00000-000 |
Campo Mensagem
Este é o campo que o sistema usa para falar com você, apresentando mensagens de problemas ou do sucesso no envio de seu arquivo.
Em caso de sucesso no processamento do arquivo a mensagem apresentada será OK.
Caso o erro seja no conteudo do arquivo a mensagem também incluirá o numero da linha que apresentou o problema.
Mensagens de erro
| Mensagem | Problema |
|---|---|
| Tamanho do arquivo não permitido. | Este erro será apresentado para casos de arquivos absurdamente grandes. |
| Erro ao Coletar Arquivo. | Houve algum problema com o envio do arquivo ou arquivo não compativel. |
| Problemas com o cabeçalho do arquivo. | Cabeçalho fora do padrão solicitado acima. |
| Quantidade incorreta de valores cpf. | Indica que a soma dos digitos numericos do campo é diferênte de 11 |
| Valores zerados ou inválidos. | Este erro irá aparecer quando algum dos valores estiverem como zero ou algum caracter não permitido, geralmente sendo apresentado nos campos numericos. |
Campo de Resposta
O campo de resposta é onde o sistema irá devolver o arquivo já formatado para o sistema selecionado.
Você deve copiar o conteudo utilizando o botão de copia ⎘ ao lado da caixa de texto, colar o conteudo no bloco de notas de seu computador, salvar o arquivo com o nome_preferido.txt, onde o nome preferido você pode alterar para qualquer nome que preferir.
Atenção
A primeira linha de 4 digitos do arquivo gerado deve ser conferida com o seu sistema prodata para que não haja divergência de modelo e versão do sistema.
Está linha está diretamente ligada a versão do sistema que o seu sistema aceita.
Por exemplo o sistema pode ter gerado o numero 0900 e o seu projeto ter o numero 0800 neste caso você só precisa alterar o numero para 0800. Você pode conferir isso nas instruções de importação do seu sistema.
