Integrações
Ligue a VIVIN aos serviços que já usa e configure cada plataforma onde as suas unidades estão anunciadas.
Antes de começar
- Onde: Definições → Integrações (
https://platform.vivin.app/settings/integrations). - Plano: todas as contas têm este separador. O trabalho diário nos canais faz-se depois em Vendas → Gestor de Canais.
- Permissões: Account Settings → Module e Account Settings → Integrations para abrir o separador. Utilities → Edit Connections para ver, acrescentar ou remover ligações. O Super administrador e o Administrador têm as três por defeito. Alterar a Margem de uma plataforma precisa também de Finance → Approve Payments, que por defeito só o Super administrador tem. Guardar a Data máxima iCal (curta duração) precisa de Account Settings → Preferences ou Fees.
O separador tem quatro blocos, de cima para baixo:
- Um banner com Ir para o MCP, que abre IA / MCP.
- Integrações de plataforma: ligações que precisam de credenciais ou de um início de sessão.
- Plataformas de reserva: um cartão por plataforma de anúncios. Veja Plataformas de reserva.
- Gestor de canais: a Data máxima iCal (curta duração).
Integrações de plataforma
Cada ligação é um cartão com o seu nome, a data em que a acrescentou ("Adicionado em …") e as suas ações. Adicionar abre o seletor Adicionar integração, com dois grupos: Integrações (abaixo) e Plataformas de reserva.
| Ligação | Para que serve | O que introduz | Onde se configura |
|---|---|---|---|
| Conta Nuki | Acesso dos inquilinos por fechadura inteligente | Chave API | Nuki |
| Invoice Express | Faturação portuguesa | ID da API e Chave API | Ligações de faturação |
| Hostkit | Faturação portuguesa (Fatura-Recibo) | Nada; depois uma chave por anúncio | Hostkit |
| NetSuite | Faturação através do seu ERP NetSuite | Quatro credenciais do NetSuite | NetSuite |
| Faturação VIVIN | A faturação integrada da VIVIN | Nada; depois Configurar | Faturação VIVIN |
| A-Cube (faturação eletrónica italiana) | Faturas e recibos eletrónicos italianos (SdI) | O início de sessão A-Cube e o Ambiente | A-Cube |
| Airbnb | Sincronização total com uma conta de anfitrião Airbnb | Nada; depois aprove no Airbnb | Airbnb e Booking.com |
| Booking.com | Sincronização total com uma conta Booking.com | Nada; depois os IDs dos hotéis | Airbnb e Booking.com |
Todas as ligações aceitam também um Nome a apresentar opcional, útil quando tem duas do mesmo tipo. O Sage 50c aparece como um cartão a cinzento, "Contacte a equipa VIVIN para ativar".
Para acrescentar uma ligação:
- Clique em Adicionar.
- Em Integrações, escolha o fornecedor. Um fornecedor de faturação que não pode funcionar a par do que já tem mostra "(já configurado)" e não pode ser escolhido.
- Preencha os campos e clique em Adicionar integração.
Para remover uma, clique no ícone do caixote do lixo (Remover integração) no seu cartão e depois em Remover ligação em Remover ligação da conta. Não pode desfazer, e tudo o que usa a ligação pode deixar de funcionar. Uma ligação Faturação VIVIN, NetSuite ou A-Cube que tenha emitido faturas, proformas ou notas de crédito não pode ser removida.
Nuki
| Campo | O que faz | Predefinição |
|---|---|---|
| Chave API | A chave API da sua conta Nuki. | — |
Depois de acrescentar a Conta Nuki, defina a fechadura de cada porta como Cacifo Nuki em Anúncios: as portas do edifício e da propriedade em Cacifos de acesso, na propriedade, e a porta da unidade em Acesso à porta da unidade, na unidade (Configuração → Informação da unidade). A VIVIN cria então o acesso Nuki para cada reserva e envia o convite da app Nuki ao inquilino com o email de check-in. Reenviar acesso Nuki, numa reserva, envia-o de novo.
Nas Definições do portal, Permitir abrir portas Nuki a partir do portal acrescenta ao portal um botão para destrancar e Permitir abrir a app Nuki a partir do portal acrescenta uma ligação para a app Nuki.
Gestor de canais
| Campo | O que faz | Predefinição |
|---|---|---|
| Data máxima iCal (curta duração) | A partir desta data, os feeds iCal da VIVIN mostram todas as unidades como bloqueadas. | Não definida |
As plataformas que leem as suas ligações iCal, normalmente o Airbnb e o Booking.com, deixam então de poder vender datas posteriores.
- Em Gestor de canais, clique no lápis, escolha uma data e clique em Guardar. A mesma data aparece, e pode ser alterada, como Data máxima (curta duração) nos cartões Airbnb e Booking.com.
- Para a copiar para as suas unidades, use o cartão Airbnb ou Booking.com: Aplicar a todos os anúncios copia-a para todas as unidades. No cartão Airbnb pode, em alternativa, escolher unidades com Selecionar anúncios ou Selecionar categorias e depois Aplicar aos anúncios selecionados.
A Data máx. curta duração própria de uma unidade, em Anúncios, prevalece sobre a data da conta. Os controlos do cartão só funcionam depois de acrescentar essa plataforma.
O que acontece quando guarda
- Uma nova ligação fica disponível de imediato. Uma ligação de faturação emite a partir do documento seguinte.
- Remover uma ligação interrompe tudo o que a usava.
- Uma nova Data máxima iCal (curta duração) altera os feeds iCal de imediato, mas as unidades mantêm a data que lhes foi dada até a aplicar de novo.
Resolução de problemas
- "A chave API é obrigatória." ou "O ID da API é obrigatório para o Invoice Express.": preencha as credenciais antes de Adicionar integração.
- Um fornecedor de faturação mostra "(já configurado)": o Invoice Express, o Hostkit e o Sage 50c não podem funcionar a par de outro fornecedor de faturação. Remova primeiro o antigo.
- Os calendários no Airbnb ou no Booking.com terminam numa data fixa: verifique a Data máxima iCal (curta duração) e aplique-a de novo às suas unidades.
Dicas
- Acrescentar uma plataforma não anuncia as suas unidades nela. Crie o anúncio na plataforma e associe cada unidade em Vendas → Gestor de Canais.
Relacionado
- Ligações de faturação
- Airbnb e Booking.com
- Plataformas de reserva
- Como funcionam as integrações
- Vendas: Gestor de Canais e ligações iCal