Visão geral das integrações

Em Integrações, liga serviços externos ao seu workspace Univents — desde o processamento de pagamentos e a sincronização de calendário e e-mail até à exportação DATEV para a contabilidade e aos acessos para automatizações próprias.

A página é um diretório: cada integração tem o seu próprio cartão, e um clique nele abre a página de detalhe correspondente com todas as definições.

Como se orientar no diretório

Navegue na barra lateral esquerda até Integrações. Chega à página Todas as integrações com todos os cartões.

• À esquerda, a barra «Categorias» — Todos, Contabilidade, Pagamentos, E-mail e calendário, IA e Programadores, cada uma com o número de integrações ao lado. Um clique filtra os cartões; permanece na visão geral, a página não muda.
• A categoria escolhida aparece na barra de endereço — pode, por isso, partilhá-la como ligação, por exemplo com uma colega que só deva ver as ligações de contabilidade.
• Campo de pesquisa no topo (Pesquisar integração) — escreva o nome de um fornecedor ou uma palavra-chave para saltar diretamente para o cartão certo.
• No telemóvel, a barra de categorias abre-se e fecha-se como uma fila de chips por cima dos cartões.
• Clicar num cartão abre a página de detalhe da integração. Em cima, à esquerda, ← Todas as integrações leva-o de volta ao diretório em qualquer momento.

O que um cartão diz num relance

• Ponto verde com «Ligado» — a integração está configurada e ativa neste workspace.
• Distintivo «Brevemente disponível» — o fornecedor está em preparação e ainda não pode ser ligado.
• Distintivo de plano na forma A partir do Core ou A partir do Growth — a integração ainda não está incluída no seu plano atual. Na página de detalhe encontra a possibilidade de upgrade.

Além disso, os botões no cartão:

• Abrir leva à página de detalhe — aí liga e configura a integração.
• Manifestar interesse aparece em vez de «Abrir» em todos os cartões que ainda estão em preparação.
• Guia abre o artigo de ajuda correspondente, sem ter de o procurar aqui.

O que está disponível hoje

O que está em preparação

Em Contabilidade, vê ainda um cartão para o BuchhaltungsButler. Tem a indicação Brevemente disponível e hoje não pode ser ligado — nem através do suporte.

O que pode fazer: clicar em Manifestar interesse no cartão. Entramos em contacto assim que a ligação estiver pronta. Até lá, existem cinco outros caminhos para a contabilidade: a exportação DATEV e a exportação BMD como ficheiro, ou sevdesk, bexio e Lexware Office como transferência direta — ver a secção «Contabilidade» mais abaixo.

Pagamentos — Stripe

Abra o cartão Stripe. Com o Stripe ativo, os clientes podem pagar diretamente numa reserva online; as receitas são transferidas automaticamente para a conta bancária indicada.

• Clique em Ligar com o Stripe para iniciar o onboarding do Stripe. Será reencaminhado para o site do Stripe.
• Se já iniciou o onboarding mas ainda não o concluiu, vê o botão Continuar onboarding.
• Com a ligação ativa, o Univents mostra o distintivo Ativo junto à entrada do Stripe. Com Desligar, pode terminar a ligação em qualquer momento.

O guia completo encontra-se no artigo Ligar a integração de pagamentos com o Stripe.

Calendário — Google e Microsoft

Através do cartão Calendário, sincroniza eventos nos dois sentidos entre o Univents e o seu programa de calendário.

1. Clique em Ligar calendário para iniciar um início de sessão.
2. Após o início de sessão, aparece o cartão de ligação. No menu pendente Selecionar calendário, escolha o calendário de destino pretendido.
3. Com Atribuir espaços, define quais dos seus espaços devem escrever eventos neste calendário. Sem atribuição, os eventos seguem para todos os calendários ligados.
4. Com Sincronizar agora, obtém manualmente os compromissos externos.
5. Se o cartão de ligação mostrar o distintivo Ligação expirada — ligar novamente, clique no botão com o mesmo nome para renovar o início de sessão.

Os detalhes encontram-se no artigo Configurar a sincronização do calendário.

Caixa de entrada de e-mail — Gmail, Outlook, IMAP

Através do cartão Caixa de entrada de e-mail, espelha os e-mails recebidos no Univents e associa mensagens a pedidos, eventos e contactos.

