Faturas e comprovantes de reserva

Visão geral

Existem muitas situações em que você, seus clientes corporativos ou o viajante precisam ter acesso a recibos ou faturas de reservas de hospedagem:

Viajantes a negócios podem precisar de comprovante de pagamento para solicitar reembolso de despesas de viagem ao empregador.
Seus clientes podem precisar de documentos para ajudar a conciliar os gastos com viagens ou para fins de relatórios internos.
Você pode precisar de documentação para relatórios financeiros, compartilhamento com contas corporativas, geração de faturas bill-back ou conciliação de lançamentos.
Viajantes a lazer podem querer um recibo para fins de gestão financeira pessoal ou para comprovar despesas.

As faturas são documentos formais legalmente válidos, geralmente emitidos por um vendedor tax-registered no momento da reserva de hospedagem check-out. Os recibos de reserva são comprovativos de pagamento que podem ser emitidos a qualquer momento post-payment.

A entidade responsável por fornecer ao viajante o recibo ou a nota fiscal da reserva de hospedagem dependerá da forma de pagamento.

Modelo de pagamento	Fonte do comprovante de reserva	Fonte da nota fiscal
Property Collect	Propriedade emite um recibo de reserva referente ao valor da reserva e às taxas cobradas no local.	Propriedade emite uma nota fiscal pelos seus serviços, que os parceiros da Rapid podem solicitar através da plataforma Rapid.
Expedia Collect atualizado	A Expedia fornece um recibo de reserva referente ao valor da reserva, que os parceiros da Rapid podem solicitar através da Rapid (veja abaixo). Propriedade entrega comprovante de reserva para cobranças no local.	Propriedade emite uma nota fiscal pelos seus serviços, que os parceiros da Rapid podem solicitar através da plataforma Rapid.
Expedia Collect	A Expedia fornece um recibo de reserva referente ao valor da reserva, que os parceiros da Rapid podem solicitar através da Rapid (veja abaixo). Propriedade entrega comprovante de reserva para cobranças no local.	A empresa propriedade pode emitir uma nota fiscal fiscal pelos seus serviços a seu critério, visto que não é obrigada a fazê-lo em muitas jurisdições.

Como identificar propriedades atualizadas do Expedia Collect

O Expedia Collect atualizado é representado como um subconjunto das propriedades do Expedia Collect no conteúdo Rapid. Se um parceiro quiser identificar um Expedia Collect atualizado propriedade, tanto expedia_collect quanto updated_expedia_collect devem ser true.

Indicadores do modelo de negócios

Campo	Tipo	Descrição
`Property_collect`	booleano	Propriedade recebe o pagamento diretamente do hóspede.
`updated_expedia_collect`	booleano	A Expedia cobra o pagamento do hóspede no momento da reserva, e o hotel recebe o valor após o check-out do hóspede. Inclui novas funcionalidades de notificação e pagamento para o propriedade.
`expedia_collect`	booleano	A Expedia cobra o pagamento do hóspede no momento da reserva, e o hotel recebe o valor após o check-out do hóspede.

Exemplo de objeto de modelo de negócios

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

Recibos de reserva

O recurso Rapid API de recibo de reserva permite obter uma representação em PDF da resposta da API de itinerário para reservas Expedia Collect e reservas Expedia Collect atualizadas. Em seguida, você pode integrar esses recibos aos seus fluxos de trabalho.

Por exemplo, você pode optar por:

Envie os recibos por e-mail aos clientes ou viajantes.
Armazene e exponha o documento nas páginas de geranciamento de viagens.
Disponibilize o PDF para seus agentes de suporte e equipes comerciais.

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

Propriedade informações incluindo nome, endereço, tipo de tarifa e tipo de quarto
Detalhes do viajante
Datas da estadia
Uma discriminação do custo total da reserva, incluindo a tarifa por noite e quaisquer impostos ou taxas adicionais.
Estado atual da reserva (reservada, alterada ou cancelada)

Os comprovantes de reserva estão disponíveis para reservas no multi-room. Cada quarto associado à reserva será representado em uma página separada do documento.

