API Pública Descarga de Billetes

Protocolo público para descarga de billetes, dirigido a agencias de viajes clientes de un grupo de agencias de viajes

V 1.0 Junio 2023

Introducción y contacto

Esta documentación describe el conjunto de métodos del servicio web desarrollado por Ofimática Jaén SL con el objetivo de descargar billetes desde un grupo de agencias de viajes a sus agencias de viajes clientes del grupo.

Para cualquier duda y aspecto a comentar durante su uso, puede contactar con nosotros de Lunes a Viernes, desde las 09:00 hasta las 14:00 y de 16:00 a 19:00 en el siguiente número de teléfono 953 280 144.

Webservice

Métodos utilizados en el flujo de descarga

Las operaciones disponibles son los siguientes:

Servicio	Descripción
GetPnrs	Este método permite a la agencia de viajes cliente del grupo la consulta de localizadores de billetes pendientes de descarga.
FileFromPnr	Este método permite a la agencia cliente del grupo la descarga de información de un localizador de billetes.
ConfirmPnr	Este método permite a la agencia cliente del grupo marcar como descargado un localizador de billetes.

Entorno	Url o "Endpoint"
LIVE	http://DOMINIO-DEL-CLIENTE/ApiDescargaBilletes.svc?wsdl

GetPnrs

En este apartado se describe la petición y la respuesta de la consulta de localizadores de billetes pendientes de descarga.

Request

Campo	Cardinalidad	Descripción
GetPnrsRequest	1	Elemento root de la petición de consulta de localizadores de billetes pendientes de descarga
1. User	1	Nombre usuario
2. Password	1	Contraseña

Response

Campo	Cardinalidad	Descripción
GetPnrsResponse	1	Elemento root de la respuesta
1. Success	1	True si OK, False si hay algún error
2. Message	1	Mensaje de información del error o no existencia de localizadores de billetes pendientes de descarga
3. Locators	0..1	Lista de localizadores de billetes pendientes de descarga

FileFromPnr

En este apartado se describe la petición y la respuesta de la petición para la descarga de la información de un localizador de billetes.

Request

Campo	Cardinalidad	Descripción
FileFromPnrRequest	1	Elemento root de la petición
1. Username	1	Nombre de usuario
2. Password	1	Contraseña
3. Locator	1	Localizador de billetes

Response

Campo	Cardinalidad	Descripción
FileFromPnrResponse	1	Elemento root de la respuesta
1. Success	1	True si OK, False si hay algún error
2. Message	1	Mensaje de información de la respuesta
3. FilesFromPnr	0..1	Lista de información de billetes de un localizador de billetes
3.1 CodCompañia	1	Identificador de la aerolínea
3.2 Billete	1	Número de billete
3.3 DigitoControl	1	Digito de control del billete
3.4 FechaEmision	1	Fecha de emisión del billete
3.5 NumPax	1	Número de pasajeros del billete
3.6 NombrePax	1	Nombre del pasajero del billete
3.7 Trayecto	1	Códigos de aeropuertos que forman el trayecto del billete
3.8 VentaComis	1	Importe de venta comisionable del billete
3.9 CosteComis	1	Importe de coste comisionable del billete
3.10 VentaTasas1	1	Importe de venta de tasas del billete
3.11 CosteTasas1	1	Importe de coste de tasas del billete
3.12 VentaTasas2	1	Importe de venta de tasas del billete
3.13 CosteTasas2	1	Importe de coste de tasas del billete
3.14 ImporteCredito	1	Importe de credito del billete
3.15 DatoEspecial1	1	DatoEspecial1
3.16 DatoEspecial2	1	DatoEspecial2
3.17 Conexionado	1	Conexionado
3.18 CargoXServicio	1	CargoXServicio
3.19 GastosGestion	1	Gastos de gestión aplicados al billete
3.20 GastosAnVenta	1	GastosAnVenta
3.21 GastosAnCoste	1	GastosAnCoste
3.22 FechaLiquidacion	1	Fecha de liquidación del billete
3.23 VentaTasas3	1	Importe de venta de tasas del billete
3.24 CosteTasas3	1	Importe de coste de tasas del billete
3.25 VentaTasas4	1	Importe de venta de tasas del billete
3.26 CosteTasas4	1	Importe de coste de tasas del billete
3.27 Divisa	1	Divisa del billete
3.28 VentaTasas5	1	Importe de venta de tasas del billete
3.29 CosteTasas5	1	Importe de coste de tasas del billete
3.30 ComisionPrev	1	ComisionPrev
3.31 CardCode	1	CardCode
3.32 Co2	1	CO2 emitido en el billete
3.33 TasasPorUsoTpv	1	TasasPorUsoTpv
3.34 TipoBillete	1	Tipo del billete
3.35 PagadoConTarjetaAgencia	1	Indica si el billete ha sido pagado con la tarjeta de la agencia
3.36 ImporteCreditoProv	1	Importe crédito proveedor
3.37 InfoTrayectos	0..1	Lista de información de trayectos
3.37.1 IdTrayecto	1	Id del trayecto
3.37.2 NumVuelo	1	Número de vuelo
3.37.3 FechaSalida	1	Fecha de salida del vuelo
3.37.4 HoraSalida	1	Hora de salida del vuelo
3.37.5 FechaLlegada	1	Fecha de llegada del vuelo
3.37.6 HoraLlegada	1	Hora de llegada del vuelo
3.37.7 Trayecto	1	Trayecto del vuelo
3.37.8 FareBasis	1	FareBasis del trayecto
3.37.9 TicketDesignator	1	TicketDesignator del trayecto
3.37.10 ClaseVuelo	1	Clase del vuelo
3.37.11 ImporteTrayecto	1	Importe del trayecto
3.37.12 EstadoConfirmacion	1	Estado Confirmacion del trayecto
3.37.13 Co2	1	Co2 del trayecto
3.38 InfoTasas	0..1	Lista de información de tasas
3.38.1 Tasa	1	Descripción de la tasa
3.38.2 ImporteTasa	1	Importe de la tasa