Antes de ligar, escolha em Visibilidade das novas contas de e-mail:

• Por workspace (predefinição) — todos os administradores veem a caixa de entrada.
• Por utilizador — só a pessoa que ligou a conta a vê. Ainda assim, é possível partilhar e-mails individuais: assim que associar um e-mail a um evento, todos os que podem ver esse evento passam a vê-lo.

Depois, clique em Ligar conta de e-mail e siga o fluxo de início de sessão. Na primeira sincronização, pode demorar até 24 horas até todas as mensagens históricas estarem carregadas. Os detalhes encontram-se no artigo Como integro a minha caixa de entrada de e-mail?.

Entrada de e-mail — pedidos por e-mail

Através do cartão Entrada de e-mail, obtém um endereço Univents próprio. Se reencaminhar pedidos de clientes para esse endereço — ou se o colocar logo no seu site —, cada e-mail chega automaticamente como pedido à caixa de entrada de pedidos, em vez de se perder numa caixa de correio.

Ligações do Claude

Através do cartão Ligações do Claude, liga o seu workspace ao Claude. Depois, pode perguntar aí diretamente por eventos, contactos ou documentos e pedir a execução de tarefas, sem iniciar sessão no Univents. Na página de detalhe vê todas as ligações existentes e pode terminar cada uma individualmente.

Chaves de API

Através do cartão Chaves de API, cria e gere chaves para integrações externas e automatizações próprias.

1. Clique em Criar nova chave.
2. Dê à chave um Nome descritivo (por ex. «Claude Desktop», «n8n Workflow» ou «Exportação DWH»).
3. Em Permissões, escolha os scopes necessários — separados por recurso em Marcar como lida e Escrita (por ex. events:read, contacts:write). Para simples exportações de dados para DWH/BI, bastam os scopes Marcar como lida; mcp:read é o acesso de IA/MCP. Escrita não implica leitura — ambas são selecionáveis individualmente.
4. Clique em Criar. A chave completa é apresentada apenas uma vez; copie-a de imediato através do ícone de copiar.
5. As chaves que já não são necessárias podem ser desativadas através de Revogada ou removidas definitivamente com o ícone de eliminar.

Todas as permissões em detalhe encontram-se no artigo Gerir chaves de API e ligações MCP.

Contabilidade — DATEV, BMD, sevdesk e bexio

Para a contabilidade, existem dois caminhos: a exportação de ficheiro (descarrega um ficheiro CSV e entrega-o — o caminho para DATEV e BMD) e a transferência direta (liga a sua conta uma única vez e, a partir daí, cada fatura emitida é transferida com um clique — o caminho para sevdesk, bexio e Lexware Office).

Através do cartão DATEV, exporta as suas faturas emitidas como lote de lançamentos DATEV (EXTF-CSV) — o formato que os consultores fiscais na Alemanha e na Áustria esperam para a importação no software do seu escritório.

1. Abra o cartão DATEV e, em Definições DATEV, introduza os dados do seu consultor fiscal: Número de consultor, Número de mandante, Plano de contas (SKR03 ou SKR04), bem como as contas predefinidas de devedor e de receitas. Clique em Guardar definições.
2. Se estes dados ainda faltarem, o Univents mostra no topo da página o aviso Faltam as definições DATEV — siga a ligação para os preencher.
3. Com as definições guardadas, escolha na secção Exportar lote de lançamentos o período pretendido (De/Até) e clique em Descarregar CSV DATEV.
4. As faturas já exportadas do período escolhido são automaticamente ignoradas na exportação seguinte. Para uma nova exportação — por exemplo, após uma correção —, ative a opção Reexportar: incluir faturas já exportadas.

Para empresas austríacas, o cartão BMD oferece o mesmo caminho no formato BMD — os detalhes encontram-se no artigo Exportação BMD.

Através dos cartões sevdesk e bexio, liga a sua conta uma única vez (no sevdesk com token de API, no bexio com início de sessão) e, depois, transfere cada fatura emitida, bem como os seus contactos de clientes, com um clique. Os guias passo a passo encontram-se em Como ligo a minha conta sevdesk? e Ligar e utilizar o bexio.

Todos os campos de definições em detalhe encontram-se no artigo Exportações e integrações de contabilidade.

API REST (exportação de dados para DWH/BI)

