Esta é uma tradução automática

Guia de integração da Vrbo na Rapid

Um guia para o processo de integração do Vrbo

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

Preciso saber

Se você estiver usando a API Rapid Geography e tiver a opção para acessar o Vrbo habilitada, também poderá acessar os IDs propriedade do Vrbo em todas as APIs de Geografia, além das 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.
  • Você deve usar a latitude e a longitude da API de Conteúdo em conjunto com sua própria solução de geografia para mapear propriedades.
  • Propriedades onde o usuário propriedade solicitou privacidade devem usar a latitude/longitude ofuscada para exibição no mapa, mas podem usar a latitude/longitude exata para a busca por propriedade, desde que a localização exata de propriedade não seja exibida ao visitante.

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

Você pode solicitar respostas de Geografia com Vrbo e hospedagem, somente Vrbo (usando supply_source=vrboem um perfil ativado) ou somente hospedagem (usando supply_source=expedia). Se supply_sourcenão for fornecido, as APIs do Rapid Geography usarão, por padrão, apenas opções de 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, você pode 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

Preciso saber

  • O conteúdo do Vrbo é fornecido através das 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 gestores do propriedade em comparação com outras opções de hospedagem da Rapid. 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 vivamente que atualize o conteúdo do Vrbo pelo menos semanalmente para garantir que os hóspedes vejam uma representação precisa do 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. Você pode identificar propriedades de Anfitriões Premier usando attribute_id=1073745445. Além disso, você pode incluir attribute_id=1073745445em sua solicitação para filtrar os resultados e retornar apenas propriedades de Anfitriões Premium.

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

Na API de Arquivos de Conteúdo, as propriedades da Vrbo são fornecidas separadamente de outras opções de hospedagem rápida.

Vrbo-specific campos

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 'Professional propriedade host/manager' indica que o propriedade é ​​gerenciado por um host/manager 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 Premier' indica que o propriedade é ​​gerenciado por um host Premier. Pode ser usado para destacar anúncios com um indicador de Anfitrião Premium ou filtrar resultados para retornar apenas propriedades de Anfitriões Premium.
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.
>> Explore o 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 casa aprimoradas incluem informações importantes sobre políticas para animais de estimação, festas, crianças, política de fumo e muito mais. additional_informationpodem incluir detalhes de cada política essencial para a estadia do hóspede, como esclarecimentos sobre as políticas, códigos de acesso, senhas, imagens e taxas stay-collected (impostos turísticos da cidade ou taxas usage-based).
>> Saiba mais no guia de conteúdo essencial para estadias 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, você deve usar Descriptions.Generalcomo alternativa.
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 obter o texto de exibição recomendado para check-out.
>> Revisar os requisitos de lançamento

Campos não relevantes para propriedades 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 o 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 onde o mesmo propriedade é ​​proveniente de múltiplos fornecedores; contudo, assim que a Vrbo for identificada como o provedor a ser reservado, o nome da Vrbo deverá 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.
>> Saiba mais sobre as configurações da unidade

Compras

Preciso 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.
  • Reservas para o mesmo dia não são possíveis (nenhuma disponibilidade será informada).

Tópico principal: merchant_of_record para reservas da Vrbo

O campo merchant_of_recordna API Rapid Shopping tem um significado diferente para o Vrbo em propriedades 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 da loja não afeta a moeda de faturamento 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: Você deve incluir a moeda de destino em cada solicitação de compra para acessar a maior oferta da Vrbo, como 'Merchant'. Caso a moeda de destino não seja informada, somente as propriedades disponíveis cujos anfitriões optaram por receber o pagamento nessa moeda específica serão exibidas na resposta da pesquisa. Consulte o apêndice para obter recomendações sobre a moeda de destino por região ou entre em contato com seu ponto de 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 da API de Compras deve corresponder ao país de faturamento do cartão de crédito fornecido na reserva. 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 cliente inserir o endereço de cobrança, você deve verificar se o código do país corresponde ao código do país informado à Rapid durante a compra. Se esses valores forem diferentes, o envio da reserva vai resultar em erro. Em vez disso, você deve refazer a solicitação de compra usando o endereço de cobrança guest-provided 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 do envio da solicitação de reserva.

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

Vrbo-specific campos

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 para viajantes e seleção de país da API de Compras Rápidas: Quando um hóspede do Vrbo inclui uma taxa de serviço para viajantes na resposta de preços, o valor incluirá o IVA correspondente ao país usado na solicitação da API de Compras Rápidas. Para efetuar uma reserva com sucesso, certifique-se de que o país solicitado na loja corresponde ao país de pagamento a ser utilizado em check-out.

Campos não relevantes para propriedades 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ões Premier e você pode usá-lo para influenciar a classificação propriedade.

P. Por que estadias de uma diária não são permitidas?
R. Como a regra VrboCare só se aplica a estadias de 2 noites ou mais, não recomendamos que você permita reservas de curta duração para evitar experiências negativas 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 experiências negativas para os hóspedes ou cancelamentos por parte dos fornecedores, é necessário limitar as reservas com o código close-in.

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. Você pode identificar propriedades pet-friendly com base nos atributos de conteúdo propriedade e os visitantes podem visualizar as políticas individuais para animais de estimação. 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, a Rapid permite pesquisar e reservar propriedades da Vrbo para estadias de até 365 noites, mas recomendamos fortemente limitar a 90 noites. Se você estiver próximo dos limites de limitação de tráfego da loja, esteja ciente de que pesquisas prolongadas têm um impacto maior no volume de chamadas para a loja.

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 taxa de limpeza, taxa administrativa, taxas por pessoa extra e outras taxas, e são combinados em um único valor.property_fees.

P. Posso fazer pacotes com inventário da Vrbo?
R. Não, você não pode anunciar ou reservar propriedades do Vrbo como parte de um pacote.

P. As propriedades da Vrbo se qualificam para ofertas somente para associados?
R. Sim.

P. Os imóveis da Vrbo no Rapid são elegíveis para promoções como reserva antecipada, última hora, novos anúncios, descontos semanais e mensais, disponíveis em Vrbo.com?
R. Sim, a Rapid retorna a descrição da promoção, o preço promocional e o preço original (riscado), assim como as hospedagens convencionais, permitindo que você apresente a oferta e a economia aos 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.

P. Os preços riscados são exibidos durante a verificação de preços, da mesma forma que na disponibilidade?
R. Não. Os dados promocionais estão disponíveis durante a sua chamada de disponibilidade, mas não estão disponíveis na resposta da verificação de preços.

Reserva e pagamento

Preciso saber

  • Você deve fornecer os dados de contato do hóspede (nome, telefone e e-mail) em 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 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. Você deve garantir que os cartões virtuais reflitam as possíveis diferenças nas taxas de câmbio e as tarifas bancárias internacionais para evitar erros de reserva por insuficiência de fundos.
  • No momento, o Expedia Affiliate Collect (EAC) não é compatível com reservas da Vrbo feitas pela Rapid.
  • No momento, as solicitações especiais não são repassadas para a propriedade. Os hóspedes devem discutir quaisquer pedidos especiais relativos à sua estadia diretamente 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. Se você estiver enviando cartões de crédito virtuais, certifique-se de que eles 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. Consequentemente, se o endereço de cobrança do cartão fornecido na reserva for diferente do país informado durante a compra, ocorrerá um erro de reserva do tipo "Código de país inválido". Você pode restringir os pagamentos aos cartões da loja point-of-sale para garantir que essa incompatibilidade não ocorra.

Observação: Você deve detectar essa incompatibilidade antes de enviar a reserva para evitar esse erro. Nesse caso, você deve fazer a solicitação de compra novamente para o código propriedade para solicitar um novo preço com base no país de faturamento do cliente.

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)

  • Você deve levar em consideração as taxas de transação internacional aplicáveis ​​a reservas feitas em outras moedas.
  • Você não deve distribuir propriedades que ofereçam um cronograma de pagamentos (depósitos da API Rapid Shopping).
  • Os cartões parceiros devem ser configurados para aceitar múltiplas cobranças, permitindo qualquer valor necessário (US$ 0 ou valor nominal) pre-authorization.s
  • O endereço de cobrança do cartão deve corresponder à moeda de cobrança do ponto de venda.
  • A configuração dos cartões de parceiros deve permitir cobranças em várias moedas, ou você deve manter um conjunto de cartões para viabilizar as cobranças e, ao mesmo tempo, reduzir as taxas bancárias.
  • Você deve ativar o cartão virtual alguns segundos antes de enviar a solicitação do livro para garantir que o cartão esteja disponível para cobrança.
  • Consulte a seção de integração avançada abaixo para obter mais informações sobre propriedades com planos de pagamento.

Tópico principal: dano à propriedade

Depósitos de segurança reembolsáveis ​​(RDDs)

  • Os RDDs exigidos pelas propriedades são exibidos na API Rapid Shopping e representam um depósito coletado no momento da reserva. Caso o hóspede não danifique o propriedade, o depósito será devolvido em até 2 semanas após a sua partida.
  • Propriedades com RDDs devem ser suprimidas como parte de uma solicitação de compra usando o parâmetro de exclusão da API Rapid Shopping.
  • Consulte a seção de integração avançada abaixo para obter mais detalhes.

Card-on-file

  • Card-on-file indica que a Vrbo tem o direito de cobrar no cartão fornecido até o valor retornado na API Rapid Shopping após a saída do hóspede do propriedade se ele tiver causado danos ao 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.
  • As propriedades Card-on-file podem ser suprimidas como parte de uma solicitação de compra usando o parâmetro de exclusão da API Rapid Shopping.

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

A moeda especificada na solicitação da loja não afeta a moeda de faturamento 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 da verificação de preço pode ser diferente daquela retornada na API Rapid Shopping e será a moeda de faturamento na qual o instrumento de pagamento será cobrado.
  • Se você estiver usando cartões virtuais para pagamento, deverá reservar uma margem suficiente para cobrir as taxas de câmbio internacional cobradas pelo seu banco.
  • Os hóspedes devem ser informados sobre as possíveis taxas bancárias para transações internacionais, e os reembolsos para reservas canceladas podem não corresponder ao pagamento inicial devido às flutuações da taxa de câmbio.

Principais diferenças em relação à hospedagem

Vrbo-specific campos

CampoDescrição
CEPOs requisitos diferem de outros inventários de hotéis da Rapid. Consulte o Apêndice 4 para obter mais detalhes.

Campos não relevantes para propriedades 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.

Post-booking experiência

Preciso saber

Ao concluir uma reserva no Vrbo através do código Rapid API, você deve orientar o hóspede sobre a experiência post-booking. Sugerimos os seguintes tópicos.

O que esperar

  • O anfitrião pode enviar mensagens ao convidado (veja abaixo exemplos de tópicos) através da API de Conversas.
  • Os hóspedes devem poder enviar uma mensagem ao anfitrião a partir da sua reserva na página de Viagens, utilizando a API de Conversas.
  • As instruções para Check-in devem ser fornecidas 72 horas antes da chegada, utilizando o Conteúdo Essencial da Estadia ou uma mensagem do anfitrião através da API de Conversas. Caso não receba a confirmação em até 48 horas após a chegada, os hóspedes devem entrar em contato imediatamente com o anfitrião ou 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 de Rapid API. Nesse cenário, a resposta de recuperação rápida incluirá apenas o preço total (o preço por noite ou por estadia será excluído). Além disso, observe que, devido à natureza do ecossistema Rapid API, para reservas modificadas pelo Vrbo, a latência de recuperação será maior do que a de recuperação com non-modified.

