This is an auto-generated translation

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

  • Os parceiros que usam a API de Geografia Rápida e que estão habilitados para o Vrbo também podem acessar os IDs propriedade do Vrbo de todas as APIs de Geografia, além de propriedades de hospedagem convencionais.

Tópico principal: mapeamento

  • Só é possível visualizar os endereços das propriedades depois que uma reserva é feita. Para mais informações, consulte o guia de integração do conteúdo essencial para a estadia.
  • 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 a outras opções de hospedagem

  • Os parceiros podem solicitar respostas de Geografia com Vrbo e hospedagem, somente Vrbo (usando supply_source=vrboem um perfil habilitado) ou somente hospedagem (usando supply_source=expedia). Se supply_sourcenão for fornecido, as APIs do Rapid Geography usarão como padrão apenas hospedagem.

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 do Vrbo é fornecido pelas mesmas APIs de conteúdo rápido que outras opções de hospedagem, passando supply_source=vrbo, mas observe as diferenças no esquema abaixo.
  • O conteúdo do Vrbo está sujeito a atualizações mais frequentes pelos gerentes do propriedade em comparação a outras opções de hospedagem rápida. Informações incorretas no anúncio da propriedade podem resultar em experiências ruins para os hóspedes, ligações para o suporte e solicitações de reembolso. Recomendamos que os parceiros atualizem o conteúdo da Vrbo pelo menos uma vez por semana para garantir que os hóspedes vejam uma representação precisa da propriedade, das comodidades e das políticas.
  • O programa Anfitrião Premium da Vrbo é um benefício exclusivo para convidados, reservado a anfitriões que proporcionam experiências positivas aos hóspedes, o que é avaliado por meio de baixas taxas de cancelamento, avaliações positivas e experiência no atendimento aos hóspedes por meio da plataforma Vrbo. Os parceiros podem identificar propriedades do Premier Host usando attribute_id=1073745445. Além disso, os parceiros podem incluir attribute_id=1073745445em suas solicitações para filtrar resultados e retornar apenas propriedades do Premier Host.

Principais diferenças em relação a outras opções de hospedagem

Campos específicos da Vrbo:

APIDescrição
Arquivo de conteúdoAs propriedades do Vrbo são fornecidas em um arquivo de conteúdo separado de outras opções de hospedagem rápida.
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.
Propriedade particularO atributo 1073745102 'Host privado propriedade' indica que o propriedade é gerenciado por um host privado. Obrigatório para exibição, além das descrições adicionais obrigatórias. Para mais informações, consulte os requisitos de lançamento.
Anfitrião profissional propriedadeO atributo 1073745142 'Host/gerenciador profissional propriedade' indica que o propriedade é gerenciado por um host/gerenciador profissional. Obrigatório para exibição, além das descrições adicionais obrigatórias. Para mais informações, consulte os requisitos de lançamento.
Anfitrião PremiumO atributo 1073745445 'Parceiro principal' indica que o propriedade é gerenciado por um host principal. Pode ser usado para marcar listagens com um indicador Premier Host ou filtrar resultados para retornar apenas propriedades Premier Host.
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 aprimoradas da casa incluem informações importantes sobre políticas para animais de estimação, festas, crianças, política de fumo e muito mais. additional_informationpode incluir detalhes de cada política essencial para a estadia do hóspede, como esclarecimentos de políticas, códigos de acesso, senhas, imagens e taxas stay-collected (impostos turísticos da cidade ou taxas usage-based). 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. Para buscar um arquivo de conteúdo específico da Vrbo, use supply_source=vrbo na solicitação da API.


P. As propriedades da Vrbo estão disponíveis em todos os idiomas?
R. Sim. No entanto, alguns campos de texto livre são fornecidos pelo anfitrião no idioma original, sem tradução. Os campos afetados incluem property_description (descriptions.general), regras da propriedade aprimoradas (vacation_rental_details:enhanced_house_rules), conteúdo essencial para a estadia e conversas por e-mail do anfitrião para o hóspede (facilitadas pela Vrbo).


P. Meus hóspedes 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. Consulte o guia de requisitos de lançamento para saber as exigências por página e região. Exceções são possíveis em situações nas quais o parceiro busca a mesma propriedade em vários fornecedores. No entanto, assim que a Vrbo é identificada como o fornecedor a ser reservado, o nome da Vrbo deve ser exibido. Apresentar a marca Vrbo é um passo importante para informar o hóspede e começar a definir expectativas após a reserva.