Habilitando recibos de reserva Rapid API

Quer habilitar os recibos de reserva da Rapid API? Entre em contato com seu representante Expedia Group.

Configurando seus recibos de reserva

Você tem alguma flexibilidade na configuração do recibo de reserva.

Você pode:

Escolha entre usar a versão padrão do documento com a marca Expedia ou a versão sem marca durante o processo de integração do seu recibo de reserva.
- Você pode substituir essa configuração padrão da marca ajustando os parâmetros da solicitação da API Retrieve.
Escolha quais dados do cliente devem ser incluídos no recibo, incluindo o nome e/ou endereço da empresa, incluindo essas informações na solicitação da API Retrieve.
Inclua o endereço de e-mail do destinatário no momento da reserva usando a API Rapid Book.
- Os recibos de reserva serão gerados e enviados automaticamente ao destinatário no momento da reserva, alteração ou cancelamento.

Recuperando comprovantes de reserva Rapid API

Você pode acessar o recibo da reserva através de um link no campo non_vat_expedia_invoice itinerary-level da resposta da API Rapid Itinerary.

Exemplo de resposta da API de itinerário

{
  "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 para um contato específico, incluindo um endereço de e-mail no corpo da solicitação da API de reservas.

Exemplo de corpo de solicitação da API de reservas

{
  "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 que o recibo da reserva seja enviado do seu próprio domínio de e-mail, recomendamos que acesse o arquivo usando o link no campo non_vat_expedia_invoice da resposta da API de Itinerário e, em seguida, utilize seus próprios sistemas internos para enviar o recibo por e-mail ao viajante ou agente.

Detalhes opcionais a 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 à 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 obter mais detalhes sobre os parâmetros opcionais disponíveis.

Parâmetro opcional	Descrição	Exemplo
`point_of_sale_display`	O nome da empresa parceira ou da entidade jurídica deverá constar no comprovante 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
`email`	Endereço de e-mail para onde o PDF do recibo de reserva deve ser enviado. Pode incluir contatos de clientes e/ou viajantes.	j.doe@acme.com

Nota: Você deve fornecer apenas o endereço de e-mail do viajante ou o endereço de e-mail da empresa do viajante no campo email. O endereço de e-mail fornecido nunca deve ser o seu próprio ou o de um contato dentro da sua organização.

Faturas

Os parceiros da Rapid podem usar o objeto invoicing na API de reservas para informar os fornecedores sobre a necessidade de uma nota fiscal. Opcionalmente, os parceiros também podem incluir detalhes do cliente corporativo na nota fiscal, além do nome do viajante.

Isso é preferível ao envio de informações em PDF por e-mail ou fax, ou ao preenchimento excessivo dos campos de instruções para viajantes ou solicitações especiais.

É importante estar ciente de que o envio dos 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.

Preencher esses campos traz os seguintes benefícios:

Informar os proprietários com antecedência sobre a necessidade de uma nota fiscal com IVA.
Dando-lhes a oportunidade de gerar a nota fiscal para o viajante.

No entanto, processar o pedido de nota fiscal e disponibilizá-la ao viajante continua sendo responsabilidade do propriedade nas reservas propriedade Collect e nas reservas Expedia Collect atualizadas.

Observação

Para enviar uma solicitação de nota fiscal a um provedor, o booleano consent_to_share deve ser passado. Se consent_to_share não for fornecido, as informações não serão compartilhadas com os fornecedores.

Exemplo de trecho de solicitação da API de reservas com objeto de faturamento

{
  ...
  "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"
  }
}

Solicitar comprovantes de reserva e faturamento corporativo para reservas atualizadas do Expedia Collect.

Os parceiros que têm as funcionalidades habilitadas tanto para recibos de reserva quanto para faturamento corporativo podem usar ambas as funcionalidades nas reservas.

Se o parceiro fornecer consent_to_share para uma reserva Expedia Collect atualizada:

A Rapid encaminhará 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 fornecer consent_to_share nenhuma informação será enviada ao provedor, mas o parceiro ainda poderá obter o recibo da reserva.