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.

Rapid API recibos de reserva

O recurso Rapid API Recibo de Reserva permite que você obtenha uma representação em PDF da resposta da API de Itinerário para que você possa Integrar esses recibos em 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 do 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 Rapid API

Acesse o recibo de reserva por meio de um link no campo de nível de itinerário non_vat_expedia_invoiceda 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 Rapid API

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. nota fiscal

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 geranciamento 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 propriedade Collect e Updated Expedia Collect, o propriedade é responsável por emitir a nota fiscal (de imposto) para o viajante como destinatário do serviço.

Para reservas propriedade Collect e Expedia Collect atualizadas, o objeto invoicingpermite que os parceiros informem os fornecedores sobre a necessidade de uma nota fiscal. O objeto invoicingtambém oferece aos parceiros a opção de solicitar que detalhes do cliente corporativo sejam incluídos na nota fiscal, além do nome do viajante.

Importante:

• Para passar uma solicitação de nota fiscal a um provedor, 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 invoicingpara reservas propriedade Collect e Expedia Collect atualizadas como uma forma de passar uma 'Solicitação de nota fiscal especial' para propriedades. O fornecimento da nota fiscal é de responsabilidade da propriedade e a Expedia não pode garantir que a propriedade criará a nota fiscal 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"
        }
    }
}

É importante estar ciente de que passar campos de solicitação de nota fiscal de IVA não acionará uma notificação para o propriedade. Em vez disso, esses campos são transmitidos às propriedades por meio da extranet Partner Central e das APIs de conectividade que elas usam para consumir reservas Expedia Group.

Passar esses campos tem o benefício de conscientizar as propriedades com antecedência sobre a necessidade de uma nota fiscal de IVA e dar a elas a oportunidade de gerar a nota fiscal para o viajante. No entanto, processar a solicitação de uma nota fiscal e disponibilizá-la ao viajante continua sendo responsabilidade do propriedade.

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 um Expedia Collect atualizado propriedade, 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 fornecerconsent_to_share para uma reserva atualizada do Expedia Collect, o Rapid passará a solicitação de nota fiscal ao provedor para que uma nota fiscal seja emitida em check-out e o parceiro também poderá recuperar o recibo da reserva. Se o parceiro não fornecerconsent_to_share, nenhuma informação será enviada ao provedor, 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.