Manual Importação de pedidos Prodata VTclient
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 | DIAS | VALOR | NOME |
|---|---|---|---|
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;
| CPF | DIAS | VALOR | NOME |
|---|---|---|---|
| 00000000000 | |||
| 000.000.000-00 |
Dias
- Os dias obrigatoriamente deve ser um numero;
- O valor de dias é referente a quantidade de dias que será feita a recarga.
| CPF | DIAS | VALOR | NOME |
|---|---|---|---|
| 10 |
Valor
- O valor obrigatóriamente é um numero;
- Obrigatorio estar em formato moeda;
Deve ser selecionado o formato moeda que irá evitar que o valor seja enviado de maneira incorreta, resultando num valor diferente ao solicitado, pois o uso de pontos e virgulas no formato de texto podem trazer resultados diferentes.
| CPF | DIAS | VALOR | NOME |
|---|---|---|---|
| R$ 10,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 | DIAS | VALOR | NOME |
|---|---|---|---|
| Nome do Cliente |
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.
