TAM Webservices - Manual de Apoio à migração

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



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



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



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



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:



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”



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.



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.



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.



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.



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.



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.



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



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



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



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



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).



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.



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.



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



2.3.2 Busca de disponibilidade tarifada



2.3.3 Busca de disponibilidade neutra



2.3.4 Criação de PNR



2.3.5 Emissã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



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



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



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



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.

TAM Webservices - Manual de Apoio à migração

Documents

Transcript of TAM Webservices - Manual de Apoio à migração