Mudanças entre as edições de "Diárias"
| Linha 8: | Linha 8: | ||
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. | 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: | Os seguintes dados deve estar disponíveis: | ||
| Linha 33: | Linha 38: | ||
Este é o template de WSDL a usar: | 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 http://gve.sea.sc.gov.br/gaxAdm/ws/wsViagem.asmx]] | ||
Edição das 12h22min de 17 de junho de 2013
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]
