Diárias

De GAX
Revisão de 16h48min de 14 de junho de 2013 por Capaverde (discussão | contribs)
Ir para navegaçãoIr para pesquisar

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:

  1. A solicitação da diária é feita em sistema do cliente, antes do cadastro de tráfego do veículo no GAX.
  2. Os dados da diária podem ser modificados ou complementados no GAX.
  3. 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: