Capítulo35

Serviço consultaBilheteCia

35.1 - Requisição

O serviço consultaBilheteCia realiza a consulta de um bilhete aéreo na CIA emissora e retorna o detalhe do aéreo.

Obs: Para que haja qualquer interação com o sistema de Webservice é necessário informar o cabeçalho de autenticação. Vide “Cabeçalho de Autenticação”.

Descrição dos campos de requisição consultaBilheteCia

Tag	Descrição	Parent	Formato	Required
localizador	Localizador do aéreo na CIA	consultaBilheteCia	String	True
bilhete	Bilhete a ser consultado	consultaBilheteCia	String	True
source	Source no qual o bilhete foi emitido: AZUL, TAM, TAM_MERCOSUL, GOL, PASSAREDO, META, SETE, PUMAAIR, NHT, MAP, PIQUIATUBA, AVIANCA, AVIANCA_V2, GOL_V2, TRAVELPORT, SABRE, FLYWAYS, LATAM	consultaBilheteCia	Enum	True

35.2 - Exemplo

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
  xmlns:ser="http://lemontech.com.br/selfbooking/wsselfbooking/services">
   <soapenv:Header>
      <ser:userPassword>userPassword</ser:userPassword>
      <ser:userName>userName</ser:userName>
      <ser:keyClient>keyClient</ser:keyClient>
   </soapenv:Header>
   <soapenv:Body>
      <ser:consultaBilheteCia>
         <consultaBilheteCia>
            <localizador>XXXXXX</localizador>
            <bilhete>999999999999</bilhete>
            <source>TAM</source>
         </consultaBilheteCia>
      </ser:consultaBilheteCia>
   </soapenv:Body>
</soapenv:Envelope>

35.3 - Resposta

A resposta do serviço é enviada com a tag consultaBilheteCiaResponse informando “Sucesso”, caso o cadastro efetuado corretamente e “Erro”, caso o bilhete não seja encontrado.

Descrição dos campos de Consulta Bilhete Cia Response

Tag	Descrição	Parent	Formato
resultadoAcao	Resultado da Consulta	consultaBilheteCiaResponse	ResultadoAcao

Descrição do campo ResultadoAcao

Tag	Descrição	Parent	Formato
status	Se SUCESSO a consulta foi efetuada com sucesso Se ERRO ocorreu algum problema durante a consulta	consultaBilheteCiaResponse	resultadoAcao
aereo	Aereo retornado na consulta	consultaBilheteCiaResponse	Aereo
mensagem	Mensagem com a descrição do status retornado	consultaBilheteCiaResponse	String

Aereo

