TAM WEB SERVICES

Manual de Apoio à Migração

Versão 1.0
 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
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização

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
 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
©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

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 é
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização

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
 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.
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização

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
 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
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização

pela aplicação cliente entre as sucessivas chamadas, conforme demonstrado a seguir:

 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 Office ID
sgIATACidade
Duty Code Constante = “SU”
Organization ID
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização

Constante = “B2T-JJ2”
 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
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização

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.
 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
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização

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.
 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
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização

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.

 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.

©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização

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

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.
 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 + 1
TAM_Altea_PNR_AdicionarCartaoFidelidade
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 1
OU
TAM_Altea_Tarifa_TarifarPNRMenorPrecoDisponivel
OU
TAM_Altea_Tarifa_TarifarPNRMenorPrecoPossivel
+
TAM_Altea_Bilhete_CriarTSTAposTarifacao
(opcional)
RES <obterMapaAssentos> TAM_Altea_Aereo_ObterMapaAssentos 1
RES <consultarTarifas> TAM_Altea_Tarifa_TarifasParCidades 1
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização

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
 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>
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização

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

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 1

OU
TAM_Altea_Tarifa_TarifarPNRMenorPrecoDisponivel
OU
TAM_Altea_Tarifa_TarifarPNRMenorPrecoPossivel
EWS Combinação de <consultaOpen> e TAM_Altea_Commando_Criptico (TY) + 1
<tarifarOpen>
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)
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>
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorizaçã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

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 Mensagens de reemissão 2
Sessão
EWS Emissão MCO Remarcação Mensagens relacionadas à TSM 2
(TAM_Altea_CriarTSM / ApagarTSM / ExibirTSM /
AtualizarTSM / ListarTSM) +
TAM_Altea_Emissao_EmitirMD)
©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.
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização

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).
 TAM Web Services – Manual de Apoio à Transição

Seleciona a primeira
sessão

Seleciona a próxima
sessão

Data da última busca mais

Não
antiga que o ITO*?

Sim

Fecha a sessão

*ITO: tempo de Time Out por

inatividade

2.2) Processo de busca

©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorizaçã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.

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.
 TAM Web Services – Manual de Apoio à Transição

Contador = 1

Contador + 1

Envia chamada de
autenticação
Não

Sucesso ? Não Contador =5 ?

Sim Sim

Salvar dados de session ID e Erro

last query date
©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
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização

2.3.4 Criação de PNR

TAM Web Services – Manual de Apoio à Transição
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização

2.3.5 Emissão
TAM Web Services – Manual de Apoio à Transição
 TAM Web Services – Manual de Apoio à Transição

2.3.6 Retarifar PNR para menor tarifa aplicável

Usuário reserva vôo e

classe

Chamada “Best Pricer”

TAM_Altea_Tarifa_TarifarPNRMenor Iniciar Sessão 1
PrecoDisponivel

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

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

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

Pode ser positivo ou negativo sob

COMENTÁRIO a análise do certificador Nenhum
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização

Critérios que deverão ser verificados para garantir a certificação positiva:

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.

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.
Evitar transações desnecessárias ou redundantes e minimizar o Aviso ou Erro
número de transações por booking.
Uso de mensagens estruturadas, sempre que possível, evitando o Aviso
uso de requisições em modo críptico.
GERENCIAMENTO DE SESSÕES
Todas as sessões devem ser encerradas após seu uso, evitando Erro
alcançar o limite de conexões simultâneas disponíveis.

Um mecanismo para manter as sessões ativas poderá ser

 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 Erro
corretamente gerenciados pela aplicação do cliente
O número de sequência da requisição deve ser incrementado na Erro
aplicação do cliente
Para aplicações on-line públicas, as sessões devem ser liberadas Aviso
enquanto é esperada a ação do usuário final
Um pool de sessões deve ser usado Aviso
PNR
Para efetuar a criação de um PNR, os seguintes elementos são Erro
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.
Evite o tratamento incorreto de múltiplos passageiros, bebês de colo Erro
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.
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização

Previna a criação de reservas duplicadas. Em aplicações web- Erro

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.
O PNR deverá ser criado no Servidor TAM somente quando o Erro
usuário confirmar a reserva (as consultas deverão ser feitas sem a
criação de PNR)
Atualmente, somente os seguintes campos do PNR poderão conter
informação de cartão de crédito: Erro
- 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.
Para aplicações on-line públicas, se um PNR for criado sem Erro
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.
AÉREO
 TAM Web Services – Manual de Apoio à Transição

Assegure-se de que o número correto de assentos foi reservado. Erro

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).
Segmentos aéreos não deverão ser vendidos para consulta de Erro
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.
Ao usar o TAM_Altea_Aereo_AdicionarMultiElementos com código Aviso
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.
O serviço TAM_Altea_Aéreo_VenderdaDisponibilidade deverá ser Aviso
usado para acesso a vendas diretas após o acesso direto de Multi
disponibilidade.
Inclusão da opção 30 se desejar o recebimento de mensagens ao Comentário
finalizar transação
TARIFAS
Uso da mensagem TAM_Altea_Tarifa_TarifacaoInformativaSemPNR Erro
para tarifamento informativo (tarifas ou taxas), para evitar impactos
no inventário das cias. aéreas e sobrecarga em servidores.
Uma opção de tarifação deve ser especificada nas mensagens de Erro
tarifação de PNR. Nunca deve ser utilizada o atributo “NOP”.
O uso de tarifação informativa (par de cidades ou itinerário) deve ser Aviso
minimizado ou evitado, consome recursos e a resposta não é 100%
garantida (devido ao fato de ser informativa e não a efetiva)
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização

No uso da busca tarifada, não há necessidade de nova solicitação Aviso

de disponibilidade ou cotação logo após.
Tarifação por Base Tarifária com validação automática das regras Aviso
(equivalente ao FXX/A) deverá ser usado ao tentar precificar uma
tarifa específica (após a busca tarifada, por exemplo)
BUSCA TARIFADA
A aplicação deverá tratar de forma correta os casos de viagens em Erro
datas próximas da data corrente.
A aplicação deverá incorporar as melhores práticas para venda das Erro
recomendações retornadas de buscas tarifadas. O serviço
TAM_Altea_Aereo_VenderDaRecomendacao deverá ser usado para
esse propósito
A aplicação deverá tratar corretamente os tipos de passageiros na Erro
busca tarifada
Recomendações (tarifas e vôos) retornadas pela busca tarifada Erro
deverão ser corretamente apresentadas pela aplicação
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 Erro
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.
TAM_Altea_Filas_Listar pode retornar, no máximo, 250 PNRs. Se Erro
uma fila contém mais que 250 PNRs, usar parâmetros para delimitar
esse intervalo.
 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.
©2009 TAM Linhas Aéreas S.A. Proibida reprodução total ou parcial sem autorização