Requisitos de lançamento para B2B somente acomodação
Esses requisitos de lançamento se aplicam a todos os parceiros com um modelo de integração business-to-business (B2B), em que os clientes finais interagem com um de seus agentes de viagens.
Visão geral
Os requisitos de lançamento B2B são categorizados em duas seções:
Requisitos do B2B SA - São específicos para este fluxo de reserva. Leia com atenção os requisitos, pois podem diferir de todos os outros tipos de tarifas ou fluxos de reserva que você integrou antes.
Requisitos comuns - Esses requisitos são comuns a todos os fluxos de reserva. Confirme que todos esses requisitos são atendidos em todos os fluxos.
Lista de verificação
Você pode encontrar uma lista de verificação para ajudar a dar suporte ao seu desenvolvimento ou fornecer feedback sobre os requisitos aqui . Se pretende disponibilizar capturas de tela para a revisão do seu site, adicione as imagens e os registros correspondentes na lista de verificação, pois isso nos ajuda a concluir o processo.
Requisitos específicos do B2B SA
Requisitos gerais
GR3: Os agentes downstream devem concordar com os Termos e Condições do Agente Expedia Group para acessar o estoque Expedia Group.
Os agentes que fazem uma reserva em nome de um usuário final/viajante devem concordar com o contrato de agente downstream do Expedia Group. Um link para o contrato do agente downstream deve ser fornecido para que os agentes revisem e aceitem antes de fazer uma reserva. Outras versões estão disponíveis aqui.
Página de reservas
BP5 – A exibição de preços deve incluir o preço total e o detalhamento dos impostos e taxa
A) Preço total
O preço total da reserva deve ser mostrado ao viajante na página de pagamento. O preço total deve corresponder à resposta da API, sem permissão de arredondamento nem conversão de moeda. O detalhamento final deve incluir as tarifas dos quartos (total ou por noite), quaisquer taxas noturnas adicionais (exceto aquelas no campo property_fee
descrito abaixo), todos os valores de estadia e impostos, um total cobrável e definir o que é pago agora e o que deve ser pago posteriormente em propriedade.
B) Detalhamento de impostos
A exibição do preço deve incluir a soma de tax_and_service_fee
e property_fee
em uma linha intitulada "Impostos e taxas". O texto exato abaixo é legalmente exigido para ser exibido ao se referir a quaisquer totais de impostos e taxas dentro do detalhamento de preços. Isso pode ser exibido como pop-up, texto simples, modal ou outra implementação. A taxa propriedade não deve ser exibida separadamente na página de checkout.
Os impostos são taxas de recuperação de impostos pagas aos fornecedores (e.g. hotéis); para mais detalhes, consulte nossos Termos de Uso. As taxas de serviço são retidas como compensação pela prestação de serviços à sua reserva e podem incluir taxas cobradas pelos fornecedores. – Traduções podem ser encontradas aqui.
O valor retornado para tax_and_service_fee
inclui apenas impostos e taxas exigidos por uma jurisdição fiscal.
C) Cobranças pelos serviços e pelas reservas de parceiros
Na medida em que o Expedia Group concede uma isenção para permitir cobranças por reservas, as cobranças pelos serviços ou pelas reservas de parceiros devem ser separadas com clareza. Se uma taxa de serviço partner-imposed for adicionada à reserva, deve ficar claro para o cliente que a taxa é cobrada pelo parceiro, e não Expedia Group, por um serviço separado (i.e, não uma taxa adicional pelo fornecimento de acomodação). As cobranças não podem ser incluídas nos itens de impostos e taxas existentes. O parceiro não deve usar a palavra "taxa" para descrever cobranças impostas por ele. Eles poderiam usar 'taxa de reserva de afiliado' ou 'taxa de serviço de afiliado'.
Página de confirmação
CP1: A exibição do preço deve incluir o preço total, bem como impostos e taxas, se houver detalhamento.
A) Preço total
O preço total da reserva deve ser exibido ao viajante na página de confirmação. O preço total deve corresponder à resposta da API, sem permissão de arredondamento nem conversão de moeda. O detalhamento final deve incluir as tarifas dos quartos (total ou por noite), quaisquer taxas noturnas adicionais (exceto aquelas no campo property_fee
descrito abaixo), todos os valores de estadia e impostos, um total cobrável e definir o que é pago agora e o que é pago posteriormente em propriedade.
B) Detalhamento de impostos
A exibição de preço deve incluir a soma de tax_and_service_fee
e property_fee
em uma linha intitulada "Impostos e taxas". A apresentação do texto abaixo é exigida por lei ao se referir a quaisquer valores de impostos e taxas em um detalhamento de preço. Isso pode ser exibido como pop-up, texto simples, modal ou outra implementação. A taxa propriedade não deve ser exibida separadamente na página de checkout.
Os impostos são taxas de recuperação de impostos pagas aos fornecedores (e.g. hotéis); para mais detalhes, consulte nossos Termos de Uso. As taxas de serviço são retidas como compensação pela prestação de serviços à sua reserva e podem incluir taxas cobradas pelos fornecedores. – Traduções podem ser encontradas aqui.
O valor retornado para tax_and_service_fee
inclui apenas impostos e taxas exigidos por uma jurisdição fiscal.
C) Cobranças pelos serviços e pelas reservas de parceiros
Na medida em que o Expedia Group concede uma isenção para permitir cobranças por reservas, as cobranças pelos serviços ou pelas reservas de parceiros devem ser separadas com clareza. Se uma taxa de serviço partner-imposed for adicionada à reserva, deve ficar claro para o cliente que a taxa é cobrada pelo parceiro e não Expedia Group por um serviço separado (i.e, não uma taxa adicional pelo fornecimento de acomodação). As cobranças não podem ser incluídas nos itens de impostos e taxas existentes. O parceiro não deve usar a palavra "taxa" para descrever cobranças impostas por ele. É possível usar "cobrança de reserva de afiliados" ou "cobrança de serviços de afiliados".
E-mail de confirmação
ER6 – A exibição de preços deve incluir o preço total e o detalhamento de impostos e taxas
A) Preço total
O preço total da reserva deve ser exibido ao viajante no recibo por e-mail. O preço total deve corresponder à resposta da API, sem permissão de arredondamento nem conversão de moeda. O detalhamento final deve incluir as tarifas dos quartos (total ou por noite), quaisquer taxas noturnas adicionais (exceto aquelas no campo property_fee
descrito abaixo), todos os valores de estadia e impostos, um total cobrável e definir o que é pago agora e o que é pago posteriormente em propriedade.
B) Detalhamento de impostos
A exibição do preço deve incluir a soma de tax_and_service_fee
e property_fee
em uma linha intitulada "Impostos e taxas". A apresentação do texto abaixo é exigida por lei ao se referir a quaisquer valores de impostos e taxas em um detalhamento de preço. Isso pode ser exibido como pop-up, texto simples, modal ou outra implementação. A taxa propriedade não deve ser exibida separadamente na página de checkout.
Os impostos são taxas de recuperação de impostos pagas aos fornecedores (e.g. hotéis); para mais detalhes, consulte nossos Termos de Uso. As taxas de serviço são retidas como compensação pela prestação de serviços à sua reserva e podem incluir taxas cobradas pelos fornecedores. – Traduções podem ser encontradas aqui.
O valor retornado para tax_and_service_fee
inclui apenas impostos e taxas exigidos por uma jurisdição fiscal.
C) Cobranças pelos serviços e pelas reservas de parceiros
Na medida em que o Expedia Group concede uma isenção para permitir cobranças por reservas, as cobranças pelos serviços ou pelas reservas de parceiros devem ser separadas com clareza. Se uma taxa de serviço partner-imposed for adicionada à reserva, deve ficar claro para o cliente que a taxa é cobrada pelo parceiro, e não Expedia Group, por um serviço separado (i.e, não uma taxa adicional pelo fornecimento de acomodação). As cobranças não podem ser incluídas nos itens de impostos e taxas existentes. O parceiro não deve usar a palavra "taxa" para descrever cobranças impostas por ele. É possível usar "cobrança de serviços de afiliados" ou "cobrança de reserva de afiliados".
Requisitos comuns de lançamento
Os requisitos de lançamento abaixo se aplicam a todos os parceiros Expedia Group em todos os fluxos de reserva. Outros requisitos específicos a cada tipo de tarifa, incluindo uma descrição detalhada da apresentação de preço, são disponibilizados em listas individuais de requisitos de tarifa.
Requisitos gerais
GR1: Uso de nomes e logotipos Expedia Group
O uso de nomes e logotipos Expedia Group só pode ser usado em sites de clientes ou agent-facing com aprovação prévia explícita por escrito da Expedia Group como exceção.
Exemplo:

GR2: Links para os termos e condições do Expedia Group URL a ser exibido
Forneça um link para os Termos e Condições do Expedia Group no texto dos Termos e Condições do seu site ou crie um link direto para os termos na sua página de reservas. Esses termos detalham as políticas que regem a reserva. Coloque o link a seguir em um local fácil de encontrar, usando o texto do link "Termos e Condições do Fornecedor". A versão em inglês pode ser encontrada aqui outras versões estão listadas aqui .
Exemplo:

GR4: Expedia Group MoR: Uso e exibição adequados em relação aos regulamentos de cartão de crédito
Ao obter, usar, transmitir, armazenar ou processar dados do titular do cartão do cliente final, você deverá cumprir o PCI DSS emitido pelo Conselho de Padrões de Segurança PCI . Uma referência completa para estes regulamentos está disponível no site oficial Conselho de Padrões de Segurança PCI site.
GR5: Expedia Group MoR ou propriedade Coletar: Evidência de conformidade com PCI fornecida para parceiros aplicáveis
Quando Expedia Group ou propriedade for MoR, uma Atestado de Conformidade (AOC) deve ser fornecida como evidência de conformidade com PCI.
Você pode encontrar conselhos sobre conformidade com PCI no site oficial Conselho de Padrões de Segurança PCI site.
Página de busca
SP1: Quando o afiliado permite que crianças sejam incluídas nas reservas, mensagens adequadas e a inserção das idades das crianças são implementadas
Se a sua integração permitir crianças viajando, você deve oferecer a possibilidade de especificar a idade de cada criança viajando no momento do check-in. Esta informação é fornecida através dooccupancy
objeto (veja o exemplo abaixo).
Quando os clientes especificam viajantes crianças, a resposta da API pode conter restrições de idade e cobranças de ocupação extra ou uso de berço que, talvez, influenciem o custo ou a qualificação da reserva.
Cada hotel define a faixa etária que classifica como criança. Pessoas com até 17 anos costumam ser consideradas crianças. Algumas propriedades não permitem hóspedes com menos de 18 anos.
Exemplo de solicitação da API:
https://api.ean.com/2.4/properties/availability?checkin=2020-09-11
&checkout=2020-09-14
¤cy=USD&language=en-US& occupancy=2-9,4 &property_id=XXXX
&country_code=XX&sales_channel=XXXX
&sales_environment=XXXX&filter=XXXX&rate_plan_count=XXXX
&rate_option=XXXX&billing_terms=XXXX&payment_terms=XXXX
&partner_point_of_sale=XXXX&platform_name=XXXX
Exemplo de resposta da API:
"occupancies": {
"2-9,4" : {
"nightly": [
[
Exemplo da interface do usuário: 1 quarto com 2 adultos e 2 crianças de 9 e 4 anos.

Disponibilidade de propriedade/quarto
AP1: As descrições dos tipos de cama estão presentes em cada quarto
As respostas da loja podem retornar obed_groups
matriz com um único valor ou múltiplas opções. Mostre os valores contidos na matriz de configuração para descrever as opções de cama do cliente.
Quando a matriz bed_groups
retornar com várias opções, mostre os links de price_check
apresentados pela resposta de compra para cada tipo de cama, para permitir a seleção do cliente.
É necessário mostrar uma mensagem ao viajante avisando que as escolhas entre vários tipos de cama para o mesmo quarto são apenas solicitações e podem não ser respeitadas no hotel caso a disponibilidade não permita.
Os nomes dos quartos são retornados na matriz dos quartos da resposta de compra como room_name
.
Exemplo de resposta da API
"property_id": "11775754",
"rooms": [
{
"id": "230434524",
"room_name": "Superior double room" ,
"rates": [
{
...
"bed_groups": {
"133243": {
"id": "133243",
"description": "Double bed" ,
"links": {...},
"configuration": [...]
},
"133242": {
"id": "133242",
"description": "2 single beds" ,
"links": {...},
"configuration": [...]
}
},
Exemplo de interface do usuário:

AP2: o sinalizador Non-refundable está claramente visível
As disponibilidades de Non-refundable são indicadas porrefundable=false
no Comprar resposta de disponibilidade. Quandorefundable=false
for retornado em uma resposta de disponibilidade, identifique claramente os quartos aplicáveis. Esse valor sempre prevalece sobre quaisquer dados de políticas diferentes. Essas reservas não são reembolsadas pela propriedade em nenhuma circunstância.
Exemplo de resposta da API:
"property_id": "XXXX",
"rooms":
"id": "XXXX",
"room_name": "Fairmont King",
"rates":
"id": "XXXX",
"status": "available",
"available_rooms": 4999,
"refundable": false ,
"deposit_required": false,
"merchant_of_record": "expedia",
Exemplo de interface do usuário:

AP3: Exibir instruções check-in e especiais check-in
O conteúdo docheckin
,checkout
,fees
, epolicies
os objetos devem ser exibidos para cada sala conforme retornado no propriedade contente definição. Essas informações devem ser exibidas na sua página de disponibilidade para garantir que o cliente esteja ciente de quaisquer taxas potenciais no check-in ou instruções especiais de acesso.
O campo de check-in especial pode incluir informações essenciais para o check-in que não estão incluídas no campo de instruções do objeto checkin
, como um requisito para notificar a propriedade sobre o horário previsto de chegada, fazer o check-in em um local diferente do prédio do hóspede ou um alerta para esperar instruções especiais de check-in da propriedade por e-mail.
Confirme que instructions
e special_instructions
são mostradas na mesma área para o viajante.
Exemplo de resposta da API:
"11775754": {
"property_id": "11775754",
"checkin": {
"begin_time": "16:00 PM",
"end_time": "4:00 AM",
"instructions": "Minimum age to check in is 18 years old.
<br />Extra-person charges may apply and vary depending on property policy.
<br />Government-issued photo identification and a credit card may be required at
check- in for incidental charges.
<br />Special requests are subject to availability upon check-in and
may incur additional charges. Special requests cannot be guaranteed. <ul>. ",
"special_instructions": "Front desk staff will greet guests on arrival. For more details,
please contact the property using the information on the booking confirmation.",
"min_age": 18
"checkout": {
"time": "11:00 AM"
"fees": {
"mandatory": "<p>You'll be asked to pay the following charges at the property:</p>
<ul><li>Deposit: USD 50 per day</li>
<li>Resort fee: USD 28.25 per accommodation,
per night</li></ul> The resort fee includes:<ul
><li>Pool access</li><li>Fitness center access</li><li>Fitness/yoga classes</li>
<li>Airport shuttle</li><li>Phone calls</li><li>In-room safe</li><li>Self parking</li>
<li>Valet parking</li><li>Parking</li></ul> <p>We have included all charges provided to us by the property.
However, charges can vary, for example, based on length of stay or the room you book. </p>",
"optional": "<p>The following fees and deposits are charged by the property at time of service,
check-in, or check-out. </p> <ul> <li>Breakfast fee: between USD 6 and USD 25 per person
(approximately)</li> <li>Late check-out is available for a fee (subject to availability)</li>
<li>Rollaway bed fee: USD 20.0 per night</li>
</ul> <p>The above list may not be comprehensive. Fees and deposits may not include tax
and are subject to change. </p>"
"policies": {
"know_before_you_go": "<ul> <li>Up to 2 children 12 years old and younger stay free when
occupying the parent or guardian's room, using existing bedding. </li>
<li>The property has connecting/adjoining rooms, which are subject to availability
and can be requested by contacting the property using the number on the booking
confirmation. </li> </ul>"
Exemplo de interface do usuário:

Página de reservas
BP1: Criptografia SSL está presente para dados pessoais
Ao enviar ou transmitir dados pessoais, você deve usar a criptografia SSL para proteger as conexões entre os navegadores ou apps do cliente e o seu site, bem como as comunicações de rede com sistemas dependentes. Dados pessoais incluem nomes, números de telefone ou e-mails de hóspedes, dados do cartão de pagamento, além de recibos de reserva ou itinerário e páginas de confirmação. Pare ou redirecione a conexão quando não for segura.
BP2: Exibir instruções de check-in e check-in especial
O conteúdo dos objetos checkin
, checkout
, fees
e policies
deve ser exibido para cada sala, conforme retornado na definição da propriedade content. Essas informações devem ser mostradas para garantir que o cliente esteja ciente de possíveis taxas no momento do check-in ou instruções de acesso especial antes de finalizar a reserva.
O campo de check-in especial pode incluir informações essenciais para o check-in que não estão incluídas no campo de instruções do objeto checkin
, como um requisito para notificar a propriedade sobre o horário previsto de chegada, fazer o check-in em um local diferente do prédio do hóspede ou um alerta para esperar instruções especiais de check-in da propriedade por e-mail.
Confirme que instructions
e special_instructions
são mostradas na mesma área para o viajante.
BP3: Política de cancelamento e etiqueta não reembolsável claramente exibidas
Antes de permitir que clientes confirmem a compra na página final de reserva, você deve disponibilizar a política de cancelamento ou tag de não reembolsável para os quartos selecionados. A política de cancelamento de cada tarifa é apresentada no objeto cancel_penalties
na API de disponibilidade de compras da Rapid.
No caso de tarifas reembolsáveis, a resposta inclui uma matriz de detalhes da política de cancelamento. Os detalhes incluem as datas inicial e final da multa especificada, bem como o tipo e o valor da multa, além de todas as datas de reserva com exceção que possam ser aplicadas. Os tipos de multa incluem um valor fixo, número de diárias e porcentagem do custo total.
Resposta | Significado |
---|---|
refundable=true | Essa tarifa é totalmente reembolsável. |
refundable=true + cancel_penalties | • Esta tarifa é reembolsável durante o período de cancelamento. • O prazo mais antigo cancel_penalties.[].start é o prazo de cancelamento gratuito, se for um cronograma futuro.• A tarifa é 100% não reembolsável após o último cancel_penalties.[].end |
refundable=false | • Esta tarifa não é reembolsável. • Nenhuma janela de multa de cancelamento é retornada. |
refundable=false + cancel_penalties | • A tarifa pode ser parcialmente reembolsável. • cancel_penalties deve ser exibido em conjunto com nonrefundable_date_ranges , que mostrará que as datas de estadia desse intervalo não são reembolsáveis assim que a reserva for criada. |
Mais informações sobre como elaborar políticas de cancelamento estão aqui.
Referência:
refundable=false
- Um valor não reembolsável vai ser cobrado imediatamente após a criação da reserva.
cancel_penalties
enonrefundable_date_ranges
têm mais detalhes.
nonrefundable_date_ranges
- As datas de estadia apresentadas nesse intervalo não são reembolsáveis depois da criação da reserva.
cancel_penalties
- Aplicável às datas de estadia que não estão envolvidas em
nonrefundable_date_ranges
. - A tarifa é 100% não reembolsável quando
cancel_penalties
estiver em branco ou não for retornado. - Uma cobrança de multa vai ser feita no cancelamento durante o período de
cancel_penalties
. - O prazo mais antigo
cancel_penalties.[].start
é o prazo de cancelamento gratuito, se for um cronograma futuro. - A tarifa é 100% não reembolsável após o último
cancel_penalties.[].end
.
Exemplo de resposta da API: política de cancelamento e sinalizador não reembolsável
"property_id": "11775754",
"rooms": [
{
"id": "230434524",
"room_name": "Traditional Room (Partner:Connect Test)",
"rates":
"id": "276321199",
"status": "available",
"available_rooms": 4999,
"refundable": true,
"cancel_penalties": [
{
"start": "2020-09-10T18:00:00.000-07:00",
"end": "2020-09-11T18:00:00.000-07:00",
"amount": "76.00",
"currency": "USD"
Exemplo de interface do usuário:

BP4: Exibir as taxas devidas na propriedade separadamente no detalhamento de preços
Quando as cobranças forem retornadas na matriz de taxas, mostre cada valor separado como uma cobrança devida na propriedade, no check-in ou no check-out. Apresente ao viajante a moeda local e solicite moeda. Essas taxas são cobradas diretamente pela propriedade (não pelo Expedia Group ou pelo governo local) e não fazem parte das taxas, impostos ou encargos de recuperação de impostos padrão incluídos na linha de impostos e taxas.
Exemplo de resposta da API: matriz de taxas
"fees" : {
"resort_fee": {
"request_currency": {
"value": "74.97",
"currency": "USD"
},
"billable_currency": {
"value": "74.97",
"currency": "USD"
},
"scope": "per_accommodation",
"frequency": "per_night"
}
},
Exemplo de interface do usuário:
Exemplo de quarto duplo standard](resources/reference/assets/Price_display_must_include_the_total_price_and_breakdown_of_the_taxes_and_fees.png'Standard double room example'
BP7: Se aplicável, as idades das crianças devem ser reiteradas
Se a sua integração permite a inclusão de crianças, e o cliente as especificar na seleção do quarto, você deve confirmar com clareza o número de viajantes que são crianças e as idades delas nas páginas de reservas. Essas informações são fornecidas por meio do objeto child_ages
.
BP8: Expedia Group MoR ou Property Collect: Informe quando o pagamento será cobrado do viajante final
Se o Expedia Group MoR for aplicável, informe que o cartão de crédito fornecido será cobrado imediatamente pelo valor total da reserva.
No caso de Property Collect, declare que a cobrança vai ser feita pela propriedade no momento do check-in ou do check-out no cartão de crédito informado. Se a propriedade oferece uma tarifa de pós-pagamento não reembolsável, indique que o cliente pode receber uma cobrança da propriedade logo após concluir a reserva.
BP9: Conformidade com os Regulamentos do Espaço Econômico Europeu: Diretiva de Serviços de Pagamento 2 (PSD2)
A conformidade com a PSD2 é necessária para qualquer parceiro que pretenda realizar transações com clientes no Espaço Econômico Europeu (EEE). Saiba mais aqui.
Expedia Group MoR ou Property Collect
Se o Expedia Group for o MoR ou o Property Collect for usado com clientes europeus, o caminho da reserva deverá incluir a adoção das APIs da Rapid para autenticação de dois fatores.
Afiliado MoR - Geral
Os parceiros devem seguir os requisitos de autenticação forte do cliente (SCA) dos regulamentos da PSD2 quando as transações com clientes estiverem nesse escopo. O texto completo da diretiva está disponível na Comissão Europeia. Mais informações sobre os padrões em conformidade que podem ser adotados estão disponíveis no “protocolo 3D Secure e especificação das funções principais” da EMVCo.
Afiliado MoR - Cartão corporativo ou cartão virtual
Os parceiros que pagam ao Expedia Group com um cartão de propriedade do parceiro, emitido em um país dentro do EEE, devem seguir os requisitos dos regulamentos PSD2. Para atenuar a necessidade do PSD2 2FA, um parceiro pode usar um cartão compatível com pagamentos B2B e isento de 2FA (autenticação de dois fatores).
Algumas opções em conformidade:
- Cartões virtuais de uso único.
- Cartão corporativo multiuso registrado em nome da empresa, não de uma pessoa. Configuração de perfil especial necessária.
Exemplo de solicitação da API para verificação de preço:
https://api.ean.com/<Price Check link from previous availability request>
Exemplo de resposta da API:
{
"status": "available",
"occupancy_pricing": {... },
"links": {
"payment_session": {
"method": "POST",
"href": "/2.4/payment-sessions?token=XXXX"
}
}
}
BP10: Expedia Group MoR – Local de processamento de pagamento exibido nas páginas de check-out
Quando o Expedia Group for MoR, o país onde o pagamento será processado deverá ser exibido em local de destaque na página de checkout. A frase "Este pagamento será processado em" deve ser inserida antes do nome do país.
Use a função de opções de pagamento da API de compras para conseguir essa informação.
Exemplo de solicitação da API para opções de pagamento:
https://api.ean.com/<payment-options link from previous availability request>
Exemplo de resposta da API:
"credit_card": {
"name": "Credit Card",
"card_options": [
"name": "MasterCard",
"processing_country": "US"
"name": "Visa",
"processing_country": "US"
Exemplo de interface do usuário:

E-mail de confirmação/voucher
Se você vai disponibilizar um voucher hospedado em um app para dispositivo móvel, continue seguindo os requisitos abaixo.
ER1: IDs de itinerário exibidos corretamente
Apenas CDS
Se sua integração fornecer o itinerary_id
do Expedia Group diretamente aos clientes, você deverá exibir esse número claramente no seu e-mail de confirmação.
Se aplicável, você deve fornecer evidências de que seus agentes têm acesso aos IDs de itinerário originais do Expedia Group, caso precisem de assistência do suporte ao cliente do Expedia Group.
A2A
Seus agentes devem ter acesso aos IDs originais dos itinerários do Expedia Group caso precisem de assistência do suporte ao cliente do Expedia Group.
ER2: O suporte ao cliente deve ser exibido de forma clara, incluindo links para ferramentas de atendimento ao cliente online
Mostre com clareza os seus canais de atendimento ao cliente no fluxo de reservas ou no e-mail de confirmação. Por exemplo: número de telefone ou chat ao vivo. Se os agentes do Expedia Group fornecerem suporte direto aos seus clientes, exiba o número de suporte do Expedia Group no seu fluxo de reservas.
ER3: As descrições dos tipos de cama estão presentes em cada quarto
Confirme o tipo de cama solicitado pelos viajantes no seu voucher ou e-mail de confirmação e mostre uma mensagem avisando que as escolhas entre vários tipos de cama para o mesmo quarto são apenas solicitações e talvez não sejam respeitadas no hotel caso a disponibilidade não permita.
Mostre os valores contidos na matriz de configuração para descrever as opções de cama do cliente.
ER4: Exibir instruções de check-in e check-in especial
O conteúdo dos objetos checkin
, checkout
, fees
e policies
deve ser exibido para cada sala, conforme retornado na definição de conteúdo da propriedade. Essas informações devem ser mostradas na página de disponibilidade para garantir que o cliente esteja ciente de possíveis taxas no momento do check-in ou instruções de acesso especial.
O campo de check-in especial pode incluir informações críticas para o check-in que não estão incluídas nocheckin
campo de instruções do objeto, como um requisito para notificar a propriedade sobre o horário previsto de chegada, fazer check-in em um local diferente do prédio do hóspede ou um alerta para esperar instruções especiais de check-in da propriedade por e-mail.
Confirme que instructions
e special_instructions
são mostradas na mesma área para o viajante.
ER5: Exibir as taxas devidas na propriedade separadamente dentro do detalhamento de preços
Quando as cobranças forem retornadas na matriz de taxas, mostre cada valor separado como uma cobrança devida na propriedade, no check-in ou no check-out. Essas taxas são cobradas diretamente pela propriedade (não pelo Expedia Group ou pelo governo local) e não fazem parte das taxas padrão de recuperação de impostos.
Requisitos técnicos e sanções
TR1: Forneça um ID de referência de afiliado exclusivo com cada solicitação de reserva
Para cada solicitação de reserva você deve usar oaffiliate_reference_id
elemento com a intenção de:
- seu próprio rastreamento;
- evitar reservas ou cobranças duplicadas pelo envio de vários formulários;
- Verificar os sistemas do Expedia Group para um itinerário se a reserva expirou ou retornou um resultado vazio devido a tempos limite do upstream.
{
"affiliate_reference_id": "Launch_Requirement_TR1" ,
"hold": false,
"email": "TR4@Launch.Requirement",
"phone": {
"country_code": "Launch_Requirement_TR5b",
"number": "Launch_Requirement_TR5b",
"area_code": "Launch_Requirement_TR5b"
},
"rooms": [
{
"given_name": "John_Launch_Requirement_TR5a",
"family_name": "Doe_Launch_Requirement_TR5a,
"smoking": false,
},
{
"given_name": "David_Launch_Requirement_TR5a",
"family_name": "Smith_Launch_Requirement_TR5a",
"smoking": false,
}
],
TR2: Forneça o código do país do viajante com cada solicitação
- O
country_code
do viajante deve ser passado nas solicitação da API de compras e de recomendações. O código do país deve corresponder ao ponto de venda acessado pelo cliente. - Esse requisito garante que os sistemas do Expedia Group forneçam aos clientes conteúdo relevante e as tarifas mais adequadas com base no mercado de vendas.
Exemplo de solicitação da API:
https://api.ean.com/2.4/properties/availability?checkin=2020-09-11
&checkout=2020-09-14
¤cy=USD&language=en-US&occupancy=2-3,4&property_id=XXXX
&country_code=XX&sales_channel=XXXX
&sales_environment=XXXX&filter=XXXX&rate_plan_count=XXXX
&rate_option=XXXX&billing_terms=XXXX&payment_terms=XXXX
&partner_point_of_sale=XXXX&platform_name=XXXX
TR3 – Dados de cobrança
TR3a) Nome do pagante
Para cliente, cartão corporativo e virtual:
- Os parceiros devem enviar o nome do titular do cartão cujo cartão está sendo cobrado pelo Expedia Group.
Para parceiros Affiliate Collect/EAC:
- Sempre que possível, o Expedia Group recomenda fortemente que os parceiros enviem o nome do pagador final da reserva.
- Essas informações são necessárias para fins de triagem regulatória ou sanções.
- Se não for possível fornecer o nome do pagador final, informe o nome da empresa/entidade legal do parceiro que paga o Expedia Group.
Observação: Se o POS for Rússia, Ucrânia ou Venezuela, informações verdadeiras do pagador serão sempre necessárias.
TR3b) País de cobrança
- Deve representar o nome individual passado no campo de contato para cobrança ou nome do pagante.
TR3c) CEP de cobrança
- Deve representar o nome individual passado no campo de contato para cobrança ou nome do pagante.
Observação: Para países que não mantêm um código postal, essas informações não precisam ser fornecidas.
"payments": [
{
"type": "customer_card",
"billing_contact": {
"given_name": "Launch_Requirement_TR3a",
"family_name": "Launch_Requirement_TR3a",
"address": {
"line_1": "555 1st St",
"line_2": "10th Floor",
"line_3": "Unit 12",
"city": "Seattle",
"state_province_code": "WA",
"postal_code": "Launch_Requirement_TR3c",
"country_code": "Launch_Requirement_TR3b"
}
},
TR4: Forneça o endereço de e-mail do cliente ou a caixa de correio de e-mail monitorada
O elemento de e-mail de cada itinerário deve conter o endereço de e-mail do viajante ou a caixa de entrada monitorada pela sua integração para o processamento dos e-mails de confirmação. Isso é necessário para casos de disputas de reserva ou solução de problemas.
TR5: Fornecer informações precisas ao viajante
TR5a) Nome do viajante
As reservas do Expedia Group devem sempre ser enviadas com o nome dos viajantes que se hospedarão em cada quarto reservado. Isso significa que no corpo da sua solicitação de reserva os valores paragiven_name
efamily_name
dentro do objeto rooms deve corresponder ao primeiro e último nome do hóspede principal que faz check-in em cada quarto.
TR5b) Número de telefone do viajante
A reserva deve incluir um número de contato funcional do viajante. Inclua esse número no campo de telefone da solicitação de reserva de cada itinerário. O Expedia Group não entrará em contato com o viajante se os agentes do parceiro fornecerem suporte direto aos clientes finais.
TR6 – Reservas de vários quartos
Se as reservas de vários quartos forem compatíveis, forneça os registros de solicitação e resposta da API para uma reserva de teste que mostre que cada quarto foi reservado e cancelado.
Cada quarto reservado cria um ID de confirmação diferente, que permite que os quartos sejam cancelados separados. Para cancelar todos os quartos, faça uma chamada de cancelamento para cada ID de confirmação no itinerário.
O Expedia Group não oferece diretamente reservas de grupos com mais de 8 quartos por meio de nossa API ou modelo. Seu representante do Expedia Group pode aconselhá-lo caso você precise reservar mais de 8 quartos.
TR7: Recomendações rápidas de tratamento de erros
Confirme que você leu as nossas recomendações de tratamento de erros da Rapid e implementou a lógica necessária para a sua aplicação.