P. Sem bed_groups, como descrevo os tipos de cama em cada quarto?
R. Consulte a página Configurações da unidade para obter detalhes sobre as descrições dos tipos de cama.

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 na API de compras da Rapid tem um significado diferente para a Vrbo nas propriedades da Rapid.

  • Ele não representa quem vai fazer a cobrança no cartão fornecido com a reserva. Todas as reservas são pré-pagas.
  • merchant=expedia (‘Merchant’) indica que a reserva vai ser feita por meio de sistemas do EG, que fornecem a melhor taxa de sucesso de reserva e descrições de erro consistentes.
  • merchant=property (‘Agency’) indica que a reserva vai ser feita pelos sistemas de pagamento legados da Vrbo. A distribuição desse inventário está desativada por padrão. Consulte a seção de integração avançada para mais informações.
  • As propriedades não estão vinculadas a um único modelo. Em vez disso, a elegibilidade para "merchant" é baseada em três fatores principais:
    • Sem depósito caução reembolsável (opção de integração avançada não recomendada: veja a seção correspondente abaixo)
    • Sem política de depósito/calendário de pagamentos (opção de integração avançada não recomendada: veja a seção correspondente abaixo)
    • As buscas precisam ser feitas na moeda de destino para receber a disponibilidade.

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.
  • Importante: Os parceiros devem incluir a moeda de destino em cada solicitação do Rapid Shop para acessar o máximo de suprimentos Vrbo como 'Merchant'. Se a moeda de destino não for fornecida, apenas as propriedades disponíveis cujos anfitriões optaram por receber o pagamento na moeda especificada vão ser retornados na resposta da API de compras da Rapid. Consulte o apêndice para obter recomendações sobre a moeda de destino por região ou fale com o seu contato do Partner Connect para obter mapeamentos mais detalhados.

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. Isso se deve aos requisitos da Vrbo de cobrar IVA sobre a taxa de serviço ao viajante com base na localização do hóspede, conforme determinado pelo código do país do endereço de cobrança.

  • Quando não houver correspondência, pode ocorrer um erro na reserva devido a diferentes requisitos de cobrança de IVA.
  • Após o hóspede inserir seu endereço de cobrança, os parceiros devem validar se o código do país é igual ao código do país passado à Rapid durante a compra. Se esses valores forem diferentes, o envio da reserva vai resultar em erro. Em vez disso, os parceiros devem refazer a solicitação de compra usando o endereço de cobrança fornecido pelo hóspede para obter um preço válido para a reserva. O hóspede deve ser informado sobre a alteração de preço (para mais ou para menos) antes de enviar a solicitação de reserva.

Principais diferenças em relação a outras opções de hospedagem

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. Além disso, o atributo 1073745445 'Parceiro Premier' ajuda você a identificar propriedades gerenciadas por anfitriões qualificados para o Programa de Anfitrião Premier e você pode usar o mesmo para influenciar a classificação propriedade.

P. Por que estadias de uma diária não são permitidas?
R. Como VrboCare se aplica apenas a estadias de 2 ou mais noites, não recomendamos que os parceiros permitam reservas curtas para evitar resultados ruins para os hóspedes.

P. Por que janelas curtas de reserva (menos de 72 horas) não são permitidas?
R. Os anfitriões precisam de tempo para processar uma solicitação de reserva, preparar a propriedade para a chegada e se comunicar com o hóspede. Para evitar resultados ruins para os hóspedes ou cancelamentos pelos fornecedores, os parceiros são obrigados a limitar as reservas de última hora.

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 incluir dados mais detalhados e precisos sobre políticas específicas de animais de estimação. Os hóspedes devem ser orientados a discutir a questão dos animais de estimação e o pagamento das taxas correspondentes com o anfitrião da propriedade.

P. Posso fazer buscas por estadias prolongadas (ou seja, mais de 28 diárias)?
R. Sim, o Rapid permite comprar e reservar propriedades Vrbo para estadias de até 365 noites, mas recomendamos fortemente limitar a 90 noites. Os parceiros que estão próximos aos limites de chamadas de compras devem estar cientes de que buscas estendidas têm um impacto maior nos volumes dessas chamadas.

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. Posso fazer pacotes com inventário da Vrbo?
R. Não, você não pode comercializar ou reservar propriedades Vrbo como parte de um pacote.

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

P. Os imóveis da Vrbo no Rapid são elegíveis para promoções como reserva antecipada, de última hora, novos anúncios, descontos semanais e mensais, conforme disponíveis em Vrbo.com?
R. Sim, o Rapid retorna a descrição da promoção, o preço promocional e o preço original (tachado), assim como uma hospedagem convencional, permitindo que você divulgue a oferta e os descontos para seus viajantes.

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.

