Troca de Arquivos

O sistema pode gerar periodicamente arquivos contendo diversas das informações armazenadas nele. Normalmente, estes dados serão transferidos para outros sistemas ou então armazenados como cópia de segurança. A geração de arquivos dependente de autorização do gestor da frota. Entre em contato com seu gestor caso tenha alguma necessidade específica.

Baixando os arquivos

Os arquivos gerados podem ser baixados via HTTP, através de requisição à URL http://gax.3ia.com.br/edi/?<usuário>:<senha>/<conjunto>/<arquivo>, onde:

usuário: nome de usuário autorizado no sistema a baixar arquivos

senha: a mesma senha usada para acessar o sistema

conjunto: nome do conjunto de exportação onde está o arquivo desejado

arquivo: nome do arquivo que será baixado

Por exemplo, "http://gax.3ia.com.br/edi/?teste:teste/cliente/Abastecimentos"

O arquivo pode ser baixado manualmente, através de um browser de internet, ou então usando o aplicativo "WGET", disponível para diversas plataformas em http://www.gnu.org/software/wget/. Uma pesquisa por WGET no google retornará inúmeras referências ao programa original e a seus clones.

O WGET pode ser agendado para execução ou disparado diretamente por linha de comando, como no exemplo abaixo:

wget http://gax.3ia.com.br/edi/?<usuário>:<senha>/<conjunto>/<arquivo> --content-disposition

Lembre-se de substituir usuário, senha, conjunto e arquivo por valores apropriados. O parâmetro "--content-disposition" faz com que o nome original do arquivo seja preservado.

Periodicidade e Prazo de Expurgo

Uma vez gerados, os arquivos ficarão disponíveis para download durante sete dias. Os arquivos são gerados sempre a noite. O intervalo de tempo entre um arquivo e outro pode ser configurado. Para isto, entre em contato com seu gestor.

Formato dos arquivos

A primeira linha do arquivo é um cabeçalho composto pelo nome dos campos separados por TAB. As linhas são delimitadas por CRLF. A partir da segunda linha, cada uma é um registro, com campos separados por TAB. Como a ordem e quantidade dos campos podem mudar, nunca acesse-os de forma posicional. Leia primeiramente o cabeçalho e identifique o índice do(s) campo(s) desejado(s). Feito isto, leia os registros que seguem, localizando o campo pelo índice obtido antes.

Dicionário de dados

Estes são os campos encontrados com mais frequencia. Note que alguns arquivos podem ter campos ligeiramente diferentes em função de autorizações diferentes dadas pelos gestores. Em caso de dúvida, contate-os diretamente.

UnidadesOrganizacoes

Contém dados sobre a estrutura administrativa do cliente. Uma unidade pode ser uma empresa, órgao, centro de custo, secretaria, departamento etc. Uma unidade pode ter subdivisões, que também podem ser subdivididas. O sistema não limita a quantidade de níveis.

cd_unidade: código da unidade; este código identifica de forma única esta unidade em todo o sistema e é de responsabilidade do usuário

nome: nome desta unidade

cd_unidade_pai: código da unidade a qual esta é subordinada ou vazio caso ela não seja subordinada a ninguém

cd_unidade_principal: código da unidade a qual esta está vinculada administrativamente ou vazio caso se trate de uma secretaria, empresa ou outras estruturas autônomas

SituacoesVeiculos

Situações cadastrais possíveis para um veículo. Cada veículo deve ter uma situação cadastral válida, a qualquer tempo. Note que as situações válidas para um determinado veículo podem variar conforme o tipo de veículo e a forma como foi incorporado na frota (se foi comprado, recebido em doação, cedido, locado etc). Um veículo bloqueado não faz parte da frota. Qualquer tentativa de registar despesas para ele será negada. Um veículo pode estar bloqueado caso seu cadastro ainda esteja incompleto no sistema ou tenha sido de alguma forma alienado. Veículo indisponível fazem parte da frota. Entretanto, por alguma razão, estão impossibilitados de abastecer. Outras despesas, como manutenções e impostos, serão aceitas. O bloqueio precede a indisponibilidade.

