Guia de integração da Vrbo na Rapid

Informações sobre o processo de integração da Vrbo para parceiros.

Visão geral

Este artigo traz orientações sobre o processo de integração da Vrbo na Rapid, incluindo como funciona, exemplos de solicitações e respostas da API e informações sobre limitações, tratamento de erros e perguntas frequentes.

Este guia é voltado para as nossas ofertas recomendadas da Vrbo. Para casos de uso avançados, consulte o guia avançado de integração abaixo.

|

Geografia

O que você precisa saber

  • Parceiros que usam APIs de geografia para Rapid e estão habilitados para Vrbo também podem acessar os IDs de propriedade da Vrbo de todas as APIs de geografia, além de propriedades de acomodação convencional.

Tópico principal: mapeamento

  • Só é possível visualizar os endereços das propriedades depois que uma reserva é feita.
  • Parceiros devem usar a latitude e a longitude da API de conteúdo em conjunto com a sua própria solução geográfica para mapear propriedades.
  • Para as propriedades que tiverem solicitado privacidade, a latitude e a longitude ficam ofuscadas na exibição do mapa, mas podem ser usadas para a busca, desde que a localização exata da propriedade não seja exibida para hóspedes.

Principais diferenças em relação à hospedagem da Rapid

  • Parceiros podem solicitar respostas de geografia da Vrbo e de hospedagem da Rapid, apenas da Vrbo (usando supply_source=vrbo em um perfil habilitado) ou apenas de hospedagem da Rapid (usando supply_source=expedia). Se supply_source não for fornecido, as APIs de geografia para Rapid vão usar o padrão expedia.

Perguntas frequentes de geografia

P. Posso filtrar as APIs de geografia para que retornem apenas propriedades da Vrbo ou que não são da Vrbo?
R. Sim. Parceiros podem filtrar usando supply_source=vrbo. Se o perfil não tiver permissão para acessar o inventário da Vrbo, nenhum resultado vai ser retornado.

Conteúdo

O que você precisa saber

  • O conteúdo da Vrbo é fornecido por meio das mesmas APIs de conteúdo para Rapid que outras hospedagens da Rapid ao usar supply_source=vrbo, mas com as diferenças descritas no esquema abaixo.

Principais diferenças em relação à hospedagem da Rapid

Campos específicos da Vrbo:

APIDescrição
Arquivo de conteúdoAs propriedades da Vrbo são fornecidas em um arquivo de conteúdo separado de outras hospedagens da Rapid.
CampoDescrição
vacation_rental_details:registry_numberCampo obrigatório para exibir propriedades de aluguel por temporada. Para mais informações, consulte os requisitos de lançamento.
private_host_property (ID do atributo: 1073745102)Obrigatório para exibição, além das descrições adicionais obrigatórias. Para mais informações, consulte os requisitos de lançamento.
professional_host_property (ID do atributo: 1073745142)Obrigatório para exibição, além das descrições adicionais obrigatórias. Para mais informações, consulte os requisitos de lançamento.
statisticsInclui informações específicas da unidade de aluguel por temporada, como ocupação máxima, número de quartos, número de banheiros, número de unidades (1 para propriedades de aluguel por temporada de uma unidade) e área da propriedade (em pés e metros quadrados). Deve ser usado para exibir um resumo das principais informações da propriedade nos resultados da busca e na parte superior da página de detalhes da propriedade.
Número de quartos e banheirosO atributo 1073743378, Número de quartos, indica o número de quartos dentro da unidade. O atributo 1073743379, Número de banheiros, indica o número de banheiros dentro da unidade.
vacation_rental_details:property_managerInclui o nome do gerente, imagens e idiomas falados na propriedade, quando disponíveis. Deve ser usado para apresentar o hóspede ao anfitrião que administra a propriedade. As informações de contato são fornecidas após a conclusão da reserva, como parte do conteúdo essencial da estadia.
vacation_rental_details:unit_configurationsDescreve os tipos e o número de camas em um quarto. Essas informações devem ser usadas para exibir o layout da propriedade para hóspedes e garantir que ela é capaz de acomodar todo o grupo de pessoas da reserva.
vacation_rental_details:house_rulesEsse campo foi desativado. Use vacation_rental_details:enhanced_house_rules.
vacation_rental_details:enhanced_house_rulesAs regras da propriedade aprimoradas incluem informações importantes sobre políticas relativas a animais de estimação, festas, crianças, fumantes, entre outros. additional_information pode incluir detalhes de cada política que sejam essenciais para a estadia do hóspede, como esclarecimentos, códigos de acesso, senhas, imagens e taxas cobradas pela estadia (como impostos de turismo da cidade ou cobranças de consumo). Para mais informações, consulte o guia de conteúdo essencial para a estadia da Vrbo.
vacation_rental_details:rental_agreementFornece o link de um PDF ou site disponibilizado pelo gerente da propriedade que deve ser exibido na página de check-out. Também pode ser exigido que hóspedes assinem e devolvam ou enviem o contrato de locação.
vacation_rental_details: free_textEste é um campo de texto livre fornecido pelo anfitrião que destaca os atributos ou experiências únicas que estão disponíveis para hóspedes na propriedade. Essa descrição também pode incluir atrações próximas, serviços opcionais disponibilizados pelo anfitrião ou outras informações importantes (como avisos sobre obras, ruído, condições da água, acesso à pista de esqui, estacionamento etc.) que hóspedes devem saber antes de fazer a reserva. Esta seção pode ser bastante extensa. Por isso, é importante prestar atenção à exibição deste campo na interface do usuário, em especial no caso de dispositivos móveis.

