Diárias
A integração do GAX com os sistemas de solicitação de diárias do cliente é feita por um conjunto de webservices.
O processo está baseado nas seguintes premissas:
- A solicitação da diária é feita em sistema do cliente, antes do cadastro de tráfego do veículo no GAX.
- Os dados da diária podem ser modificados ou complementados no GAX.
- Uma vez concluída a viagem, o GAX fornece acesso aos dados finais.
O sistema de solicitação de diárias do cliente deve implementar um webservice que forneça os dados da viagem, recebendo como parâmetro uma chave de acesso. A chave de acesso costuma ser o número da solicitação.
Os parâmetros passados pelo GAX nesta chamada estão listados a seguir:
- p_strTokenUsuario: token de identificação do GAX
- p_intCdViagem: código da viagem
Os seguintes dados deve estar disponíveis:
- LOCALIDADE_ORIGEM: nome do local onde inicia a viagem
- LOCALIDADE_DESTINO: destino da viagem
- PARTIDA: data e hora de partida (previsto)
- CHEGADA: data e hora de retorno (previsto)
Para cada viajante, estes são os dados a serem fornecidos:
- MATRICULA: matrícula (ou CPF) do passageiro
- NOME_VIAJANTE: nome completo
O primeiro viajante será registrado no GAX como motorista. A lista de viajantes é opcional.
O trechos da viagem serão informados com os dados abaixo:
- LOCALIDADE_ORIGEM: origem do trecho
- LOCALIDADE_DESTINO: destino do trecho
- PARTIDA: data e hora de partida (previsto)
- CHEGADA: data e hora de chegada (previsto)
A lista de trechos é opcional.
Recomenda-se que a implementação deste webservice inclua as regras de permissão de acesso aos dados e validação de estado da solicitação da diárias. Por exemplo, autorizar o tráfego somente para solicitações de diária que tenham sido aprovadas. Violações de regras devem retornar erros, quando então o GAX cancelará o cadastramento da viagem.
Este é o template de WSDL a usar:
Uma vez concluída a viagem, o sistema de diárias do cliente deve invocar outro webservice do GAX para obter os dados atualizados. São esperados os seguintes parâmetros:
- usuario: nome de usuários registrado no GAX
- senha: senha do usuário
- cdViagem: código da viagem (o mesmo usado para cadastrá-la)
- matricula: matrícula do passageiro que será consultado
O retorno é formado pelos seguintes campos:
- origem: local de origem da viagem
- destino: local de destino da viagem
- dtInicio: data e hora de início
- dtTermino: data e hora de término
- hodInicio: hodômetro inicial
- hodTermino: hodômetro final
- placa: placa do veículo que fez a viagem
- finalidade: descrição do objetivo da viagem
- matricula: matrícula do passageiro
- nm_passageiro: nome do passageiro
Para cada trecho:
- origem: local de início do trecho
- destino: local de chegada do trecho
- dtInicio: data e hora inicial
- dtTermino: data e hora final
- hodInicio: hodômetro do veículo no início do trecho
- hodTermino: hodômetro do veículo no final do trecho
- matriculaCondutor: matrícula do condutor que dirigiu o veículo no trecho
- nomeCondutor: nome do condutor
Consulte o WSDL deste webservice em [http://gve.sea.sc.gov.br/gaxAdm/ws/wsViagem.asmx]