Reserva 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. Os hóspedes devem discutir pedidos especiais para a estadia direto com o anfitrião após a reserva.

Tópico principal: pagamentos

Validação

  • Todas as reservas da Vrbo na Rapid exigem um cartão de crédito válido com endereço de cobrança correspondente.
  • Em algumas regiões, a Vrbo pode autenticar o cartão com US$ 0 ou um valor nominal. Os parceiros que enviam cartões de crédito virtuais devem garantir que estejam configurados para aceitar múltiplas cobranças.
  • As regras de validação de cartão de crédito são diferentes de outras reservas na Rapid. Veja o apêndice 4 para mais detalhes.
  • Os preços da Vrbo costumam incluir uma taxa de serviço, cobrada pela própria plataforma. O valor da taxa de serviço varia de acordo com a localização do hóspede devido aos requisitos legais para cobrar IVA sobre essa taxa. Como resultado, se o endereço de cobrança do cartão fornecido com a reserva não for no mesmo país indicado durante a solicitação de compras, vai ocorrer um erro de reserva relativo a código de país inválido.
    • Como resultado, os parceiros devem detectar essa incompatibilidade antes de enviar a reserva, para evitar que ocorra um erro. Nesse caso, os parceiros devem pesquisar de novo a propriedade para solicitar um novo preço com base no país de cobrança do hóspede.
    • Os parceiros podem restringir pagamentos a cartões do ponto de venda adquirido para garantir que essa incompatibilidade não ocorra.

Cartão de crédito de cliente

  • Os hóspedes devem ser informados de que podem estar sujeitos a taxas de transações internacionais para reservas feitas em outras moedas, e eventuais reembolsos podem ser afetados pelo câmbio.

Cartão de crédito do parceiro (cartões virtuais)

  • Os parceiros também precisam considerar eventuais taxas de transação internacional no caso das reservas feitas em outras moedas.
  • Os parceiros não devem distribuir propriedades que forneçam calendários de pagamentos (depósitos na API de compras da Rapid).
  • Os cartões de parceiros devem ser configurados de modo a aceitar múltiplas cobranças para permitir as pré-autorizações necessárias (US$ 0 ou valor nominal).
  • O endereço de cobrança do cartão do parceiro deve corresponder à moeda de cobrança do seu ponto de venda.
  • A configuração do cartão do parceiro deve permitir cobranças em diversas moedas, ou o parceiro deve manter um conjunto de cartões para viabilizar as cobranças e reduzir as taxas bancárias.
  • Os parceiros devem ativar o cartão virtual (VCC, na sigla em inglês) alguns segundos antes de enviar a solicitação de reserva para garantir que ele esteja disponível para cobrança.
  • Consulte a seção de integração avançada abaixo para mais informações sobre propriedades com cronogramas de pagamentos.

Tópico principal: dano à propriedade

Depósitos caução reembolsáveis (RDDs, na sigla em inglês)

  • Os RDDs exigidos pelas propriedades são exibidos na API de compras da Rapid e representam um depósito cobrado no momento da reserva. Se o hóspede não danificar o propriedade, o depósito será devolvido no prazo de 2 semanas após a partida do hóspede.
  • Propriedades com RDDs devem ser suprimidas como parte de uma solicitação de compra da Rapid usando o parâmetro de exclusão da API de compras.
  • Veja a seção de integração avançada abaixo para mais detalhes.

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 na compra da 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 da compra, no objeto card_on_file_limit.
  • Propriedades com cartão de crédito cadastrado devem ser suprimidas como parte de uma solicitação de compra da Rapid usando o parâmetro de exclusão da API de compras.

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. Caso contrário, a moeda retornada na resposta de verificação de preço pode ser diferente daquela retornada no Rapid Shop e será a moeda de cobrança na qual o instrumento de pagamento será cobrado.
  • Os parceiros que usam cartões virtuais devem deixar uma margem suficiente para cobrir as taxas de câmbio internacionais cobradas pelo banco parceiro.
  • Os hóspedes devem ser informados sobre possíveis taxas bancárias para transações internacionais, e os reembolsos de reservas canceladas podem não ser iguais ao pagamento inicial devido a flutuações no câmbio.

Principais diferenças em relação à hospedagem

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.

Experiência Post-booking