Quando este campo não estiver presente, parceiros devem usar Descriptions.General.
descriptions.generalFornece uma descrição gerada por máquina da propriedade de aluguel por temporada com base nos atributos, nas comodidades e na localização da propriedade. Este texto não inclui orientações nem informações do anfitrião. Este campo é mais relevante para propriedades de acomodação convencional. Este campo deve ser usado quando não houver vacation_rental_details.free_text.
traveler_service_feeEsse campo foi desativado. Não usar. Consulte os requisitos de lançamento para ver o texto de exibição de check-out recomendado.

Campos que não são relevantes para propriedades da Vrbo:

CampoDescrição
Classificação da propriedadeNo momento, as classificações não estão disponíveis para propriedades da Vrbo. Em vez disso, podem ser usadas as pontuações das avaliações de hóspedes.
Descrição do quartoNão é relevante para propriedades de aluguel por temporada de uma unidade. Em vez disso, devem ser utilizadas informações sobre o quarto.
Plano tarifárioNão é relevante para propriedades da Vrbo.
Informações sobre o quartoTodas as informações referentes ao quarto estão disponíveis na descrição da propriedade. Como não há conteúdo relacionado aos quartos para as propriedades da Vrbo, as comodidades que costumam ficar nesses espaços são incluídas em uma nova seção chamada vacation_rental_details.
vrbo_srp_id, listing_id, listing_number, listing_source, listing_unitEstes campos são relevantes apenas para o modelo Vrbo link-off, mas também podem ser usados para mapeamento/correspondência de propriedades.
IPM_NameSó parceiros que fazem parte do período de teste de administradores integrados da Vrbo têm acesso. O valor fornece o nome do administrador integrado, que deve ser comunicado ao hóspede como o intermediário responsável pela cobrança no cartão e pelo envio de e-mails sobre a estadia.

Perguntas frequentes sobre conteúdo

P. Como faço para mapear conteúdo da Vrbo se o endereço não é fornecido pelo conteúdo da Rapid?
R. Você pode usar a Rapid API de geografia e/ou os valores de latitude e longitude das propriedades para incluir a localização geográfica delas.


P. As propriedades da Vrbo estão incluídas nos arquivos de conteúdo da Rapid?
R. Sim, mas em um arquivo de conteúdo específico da Vrbo ao usar supply_source=vrbo na solicitação da API.


P. As propriedades da Vrbo estão disponíveis em todos os idiomas?
R. Sim, mas alguns campos de texto livre que o anfitrião preenche não estão traduzidos.


P. Tenho hóspedes que não conhecem a Vrbo. É obrigatório exibir a marca Vrbo em todas as regiões?
R. A exibição é obrigatória, mas é permitido substituir pelas marcas locais da Vrbo na Alemanha, na França, na Austrália e na Nova Zelândia. Consulte o Apêndice 2 abaixo.


P. Sem bed_groups, como descrevo os tipos de cama em cada quarto?
R. Consulte unit_configurations, que retorna conteúdo fornecendo um tipo de cama e uma descrição do quarto.

Compras

O que você precisa saber

  • As propriedades da Vrbo são propriedades inteiras, sem acomodações compartilhadas.
  • As propriedades da Vrbo são apenas de uma unidade.
  • As propriedades da Vrbo retornam apenas um plano tarifário único.
  • As propriedades com depósitos caução devem ser excluídas usando exclusion=refundable_damage_deposit na solicitação de compra. Consulte o guia avançado de integração para mais informações importantes sobre como habilitar essas propriedades.
  • Propriedades com políticas de depósito são excluídas. Consulte o guia avançado de integração abaixo para ver mais detalhes.
  • Não é possível fazer reservas para o mesmo dia. Uma mensagem de indisponibilidade é retornada.

Tópico principal: merchant_of_record para reservas da Vrbo

O campo merchant_of_record em compras da Rapid tem um significado diferente para a Vrbo nas propriedades da Rapid e não deve ser usado no momento.

  • Ele não representa quem vai fazer a cobrança no cartão fornecido com a reserva.
  • Ele não indica o momento do pagamento (pay_now ou pay_later).

Tópico principal: códigos de país para reservas da Vrbo

O código do país especificado na solicitação de compra deve corresponder ao país de cobrança do cartão virtual do parceiro.

  • Quando não houver correspondência, pode ocorrer um erro na reserva devido a diferentes requisitos de cobrança de IVA. Consulte o guia avançado de integração para mais detalhes.

