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 (usandosupply_source=expedia
). Sesupply_source
não for fornecido, as APIs de geografia para Rapid vão usar o padrãoexpedia
.
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:
API | Descrição |
---|---|
Arquivo de conteúdo | As propriedades da Vrbo são fornecidas em um arquivo de conteúdo separado de outras hospedagens da Rapid. |
Campo | Descrição |
---|---|
vacation_rental_details:registry_number | Campo 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. |
statistics | Inclui 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 banheiros | O 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_manager | Inclui 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_configurations | Descreve 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_rules | Esse campo foi desativado. Use vacation_rental_details:enhanced_house_rules . |
vacation_rental_details:enhanced_house_rules | As 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_agreement | Fornece 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_text | Este é 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.general | Fornece 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_fee | Esse 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:
Campo | Descrição |
---|---|
Classificação da propriedade | No 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 quarto | Não é relevante para propriedades de aluguel por temporada de uma unidade. Em vez disso, devem ser utilizadas informações sobre o quarto. |
Plano tarifário | Não é relevante para propriedades da Vrbo. |
Informações sobre o quarto | Todas 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_unit | Estes campos são relevantes apenas para o modelo Vrbo link-off, mas também podem ser usados para mapeamento/correspondência de propriedades. |
IPM_Name | Só 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
oupay_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:
Taxa | Descrição |
---|---|
property_fee | Descreve 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_fee | Taxa 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:
Campo | Descrição |
---|---|
ID do quarto | O 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íveis | Sempre 0 para propriedades da Vrbo. Este campo não deve ser usado para indicar urgência. |
Grupos de camas | Não se aplica à Vrbo, pois nenhuma seleção ou preferência está disponível. |
ID e descrição da promoção | Nã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:
Campo | Descrição |
---|---|
Estado/província | Os requisitos diferem de outros inventários de hotéis da Rapid. Veja mais informações abaixo. |
CEP | Os 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:
Recurso | Descrição |
---|---|
Espera e retomada | No momento, não é compatível com reservas da Vrbo feitas pela Rapid. |
Solicitação especial | As 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 viajante | Incompatí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:
Campo | Descrição |
---|---|
Conteúdo essencial para a estadia | Representa 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:
Campo | Descrição |
---|---|
Valor de reembolso no cancelamento | Indisponível para reservas da Vrbo feitas pela Rapid. |
Token de conversa | Indisponível para reservas da Vrbo feitas pela Rapid. |
Alterações secundárias | Incompatí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 principais | Incompatí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).
- 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 postais | Países sem códigos postais | Países com códigos postais e detalhes adicionais |
---|---|---|
![]() | ![]() | ![]() |
Afeganistão | Angola | Austrália: estado |
Ilhas Åland | Antígua e Barbuda | Brasil: estado (+ bairro no ponto de venda BR) e CPF/CNPJ |
Albânia | Aruba | Canadá: província |
Samoa Americana | Bahamas | Japão: linha de estado e endereço 2 |
Andorra | Belize | Espanha: identificação nacional |
Anguila | Benim | Estados Unidos: estado |
Antártida | Botsuana | |
Argentina | Burkina Faso | |
Armênia | Burundi | |
Áustria | Camarões | |
Azerbaijão | República Centro-Africana | |
Bahrain | Comores | |
Bangladesh | Congo | |
Barbados | República Democrática do Congo | |
Belarus | Ilhas Cook | |
Bélgica | Costa do Marfim | |
Bermuda | Djibouti | |
Butão | Dominica | |
Estado Plurinacional da Bolívia† | Guiné Equatorial | |
Bósnia e Herzegovina | Eritreia | |
Ilha Bouvet | Fiji | |
Território Britânico do Oceano Índico | Territórios Franceses do Sul | |
Brunei | Gâmbia | |
Bulgária | Gana | |
Camboja | Granada | |
Cabo Verde | Guiné | |
Ilhas Cayman | Guiana | |
Chade | Hong Kong | |
Chile | Irlanda†† | |
China | Quênia | |
Ilha Christmas | Kiribati | |
Ilhas Cocos | Macau | |
Colômbia | Malawi | |
Costa Rica | Mali | |
Croácia | Mauritânia | |
Cuba | Ilhas Maurício | |
Chipre | Montserrat | |
República Tcheca | Nauru | |
Dinamarca | Niue | |
República Dominicana | Panamá | |
Equador | Catar | |
Egito | Ruanda | |
El Salvador | São Cristóvão e Névis | |
Estônia | Santa Lúcia | |
Etiópia | São Tomé e Príncipe | |
Ilhas Malvinas | Seychelles | |
Ilhas Faroé | Serra Leoa | |
Finlândia | Ilhas Salomão | |
França | Somália†† | |
Guiana Francesa | África do Sul†† | |
Polinésia Francesa | Suriname | |
Gabão | Síria | |
Geórgia | Tanzânia | |
Alemanha | Timor-Leste | |
Gibraltar | Toquelau | |
Grécia | Tonga | |
Groenlândia | Trinidad e Tobago | |
Guadalupe | Tuvalu | |
Guam | Uganda | |
Guatemala | Emirados Árabes Unidos | |
Guiné-Bissau | Vanuatu | |
Haiti | Iê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"
}
]
- 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:
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 vendas | Marca voltada para o cliente |
---|---|
França | Abritel |
Alemanha | Fewo-Direkt |
Austrália | Stayz |
Nova Zelândia | Bookabach |
Outros | Vrbo |