Pular para conteúdo

WS105 – Verificar se existe rota aberta para a placa

Clique aqui para ver histórico de versões
Data de atualização Data de publicação do serviço Alterações
17/03/2021 17/03/2021 Criação do serviço.

Objetivo

Verificar se existe uma rota aberta para a placa de veículo informada.

Descrição do método
Método checkTruckStatus
Versão 2
WSDL http://soap.comprovei.com.br/exportQueue/index.php?wsdl

Importante

  1. Nossas conexões são seguras utilizando o protocolo SSL. Por questão de segurança nossos certificados são alterados constantemente e sem aviso prévio. Portanto é recomendável que não desenvolvam as integrações baseadas em um certificado fixo.
  2. Constantemente (e sem aviso prévio) adicionamos novos campos e estruturas tanto nas requisições quanto nas respostas dos nossos webservices. Quem for utilizar nossos webservices deve implementar de tal maneira que os programas que consomem estes webservices não deixem de funcionar quando houver as alterações de campos mencionadas.

Características

  • As chamadas serão realizadas via SOAP sobre HTTPS;
  • A origem do chamado do Web Service será o sistema do cliente;

Autenticação

  • As chamadas terão autenticação a nível de transporte (Basic Authentication);
  • Solicite o user / password ao administrador da conta.

Request

A requisição para o nosso Web Service é composta da seguinte forma:

TAG Tipo Descrição
placaVeiculo conjunto de caracteres Placa do veículo que será verificada.

Exemplo de Request

<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:WebServiceComprovei">
   <soapenv:Header/>
   <soapenv:Body>
      <urn:checkTruckStatus soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <PlacaVeiculo xsi:type="xsd:string">ELW2173</PlacaVeiculo>
      </urn:checkTruckStatus>
   </soapenv:Body>
</soapenv:Envelope>

Response

Nosso Web Service responde para você da seguinte forma:

TAG Tipo Descrição
codigoRetorno Inteiro Código da mensagem de retorno.
MensagemRetorno Conjunto de caracteres Mensagem de retorno.
Rota Estrutura Contém todas as informações da rota, caso seja encontrada alguma.

Rota

TAG Tipo Descrição
Data Data Data no formato 'YYYY-MM-DD'.
Nome Conjunto de caracteres Nome da rota.
Numero Conjunto de caracteres Numero da rota.
CodigoMotorista Conjunto de caracteres Motorista vinculado à rota.
TelefoneMotorista Conjunto de caracteres Telefone cadastrado do motorista.
PlacaVeiculo Conjunto de caracteres Placa do veículo associado à rota.
CodigoStatus Inteiro Status da rota.
Status Conjunto de caracteres Nome do status da rota.
Localizacao Estrutura Contém a última latitude e longitude capturada do motorista.

Localizacao

TAG Tipo Descrição
DataHoraUltimaLocalizacao Data e Hora Data e hora da última localização capturada do veículo.
Latitude Decimal Posição de latitude no formato decimal.
Longitude Decimal Posição de longitude no formato decimal.

Exemplo de Response

<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:WebServiceComprovei" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
    <SOAP-ENV:Body>
        <ns1:checkTruckStatusResponse>
            <CodigoRetorno xsi:type="xsd:integer">1</  CodigoRetorno>
            <MensagemRetorno xsi:type="xsd:string">Veículo com rota    alocada.</MensagemRetorno>
            <Rota xsi:type="Rota">
                <Data  xsi:type="xsd:string">2021-02-18</Data>
                <Nome xsi:nil="true"/>
                <Numero    xsi:type="xsd:string">000001002</Numero>
                <CodigoMotorista       xsi:type="xsd:string">12345678912</CodigoMotorista>
                <TelefoneMotorista     xsi:type="xsd:string">11988888888</TelefoneMotorista>
                <Placa xsi:type="xsd:string">ABC1234</Placa>
                <CodigoStatus xsi:type="xsd:int">1</CodigoStatus>
                <Status    xsi:type="xsd:string">Liberado</Status>
                <Localizacao xsi:type="Localizacao">
                    <DataHoraUltimaLocalizacao xsi:type="xsd:string">2021-02-25 15:25:30</DataHoraUltimaLocalizacao>
                    <Latitude xsi:type="xsd:string">-23.5487851</Latitude>
                    <Longitude xsi:type="xsd:string">-47.1908806</Longitude>
                </Localizacao>
            </Rota>
        </ns1:checkTruckStatusResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Códigos de retorno

| Código | Descrição | |:-------|:-----|:------------| | 0 | Veículo sem rota alocada. | | 1 | Veículo com rota alocada. | | 998 | Parâmetro de entrada não foi preenchido. | | 999 | Usuário não autenticado. |