Tópico principal: códigos de moeda para reservas da Vrbo

A moeda especificada na solicitação de compra não afeta a moeda de cobrança da reserva.

  • Não é possível especificar a moeda para uma reserva da Vrbo. A moeda de cobrança sempre corresponde à moeda da propriedade.

Principais diferenças em relação à hospedagem da Rapid

Campos específicos da Vrbo:

TaxaDescrição
property_feeDescreve o valor total das taxas da propriedade para a reserva, incluindo taxas de limpeza, de administração, de hóspede adicional, entre outras.
traveler_service_feeTaxa de serviço cobrada pela Vrbo para facilitar a reserva e oferecer suporte. Se alguma parte da reserva não for reembolsável, essa taxa também não vai ser. Para ver mais informações sobre a exibição, consulte os requisitos de lançamento.

Taxas de serviço do viajante e seleção de país da compra na Rapid: quando uma propriedade da Vrbo inclui uma taxa de serviço do viajante na resposta de preço, o valor inclui o IVA correspondente ao país usado na solicitação de compra da Rapid. Para fazer uma reserva bem-sucedida, parceiros devem garantir que o país da solicitação de compra corresponda ao país do pagamento que vai ser usado no check-out.

Campos que não são relevantes para propriedades da Vrbo:

CampoDescrição
ID do quartoO nome do quarto e o ID da tarifa não se aplicam ao inventário da Vrbo e não devem ser exibidos.
Quartos disponíveisSempre 0 para propriedades da Vrbo. Este campo não deve ser usado para indicar urgência.
Grupos de camasNão se aplica à Vrbo, pois nenhuma seleção ou preferência está disponível.
ID e descrição da promoçãoNão aplicável ao inventário da Vrbo.

Perguntas frequentes sobre compras

P. Como são classificadas as propriedades da Vrbo?
R. Você pode usar a pontuação ou o número de avaliações de hóspedes, quando houver. Caso contrário, o seu contato do Partner Connect na EPS pode compartilhar uma lista de propriedades qualificadas para o programa Anfitrião Premium da Vrbo. Ao usar esse indicador, os parceiros podem identificar propriedades administradas por anfitriões qualificados para o programa Anfitrião Premium e usar o programa para influenciar a ordem de exibição das propriedades.

P. Como posso permitir que hóspedes façam buscas com animais de estimação?
R. No momento, a Rapid não oferece a capacidade de filtrar por política de animais de estimação ou fornecer preços com taxa de animais de estimação. Os parceiros podem identificar propriedades que permitem animais de estimação com base nos atributos de conteúdo da propriedade, e hóspedes podem consultar as políticas específicas quanto a isso. Os anfitriões podem fornecer informações adicionais sobre políticas de animais de estimação dentro de vacation_rental_details.free_text ou enhanced_house_rules, que podem fornecer informações mais detalhadas e precisas sobre políticas específicas de animais de estimação.

P. Posso fazer buscas por estadias prolongadas (ou seja, mais de 28 diárias)?
R. Não, a Rapid limita as pesquisas a um máximo de 28 diárias no momento.

P. Por que não vejo o mesmo detalhamento de taxas na Rapid e na Vrbo.com?
R. A Rapid não consegue dividir a taxa da propriedade em componentes específicos no momento. Esses componentes podem incluir taxas de limpeza, de administração, de hóspede adicional, entre outras, que são todas combinadas em property_fees.

P. Vejo propriedades retornando merchant_of_record=expedia ou merchant_of_record=property, e isso muda dependendo da data.
R. Não é possível reservar algumas ofertas da Vrbo como Merchant, apenas como Property Collect. Como resultado, quando as compras incluem apenas ofertas Merchant, algumas propriedades disponíveis na Vrbo não são retornadas. A única maneira de comprar e reservar essas propriedades é incluir também Property Collect na solicitação de compra.

P. Posso fazer pacotes com inventário da Vrbo?
R. Sim. No entanto, a Vrbo oferece apenas tarifas independentes no momento. Além disso, se o hóspede acessar a própria conta da Vrbo, vai ver os detalhes da transação financeira, inclusive o valor pago.

P. As propriedades da Vrbo se qualificam para ofertas somente para associados?
R. No momento, não.

P. Posso ativar a comunicação do hóspede com o anfitrião durante a fase de compras, antes do check-out?
R. No momento, não.

P. Vou ver a taxa de marketing correta na resposta de disponibilidade?
R. Consulte as estimativas de gross_profit e faça os cálculos com base no seu contrato.

P. As tarifas da Vrbo na Rapid vão ser consistentes com as tarifas dos sites da Vrbo e do Expedia Group?
R. Os preços do inventário da Vrbo na Rapid devem refletir os que aparecem no site da marca Expedia Group, mas podem ser diferentes dos preços mostrados na Vrbo. Isso normalmente tem base no cálculo da taxa de serviço e pode variar para mais ou para menos. Além disso, o acúmulo de taxas da propriedade pode ser um pouco diferente por marca.

