Companhias Aéreas estamos todos ligados

Transcrição

1 Manual do Desenvolvedor Companhias Aéreas estamos todos ligados

2 01 egistros de transações das companhias aéreas Elementos da Solicitação AirlinesDetails Passenger FlightLeg Exemplos XML de Solicitações 9 Códigos de resposta das transações de companhias aéreas 11 Clique nos hiperlinks para navegar no material do Manual do Desenvolvedor Companhias Aéreas.

3 3 01 egistros de transações das companhias aéreas A captura de transações para as companhias aéreas também é feita pelo e-ede e é utilizada por meio do envio de informações adicionais em uma transação normal de cartão de crédito e débito. O serviço de cartão de crédito e débito está descrito na seção 2 do Guia de eferência dos Desenvolvedores do e-ede. O e-ede também aceitará dados de companhias aéreas em uma transação de dois passos. A localização dos dados na Solicitação XML permanece a mesma. No momento, a inclusão de dados adicionais durante a transação de atendimento somente se aplica aos dados de companhias aéreas. 1.1 Elementos da solicitação Nesta seção, serão apresentados os campos associados às transações de companhias aéreas, bem como exemplos XML desses campos. Para enviar informações de itinerário de voo, utilize o elemento AirlinesDetails: equest º Authentication Consulte a seção do Guia de eferência dos Desenvolvedores do e-ede º Transaction TxnDetails AirlinesDetails Informações relacionadas a todo o pedido, seção º Passenger Detalhes sobre os passageiros individuais, seção º FlightLeg Fornece detalhes sobre cada fase da viagem, seção 1.1.3

4 4 Além disso, as informações sobre itinerário de voo também podem ser fornecidas no elemento ISOAirline: equest º Authentication - Consulte a seção do Guia de eferência dos Desenvolvedores do e-ede º Transaction TxnDetails ISOAirline Informações relacionadas a todo o pedido, seção º ISOAirlinePassenger Detalhes sobre os passageiros individuais, seção º ISOAirlineLeg Fornece detalhes sobre cada fase da viagem, seção Nas tabelas a seguir, cada campo será identificado com a legenda a seguir: 1. O Opcional 2. Obrigatório: o campo deve ser preenchido AirlinesDetails Os elementos AirlinesDetails contêm informações relacionadas a todo o pedido. Nome do Elemento Posição Secundários Atributos AirlinesDetails equest.transaction.txndetails Sim Não

5 5 Elementos de AirlinesDetails Nome do elemento Descrição Valores / Limitações Obrigatório agencyname O nome da agência de viagem Alfanumérico, até 26 caracteres agencycode O número IATA Numérico, até 8 caracteres airlineplaninvoice A fatura do plano da companhia aérea Alfanumérico, até 6 caracteres O airlineplannumber O número do plano da companhia aérea Alfanumérico, até 2 caracteres O departurepoint O ponto de partida Código de origem de três caracteres Passenger Consulte a seção FlightLeg Consulte a seção Exemplo XML dos elementos de AirlinesDetails <AirlinesDetails> <agencyname>myairlinesagency</agencyname> <agencycode> </agencycode> <departurepoint>mel</departurepoint> <Passenger> </Passenger> <Passenger> </Passenger> <FlightLeg number= 1 > </FlightLeg> </AirlinesDetails> <AirlinesDetails> <agencyname>myairlinesagency</agencyname> <agencycode> </agencycode> <airplaninvoice>1234an</airplaninvoice> <airplannumber>12</airplannumber> <departurepoint>syd</departurepoint> <Passenger> </Passenger> <FlightLeg number= 1 > </FlightLeg> </AirlinesDetails>

6 Passenger Deve haver, no mínimo, um passageiro por transação. Quando houver mais de uma pessoa viajando, o fornecimento de vários elementos Passenger permite que toda a transação seja autorizada e, ao mesmo tempo, mantém as informações das faturas individuais de cada passageiro. A soma dos valores das passagens de cada passageiro deve corresponder ao campo amount (valor), que faz parte das informações normais de cartão de crédito e débito. Esse elemento pode ser repetido quantas vezes for necessário. Nome do elemento Posição Secundários Atributos Passenger equest.transaction.txndetails.airlinesdetails Sim Não Elementos de Passenger Nome do elemento Descrição Valores/Limitações Obrigatório? passengername O nome do passageiro Alfanumérico, até 25 caracteres passengerref Uma referência única do passageiro Alfanumérico, até 17 caracteres ticketnumber Número da passagem do passageiro. De modo opcional, isso pode ser diferente para cada passageiro Alfanumérico, até 14 caracteres. Geralmente, isso consiste em um prefixo de 3 caracteres, 10 caracteres do número da passagem e um único dígito de verificação no final. De modo opcional, os caracteres do prefixo e o dígito de verificação podem ser substituídos por 0 ticketprice O valor da passagem do passageiro individual

