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 da Rapid API
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 sobre a propriedade, incluindo nome, endereço, tipo de tarifa e tipo de quarto
- Detalhes do viajante
- Datas da estadia
- Detalhamento do custo total da reserva, incluindo a tarifa por 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.
Configuração dos 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.
Recuperação de recibos de reserva da Rapid API
Acesse o recibo de reserva pelo link no nível do itinerário non_vat_expedia_invoice
da resposta da API de itinerário da Rapid.
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 da 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 a serem incluídos nos recibos de reserva da Rapid API
Você tem a opção de fornecer outros detalhes da empresa, do cliente e do viajante nas suas solicitações da API de reservas para modificar ainda mais o recibo de 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ê.
Parâmetro opcional | Descrição | Exemplo |
---|---|---|
point_of_sale_display | Nome da empresa parceira ou pessoa jurídica que vai aparecer no documento do recibo de reserva | ABC Travel ABC Travel LTD |
company_name | Nome da empresa do cliente | ACME Corp |
company_address | Endereço do cliente | 100 Main St, Miami, FL 10000 EUA |
Endereço de e-mail para o qual o recibo de reserva em PDF deve ser entregue. Pode incluir contatos de clientes e/ou viajantes. | j.doe@acme.com |
Recibo de reserva versus documento original de 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. Tenha em mente que esse documento de recibo de reserva pode servir de 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.
Modelo de pagamento | Fonte do recibo de reserva | Fonte da nota fiscal |
---|---|---|
Property Collect | A propriedade entrega o recibo com o valor da reserva e as taxas cobradas no local. | A propriedade pode emitir uma nota fiscal pelos seus serviços |
Expedia Collect atualizado | A Expedia entrega o recibo com o valor de reserva. A propriedade entrega o recibo com as taxas cobradas no local. | A propriedade pode emitir uma nota fiscal pelos seus serviços |
Expedia Collect | A Expedia entrega o recibo com o valor de reserva. A propriedade entrega o recibo com as taxas cobradas no local. | A propriedade pode emitir uma nota fiscal pelos seus serviços. Observação: a Expedia não tem a obrigação de emitir notas fiscais referentes à prestação de serviços. |
Quer habilitar os recibos de reserva da Rapid API? Fale com o seu representante da Expedia.