This is an auto-generated translation

Observação: o EGI não está disponível atualmente para todos os parceiros. Se você estiver interessado em habilitar esse estoque, entre em contato com seu gerente de conta para saber mais sobre o que é necessário para acessar o EGI.

Inventário global expandido para a API de hospedagem rápida

Competir em escala global com estoques expandidos ao redor do mundo

O estoque global expandido (EGI) da Expedia ajuda você a competir com mais de 34.000 propriedades no mundo todo, com mais estoque sendo adicionado regularmente. Isso inclui propriedades recém-adquiridas e estoque adicional em propriedades atualmente adquiridas.

Detalhes técnicos

EGI não faz parte do estoque padrão em Rapid API, mas pode ser explicitamente habilitado mediante solicitação. Ele apresenta comportamentos dinâmicos e padrões de integração que diferem do estoque padrão, exigindo atenção especial nos fluxos de trabalho de ingestão de conteúdo, compras e reservas.

Arquivos de conteúdo

As APIs Rapid Content File e Catalog File para EGI atualmente oferecem suporte apenas ao conteúdo English-language. Se o seu sistema exigir arquivos de conteúdo localizados (non-English), você poderá gerá-los localmente usando as APIs propriedade Content e Geography. Essas APIs oferecem streaming real-time e tratamento flexível de dados para todos os idiomas de conteúdo, facilitando a extração das informações necessárias das respostas da API JSON-formatted. Você pode armazenar a resposta JSON bruta localmente para processamento posterior ou transformá-la para importação de banco de dados ou outros casos de uso.

Exemplo de solicitação de uma lista de propriedades para uma região usando a API de Geografia:

/regions?country_code=US&language= it-IT&include=property_ids_expanded&include=property_ids

Exemplo de solicitação de conteúdo de catálogo usando a API de conteúdo propriedade:

/properties/content?language=it-IT&supply_source=expedia&property_id={property_id}&include=catalog

Você pode optar por priorizar o lançamento da integração de conteúdo para o EGI e, ao mesmo tempo, alocar tempo adicional para revisar os fluxos de trabalho de compras e reservas, ou pode lançar todos os três componentes juntos quando se sentir preparado para o EGI. Para obter detalhes de configuração, entre em contato com seu consultor de integração.

Alinhamento de dados da sala

Novas salas propriedade podem aparecer na API de compras antes que seu sistema esteja totalmente sincronizado com a API de conteúdo propriedade. Para manter uma experiência de usuário consistente, considere excluir temporariamente essas salas da exibição do cliente, acionar uma chamada de API de conteúdo real-time para a nova sala ou aumentar a frequência das atualizações de conteúdo local para minimizar o atraso de dados.

Identificador de taxa

As taxas de EGI são estruturadas de forma diferente do estoque padrão e aderem a um modelo de dados mais dinâmico. Como não há um valor estático para essas taxas, a API de compras as retorna com um valor dinâmico rate_idque não corresponde aos valores na API de conteúdo propriedade. Este valor de sequência dinâmica consiste em dígitos, letras e vários outros símbolos, que podem ser diferentes em cada resposta da API de compras. Por isso, o valor rate_idé instável e não deve ser usado como um identificador persistente ou chave primária. Se o seu sistema precisar distinguir taxas entre processos, considere combiná-las com uma combinação de atributos de política e características de oferta. Consulte este documento seguro para obter mais detalhes.

Exemplo do valor rate_id em uma resposta da Shopping API:

[
  {
    "property_id": "ABC152",
    "status": "available",
    "rooms": [
      {
        "id": "XYZ652",
        "room_name": " Deluxe Double ",
        "rates": [
          {
            "id": "5K|Pa7xbx4z||GCogh8-B96OEY3-f9326e292|UFO",
            … …

Variabilidade da configuração da cama

Em circunstâncias excepcionais, certos quartos podem não ter configurações de cama designadas, indicadas nas APIs de Conteúdo e de Compras por meio de um ID bed_groupsde 0 e a descrição "Cama não especificada". Isso implica que o propriedade determinará o arranjo da cama no check-in. Embora essa ocorrência seja rara, seu sistema deve manter o cliente informado e, se ele tiver preferências fortes, ajudá-lo a comunicar solicitações especiais à nossa equipe de operações do cliente.

Exemplo de configuração de cama não especificada em uma resposta da API de compras:

{
  "bed_groups": {
    "0": {
      "id": "0",
      "description": "Bed Not Specified",
      "links": {
        "price_check": {
          … …

Pausar e Continuar

Algumas tarifas EGI são incompatíveis com o fluxo de trabalho Reter e Retomar da API de reservas e retornarão erros se uma tentativa de retenção for feita. Para evitar experiências ruins para o cliente, você pode solicitar o sinalizador de taxa retenível na resposta da API de compras e segui-lo para aplicar o fluxo de trabalho correto.

Exemplo de solicitação de bandeira de taxa retida:

Request:
/properties/availability?... …&include=rooms.rates.holdable

Response:
… …
"rooms": [
  {
    "id": "XYZ652",
    "room_name": "Deluxe Double Room",
    "rates": [
      {
        "id": "5K|Pa7xbx4z||GCogh8-B96OEY3-f9326e292|UFO",
        “holdable”: true,
        … …

Recursos do Post-booking

Após a confirmação de uma reserva por meio da API de reservas, a reserva será entregue em Gerenciar APIs de reservas. Os links de token para acessar os recursos do post-booking, incluindo Soft Change, Hard Change e propriedade Message Center, também estarão disponíveis nas APIs de geranciamento de reservas. Ocasionalmente, os links de token podem levar até cinco minutos para ficarem prontos. É importante observar que esses recursos não estão disponíveis para todas as reservas e devem ser gerenciados com elegância no seu sistema.

Principais diferenças no EGI

Característica / comportamentoInventário padrãoInventário global expandido
Disponibilidade por padrãoAtivado por padrãoAtivação mediante solicitação
Identificador de taxaEstático, persistenteDinâmico, varia de acordo com a loja
Soluções de conteúdoCompatível com APIs de arquivo e APIs de conteúdo de streamingCompatível com APIs de arquivo para conteúdo em inglês e APIs de conteúdo de streaming para todos os idiomas
Requisito de sincronização de conteúdoSincronização diária para propriedades popularesSincronização diária para propriedades populares
Configuração de camasEspecificadoPode não ser especificado em casos raros
Pausar e ContinuarDisponível para todas as reservasDisponível para algumas reservas
Recursos do Post-bookingDisponível para todas as reservasDisponível para algumas reservas
Esta página foi útil?
Como podemos melhorar esse conteúdo?
Agradecemos por nos ajudar a melhorar.