cd_situacao_veiculo: código da situação cadastral

descricao: descrição da situação cadastral

veiculo_bloqueado: 0 indica veículo disponível quando nesta situação cadastral, 1 indica veículo bloqueado

veiculo_indisponivel: 0 indica veículo disponível quando nesta situação cadastral, 1 indica veículo indisponível

Usuarios

Usuários com acesso ao sistema. Os dados a que o usuário terá acesso são restritos àqueles referentes a unidade em que ele está vinculado e a todas as subordinadas a ela.

login: identificação do usuário no sistema

nome: nome do usuário

cd_unidade: código da unidade primária a qual o usuário está vinculado

cd_nivel: código do nível de acesso do usuário

bloqueado: 0 indica que o usuário pode acessar o sistema, 1 indicar que o acesso do usuário está temporariamente cancelado

UnidadesSecundarias

Outras unidades a que o usuário terá acesso, fora da subordinação da sua unidade primária. O acesso é garantido à unidade e a todas as vinculadas a ela. Um usuário pode ter apenas uma unidade primária, mas diversas unidades secundárias.

login: identificação do usuário

cd_unidade: código da unidade secundária

cd_nivel: nível de acesso aplicado quando acessando esta unidade secundária

Veiculos

Cadastro dos veículos que compõem a frota.

licenca: código de identificação do veículo no sistema

placa: placa ou patrimônio (se o equipamento não tiver placa)

cd_unidade_usuaria: código da unidade usuária deste veículo ou vazio caso o veículo não esteja lotado em nenhuma unidade

tp_propriedade: tipo de propriedade do veículo (se próprio, locado, doado etc)

proprietario: nome do proprietário como consta no documento de registro

cd_situacao_veiculo: código da situação cadastral atual do veículo

situacao_veiculo: descrição da situação cadastral atual do veículo

veiculo_bloqueado: 0 indica veículo disponível, 1 indica veículo bloqueado

veiculo_indisponivel: 0 indica veículo disponível, 1 indica veículo indisponível

tp_veiculo: tipo de veículo (se terrestre, embarcação, equipamento ou aeronave)

tp_hodometro: tipo de hodômetro usado (quilômetros, milhas ou horas)

patrimonio: número de patrimônio do veículo

modelo_veiculo: modelo do veículo

fabricante_veiculo: fabricante do veículo

familia_veiculo: família do veículo (semelhante ao modelo, mas sem informar a versão)

ano_fabricacao: ano de fabricação

ano_modelo: ano do modelo

cor_predominante: cor

hodometro_atual: leitura atual do hodômetro, conforme o último abastecimento

cd_militar: código de identificação do veículo na frota

uso: atributo de tipo de utilização do veículo, se houver

combustível: lista de combustíveis usados pelo veículo

Debitos

Relação de débitos para cada veículo da frota. Os débitos podem estar em aberto ou já quitados, quando então haverá também a data e o valor pago.

licenca: código de identificação do veículo no sistema

placa: placa ou patrimônio (se o equipamento não tiver placa)

descricao: descrição do débito (por exemplo, Seguro DPVAT, Vistoria, Registro de Veiculo etc)

valor_debito: valor do débito

dt_vencimento: data de vencimento do débito

valor_pago: valor pago (apenas se débito já quitado)

dt_pagamento: data do pagamento

Servicos

Abastecimentos, manutenções e demais custos do veículo.

autorizacao: número de autorização gerado pelo sistema para este serviço

licenca: código de identificação do veículo no sistema

placa: placa ou patrimônio (se o equipamento não tiver placa)

data: data em que o serviço foi realizado

qtde: quantidade de serviço ou produto autorizado

cd_produto: código do serviço ou produto

descricao: descrição do serviço ou produto autorizado

hodometro: hodômetro do veículo no momento da autorização

Multas

Multas e infrações cometidas pelos veículos.

licenca: código de identificação do veículo no sistema

placa: placa ou patrimônio (se o equipamento não tiver placa)

tp_multa: MUL para multa, INF para infração

cd_infracao: código da infração

descricao: descrição do tipo de infração

data: data em que a infração foi cometida

valor: valor da multa ou infração