Reservas e pagamento

O que você precisa saber

  • Parceiros devem informar os dados de contato do hóspede (nome, telefone e e-mail) junto com cada reserva para facilitar a comunicação entre anfitrião e hóspede.
  • A Vrbo tem requisitos mais rígidos a respeito de quais países precisam incluir os códigos postais e estaduais com a reserva. Mais detalhes no guia avançado de integração abaixo.
  • Quando os contratos de locação são fornecidos no conteúdo, eles devem aparecer na página de pagamento. Para ver mais informações, consulte os requisitos de lançamento.
  • As reservas da Vrbo feitas por meio da Rapid API exigem um cartão virtual para o pagamento. Parceiros que desejam enviar cartões de crédito de clientes devem consultar o guia avançado de integração.
  • As moedas de cobrança são predefinidas para as propriedades da Vrbo. Por isso, é importante prestar atenção aos limites de crédito do cartão virtual. Parceiros devem garantir que os cartões virtuais reflitam possíveis diferenças de taxa de câmbio e encargos bancários internacionais para evitar erros de reserva por fundos insuficientes.
  • No momento, o Expedia Affiliate Collect (EAC) não é compatível com reservas da Vrbo feitas pela Rapid. As propriedades que exigem vários pagamentos não estão qualificadas para o parceiro merchant of record. Consulte o guia avançado de integração para mais informações sobre como habilitar essas propriedades.
  • No momento, as solicitações especiais não são repassadas para a propriedade.

Tópico principal: dano à propriedade

Cartão cadastrado:

  • O cartão de crédito cadastrado indica que a Vrbo tem o direito de realizar cobranças no cartão informado até o valor retornado da compra na Rapid depois da saída do hóspede, caso tenha causado dano à propriedade. A Vrbo envia um resumo dos danos e uma fatura ao hóspede quando são feitas reclamações. Em caso de falha de cobrança no cartão informado na reserva, a Vrbo entra em contato com o hóspede e solicita o pagamento pelo site da Vrbo.
  • É necessário informar os hóspedes sobre o valor que a propriedade pode cobrar em caso de danos durante a estadia. Essa informação é retornada na resposta de compra, no objeto card_on_file_limit.

Tópico principal: códigos de moeda para reservas da Vrbo

A moeda especificada na solicitação de compra não afeta a moeda de cobrança da reserva.

  • Não é possível especificar a moeda para uma reserva da Vrbo. A moeda de cobrança sempre corresponde à moeda da propriedade.
  • Os cartões virtuais devem ser configurados com uma margem suficiente para cobrir as taxas de câmbio internacionais cobradas pelo banco parceiro.

Principais diferenças em relação à hospedagem da Rapid

Campos específicos da Vrbo:

CampoDescrição
Estado/provínciaOs requisitos diferem de outros inventários de hotéis da Rapid. Veja mais informações abaixo.
CEPOs requisitos diferem de outros inventários de hotéis da Rapid. Veja mais informações abaixo.

Campos que não são relevantes para propriedades da Vrbo:

RecursoDescrição
Espera e retomadaNo momento, não é compatível com reservas da Vrbo feitas pela Rapid.
Solicitação especialAs solicitações especiais não podem ser comunicadas à propriedade no momento. Hóspedes devem se comunicar com a propriedade após a reserva para fazer solicitações especiais.
Instruções de atendimento ao viajanteIncompatível com reservas da Vrbo no momento.

Perguntas frequentes sobre reservas e pagamento

P. Quais informações do hóspede precisam ser enviadas com o pedido de reserva?
R. Todas as reservas da Vrbo na Rapid exigem o e-mail e o número de telefone do hóspede para permitir a comunicação com o anfitrião. Isso é fundamental, pois os anfitriões podem fornecer informações relacionadas à estadia por e-mail após a reserva ou antes da chegada do hóspede, inclusive combinações para encontrar o hóspede na chegada ou códigos de acesso para as portas.

Pós-reserva

Após a conclusão de uma reserva da Vrbo por meio da Rapid API, parceiros devem fornecer orientação a hóspedes sobre a experiência pós-reserva. Os tópicos de orientação sugeridos incluem:

O que esperar

  • O anfitrião pode enviar mensagens a hóspedes (veja abaixo exemplos de tópicos). Esses e-mails vêm da Vrbo (ou da marca local da Vrbo).
  • Como entrar em contato com o anfitrião usando as informações de contato fornecidas no conteúdo essencial sobre a estadia da Rapid.

Como gerenciar reservas

  • Hóspedes podem cancelar reservas por meio do site parceiro, com base na API de cancelamento da Rapid.
  • Hóspedes podem solicitar alterações ao anfitrião ou canal de suporte, ou então cancelar e refazer a reserva (recomendado).

Se houver um problema

  • Informe aos hóspedes como entrar em contato com o suporte (parceiro, serviço de suporte a clientes ou Vrbo).
  • Oriente hóspedes a entrarem em contato com o suporte de imediato quando surgir um problema em vez de esperar o fim da estadia, pois a Vrbo não pode resolver problemas após a partida.
  • Parceiros devem considerar a possibilidade de fornecer um link para a página de login do site da Vrbo. É solicitado que hóspedes insiram o seu e-mail e criem uma senha. Depois de fazer login, hóspedes têm acesso aos recursos de gerenciamento de reservas descritos abaixo.

Observação: é preciso informar aos hóspedes o número de confirmação da Vrbo (HA-########), pois ele é a única referência disponível para o anfitrião e o suporte da Vrbo, além de ser mencionado em todos os e-mails da Vrbo.

Principais diferenças em relação à hospedagem da Rapid

Campos específicos da Vrbo:

CampoDescrição
Conteúdo essencial para a estadiaRepresenta o guia de boas-vindas da Vrbo e deve ser fornecido ao hóspede após a criação da reserva. Para mais informações, consulte o guia de conteúdo essencial para a estadia da Vrbo.

Campos que não são relevantes para propriedades da Vrbo:

CampoDescrição
Valor de reembolso no cancelamentoIndisponível para reservas da Vrbo feitas pela Rapid.
Token de conversaIndisponível para reservas da Vrbo feitas pela Rapid.
Alterações secundáriasIncompatível com reservas da Vrbo. Hóspedes devem solicitar alterações direto ao anfitrião por e-mail ou entrar em contato com o suporte.
Alterações principaisIncompatível com reservas da Vrbo. Hóspedes devem solicitar alterações direto ao anfitrião por e-mail ou entrar em contato com o suporte.

Perguntas frequentes sobre o período pós-reserva

P. Quais e-mails o hóspede vai receber da Vrbo?
R. Hóspedes recebem um e-mail de confirmação de reserva da marca Vrbo. Também podem receber um e-mail com o Guia de boas-vindas da Vrbo antes da chegada.

P. Quais e-mails o hóspede vai receber do anfitrião (por meio da Vrbo)?
R. Hóspedes recebem conversas do anfitrião no e-mail cadastrado para durante a criação da reserva. As conversas podem incluir informações importantes para a chegada e a experiência do hóspede na propriedade, além de servir como um canal de comunicação durante a estadia.

P. É possível cancelar as reservas da Vrbo na Rapid por meio da Rapid API de cancelamento?
R. Sim, todas as reservas da Vrbo feitas pela Rapid podem ser canceladas usando o token de cancelamento na resposta de itinerário da Rapid. Como alternativa, hóspedes podem solicitar o cancelamento ao gerente da propriedade, ao suporte da Vrbo ou à página de gerenciamento de reservas da Vrbo.

P. Quais recursos a Vrbo oferece pós-reserva no seu site?
R. A Vrbo oferece ferramentas de gerenciamento de reservas no site, que hóspedes podem acessar usando um e-mail e criando uma senha. A maioria desses recursos também está disponível por meio de conversas via Rapid ou entre anfitrião e hóspede:

  • Alterações na reserva:
    • Solicitar cancelamento. Hóspedes também podem cancelar reservas no site parceiro por meio da API de cancelamento da Rapid.
    • Solicitar alterações na reserva (a solicitação é enviada ao gerente da propriedade). Hóspedes também podem solicitar alterações de maneira direta ao anfitrião por meio de conversas ou e-mails.
    • Ver oferta de seguro.
  • Informações sobre a propriedade e chegada.
    • Ver informações sobre a chegada. Esses dados também estão disponíveis no guia essencial para a estadia na API de itinerário da Rapid para que parceiros se comuniquem com hóspedes.
    • Falar com o gerente da propriedade por mensagem. Hóspedes também podem responder aos e-mails do anfitrião.
    • Ver nome do gerente da propriedade. Esses dados também estão disponíveis no guia essencial para a estadia na API de itinerário da Rapid para que parceiros se comuniquem com hóspedes.
  • Ver dados de pagamento:
    • Ver calendário de pagamentos. Essas informações também são fornecidas aos parceiros para exibição ao hóspede antes e após a reserva.
    • Visualizar/baixar fatura/recibo do IVA.

P. Como é possível alterar as reservas da Vrbo?
R. É recomendável que hóspedes cancelem e refaçam a reserva, mas é possível solicitar alterações nas reservas da Vrbo por meio de comunicações com o anfitrião, iniciando uma solicitação de alteração por meio do suporte ou das ferramentas de reserva da Vrbo.

P. Eu vou receber notificações da Rapid sobre alterações ou cancelamentos de reservas?
R. Os parceiros inscritos nas notificações da Rapid vão receber notificações quando houver o cancelamento de uma reserva, mas, no momento, não podemos diferenciar entre cancelamentos de fornecedores e cancelamentos solicitados pelo usuário. Alterações nas reservas não geram notificações.

P. Como os hóspedes acessam as ferramentas de gestão de reservas da Vrbo, e o que eles podem fazer lá?
R. Os hóspedes recebem um e-mail de confirmação de reserva com links para gerenciar a reserva. Ao entrar no site da Vrbo, eles precisam criar uma conta usando o e-mail fornecido com a reserva. Os hóspedes podem visualizar a reserva, iniciar conversas com o anfitrião, baixar uma fatura de taxa de serviço, cancelar ou solicitar o cancelamento da reserva, solicitar a alteração da reserva, iniciar um pagamento agendado e compartilhar a viagem com outras pessoas.

P. As conversas com anfitriões da Vrbo funcionam com a Central de mensagens da propriedade?
R. No momento, não.

P. Como os hóspedes recebem as informações de check-in?
R. Consulte o guia de conteúdo essencial para a estadia da Vrbo. No momento, a Vrbo envia um guia de boas-vindas ao hóspede cerca de três dias antes da chegada. O conteúdo do guia de boas-vindas depende do nível de detalhes fornecido pelo anfitrião. Anfitriões também podem optar por enviar informações essenciais sobre a estadia em formato de conversa para o e-mail fornecido pelo hóspede no momento da reserva. Para garantir o recebimento dessas informações, parceiros devem fornecer ao hóspede o conteúdo essencial para a estadia. As comunicações transacionais da Vrbo vão ser omitidas no futuro.

P. A propriedade pode cancelar uma reserva Vrbo depois de confirmada?
R. Sim, os gerentes de propriedade podem cancelar uma reserva Vrbo a qualquer momento entre a reserva e a chegada do hóspede. Muitas vezes, isso acontece um dia após a criação da reserva, quando o gerente percebe que a propriedade não está mais disponível nessa data. Se isso acontecer antes da chegada do hóspede, a Garantia Reserve com Segurança da Vrbo significa que o suporte da Vrbo vai ajudar o hóspede com acomodações temporárias durante a busca uma propriedade de aluguel por temporada equivalente. A frequência de cancelamento é um fator determinante na qualificação para Anfitrião Premium, além de afetar a veiculação da propriedade nos resultados de busca. Por isso, gerentes das propriedades evitam fazer cancelamentos, a menos que sejam necessários.

Guia avançado de integração

Situação 1: depósitos caução reembolsáveis (RDD)

Algumas propriedades da Vrbo exigem a cobrança de um depósito caução antes da chegada, fornecendo um reembolso após a partida com base nas condições da propriedade.

Sobre RDDs

  • A solicitação de RDDs por parte das propriedades pode aumentar durante períodos de alta demanda, como feriados.
  • Cerca de 2% das propriedades exigem um depósito caução reembolsável antes da chegada.
  • O valor e a obrigatoriedade do RDD podem variar de acordo com a localização geográfica e a época do ano.

Hóspedes devem ser informados

  • O pagamento do depósito caução é feito com o último pagamento agendado (ou no ato da reserva em caso de pagamento único).

Exemplo de RDD

  • O reembolso do depósito caução é feito em até 12 dias após a partida, com base na inspeção do anfitrião.
  • Caso tenha ocorrido algum dano, a Vrbo envia uma fatura ao hóspede.
  • O valor do depósito caução reembolsável deve ser exibido no check-out.
  • O valor do RDD exibido na compra da Rapid é uma estimativa. O valor da verificação de preço da Rapid é o que vai ser cobrado do hóspede e deve ser apresentado no momento do check-out.

Parceiro merchant of record:

  • Recomendamos que os RDDs sejam excluídos quando o parceiro oferecer pagamento por cartão virtual, a menos que possam facilitar a cobrança e o reembolso do depósito caução para o hóspede.
  • Parceiros são responsáveis por exibir o valor ao hóspede e fazer a cobrança ou o reembolso da maneira adequada.

Exemplo:

"rates": [
    {
        "refundable_damage_deposit": {
            "value": "150.00",
            "currency": "USD"
        }  
    }
]

Situação 2: cartão de crédito do cliente

O uso de cartões de crédito do cliente requer validação adicional e maior comunicação com o hóspede.

Validação do endereço

  • As reservas da Vrbo exigem uma validação de endereço diferente da exigida pela hospedagem da Rapid.

Veja abaixo os detalhes:

Países com códigos postaisPaíses sem códigos postaisPaíses com códigos postais e detalhes adicionais
countries-with-postal-codescountries-without-postal-codescountries-with-postal-codes-and-additional-details
AfeganistãoAngolaAustrália: estado
Ilhas ÅlandAntígua e BarbudaBrasil: estado (+ bairro no ponto de venda BR) e CPF/CNPJ
AlbâniaArubaCanadá: província
Samoa AmericanaBahamasJapão: linha de estado e endereço 2
AndorraBelizeEspanha: identificação nacional
AnguilaBenimEstados Unidos: estado
AntártidaBotsuana
ArgentinaBurkina Faso
ArmêniaBurundi
ÁustriaCamarões
AzerbaijãoRepública Centro-Africana
BahrainComores
BangladeshCongo
BarbadosRepública Democrática do Congo
BelarusIlhas Cook
BélgicaCosta do Marfim
BermudaDjibouti
ButãoDominica
Estado Plurinacional da Bolívia†Guiné Equatorial
Bósnia e HerzegovinaEritreia
Ilha BouvetFiji
Território Britânico do Oceano ÍndicoTerritórios Franceses do Sul
BruneiGâmbia
BulgáriaGana
CambojaGranada
Cabo VerdeGuiné
Ilhas CaymanGuiana
ChadeHong Kong
ChileIrlanda††
ChinaQuênia
Ilha ChristmasKiribati
Ilhas CocosMacau
ColômbiaMalawi
Costa RicaMali
CroáciaMauritânia
CubaIlhas Maurício
ChipreMontserrat
República TchecaNauru
DinamarcaNiue
República DominicanaPanamá
EquadorCatar
EgitoRuanda
El SalvadorSão Cristóvão e Névis
EstôniaSanta Lúcia
EtiópiaSão Tomé e Príncipe
Ilhas MalvinasSeychelles
Ilhas FaroéSerra Leoa
FinlândiaIlhas Salomão
FrançaSomália††
Guiana FrancesaÁfrica do Sul††
Polinésia FrancesaSuriname
GabãoSíria
GeórgiaTanzânia
AlemanhaTimor-Leste
GibraltarToquelau
GréciaTonga
GroenlândiaTrinidad e Tobago
GuadalupeTuvalu
GuamUganda
GuatemalaEmirados Árabes Unidos
Guiné-BissauVanuatu
HaitiIêmen
Ilhas Heard eMcDonald†Zimbábue
Santa Sé (Cidade do Vaticano)
Honduras
Hungria
Islândia
Índia
Indonésia
Irã
Iraque
Israel
Itália
Jamaica
Jordânia
Cazaquistão
Coreia do Sul
Kuwait
Quirguistão
Laos
Letônia
Líbano
Lesoto
Libéria
Líbia†
Liechtenstein
Lituânia
Luxemburgo
República da Macedônia do Norte
Madagascar
Malásia
Maldivas
Malta
Ilhas Marshall
Martinica
Maiote
México
Federação dos Estados da Micronésia
Moldávia
Mônaco
Mongólia
Montenegro
Marrocos
Moçambique
Mianmar
Namíbia
Nepal
Países Baixos
Nova Caledônia
Nova Zelândia
Nicarágua
Níger
Ilha Norfolk
Ilhas Marianas do Norte
Noruega
Omã
Palau
Estado da Palestina
Papua Nova Guiné
Paraguai
Peru
Filipinas
Ilha Pitcairn
Polônia
Portugal
Porto Rico
Reunião
Romênia
Federação Russa
São Bartolomeu
Santa Helena, Ascensão e Tristão da Cunha
Saint-Pierre e Miquelon
São Vicente e Granadinas
Samoa
San Marino
Senegal
Sérvia
Sérvia e Montenegro
Singapura
Eslováquia
Eslovênia
Ilhas Sandwich do Sul e Geórgia do Sul
Sri Lanka
Sudão
Svalbard e Jan Mayen
Suazilândia
Suécia
Suíça
Taiwan, Província da China
Tajiquistão
Tailândia
Togo†
Tunísia
Turquia
Turcomenistão
Ilhas Turks e Caicos
Ucrânia
Reino Unido
Ilhas Menores Distantes dos Estados Unidos
Uruguai
Uzbequistão
Venezuela
Vietnã
Ilhas Virgens Britânicas
Ilhas Virgens Americanas
Wallis e Futuna
Saara Ocidental
Zâmbia

†Países com disponibilidade parcial de CEPs/códigos postais, mas mantidos como obrigatórios no check-out da Vrbo.
††Países com disponibilidade parcial de CEPs/códigos postais, mas que não mantemos como obrigatórios.

Hóspedes devem ser informados

  • Descrição de quem vai fazer a cobrança no cartão.
  • Cobranças bancárias: é importante lembrar hóspedes que os seus bancos podem cobrar taxas sobre transações internacionais.
  • Reembolsos: é importante lembrar hóspedes que as flutuações da taxa de câmbio podem afetar o valor do reembolso.

Danos: deve-se informar hóspedes sobre o valor máximo da cobrança e o momento em que a cobrança e/ou o reembolso são feitos

  • O valor máximo da cobrança é fornecido na resposta da compra na Rapid, em refundable_damage_deposit.
  • O valor é cobrado no cartão do hóspede se há danos à propriedade até o valor máximo especificado.
  • Caso tenha ocorrido algum dano, a Vrbo envia uma fatura ao hóspede.

Erro de reserva: o país da compra é diferente do país do cliente (endereço de cobrança)

O preço de uma propriedade da Vrbo pode variar de acordo com a localização do hóspede. O endereço de cobrança informado pelo hóspede durante o check-out determina a localização. Como resultado, os parceiros devem detectar essa incompatibilidade antes de enviar a reserva, para evitar que ocorra um erro. Se os países forem diferentes, os parceiros devem obter um novo preço com base no país de cobrança do hóspede.

Opção 1: antes de enviar a reserva, os parceiros devem comparar o país da compra com o país de cobrança do hóspede. Se eles forem diferentes, é preciso refazer a compra usando o país do endereço de cobrança, mostrar o preço atualizado e permitir que o hóspede refaça a reserva.

Opção 2: limitar os campos de endereço de cobrança na página de check-out apenas ao país do ponto de venda.

Situação 3: calendário de pagamentos

Às vezes, as propriedades da Vrbo cobram o pagamento com base em um calendário predefinido.

Sobre depósitos (calendários de pagamentos)

  • Cerca de 25% das propriedades fornecem um calendário de pagamentos para antecedências superiores a três meses.
  • Cerca de 15% das propriedades fornecem um calendário de pagamentos para antecedências inferiores a um mês.

Hóspedes devem ser informados

  • Os detalhes do calendário de pagamentos devem ser mostrados durante a compra/o check-out. O ideal é que isso seja feito em uma exibição visual da linha do tempo.

Exemplo:

"deposits": [
              {
               "value": "412.10",
               "due": "2023-05-17",
               "currency": "USD"
              },
              {
               "value": "236.17",
               "due": "2023-08-24",
               "currency": "USD"
              }
             ]

payment-schedule-example


  • Deve-se informar a hóspedes que são responsáveis por efetuar o pagamento no site da Vrbo de acordo com o calendário fornecido e que, caso não façam isso, o anfitrião pode o cancelar a reserva.
  • A Vrbo envia lembretes por e-mail antes, na data e após a data de vencimento do pagamento para garantir que o hóspede esteja ciente dessa exigência.

Em combinação com depósitos caução reembolsáveis:

  • Quando o RDD for exigido, ele será cobrado como parte do último pagamento agendado. Em caso de pagamento único, o RDD é cobrado no ato da reserva.

Em combinação com parceiro merchant of record:

  • Devido à exigência de pagamento manual na Vrbo.com, não recomendamos que propriedades com calendários de pagamentos sejam reservadas como merchant of record.

Apêndice 1: comunicações com anfitriões

Todas as reservas da Vrbo devem incluir o e-mail do cliente para facilitar a comunicação direta entre o gerente da propriedade e o viajante. O uso de um e-mail de parceiro/agente corre o risco de cancelamento da reserva pelo anfitrião em alguns casos.

Exemplos de comunicações do gerente da propriedade incluem:

  • Mensagem de boas-vindas e apresentação ao administrador profissional
  • Dados de contato
  • Políticas e informações importantes
  • Endereço e direções
  • Código para o cofre de chaves
  • Agenda de pagamentos
  • Contrato de locação (pode ser necessário para que o administrador profissional não cancele a reserva)
  • Solicitação de envio de foto do passaporte (pode ser necessária para que o administrador profissional não cancele a reserva)
  • Confirmação de cancelamento
  • Confirmação de reembolso

Exemplo:

property-manager-message

Apêndice 2: comunicações com a Vrbo

Os seguintes e-mails da Vrbo são omitidos para reservas feitas por meio da Rapid API:

  • Confirmação de reserva
  • Reserva cancelada por viajantes
  • Reserva cancelada pela propriedade
  • Guia de boas-vindas
  • Revenda
  • Solicitação de avaliação da propriedade
  • Solicitação de avaliação da experiência de suporte
  • Redirecionamento de clientes pós-cancelamento

Modelos de e-mail Vrbo específicos para situações de integração avançadas:

  • Cancelamento devido a fraude
  • Cobrança de depósito caução
  • Recibo de depósito caução
  • Solicitação de depósito caução
  • Pagamento agendado em atraso
  • Recebimento de pagamento
  • Reembolso de pagamento

Modelos de e-mail baseados em interações com hóspedes da Vrbo.com:

  • Viajante solicita cancelamento
  • Anfitrião responde a uma mensagem
  • Viajante envia mensagem ao anfitrião
  • Criação de conta
  • Redefinição de senha
  • Confirmação de redefinição de senha
  • Criação de senha
  • Convite para hóspede
  • Acompanhamento do convite para hóspede
  • Solicitação de pagamento adicional
  • Solicitação de pagamento
  • Pagamento estornado
  • Pagamento off-line enviado
  • Pagamento off-line recebido
  • Confirmação de pagamento
  • Solicitação de cancelamento de pagamento
  • Pagamento cancelado
  • Reserva atualizada
  • Alteração de reserva aceita, sem pagamento
  • Alteração de reserva solicitada
  • Recibo de compra com IVA

Apêndice 3: marcas voltadas para o cliente

Ponto de vendasMarca voltada para o cliente
FrançaAbritel
AlemanhaFewo-Direkt
AustráliaStayz
Nova ZelândiaBookabach
OutrosVrbo
Esta página foi útil?
Como podemos melhorar esse conteúdo?
Agradecemos por nos ajudar a melhorar.