Troca de Arquivos - Histórico de revisão

Capaverde: /* Periodicidade e Prazo de Expurgo */

2014-07-07T13:42:18Z

‎Periodicidade e Prazo de Expurgo

Capaverde: /* Baixando os arquivos */

2014-07-07T13:35:31Z

‎Baixando os arquivos

Capaverde em 20h23min de 28 de fevereiro de 2011

2011-02-28T20:23:39Z

Capaverde em 20h08min de 28 de fevereiro de 2011

2011-02-28T20:08:59Z

Capaverde: /* Veiculos */

2011-02-28T20:00:40Z

‎Veiculos

Capaverde: /* Baixando os arquivos */

2011-01-20T18:16:41Z

‎Baixando os arquivos

Capaverde em 11h08min de 25 de agosto de 2010

2010-08-25T11:08:03Z

Capaverde: /* Dicionário de dados */

2010-08-24T19:53:19Z

‎Dicionário de dados

Capaverde: Criou página com '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 arm…'

2010-08-24T19:25:41Z

Criou página com '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 arm…'

Página nova

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/?<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/?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.

==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

@@ Linha 25: / Linha 25: @@
 ==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 configurada. Para isto, entre em contato com seu gestor.
+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==

← Edição anterior		Edição das 20h23min de 28 de fevereiro de 2011
Linha 159:		Linha 159:

	hodometro: hodômetro do veículo no momento da autorização		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

← Edição anterior		Edição das 20h08min de 28 de fevereiro de 2011
Linha 123:		Linha 123:

	combustível: lista de combustíveis usados pelo veículo		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

← Edição anterior		Edição das 20h00min de 28 de fevereiro de 2011
Linha 119:		Linha 119:

	cd_militar: código de identificação do veículo na frota		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

← Edição anterior		Edição das 11h08min de 25 de agosto de 2010
Linha 18:		Linha 18:

	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.		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 configurada. Para isto, entre em contato com seu gestor.

	==Formato dos arquivos==		==Formato dos arquivos==

@@ Linha 5: / Linha 5: @@
 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"

@@ Linha 2: / Linha 2: @@
 ==Baixando os arquivos==
-Os arquivos gerados podem ser baixados via HTTP, através de requisição à URL http://gax.3ia.com.br/?<usuário>:<senha>/<conjunto>/<arquivo>, onde:
+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
@@ Linha 9: / Linha 9: @@
 arquivo: nome do arquivo que será baixado
-Por exemplo, "http://gax.3ia.com.br/?teste:teste/cliente/Abastecimentos"
+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.

← Edição anterior		Edição das 19h53min de 24 de agosto de 2010
Linha 36:		Linha 36:

	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		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