Recibos de reserva

Entregue recibos de reserva a viajantes para reservas pré-pagas feitas pela Rapid API.

Visão geral

Há muitas situações em que você, seus clientes corporativos e viajantes precisam acessar recibos ou comprovantes de pagamento das reservas de hospedagem:

• Viajantes de negócios podem exigir comprovantes de pagamento para reivindicar o reembolso de despesas de viagem junto ao seu empregador.
• Seus clientes podem precisar de documentos para a conciliação de gastos de viagem e para fins de relatórios internos.
• Você pode precisar da documentação para relatórios financeiros, compartilhamento com contas corporativas, geração de faturas de cobrança, ou conciliação de reservas.
• Viajantes de lazer podem querer um recibo para o gerenciamento das próprias finanças pessoais ou relatórios de despesas.

Recibos de reserva de API rápida

O recurso de recibo de reserva da Rapid API permite que você obtenha uma representação em PDF da resposta da API de itinerário para poder integrar esses recibos nos seus vários fluxos de trabalho. Por exemplo, você pode optar por enviar os recibos por e-mail para clientes ou viajantes, armazenar e expor o documento nas páginas de gerenciamento de viagens ou disponibilizar o PDF para os seus agentes de suporte e equipes de negócios.

Por padrão, um recibo de reserva da Rapid API inclui:

• Informações da propriedade, incluindo nome, endereço, tipo de tarifa e tipo de quarto.
• Detalhes do viajante.
• Datas de estadia.
• Detalhamento do custo total da reserva, incluindo diária e quaisquer impostos ou taxas adicionais.
• Estado atual da reserva (reservada, alterada ou cancelada).

Os recibos de reserva estão disponíveis para reservas de vários quartos. Cada quarto associado à reserva vai aparecer em uma página separada do documento.

Configurando seus recibos de reserva

Há uma certa flexibilidade na forma como o recibo de reserva é configurado. Você pode:

• Escolher entre usar a versão padrão do documento com a marca Expedia ou sem a marca durante a ativação do seu recibo de reserva. Para substituir esse padrão relativo à marca, você pode ajustar os parâmetros da solicitação da API de recuperação.
• Escolher quais detalhes do cliente devem ser incluídos no recibo, incluindo o nome da empresa e/ou endereço ao adicionar esses detalhes na solicitação da API de recuperação.
• Incluir um endereço de e-mail do destinatário no momento da reserva usando a API de reserva da Rapid. Os recibos de reserva serão gerados e enviados de maneira automática ao destinatário no momento da reserva, da alteração ou do cancelamento.

Recuperando recibos de reserva da API rápida

Acesse o recibo de reserva por meio de um link no campo de nível de itinerário non_vat_expedia_invoice da resposta da API de itinerário rápido .

Exemplo de resposta

{
  "itinerary_id": "8999989898988",
  "property_id": "8150374",
  "links": {
    "cancel": { ... },
    "non_vat_expedia_invoice": {
      "method": "GET",
      "href": "/v3/itineraries/8999989898988/invoice?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
    }
  },
  ...
}

Você também pode optar por enviar o documento por e-mail a um contato específico. Para isso, inclua um endereço de e-mail no corpo da solicitação da API de reservas.

Exemplo de corpo de solicitação

{
  "affiliate_reference_id": "4480ABC",
  ...
  "rooms": [ ... ],
  "payments": [ ... ],
  "invoicing": {
    "company_name": "My Employer",
    "company_address": {
      "line_1": "123 Employer Ave",
      "line_2": "Suite 742",
      "city": "Seattle",
      "state_province_code": "WA",
      "postal_code": "98121",
      "country_code": "US"
    },
    "point_of_sale_display": "My Corporate Travel Site",
    "email": "example@myemployer.com"
  },
  ...
  "traveler_handling_instructions": "Please use the card provided for payment."
}

Se você precisar enviar o recibo da reserva do seu próprio domínio de e-mail, recomendamos que você acesse o arquivo usando o link no campo non_vat_expedia_invoice da resposta da API de itinerário e utilize os próprios sistemas internos para enviar o recibo por e-mail ao viajante ou agente.

Detalhes opcionais para incluir nos recibos de reserva da API rápida

Você tem a opção de fornecer detalhes adicionais da empresa, do cliente ou do viajante em suas solicitações da API de reservas para modificar ainda mais o recibo da reserva. Esses são parâmetros opcionais e não são obrigatórios para a geração do recibo de reserva. Consulte a tabela abaixo para mais detalhes sobre os parâmetros opcionais disponíveis para você.

Fonte do documento de recibo de reserva vs. fatura

A entidade responsável por fornecer um recibo ou fatura para uma reserva de hospedagem vai depender do parceiro, tipo de tarifa e qual entidade é responsável por coletar os fundos do hóspede.

• Property Collect: a propriedade vai ser responsável por fornecer recibos e/ou notas fiscais ao viajante quando for a entidade que cobra o hóspede pela estadia e pelas compras feitas no local durante a estadia. O Expedia Group não pode fornecer recibos de reserva e/ou faturas em nome de propriedades para reservas Property Collect.
• Expedia Collect e Expedia Collect atualizado: conforme descrito acima, agora a Expedia pode fornecer um recibo de reserva para reservas pré-pagas feitas via Rapid API. Observe que este documento de recibo de reserva pode servir como comprovante de pagamento da reserva , mas não é uma nota fiscal. As propriedades continuam sendo responsáveis por fornecer recibos e/ou notas fiscais para reservas pagas na propriedade e para adicionais feitas no local durante a estadia do hóspede. Consulte abaixo mais detalhes sobre a funcionalidade de recibo de reserva da Rapid.

Faturamento para clientes corporativos

Clientes corporativos de empresas de gerenciamento de viagens podem exigir faturas de reservas de hotéis de agências para processos de governança corporativa e para recuperar impostos sobre estadias em hotéis, quando aplicável. Conforme a tabela acima, para reservas do Property Collect e do Updated Expedia Collect, a propriedade é responsável por emitir a fatura (de imposto) para o viajante como destinatário do serviço.

Para reservas do Property Collect e do Updated Expedia Collect, o objeto invoicing permite que os parceiros informem os fornecedores sobre a necessidade de uma fatura. O objeto invoicing também oferece aos parceiros a opção de solicitar que detalhes do cliente corporativo sejam incluídos na fatura, além do nome do viajante.

Importante:

• Para passar uma solicitação de fatura a um fornecedor, o booleano deve ser passado.consent_to_share Seconsent_to_sharenão for fornecido, as informações não serão compartilhadas com os fornecedores.
• Os parceiros devem considerar o objeto invoicing para reservas do Property Collect e do Expedia Collect atualizado como uma forma de passar uma "Solicitação de fatura especial" para as propriedades. O fornecimento da fatura continua sendo responsabilidade da propriedade e a Expedia não pode garantir que a propriedade criará a fatura conforme a solicitação de faturamento.

Exemplo

{
...
    "invoicing": {
        "consent_to_share": true,
        "company_name": "alphaDemandPartner",
        "company_address": {
            "line_1": "555 1st St",
            "line_2": "10th Floor",
            "line_3": "Unit 12",
            "city": "Seattle",
            "state_province_code": "WA",
            "postal_code": "98121",
            "country_code": "US"
        },
        "email": "chucktesta@mydomain.com",
        "vat_number": "1234567890"
        }
    }
}

Como identificar propriedades atualizadas do Expedia Collect

O Expedia Collect atualizado é representado como um subconjunto de propriedades do Expedia Collect no conteúdo rápido. Se um parceiro quiser identificar uma propriedade do Expedia Collect atualizada, expedia_collecteupdated_expedia_collectdevem ser verdadeiros.

Exemplo

{
    ...
    "business_model": {
        "expedia_collect": true,
        "property_collect": false,
        "updated_expedia_collect": true
    }
}

Solicitação de recibos de reserva e faturamento corporativo em reservas atualizadas do Expedia Collect

Os parceiros habilitados para recibos de reserva e faturamento corporativo podem usar ambos os recursos ao mesmo tempo nas reservas atualizadas do Expedia Collect. Se o parceiro fornecer consent_to_share para uma reserva atualizada do Expedia Collect, o Rapid passará a solicitação de fatura ao fornecedor para que uma fatura seja emitida no check-out e o parceiro também poderá recuperar o recibo da reserva. Se o parceiro não fornecer consent_to_share, nenhuma informação será enviada ao fornecedor, mas o parceiro ainda poderá obter o recibo de reserva.

Quer habilitar os recibos de reserva da Rapid API? Fale com o seu representante da Expedia.