Compreendendo o Parâmetro SourceMarket em Integrações de Hotéis

Nas integrações via API com distribuidores e fornecedores de hotelaria — como a Yalago —, o parâmetro SourceMarket (mercado de origem) desempenha um papel fundamental na definição de tarifas, restrições contratuais e políticas de cancelamento. Contudo, é comum encontrar requisições em que este campo é enviado vazio ("SourceMarket": "").

Por que o SourceMarket pode ser enviado vazio?

1. Parâmetro Opcional na API do Fornecedor: Em muitas APIs, o envio explícito do mercado de origem não é obrigatório na estrutura do JSON. Quando a aplicação cliente não injeta esse valor, a requisição trafega com uma string vazia.

2. Definição por Omissão (Fallback): Na ausência de um código de país especificado na chamada, o distribuidor (Yalago) costuma assumir o mercado associado diretamente às credenciais da conta (X-Api-Key) ou determinar o contexto com base na moeda solicitada (ex.: USD).

3. Ausência de Mapeamento no Motor de Busca: Se a plataforma de venda não capturar ou não mapear a nacionalidade/residência do utilizador final no momento da pesquisa, o parâmetro não é preenchido no payload da API.

Observação Importante (Integração Cangooroo): Quando a integração é intermediada pelo hub Cangooroo, o comportamento do SourceMarket enviado ao fornecedor depende diretamente do que está configurado no cadastro do fornecedor Yalago dentro do próprio Cangooroo.

Se nas configurações do fornecedor no Cangooroo houver um Source Market fixo/padrão definido (ou regras de seleção baseadas no ponto de venda/nacionalidade), o Cangooroo injetará esse valor automaticamente na chamada de API para a Yalago. Caso contrário, se a configuração estiver em branco ou sem regra mapeada, a requisição será disparada com o campo vazio.