Propriedade — Configuração completa

Use as abas abaixo: Conta & propriedade, ficha (Geral, canais, OTA, API, iCal) e atalhos Pricing, Calendário, Promoções, Galeria e Relação (mapas). Atalhos na URL: #ical, #pricing, #calendario, #promocoes, #galeria, #relacao (com tenant e propriedade escolhidos). Dados em gocore.accommodation; ligações em channel_property_connections.

Visualização pública (ficha no site) Detalhe — ficha pública Detalhe — alojamento.php Usa o id gocore da propriedade seleccionada. Sem propriedade escolhida, os botões ficam inactivos.

Propriedade

Conta & channel managers

Com uma só conta mostramos o nome sem selector de tenant. Com tenant seleccionado mostramos domínios relacionados e anfitriões (dados em tenant_config e, para anfitriões, owner_id distintos nas propriedades carregadas). Os cartões abaixo cruzam gocore com contagens Smoobu / Beds24 (API), ligações Avantio em channel_property_connections e o resumo de ligações por portal. Clique num cartão para listar.

Ligar portais / API Adicionar conta Adicionar domínio

—

Conta (tenant)

Gestor desta conta — Opcional: em app_admin/data/tenant_config.json acrescente account_manager_name (ou manager_name) no objecto do tenant.

Propriedade

Filtre por texto, tipo e localização (quando existirem colunas na BD). O select nativo fica oculto mas sincronizado para compatibilidade.

Ajuda — Dados gerais

Define a ficha base da unidade na base CheckInAll (gocore.accommodation): tipo, nome comercial, IVA, número de registo (AL) e modelo de reserva. Estes dados alimentam reservas, compliance e relatórios. O Property Id (api_id) e o Smoobu apartment id são informativos aqui — as ligações activas gerem-se em Channel manager e a chave técnica em API & exportação.

Dados gerais

Preencha tipo, nome e modelo de reserva.
IVA e registo AL quando aplicável.
Guarde — depois avance para Channel manager e API.

Property Id ?

Property Type ?

Vat Rate % ?

Property Name ?

Type of Booking ?

Permit Id ?

Smoobu apartment id ?

Ajuda — Channel manager

Liga esta propriedade interna ao listing Smoobu (ID externo) e escolhe se a sincronização de canais via Beds24 / Smoobu está ligada ou em pausa. Para cruzar quartos, Beds24, JSON e vários OTAs use Ligação de casas. Nesta página a ligação directa por ID é sobretudo para Smoobu; outros portais entram pelo CM ou pelo mapa.

Channel manager

Ligue o apartamento Smoobu a esta propriedade interna. Mapa completo (quartos, Beds24, JSON) continua em Ligação de casas.

Portais compatíveis

O channel manager só oferece ligação directa por ID para Smoobu nesta página; Beds24/OTAs passam pelo mapa; Avantio e SU API por credenciais; Lodgify, Guesty e Rentals United em roadmap.

Confirme propKey e api_id no separador API.
Carregue a lista Smoobu (API) e escolha o apartamento, ou escreva o ID manualmente.
Guarde a ligação; active ou desactive a sincronização.

Modo de sincronização

Canais activos (Beds24 / Smoobu) Desactivado (sem push/pull de canais)

Ligações actuais

Canal	ID externo	Estado
—

Nova ligação rápida (Smoobu)

Apartamentos na conta Smoobu

Seleccionar apartamento existente

Canal

ID apartamento / listing

Abrir mapa completo

Ajuda — Importar OTA / PMS

Concentra atalhos para o mapa Smoobu ↔ Beds24, importação gocore passo-a-passo e preços por canal, já com o tenant seleccionado no topo. Use o comparador e a checklist para alinhar a ficha com o OTA escolhido; dados em tempo real no site do portal só com programas partner ou export do CM (ver caixa abaixo).

Importar desde OTA / PMS

Escolha a ferramenta e, se quiser, um canal OTA para comparar dados e seguir uma checklist operacional. O tenant seleccionado em cima é passado às ferramentas.

Importar directamente de Airbnb, Booking.com, VRBO, Expedia, Trip.com, etc.? Estes portais não oferecem uma API pública genérica para qualquer PMS importar fichas completas: o acesso técnico passa por programas de parceiro (ex.: Connectivity Booking.com, parcerias Airbnb), contratos e homologação. Na prática, o fluxo suportado hoje no CheckInAll é via channel manager (Smoobu, Beds24, …), que já sincroniza com os OTAs — depois o mapa JSON e o gocore consolidam os dados internamente. Integrações «one-click» directas por canal são roadmap e dependem dessas parcerias.

Canal OTA (comparador & acções)

Ajuda — Ferramentas

