Manual / Integrações

Conectar OpenGDS

Atualizado em 2026-05-24

Conectar OpenGDS ao BedFlow

OpenGDS é uma plataforma de distribuição europeia com sub-canais como Natuurhuisje, VIPIO e Charmant Hotel. Uma única ligação ao OpenGDS envia o seu inventário para todos esses sub-canais em simultâneo. O fluxo é idêntico ao do Booking.com, mas o OpenGDS suporta múltiplos planos de tarifa por quarto (um por sub-distribuidor) para que possa definir preços diferentes por nicho.

⚠️ Pré-requisito: já tem uma conta OpenGDS com o seu alojamento registado. Ainda não tem? Solicite em opengds.com e aguarde até que aprovem o seu anúncio.

O que precisa?

| Item | Onde encontrar | |---|---| | OpenGDS Hotel Code | 5-8 caracteres alfanuméricos, no seu portal OpenGDS ou junto do seu account manager | | Login no seu portal OpenGDS | E-mail + palavra-passe, para o passo de aceitação da ligação |

Passo 1 — Procurar o Hotel Code

Inicie sessão no seu portal OpenGDS. O Hotel Code encontra-se em Account → Property Settings, ou solicite-o ao seu account manager do OpenGDS por e-mail.

Ainda não tem acesso ao portal? Envie um e-mail ao seu contacto do OpenGDS — normalmente enviam-lhe o Hotel Code no prazo de 1 dia útil.

Passo 2 — Introduzir o código no BedFlow

  1. Definições → Integrações → Mosaico OpenGDS → Definições.
  2. Cole o Hotel Code em "OpenGDS Hotel Code".
  3. Clique em Guardar.
  4. Clique em "Ligar no Channex" — abre-se um modal inline dentro do BedFlow com o formulário de ligação do Channex (já não abre um novo separador).

Passo 3 — Percorrer o modal do Channex

No modal aparece o assistente "Create Channel" do Channex com 3 (ou 4) separadores:

Separador "General Settings"

  • Channel → escolha "OpenGDS"
  • Title → "OpenGDS" (a predefinição é suficiente)
  • Currency → EUR
  • Clique em Save

Separador "Mapping" — obrigatório

Para cada tipo de quarto do OpenGDS, escolhe qual o plano de tarifa do BedFlow que lhe é associado. Um tipo de quarto sem mapeamento NÃO será enviado ao OpenGDS.

Tem planos de tarifa adicionais por sub-distribuidor (Natuurhuisje/VIPIO/CharmantHotel — veja a secção seguinte)? Então verá aqui múltiplos planos de tarifa por quarto BedFlow e associa cada um separadamente ao feed correto a jusante.

Separador "Channel Settings"

Normalmente sem campos obrigatórios — reveja e guarde.

Separador "Readiness Check"

Mostra os possíveis bloqueios que impedem a ativação. Tudo a verde? Bem.

Passo 4 — De volta no BedFlow

Clique na parte inferior do modal em "Concluído — fechar e atualizar estado". O BedFlow irá então:

  1. Obter o ID do canal Channex → guardar na ChannelConnection do BedFlow
  2. Executar POST /channels/{id}/activate contra o Channex → o canal muda de disabled para ativo
  3. O estado muda para "Pedido no OpenGDS — aguardar aceitação" (pending_ota)

Está a receber "Mapeamento ainda não completo" como aviso? Volte ao modal do Channex, preencha completamente o separador Mapping e clique novamente em "Concluído".

Passo 5 — OpenGDS confirma

O OpenGDS valida o seu pedido de ligação do lado do servidor, normalmente 24–72 horas. Receberá um e-mail do OpenGDS assim que for aprovado. Não é necessária qualquer ação manual da sua parte.

O estado muda automaticamente para "Ativo — o seu canal está em direto" quando o OpenGDS aceitar.

Múltiplos planos de tarifa por quarto (Natuurhuisje / VIPIO / CharmantHotel)

