Académique Documents
Professionnel Documents
Culture Documents
Índice
1 Introdução .................................................................................................................... 4
1.1 Objetivo.................................................................................................................... 4
1.2 Definições e Abreviaturas ........................................................................................ 4
Visão Técnica...................................................................................................................... 5
1.3 Arquitetura ............................................................................................................... 5
1.4 Acesso ao sistema................................................................................................... 6
2 Funcionalidades ........................................................................................................... 8
2.1 Serviços disponíveis ................................................................................................ 8
2.1.1 TAM_Altea_Seguranca_Autenticar .................................................................. 8
2.1.2 TAM_Altea_Seguranca_Sair ............................................................................ 8
2.1.3 TAM_Altea_Aereo_ObterMapaAssentos.......................................................... 8
2.1.4 TAM_Altea_Aereo_infoVoo .............................................................................. 8
2.1.5 TAM_Altea_Aereo_MultiDisponibilidade........................................................... 8
2.1.6 TAM_Altea_Aereo_RemarcarSegAereo........................................................... 8
2.1.7 TAM_Altea_Aereo_VenderdaDisponibilidade................................................... 8
2.1.8 TAM_Altea_Aereo_VenderDaRecomendacao ................................................. 9
2.1.9 TAM_Altea_Commando_Criptico ..................................................................... 9
2.1.10 TAM_Altea_Tarifa_Upsell (Disponibilidade Tarifada).................................... 9
2.1.11 TAM_Altea_Tarifa_VerificarRegras .............................................................. 9
2.1.12 TAM_Altea_Tarifa_TarifasParCidades ......................................................... 9
2.1.13 TAM_Altea_Tarifa_TarifacaoInformativasemPNR ........................................ 9
2.1.14 TAM_Altea_Tarifa_TarifarPNRClasseReservada ......................................... 9
2.1.15 TAM_Altea_Tarifa_TarifarPNRMenorPrecoDisponivel ................................. 9
2.1.16 TAM_Altea_Tarifa_TarifarPNRMenorPrecoPossivel..................................... 9
2.1.17 TAM_Altea_PNR_AdicionarCartaoFidelidade............................................. 10
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
Dados do Documento
Empresa Amadeus
Departamento IT Services – Equipe de Suporte e Certificação TAM Web Services
Autor Maria Melo / Ricardo Osiro
Revisado por Joelma Martins / Viviane Carvalho Date 01/07/2009
Aprovado por Approver Name Date DD / MM / YYYY
Versão Data Alter Comment Por
1.0 01 / 07 / 2009
TAM Web Services – Manual de Apoio à Transição
1 Introdução
1.1 Objetivo
TERMO DESCRIÇÃO
RES Sistema Booking Web Services (TAM)
EWS Sistema e-Ticket TAM Web Services
WSDL Web Services Definition Language, é uma linguagem baseada em
XML utilizada para descrever Web Services. Trata-se de um
documento escrito em XML que além de descrever o serviço,
especifica como acessá-lo e quais as operações ou métodos
disponíveis.
XSD Um arquivo contendo as definições na linguagem XML Schema é
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
Visão Técnica
1.3 Arquitetura
Aspectos importantes:
• Os Web Services TAM são construídos seguindo os padrões W3C para web services:
WSDL, SOAP, HTTP/HTTPS, Schemas XSD
o Validação de mensagens SOAP através de schemas.
o Geração de proxys através de WSDL para converter objetos em mensagens XML.
• O Web Services confia na segurança estabelecida nos Office IDs (Point of Sale) com
relação a funcionalidades e conteúdo. Usuários podem utilizar somente o que estiver
habilitado em seus Office IDs.
• O acesso às funcionalidades e conteúdo via WS pode ser feito usando:
o XML estruturado
o Comandos crípticos e screen scrapping dentro de mensagens XML. Não é
recomendado na maioria dos casos.
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
<awsec:Secure>
<awsec:SessionId>00001I27PH</awsec:SessionId>
<awsec:SequenceNumber>2</awsec:SequenceNumber>
<awsec:SecurityToken>SPAXT4LQAAESR1NT8I1I7TFUF</awsec:SecurityToken>
</awsec:Secure>
Esta chave de sessão permite chamadas stateful, basta que ela seja incrementada e enviada
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
Requisição: sign-in
Resposta:
<awsec:SessionId>00001I27PH</awsec:SessionId>
<awsec:SequenceNumber>1</awsec:SequenceNumber>
<awsec:SecurityToken>SPAXT4LQAAESR1NT8I1I7TFUF</awsec:SecurityToken>
Requisição:
<awsec:SessionId>00001I27PH</awsec:SessionId>
<awsec:SequenceNumber>2</awsec:SequenceNumber>
<awsec:SecurityToken>SPAXT4LQAAESR1NT8I1I7TFUF</awsec:SecurityToken>
Resposta:
<awsec:SessionId>00001I27PH</awsec:SessionId>
<awsec:SequenceNumber>2</awsec:SequenceNumber>
<awsec:SecurityToken>SPAXT4LQAAESR1NT8I1I7TFUF</awsec:SecurityToken>
Quando uma sessão não é mais necessária, ela deve ser encerrada, através do serviço
TAM_Altea_Seguranca_Sair.
Constante = “B2T-JJ2”
TAM Web Services – Manual de Apoio à Transição
2 Funcionalidades
Nesta seção listaremos os serviços disponíveis com uma breve descrição dos mesmos.
2.1.1 TAM_Altea_Seguranca_Autenticar
Este serviço deve ser usado para autenticar-se no sistema TAM através de um login válido.
Devem ser informados a organização, office id, usuário e senha para os quais se deseja efetuar
o login.
2.1.2 TAM_Altea_Seguranca_Sair
Permite ao usuário sair do sistema TAM. Em outras palavras, a(s) sessão(ões) existente(s)
é(são) encerrada(s).
2.1.3 TAM_Altea_Aereo_ObterMapaAssentos
O mapa de assentos pode ser solicitado para os vôos TAM ou de outras companhias aéreas
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
2.1.4 TAM_Altea_Aereo_infoVoo
A função de informações de vôo provê informações atualizadas referentes à operação de um
determinado vôo antes, durante e após a saída do mesmo.
2.1.5 TAM_Altea_Aereo_MultiDisponibilidade
Esta função permite a solicitação de disponibilidade neutra, ou seja, sem informações de tarifas.
2.1.6 TAM_Altea_Aereo_RemarcarSegAereo
2.1.7 TAM_Altea_Aereo_VenderdaDisponibilidade
Esta função pode ser utilizada para a venda de um segmento aéreo, logo após uma
disponibilidade neutra.
TAM Web Services – Manual de Apoio à Transição
2.1.8 TAM_Altea_Aereo_VenderDaRecomendacao
Esta função deve ser utilizada para a venda de uma recomendação de vôo, logo após uma
disponibilidade tarifada.
2.1.9 TAM_Altea_Commando_Criptico
Esta função deve ser usada para transações que não possuem uma mensagem estruturada
disponível.
Esta função permite a busca das melhores recomendações de vôos e tarifas, de acordo com
famílias de tarifas e outros parâmetros de busca.
2.1.11 TAM_Altea_Tarifa_VerificarRegras
Esta função deve ser utilizada logo após uma transação de tarifação informativa ou de PNR, e
permite a busca de regras tarifárias relativas a uma tarifa específica.
2.1.12 TAM_Altea_Tarifa_TarifasParCidades
Esta função retorna uma lista de tarifas disponíveis para um mercado específico. Ela também
retorna informações básicas e resumidas referente às regras que devem ser aplicadas a estas
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
tarifas.
2.1.13 TAM_Altea_Tarifa_TarifacaoInformativasemPNR
2.1.14 TAM_Altea_Tarifa_TarifarPNRClasseReservada
Esta função possibilita precificar os segmentos aéreos para passageiros específicos ou todos os
passageiros em um PNR recém criado ou já existente. O sistema aplica a menor tarifa existente
para a classe de reserva informada no PNR e ao menos que seja solicitado o contrário, todo o
cálculo é efetuado na moeda do país em que se encontra configurado o sistema.
2.1.15 TAM_Altea_Tarifa_TarifarPNRMenorPrecoDisponivel
Esta função retorna uma lista de menores tarifas com lugares disponíveis para o itinerário
reservado em um PNR recém criado ou já existente.
2.1.16 TAM_Altea_Tarifa_TarifarPNRMenorPrecoPossivel
Esta função possibilita a busca da menor tarifa possível para um itinerário reservado
(independente de haver disponibilidade) em um PNR recém criado ou já existente.
TAM Web Services – Manual de Apoio à Transição
2.1.17 TAM_Altea_PNR_AdicionarCartaoFidelidade
Esta função deve ser utilizada para adicionar um cartão de fidelidade em um PNR, com duas
possibilidades: criar um ou vários elementos associados a um passageiro já existente no PNR
ou criar o elemento nominal (passageiro) juntamente com o elemento de serviço relacionado ao
cartão fidelidade.
2.1.18 TAM_Altea_PNR_AdicionarMultiElementos
Esta função deve ser usada para a criação de PNRs, permitindo a inserção de vários elementos
de uma única vez.
Esta função deve ser usada para cancelar elementos específicos do PNR, ou mesmo todo o
itinerário.
2.1.20 TAM_Altea_PNR_ExibirHistorico
Esta função deve ser usada para recuperar todo ou parte do histórico de um PNR específico.
2.1.21 TAM_Altea_PNR_Recuperar
Esta função deve ser usada para recuperar todas as informações de um PNR específico, ou
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
2.1.22 TAM_Altea_PNR_Dividir
Os PNRs original e associado ficam relacionados através do AXR (Asociated Record Indexing).
2.1.23 TAM_Altea_PNR_TransferirPropriedade
Esta função deve ser usada para transferir a responsabilidade de um PNR para um outro office
id.
2.1.24 TAM_Altea_Perfil_Obter
Esta função deve ser usada para recuperar informações de um perfil de cliente.
2.1.25 TAM_Altea_Fila_Listar
2.1.26 TAM_Altea_Bilhete_CriarTSTAposTarifacao
Esta função possibilita a criação da máscara de emissão automática (TST). O sistema armazena
automaticamente as informações referentes a uma tarifação efetuada exatamente antes da
chamada desta função.
2.1.27 TAM_Altea_Bilhete_ProcessarETicket
2.1.28 TAM_Altea_Emissao_EmitirBilhete
2.1.29 TAM_Altea_Emissao_EmitirMD
2.1.30 TAM_Altea_Emissao_EmitirCombinado
2.1.31 TAM_Altea_Reembolso_Iniciar
Esta função deve ser usada para iniciar um novo processo de reembolso. A partir de um número
de bilhete, ela retorna as informações do documento a ser reembolsado.
A partir disso, a aplicação usuária poderá atualizar, salvar ou ignorar o reembolso, conforme
descrito nos itens a seguir.
2.1.32 TAM_Altea_Reembolso_Atualizar
Este serviço deve ser usado para atualizar o conteúdo de um documento de reembolso
previamente recuperado pelo método Iniciar.
2.1.33 TAM_Altea_Reembolso_Ignorar
Esta função deve ser utilizada caso a aplicação queira descartar um documento de reembolso
previamente recuperado. Todos os dados não previamente gravados serão perdidos.
2.1.34 TAM_Altea_Reembolso_Processar
Esta função permite que um documento de reembolso previamente recuperado seja salvo.
TAM Web Services – Manual de Apoio à Transição
2.1.35 TAM_Altea_PNR_CriarTSM
Esta transação cria uma TSM (mascara para emissão de MCOs – miscellaneous documents).
2.1.36 TAM_Altea_PNR_ApagarTSM
Este serviço deve ser utilizado para apagar uma TSM específica.
2.1.37 TAM_Altea_PNR_ExibirTSM
Através desse serviço é possível recuperar todas as informações referentes a uma TSM
específica.
2.1.38 TAM_Altea_PNR_AtualizarTSM
Esta função deve ser usada para atualizar dados de uma TSM específica. Todos os dados
podem ser atualizados com exceção da data, tipo e associação a passageiro.
2.1.39 TAM_Altea_PNR_ListarTSM
Esta transação disponibiliza uma lista de todas as TSMs existentes em um PNR. TSMs
previamente apagadas não são consideradas.
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
2.1.40 TAM_Altea_Fila_RemoverItem
Esta função deve ser utilizada para remover um PNR de uma fila.
2.1.41 TAM_Altea_Bilhete_ChecarElegibilidade
2.1.42 TAM_Altea_Bilhete_ApagarTST
Este serviço permite a exclusão de uma ou várias TSTs de um PNR em criação ou já existente.
2.1.43 TAM_Altea_Bilhete_ExibirTST
Este serviço deve ser utilizado para recuperar parte ou toda a informação referente a uma TST.
2.1.44 TAM_Altea_Bilhete_RetarifarPNRClasseReservada
Referente ao processo de reemissão, esta função deve ser utilizada para retarifar parcialmente
ou totalmente um PNR, na classe de serviço reservada.
TAM Web Services – Manual de Apoio à Transição
2.1.45 TAM_Altea_Bilhete_RetarifarPNRMenorPrecoPossivel
Referente ao processo de reemissão, esta função deve ser utilizada para retarifar parcialmente
ou totalmente um PNR, na menor classe de serviço possível.
2.1.46 TAM_Altea_Bilhete_ReemitirTarifacaoConfirmada
2.1.47 TAM_Altea_Bilhete_BuscaUpsell
A tabela a seguir demonstra o relacionamento entre os serviços dos atuais sistemas RES/EWS
e os novos serviços TAM Web Services:
TAM_Altea_PNR_AdicionarMultiElementos 1
RES <ignorarTransacao> TAM_Altea_PNR_AdicionarMultiElementos 1
RES <alterarSenha> Não mais disponibilizado N/A
RES <alterarClasseReserva> TAM_Altea_Aereo_RemarcarSegAereo 1
RES <consultarListaPNR> TAM_Altea_Fila_Listar 1
RES <finalizarFilaPnr> TAM_Altea_Fila_RemoverItem 2
RES <obterInformacoesAdicionaisVoos> TAM_Altea_Aereo_infoVoo 1
RES <transferirPNR> TAM_Altea_PNR_TransferirPropriedade 1
RES <incluirSegmentoOpen> TAM_Altea_PNR_AdicionarMultiElementos 1
RES <confirmarSegmento> TAM_Altea_PNR_AdicionarMultiElementos 1
RES <consultarHistorico> TAM_Altea_PNR_ExibirHistorico 1
RES <excluirRemarks> TAM_Altea_PNR_Cancelar 1
RES <consultarReservaAssento> TAM_Altea_PNR_Recuperar 1
RES <dividirGrupo> TAM_Altea_PNR_Dividir 1
RES <obterListaVoosFareBundle> Mensagem de Disponibilidade Tarifada 2
RES <obterListaVoosProximaFareBundle> Mensagem de Disponibilidade Tarifada 2
RES <tarifarReservaFareBundle> TAM_Altea_Tarifa_TarifacaoInformativasemPNR 1
RES <obterTextosBundles> TAM_Altea_Tarifa_VerificarRegras 1
RES <obterSellUp> Mensagem de Disponibilidade Tarifada 2
RES <tarifarBundle> TAM_Altea_Tarifa_TarifarPNRMenorPrecoDisponivel 1
RES <obterListaTarifasBundle> Mensagem de Disponibilidade Tarifada 2
TAM Web Services – Manual de Apoio à Transição
TAM_Altea_PNR_AdicionarMultiElementos 1
EWS <efetuaPagamentoMCO> TAM_Altea_PNR_AdicionarMultiElementos 1
EWS <listaPagamentosSessao> TAM_Altea_PNR_Recuperar 1
EWS <removePagamentoSessao> TAM_Altea_PNR_Cancelar 1
EWS <emissaoEticket> Emissão_EmitirBilhete 2
EWS <consultaTipoPassageiro> Não mais disponibilizado N/A
EWS <consultaFormaPagamento> Não mais disponibilizado N/A
EWS <geraResumoVendas> TBD. Será disponibilizada na versão 3 3
EWS <geraResumoVendasAutomatico> TBD. Será disponibilizada na versão 3 3
EWS <geraResumoTEF> Sistema de Gateway de Pagamento N/A
EWS Mensagens de Reembolso: TAM_Altea_Reembolso_Iniciar
<enviaSolicitacoesReembolso>
<consultaSolicitacaoStatus> TAM_Altea_Reembolso_Processar
<consultaSolicitacoesReembolsoAbert TAM_Altea_Reembolso_Atualizar 2
as>
TAM_Altea_Reembolso_Ignorar
<consultaMotivoReembolso>
EWS <consultaDocumentoReembolsavel> TAM_Altea_Bilhete_ProcessarETicket 1
EWS <consultaHistorico> TAM_Altea_PNR_ExibirHistorico 1
EWS <cancelaDocumento> TAM_Altea_Bilhete_ProcessarETicket 1
(com opção Void)
EWS <obtemListaDocumentosIdentificacao> Não mais disponibilizado N/A
EWS <obtemListaPaises> Não mais disponibilizado N/A
EWS <listaBilhetesPNR> TAM_Altea_PNR_Recuperar 1
TAM Web Services – Manual de Apoio à Transição
Nesta seção recomendaremos as melhores práticas para fluxos dos processos mais utilizados.
Os mesmos devem ser adaptados de acordo com a aplicação usuária, porém vale reforçar que
o cumprimento das mesmas é garantia de um processo de certificação positivo e de que a
aplicação usuária está desenvolvida de forma mais eficiente possível para uso do TAM Web
Services.
Esta sessão contém uma breve descrição de sugestão de como gerenciar um pool de sessões
stateless.
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
1) Base de dados:
Uma tabela deve ser criada contendo quatro colunas: Session ID, Sequence Number, Security
Token, e Last Query Date.
Os três primeiros campos representam a chave de sessão e o quarto campo, a data exata da
última chamada enviada para o sistema.
2) Processos
Três diferentes processos devem acessar essa base de dados: manutenção, busca e nova
sessão.
O propósito deste processo é limpar a base de dados de sessões muito velhas. Este processo
deve ser executado a cada X segundos (recomendação: 30).
TAM Web Services – Manual de Apoio à Transição
Seleciona a primeira
sessão
Seleciona a próxima
sessão
Sim
Fecha a sessão
Este processo inicia quando um usuário da aplicação requisita um serviço stateless. Uma
sessão disponível é escolhida do pool ou então criada, a chamada é enviada e a base de dados
é atualizada.
Este processo tenta criar uma sessão em um máximo de cinco tentativas. Se bem sucedida, a
informação da sessão deve ser armazenada na base de dados, caso contrário uma mensagem
de erro é retornada.
TAM Web Services – Manual de Apoio à Transição
Contador = 1
Contador + 1
Envia chamada de
autenticação
Não
Sim Sim
2.3.5 Emissão
TAM Web Services – Manual de Apoio à Transição
TAM Web Services – Manual de Apoio à Transição
Revender segmentos
TAM_Altea_Aereo_RemarcarSegAereo
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
Precificar PNR
TAM_Altea_Tarifa_TarifarPNRClasse
Reservada
Mostrar
confirmação
ao Usuário
Criar TST
TAM_Altea_Bilhete_CriarTSTApos
Tarifacao
Encerrar Sessão 2
Encerrar sessão 1
TAM_Altea_PNR_
AdicionarMultiElementos
Usuário insere informações Para a criação do PNR com todas as
informações
option code 10
Iniciar Sessão 2
TAM Web Services – Manual de Apoio à Transição
Para que o processo de certificação seja bem sucedido, é imprescindível que a aplicação seja
desenvolvida de forma a evitar alguns erros mais comuns e que sejam implementados os
elementos mandatórios antes que a mesma seja submetida ao processo de certificação.
A lista abaixo contém alguns exemplos de incidentes, divididos por assunto (Geral, PNR, filas,
etc.), dentro dos três possíveis níveis de classificação: Erro, Aviso e Comentário.
Tipos de Incidente
IMPACTO NA
INCIDENTE CARACTERÍSTICA
CERTIFICAÇÃO
Processo suspenso até
Comportamento incorreto da
ERRO aplicação
correção ou não certificação da
aplicação
Comportamento que traz
consequências negativas à Não impede a certificação
AVISO aplicação e cuja correção é positiva
extremamente recomendada
TIPO
GERAL
INCIDENTE
A aplicação não deve criar loops no servidor TAM Erro
Tratamento de erros deve ser implementado da forma correta Erro
Aplicação deverá tratar corretamente o XML de resposta da Erro
requisição enviada
O formato dos dados e valores deverá ser verificado antes do envio Erro
para o servidor da TAM.
3 Documentação
A documentação TAM Web Services inclui os seguintes componentes:
• User Guide:
o Os User Guides provêem uma macro visão de cada funcionalidade, contendo
uma descrição para cada mensagem e alguns casos de uso com exemplos de
XMLs. Todos os serviços possuem um User Guide correspondente;
• Technical Reference:
o Referência técnica para cada mensagem, com a explicação de sua estrutura,
entidades e tabelas de código quando aplicável. Todos os serviços possuem um
Technical Reference correspondente;
• Schemas XML:
o Arquivos com a definição formal da especificação utilizando-se do padrão W3C
para XML Schema Definition (.xsd’s). Para cada mensagem de chamada e
retorno existe um arquivo XSD correspondente;
• WSDL:
o Documento que utiliza a linguagem WSDL para descrever o serviço, especificar
como acessá-lo e quais as operações ou métodos disponíveis.
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização