File-based Entrega de itinerarios
El informe estándar de la API de itinerarios del Portal de socios incluye las reservas de « transaction-level », ya sean solo de alojamiento o de varias líneas de negocio (LOB). Si utilizas nuestros informes estándar, podrás obtener tus datos rápidamente, sin necesidad de dedicar tiempo adicional al desarrollo.
Los informes de la API de itinerarios se generan a nivel de transacción y ofrecen una lista seleccionada de más de 60 campos entre los que elegir para el alojamiento, además de más de 100 campos para los informes de « multi-LOB ». Las opciones de campo son las siguientes:
- Información básica sobre la reserva, como las fechas del viaje, los itinerarios y los importes del viaje
- Datos del viajero y del comprador (si son personas diferentes)
- Información sobre el producto, como números de confirmación, proveedores y ubicaciones, el número de LOB utilizados y los costes
>> Más información sobre cómo configurar la entrega de archivos
>> Buenas prácticas para la importación de archivos
Campos predeterminados del informe estándar
Hay muchos campos entre los que elegir a la hora de personalizar tus informes. Estos ya vienen incluidos de serie en los informes estándar.
| Nombre del campo | Tipo de datos | Descripción | Ejemplo |
|---|---|---|---|
book_date | de lanzamiento | La fecha en la que se hizo la reserva por primera vez, expresada en el formato de fecha ISO 8601 (YYYY-MM-DD). | 2023-02-05 |
transaction_date | de lanzamiento | La fecha en la que se modificó por última vez una reserva. Esto es lo mismo quebook_datesi la reserva nunca se actualiza. La fecha se muestra en el formato ISO 8601 (YYYY-MM-DD). | 2023-02-05 |
begin_use_date | de lanzamiento | La fecha en la que empieza el viaje: fecha de salida, fecha de « check-in », fecha de « pick-up », etc., expresada en el formato de fecha ISO 8601 (YYYY-MM-DD). | 2023-04-05 |
end_use_date | de lanzamiento | La fecha en la que termina el viaje: fecha de llegada, fecha de « check-out », fecha de « drop-off », etc., expresada en el formato de fecha ISO 8601 (YYYY-MM-DD). | 2023-04-06 |
transaction_type | varchar(200) | Tipo de transacción registrada. | Valores posibles: compra, concesión, modificación, cancelación. |
product_line_name | varchar(200) | El tipo de operación al que pertenece la partida de reserva. | Valores posibles: Vuelo, Coche, Crucero, Servicios en el destino, Seguro, Alojamiento, Paquete, desconocido |
package_indicator | varchar(100) | Si el elemento de la reserva forma parte de un paquete (como vuelo + hotel). | Valores posibles: parte de un paquete, independiente, desconocido |
product_component | varchar(200) | Productos incluidos en la compra del paquete. Si la compra no es un paquete, solo aparecerá el nombre de una única línea de productos. | Avión, 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, expresada en el formato estándar del código de moneda del número de cuenta bancaria internacional (IBAN). | USD |
gbv_local | decimal(18,4) | El valor bruto de la reserva (GBV), o el importe total de la reserva, incluidos impuestos y comisiones, en la moneda utilizada para el pago. | 694.89 |
order_count | smallint | Número de pedidos (no de artículos) incluidos en la compra del paquete. | 1 |
Campos opcionales adicionales
Nota: La tabla que aparece a continuación no refleja el orden en el que se mostrarán los campos en el informe. El orden de los campos viene determinado por el orden en el que se activan durante la creación o la edición.
| Nombre del campo | Tipo de datos | Descripción | Ejemplo |
|---|---|---|---|
transaction_datetime | Marca de tiempo | Fecha y hora de la última actualización (modificación) de la reserva; si la reserva no se modifica nunca, coincidirá con la fecha de la reserva. | 2023-02-05 06:05:00 |
booking_window | entero | Días que hay entre la fecha de la reserva y la fecha de « check-in ». | 32 |
booking_status | varchar(50) | Abierto, en curso, finalizado, adjudicado o cancelado. | En curso |
online_offline_indicator | varchar(100) | Indica si la reserva se hizo por internet o fuera de internet a través de un agente. | En línea |
point_of_sale_country | char(3) | Punto de venta desde el que el cliente está haciendo la reserva. | USD |
payment_type | varchar(50) | Forma de pago utilizada (como tarjeta de crédito, puntos o pago fraccionado). Este campo se dejará en blanco en las reservas de coches u hoteles en las que la agencia se encargue de pagar más tarde. | Pago fraccionado |
coupon_code | varchar(100) | Se ha utilizado el código del cupón. | 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 |
gbv_tpid | decimal(18,4) | Muestra el valor total de GBV en la moneda del TPID. | 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 la moneda del 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 datos de los pasajeros aéreos del proveedor. | ABCDEF |
air_carrier_pnr | varchar(100) | Registro de datos de los pasajeros de las 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 en avión. | Solo ida |
air_fare_class | varchar(200) | Clase de billete de avión que has comprado. | 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 desde el que sale o tiene su origen el vuelo. | YYZ |
airport_origin_location | varchar(406) | Lugar desde donde sale o tiene su origen el vuelo. | Toronto, Ontario, Canadá |
airport_destination_code | char(3) | Código del aeropuerto al que llega el vuelo o el de destino. | FLL |
airport_destination_location | varchar(406) | Lugar al que llega el vuelo/el 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 de la reserva (con archivos detallados que incluyen el ID de la reserva, que suele ser 0 o 1). | 1 |
air_segment_count | smallint | Número de tramos del viaje en avión (si se agrega por encima del nivel del ID de la reserva, será la suma de todos los tramos de todos los pasajeros de la reserva). | 2 |
air_gbv_local | decimal(18,4) | Valor bruto de la reserva correspondiente al tramo aéreo, en moneda local. | 694,8941 |
air_gbv_usd | decimal(18,4) | Valor bruto de la reserva correspondiente al tramo aéreo, en dólares estadounidenses. | 694,8941 |
air_gbv_tpid | decimal(18,4) | Valor bruto de la reserva correspondiente al tramo aéreo, en la moneda del TPID. | 694,8941 |
air_tpid_currency_code | char(3) | La divisa de la reserva del TPID expresada en el formato estándar del código de divisa del número de cuenta bancaria internacional (IBAN). | USD |
total_person_count | entero | Número total de personas incluidas en la reserva (solo alojamiento). | 3 |
adult_count | smallint | Número de adultos incluidos en la reserva (solo alojamiento). | 2 |
child_count | smallint | Número de niños incluidos en la reserva (solo en el alojamiento). | 1 |
lodging_supplier_confirmation_code | varchar(100) | Código de confirmación que te da el alojamiento al hacer la reserva. | 1516171819 |
lodging_business_model | varchar(200) | Modelo de negocio del servicio de alojamiento de Booking. | Merchant |
lodging_chain_independent | varchar(200) | Indicador que señala si el alojamiento es independiente o forma parte de una cadena. | Independiente |
lodging_chain_name | varchar(200) | Nombre de la cadena (marca) del alojamiento reservado. | Independiente |
lodging_property_name | varchar(200) | Nombre del alojamiento reservado | Hotel Cordelia |
lodging_star_rating | flotante | Clasificación por estrellas del alojamiento reservado. | 3 |
lodging_property_city | varchar(40) | Ciudad donde está el alojamiento que has reservado. | París |
lodging_property_market_name | varchar(80) | Mercado en el que se encuentra el alojamiento reservado. | IDF - París, Francia |
lodging_property_state_province | varchar(40) | Estado o provincia donde está el alojamiento que has reservado. | París |
lodging_property_country | varchar(80) | Código del país donde se encuentra el alojamiento reservado. | Francia |
lodging_refundable_rate_indicator | varchar(100) | Indicación de si la tarifa reservada es reembolsable o no reembolsable. | Tasa 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 «Comfort», con baño privado |
lodging_length_of_stay | entero | Duración de la estancia (número de noches) en el alojamiento reservado. | 5 |
lodging_room_count | smallint | Número de habitaciones reservadas en el alojamiento. | 1 |
lodging_room_night_count | smallint | Número de pernoctaciones de la reserva (duración de la estancia × número de habitaciones). | 5 |
lodging_gbv_local | decimal(18,4) | Valor bruto de la reserva correspondiente al alojamiento, en moneda local. | 1379.8 |
lodging_gbv_usd | decimal(18,4) | Valor bruto de la reserva correspondiente al alojamiento, en dólares estadounidenses. | 1029.9317 |
lodging_gbv_tpid | decimal(18,4) | Valor bruto de la reserva correspondiente al alojamiento, en la moneda del TPID. | 1029.9317 |
lodging_average_daily_rate_local | decimal(18,4) | Tarifa media diaria del alojamiento reservado (GBV / duración de la estancia) en moneda local. | 275.96 |
lodging_average_daily_rate_usd | decimal(18,4) | Tarifa media diaria del alojamiento reservado (GBV / duración de la estancia) en dólares estadounidenses. | 205.9863 |
lodging_tpid_currency_code | char(3) | La moneda de la reserva de alojamiento en TPID, expresada en el formato estándar del código de moneda del número de cuenta bancaria internacional (IBAN). | USD |
car_supplier_confirmation_code | varchar(100) | Código de confirmación que te da la empresa de alquiler de coches al hacer la reserva. | ABC1234 |
car_business_model | varchar(200) | Modelo de negocio de la reserva de piezas de coche. | n/a |
car_vendor_name | varchar(200) | Nombre de la empresa de alquiler de coches con la que has reservado. | Hertz |
car_type | varchar(200) | Tipo de coche reservado. | Compacto de 2/4 puertas |
car_pickup_location_code | char(3) | Código de ubicación (normalmente el código del aeropuerto) donde hay que recoger el coche reservado. | YDF |
car_pickup_location | varchar(200) | Lugar donde hay que recoger el coche que has reservado. | Deer Lake, NL (YDF-Deer Lake Regional) |
car_dropoff_location_code | char(3) | Código de la ubicación (normalmente el código del aeropuerto) donde hay que devolver el coche reservado. | YDF |
car_dropoff_location | varchar(200) | Lugar donde hay que devolver el coche que has reservado. | Deer Lake, NL (YDF-Deer Lake Regional) |
car_trip_type | varchar(200) | Tanto si has reservado el coche para ida y vuelta como si es solo de ida. | Ida y vuelta |
car_rental_day_count | smallint | Número de días que se reservó el coche. | 7 |
car_count | smallint | Número de coches reservados. | 1 |
car_gbv_local | decimal(18,4) | Valor bruto de la reserva correspondiente al coche, en moneda local. | 310,8 |
car_gbv_usd | decimal(18,4) | Valor bruto de la reserva correspondiente al coche, en dólares estadounidenses. | 231.9919 |
car_gbv_tpid | decimal(18,4) | Valor bruto de la reserva correspondiente a la parte del coche, en la moneda del TPID. | 1029.9317 |
car_tpid_currency_code | char(3) | La moneda de la reserva de TPID para el coche, expresada en el formato estándar del código de moneda del número de cuenta bancaria internacional (IBAN). | USD |
activity_offering_name | varchar(200) | Nombre de la actividad de «Destination Services» que has reservado. | Passions of Paradise: Gran Barrera de Coral |
activity_vendor_name | varchar(200) | Nombre del proveedor de servicios de destino con el que has reservado. | Viator (3P) |
activity_vendor_city | varchar(200) | Ciudad donde está la sucursal del proveedor. | Desconocido |
activity_vendor_country_code | char(3) | Código del país donde está 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 la reserva correspondiente a la parte de «Servicios de destino» en moneda local. | 204.02 |
activity_gbv_usd | decimal(18,4) | Valor bruto de la reserva correspondiente a la parte de «Servicios de destino» de la reserva, en dólares estadounidenses. | 152.2878 |
activity_gbv_tpid | decimal(18,4) | Valor bruto de la reserva correspondiente a la parte de la actividad, en la moneda del TPID. | 1029.9317 |
activity_tpid_currency_code | char(3) | La divisa de la reserva de la actividad TPID expresada en el formato estándar del código de divisa del Número Internacional de Cuenta Bancaria (IBAN). | USD |
loyalty_id | varchar(200) | Número de fidelidad / de socio. | 12345678 |
program_id | varchar(200) | Muestra información sobre los niveles | 6549 |
passenger_name | varchar(200) | Nombre de la persona asociada a las reservas (normalmente es el mismo que el del comprador, salvo en las reservas de vuelos, en las que aparecen todos los pasajeros con billete). | James Smith |
purchaser_first_name | varchar(200) | Nombre de la persona que realiza la reserva. | James |
purchaser_last_name | varchar(200) | Apellido de la persona que realiza la reserva. | Smith |
purchaser_email_address | varchar(200) | Dirección de correo electrónico de la persona que realiza la reserva. | james.smith@email.com |
billing_address | varchar(200) | Dirección de la persona que realiza la reserva (incluyendo calle, ciudad, estado/provincia, país y código postal). | 123 1st Street, Nueva York, NY |
billing_phone_number | varchar(200) | Número de teléfono de la persona que realiza la reserva. | 10111213141 |
promotional_mail_indicator | char(3) | Indicador de si una persona se ha dado de alta para recibir correos promocionales. | 0 |