Tag	Descrição	Parent	Formato
id	Número de identificação do aéreo	aereo	Inteiro
localizador	Localizador da empresa que emitiu a viagem	aereo	String
localizadorGds	Indica se o localizador é do gds	aereo	Boolean
source	Fonte em que foi realizada a pesquisa. (Ex: Sabre, Gol, Webjet)	aereo	String
codigoEmissor	Número de identificação do emissor no sistema	aereo	Inteiro
nomeEmissor	Nome do Emissor	aereo	String
codigoReservador	Número de identificação do reservador no sistema	aereo	Inteiro
nomeReservador	Nome do reservador	aereo	String
dataVencimento	Data de vencimento para realizar a confirmação da viagem	aereo	YYYY-MM-DDTHH:mm:SS
dataEmissao	Data em que o bilhete do voo foi emitido	aereo	YYYY-MM-DDTHH:mm:SS
dataReserva	Data em que foi realizada a reserva do voo	aereo	YYYY-MM-DDTHH:mm:SS
menorTarifa	Menor tarifa encontrada para o voo e a data selecionada	aereo	Double (#.##)
maiorTarifa	Maior tarifa encontrada para o voo e a data selecionada	aereo	Double (#.##)
codigoFornecedor	Número de identificação do fornecedor no sistema	aereo	Inteiro
idPassageiroRef	Número de identificação que vincula o passageiro com o produto aéreo	aereo	Inteiro
aereoTarifa	Elemento que contém informações da tarifa aplicada na viagem	aereo	Aereo Tarifa
aereoSeguimento	Elemento que guarda as informações da viagem	aereo	Aereo Segmento
formaPagamento	Elemento que contém as informações sobre a forma que a viagem foi paga	aereo	Forma Pagamento
aereoBilhete	Elemento que contém as informações do bilhete que foi emitido para a viagem	aereo	Aereo Bilhete
selfbook	Informa se a viagem foi selecionada via selfbooking	aereo	Boolean
justificativaMaiorTarifa	Justificativa para a escolha de uma tarifa maior que a menor tarifa encontrada	aereo	String
ciaMenorTarifa	Cia da menor tarifa encontrada para o voo e a data selecionada	aereo	String
emailEmissor	E-mail do emissor	aereo	String
nacional	Indica se o voo é nacional ou internacional	aereo	Boolean
codigoJustificativaMenorTarifa	Código da justificativa para a escolha de uma tarifa maior que a menor tarifa encontrada	aereo	Inteiro
observacao	Observação do emissor ao cliente quando conclui uma Solicitação	aereo	String
tipoVoo	Tipo do voo (Direto, Conexão ou Escala)	aereo	String
remarks	Elemento que contém as informações do remark	aereo	Remark
identificadorIntegracao	Identificador de integração web service	aereo	String
identificadorBackOfficeTipoProduto	Identificador do Tipo Produto	aereo	String
statusCancelamento	Status do cancelamento do produto: 0=reembolso, 1= crédito cia aérea, 2=em aberto.	aereo	Inteiro
valorMulta	Valor da multa se aplicada no reembolso	aereo	Double (#.##)
valorReembolso	Valor de reembolso solicitado na Cia aérea	aereo	Double (#.##)
dataModificacaoStatusCancelamento	Data que foi modificado o status do cancelamento	aereo	YYYY-MM-DDTHH:mm:SS
usuarioModificouStatusCancelamento	Usuário que modificou o status do cancelamento	aereo	Inteiro
totalAereo	É a somatória de todos os elementos totalTarifaPax.	aereo	Double (#.##)
cancelado	Indica se o produto está cancelado ou não.	aereo	boolean
identificadoresIntegracao	Identificador da Integração	aereo	Identificadores Integração
Reemissão	Reemissão	aereo	Reemissao
consolidadora	Elemento que guarda as informações da Agência consolidadora	aereo	Consolidadora
complementoJustificativaMaiorTarifa	Complemento da Justificativa para a escolha de uma tarifa maior que a menor tarifa encontrada	aereo	String
canceladoEmitido	Indica se o foi cancelado depois de ser emitido	aereo	boolean
identificadoresIntegracao	Elemento que guarda informações de identificação de integração da com outros sistemas	aereo	Identificadores Integração
autoEmissao	Informa se houve auto emissão	aereo	boolean
importado	Elemento utilizado para identificar se é importado	aereo	boolean
online	Elemento utilizado para identificar se o produto é online	aereo	boolean
agenteOnline	Elemento utilizado para identificar se é agente online	aereo	boolean
opcaoRota	Elemento utilizado para identificar se houve opção de rota	aereo	boolean

Aereo Tarifa

Tag	Descrição	Parent	Formato
acordo	Código do acordo aplicado na tarifa	aereoTarifa	String
classe	Classe onde a tarifa foi reservada. (Y = Economica, C = Executiva, F = Primeira Classe)	aereoTarifa	String
aereoTarifaPax	Elemento que contém as informações sobre como tarifa é paga pelo passageiro	aereoTarifa	Aereo Tarifa Pax

Aereo Tarifa Pax

Tag	Descrição	Parent	Formato
tarifa	Tarifa aplicada	aereoTarifaPax	Double (#.##)
taxa	Taxa aplicada	aereoTarifaPax	Double (#.##)
taxaDu	Taxa DU aplicada	aereoTarifaPax	Double (#.##)
tipoPax	Informa o tipo de passageiro: ADT(adulto), CHD(), INF()	aereoTarifaPax	Enum
quantidadePax	Quantidade de passageiros para aquele voo	aereoTarifaPax	Integer
tarifaSemAcordo	Valor da tarifa sem acordo	aereoTarifaPax	Double (#.##)
moeda	Tipo da Moeda	aereoTarifaPax	String
moedaBase	Tipo da Moeda Base	aereoTarifaPax	String
tarifaBase	Tipo da tarifa base	aereoTarifaPax	Double (#.##)
cotacao	Cotação da moeda utilizada	aereoTarifaPax	Double (#.##)
acordo	Código de acordo	aereoTarifaPax	String
totalTarifaPax	É a somatória da tarifa + taxa + taxaDU	aereoTarifaPax	Double (#.##)
taxaFee	Valor da taxa fee aplicada	aereoTarifaPax	Double (#.##)
valorFullFare	Valor da tarifa cheia (Full fare)	aereoTarifaPax	Double (#.##)

Aereo Segmento

Tag	Descrição	Parent	Formato
dataSaida	Data em que será iniciada a viagem	aereoSeguimento	YYYY-MM-DDTHH:mm:SS
destino	Destino da viagem	aereoSeguimento	String
dataChegada	Data em que será finalizada a viagem	aereoSeguimento	YYYY-MM-DDTHH:mm:SS
aereoVoo	Elemento que guarda os dados do voo, caso haja mais de um aereoVoo há uma conexão	aereoSeguimento	Aereo Voo
origem	Origem da viagem	aereoSeguimento	String
localizadorCia	Localizado da Cia aérea para o segmento	aereoSeguimento	String
milhas	Milhas percorridas	aereoSeguimento	Double (#.#)
paisOrigem	País do aeroporto de origem	aereoSeguimento	String
estadoOrigem	Estado do aeroporto de origem	aereoSeguimento	String
cidadeOrigem	Cidade do aeroporto de origem	aereoSeguimento	String
paisDestino	País do aeroporto de destino	aereoSeguimento	String
estadoDestino	Estado do aeroporto de destino	aereoSeguimento	String
cidadeDestino	Cidade do aeroporto de destino	aereoSeguimento	String

Aereo Voo

Tag	Descrição	Parent	Formato
idAereoVoo	Número de identificação do voo dentro do sistema	aereoVoo	Integer
origem	Código do aeroporto da origem do voo	aereoVoo	String
dataSaida	Data de saída do voo	aereoVoo	YYYY-MM-DDTHH:mm:SS
destino	Código do aeroporto do destino do voo	aereoVoo	String
dataChegada	Data de chegada do voo	aereoVoo	YYYY-MM-DDTHH:mm:SS
cia	Elemento que guarda as informações da empresa aérea que realizou a venda do voo	aereoVoo	Cia
ciaOperacao	Elemento que guarda as informações da empresa aérea que realizou o voo	aereoVoo	Cia Operação
aeronave	Modelo da aeronave	aereoVoo	String
numeroVoo	Número de identificação do voo	aereoVoo	Integer
aereoDetalheParada	Elemento que guarda as paradas (escalas) que o voo realizou	aereoVoo	Aereo Detalhe Parada
assento	Elemento que guarda as informações do assento reservado para o passageiro	aereoVoo	Assento
aereoDetalheBaseTarifa	Elemento que guarda as informações da base de tarifaria	aereoVoo	Aereo Datalhe Base Tarifária
localizadorCia	Localizado da Cia aérea para o segmento	aereoVoo	String
tipoVoo	Tipo do voo (Direto, Conexão ou Escala)	aereoVoo	String
milhas	Milhas percorridas	aereoVoo	Double (#.#)
idClasse	Número de identificação da classe	aereoVoo	Integer

Cia

Tag	Descrição	Parent	Formato
codigoIata	Código iata da companhia	cia	Integer
sigla	Sigla da companhia	cia	String

Cia Operação

Tag	Descrição	Parent	Formato
codigoIata	Código iata da companhia	ciaOperacao	Integer
sigla	Sigla da companhia	ciaOperacao	String

Aereo Detalhe Parada

Tag	Descrição	Parent	Formato
origem	Origem da escala	aereoDetalheParada	String
dataSaida	Data de saída da escala	aereoDetalheParada	YYYY-MM-DDTHH:mm:SS
destino	Destino da escala	aereoDetalheParada	String
dataChegada	Data de chegada da escala	aereoDetalheParada	YYYY-MM-DDTHH:mm:SS

Assento

Tag	Descrição	Parent	Formato
passageiroRef	Número de identificação do passageiro	aereoVooAssento	Inteiro
assento	Código de identificação do assento reservado	aereoVooAssento	String

Aereo Datalhe Base Tarifária

Tag	Descrição	Parent	Formato
baseTarifaria	Base tarifaria que foi utilizada	aereoDetalheBaseTarifa	String
classeTarifaria	Classe tarifaria que foi utilizada	aereoDetalheBaseTarifa	String

Aereo Bilhete

Tag	Descrição	Parent	Formato
idPassageiroRef	Número de identificação do passageiro que utilizou o bilhete	aereoBilhete	Integer
bilhete	Código de identificação do bilhete	aereoBilhete	String
bilheteOriginal	Código de identificação do bilhete original, caso haja remissão do bilhete	aereoBilhete	String
isLocalizador	Indica se é um localizador eletrônico, utilizado pelas empresas Gol e Azul	aereoBilhete	Boolean
numeroRecibo	Número do recibo do bilhete	aereoBilhete	String
tourCode	Tour Code informado pelo source SABRE	aereoBilhete	String

35.4 - Exemplo

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/" 
  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header/>
   <S:Body>
      <ns2:atualizarBudgetResponse 
        xmlns:ns2="http://lemontech.com.br/selfbooking/wsselfbooking/services">
         <resultadoOperacao>
            <status>SUCESSO</status>
            <aereo>
                <localizador>ZZZZZ</localizador>
                <localizadorGds>true</localizadorGds>
                <source>SABRE</source>
                <dataVencimento>2017-01-10T14:59:24</dataVencimento>
                <dataReserva>2017-01-10T14:59:24</dataReserva>
                <menorTarifa>1064.62</menorTarifa>
                <maiorTarifa>1064.62</maiorTarifa>
                <codigoFornecedor>JJ</codigoFornecedor>
                <aereoTarifa>
                   <acordo>TESTE</acordo>
                   <classe>ECONOMICA</classe>
                   <aereoTarifaPax>
                      <tarifa>1064.62</tarifa>
                      <taxa>27.68</taxa>
                      <taxaDu>0.0</taxaDu>
                      <tipoPax>ADT</tipoPax>
                      <quantidadePax>1</quantidadePax>
                      <tarifaSemAcordo>1364.9</tarifaSemAcordo>
                      <moeda>BRL</moeda>
                      <moedaBase>BRL</moedaBase>
                      <tarifaBase>1064.62</tarifaBase>
                      <acordo>TESTE</acordo>
                      <totalTarifaPax>1092.3</totalTarifaPax>
                      <taxaFee>0.0</taxaFee>
                   </aereoTarifaPax>
                </aereoTarifa>
                <aereoSeguimento>
                   <origem>FLN</origem>
                   <dataSaida>2017-01-11T16:54:00</dataSaida>
                   <destino>CGH</destino>
                   <dataChegada>2017-01-11T18:00:00</dataChegada>
                   <aereoVoo>
                      <idAereoVoo>0</idAereoVoo>
                      <origem>FLN</origem>
                      <dataSaida>2017-01-11T16:54:00</dataSaida>
                      <destino>CGH</destino>
                      <dataChegada>2017-01-11T18:00:00</dataChegada>
                      <cia>
                         <codigoIata>957</codigoIata>
                         <sigla>JJ</sigla>
                      </cia>
                      <ciaOperacao>
                         <codigoIata>957</codigoIata>
                         <sigla>JJ</sigla>
                      </ciaOperacao>
                      <aeronave>319</aeronave>
                      <numeroVoo>3104</numeroVoo>
                      <milhas>305.0</milhas>
                      <assento>
                         <assento>19D</assento>
                      </assento>
                      <aereoDetalheBaseTarifa>
                         <baseTarifaria>MD0X0N8</baseTarifaria>
                         <classeTarifaria>M</classeTarifaria>
                      </aereoDetalheBaseTarifa>
                      <idClasse>1</idClasse>
                      <localizadorCia>XXXXXXX</localizadorCia>
                   </aereoVoo>
                   <localizadorCia>XXXXXXX</localizadorCia>
                   <milhas>305.0</milhas>
                   <paisOrigem>BR</paisOrigem>
                   <estadoOrigem>SC</estadoOrigem>
                   <paisDestino>BR</paisDestino>
                   <estadoDestino>SP</estadoDestino>
                   <cidadeOrigem>FLORIANOPOLIS</cidadeOrigem>
                   <cidadeDestino>SAO PAULO</cidadeDestino>
                </aereoSeguimento>
                <formaPagamento>
                   <valor>1092.3</valor>
                   <formaPagameno>FA</formaPagameno>
                   <tipo>BILHETE</tipo>
                </formaPagamento>
                <aereoBilhete>
                   <bilhete>9572386510015</bilhete>
                   <isLocalizador>false</isLocalizador>
                </aereoBilhete>
                <selfbook>true</selfbook>
                <canceladoEmitido>false</canceladoEmitido>
                <nacional>true</nacional>
                <totalAereo>1092.3</totalAereo>
                <cancelado>false</cancelado>
                <autoEmissao>false</autoEmissao>
                <importado>false</importado>
                <online>true</online>
                <agenteOnline>false</agenteOnline>
                <opcaoRota>false</opcaoRota>
         </aereo>
         </resultadoOperacao>
      </ns2:atualizarBudgetResponse>
   </S:Body>
</S:Envelope>

35.5 - Exemplo

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/" 
  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
   <SOAP-ENV:Header/>
   <S:Body>
      <ns2:atualizarBudgetResponse 
        xmlns:ns2="http://lemontech.com.br/selfbooking/wsselfbooking/services">
         <resultadoOperacao>
            <status>ERRO</status>
            <mensagem>Bilhete nao localizado</mensagem>
         </resultadoOperacao>
      </ns2:atualizarBudgetResponse>
   </S:Body>
</S:Envelope>

Capítulo anterior

Serviço atualizarBudget

Próximo capítulo

Serviço cadastrarHoteisHomologados