Escolha o fluxo (mapa JSON, importação API gocore ou preços por canal) e abra a página dedicada; o tenant actual é passado no contexto para evitar reconfigurar.

Origem da ferramenta

«Importar tudo» no sentido operacional = gravar mapa + correr importação na página dedicada; aqui abrimos a ferramenta certa com o tenant já escolhido. Os OTAs em si entram pelos dados que o CM sincroniza, não por um botão separado por marca.

Ajuda — Comparador

Mostra lado a lado campos na BD CheckInAll e o que está ligado ao OTA seleccionado (IDs e metadados conhecidos). Serve para validar antes de gravar mapeamentos; não substitui leitura directa da ficha no site do portal.

Comparação lado a lado: valores actuais no gocore (esta propriedade) vs. o que tiver sido registado no canal. A coluna do canal só mostra IDs de ligação conhecidos; ficha completa no OTA em tempo real exige API partner ou export do CM (roadmap).

Campo	gocore (CheckInAll)	Canal (seleccionado)

Ajuda — Acções neste canal

Lista de tarefas operacionais por OTA (preços, fotos, políticas, etc.). Marque o que já fez; o progresso fica só neste browser (chave: tenant + propriedade + canal) — não sincroniza entre dispositivos.

Checklist operacional para alinhar esta propriedade com o canal escolhido. As marcações ficam guardadas neste browser (por tenant + propriedade + canal).

API (propKey) & exportação

Ajuda — API & exportação

O propKey (beds24_prop_key) identifica esta propriedade no Beds24 (API JSON): mensagens inbox e reservas por alojamento. Tem prioridade sobre a PropKey «por defeito» em Integrações e chaves. A API unified_messaging/api/beds24_inbox.php usa este valor quando envia accommodation_id (id interno do alojamento). Alinhe com o mapa Smoobu ↔ Beds24. Exportar JSON gera um snapshot para auditoria ou import no mapa.

propKey ?

Ajuda — iCal (estilo portal)

Esquerda: links secretos (?t= token) para colar em cada canal (Airbnb, Booking, VRBO, etc.) e mostrar a ocupação exportada pelo CheckInAll a partir de channel_bookings — pode gerar um URL por propriedade e por quarto. Direita: ligue N canais em simultâneo: adicione uma linha por calendário externo (nome do canal + URL iCal). Não há limite artificial no número de fontes; use Testar feed para validar cada URL. A fusão automática de bloqueios no calendário CheckInAll a partir destes feeds é evolução futura (cron). Regenerar invalida o URL de exportação. Por quarto na exportação, alinhe api_room_id no Channel Mapping.

iCal — exportação & links do portal

Colar no portal (exportação CheckInAll)

Cole estes URLs no iCal / calendário do parceiro para mostrar indisponibilidade exportada pelo CheckInAll.

Teste rápido: copie o URL e abra num separador ou use curl -sI — deve responder 200 com Content-Type: text/calendar.

URL iCal da propriedade

Por quarto (room)

Quarto	api_room_id	URL
—

Importar calendários de parceiros

Vários canais: repita «Adicionar fonte iCal» para cada OTA ou site (Airbnb, Booking.com, VRBO, Holidu, etc.) — um URL de exportação iCal por canal, sem limite de linhas. Dê um nome claro ao canal, defina se o calendário cobre toda a propriedade ou um quarto, e cole o URL (http, https ou webcal). Pode editar, testar e remover cada ligação. Testar abre a vista anual e compara ocupação do feed com as reservas em channel_bookings (útil vs. Airbnb). Preços: o iCal só traz disponibilidade/ocupação — não importa tarifas; preços entram pelo channel manager, hub Daily Prices / pricing ou ferramentas internas, não por este URL.

Airbnb — onde obter o link de exportação

Calendário (anfitrião) → escolha o anúncio → Disponibilidade.
Em Ligar calendários → Ligar a outro site → copie o link do calendário Airbnb (deve terminar em .ics ou incluir /calendar/ical/).
Não partilhe esse URL publicamente; trate-o como credencial. Se expuser, regenere na Airbnb.
O feed traz disponibilidade / reservas, não preços nem descontos.

Coerência (Airbnb por defeito): com «Verificar coerência» activo, o servidor compara noites bloqueadas em channel_bookings com o iCal externo (janela ~1 ano). Se o desvio persistir ≥ 5 minutos, envia e-mail aos admins (CHECKINALL_COHERENCE_ALERT_EMAIL ou CHECKINALL_PRICING_SUPERVISOR_EMAIL) e mostra alerta aqui. Agendar cron a cada 2 horas, p.ex. 0 */2 * * * php …/partner_ical_coherence_cron.php ou HTTP com CHECKINALL_CRON_SECRET (ver accommodation/crontab.partner_ical_coherence.example).