Como gerenciar reservas

  • Os hóspedes podem cancelar reservas através do seu site, com base na API Rapid Cancel.
  • Hóspedes podem solicitar alterações ao anfitrião ou então cancelar e refazer a reserva (recomendado).
  • Os pedidos de cancelamento de reservas no Vrbo recebem considerações especiais quando a tentativa de cancelamento é feita dentro de 4 horas após a criação da reserva. A solicitação pode retornar um código HTTP indicando que o servidor precisa de mais tempo para processar. Nesses casos, aguarde alguns minutos e tente cancelar novamente (recomendamos tentar a cada 10 minutos nas primeiras 6 tentativas e, em seguida, 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 Expedia Group e envie os registros do Rapid.

Se houver um problema

  • Informe os hóspedes para entrarem em contato com o suporte ao cliente ou com o Suporte Direto ao Cliente Expedia Group (CDS).
  • 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 resolver o problema, os hóspedes devem entrar em contato com você imediatamente para obter suporte. Os hóspedes não vão ser reembolsados se escolherem acomodações alternativas por conta própria.

Nota: O número de confirmação do Vrbo (HA-########) deve ser fornecido aos hóspedes, pois é a única referência disponível para o anfitrião e para o suporte do 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 do stay-collected, como consumo de eletricidade ou uso de toalhas.
  • Pagamento por danos à propriedade

Consulte o Apêndice 5 para exemplos de taxas stay-collected.


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

Vrbo-specific campos

CampoDescrição
Conteúdo essencial para a estadiaEste guia de boas-vindas da Vrbo deve ser entregue ao hóspede imediatamente após a criação da reserva.
>> Consulte o conteúdo essencial sobre estadias na Vrbo para obter mais detalhes.

Campos não relevantes para propriedades Vrbo

CampoDescrição
Valor de reembolso no cancelamentoIndisponí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.

Post-booking Perguntas frequentes

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. Você deve fornecer essas confirmações com base na API Rapid Itinerary. Os hóspedes receberão da Vrbo apenas e-mails relacionados a solicitações de pagamento adicionais.

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.

P. Como é possível alterar as reservas da Vrbo?
R. Recomenda-se que os hóspedes cancelem e façam uma nova reserva, mas eles podem solicitar alterações nas reservas do Vrbo entrando em contato com o anfitrião ou abrindo uma solicitação de alteração por meio do suporte.

P. Eu vou receber notificações da Rapid sobre alterações ou cancelamentos de reservas?
R. Se você se inscreveu nas notificações da Rapid, receberá notificações quando uma reserva for alterada ou cancelada. Note que, neste momento, não podemos identificar quem alterou a reserva.

P. As conversas com anfitriões da Vrbo funcionam com a Central de mensagens da propriedade?
R. Não. As comunicações Host-traveler são necessárias para usar a API de Conversação.

P. Como os hóspedes recebem as informações de check-in?
R. Você é responsável 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 enviarão um guia de boas-vindas ao hóspede como uma mensagem através da API de Conversas. Os hóspedes devem ser orientados a entrar em contato com o serviço de atendimento ao cliente caso não recebam instruções de chegada em até 48 horas após o embarque, para obterem auxílio no contato com o anfitrião ou na busca de acomodações alternativas.

>> Leia mais sobre o conteúdo essencial da estadia

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. Caso isso ocorra antes da chegada do hóspede, este receberá apoio da VrboCare para encontrar uma acomodação alternativa adequada. Consulte o guia de suporte da Vrbo na Rapid para mais detalhes.

>> Saiba mais sobre VrboCare

P. Os anfitriões são penalizados por cancelar reservas?
R. Sim. Além disso, a frequência com que os administradores de propriedade cancelam contas é um fator determinante para a elegibilidade de anfitriões de destaque e impacta o posicionamento de propriedade nos resultados de busca. Portanto, os administradores de propriedade tomam cuidado para não cancelar contas, a menos que seja necessário. Aproveitar o status de anfitrião premium para exibir os melhores imóveis no topo dos resultados de pesquisa pode ajudar a mitigar esse risco.

Guia avançado de integração

Cenário Avançado: Depósitos de segurança reembolsáveis ​​(DSRs)

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 tanto para você quanto para seus convidados, recomendamos fortemente suprimir essas propriedades dos seus resultados de pesquisa.

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 de segurança será efetuado em até 14 dias após a partida, mediante 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 em RDD exibido na API Rapid Shopping é 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 como Merchant de registro

  • Recomendamos que exclua os RDDs (Distribuidores de Débito Remoto) ao efetuar o pagamento com cartão virtual, a menos que eles facilitem a cobrança e o reembolso do depósito de segurança junto ao hóspede.
  • Você é responsável por exibir o valor ao hóspede e por cobrar/reembolsar o valor conforme o combinado.

Exemplo:

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

Cenário avançado: 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ódigo postal e outros exigem informações adicionais, as reservas da Vrbo requerem 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ódigo postal

countries-without-postal-codes

Consulte o apêndice 4 para obter uma lista dos países apoiados.

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 através da configuração do perfil do parceiro. Quando presentes, os cronogramas de pagamento aparecerão na API Rapid Shopping como depósitos, de acordo com propriedade Collect.

>> Saiba mais sobre depósitos na API de Compras Rápidas

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 cronograma de pagamento devem ser exibidos durante a compra em shop/check-out, idealmente como uma visualização de linha do tempo.

Exemplo:

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

payment-schedule-example

Além disso, os hóspedes devem ser informados de que são responsáveis ​​por efetuar o pagamento no site da Vrbo de acordo com o cronograma fornecido, sob pena de cancelamento por parte do anfitrião.

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.

Combinado com depósitos de segurança 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 conjunto com o parceiro, o registro Merchant

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

Você deve integrar a API de Conversação para facilitar a comunicação direta entre o anfitrião do propriedade e o viajante.

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

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.

  • Argentina
  • Austrália
  • Áustria
  • Brasil
  • Canadá
  • Dinamarca
  • França
  • Alemanha
  • Grã-Bretanha
  • Grécia
  • Itália
  • Países Baixos
  • Noruega
  • Polônia
  • Portugal
  • Espanha
  • Suécia
  • Turquia

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.