ConfirmPnr

En este apartado se describe la petición y la respuesta del método para marcar un localizador de billetes como descargado.

Request

Campo	Cardinalidad	Descripción
ConfirmPnrRequest	1	Elemento root de la petición
1. Username	1	Nombre de usuario
2. Password	1	Contraseña
3. Locator	1	Localizador de billetes

Response

Campo	Cardinalidad	Descripción
ConfirmPnrResponse	1	Elemento root de la respuesta
1. Success	1	True si OK, False si hay algún error
2. Message	1	Mensaje de información de la respuesta
3. ConfirmPnr	1	Confirmación del pnr

Ejemplo de implementación de la llamada al método FileFromPnr con código .Net C#

using System;
using System.Collections.Generic;
using System.Linq;
using System.ServiceModel;
using System.Text;
using System.Threading.Tasks;
using EjemploApiDescargaBilletes.Api;

namespace EjemploApiDescargaBilletes
{
    public class Prueba
    {
        public void PruebaPnr()
        {
            var url = "http://ejemplo.apidescargabilletes.es/ApiDescargaBilletes.svc";
            var connectionTimeout = new TimeSpan(0, 0, 30); 
            var client = new EjemploApiDescargaBilletes.Api.ApiDescargaBilletesClient(new BasicHttpBinding
            {
                MaxReceivedMessageSize = int.MaxValue,
                ReceiveTimeout = connectionTimeout,
                SendTimeout = connectionTimeout,
                OpenTimeout = connectionTimeout,
                CloseTimeout = connectionTimeout
            }, new EndpointAddress(url));

//Este objeto ApiDescargaBilletesClient es una clase autogenerada para .Net c# por VisualStudio con la opción de generar referencia de servicio para la url del WSDL del webservice

var fileFromPnrRequest = new FileFromPnrRequest
            {
                Locator = "pnr locator"
                User = "usuario",
                Password = "pasword"
            };
            var fileFromPnrResponse = client.FileFromPnr(fileFromPnrRequest);

if (fileFromPnrResponse.Success)
            {
                //La petición ha sido correcta, en fileFromPnrResponse.FilesFromPnr se obtiene la información de los billetes
            }
            else
            {
                //Ha ocurrido algún error en la petición, en fileFromPnrResponse.Message se obtiene el mensaje de error
            }
        } 
    }
}