Parceiro	Âmbito	Verif.	Calendário e acções
—

Ajuda — Pricing

O hub de preços concentra Daily Prices, regras, channel mapping e sync entre CMs. Os links com acc= abrem já esta propriedade (id gocore).

Pricing — preços e canais

Atalhos para a equipa: escolha tenant e propriedade acima; depois abra o módulo desejado.

Daily Prices (grelha) Channel mapping

Hub de preços (índice) Tarifas (revenue) Fixed prices Daily price rules Sync entre CMs

Ajuda — Calendário

O calendário operacional de preços está no Daily Prices (por dia). O mockup Beds24 é referência visual; a grelha real usa a BD accommodation_8_rate_seasons.

Calendário — disponibilidade e preços por dia

Use a grelha Daily Prices para editar valores; o mockup ajuda a alinhar com a UX Beds24.

Abrir Daily Prices (esta propriedade) Mockup Beds24 (controlo) Mockup Beds24 (HTML)

Ajuda — Promoções

Promotions guarda metadados OTA (Booking / Expedia, …). Promoções membership aplicam-se a canais directos / website. Filtre por propriedade quando o URL levar acc=.

Promoções — OTAs e membership

Ligações para o módulo de preços gocore.

Promotions (OTA) — esta propriedade Promoções membership (plataforma) Tarifa não reembolsável

Ajuda — Galeria

Ao escolher este separador abre-se o gestor de galeria completo (modal): upload, filtros, edição e relação a propriedades/quartos em gallery_media. Abaixo segue um resumo das fotos ligadas ao alojamento; tratamento em lote da coluna pictures / ficheiros em /accommodation/uploads/property/{id}/ nos links.

Galeria — fotos e media

O separador abre o gestor completo em modal (mesma página que /accommodation/admin/admin_gallery/gallery_manager.html). A grelha abaixo usa gallery_media (não use /admin/accommodation/… — 404 neste servidor). Propriedade activa: —.

Tratamento de fotos (lote) Índice galeria admin

Fotos ligadas a esta propriedade

Clique numa miniatura para editar metadados, temas e ligações (como no gestor). Enviar faz upload para a galeria central e associa automaticamente a este alojamento.

Ajuda — Relação (mapas)

Mapas entre Smoobu ↔ Beds24 / gocore, api_id e canais. O tenant na query alinha com a conta seleccionada.

Relação — mapas e ligações

Ferramentas usadas pela equipa para cruzar IDs externos com o alojamento gocore.

Ligação de casas (mapa completo) Channel mapping (api_id / quartos) Preços Smoobu ↔ Beds24 Mapa Smoobu (webmaster)

Visão geral desta página

Configure uma propriedade gocore por vez: escolha tenant e alojamento no topo, depois use as abas (Geral, Channel manager, OTA, API, iCal, Pricing, etc.).

Atalhos na URL: #geral, #ical, #pricing, … — com tenant e propriedade já seleccionados. Os dados vêm de gocore.accommodation e ligações em channel_property_connections.

Ao recarregar com #ical, a página posiciona-se no topo (cabeçalho e filtros) mantendo o separador iCal activo depois de carregar a ficha.

Separador iCal — exportar, importar e coerência

Exportação (esquerda): gera URLs com token secreto (?t=) para colar nos portais (Airbnb, Booking, …). Mostram ocupação a partir de channel_bookings. Pode haver URL por propriedade e por quarto. Regenerar invalida o link antigo.

Importação (direita): Adicionar fonte iCal por cada calendário externo. Indique parceiro, âmbito (toda a propriedade ou quarto) e URL (https, http ou webcal). Na tabela use Copiar, Testar (abre comparador anual iCal vs PMS), Alterar e Remover.

Preços: feeds iCal não incluem tarifas. Para importar ou sincronizar preços use o channel manager (Smoobu, Beds24, …), o módulo Daily Prices / hub de pricing da plataforma ou importações suportadas pela equipa — não pelo URL iCal da Airbnb.

Coerência: com «Verificar coerência» activo, o servidor compara bloqueios em channel_bookings com o feed iCal (janela ~1 ano). Desvio contínuo ≥ 5 minutos dispara e-mail aos admins e alerta na página. O job recomendado corre a cada 2 horas — ver accommodation/crontab.partner_ical_coherence.example.

Airbnb: o bloco colapsável «Airbnb — onde obter o link» explica o caminho na extranet. Trate o URL iCal como credencial.

URL directa e partilha

Pode combinar query com hash, por exemplo ?tenant=SEU_TENANT&id=ID_GOCORE#ical, para abrir já o tenant, a propriedade e o separador iCal (após carregar a lista).

Ficha pública no site usa o id gocore nos atalhos «Detalhe» do cabeçalho desta página.