7 7 Elemento XML do elemento Passenger <Passenger> <passengername>joe Citizen</passengername> <passengerref> </passengerref> <ticketnumber> </ticketnumber> <ticketprice>199.99</ticketprice> </Passenger> FlightLeg Cada transação deve conter uma fase de voo especificada no elemento FlightLeg. Nome do elemento Posição Secundários Atributos FlightLeg equest.transaction.txndetailsairlinesdetails Sim Sim Atributos de FlightLeg Nome do atributo Descrição Valores / Limitações Obrigatório number A fase da viagem 1

8 8 Elementos de FlightLeg Nome do elemento Descrição Valores / Limitações Obrigatório carriercode Código da companhia aérea Código da companhia de dois caracteres class Classe de serviço Único caractere alfanumérico departtax Valor total de taxas de embarque Numérico, até 12 dígitos incluindo o ponto decimal departuredate Data de partida AAAAMMDD O destination O destino final Código de destino de três caracteres farebasiscode O código básico da tarifa Alfanumérico, até 6 caracteres O flight_number Número do voo Alfanumérico, até 4 caracteres O stopovercode O código de conexão Alfanumérico, até 1 caractere O Obs: o valor de taxa de embarque não pode ser superior a 40% do valor total da transação. Exemplo XML dos elementos de FlightLeg <FlightLeg number= 1 > <carriercode>qf</carriercode> <class>1</class> <departuredate> </departuredate> <destination>lha</destination> <flight_number>1234</flight_number> </FlightLeg> <FlightLeg number= 1 > <carriercode>qf</carriercode> <class>1</class> <departtax>12.99</departtax> <departuredate> </departuredate> <destination>lha</destination> <farebasiscode>1223ab</farebasiscode> <flight_number>1234</flight_number> </FlightLeg>

9 9 1.2 Exemplos XML de Solicitações Exemplo de Transação XML de compra de passagem para voos de vários passageiros <equest version= 2 > <Authentication> <password>******</password> </Authentication> <Transaction> <CardTxn> <method>auth</method> <Card> <pan>5700********0001</pan> <expirydate>14/05</expirydate> </Card> </CardTxn> <TxnDetails> <merchantreference> </merchantreference> <amount>150.00</amount> <AirlinesDetails> <agencyname>myairlinesagency</agencyname> <agencycode> </agencycode> <departurepoint>mel</departurepoint> <Passenger> <passengername>joe Citizen</passengername> <passengerref> </passengerref> <ticketnumber>abc </ticketnumber> <ticketprice>100.00</ticketprice> </Passenger> <Passenger> <passengername>jane Citizen</passengername> <passengerref> </passengerref> <ticketnumber>abc </ticketnumber> <ticketprice>50.00</ticketprice> </Passenger> <FlightLeg number= 1 > <carriercode>ba</carriercode> <destination>syd</destination>

10 10 <departuredate> </departuredate> <class>1</class> </FlightLeg> </AirlinesDetails> </TxnDetails> </Transaction> </equest>

11 11 02 Códigos de resposta das transações de companhias aéreas Abaixo a tabela de códigos de resposta específicos para as transações de companhias aéreas Código de retorno geral Missing or corrupted FlightLeg number Support for airlines transaction not enabled Duplicate passenger reference Airlines ticket prices do not reconcile with transaction amount Airlines: data already supplied Airlines: pre/erp txn for this amex airlines fulfill contained no airlines data Airlines: invalid extended data Airlines: invalid capture method Descrição Um número de fase foi copiado ou não foi inserido O estabelecimento comercial não foi configurado para transações de companhias aéreas Uma referência de passageiro já foi utilizada para esse estabelecimento comercial A soma dos valores de passagens do passageiro não corresponde ao valor total da transação Ao utilizar o modelo de transações de dois passos, o passageiro da companhia aérea e as informações do voo somente podem ser fornecidos uma vez, na fase de pré auth Uma transação pre/erp foi processada utilizando um TID não relacionado a companhias aéreas e, portanto, não pode ser atendida com dados de companhias aéreas A transação contém dados relacionados a serviço estendido incompatível com as transações de companhias aéreas O método de captura fornecido não é suportado para as transações de companhias aéreas

12