O OpenGDS agrega para três sub-distribuidores a jusante populares:

| Sub-feed | Nicho | Quando relevante | |---|---|---| | Natuurhuisje | Turismo de natureza — cabanas, casas de férias em ambiente rural | Se o seu alojamento se situa no meio de uma área natural | | VIPIO | Estadias de luxo e incomuns | Boutique B&B, suites com spa | | CharmantHotel | Hotéis boutique encantadores em NL/BE/LU/DE | Especificamente para viajantes de língua neerlandesa |

Quer uma estratégia de preços própria por sub-distribuidor? O BedFlow suporta isso através de "planos de tarifa adicionais" por quarto × canal. Configuração única via artisan:

# Para o Quarto 1 — adicionar 3 planos de tarifa adicionais:
php artisan channex:configure-extra-rate-plan 1 opengds "Natuurhuisje"
php artisan channex:configure-extra-rate-plan 1 opengds "VIPIO"
php artisan channex:configure-extra-rate-plan 1 opengds "CharmantHotel"

# Depois uma sincronização Channex única para que os planos de tarifa sejam criados:
# (através da página Connections → mosaico OpenGDS → Sync, ou uma chamada artisan tinker)

# Ver o que já tem:
php artisan channex:configure-extra-rate-plan 1 opengds "" --list

# Remover:
php artisan channex:configure-extra-rate-plan 1 opengds "VIPIO" --remove

Após a sincronização aparecem 3 planos de tarifa adicionais na sua conta Channex sob OpenGDS:

  • Kamer 1 — Opengds — Natuurhuisje
  • Kamer 1 — Opengds — VIPIO
  • Kamer 1 — Opengds — CharmantHotel

No seu extranet do OpenGDS associa cada plano de tarifa ao sub-feed a jusante correto (plano de tarifa Natuurhuisje → feed Natuurhuisje, etc.). Depois o BedFlow envia automaticamente disponibilidade + preço para todos os planos de tarifa.

⚠️ Preços por nicho — atualmente o BedFlow envia o mesmo preço de canal para todos os planos de tarifa de um quarto sob o mesmo canal. Quer um preço diferente por nicho? Isso está no roadmap: modificador por plano de tarifa (ex. "VIPIO = principal + 10%"). Até lá: preço OpenGDS igual para todos os sub-distribuidores.

💡 Interface Filament a seguir — por agora a configuração é via artisan; uma interface Filament na página Connections (mosaico OpenGDS com repeater) virá numa PR de seguimento. Para 4 quartos × 3 sub-feeds são 12 comandos, apenas uma vez.

Perguntas frequentes

Vejo quartos no extranet do OpenGDS com nomes que não reconheço

São os próprios modelos de quartos do OpenGDS ou remanescentes de um onboarding anterior com eles. Não conseguimos eliminá-los através do Channex — o OpenGDS gere a sua própria taxonomia de quartos. Utilize o extranet do OpenGDS ou envie um e-mail ao seu suporte para limpeza. O que pode fazer no separador Mapping do Channex: mapear apenas os modelos que correspondem aos seus quartos; deixar os restantes em "Not mapped".

Envio para a VIPIO e o Charmant Hotel separadamente? Por padrão: uma ligação ao OpenGDS agrupa todos os seus sub-canais — um push = todos os parceiros de distribuição recebem o mesmo preço e disponibilidade. Quer preços diferentes por sub-distribuidor? Configure então planos de tarifa adicionais (veja a secção acima).

Qual é a comissão padrão? 22% (divisor 0,78). O OpenGDS tem a comissão mais elevada dos nossos canais suportados — isso compensa a distribuição mais ampla para os sub-canais.

A ativação já dura uma semana, e agora? Envie um e-mail para support@bedflow.eu com o seu Hotel Code e nome da property. Podemos pedir ao Channex para reativar ou consultar o estado no OpenGDS.

Precisa de ajuda?

Envie um e-mail para support@bedflow.eu com o nome da sua property no BedFlow.

← Voltar à categoria