Integrações e distribuição
A VIVIN liga o seu portefólio aos sítios onde arrenda quartos, ao software que emite as suas faturas e às fechaduras das suas portas. Esta página explica cada tipo de integração, o que faz por si e onde a configura.
Onde encontrar: Definições → Integrações (https://platform.vivin.app/settings/integrations). Os Super Admins e os Admins têm acesso por defeito. Liga as unidades às plataformas uma a uma em Vendas → Gestor de Canais ou no editor da unidade em Anúncios. Para os campos de cada cartão, veja Definições → Integrações.
Integrações num relance
| Tipo | Integrações | Onde configura | O que obtém |
|---|---|---|---|
| Plataformas de reserva de média duração | Inlife, Uniplaces, Spacest, Spotahome, Housing Anywhere, Erasmus Life Lisboa | Cartões de Plataformas de reserva, e depois ligar cada unidade | Anúncios e disponibilidade publicados na plataforma. Reservas criadas na VIVIN |
| Canais de curta duração | Airbnb, Booking.com | Uma conta de canal em Integrações de plataforma, ou um link de calendário por unidade | Sincronização nos dois sentidos de preços, disponibilidade e reservas, ou importação num só sentido das datas bloqueadas |
| O seu próprio site | Motor de reservas Vivin | Cartão de Plataformas de reserva | Reservas diretas criadas na VIVIN |
| Outras origens de reservas | Idealista, Edu Portugal, Coliving, SRF (Student Room Flat) | Cartões de Plataformas de reserva | Comissão (e margem, exceto no Edu Portugal) nas reservas que adiciona manualmente. O Idealista recebe ainda um ficheiro de anúncios de hora a hora |
| Faturação | Invoice Express, Hostkit, Faturação VIVIN, NetSuite, A-Cube (faturação eletrónica italiana), Sage 50c | Integrações de plataforma | Faturas, recibos e notas de crédito emitidos por si |
| Fechaduras inteligentes | Conta Nuki | Integrações de plataforma | Acesso às portas para os inquilinos |
| Pagamentos dos inquilinos | EasyPay (cartão e IBAN virtual) | Configurado pela VIVIN | Pagamentos online registados no plano de pagamentos |
| Clientes de IA | Claude, ChatGPT, Gemini e outros clientes MCP | Definições → IA / MCP | A sua própria ferramenta de IA pode ler os seus dados da VIVIN |
Como as peças se encaixam
A ligação a uma plataforma de reserva tem três camadas, da conta até cada anúncio:
| Camada | O que decide | Onde a define |
|---|---|---|
| Conta | Que plataformas utiliza. As plataformas de reserva estão ativadas por defeito, e só as plataformas ativadas têm uma coluna em Vendas → Gestor de Canais. | Um cartão por plataforma em Plataformas de reserva |
| Unidade | Que unidades a plataforma recebe. No Uniplaces, Spotahome, Housing Anywhere, Inlife e Idealista, o feed leva todas as unidades, a menos que as exclua (as unidades de propriedades arquivadas ficam de fora); ligar uma unidade ao seu anúncio existente faz a correspondência entre os dois. No Spacest e no Erasmus Life Lisboa, só as unidades que ligar. | Listagens nas integrações da unidade, e os links da unidade |
| Conteúdo do anúncio | O que o anúncio diz e mostra. As plataformas que publicam anúncios completos (Uniplaces, Spotahome, Housing Anywhere, Inlife, Idealista) e o Motor de reservas Vivin precisam de descrições, comodidades e fotografias; o cartão Prontidão para full integration mostra o que falta. | Os separadores Integração completa e Fotos dos editores da propriedade e da unidade |
Plataformas de reserva de média duração
Clique no cartão de uma plataforma em Plataformas de reserva para o abrir e, depois, clique em Editar:
- Comissão e IVA da comissão guardam a taxa da plataforma. As reservas da plataforma mostram-nas como Comissão estimada da plataforma. Não ficam registadas nos Fluxos de Caixa.
- Bloqueio de calendário (dias): se a última estadia ou bloqueio de uma unidade terminar daqui a mais do que este número de dias, a plataforma também vê a unidade como indisponível depois dessa data. Isto impede a plataforma de vender datas muito distantes.
- Email da integração é o endereço de email da sua conta na plataforma. Indica à plataforma quais os anúncios que são seus.
- Margem (Nenhum, Percentagem (%) ou Fixo) aumenta a renda para esta plataforma. Altera tanto o preço que a plataforma mostra como a renda das reservas que dela vêm.
- IBAN virtual (Copiar IBAN) aparece quando a VIVIN emitiu um para a plataforma. Entregue-o à plataforma para os seus pagamentos, para que a VIVIN consiga reconhecer o dinheiro que entra.
- O botão (i) junto ao nome da plataforma (por exemplo, O que o Uniplaces suporta) lista os campos do anúncio que a plataforma recebe.
O ícone do lixo num cartão desativa a plataforma e mantém os seus valores. Para a voltar a ativar, clique em Adicionar em Integrações de plataforma e escolha-a no grupo Plataformas de reserva. Pode adicionar cada plataforma uma vez.
Ligue cada unidade num de dois sítios:
- Anúncios → abra a unidade → Configuração → Canais → Adicionar URL do anúncio na linha da plataforma.
- Vendas → Gestor de Canais → clique na célula Sem integração da unidade → cole o URL completo do anúncio em Link do anúncio (um ID de anúncio sozinho não é aceite) → Integrar.
Para cada unidade no feed de uma plataforma:
- A VIVIN publica a renda, as taxas, a caução, as regras de estadia e as datas indisponíveis da unidade. Cada plataforma lê estes dados ao seu ritmo, por isso uma alteração pode demorar um pouco a aparecer lá.
- Quando um inquilino reserva na plataforma, a VIVIN cria a reserva com um plano de pagamentos construído a partir da renda e das taxas da unidade e das predefinições da sua conta. Recebe uma notificação quando a reserva é criada. Recebe também uma quando não pode ser criada, por exemplo porque as datas coincidem com outra reserva. Adicione essa reserva manualmente.
- Para manter uma unidade fora de uma só plataforma, abra o separador Integração completa da unidade e desative a plataforma em Listagens nas integrações (Excluído do feed).
As reservas do Uniplaces, Spotahome, Housing Anywhere e Spacest chegam à VIVIN através do email de confirmação da plataforma:
- Reencaminhe todas as confirmações para o endereço de reservas que a VIVIN lhe dá no onboarding (se não o tiver, peça através de Ajuda e suporte). Uma regra de reencaminhamento automático na sua caixa de correio é a forma mais fiável.
- A VIVIN encontra a unidade pelo ID do anúncio da plataforma, que vem no email. Ligue primeiro a unidade a esse anúncio: se o ID do anúncio não estiver ligado a uma unidade, não é criada nenhuma reserva. Recebe um alerta que explica como o ligar quando o email foi reencaminhado a partir de um endereço de um dos seus utilizadores ou enviado para o seu Email da integração dessa plataforma.
- Só são importadas as reservas confirmadas. Pedidos, recusas, alterações de datas, cancelamentos e mensagens são ignorados, por isso aceite primeiro o pedido na plataforma.
- Uma confirmação que falha não é repetida. Corrija a causa (por exemplo, liberte as datas) e depois adicione a reserva manualmente com essa plataforma como Plataforma e o que o inquilino lá pagou como Valor do primeiro pagamento.
Idealista: depois de a VIVIN configurar o envio consigo, a VIVIN envia todas as suas unidades ativas para o Idealista num ficheiro, de hora a hora, sem ligar unidades. As reservas do Idealista, Edu Portugal, Coliving e SRF (Student Room Flat) são adicionadas manualmente: escolha a plataforma como origem da reserva. Alguns parceiros ligam-se a uma única conta de senhorio e não têm cartão. A VIVIN configura-os por si.
Airbnb e Booking.com
Cada unidade sincroniza com o Airbnb ou o Booking.com de uma de duas formas: uma Integração completa, com preços, disponibilidade e reservas nos dois sentidos através de uma conta de canal em Integrações de plataforma, ou um Link de calendário (iCal), que apenas importa as datas que o canal bloqueou. As reservas de uma integração completa espelham o canal, por isso as respetivas datas, unidade e inquilino alteram-se lá, não na VIVIN. Para os passos de configuração e o que cada forma importa, veja Airbnb e Booking.com.
Motor de reservas Vivin
O cartão Motor de reservas Vivin liga o motor de reservas do seu próprio site. O site lê da VIVIN os seus anúncios, preços e disponibilidade. As reservas feitas no site são criadas na VIVIN como qualquer outra reserva de plataforma. O conteúdo do anúncio vem do separador Integração completa. O cartão mostra uma Chave API da integração só de leitura, com apenas os últimos caracteres visíveis. O seu programador web encontra os detalhes técnicos na API do Motor de Reservas.
Faturação
Adicione o seu fornecedor de faturação em Integrações de plataforma → Adicionar:
| Fornecedor | O que introduz |
|---|---|
| Invoice Express | ID da API e Chave API |
| Hostkit | Nada, ao início. Depois clique em Chaves por anúncio no cartão e adicione uma chave Hostkit por anúncio |
| Faturação VIVIN | Nada a ligar. Clique em Configurar no cartão para definir os dados do emitente, a numeração, as taxas de imposto e os modelos Word |
| NetSuite | ID da conta, ID de cliente OAuth, ID do certificado e chave privada. Clique em Configurar para definir as predefinições das faturas e o mapeamento das classes de propriedade |
| A-Cube (faturação eletrónica italiana) | O email e a palavra-passe da sua conta A-Cube, mais Sandbox (testes) ou Produção. Depois abra as Definições de faturação italiana |
| Sage 50c | Não é self-service: o cartão diz Contacte a equipa VIVIN para ativar |
O Invoice Express, o Hostkit e o Sage 50c funcionam cada um sozinho: não se pode adicionar outro fornecedor de faturação a seu lado. A Faturação VIVIN, o NetSuite e o A-Cube podem ser combinados. Uma ligação é a geral (etiqueta Fallback), e cada ligação adicional trata dos Tipos de pagamento e/ou dos Proprietários que escolher. Os códigos de imposto, as datas das faturas e a série de faturas do Hostkit definem-se em Definições → Faturação; veja Faturação.
Fechaduras inteligentes (Nuki)
- Vá a Definições → Integrações, clique em Adicionar em Integrações de plataforma, escolha Conta Nuki, cole a sua Chave API e clique em Adicionar integração.
- No editor da propriedade (Configuração → Cacifos de acesso), defina Porta do edifício ou Porta da propriedade como Cacifo Nuki e escolha a fechadura. No editor da unidade (Configuração → Informação da unidade), o Acesso à porta da unidade está sempre visível — defina-o como Cacifo Nuki e escolha a fechadura.
- O email automático de check-in da VIVIN convida o inquilino para a app Nuki. Se uma regra de email substituir esse email, ative Enviar convite Nuki na regra (Definições → Comunicações). Para voltar a enviar um convite, use Reenviar acesso Nuki na reserva. Nas Definições do portal, ative Permitir abrir a app Nuki a partir do portal para um link Abrir a app Nuki no Início, ou Permitir abrir portas Nuki a partir do portal para um desbloqueio dentro do portal.
Pagamentos dos inquilinos
Os pagamentos por cartão e por IBAN virtual (vIBAN) através da EasyPay são ativados na sua conta pela VIVIN, por isso não há nada a adicionar no separador Integrações. Só funcionam em contas que usam EUR. Noutras moedas, regista os pagamentos manualmente. Os pagamentos que entram ficam registados no plano de pagamentos da reserva.
API de parceiros, feeds de calendário e IA
- API de parceiros: as plataformas de reserva leem os feeds dos seus anúncios e enviam reservas através da API de parceiros da VIVIN, com um acesso que a VIVIN emite. Os detalhes técnicos estão na referência da API.
- Feed de calendário por unidade: cada unidade tem um link de calendário público da VIVIN. Em Vendas → Gestor de Canais, clique em Copiar iCal na linha da unidade e cole o link em qualquer plataforma que importe calendários.
- Clientes de IA: o aviso no topo de Definições → Integrações tem um botão Ir para o MCP que abre Definições → IA / MCP. Veja Ligar o Claude, o ChatGPT ou outras ferramentas de IA.
Dicas
- Não há coluna de uma plataforma em Vendas → Gestor de Canais? Clique em Adicionar em Integrações de plataforma: se a plataforma estiver listada no grupo Plataformas de reserva, está desativada, por isso escolha-a para a voltar a ativar. O Idealista, o Edu Portugal, o Coliving e o SRF nunca têm coluna.
Ver também
- Definições → Integrações: todos os cartões e campos em detalhe
- Airbnb e Booking.com: integração completa e links de calendário para estadias curtas
- Anúncios: Canais, Curta duração e Integração completa da unidade
- Referência da API: feeds de parceiros, iCal e endpoints de reservas
- Onboarding de uma nova propriedade: lista de configuração de ponta a ponta