Compartir el contexto de reserva con las propiedades

Proporcionar una experiencia fluida a los socios y clientes corporativos

Información general

Rapid API ofrece opciones para ayudar a los alojamientos a servir mejor a los viajeros compartiendo contexto de reserva adicional en las reservas de alojamiento. Son especialmente útiles, aunque no exclusivamente, para los viajeros de negocios.

Estas opciones ayudan a los alojamientos:

Reconocer las relaciones entre empresas y TMC
Comprender cuándo se utilizan las tarjetas de crédito virtuales y cómo deben manejarse

Las características principales son:

Identificación de socios y clientes: comparte información con las propiedades sobre la fuente de la reserva (e.g. TMC y clientes corporativos).
Instrucciones de la tarjeta de crédito virtual: comparte orientaciones claras sobre cómo debe utilizarse una tarjeta de crédito virtual para una reserva por cobrar de una propiedad.

Son especialmente útiles cuando se utilizan en combinación con:

Identificación de socios y clientes

Objetivo

La identificación de socios y clientes te permite incluir información en la solicitud de Reserva para que la propiedad pueda verla:

Qué socio gestionó la reserva (por ejemplo, una empresa específica de gestión de viajes) y/o
¿Qué cliente corporativo emplea al viajero

Este contexto proporciona a los alojamientos una mayor visibilidad sobre el origen de una reserva, lo que les permite

Reconocer al socio de Rapid a través del cual reservó un viajero
Reconoce a los invitados corporativos que repiten o de alto valor
Ofrecer una experiencia de viaje más personalizada
Mantener la continuidad del tratamiento para los viajeros frecuentes de empresa

Parámetros API

Puedes enviar esta información utilizando los siguientes campos de la solicitud de Reserva:

supplier_transparency (objeto)
consent_to_share (booleano, obligatorio si quieres que los datos se compartan con los proveedores)

Puedes pasar el nombre del socio o del cliente, o ambos.

Reglas clave:

consent_to_share Es obligatorio que Rapid API transmita los datos a los proveedores
Si consent_to_share no es true, Rapid API no compartirá la información del socio/cliente, aunque supplier_transparency esté rellenado

Ejemplo de identificación de socios y clientes

{
  ...
  "supplier_transparency": {
    "point_of_sale_display_to_share": "PLS Partner Name",
    "company_name_to_share": "Corporate Client Name",
    "consent_to_share": true
  }
}

Detalles del campo

Campo	Detalles
`point_of_sale_display_to_share`	Una etiqueta partner-facing o traveler-facing que quieras que veal alojamiento (por ejemplo, la marca de la TMC o del distribuidor).
`company_name_to_share`	El nombre del cliente corporativo asociado al viajero (por ejemplo, el empleador).
`consent_to_share`	Cuando `true`, indica a Rapid API que el cliente final ha consentido que esta información se comparta con el proveedor (propiedad). Si se omite o `false`, la información no se reenvía.

Instrucciones de la tarjeta de crédito virtual

Context

Los programas de empresa suelen pagar los viajes de negocios utilizando una mezcla de:

Tarjetas de crédito personales para viajeros
Tarjetas de pago para empresas
Tarjetas de crédito virtuales (VCC)

Sin embargo, algunas propiedades carecen de directrices claras al respecto:

Cómo reconocer y procesar la tarjeta de crédito virtual
Qué cargos se autorizan en una tarjeta de crédito virtual
Cuándo se puede cargar la tarjeta (periodo de validez)

Esto puede llevar a confusiones en la facturación y/o en la salida y a experiencias negativas para los viajeros de negocios.

Objetivo

Las instrucciones de la tarjeta de crédito virtual proporcionan a los alojamientos una orientación estructurada sobre:

Si se está utilizando una tarjeta de crédito virtual para una reserva por cobrar de una propiedad
Qué gastos están cubiertos (habitación, impuestos, imprevistos especificados, etc.)
Cualquier límite de carga y fechas de validez
Cómo localizar a un contacto de la tarjeta si algo va mal

Parámetros de la API

Estas instrucciones se añaden dentro de la solicitud de Reserva utilizando:

Matriz de pagos:
- typeidentifica una tarjeta de crédito virtual cuando se utiliza virtual_card
additional_handling (dentro de una entrada de pago) proporciona instrucciones detalladas sobre la gestión del pago, como por ejemplo
- authorized_expenses
- specified_incidental_expenses
- total_charges_allowed
- is_cvc_required
- authorizing_company
- card_contact
- payment_allowable_period_start
- payment_allowable_period_end

El objeto additional_handling es opcional, pero recomendable.

Ejemplo de tarjeta de crédito virtual con gestión adicional

{
 ...
 "pagos": [
 {
 "tipo": "virtual_card",
 "número": "4111111111111111",
 "security_code": "123",
 "expiration_month": "08",
 "expiration_year": "2025",
 "billing_contact": {
 "given_name": "Juan
 "family_name": "Smith",
 "dirección": {
 "línea_1": "555 1st St",
 "line_2": "Piso 10",
 "line_3": "Unidad 12",
 "ciudad": "Seattle",
 "state_province_code": "WA",
 "postal_code": "98121",
 "country_code": "US"
 }
 },
 "additional_handling": {
 "authorized_expenses": "total_plus_incidentals",
 "specified_incidental_expenses": [
 "desayuno",
 "internet"
 ],
 "total_charges_allowed": {
 "valor": "875.00",
 "moneda": "USD"
 },
 "is_cvc_required": verdadero,
 "authorizing_company": "Conferma",
 "card_contact": {
 "correo electrónico": "chucktesta@mydomain.com",
 "teléfono": {
 "country_code": "1",
 "area_code": "555",
 "número": "5555555"
 }
 },
 "payment_allowable_period_start": "2024-01-01",
 "payment_allowable_period_end": "2025-08-01"
 }
 }
 ]
}

### Campos clave de manipulación adicionales

| Campo | Detalles |
| ----- | ----- |
| `authorized_expenses` | Regla de alto nivel que indica para qué puede utilizarse la tarjeta de crédito virtual, e.g.<br><br>• `room_only`<br>• `room_and_tax`<br>• `total_plus_incidentals` |
| `specified_incidental_expenses` | Una lista de los gastos imprevistos específicos que están permitidos (por ejemplo, desayuno o internet) |
| `total_charges_allowed` | Un límite superior explícito para las tasas<br><br> • valor: importe máximo<br>• moneda: código de moneda (e.g. USD) |
| `is_cvc_required` | Indica si el CVC debe estar presente para que la propiedad realice el cargo en la tarjeta |
| `authorizing_company` | Nombre de la empresa que emitió o gestiona la tarjeta de crédito virtual (por ejemplo, un proveedor de tarjetas de crédito virtuales o una entidad corporativa) |
| `card_contact` | Datos de contacto en caso de que el alojamiento tenga algún problema para efectuar el cargo en la tarjeta:<br><br>• `email`<br>•`phone.country_code, phone.area_code, phone.number` |
| `payment_allowable_period_start / payment_allowable_period_end` | El intervalo de fechas durante el cual la tarjeta es válida para los cargos (suele coincidir con las fechas de estancia más un pequeño margen). |