Após a conclusão de uma reserva Vrbo por meio do Rapid API, os parceiros devem fornecer orientação ao hóspede sobre a experiência post-booking. 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 fornecidas no conteúdo essencial para a estadia da Rapid.
  • As instruções de check-in devem ser fornecidas 72 horas antes da chegada. Caso não sejam recebidas até 48 horas antes da chegada, os hóspedes devem entrar em contato imediato com o suporte.
  • Solicitações de pagamento adicionais
  • Embora Rapid API não suporte alterações definitivas em reservas do Vrbo, as reservas podem ser alteradas fora do Rapid API. Nesse cenário, a resposta de recuperação rápida incluirá apenas o preço total (o preço por noite ou estadia será excluído). Além disso, observe que, devido à natureza do ecossistema Rapid API, para as reservas modificadas pelo Vrbo, a latência de recuperação será maior do que a recuperação do non-modified.

Como gerenciar reservas

  • Os hóspedes podem cancelar reservas pelo site do parceiro, com base na API de cancelamento rápido.
  • Hóspedes podem solicitar alterações ao anfitrião ou então cancelar e refazer a reserva (recomendado).
  • Solicitações de cancelamento para inventário da Vrbo têm considerações especiais quando a tentativa de cancelamento é feita até 4 horas depois da criação da reserva.
    • A solicitação pode retornar um código http indicando que o backend precisa de mais tempo para se estabilizar. Nesses casos, aguarde alguns minutos e tente cancelar outra vez. Recomendamos tentar a cada 10 minutos nas primeiras 6 tentativas e, depois, a cada 30 minutos. Se as tentativas de cancelamento continuarem sem sucesso após 5 horas da criação da reserva, entre em contato com a equipe de suporte da EPS com os registros rápidos.

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.
  • Caso os hóspedes não consigam acessar a propriedade, eles devem primeiro tentar entrar em contato com o anfitrião. Caso não consigam, os hóspedes devem entrar em contato imediato com o parceiro para receber suporte. Os hóspedes não vão ser reembolsados se escolherem acomodações alternativas por conta própria.

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.

Tópico principal: pagamentos Post-booking

Os anfitriões da Vrbo podem solicitar pagamentos adicionais após a conclusão da reserva ou após a estadia do hóspede. Os pedidos de pagamento são facilitados por meio de um e-mail da Vrbo enviado ao hóspede, que inclui um link para uma página de pagamento (não é necessário fazer login). Os hóspedes devem estar cientes de que o não pagamento de quaisquer taxas adicionais solicitadas pelo anfitrião pode resultar no cancelamento da reserva. Todas as taxas solicitadas pelo anfitrião estão incluídas nos campos de texto livre de conteúdo da Rapid, como os de descrição e regras da propriedade ou contrato de locação em free_text.

Exemplos de solicitações de pagamento adicionais incluem:

  • Pagamento de depósito para animais de estimação
  • Pagamento de diárias adicionais, se solicitado ao anfitrião para prolongar a estadia
  • Pagamento de taxas cobradas durante a estadia, como uso de eletricidade ou de toalhas
  • Pagamento por danos à propriedade

Consulte o apêndice 5 para obter exemplos de taxas stay-collected

Principais diferenças em relação a outras opções de hospedagem

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 Post-booking

P. Quais e-mails o hóspede vai receber da Vrbo?
R. Os hóspedes não vão receber confirmações de reserva ou cancelamento da Vrbo. Os parceiros podem fornecer essas confirmações com base na API de itinerário da Rapid.

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. Esses e-mails podem ser facilitados pela Vrbo ou vir direto do anfitrião. Os anfitriões também podem entrar em contato por outros meios, como SMS ou WhatsApp.

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 ou ao suporte.

P. Quais recursos a Vrbo oferece pós-reserva no seu site?
R. As reservas da Vrbo feitas em sites parceiros não ficam acessíveis na conta da Vrbo do hóspede. Apenas a caixa de entrada da Vrbo, que inclui conversas entre o hóspede e o anfitrião, está disponível para os hóspedes.

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 ou de uma solicitação de alteração via suporte.

P. Eu vou receber notificações da Rapid sobre alterações ou cancelamentos de reservas?
R. Os parceiros inscritos nas notificações rápidas receberão notificações quando uma reserva for alterada ou cancelada. Observe que não podemos identificar quem alterou uma reserva neste momento.

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. Os parceiros são responsáveis por enviar um guia de boas-vindas ao hóspede 72 horas antes da chegada. O conteúdo deste guia de boas-vindas vem do conteúdo essencial para a estadia da Rapid, na API de itinerário da Rapid. É importante lembrar que nem todos os anfitriões usam esse recurso. Em vez disso, muitos anfitriões enviam um guia de boas-vindas ao hóspede como um e-mail de conversa. Os hóspedes devem ser orientados a entrar em contato com o suporte do parceiro caso não tenham recebido instruções até 48 horas antes da chegada, de modo a receber assistência para entrar em contato com o anfitrião ou encontrar acomodações alternativas. Se quiser mais informações, consulte o guia de conteúdo essencial para a estadia da Rapid.

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, o hóspede receberá suporte de VrboCare para encontrar acomodações de substituição adequadas. Consulte o guia de suporte da Vrbo na Rapid para mais detalhes.

