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