O Univents disponibiliza uma API REST (v1) regular — concebida para a importação contínua dos dados do seu workspace para um data warehouse ou ferramenta de BI (extração completa inicial + sincronização delta incremental). Não é necessário MCP/IA; esta é a via clássica e estruturada.

• Especificação (pública, acessível sem chave, importável diretamente no Postman/codegen):
  • OpenAPI 3.1: https://univents.app/api/v1/openapi.json
  • Documentação interativa: https://univents.app/api/v1/docs
• Autenticação: chave de API Bearer com scopes Marcar como lida por recurso (ver acima).
• Fluxos de dados: eventos, contactos e empresas, espaços (dados-mestre), bem como pedidos, reservas + linhas e documentos financeiros — orçamentos/faturas/guias de remessa — incl. linhas (dados transacionais).
• Sincronização delta: com updated_since obtém apenas as alterações; a paginação por cursor devolve páginas completas (se necessário, eliminar duplicados por id). Os registos eliminados aparecem como tombstones (include_deleted=true) ou no fluxo próprio /deleted-records. Todos os carimbos de data/hora são ISO 8601 UTC. Limite: 120 pedidos/minuto por chave.

Para uma configuração em curso, contacte o suporte — disponibilizamos uma chave e acrescentamos campos em falta de forma direcionada.

Perguntas frequentes

Não encontro uma integração — onde procuro? Se a barra de categorias à esquerda estiver numa categoria específica, só vê os cartões dessa categoria. Clique em Todos ou utilize o campo de pesquisa no topo; voltam a aparecer todas as integrações.

Como volto de uma página de detalhe? Através da ligação ← Todas as integrações, em cima à esquerda em cada página de detalhe.

Já posso ligar sevdesk, bexio, BMD, DATEV, Lexware Office ou BuchhaltungsButler? DATEV, BMD, sevdesk, bexio e Lexware Office já pode utilizar. Só o BuchhaltungsButler ainda está Brevemente disponível e de momento não pode ser ligado — nem através do suporte. Manifeste o seu interesse através do cartão e informamo-lo assim que arrancar.

O BMD é uma ligação real? Não. O BMD é uma exportação CSV — ou seja, um ficheiro que entrega à sua contabilidade, não uma ligação contínua entre os sistemas. Já o sevdesk e o bexio são ligações reais: liga uma vez e, depois, transfere cada fatura com um clique.

Posso ligar vários calendários em simultâneo? Sim: um calendário comum para todo o workspace e, além disso, cada utilizador com direitos de administração pode ligar o seu próprio calendário pessoal.

O que acontece quando a ligação do calendário ou do e-mail expira? O Univents mostra o distintivo Ligação expirada — ligar novamente diretamente no cartão de ligação. Clique nele para renovar o início de sessão; todas as definições anteriores (calendário selecionado, atribuição de espaços) são mantidas.

A minha chave de API é segura? Guarde a chave como uma palavra-passe. Após a criação, o Univents mostra-a exatamente uma vez. Se uma chave cair em mãos erradas, revogue-a de imediato através de Revogada e crie uma nova.

Posso exportar os meus dados por API para um DWH próprio? Sim. Utilize a API REST (ver secção acima) com uma chave Marcar como lida. Está pensada para exportação completa e delta contínua; a especificação está disponível publicamente em https://univents.app/api/v1/openapi.json e pode ser importada diretamente nas suas ferramentas.

O que exporta exatamente a exportação DATEV? Faturas emitidas já finalizadas (que deixaram de ser rascunho) do período escolhido, como lote de lançamentos em formato EXTF-CSV — prontas para importação no software do escritório do seu consultor fiscal. Os detalhes de cada campo encontram-se no artigo Exportações e integrações de contabilidade.

No cartão DATEV aparece «A partir do Growth» — porquê? A exportação DATEV está desbloqueada a partir do plano Growth. O distintivo de plano diz-lho logo no cartão, em vez de só depois do clique. Se abrir o cartão mesmo assim, o Univents mostra uma informação de upgrade em vez da função de exportação.

Posso mostrar a visão geral a alguém que não tenha acesso ao Univents? Sim. Em https://univents.app/integrationen está a mesma visão geral, de forma pública — prático se quiser mostrar ao seu consultor fiscal ou a colegas o que o Univents liga.