File-based entrega de Itinerarios
El informe estándar para la API de Itinerarios en el Portal de Socios incluye las reservas de transaction-level, ya sea sólo para Alojamiento o para múltiples líneas de negocio (LOB). Utilizar nuestros informes estándar significa que puedes obtener tus datos rápidamente, sin tiempo de desarrollo adicional.
Los informes para la API de Itinerarios se realizan a nivel de transacción, y ofrecen una lista curada de más de 60 campos a elegir para el Alojamiento, además de más de 100 campos para los informes de multi-LOB. Las opciones de campo incluyen:
- Información básica de la reserva, como fechas de viaje, itinerarios e importes del viaje
- Información del cliente viajero y comprador (si es diferente)
- Información sobre el producto, como números de confirmación, proveedores y ubicaciones, número de LOB utilizadas y costes
Más información sobre la configuración de la entrega de archivos
Prácticas recomendadas para la ingestión de archivos
Campos por defecto del informe estándar
Hay muchos campos para elegir a la hora de personalizar tus informes. Se incluyen por defecto en los informes estándar.
| Nombre del campo | Tipo de datos | Descripción | Ejemplo |
|---|---|---|---|
book_date | fecha | La fecha en que se hizo inicialmente una reserva, representada en formato de fecha ISO 8601 (YYYY-MM-DD). | 2023-02-05 |
transaction_date | fecha | La fecha en que una reserva fue modificada por última vez. Es lo mismo quebook_datesi la reserva no se actualiza nunca. La fecha se representa en formato de fecha ISO 8601 (YYYY-MM-DD). | 2023-02-05 |
begin_use_date | fecha | La fecha de inicio del viaje: fecha de salida, fecha de check-in, fecha de pick-up, etc. representada en formato de fecha ISO 8601 (YYYY-MM-DD). | 2023-04-05 |
end_use_date | fecha | La fecha en que finaliza el viaje: fecha de llegada, fecha de check-out, fecha de drop-off, etc., representada en formato de fecha ISO 8601 (YYYY-MM-DD). | 2023-04-06 |
transaction_type | varchar(200) | Tipo de transacción registrada. | Valores posibles: compra, adjudicación, modificación, cancelación. |
product_line_name | varchar(200) | El tipo de negocio al que pertenece el elemento de reserva. | Valores posibles: Avión, Coche, Crucero, Servicios en destino, Seguro, Alojamiento, Paquete, desconocido |
package_indicator | varchar(100) | Si el elemento de reserva forma parte de un paquete (como vuelo + hotel). | Valores posibles: parte del paquete, independiente, desconocido |
product_component | varchar(200) | Productos incluidos en un paquete de compra. Si la compra no es un paquete, sólo se mostrará el nombre de una única línea de productos. | Aire, Coche |
itinerary_number | varchar(50) | Número de itinerario o el número de referencia del pedido en el punto de venta. | 12345678910111 |
booking_item_id | varchar(50) | Identificador de un elemento específico reservado como parte de un itinerario. El valor del campo puede ser tanto positivo como negativo. | 1400882912 |
currency_code | char(3) | Moneda en la que se pagó la reserva, representada en el formato estándar de código de moneda del Número Internacional de Cuenta Bancaria (IBAN). | USD |
gbv_local | decimal(18,4) | El valor bruto de la reserva (VBP), o importe total de la reserva, incluidos impuestos y tasas, en la moneda utilizada para pagar. | 694.89 |
order_count | smallint | Número de pedidos (no de artículos) en el paquete de compra. | 1 |
Campos opcionales adicionales
Nota: La tabla siguiente no es el orden en que se mostrarán los campos en el informe. El orden de los campos viene determinado por el orden en que se activan los campos durante la creación/edición.
| Nombre del campo | Tipo de datos | Descripción | Ejemplo |
|---|---|---|---|
transaction_datetime | Marca de tiempo | Fecha/hora en que se actualizó (modificó) por última vez la reserva; es la misma que la fecha de reserva si ésta no se modifica nunca. | 2023-02-05 06:05:00 |
booking_window | entero | Días entre la fecha reservada y la fecha check-in. | 32 |
booking_status | varchar(50) | Abierta, en curso, completada, adjudicada o cancelada. | En curso |
online_offline_indicator | varchar(100) | Indicación de si la reserva se hizo online u offline a través de un agente. | En línea |
point_of_sale_country | char(3) | Punto de venta desde el que el cliente realiza la reserva. | USD |
payment_type | varchar(50) | Forma de pago utilizada (tarjeta de crédito, puntos, pago fraccionado). | Pago fraccionado |
coupon_code | varchar(100) | Código del cupón utilizado. | ABCD |
coupon_name | varchar(200) | Nombre del cupón. | PRIME |
coupon_description | varchar(510) | Descripción del cupón utilizado. | BoGo 5 % |
coupon_price_amount_usd | decimal(18,4) | Importe del cupón en dólares estadounidenses. | -58.6877 |
gbv_usd | decimal(18,4) | Valor bruto de la reserva en dólares estadounidenses. | 694,8941 |
taxes_and_fees_local | decimal(18,4) | Total de impuestos y tasas en moneda local. | 144.77 |
taxes_and_fees_usd | decimal(18,4) | Total de impuestos y tasas en dólares estadounidenses. | 144.77 |
taxes_and_fees_tpid | decimal(18,4) | Total de impuestos y tasas en moneda TPID. | 144.77 |
insurance_gbv_local | decimal(18,4) | Importe del seguro en moneda local. | 80.4 |
insurance_gbv_usd | decimal(18,4) | Importe del seguro en dólares estadounidenses. | 80.4 |
air_supplier_pnr | varchar(100) | Registro de nombres de pasajeros aéreos del proveedor. | ABCDEF |
air_carrier_pnr | varchar(100) | Registro de nombres de pasajeros de compañías aéreas. | BCDEFG |
air_business_model | varchar(200) | Modelo de negocio del componente aéreo de la reserva. | Agencia |
air_trip_type | varchar(200) | Tipo de viaje aéreo. | Solo ida |
air_fare_class | varchar(200) | Clase de tarifa aérea adquirida. | Clase Business |
air_plating_carrier | varchar(200) | Nombre de la compañía aérea. | Air Canada |
airport_origin_code | char(3) | Código del aeropuerto de salida/origen del vuelo. | YYZ |
airport_origin_location | varchar(406) | Lugar de salida/origen del vuelo. | Toronto, Ontario CAN |
airport_destination_code | char(3) | Código del aeropuerto al que llega el vuelo/destino. | FLL |
airport_destination_location | varchar(406) | Lugar al que llega el vuelo/destino. | Fort Lauderdale, Florida EE.UU. |
air_ticket_number | varchar(100) | Número de billete de avión. | 123456789101 |
air_ticket_count | smallint | Número de billetes de avión en la reserva (con archivos detallados que incluyen el ID del elemento de reserva, normalmente 0 ó 1). | 1 |
air_segment_count | smallint | Número de segmentos del viaje aéreo (si se agrega por encima del nivel de ID de elemento de reserva, será una suma de todos los segmentos para todos los pasajeros de la reserva). | 2 |
air_gbv_local | decimal(18,4) | Valor bruto de la parte aérea de la reserva en moneda local. | 694,8941 |
air_gbv_usd | decimal(18,4) | Valor bruto de la parte aérea de la reserva en dólares estadounidenses. | 694,8941 |
air_gbv_tpid | decimal(18,4) | Valor bruto de la parte aérea de la reserva en moneda TPID. | 694,8941 |
air_tpid_currency_code | char(3) | Moneda de reserva TPID representada en el formato estándar de código de moneda del Número Internacional de Cuenta Bancaria (IBAN). | USD |
total_person_count | entero | Número total de personas incluidas en la reserva (sólo la parte de alojamiento). | 3 |
adult_count | smallint | Número de adultos incluidos en la reserva (sólo la parte de alojamiento). | 2 |
child_count | smallint | Número de niños incluidos en la reserva (sólo en la parte de alojamiento). | 1 |
lodging_supplier_confirmation_code | varchar(100) | Código de confirmación facilitado por el alojamiento al hacer la reserva. | 1516171819 |
lodging_business_model | varchar(200) | Modelo de negocio del componente de alojamiento de la reserva. | Merchant |
lodging_chain_independent | varchar(200) | Indicador de si el inmueble es independiente o forma parte de una cadena. | Independiente |
lodging_chain_name | varchar(200) | Nombre de la cadena (marca) del inmueble reservado. | Independiente |
lodging_property_name | varchar(200) | Nombre del inmueble reservado | Hotel Cordelia |
lodging_star_rating | flotante | Clasificación por estrellas del alojamiento reservada. | 3 |
lodging_property_city | varchar(40) | Ciudad donde se encuentral alojamiento reservada. | París |
lodging_property_market_name | varchar(80) | Mercado donde se encuentral alojamiento reservada. | FIL - París, Francia |
lodging_property_state_province | varchar(40) | Estado/provincia donde se encuentral alojamiento reservada. | París |
lodging_property_country | varchar(80) | Código del país donde se encuentral alojamiento reservada. | Francia |
lodging_refundable_rate_indicator | varchar(100) | Indicación de si la tarifa reservada es reembolsable o no reembolsable. | Tarifa de penalización por cancelación reembolsable. |
lodging_rate_plan_name | varchar(200) | Nombre del plan de tarifas reservado. | Paquete |
lodging_rate_type_name | varchar(200) | Nombre del tipo de tarifa reservada. | Paquete |
lodging_room_type_name | varchar(200) | Nombre del tipo de habitación reservada. | Habitación doble confort, baño privado |
lodging_length_of_stay | entero | Duración de la estancia (número de noches) en la propiedad reservada. | 5 |
lodging_room_count | smallint | Número de habitaciones reservadas en la propiedad. | 1 |
lodging_room_night_count | smallint | Número de noches de habitación en la reserva (duración de la estancia * número de habitaciones). | 5 |
lodging_gbv_local | decimal(18,4) | Valor bruto de reserva de la parte de alojamiento de la reserva en moneda local. | 1379.8 |
lodging_gbv_usd | decimal(18,4) | Valor bruto de la parte de alojamiento de la reserva en dólares estadounidenses. | 1029.9317 |
lodging_gbv_tpid | decimal(18,4) | Valor bruto de reserva de la parte de alojamiento de la reserva en moneda TPID. | 1029.9317 |
lodging_average_daily_rate_local | decimal(18,4) | Tarifa media diaria del alojamiento reservada (GBV / duración de la estancia) en moneda local. | 275.96 |
lodging_average_daily_rate_usd | decimal(18,4) | Tarifa media diaria del alojamiento reservada (GBV / duración de la estancia) en dólares estadounidenses. | 205.9863 |
lodging_tpid_currency_code | char(3) | Moneda de reserva del TPID de alojamiento representada en el formato estándar de código de moneda del Número Internacional de Cuenta Bancaria (IBAN). | USD |
car_supplier_confirmation_code | varchar(100) | Código de confirmación proporcionado por la empresa de alquiler de coches en el momento de la reserva. | ABC1234 |
car_business_model | varchar(200) | Modelo de negocio de coche componente de reserva. | n/a |
car_vendor_name | varchar(200) | Nombre de la empresa de alquiler de coches reservada. | Hertz |
car_type | varchar(200) | Tipo de coche reservado. | Compacto de 2/4 puertas |
car_pickup_location_code | char(3) | Código de la localidad (normalmente el código del aeropuerto) donde se debe recoger el coche reservado. | YDF |
car_pickup_location | varchar(200) | Lugar de recogida del coche reservado. | Deer Lake, NL (YDF-Deer Lake Regional) |
car_dropoff_location_code | char(3) | Código del lugar (normalmente el código del aeropuerto) donde se debe dejar el coche reservado. | YDF |
car_dropoff_location | varchar(200) | Lugar donde se dejará el coche reservado. | Deer Lake, NL (YDF-Deer Lake Regional) |
car_trip_type | varchar(200) | Si el coche se reserva de ida o de vuelta. | Ida y vuelta |
car_rental_day_count | smallint | Número de días para los que se reservó el coche. | 7 |
car_count | smallint | Número de coches reservados. | 1 |
car_gbv_local | decimal(18,4) | Valor bruto de reserva de la parte de coche de la reserva en moneda local. | 310.8 |
car_gbv_usd | decimal(18,4) | Valor bruto de la parte de la reserva correspondiente al coche en dólares estadounidenses. | 231.9919 |
car_gbv_tpid | decimal(18,4) | Valor bruto de reserva de la parte de coche de la reserva en moneda TPID. | 1029.9317 |
car_tpid_currency_code | char(3) | Moneda de reserva del TPID del coche representada en el formato estándar de código de moneda del Número Internacional de Cuenta Bancaria (IBAN). | USD |
activity_offering_name | varchar(200) | Nombre de la actividad de Servicios en Destino reservada. | Passions of Paradise: Gran Barrera de Coral |
activity_vendor_name | varchar(200) | Nombre del proveedor de Servicios de Destino contratado. | Viator (3P) |
activity_vendor_city | varchar(200) | Ciudad donde se encuentra la sucursal del vendedor. | Desconocido |
activity_vendor_country_code | char(3) | Código del país donde se encuentra la sucursal del proveedor. | NZL |
activity_ticket_count | smallint | Número de entradas reservadas para la actividad. | 1 |
activity_gbv_local | decimal(18,4) | Valor bruto de reserva de la parte de Servicios en Destino de la reserva en moneda local. | 204.02 |
activity_gbv_usd | decimal(18,4) | Valor bruto de la parte de la reserva correspondiente a los Servicios en Destino, en dólares estadounidenses. | 152.2878 |
activity_gbv_tpid | decimal(18,4) | Valor bruto de la parte de actividad de la reserva en la moneda TPID. | 1029.9317 |
activity_tpid_currency_code | char(3) | Moneda de reserva del TPID de la actividad representada en el formato estándar de código de moneda del Número Internacional de Cuenta Bancaria (IBAN). | USD |
loyalty_id | varchar(200) | Número de identificación de lealtad / afiliación. | 12345678 |
program_id | varchar(200) | Representa la información de nivel | 6549 |
passenger_name | varchar(200) | Nombre de la persona vinculada a las reservas (suele coincidir con el nombre del comprador, excepto en las reservas de avión, en las que figuran todos los pasajeros con billete). | James Smith |
purchaser_first_name | varchar(200) | Nombre de la persona que compra la reserva. | James |
purchaser_last_name | varchar(200) | Apellidos de la persona que compra la reserva. | Smith |
purchaser_email_address | varchar(200) | Dirección de correo electrónico de la persona que compra la reserva. | james.smith@email.com |
billing_address | varchar(200) | Dirección de la persona que compra la reserva (incluyendo calle, ciudad, estado/provincia, país, código postal). | 123 1st Street, Nueva York, NY |
billing_phone_number | varchar(200) | Número de teléfono de la persona que compra la reserva. | 10111213141 |
promotional_mail_indicator | char(3) | Indicador de si el individuo está inscrito para recibir correo promocional. | 0 |