tam webservices - manual de apoio à migração
TRANSCRIPT
TAM WEB SERVICES
Manual de Apoio à Migração Versão 1.0
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transição
Í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 2.1.18 TAM_Altea_PNR_AdicionarMultiElementos ............................................... 10 2.1.19 TAM_Altea_ PNR_Cancelar ....................................................................... 10 2.1.20 TAM_Altea_PNR_ExibirHistorico................................................................ 10 2.1.21 TAM_Altea_PNR_Recuperar...................................................................... 10 2.1.22 TAM_Altea_PNR_Dividir ............................................................................ 10 2.1.23 TAM_Altea_PNR_TransferirPropriedade.................................................... 10 2.1.24 TAM_Altea_Perfil_Obter............................................................................. 10 2.1.25 TAM_Altea_Fila_Listar ............................................................................... 10 2.1.26 TAM_Altea_Bilhete_CriarTSTAposTarifacao.............................................. 11 2.1.27 TAM_Altea_Bilhete_ProcessarETicket ....................................................... 11 2.1.28 TAM_Altea_Emissao_EmitirBilhete ............................................................ 11 2.1.29 TAM_Altea_Emissao_EmitirMD.................................................................. 11 2.1.30 TAM_Altea_Emissao_EmitirCombinado..................................................... 11 2.1.31 TAM_Altea_Reembolso_Iniciar .................................................................. 11 2.1.32 TAM_Altea_Reembolso_Atualizar .............................................................. 11 2.1.33 TAM_Altea_Reembolso_Ignorar................................................................. 11 2.1.34 TAM_Altea_Reembolso_Processar............................................................ 11 2.1.35 TAM_Altea_PNR_CriarTSM....................................................................... 12 2.1.36 TAM_Altea_PNR_ApagarTSM ................................................................... 12 2.1.37 TAM_Altea_PNR_ExibirTSM...................................................................... 12 2.1.38 TAM_Altea_PNR_AtualizarTSM................................................................. 12 2.1.39 TAM_Altea_PNR_ListarTSM...................................................................... 12 2.1.40 TAM_Altea_Fila_RemoverItem................................................................... 12 2.1.41 TAM_Altea_Bilhete_ChecarElegibilidade ................................................... 12 2.1.42 TAM_Altea_Bilhete_ApagarTST................................................................. 12 2.1.43 TAM_Altea_Bilhete_ExibirTST ................................................................... 12 2.1.44 TAM_Altea_Bilhete_RetarifarPNRClasseReservada .................................. 12
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transição
2.1.45 TAM_Altea_Bilhete_RetarifarPNRMenorPrecoPossivel ............................. 13 2.1.46 TAM_Altea_Bilhete_ReemitirTarifacaoConfirmada..................................... 13 2.1.47 TAM_Altea_Bilhete_BuscaUpsell ............................................................... 13
2.2 Relacionamento de serviços entre sistemas .......................................................... 14 2.3 Melhores Práticas .................................................................................................. 18
2.3.1 Gerenciamento de Sessões ........................................................................... 18 2.3.2 Busca de disponibilidade tarifada ................................................................... 22 2.3.3 Busca de disponibilidade neutra..................................................................... 23 2.3.4 Criação de PNR ............................................................................................. 24 2.3.5 Emissão ......................................................................................................... 25 2.3.6 Retarifar PNR para menor tarifa aplicável ...................................................... 26 2.3.7 Checklist para Certificação............................................................................. 27
3 Documentação ........................................................................................................... 30
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
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transição
1 Introdução
1.1 Objetivo O principal objetivo deste documento é descrever as diferenças entre os atuais sistemas Booking Web Services (RES) e E-Ticket TAM Web Services (EWS) e o novo sistema TAM Web Services, a fim de possibilitar que os atuais usuários destes sistemas tenham as informações necessárias para realizar a migração de suas aplicações para o novo sistema. Este documento é destinado aos desenvolvedores de aplicações que atualmente já utilizam os Web Services TAM.
1.2 Definições e Abreviaturas
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 é chamado de XSD (XML Schema Definition), este descreve a estrutura de uma mensagem XML.
XML XML (eXtensible Markup Language) é uma recomendação da W3C para gerar linguagens de marcação para necessidades especiais.
W3C O World Wide Web Consortium é um consórcio de empresas de tecnologia. Fundado por Tim Berners-Lee em 1994 para levar a Web ao seu potencial máximo, por meio do desenvolvimento de protocolos comuns e fóruns abertos que promovem sua evolução e asseguram a sua interoperabilidade. O W3C desenvolve padrões para a criação e a interpretação dos conteúdos para a Web.
SOAP Simple Object Access Protocol, é um protocolo para troca de informações estruturadas em uma plataforma descentralizada e distribuída, utilizando tecnologias baseadas em XML.
Office ID Ponto de Venda. Equivalente a unidade operacional
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transiçã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.
O Integrador de serviços (IS) é o core da arquitetura
• Ele expõe todas as funcionalidades através dos pontos de acessos a serviços (SAP). Para o TAM Web Services este ponto chamará ponto de acesso a serviço web (WSAP)
• Permite a integração entre os componentes e sistemas
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transição
1.4 Acesso ao sistema A autenticação é o primeiro passo para a troca de informações entre a aplicação cliente e a TAM (através do serviço TAM_Altea_Segurança_Autenticar). Após uma autenticação positiva, a TAM cria uma sessão e retorna seu identificador. A chave de sessão (session ID) é retornada na mensagem TAM_Altea_Seguranca_AutenticarResp e deverá ser adicionada no SOAP Header nas requisições posteriores:
<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 pela aplicação cliente entre as sucessivas chamadas, conforme demonstrado a seguir:
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transiçã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. Abaixo estão relacionados os antigos e novos parâmetros de autenticação:
ATUAL NOVO OBSERVAÇÃO
cdUsuario User ID
cdSenha Password Codificado base-64
adUnidadeOperacional
sgIATACidade
Office ID
Duty Code Constante = “SU”
Organization ID Constante = “B2T-JJ2”
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transição
2 Funcionalidades
2.1 Serviços disponíveis
Nesta seção listaremos os serviços disponíveis com uma breve descrição dos mesmos. Todos os serviços possuem um documento “User Guide” e “Technical Reference” correspondente; estes documentos devem ser consultados para a obtenção de maiores detalhes técnicos e funcionais de cada serviço.
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 que possuam acordo de mapa de assentos interativo com a TAM.
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
Esta função possibilita efetuar a revenda de segmentos existentes em um PNR (novo ou já existente). Porém, não é possível fazer alterações em PNR de grupo, segmentos open, informativos, de companhias aéreas não participantes do sistema TAM ou segmentos passivos, com a utilização deste serviço.
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.
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
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.
2.1.10 TAM_Altea_Tarifa_Upsell (Disponibilidade Tarifada)
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 tarifas.
2.1.13 TAM_Altea_Tarifa_TarifacaoInformativasemPNR
Esta função possibilita precificar um itinerário sem a necessidade de criação de um PNR. Nenhum bilhete pode ser criado.
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.
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
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.
2.1.19 TAM_Altea_ PNR_Cancelar
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 para carregar um PNR dentro de uma sessão.
2.1.22 TAM_Altea_PNR_Dividir
Esta função possibilita a separação de passageiros de um PNR original, com a criação de um novo PNR associado, com os dados desses passageiros e demais elementos relacionados. 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
Esta função retorna uma lista de PNRs existentes em uma fila.
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transição
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
Este serviço provê diferentes funcionalidades dependendo do critério de chamada: display de um bilhete eletrônico específico ou de uma lista de bilhetes; histórico de um bilhete eletrônico específico; requisição de emissão de um bilhete de papel ou cancelamento de um bilhete eletrônico.
2.1.28 TAM_Altea_Emissao_EmitirBilhete
Este serviço possibilita a emissão de e-Tickets.
2.1.29 TAM_Altea_Emissao_EmitirMD
Este serviço possibilita a emissão de MCOs (Miscellaneous Documents).
2.1.30 TAM_Altea_Emissao_EmitirCombinado
Este serviço possibilita a emissão de e-Tickets e MCOs conjuntamente.
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.
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
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.
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
Mensagem relacionada ao processo de reemissão. O objetivo dessa transação é ajudar o cliente na escolha das mudanças em seu itinerário, possibilitando a retarifação do mesmo.
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.
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
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
Esta transação confirma uma retarifação executada via TAM_Altea_RetarifarPNRClasseReservada ou TAM_Altea_RetarifarPNRMenorPrecoPossivel, criando a TST com os dados para a reemissão.
2.1.47 TAM_Altea_Bilhete_BuscaUpsell
Esta operação permite a busca de recomendações de menores tarifas considerando número do bilhete original, famílias de tarifas e demais parâmetros da viagem. As menores recomendações por família de tarifas serão retornadas.
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transição
2.2 Relacionamento de serviços entre sistemas A tabela a seguir demonstra o relacionamento entre os serviços dos atuais sistemas RES/EWS e os novos serviços TAM Web Services: SISTEMA DE PARA VERSÃO
RES <autenticarUsuario> TAM_Altea_Seguranca_Autenticar 1
Logout TAM_Altea_Seguranca_Sair 1
RES <alterarCartaoFidelidade> TAM_Altea_TAM_Altea_PNR_Cancelar +
TAM_Altea_PNR_AdicionarCartaoFidelidade
1
RES <obterListaVoos> TAM_Altea_Aereo_MultiDisponibilidade 1
RES <obterListaVoosProxima> TAM_Altea_Aereo_MultiDisponibilidade 1
RES <consultarBuffer> TAM_Altea_PNR_Recuperar (opção 0) 1
RES <carregarReserva> TAM_Altea_PNR_Recuperar 1
RES <consultarReserva> TAM_Altea_PNR_Recuperar 1
RES <tarifarReserva> TAM_Altea_Tarifa_TarifarPNRClasseReservada
OU TAM_Altea_Tarifa_TarifarPNRMenorPrecoDisponivel
OU TAM_Altea_Tarifa_TarifarPNRMenorPrecoPossivel
+
TAM_Altea_Bilhete_CriarTSTAposTarifacao (opcional)
1
RES <obterMapaAssentos> TAM_Altea_Aereo_ObterMapaAssentos 1
RES <consultarTarifas> TAM_Altea_Tarifa_TarifasParCidades 1
RES <consultarLocalizador> TAM_Altea_PNR_Recuperar 1
RES <consultarFidelidade> TAM_Altea_Perfil_Obter 1
RES <codificarAeroporto> TBD. Será disponibilizada na versão 3 3
RES <codificarCidade> TBD. Será disponibilizada na versão 3 3
RES <codificarPais> TBD. Será disponibilizada na versão 3 3
RES <codificarEmpresaAerea> TBD. Será disponibilizada na versão 3 3
RES <codificarEquipamento> TBD. Será disponibilizada na versão 3 3
RES <codificarAcordos> TBD. Será disponibilizada na versão 3 3
RES <decodificarAeroportos> TBD. Será disponibilizada na versão 3 3
RES <decodificarCidade> TBD. Será disponibilizada na versão 3 3
RES <decodificarPais> TBD. Será disponibilizada na versão 3 3
RES <decodificarEmpresaAerea> TBD. Será disponibilizada na versão 3 3
RES <decodificarEquipamento> TBD. Será disponibilizada na versão 3 3
RES <decodificarAcordos> TBD. Será disponibilizada na versão 3 3
RES <dividirPNR> TAM_Altea_PNR_Dividir 1
RES <excluirCartaoFidelidade> TAM_Altea_PNR_Cancelar 1
RES <incluirCartaoFidelidade> TAM_Altea_PNR_AdicionarCartaoFidelidade 1
RES <incluirAPISEnderecoResidencial> TAM_Altea_PNR_AdicionarMultiElementos 1
RES <incluirAPISPassaporte> TAM_Altea_PNR_AdicionarMultiElementos 1
RES <incluirAPISVisto> TAM_Altea_PNR_AdicionarMultiElementos 1
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transição
RES <incluirGeneralRemarks> TAM_Altea_PNR_AdicionarMultiElementos 1
RES <incluirHistoricalRemarks> TAM_Altea_PNR_AdicionarMultiElementos 1
RES <incluirRemarksLocalizadorGDS> TAM_Altea_PNR_AdicionarMultiElementos 1
RES <incluirSegmentoDiretamente> TAM_Altea_Aereo_VenderDaRecomendacao 1
RES <incluirSegmentoDisponibilidade> TAM_Altea_Aereo_VenderDaDisponibilidade 1
RES <incluirSegmentoSurface> TAM_Altea_PNR_AdicionarMultiElementos 1
RES <reservarAssento> TAM_Altea_PNR_AdicionarMultiElementos 1
RES <incluirTelefone> TAM_Altea_PNR_AdicionarMultiElementos 1
RES <incluirTimeLimit> TAM_Altea_PNR_AdicionarMultiElementos 1
RES <incluirNome> TAM_Altea_PNR_AdicionarMultiElementos 1
RES <incluirGrupo> TAM_Altea_PNR_AdicionarMultiElementos 1
RES <incluirOSI> TAM_Altea_PNR_AdicionarMultiElementos 1
RES <incluirSSR> TAM_Altea_PNR_AdicionarMultiElementos 1
RES <incluirBilhete> TAM_Altea_PNR_AdicionarMultiElementos 1
RES <cancelarOsiSsr> TAM_Altea_PNR_Cancelar 1
RES <cancelarReservaAssento> TAM_Altea_PNR_Cancelar 1
RES <cancelarReserva> TAM_Altea_PNR_Cancelar 1
RES <excluirNome> TAM_Altea_PNR_Cancelar 1
RES <excluirSegmento> TAM_Altea_PNR_Cancelar 1
RES <excluirTelefone> TAM_Altea_PNR_Cancelar 1
RES <gravarTransacao> TAM_Altea_PNR_AdicionarMultiElementos 1
RES <efetuarReservaRapida> 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
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transição
RES <consultarMapaAssentos> TAM_Altea_ObterMapaAssentos 1
EWS <autenticaUsuario> TAM_Altea_Seguranca_Autenticar 1
EWS <alteraSenha> Não mais disponibilizado N/A
EWS <consultaPNR> TAM_Altea_PNR_Recuperar
1
EWS <recalculo> TAM_Altea_Tarifa_TarifarPNRClasseReservada OU
TAM_Altea_Tarifa_TarifarPNRMenorPrecoDisponivel OU
TAM_Altea_Tarifa_TarifarPNRMenorPrecoPossivel
1
EWS Combinação de <consultaOpen> e <tarifarOpen>
TAM_Altea_Commando_Criptico (TY) +
TAM_Altea_PNR_AdicionarMultiElementos +
TAM_Altea_Tarifa_TarifarPNRClasseReservada (opção RLI para obter lista de tarifas) +
TAM_Altea_Tarifa_VerificarRegras +
TAM_Altea_Bilhete_CriarTSTAposTarifacao +
TAM_Altea_Commando_Criptico (TTP/IG)
1
EWS <efetuaPagamentoVista> TAM_Altea_PNR_AdicionarMultiElementos 1
EWS <efetuaPagamentoOrgaoGoverno> TAM_Altea_PNR_AdicionarMultiElementos 1
EWS <calculaJuros> Sistema de Gateway de Pagamento N/A
EWS <identificaCartaoCorporate> Sistema de Gateway de Pagamento N/A
EWS <efetuaTransacaoTEF> Sistema de Gateway de Pagamento N/A
EWS <efetuaCancelamentoTransacaoTEF> Sistema de Gateway de Pagamento N/A
EWS <consultaCupomSubstituido> TAM_Altea_Bilhete_ProcessarETicket 1
EWS <efetuaPagamentoSubstituicao> 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: <enviaSolicitacoesReembolso>
<consultaSolicitacaoStatus>
<consultaSolicitacoesReembolsoAbertas>
<consultaMotivoReembolso>
TAM_Altea_Reembolso_Iniciar
TAM_Altea_Reembolso_Processar
TAM_Altea_Reembolso_Atualizar
TAM_Altea_Reembolso_Ignorar
2
EWS <consultaDocumentoReembolsavel> TAM_Altea_Bilhete_ProcessarETicket 1
EWS <consultaHistorico> TAM_Altea_PNR_ExibirHistorico 1
EWS <cancelaDocumento> TAM_Altea_Bilhete_ProcessarETicket
(com opção Void)
1
EWS <obtemListaDocumentosIdentificacao> Não mais disponibilizado N/A
EWS <obtemListaPaises> Não mais disponibilizado N/A
EWS <listaBilhetesPNR> TAM_Altea_PNR_Recuperar 1
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transição
EWS <consultaFidelidade> TAM_Altea_Perfil_Obter 1
EWS <consultaPoliticaComercial> Não mais disponibilizado N/A
EWS <consultaAeroporto> TAM_Altea_Commando_Criptico (DAC) 1
EWS <consultaReservaSessao> TAM_Altea_PNR_Recuperar 1
EWS <consultaDecendios> Não mais disponibilizado N/A
EWS <consultaSaldoTEF> Sistema de Gateway de Pagamento N/A
EWS <efetuaTransacaoSaldosTEF> Sistema de Gateway de Pagamento N/A
EWS Logout TAM_Altea_Seguranca_Sair 1
EWS <consultaIdiomas> Não mais disponibilizado N/A
EWS Reenvio de Email Comando críptico ITR-EML 1
EWS <obterInformacoesSistema Não mais disponibilizado N/A
EWS <consultaSaldoTefCancelamento> Sistema de Gateway de Pagamento N/A
EWS <consultaRegrasFinanciamento> Sistema de Gateway de Pagamento N/A
EWS <removeReserva> TAM_Altea_AdicionarMultiplosElementos (opção 20) 1
EWS <atualizarDadosPassageiroReserva> TAM_Altea_AdicionarMultiplosElementos 1
EWS <validarControleOperacional> Mensagens de reemissão 2
EWS Consulta Situação de Reserva Mensagens de reemissão 2
EWS Remove Situação de Reserva da Sessão
Mensagens de reemissão 2
EWS Emissão MCO Remarcação Mensagens relacionadas à TSM (TAM_Altea_CriarTSM / ApagarTSM / ExibirTSM /
AtualizarTSM / ListarTSM) + TAM_Altea_Emissao_EmitirMD)
2
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transição
2.3 Melhores Práticas 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.
2.3.1 Gerenciamento de Sessões
Podemos estabelecer como boas práticas para o gerenciamento de sessões:
• Evitar chamadas de autenticação desnecessárias, com o uso de “session pooling”: agrupar transações stateless (por exemplo, uma busca de disponibilidade tarifada) em um pool de sessões reutilizáveis.
• Usar sessões dedicadas na criação ou atualização de dados: sempre isolar um processo de criação / atualização de dados dentro de uma sessão dedicada, encerrando a sessão ao final do processo.
2.3.1.1 Session Pooling
Esta sessão contém uma breve descrição de sugestão de como gerenciar um pool de sessões stateless. Dois elementos devem ser considerados: base de dados e processos. 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. 2.1) Processo de manutençã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).
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transição
Seleciona a primeira
sessão
Fecha a sessão
Sim
Data da última busca mais
antiga que o ITO*?
Seleciona a próxima
sessão
Não
*ITO: tempo de Time Out por
inatividade
2.2) Processo de busca 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. A atualização da base de dados deve atualizar todos os campos da sessão.
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transição
2.3) Processo de nova sessão 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.
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transição
Sucesso ?
Envia chamada de
autenticação
Sim
Não
Salvar dados de session ID e
last query date
Contador + 1
Contador =5 ?
Erro
Sim
Não
Contador = 1
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transição
2.3.2 Busca de disponibilidade tarifada
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transição
2.3.3 Busca de disponibilidade neutra
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transição
2.3.4 Criação de PNR
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transição
2.3.5 Emissão
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transição
2.3.6 Retarifar PNR para menor tarifa aplicável
Chamada “Best Pricer”TAM_Altea_Tarifa_TarifarPNRMenor
PrecoDisponivel
Revender segmentosTAM_Altea_Aereo_RemarcarSegAereo
Precificar PNRTAM_Altea_Tarifa_TarifarPNRClasse
Reservada
Criar TSTTAM_Altea_Bilhete_CriarTSTApos
Tarifacao
Mostrar
confirmação
ao Usuário
Usuário reserva vôo e
classe
Iniciar Sessão 1
Encerrar sessão 1
Usuário insere informações
TAM_Altea_PNR_
AdicionarMultiElementos
Para a criação do PNR com todas as
informações
option code 10
Iniciar Sessão 2
Encerrar Sessão 2
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transição
2.3.7 Checklist para Certificaçã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
INCIDENTE CARACTERÍSTICA IMPACTO NA
CERTIFICAÇÃO
ERRO Comportamento incorreto da aplicação
Processo suspenso até correção ou não certificação da aplicação
AVISO
Comportamento que traz consequências negativas à aplicação e cuja correção é extremamente recomendada
Não impede a certificação positiva
COMENTÁRIO Pode ser positivo ou negativo sob a análise do certificador
Nenhum
Critérios que deverão ser verificados para garantir a certificação positiva:
GERAL TIPO
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 requisição enviada
Erro
O formato dos dados e valores deverá ser verificado antes do envio para o servidor da TAM. Em particular, o tratamento de datas deverá ser efetuado corretamente: a aplicação deve detectar datas inválidas ou fora de ordem e retornar um erro para o usuário sem enviar uma requisição desnecessária para o servidor TAM.
Erro
Evitar transações desnecessárias ou redundantes e minimizar o número de transações por booking.
Aviso ou Erro
Uso de mensagens estruturadas, sempre que possível, evitando o uso de requisições em modo críptico.
Aviso
GERENCIAMENTO DE SESSÕES Todas as sessões devem ser encerradas após seu uso, evitando alcançar o limite de conexões simultâneas disponíveis. Um mecanismo para manter as sessões ativas poderá ser
Erro
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transição
certificado e em alguns casos é, inclusive, recomendado, porém a aplicabilidade deverá ser discutida entre ambas as partes (desenvolvedores / analistas Amadeus)
Mecanismos de timers (inatividade/resposta) devem ser corretamente gerenciados pela aplicação do cliente
Erro
O número de sequência da requisição deve ser incrementado na aplicação do cliente
Erro
Para aplicações on-line públicas, as sessões devem ser liberadas enquanto é esperada a ação do usuário final
Aviso
Um pool de sessões deve ser usado Aviso
PNR Para efetuar a criação de um PNR, os seguintes elementos são mandatórios:
- um nome (NM); - um contato (AP, APE, AM,…); - um segmento aéreo; - um elemento TK; - origem (RF).
Ao recuperar e alterar um PNR (RT), o elemento RF deverá ser enviado antes da conclusão da transação.
Erro
Evite o tratamento incorreto de múltiplos passageiros, bebês de colo e outros tipos de passageiros. Os passageiros devem ser corretamente definidos no PNR, especialmente bebês de colo (que deverão estar associados a adultos). A idade do bebê de colo (infant) deverá ser informada após o nome do bebê para correta criação do elemento SR INFT.
Erro
Previna a criação de reservas duplicadas. Em aplicações web- based, não poderá ser permitido retornar da página de confirmação de reserva para a página inicial e reservar o mesmo itinerário novamente.
Erro
O PNR deverá ser criado no Servidor TAM somente quando o usuário confirmar a reserva (as consultas deverão ser feitas sem a criação de PNR)
Erro
Atualmente, somente os seguintes campos do PNR poderão conter informação de cartão de crédito: - Números de cartões de crédito: FOID, sub elementos de documentos miscelânea como MCO, XSB (excesso de bagagem) e SVC (documentos para cobrança de taxa); - Números de cartão de Crédito e código de segurança (CVV2/ CVC2/ CID): FP e SSR EPAY. Todos os outros campos do PNR (como RM, RC,…) não devem conter nenhuma informação de cartão de crédito.
Erro
Para aplicações on-line públicas, se um PNR for criado sem elemento de forma de pagamento (FP), assegure-se que um elemento TKXL esteja presente (evite a criação de elemento TKOK sem forma de pagamento FP, pois os assentos poderão ser cancelados através de processos automáticos das companhias aéreas). Aceitável se a FOP for inserida por outro processo automático ou manual.
Erro
AÉREO
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transição
Assegure-se de que o número correto de assentos foi reservado. Não deverão ser bloqueados assentos para bebês definidos como INF (bebês que ocuparão assento deverão ser definidos como INS).
Erro
Segmentos aéreos não deverão ser vendidos para consulta de disponibilidade ou tarifa. A consulta deverá ser feita com o serviço TAM_Altea_Aereo_MultiDisponibilidade ou TAM_Altea_Tarifa_Upsell, e a mensagem TAM_Altea_Tarifa_TarifacaoInformativaSemPNR deve ser usada para tarifamento de itinerários.
Erro
Ao usar o TAM_Altea_Aereo_AdicionarMultiElementos com código de opção 11 (Encerrar a transação e abrir PNR), incluir também a opção 267 (parar no 1º erro encontrado na venda). Isso assegura que os erros na venda de segmentos aéreos serão detectados, evitando uma inesperada finalização da transação.
Aviso
O serviço TAM_Altea_Aéreo_VenderdaDisponibilidade deverá ser usado para acesso a vendas diretas após o acesso direto de Multi disponibilidade.
Aviso
Inclusão da opção 30 se desejar o recebimento de mensagens ao finalizar transação
Comentário
TARIFAS Uso da mensagem TAM_Altea_Tarifa_TarifacaoInformativaSemPNR para tarifamento informativo (tarifas ou taxas), para evitar impactos no inventário das cias. aéreas e sobrecarga em servidores.
Erro
Uma opção de tarifação deve ser especificada nas mensagens de tarifação de PNR. Nunca deve ser utilizada o atributo “NOP”.
Erro
O uso de tarifação informativa (par de cidades ou itinerário) deve ser minimizado ou evitado, consome recursos e a resposta não é 100% garantida (devido ao fato de ser informativa e não a efetiva)
Aviso
No uso da busca tarifada, não há necessidade de nova solicitação de disponibilidade ou cotação logo após.
Aviso
Tarifação por Base Tarifária com validação automática das regras (equivalente ao FXX/A) deverá ser usado ao tentar precificar uma tarifa específica (após a busca tarifada, por exemplo)
Aviso
BUSCA TARIFADA A aplicação deverá tratar de forma correta os casos de viagens em datas próximas da data corrente.
Erro
A aplicação deverá incorporar as melhores práticas para venda das recomendações retornadas de buscas tarifadas. O serviço TAM_Altea_Aereo_VenderDaRecomendacao deverá ser usado para esse propósito
Erro
A aplicação deverá tratar corretamente os tipos de passageiros na busca tarifada
Erro
Recomendações (tarifas e vôos) retornadas pela busca tarifada deverão ser corretamente apresentadas pela aplicação
Erro
FILAS Serviços de filas deverão ser usados sempre que possível. Comentário
Se uma aplicação gerencia várias filas, o serviço TAM_Altea_Comando_Criptico (QT) deverá ser utilizado para obter um status global de filas ativas, pata que o processamento seja feito apenas nas filas que contenham PNRs.
Erro
TAM_Altea_Filas_Listar pode retornar, no máximo, 250 PNRs. Se uma fila contém mais que 250 PNRs, usar parâmetros para delimitar esse intervalo.
Erro
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização
TAM Web Services – Manual de Apoio à Transição
3 Documentação A documentação TAM Web Services inclui os seguintes componentes:
• Manual de Apoio à Migração (este documento): o Contendo orientações para que os usuários dos atuais sistemas de Web Services
TAM (RES e EWS) possam migrar suas aplicações para utilização do novo TAM Web Services;
• 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.