P. Os anfitriões são penalizados por cancelar reservas?
R. 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. Aproveitar o status de Anfitrião Premium para exibir as melhores propriedades no topo dos resultados da busca pode ajudar os parceiros a diminuir esse risco.

Guia avançado de integração

Situação avançada: depósitos caução reembolsáveis (RDDs, na sigla em inglês)

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. Como os valores de RDD podem ser altos e difíceis de aceitar para parceiros e hóspedes, recomendamos suprimir essas propriedades dos resultados da busca de parceiros.

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 dos depósitos de danos será feito dentro de 14 dias da partida, com base na inspeção do anfitrião.
  • Caso tenha ocorrido algum dano, a Vrbo envia uma fatura por e-mail ao hóspede.
  • O valor do depósito caução reembolsável deve ser exibido no check-out.
  • O valor do RDD exibido na resposta de 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 avançada: 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

Como alguns países não exigem códigos postais e alguns exigem detalhes adicionais, as reservas do Vrbo exigem uma validação de endereço diferente de outras opções de hospedagem.

Países com códigos postais

countries-with-postal-codes

Países sem códigos postais

countries-without-postal-codes

Países com códigos postais e detalhes adicionais

countries-with-postal-codes-and-additional-details

Veja o apêndice 4 para uma lista de países suportados.

Situação avançada: calendários de pagamentos

Às vezes, as propriedades da Vrbo cobram o pagamento com base em um calendário predefinido. Essas propriedades podem ser ativadas/desativadas por meio da configuração do perfil do parceiro. Quando presentes, os calendários de pagamento aparecem na API de compras da Rapid como depósitos, de acordo com o Property Collect. Consulte a documentação da API de compras da Rapid para mais informações sobre como identificar depósitos.

Sobre depósitos (calendários de pagamentos)

  • Cerca de 20% a 30% 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 superiores 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)
  • Anfitrião responde a uma mensagem
  • Viajante envia mensagem ao anfitrião

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
  • Confirmação de reembolso da reserva
  • 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

Outros e-mails relacionados a pagamento da Vrbo que podem ser enviados ao hóspede, incluindo taxas de estadia adicionais (por exemplo, para animais de estimação), alterações (diárias adicionais) e danos:

  • Solicitação de pagamento adicional
  • Confirmação de pagamento
  • Recebimento de pagamento
  • Relatório de danos à propriedade

E-mails adicionais com base na interação do hóspede com a Vrbo.com

  • Criação de conta
  • Redefinição de senha
  • Confirmação de redefinição de senha
  • Criação de senha

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

  • Cancelamento devido a fraude
  • Depósito caução cobrado – apenas para propriedades com RDD
  • Recibo do depósito caução – apenas para propriedades com RDD
  • Solicitação de depósito caução – apenas para propriedades com RDD
  • Pagamento programado em atraso – apenas para propriedades com calendário de pagamentos

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

Apêndice 4: Validação de endereço

Para validação de endereço, os seguintes países exigem um código postal. Alguns também exigem detalhes adicionais.

  • Argentina
  • Austrália (+ estado)
  • Áustria
  • Brasil (+ estado e CPF/CNPJ; se for utilizar o ponto de venda brasileiro, o bairro também deve ser incluído)
  • Canadá (+ província)
  • Dinamarca
  • França
  • Alemanha
  • Grã-Bretanha
  • Grécia
  • Itália
  • Japão (sem código postal, mas o estado e a linha de endereço 2 são obrigatórios)
  • Países Baixos
  • Noruega
  • Polônia
  • Portugal
  • Espanha
  • Suécia
  • Turquia
  • Estados Unidos (o código postal não é obrigatório, mas o estado deve ser incluído)

Apêndice 5: Exemplos de taxas Stay-collected

Algumas taxas cobradas pelo propriedade podem incluir:

  • Taxas administrativas
  • Ar-condicionado
  • Clube
  • Eletricidade
  • Aquecimento
  • Banheira de hidromassagem
  • Internet
  • Lavanderia
  • Roupas de cama
  • Roupas de banho
  • Estacionamento
  • Piscina
  • Taxas da propriedade
  • Água
Esta página foi útil?
Como podemos melhorar esse conteúdo?
Agradecemos por nos ajudar a melhorar.