# Visão geral (/pt-PT/aan-de-slag)

Nesta página percorre o seu primeiro dia no Tillor: do início de sessão até à primeira fatura. A ordem conta, porque cada parte assenta na anterior. Uma ocupação, por exemplo, precisa de um cliente e de um terreno, por isso crie-os primeiro. Se preferir seguir um exemplo da vida real, veja [Na prática](/praktijk). Se encontrar uma palavra que não conhece, consulte-a em [Conceitos](/begrippen).

## Como se liga tudo? [#hoe-hangt-dit-samen]

Estes são os blocos de construção e aquilo de que precisam:

```mermaid
flowchart LR
  I[Instellingen] --> T[Terreinen]
  T --> B[Bezetting]
  T --> R[Reservering]
  K[Klanten] --> B
  K --> R
  P[Producten] --> F[Factuur]
  K --> F
  B --> F
  R --> F
  F --> Bet[Betaling]
```

Uma fatura pertence sempre a um cliente. Um cliente num terreno durante um período mais longo chama-se ocupação; uma estadia com data de entrada e de saída é uma reserva. Os produtos não são obrigatórios, mas garantem que o preço, o IVA e as ações ficam corretos na linha da fatura.

<Callout type="info" title="Bom saber">
- Se tiver mais do que uma organização, escolhe uma depois de iniciar sessão. Se faltar alguma, peça ao administrador que o convide.
- Os itens de menu que vê dependem das suas permissões. Se não vir algo, peça a permissão ao administrador.
- Sem terreno não pode criar uma ocupação. Sem cliente não pode criar uma reserva, uma ocupação nem uma fatura.
- Pagamentos em numerário, por transferência e outros pagamentos manuais funcionam sem ligação. Para pagar online ou com terminal, ligue o Mollie.
- A forma mais rápida de voltar a encontrar algo é pesquisar com **Ctrl+K** ou **⌘K**.
</Callout>

Antes de começar:

- Tem uma conta Microsoft, Google ou Apple e o administrador convidou-o para a sua organização. Sem convite não vê nenhuma organização.
- Tem as permissões para o que pretende fazer. Se faltarem, o item de menu não aparece ou o botão está desativado.

## Configurar o seu parque [#je-park-inrichten]

<Steps>
<Step>
### Inicie sessão e escolha a organização [#log-in-en-kies-je-organisatie]
Inicie sessão com a sua conta Microsoft, Google ou Apple. Se tiver acesso a mais do que uma organização, escolha uma. Se ainda não tiver acesso, peça ao administrador que o convide. Veja [Iniciar sessão](/inloggen).
</Step>
<Step>
### Reveja as definições da organização [#loop-de-organisatie-instellingen-na]
Abra <UIPath>Apoio > Definições</UIPath>. Em **Geral**, confirme o fuso horário e o país predefinido e, em **Horário de funcionamento**, preencha o seu horário. Em **Faturação** encontra, entre outros, o prazo de vencimento predefinido e as taxas de IVA. Convide colegas em **Utilizadores**. Veja [Organização](/gebruikers/organisaties).
</Step>
<Step>
### Crie os seus terrenos [#maak-je-terreinen-aan]
Aceda a <UIPath>Parque > Terrenos</UIPath> e adicione os seus lugares, como parcelas, chalés e lugares fixos. Sem terreno não pode criar uma ocupação, e os contadores são associados a um terreno. Veja [Terrenos](/terreinen).
</Step>
<Step>
### Crie os seus produtos [#maak-je-producten-aan]
Aceda a <UIPath>Administração > Produtos</UIPath> e crie as tarifas e os serviços que aparecem nas faturas, como as noites de estadia. Uma linha de fatura também pode existir sem produto, mas com um produto o preço, o IVA e as eventuais ações ficam logo corretos. Veja [Produtos](/producten).
</Step>
<Step>
### Adicione os seus clientes [#voeg-je-klanten-toe]
Aceda a <UIPath>Clientes > Visão geral</UIPath> e crie um cliente. Reservas, ocupações e faturas pertencem sempre a um cliente. Veja [Gestão de clientes](/klantenbeheer).
</Step>
<Step>
### Crie uma reserva ou uma ocupação [#maak-een-reservering-of-bezetting-aan]
Uma reserva destina-se a uma estadia com data de entrada e de saída, e também pode ser criada sem terreno fixo. Uma ocupação associa um cliente a um terreno por um período mais longo, por exemplo um lugar anual. Veja [Reservas](/reserveringen) e [Ocupações](/bezettingen).
</Step>
<Step>
### Crie a sua primeira fatura [#maak-je-eerste-factuur]
Abra o perfil do cliente e crie aí uma nova fatura. Adicione linhas, lance a fatura e envie-a. Veja [Faturas](/facturen).
</Step>
<Step>
### Ligue os pagamentos [#koppel-betalingen]
Se quiser que os clientes paguem online ou com terminal, ligue o Mollie em <UIPath>Apoio > Definições</UIPath>, em **Integrações**. Pagamentos em numerário, por transferência e outros pagamentos manuais funcionam sem ligação. Veja [Processamento de pagamentos](/betalingsverwerking) e [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie).
</Step>
</Steps>

Se usar contadores, cancelas ou etiquetas NFC, configure-os depois. Veja primeiro [Parque](/park) e [Controlo de acessos](/toegangscontrole).

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- Os seus clientes, terrenos e produtos ficam prontos, para que possa criar reservas, ocupações e faturas no dia a dia.
- A sua primeira fatura fica como rascunho no cliente. Só depois de **Lançar fatura** recebe um número definitivo, e a partir daí pode enviá-la e recebê-la.
- Se tiver ligado o Mollie, os clientes podem pagar online ou com terminal e o pagamento regressa automaticamente à fatura.

## Orientar-se [#je-weg-vinden]

O menu principal está à esquerda. Em cima muda de organização, se tiver mais do que uma. Os itens que vê dependem das suas permissões.

<DocScreenshot src="/screenshots/inleiding/dashboard-welcome.png" alt="Painel - ecrã inicial depois de iniciar sessão" />

| Menu | Para quê |
|------|----------|
| **Painel** | Ecrã inicial com as chegadas e as partidas de hoje |
| **Reservas** | Estadias e o calendário de reservas |
| **Tarefas** | Distribuir e acompanhar o trabalho |
| **Controlo de acessos** | Pontos de acesso e registo de acessos |
| **Clientes** | **Visão geral** e **Consumo em dívida** |
| **Parque** | **Mapa**, **Terrenos**, **Contadores**, **Armários de contadores** e **Meteorologia** |
| **Comunicação** | **Chamadas telefónicas**, **Notificações** e **Comentários** |
| **Administração** | **Documentos**, **Assinaturas**, **Faturas**, **Pagamentos**, **Transações bancárias** (com a permissão para as ver), **Relatórios de pagamento**, **Fila de impressão** e **Produtos** |

Sob o título **Administrador** encontra **Automações** (com a permissão para as ver) e **Controladores**. Em baixo, em **Apoio**, encontra as suas notificações, a **Caixa de entrada** e o **Registo de auditoria** (com as permissões correspondentes), **Definições** e **Mais recursos** com a documentação. Os itens que vê dependem das suas permissões.

Pesquisa-se com **Pesquisar** no cabeçalho, ou com **⌘K** (Mac) ou **Ctrl+K** (Windows). Assim salta diretamente para um cliente, fatura, reserva ou terreno. Veja [Pesquisar](/zoeken).

A sua própria conta, sessões e chaves de API encontra-as através do seu nome, em baixo no menu.


## Problemas? [#problemen]

<Accordions>
<Accordion title="Não consigo entrar na minha organização">
O administrador tem primeiro de o convidar. Inicie sessão com a conta com que ele o convidou. Veja [Iniciar sessão](/inloggen).
</Accordion>
<Accordion title="Não vejo um item de menu que consta deste manual">
Só vê os itens para os quais tem permissões. Peça ao administrador a permissão, ou a função que a inclui.
</Accordion>
<Accordion title="Não consigo criar uma ocupação">
Não há nenhum terreno disponível ou o cliente ainda não existe. Crie primeiro um terreno e um cliente. Um terreno com uma ocupação em curso não aparece na lista de escolha.
</Accordion>
<Accordion title="Não sei onde encontrar algo">
Use **Pesquisar** no cabeçalho, ou pesquise neste manual com a barra de pesquisa no topo.
</Accordion>
</Accordions>

## Precisa de ajuda? [#hulp-nodig]

- Se procura algo neste manual, use a barra de pesquisa no topo ou escolha no Tillor **Mais recursos > Documentação**.
- O Tillor não funciona como esperado? Verifique primeiro o [estado do sistema](https://status.tillor.eu) para ver avarias e manutenção planeada.
- Perdeu o acesso a uma organização, ou quer alterar os dados da empresa nas faturas? Envie um e-mail para support@tillor.eu.
- Quer recuperar dados de uma cópia de segurança? Veja [Dados e cópias de segurança](/gegevens-backups).

## Conceitos [#begrippen]

- **Organização**: a sua conta Tillor, normalmente a sua empresa. Veja [Conceitos](/begrippen#organisatie).
- **Parque**: o local físico. Veja [Conceitos](/begrippen#park).
- **Cliente**: uma pessoa ou empresa no Tillor. Veja [Conceitos](/begrippen#klant).
- **Terreno**: um lugar no seu parque. Veja [Conceitos](/begrippen#terrein).
- **Ocupação** e **reserva**: um cliente num terreno por um período mais longo, ou uma estadia com data de entrada e de saída. Veja [Conceitos](/begrippen#bezetting).
- **Lançar fatura**: tornar uma fatura definitiva. Veja [Conceitos](/begrippen#boeken).

## Ver também [#zie-ook]

<Cards>
  <Card title="Na prática" href="/praktijk" description="Exemplos completos de um dia de trabalho" />
  <Card title="Conceitos" href="/begrippen" description="Todos os termos num só lugar" />
  <Card title="Iniciar sessão" href="/inloggen" description="Métodos de início de sessão e a sua conta" />
  <Card title="Pesquisar" href="/zoeken" description="Encontrar depressa o que procura" />
  <Card title="Dados e cópias de segurança" href="/gegevens-backups" description="Prazos de conservação e recuperação" />
  <Card title="Novidades" href="/wat-is-nieuw" description="Alterações recentes por mês" />
</Cards>


# Conceitos (/pt-PT/begrippen)

O Tillor usa algumas palavras com mais frequência do que está habituado, e algumas parecem-se entre si. Nesta página encontra, para cada conceito, o que significa e onde pode ler mais. A lista está por ordem alfabética. Se procura algo sobre os próprios controladores, como ACL ou firmware, veja o [glossário dos controladores](/controllers/lexicon).

<Callout type="info" title="Duas palavras que se confundem muitas vezes">
Uma **ocupação** é um cliente que fica num terreno durante um período mais longo, como um cliente sazonal. Uma **reserva** é uma marcação para uma única estadia. Com **lançar** o Tillor refere-se sempre a tornar uma fatura definitiva, nunca a reservar uma estadia.
</Callout>

### Aviso de cobrança [#aanmaning]

Um lembrete enviado a um cliente de que uma fatura lançada ainda não foi paga. Envia-o por fatura, com a mesma ligação para pagar online. Veja [Enviar um aviso de cobrança](/facturen/versturen#een-aanmaning-versturen).

### Automação [#automatisering]

Uma regra que o Tillor executa por si: quando isto acontece, faz aquilo. Por exemplo, criar uma tarefa de seguimento quando uma ocupação termina. Os passos de uma automação formam em conjunto um fluxo, o desenho no ecrã de trabalho. Veja [Automações](/automatiseringen).

### Pagamento [#betaling]

Um valor que um cliente paga ou que ainda está a caminho, com um método, um estado e normalmente uma fatura. Encontra-os em <UIPath>Administração > Pagamentos</UIPath>. Veja [Encontrar pagamentos](/betalingsverwerking/betalingen-bekijken).

### Grupo de pagamentos [#betalingsgroep]

Um conjunto de pagamentos sob um só nome, que depois associa de uma só vez a uma fatura lançada. Por exemplo, todos os pagamentos com terminal de um dia. Veja [Grupos de pagamentos](/betalingsverwerking/groepen).

### Relatório de pagamento [#betalingsrapport]

O resumo de todos os pagamentos de um único dia de calendário, pensado para a sua contabilidade. O relatório de hoje é um rascunho e torna-se definitivo quando o dia termina. Veja [Relatórios de pagamento](/boekhouden/betalingsrapporten).

### Página de prova [#bewijspagina]

As páginas no fim de um PDF assinado, com o título do documento, quem assinou e quando, e duas impressões digitais digitais. Chamam-se **Prova de assinatura** e mostram mais tarde que o documento não foi alterado. Veja [Prova e validade](/handtekeningen/bewijs-en-geldigheid).

### Ocupação [#bezetting]

Um cliente que está num terreno durante um período mais longo. Enquanto a ocupação decorre, o Tillor cobra a esse cliente o consumo dos contadores nesse terreno. Um terreno tem no máximo um cliente de cada vez. Veja [Ocupações](/bezettingen).

### Lançar [#boeken]

Tornar definitiva uma fatura em rascunho. A fatura recebe um número e já não pode ser alterada livremente. Em Tillor a palavra não tem nada a ver com reservar. Veja [Lançar uma fatura](/facturen/boeken).

### Rascunho [#concept]

Uma fatura que ainda não foi lançada. Ainda pode alterar as linhas e nada foi enviado ao cliente nem à contabilidade. Veja [Estados de uma fatura](/facturen/statussen).

### Connector [#connector]

Uma pequena caixa na rede do seu parque que liga o Tillor a dispositivos no local, como impressoras e controladores de acesso. O Tillor fornece-a pré-configurada e atualiza-a por si. Veja [Connector](/connector).

### Controlador [#controller]

Uma caixa com ecrã tátil no seu parque, junto a um duche ou a uma porta. Lê uma etiqueta NFC ou um código QR, e o Tillor decide se o hóspede pode passar. Gere os controladores em **Controladores**. Veja [Controladores](/controllers).

### Nota de crédito [#creditnota]

Uma fatura com valores negativos que anula uma fatura anterior. A aplicação chama-lhe **nota de crédito**. Cria-a com **Estornar fatura**. Veja [Estornar uma fatura](/facturen/corrigeren#een-factuur-omkeren).

### Campo personalizado [#eigen-veld]

Um campo que a sua organização adiciona a um cliente, terreno, ocupação, contador ou tarefa, além dos campos que o Tillor já inclui. Gere-os em <UIPath>Definições > Campos personalizados</UIPath>. Veja [Campos personalizados](/eigen-velden).

### Fatura [#factuur]

Aquilo que cobra a um cliente, com linhas por produto. Uma fatura nova é sempre um rascunho. Cria-a no perfil do cliente e gere todas as faturas em <UIPath>Administração > Faturas</UIPath>. Veja [Faturas](/facturen).

### Evento [#gebeurtenis]

Uma linha na cronologia de um cliente, fatura ou outro registo que mostra o que aconteceu, por quem e o que mudou. Veja [Registo de atividade](/activiteitenlog).

### Utilizador [#gebruiker]

Uma conta com acesso ao Tillor. No texto corrido chamamos colega a outro utilizador. Gere os utilizadores e as suas permissões em <UIPath>Definições > Utilizadores</UIPath>. Veja [Organização](/gebruikers/organisaties).

### Grupo [#groep]

Um conjunto fixo de colegas, por exemplo **Receção**. Atribui tarefas a um grupo, partilha vistas com um grupo e pode dar ou retirar permissões a um grupo. Veja [Grupos](/gebruikers/groepen). Um grupo de pagamentos é outra coisa.

### Razão geral [#grootboek]

O número de conta na sua contabilidade em que um produto é lançado. Preenche-o no produto e segue com o envio para a contabilidade. Veja [O número da conta](/producten/product-aanmaken#grootboeknummer).

### Débito direto [#incasso]

O Tillor cobra por si o valor de uma fatura da conta bancária do cliente. Só é possível com um mandato ativo. Veja [Cobrar uma fatura por débito direto](/betalingsverwerking/incasso).

### Lista de opções [#keuzelijst]

Uma lista fixa de opções de onde um campo personalizado do tipo **Escolha** ou **Escolha múltipla** tira os valores. Cria a lista uma vez e usa-a em vários campos. Veja [Listas de opções](/eigen-velden/keuzelijsten).

### Quiosque [#kiosk]

Um tablet Android que mostra a aplicação Tillor e fica nela, para que os hóspedes não consigam aceder às definições do aparelho. Veja [Configurar um quiosque](/mobiele-app/kiosk-inrichten).

### Cliente [#klant]

O registo no Tillor de uma pessoa ou empresa: dados, faturas, ocupações, métodos de acesso e mais. A palavra hóspede só a usamos em texto corrente para quem fica no seu parque. Veja [Gestão de clientes](/klantenbeheer).

### Mandato [#mandaat]

A autorização de um cliente para cobrar faturas da sua conta bancária (um mandato SEPA). O cliente assina-o no próprio Tillor. Veja [Pedir a assinatura de um mandato SEPA](/betalingsverwerking/mandaat).

### Contador [#meter]

Um aparelho para água, eletricidade ou gás. Um contador pertence a um terreno, não a um cliente. O consumo vai para o cliente que tiver nesse momento uma ocupação no terreno. Veja [Gestão de contadores](/meterbeheer).

### Armário de contadores [#meterkast]

Um armário onde estão contadores. Em <UIPath>Parque > Armários de contadores</UIPath> gere os armários e os contadores que lhes estão atribuídos. Veja [Parque](/park#meterkasten).

### Etiqueta NFC [#nfc-tag]

Um cartão, pulseira ou porta-chaves que o hóspede encosta a um controlador, por exemplo para o duche ou um ponto de acesso. Uma etiqueta pode ter saldo. Veja [NFC](/nfc).

### Notificação [#notificatie]

Uma mensagem que o Tillor envia a um cliente ou colega, por e-mail, SMS, correio, WhatsApp ou push. Em <UIPath>Comunicação > Notificações</UIPath> vê se chegou. Veja [Notificações](/notificaties).

### Pedido de assinatura [#ondertekenverzoek]

O pedido para que um PDF, como um contrato de arrendamento, seja assinado online por uma ou mais pessoas, uma a seguir à outra. Gere-os em <UIPath>Administração > Assinaturas</UIPath>. Veja [Assinaturas](/handtekeningen).

### Consumo em dívida [#openstaand-verbruik]

Consumo de contadores que ainda não consta de uma fatura. Vê-o por cliente em <UIPath>Clientes > Consumo em dívida</UIPath> e fatura-o com **Faturar consumo**. Veja [Gestão de contadores](/meterbeheer/verbruik-factureren).

### Comentário [#opmerking]

Uma nota interna num cliente, fatura, reserva ou outro registo. Os comentários nunca são visíveis para o cliente. Veja [Comentários](/notities).

### Organização [#organisatie]

A sua conta Tillor, ou seja, a sua empresa com os seus utilizadores, definições e dados. O parque é o local físico. Veja [Organização](/gebruikers/organisaties).

### Parque [#park]

O local físico: o seu parque de campismo ou de lazer. Em **Parque** encontra o mapa, os terrenos, os contadores e os armários de contadores. Veja [Parque](/park).

### Peppol [#peppol]

Uma rede europeia com que envia faturas por via eletrónica diretamente para o sistema de contabilidade do destinatário, sem PDF. Para faturas belgas a empresas com número de IVA é obrigatória. Veja [Peppol](/boekhouden/peppol).

### Produto [#product]

Uma tarifa ou serviço que coloca numa linha de fatura, como uma noite, a taxa de estacionamento ou um kWh de eletricidade. Um produto pode ter ações que o Tillor executa ao lançar ou ao pagar. Veja [Produtos](/producten).

### Ação de produto [#productactie]

Algo que o Tillor faz automaticamente quando uma linha de fatura com este produto é lançada ou paga, como prolongar uma ocupação ou carregar uma etiqueta NFC. Veja [Ações de produto](/producten/productacties).

### Permissão [#recht]

O que um utilizador pode fazer no Tillor, por exemplo editar produtos ou repor faturas. Dá permissões por utilizador ou através de um grupo. Uma recusa através de um grupo prevalece sempre. Veja [Editar permissões](/gebruikers/organisaties#rechten-bewerken) e [Permissões de grupo](/gebruikers/groepen#groepsrechten).

### Reserva [#reservering]

Uma marcação para uma única estadia num terreno, com chegada e partida. Uma reserva não é o mesmo que uma ocupação. Veja [Reservas](/reserveringen).

### Tarefa [#taak]

Um trabalho para si ou para um colega, com, entre outros, um prazo, subtarefas e clientes ou terrenos associados. Vê as tarefas em vistas. Veja [Tarefas](/taken).

### Tablet [#tablet]

O aparelho na receção em que corre a aplicação Tillor, por exemplo para um cliente assinar um contrato ou um mandato. Tablets, quiosques e telemóveis com sessão iniciada encontra-os em **Definições**. Veja [Tablets e quiosques](/mobiele-app/tablets-en-kiosken).

### Terreno [#terrein]

Um lugar no seu parque que arrenda ou onde planeia estadias, com um nome e eventualmente contadores. Associa contadores a um terreno, e os clientes chegam a ele através de uma ocupação ou reserva. Veja [Terrenos](/terreinen).

### Tipo de terreno [#terreintype]

Uma classificação dos seus terrenos, como **Lugar**, **Chalé** ou **Lugar para autocaravanas**. Usa o tipo para filtrar a lista, colorir o mapa e nas automações. Veja [Tipos de terreno](/terreinen#terreintypes).

### Método de acesso [#toegangsmethode]

A forma como um cliente passa por um ponto de acesso: reconhecimento de matrícula, uma etiqueta NFC ou um código QR. Gere-os no cliente, no separador **Controlo de acessos**. Veja [Controlo de acessos](/toegangscontrole).

### Ponto de acesso [#toegangspunt]

Uma cancela, portão ou porta eletrónica onde o acesso é controlado. Pode abrir e fechar um ponto de acesso a partir do Tillor e ver no registo quem passou. Veja [Controlo de acessos](/toegangscontrole).

### Gatilho [#trigger]

O início de uma automação: o evento, a hora ou a mensagem que a faz arrancar. Um gatilho pode ter um filtro, para que a automação só arranque se algo se verificar. Veja [Gatilhos](/automatiseringen/triggers).

### Lote de consumo [#verbruiksbatch]

Um período de consumo de contador para um cliente e um contador, com uma leitura inicial e final. A aplicação chama-lhe **período de consumo**; neste manual também aparece lote de consumo. Veja [Lotes de consumo](/meterbeheer/consumptie-batches).

### Vista [#weergave]

Uma forma guardada de ver as suas tarefas, por exemplo **Tarefas abertas** ou **Manutenção**. Cada vista aparece como separador no topo da página Tarefas. Veja [Vistas](/taken/weergaven).

### Selo [#zegel]

A assinatura digital da sua organização com que o Tillor fecha um PDF assinado. Se depois algo no ficheiro mudar, um leitor de PDF avisa. Há também um carimbo de data e hora. Veja [Selo e carimbo de data e hora](/handtekeningen/bewijs-en-geldigheid#zegel-en-tijdstempel).

## Ver também [#zie-ook]

<Cards>
  <Card title="Na prática" href="/praktijk" description="Quatro exemplos completos que combinam vários módulos" />
  <Card title="Controladores: glossário" href="/controllers/lexicon" description="Conceitos técnicos sobre controladores" />
</Cards>


# Dados e cópias de segurança (/pt-PT/gegevens-backups)

O Tillor faz automaticamente cópias de segurança dos dados da sua organização. Não precisa de configurar nada e não as vê no Tillor. Se precisar de dados do passado ou se algo correu mal, o apoio do Tillor repõe um estado anterior por si. Aqui vê como o pedir e até onde pode recuar.

<Callout type="info" title="Bom saber">
- As cópias de segurança recuam até ao primeiro mês de calendário já terminado, com um arquivo por mês. Os detalhes estão na tabela abaixo.
- A reposição não a faz você: é sempre feita através do apoio do Tillor.
- Não pode descarregar nem consultar uma cópia de segurança.
</Callout>

Antes de começar: saiba que dados precisa e a partir de que momento ou de que mês.

## Durante quanto tempo o Tillor guarda cópias de segurança? [#hoe-lang-bewaart-tillor-back-ups]

O Tillor guarda três tipos de cópias de segurança em paralelo. Em conjunto dão-lhe um ponto de recuperação recente e um histórico mais longo.

| Período | O que pode recuperar |
|---------|-------------------------|
| **Últimas 48 horas** | Uma cópia de 4 em 4 horas, para recuperar um momento recente |
| **Últimos 14 dias** | Uma cópia por noite |
| **Cada mês de calendário já terminado** | Um arquivo mensal por mês, sem eliminação automática |

O mês de calendário atual só tem as cópias noturnas dos últimos 14 dias. Assim que um mês termina, fica guardada uma cópia desse mês como arquivo mensal.

Os prazos aplicam-se a todas as organizações. Se o Tillor mudar a política, atualizamos esta página.

## Pedir a reposição de uma cópia de segurança [#een-back-up-laten-terugzetten]

A reposição não se faz sozinho no Tillor. O apoio do Tillor faz isso consigo, para que os seus dados atuais não sejam substituídos por engano.

<Steps>
<Step>
### Reúna o que quer recuperar [#verzamel-wat-je-wilt-terughalen]
Defina de que dados precisa, como faturas, clientes ou reservas. Anote o momento ou o período a que quer recuar, por exemplo "ontem por volta das 14:00" ou "março de 2026".
</Step>
<Step>
### Contacte o apoio do Tillor [#neem-contact-op-met-tillor-support]
Envie um e-mail para support@tillor.eu e indique o nome da sua organização, os dados que quer recuperar e o momento ou período pretendido.
</Step>
<Step>
### Combine o que vai ser reposto [#overleg-wat-er-precies-terugkomt]
O apoio do Tillor procura a cópia de segurança que corresponde ao seu pedido e fala consigo sobre o que vai acontecer antes de a recuperação começar.
</Step>
</Steps>

<Callout type="warn" title="Atenção">
A reposição pode fazer os dados regressar a um estado anterior. Tudo o que introduziu depois do momento escolhido pode por isso desaparecer. Fale sempre disso primeiro com o apoio do Tillor.
</Callout>

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- O apoio do Tillor procura a cópia adequada e fala consigo sobre o que vai ser reposto antes de a recuperação começar.
- Durante a recuperação, a sua organização fica em modo de manutenção e só os colaboradores do Tillor têm acesso. Depois tudo volta a estar disponível.
- Os dados que introduziu depois do momento escolhido podem ter desaparecido. Por isso, fale sempre primeiro.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Quero descarregar ou consultar eu próprio uma cópia de segurança">
Não é possível no Tillor. As cópias de segurança só estão disponíveis para o apoio do Tillor. Peça ao apoio que procure os dados de que precisa.
</Accordion>
<Accordion title="Quero dados de há mais de um mês">
Para meses anteriores, o Tillor guarda uma cópia por mês de calendário. Pode assim recuar a um mês, mas não a um dia ou a uma hora concretos desse mês. Para os últimos 14 dias é possível por dia, para as últimas 48 horas de 4 em 4 horas.
</Accordion>
<Accordion title="O Tillor não está acessível durante a recuperação">
Durante uma recuperação, a sua organização fica em modo de manutenção e só os colaboradores do Tillor têm acesso. Combine com o apoio do Tillor um momento que lhe convenha.
</Accordion>
<Accordion title="Eliminei uma fatura ou um cliente por engano">
Envie um e-mail ao apoio do Tillor com o nome dos dados e o momento da eliminação. Veja primeiro no [registo de atividade](/activiteitenlog) quem alterou o quê e quando.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Começar" href="/aan-de-slag" description="Configurar o seu parque passo a passo" />
  <Card title="Registo de atividade" href="/activiteitenlog" description="Veja quem alterou o quê e quando" />
</Cards>


# Iniciar sessão no Tillor (/pt-PT/inloggen)

Inicia sessão no Tillor com uma conta que já tem na Microsoft, Google ou Apple. O Tillor não tem palavra-passe própria: é esse fornecedor que trata da sua palavra-passe. Depois de iniciar sessão, escolhe a organização e chega ao painel. Se este é o seu primeiro dia, continue para [Começar](/aan-de-slag).

Antes de começar:

- Precisa de uma conta Microsoft, Google ou Apple.
- Um administrador tem de o ter convidado primeiro como utilizador com o mesmo endereço de e-mail. Se isso não aconteceu, vê **Nenhuma organização encontrada**.

## Iniciar sessão [#inloggen]

<Steps>
<Step>
### Abra o Tillor [#open-tillor]
Aceda no navegador à aplicação web do Tillor. Se já tiver sessão iniciada, o Tillor reencaminha-o logo para a sua organização.
</Step>
<Step>
### Escolha o método de início de sessão [#kies-je-inlogmethode]
Clique em **Iniciar sessão com a Microsoft**, **Iniciar sessão com o Google** ou **Iniciar sessão com a Apple**. O método com que iniciou sessão da última vez está marcado com **Última utilização**.
</Step>
<Step>
### Siga os passos do fornecedor [#volg-de-stappen-van-de-provider]
É levado ao ecrã de início de sessão da Microsoft, do Google ou da Apple. Na Microsoft e no Google escolhe a conta que quer usar. Depois regressa ao Tillor.
</Step>
<Step>
### Escolha a organização [#kies-je-organisatie]
Se tiver acesso a mais do que uma organização, vê um ecrã de escolha. Procure a sua organização na lista e clique em **Abrir**. Se só tiver uma, vai diretamente para o painel.
</Step>
</Steps>

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- Chega ao painel da sua organização. O Tillor lembra-se do último método de início de sessão e marca-o da próxima vez com **Última utilização**.
- Só vê as partes para as quais tem permissões.
- A sua sessão mantém-se ativa neste dispositivo, até 30 dias sem utilização ou até terminar a sessão.

## Como se liga tudo? [#hoe-hangt-dit-samen]

Uma pessoa tem uma conta Tillor. Pode associar essa conta a vários métodos de início de sessão. Um administrador adiciona-o como utilizador a uma organização e dá-lhe permissões. O que vê depois depende dessas permissões.

```mermaid
flowchart LR
  A[Je Microsoft-, Google- of<br/>Apple-account] --> B[Je Tillor-account]
  B --> C[Een of meer organisaties]
  C --> D[Jouw rechten<br/>bepalen wat je ziet]
```

<Callout type="info" title="Bom saber">
- Mantém a sessão iniciada enquanto usar o Tillor. Após 30 dias sem utilização, volta a iniciar sessão.
- Uma ligação de verificação do seu endereço de e-mail é válida durante 15 minutos. Só pode pedir um novo e-mail de dois em dois minutos, no máximo.
- A Microsoft está sempre ativa como método de início de sessão. O Google e a Apple podem não existir, consoante o seu ambiente Tillor.
- Não pode desassociar o seu último método de início de sessão.
</Callout>

## Dar acesso a um colega [#een-collega-toegang-geven]

Um administrador com as permissões certas convida colegas.

<Requires permission="Gebruikersrechten beheren" />

<Steps>
<Step>
### Abra os utilizadores [#open-de-gebruikers]
Aceda a <UIPath>Apoio > Definições</UIPath> e escolha **Utilizadores**.
</Step>
<Step>
### Convide o colega [#nodig-de-collega-uit]
Clique em **Convidar utilizador**, preencha o endereço de e-mail e clique em **Convidar**.
</Step>
</Steps>

Se já existir uma conta Tillor com esse endereço de e-mail, o colega é adicionado de imediato. Caso contrário, o colega recebe um convite por e-mail e torna-se membro no primeiro início de sessão. Depois defina as permissões, veja [Organização](/gebruikers/organisaties). O colega só vê algo útil depois de as permissões estarem definidas.

## Gerir a sua própria conta [#je-eigen-account-beheren]

Clique no seu nome em baixo no menu e escolha **Conta**. Aí encontra:

- **E-mail**: se o seu endereço de e-mail está **Verificado** ou **Não verificado**. Se indicar **Não verificado**, vê o botão **Verificar endereço de e-mail**, veja [Verificar o seu endereço de e-mail](#je-e-mailadres-verifiëren).
- **Plataformas associadas**: associe a Microsoft, o Google ou a Apple à mesma conta com **Associar**, ou remova uma ligação com **Desassociar**. Não pode desassociar o seu último método de início de sessão.
- **Sessões ativas**: veja em que dispositivos tem sessão iniciada. Com **Terminar sessão** termina uma sessão, com **Terminar sessão em todos os outros dispositivos** termina todas as outras.
- O seu número de telefone e o idioma da sua conta.

Mantém a sessão iniciada enquanto usar o Tillor. Após 30 dias sem utilização, volta a iniciar sessão. Para terminar sessão, escolha **Terminar sessão** no menu por baixo do seu nome.

## Verificar o seu endereço de e-mail [#je-e-mailadres-verifiëren]

O Tillor adota o seu endereço de e-mail do fornecedor com que iniciou sessão pela primeira vez. O Google e a Apple indicam nessa altura que o endereço é seu. A Microsoft normalmente não o faz, e nesse caso o seu endereço aparece na página **Conta** como **Não verificado**.

Enquanto o seu endereço não estiver verificado, o Tillor não associa um segundo método de início de sessão à sua conta. Se, por exemplo, iniciar sessão pela primeira vez com o Google e a sua conta tiver sido criada com a Microsoft, vê o aviso de que o endereço já pertence a uma conta que ainda não está verificada. Verifique o seu endereço uma vez, depois já funciona.

<Steps>
<Step>
### Peça o e-mail de verificação [#vraag-de-verificatiemail-aan]
Se tiver sessão iniciada, clique na página **Conta** em **Verificar endereço de e-mail**. Se não tiver sessão iniciada e recebeu o aviso na página de início de sessão, preencha aí o seu endereço de e-mail e clique em **Enviar e-mail de verificação**. Essa página dá sempre a mesma confirmação, mesmo que não exista nenhuma conta com esse endereço.
</Step>
<Step>
### Abra o e-mail [#open-de-e-mail]
Recebe um e-mail com o assunto **Verifica o teu endereço de e-mail para o Tillor**. Clique em **Verificar endereço de e-mail**. A ligação é válida durante 15 minutos; se tiver expirado, peça simplesmente uma nova.
</Step>
<Step>
### Inicie sessão [#log-in]
Depois de clicar, regressa à página de início de sessão ou à página da sua conta. Inicie sessão com o método que preferir. A partir de agora o Tillor associa à sua conta um novo método de início de sessão com o mesmo endereço de e-mail.
</Step>
</Steps>

Só pode pedir um novo e-mail de verificação de dois em dois minutos, no máximo. Se não quiser esperar pelo e-mail, com a sessão iniciada também pode associar logo um segundo método em **Conta > Plataformas associadas**.

## Chaves de API para ligações [#api-sleutels-voor-koppelingen]

Para ligações técnicas, gere as chaves de API na página **Conta**. Abra **Programadores** no menu do seu perfil e clique em **Ir para as chaves de API**, ou vá a **Conta** > **Chaves de API**. Veja [Programadores](/ontwikkelaars) para a documentação de integração.

<DocScreenshot src="/screenshots/http/api-keys-nav.png" alt="Conta - secção Chaves de API" />

## Problemas? [#problemen]

<Accordions>
<Accordion title="Vê Nenhuma organização encontrada">
A sua conta existe, mas ainda não está associada a uma organização. Peça a um administrador da sua organização que o convide com o mesmo endereço de e-mail da sua conta Microsoft, Google ou Apple.
</Accordion>
<Accordion title="Vê que o endereço de e-mail já pertence a uma conta que ainda não está verificada">
Já existe uma conta Tillor com este endereço, criada com outro método de início de sessão, e esse endereço ainda não está verificado. Por baixo do aviso, preencha o seu endereço de e-mail e clique em **Enviar e-mail de verificação**, ou inicie sessão com o método que usou antes e clique na página **Conta** em **Verificar endereço de e-mail**. Veja [Verificar o seu endereço de e-mail](#je-e-mailadres-verifiëren).
</Accordion>
<Accordion title="A ligação de verificação expirou ou não é válida">
Uma ligação de verificação funciona durante 15 minutos. Peça uma nova na página de início de sessão ou na página **Conta** e use o e-mail mais recente.
</Accordion>
<Accordion title="Não foi possível associar a conta">
Esta conta já está associada a outro utilizador, ou o endereço de e-mail não corresponde à sua conta atual. Use o mesmo endereço de e-mail, ou inicie sessão com a conta que já está associada e desassocie-a primeiro aí.
</Accordion>
<Accordion title="A sessão de início de sessão expirou">
O início de sessão demorou demasiado ou a página esteve aberta demasiado tempo. Clique de novo no seu método de início de sessão e conclua os passos mais depressa.
</Accordion>
<Accordion title="Não vejo tudo o que o meu colega vê">
O que vê depende das suas permissões. Peça a um administrador que ajuste as suas permissões, veja [Organização](/gebruikers/organisaties).
</Accordion>
<Accordion title="Recebe outra mensagem de erro">
Tente mais uma vez. Se voltar a falhar, envie um e-mail para support@tillor.eu e indique a mensagem.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Começar" href="/aan-de-slag" description="Configurar o seu parque passo a passo" />
  <Card title="Utilizadores" href="/gebruikers" description="Permissões de utilizadores e definições da organização" />
</Cards>


# Vraag het Tillie (/pt-PT/vraag-het-tillie)

Tillie is de assistent van deze handleiding. Je stelt een vraag zoals je ze aan een collega zou stellen, bijvoorbeeld "Hoe maak ik een creditnota?". Tillie zoekt de pagina's op die erover gaan, leest ze en antwoordt in een paar zinnen of stappen, met een link naar elke pagina die ze gebruikte. Zoek je een pagina waarvan je de naam al kent, dan is de [zoekfunctie](#zoeken-of-tillie) bovenaan sneller.

<Callout type="info" title="Goed om te weten">
- Tillie antwoordt uit deze handleiding. Over je eigen klanten, facturen of meters weet ze alleen iets als je haar [toegang tot je account](#tillie-in-je-account-laten-kijken) geeft.
- Ze antwoordt met AI en kan zich vergissen. Controleer een belangrijke stap op de pagina waar ze naar linkt.
- Ze antwoordt in de taal waarin je de handleiding leest.
- Zet geen persoonlijke gegevens van klanten in je vraag. Die heeft Tillie niet nodig.
</Callout>

## Een vraag stellen [#een-vraag-stellen]

<Steps>
<Step>
### Open Tillie [#open-tillie]
Klik rechtsonder op **Vraag het Tillie**, of druk op **⌘I** (Mac) of **Ctrl+I** (Windows). Tillie opent aan de rechterkant; op een telefoon vult ze het scherm. Met **Groter** maak je het venster breder.
</Step>
<Step>
### Stel je vraag [#stel-je-vraag]
Typ je vraag onderaan en druk op **Enter**. Met **Shift+Enter** begin je een nieuwe regel. Weet je niet goed hoe te beginnen, kies dan een van de voorbeeldvragen. Een vraag is maximaal 1.000 tekens lang.

Ben je niet aangemeld bij Tillor, dan controleert Tillie bij je eerste vraag dat je geen robot bent. Meestal merk je daar niets van; soms vraagt een vakje om een klik.
</Step>
<Step>
### Volg wat Tillie opzoekt [#volg-wat-tillie-opzoekt]
Boven het antwoord zie je wat Tillie doet: **Zocht naar** met de zoekwoorden en **Las** met de titel van elke pagina die ze opende. Daarna verschijnt het antwoord, woord voor woord. Met de stopknop rechts in het invoerveld breek je een antwoord af.
</Step>
<Step>
### Open de bronnen [#open-de-bronnen]
Klik op **bronnen gebruikt** om de pagina's te zien waar het antwoord op steunt, en klik een titel om de pagina te openen. Links in het antwoord zelf werken ook. Tillie blijft open terwijl je leest, behalve op een telefoon.
</Step>
</Steps>

## Tillie in je account laten kijken [#tillie-in-je-account-laten-kijken]

Ben je aangemeld bij Tillor, dan kan Tillie ook vragen over je eigen gegevens beantwoorden, zoals "Welke facturen van de familie Peeters staan nog open?" of "Wat was de laatste meterstand van plaats 12?". Daarvoor geef je haar eerst toegang.

<Steps>
<Step>
### Geef Tillie toegang [#geef-tillie-toegang]
Open Tillie. Bovenaan staat **Mag Tillie in je account kijken?**. Ben je lid van meer dan één organisatie, kies dan de organisatie. Klik **Toegang geven**.
</Step>
<Step>
### Stel je vraag [#stel-je-vraag-1]
Bovenaan staat nu **Tillie leest mee in** met de naam van je organisatie. Stel je vraag zoals altijd. Wat Tillie in je account opzoekt, zie je boven het antwoord: **Zocht in je account naar** en **Las** met wat ze bekeek.
</Step>
</Steps>

<Callout type="info" title="Wat Tillie mag">
- Tillie kan alleen **lezen**, en alleen wat jij zelf mag zien in die organisatie. Ze kan niets wijzigen, verwijderen of versturen.
- De toegang geldt 30 dagen. Met **Intrekken** stop je ze meteen.
- Geven en intrekken van de toegang staan in de [activiteitenlog](/activiteitenlog#beveiligingsgebeurtenissen) van je organisatie.
- Wat Tillie leest, gaat naar het taalmodel dat haar antwoord schrijft, net als bij de AI-assistent in de inbox. Het wordt niet bewaard om modellen te trainen.
</Callout>

## Een wijziging bevestigen [#een-wijziging-bevestigen]

Vraag je Tillie iets te veranderen, bijvoorbeeld "Zet factuur 2026-0142 terug naar concept", dan doet ze dat niet zelf. Ze stelt het voor in een kaart **Voorgestelde wijziging** met wat er zal gebeuren en welke velden veranderen, met hun nieuwe waarde.

- Klik **Bevestigen** om de wijziging uit te voeren. Tillor voert ze uit met jouw rechten, alsof je ze zelf deed, en toont daarna **Uitgevoerd.** of waarom het niet lukte.
- Klik **Annuleren** als je de wijziging niet wil. Er gebeurt dan niets.
- Een voorstel verloopt na 10 minuten. Vraag het dan opnieuw.

Elke bevestigde wijziging staat in de [activiteitenlog](/activiteitenlog#beveiligingsgebeurtenissen) van je organisatie, en de wijziging zelf staat in de **Gebeurtenissen** van het record, op jouw naam.

## Wat gebeurt er daarna? [#wat-gebeurt-er-daarna]

- Je gesprek blijft bewaard zolang het tabblad open is, ook als je naar een andere pagina gaat. Een vervolgvraag mag dus naar het vorige antwoord verwijzen ("En als de factuur al betaald is?"). Tillie onthoudt de laatste drie vragen met hun antwoord.
- Met **Nieuw gesprek** (het ronde pijltje bovenaan) begin je opnieuw. Sluit je het tabblad, dan is het gesprek weg.
- Onder elk antwoord laat je met een duim weten of het hielp. Zo zien we welke vragen de handleiding nog slecht beantwoordt.

## Hoeveel vragen kan je stellen? [#hoeveel-vragen-kan-je-stellen]

Tillie beantwoordt één vraag tegelijk. Daarnaast gelden grenzen, zodat de assistent beschikbaar blijft voor iedereen:

| Wie | Per minuut | Per dag |
|-----|------------|---------|
| Niet aangemeld | 5 vragen | 30 vragen |
| Aangemeld bij Tillor | 10 vragen | 100 vragen |

Op een netwerk dat je deelt met anderen, zoals de wifi van een kantoor of camping, geldt ook een grens voor iedereen samen. Heeft Tillie op een dag veel bezoekers geholpen, dan vraagt ze wie niet aangemeld is om zich aan te melden.

## Zoeken of Tillie? [#zoeken-of-tillie]

| Je wil | Gebruik |
|--------|---------|
| Een pagina openen waarvan je de naam kent, zoals "Mandaat" | De zoekfunctie bovenaan (**⌘K** of **Ctrl+K**) |
| Weten hoe je iets doet, in je eigen woorden | Tillie |
| Een antwoord dat meerdere pagina's combineert | Tillie |

## Problemen? [#problemen]

<Accordions>
<Accordion title="Ik zie Vraag het Tillie niet">
Tillie is nog niet voor iedereen beschikbaar. Staat de knop niet rechtsonder, gebruik dan de zoekfunctie bovenaan.
</Accordion>
<Accordion title="Je ziet Je stelde veel vragen kort na elkaar">
Je zit aan de grens per minuut of per dag. De melding zegt hoe lang je moet wachten. Ben je niet aangemeld, meld je dan aan bij Tillor: dan krijg je meer vragen per dag.
</Accordion>
<Accordion title="Je ziet Tillie beantwoordde vandaag al veel vragen van bezoekers">
De vragen voor bezoekers die niet aangemeld zijn, zijn voor vandaag op. Klik **Aanmelden bij Tillor** en stel je vraag opnieuw, of gebruik de zoekfunctie.
</Accordion>
<Accordion title="Je ziet Tillie is nu niet beschikbaar">
Tillie neemt even geen vragen aan. Gebruik de zoekfunctie bovenaan en probeer het later opnieuw.
</Accordion>
<Accordion title="Je ziet De controle of je geen robot bent lukte niet">
Herlaad de pagina en stel je vraag opnieuw. Blokkeert een extensie in je browser scripts of cookies, zet ze dan uit voor deze site.
</Accordion>
<Accordion title="Ik zie Mag Tillie in je account kijken? niet">
Dat staat er alleen als je aangemeld bent bij Tillor in dezelfde browser. Meld je aan en open Tillie opnieuw. Heb je al toegang gegeven, dan staat er **Tillie leest mee in**.
</Accordion>
<Accordion title="Je ziet Niet uitgevoerd bij een wijziging">
Tillor weigerde de wijziging, meestal omdat je er de rechten niet voor hebt of omdat het record intussen veranderde. De melding zegt waarom. Doe de wijziging dan in Tillor zelf.
</Accordion>
<Accordion title="Je ziet Verlopen bij een wijziging">
Je bevestigde niet binnen 10 minuten. Vraag Tillie de wijziging opnieuw voor te stellen.
</Accordion>
<Accordion title="Het antwoord klopt niet">
Open de bronnen onder het antwoord en controleer de stap op die pagina. Geef het antwoord een duim omlaag, zodat we het kunnen verbeteren.
</Accordion>
</Accordions>

## Zie ook [#zie-ook]

<Cards>
  <Card title="Zoeken in Tillor" href="/zoeken" description="Een klant, factuur of terrein vinden in de app" />
  <Card title="Begrippen" href="/begrippen" description="Alle termen in Tillor op een rij" />
  <Card title="Aan de slag" href="/aan-de-slag" description="Je eerste stappen in Tillor" />
</Cards>


# Novidades (/pt-PT/wat-is-nieuw)

O Tillor recebe uma atualização quase todos os dias. Nesta página estão as alterações que nota como administrador. Deixamos de fora pequenas melhorias e correções de erros.

## Novembro de 2026 [#november-2026]

### Tarefas [#taken]

- Filtre tarefas por **Texto**: mostre apenas as tarefas cujo nome ou descrição contém, ou precisamente não contém, um texto, e adicione os textos que quiser (por exemplo **Não contém** `Verzekering vervallen:`). Veja [Filtrar por texto](/taken/filteren#filteren-op-tekst).
- Os filtros e as definições da vista integrada **Todas** podem agora ser guardados para toda a organização, com a permissão **Gerir etiquetas e vistas partilhadas**. Veja [Guardar ou descartar alterações](/taken/weergaven#wijzigingen-opslaan-of-verwerpen).

### Pesquisa [#zoeken]

- A janela de pesquisa mostra os resultados por categoria, com a categoria do melhor resultado no topo e os três melhores resultados de cada categoria. Com o botão **Tudo** no início do campo de pesquisa, ou com **⌥1** a **⌥9** (**Alt** no Windows), pesquisa numa só categoria, mesmo antes de escrever. Em baixo encontra os atalhos de teclado e as categorias sem resultados. Veja [Pesquisa](/zoeken).

### Manual [#handleiding]

- A Tillie agora também pode ver a tua conta: dá-lhe acesso de leitura à tua organização e pergunta pelos teus clientes, faturas ou contadores. Propõe uma alteração, que só acontece quando a confirmas. Consulta [Deixar a Tillie ver a tua conta](/vraag-het-tillie#tillie-in-je-account-laten-kijken).
- Agora escolhes claro ou escuro uma só vez: o manual segue o tema que escolheste no Tillor, e vice-versa.
- Novo: [Pergunta à Tillie](/vraag-het-tillie). Faz uma pergunta por palavras tuas no canto inferior direito e a Tillie responde a partir do manual, com as páginas que usou.
- O manual existe agora também noutros idiomas: escolha o seu idioma no canto superior direito. Abre automaticamente no idioma que usa no Tillor. Uma página que ainda não esteja traduzida mostra o texto em neerlandês.

### Chat do site [#website-chat]

- Um visitante pode agora enviar 10 mensagens por minuto e 200 por dia pelo chat, e todos os visitantes da mesma rede em conjunto 30 por minuto. Acima disso, o visitante é convidado a aguardar um momento. Assim, um script não consegue inundar a tua caixa de entrada e as respostas da Tillie. Consulta [Problemas?](/inbox/website-chat#problemen).

### Contadores (ICY) [#meters-icy]

- O Tillor lê agora a ICY através da nova API v2. Em <UIPath>Definições > Integrações > ICY</UIPath>, preencha o início de sessão da API v2 e escolha o número do seu parque na lista; sem esses dados, os contadores ICY deixam de ser atualizados.
- Um contador ICY mostra que **Módulo** está no lugar (Campère ou PRM) e, se a ICY o conhecer, o **Número de série do módulo**. Se esse número de série mudar na ICY, fica registado na **Atividade** do contador.
- O cartão **Controladores ICY** em <UIPath>Parque > Contadores</UIPath> mostra, por controlador, quando a ICY o viu pela última vez, quantos contadores estão ligados a ele. Os alarmes que a ICY comunica num controlador também aparecem aí, e recebe a mesma notificação push que para um alarme de contador. Um controlador com um alarme, ou um que esteja parado há mais de uma hora, aparece no topo. Um controlador tem o nome do seu armário de contadores (por exemplo **MK6**) em vez do número da ICY. Veja [Controladores ICY](/meterbeheer/alarmen-en-status#icy-controllers).
- Um contador ICY mostra agora também o seu **Controlador** e o **Tempo de corte**. Outro tempo de corte do módulo fica registado na **Atividade** do contador.
- A lista em <UIPath>Parque > Contadores</UIPath> tem uma coluna **Módulo** (Campère ou PRM), e o ficheiro Excel de **Exportar todos os contadores** tem a coluna `module` na folha ICY.
- Em **Amperagem** só aparecem os valores até ao máximo definido na ICY para o módulo nesse lugar. Antes, o Tillor oferecia em cada contador a lista completa do parque.
- Os alarmes da ICY recebem um nome fixo no seu idioma, como **Sobrecorrente** ou **Falha de energia**, e os **Avisos** mostram agora quantas vezes o limite de comutação já foi usado.

### Programadores [#ontwikkelaars]

- **Não retrocompatível:** os alarmes passam a chamar-se `integration-alarm` na API e nos eventos, porque agora também podem estar num controlador ICY. Os eventos `meter-alarm:created` e `meter-alarm:resolved` foram substituídos por [`integration-alarm:created`](/ontwikkelaars/events#integration-alarm-created) e [`integration-alarm:resolved`](/ontwikkelaars/events#integration-alarm-resolved), e os caminhos REST `/meter-alarms` por `/integration-alarms`. Os nomes antigos deixaram de existir. Os webhooks e as automações existentes foram convertidos automaticamente para os novos eventos; ajuste no seu próprio código o nome do evento e o caminho. O campo `meterId` de um alarme pode estar vazio; nesse caso `icyControllerId` está preenchido.
- Um cliente OAuth pode agora ser limitado às pessoas da sua organização, e ainda a grupos e permissões: assinale **Só as pessoas de (a sua organização) podem iniciar sessão** na janela do cliente em <UIPath>Conta > Clientes OAuth</UIPath>. Pensado para o início de sessão único num serviço externo. Consulte [Clientes OAuth](/ontwikkelaars/oauth-clients).
- Cada endpoint da [referência da API](/api-referentie) mostra agora em **Acesso** quem o pode chamar e de que permissão um membro precisa. Uma chave de API com scopes também precisa dessa permissão nos seus scopes. O [índice de eventos](/ontwikkelaars/events) mostra o mesmo para cada evento.

### Chaves de API [#api-sleutels]

- Pode agora limitar uma chave de API às permissões de que uma ligação precisa: ative **Limitar às permissões selecionadas** na janela da chave em <UIPath>Conta > Chaves de API</UIPath>. Uma chave limitada nunca pode mais do que você próprio. Veja [Limitar permissões](/ontwikkelaars/http#rechten-beperken).

### Campos personalizados [#eigen-velden]

- Um campo de ligação a contadores pode limitar-se aos contadores do terreno da ocupação, e qualquer campo de ligação a um registo listável pode filtrar as suas opções com TypeScript próprio. O Tillor recusa ao guardar um registo fora dessa limitação. As listas curtas (menos de 50 registos) são mostradas logo na lista de escolha, sem ter de escrever primeiro 2 carateres. Veja [Filtrar opções](/eigen-velden/veldtypes#opties-filteren).
- O mesmo filtro pode também dar a uma opção um rótulo próprio e um cabeçalho na lista de escolha, devolvendo um texto ou `{ label, group }` em vez de `true`. Veja [Rótulos próprios](/eigen-velden/veldtypes#eigen-labels).

### Manual [#handleiding-1]

- Novo no manual: [Conceitos](/begrippen), um glossário de todos os termos do Tillor, e [Na prática](/praktijk), quatro exemplos completos que seguem um método de trabalho inteiro através dos módulos, como receber um cliente sazonal ou cobrar consumo.
- Cada módulo começa agora com o que é, do que precisa e o que acontece a seguir, com um bloco **Bom saber** e uma lista **Problemas?** por tarefa. Também são novos [Convidar utilizadores e dar permissões](/gebruikers/gebruikers-en-rechten), uma visão geral de todos os [tipos de notificação](/communicatie/notificatietypes) e páginas separadas por tarefa para [contadores](/meterbeheer), [controladores](/controllers) e [impressoras](/printer).

### Assinaturas [#handtekeningen]

- Clientes, pessoas de contacto e partes externas podem agora assinar um documento também no tablet da receção. Na vez deles, clique em **Assinar no tablet**, com código ou sem código se tiver verificado você próprio a identidade; o tablet mostra o nome deles em letras grandes, também num mandato SEPA. Veja [No tablet da receção](/handtekeningen/ondertekenen#op-de-tablet-aan-de-receptie).
- Em **Enviar**, o editor verifica tudo de uma vez: um signatário sem campo de assinatura, ou um cliente ou pessoa de contacto sem endereço de e-mail e número de telemóvel, é logo assinalado. Veja [Não consigo enviar](/handtekeningen/handtekening-vragen#problemen).

### Transações bancárias [#banktransacties]

- Clique no ícone (i) numa transação bancária para abrir o seu painel de detalhes. No menu de ações cria uma tarefa sobre ela ou copia uma ligação que abre logo o painel. Veja [Consultar transações bancárias](/boekhouden/betalingsrapporten/betaalmethodes/ponto#banktransacties-bekijken).

### Produtos e faturas [#producten-en-facturen]

- O IVA em autoliquidação é agora uma opção em **% IVA**, ao lado das taxas: para serviços na UE e subcontratante, e também fornecimento intracomunitário, exportação e isento. A fatura recebe a menção legal, lançar pede um número de IVA quando é necessário, e a linha entra no Admisol na grelha certa. Para o Odoo, preencha por regime o nome do IVA do Odoo nas [definições de exportação](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo#btw-regimes); um preço agendado também pode converter um produto para um regime. Veja [IVA em autoliquidação e outros regimes sem IVA](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw).
- Registe valores de antes do Tillor, como antigas cauções, como saldo inicial na conta de um cliente: à mão ou com uma importação para todos os clientes de uma vez. Contam para o saldo e para a monitorização, mas não são uma fatura e não seguem para a contabilidade. Veja [Saldos iniciais de antes do Tillor](/producten/product-aanmaken#beginsaldi-van-voor-tillor).
- Um pacote de produtos é agora código: cada passo tem um produto, uma quantidade e uma **Fórmula** opcional em TypeScript que, ao guardar a fatura, determina se o passo entra, com que quantidade, ou exatamente que linhas (descrição própria, preço, método de acesso). A fórmula lê o cliente, a ocupação, o terreno e a linha principal, incluindo campos personalizados, além das listas de contadores e métodos de acesso. As opções fixas por contador, etiqueta NFC e cão desapareceram; o que faziam está no manual como fórmula de exemplo. Veja [Fórmula por passo](/producten/bundel-velden#formule-per-stap).
- Monitorize o saldo de um cliente numa conta da razão geral, por exemplo para cauções. O Tillor mostra o saldo na fatura e recusa uma fatura que o leve abaixo de zero. Com uma permissão própria lança na mesma, com uma justificação na cronologia. Veja [Monitorizar o saldo do cliente](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken).
- No separador **Faturação** de um cliente está a nova tabela **Contas**: o saldo por conta da razão geral em que algo foi lançado, com por baixo as faturas lançadas e a conta corrente. Se tiver contas da razão geral monitorizadas, por defeito vê só essas; com um filtro vê todas. Veja [Monitorizar o saldo do cliente](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken).

### Faturas e pagamentos [#facturen-en-betalingen]

- Com **Ligação de pagamento parcial** no menu de uma fatura lançada cria uma ligação de pagamento para uma parte do valor em dívida. Veja [Criar uma ligação para um pagamento parcial](/facturen/betalingen-registreren#een-link-voor-een-deelbetaling-maken).
- Um mandato SEPA assinado é selado, de modo que um leitor de PDF mostra qualquer alteração posterior. Veja [Mandato SEPA](/betalingsverwerking/mandaat).

### Utilizadores e permissões [#gebruikers-en-rechten]

- Um grupo pode permitir ou recusar permissões para todos os seus membros; uma recusa prevalece sempre. Em **Editar permissões** vê, por permissão, se vem diretamente ou através de um grupo. Veja [Permissões de grupo](/gebruikers/groepen#groepsrechten).

### Parque e técnica [#park-en-techniek]

- Um controlador pode conhecer várias redes Wi-Fi, numa ordem que você define. Veja [Definições do controlador](/controllers/settings).
- Num contador, **Consumo e tendências** mostra o consumo por hora para um dia, com um novo seletor de período. Veja [Gestão de contadores](/meterbeheer/meterstanden-en-trends#verbruik-en-trends-lezen).

### Tarefas [#taken-1]

- Imprima uma tarefa em A4 ou numa impressora de talões a partir do menu da tarefa; a impressão mostra também os itens associados e os bloqueios. No mesmo menu está **Eliminar**, exceto nas tarefas que só uma automação pode concluir. Veja [Detalhes da tarefa](/taken/taakdetails#het-menu-van-de-taak).
- Adicione subtarefas enquanto cria uma tarefa. Veja [Criar uma tarefa](/taken/taakdetails#een-taak-aanmaken).
- Uma vista pode ocultar tarefas concluídas ao fim de um dia, uma semana ou um mês. Veja [Ocultar tarefas concluídas](/taken/indelingen#voltooide-taken-verbergen).

## Outubro de 2026 [#oktober-2026]

### Terrenos [#terreinen]

- A **Tarifa calculada** de um terreno segue agora uma fórmula que escreve você mesmo por organização em <UIPath>Definições > Tarifa do lote</UIPath>, com as mesmas variáveis `{terrain.…}` das automações. Experimenta logo a fórmula num terreno, e cada parte com nome recebe uma coluna na exportação de terrenos. O resultado é guardado no terreno e acompanha qualquer alteração do terreno ou da fórmula. Veja [Fórmula de tarifa](/terreinen#tariefformule).

### Assinaturas [#handtekeningen-1]

- Faça assinar online um PDF, como um contrato de arrendamento, por clientes, pessoas de contacto, colegas e partes externas, uns a seguir aos outros. O PDF assinado com página de prova fica nos documentos do cliente. Veja [Assinaturas](/handtekeningen).
- Um signatário também pode escrever a sua assinatura ou rubrica em vez de a desenhar. Veja [Como alguém assina](/handtekeningen/ondertekenen).
- No editor escolhe em **Campos para** para quem coloca os campos, e põe um campo colocado em nome de outra pessoa com **Signatário**. Os campos colocam-se tocando ou arrastando. Veja [Colocar os campos](/handtekeningen/handtekening-vragen).

### Iniciar sessão [#inloggen]

- Se o seu endereço de e-mail ainda estiver **Não verificado**, verifica-o com um clique a partir da página **Conta** ou da página de início de sessão. Só depois o Tillor associa um segundo método de início de sessão à sua conta. Veja [Verificar o seu endereço de e-mail](/inloggen#je-e-mailadres-verifiëren).

### Automações [#automatiseringen]

- Com o passo **Executar código** escreve um pouco de TypeScript sobre as variáveis do fluxo, por exemplo para determinar que subtarefas uma tarefa recebe. O resultado lê-o nos passos seguintes como `{result}`. Veja [Executar código](/automatiseringen/logica#code-uitvoeren).
- Um fluxo pode primeiro **Sincronizar transações bancárias** e depois enviar um lembrete de pagamento, para que uma fatura que acabou de ser paga não receba lembrete. Guarde essa automação a partir da rede do escritório, e o Tillor memoriza o IP para a ligação bancária. Veja [Sincronizar transações bancárias](/automatiseringen/acties/facturen-en-betalingen#banktransacties-synchroniseren).
- Desative os avisos de cobrança automáticos para um cliente ou para uma única fatura. Um fluxo de lembretes ignora os clientes que já o têm ativado. Veja [Desativar lembretes automáticos para o cliente](/automatiseringen/acties/facturen-en-betalingen#automatische-herinneringen-uitschakelen-voor-klant).
- Em **Criar tarefa** pode definir que só o fluxo conclui a tarefa. Com **Eliminar tarefa** remove essa tarefa mais tarde. Veja [Tarefas](/automatiseringen/acties/taken).
- Numa ação de tarefa pode ativar **Pedir confirmação**. O colega confirma primeiro a escolha, e só depois o fluxo continua.
- Crie você mesmo automações num ecrã de trabalho: escolha um gatilho, adicione passos, condições e tempos de espera e veja, por execução, o que aconteceu. Veja [Automações](/automatiseringen).
- Uma automação pode ter vários gatilhos. O Tillor bloqueia ciclos em que uma automação se continua a iniciar a si própria.
- Agora pode esperar até uma hora fixa, um número de horas ou minutos, ou até a sua organização fechar.
- Inicie uma automação numa data de um registo, com um gatilho agendado ou a partir do seu próprio sistema através de um [webhook de entrada](/ontwikkelaars/automatiseringen).
- Com o passo **Pedir uma decisão** cria você mesmo os botões na tarefa, com cor e ícone próprios, eventualmente com uma nota ou confirmação obrigatória. Cada botão é uma saída do passo. Veja [Pedir uma decisão](/automatiseringen/logica#vraag-om-een-beslissing).
- O gatilho **É escolhida uma ação de tarefa** inicia uma automação quando alguém escolhe um botão associado numa tarefa. Num webhook de entrada, com **Ignorar repetições** evita que a mesma chamada inicie o fluxo duas vezes. Veja [Gatilhos](/automatiseringen/triggers).
- **Aguardar um evento** tem uma saída **Eliminado** para quando o registo do fluxo desaparece. Veja [Lógica](/automatiseringen/logica#wachten-op-een-gebeurtenis).
- No editor testa com um registo real, coloca **Molduras** à volta dos passos e repõe uma versão anterior através de **Histórico**. Veja [Começar](/automatiseringen/aan-de-slag#de-editor).

### Tarefas [#taken-2]

- Na lista de tarefas vê todos os registos associados e filtra por tipo com **Ligado a**. Veja [Filtrar](/taken/filteren).
- Os e-mails de tarefas mostram uma pré-visualização da tarefa. As tarefas também se encontram através de [Pesquisar](/zoeken).
- Antes de uma tarefa privada ficar visível para toda a organização, o Tillor pergunta se a quer tornar pública. Veja [Tarefas privadas](/taken/prive-taken).
- Tarefas privadas, uma vista de calendário e um temporizador que continua a contar enquanto trabalha noutra coisa. Veja [Tarefas](/taken).
- Partilhe uma vista como página só de leitura ou como ligação de calendário. Veja [Partilhar tarefas](/taken/delen).
- Os estados de espera foram reunidos num só estado, **A aguardar resposta**.
- Atribua uma tarefa a um grupo e partilhe uma vista com grupos de colegas. Veja [Quem vê uma vista](/taken/weergaven#wie-ziet-een-weergave).
- Uma tarefa pode ter botões de escolha, eventualmente com uma nota ou confirmação obrigatória. Veja [Tarefas com botões de escolha](/taken/taakdetails#taken-met-keuzeknoppen).
- Cole um ficheiro na janela da tarefa para o adicionar como anexo. Os campos personalizados das tarefas também estão nessa janela.

### Caixa de entrada [#inbox]

- O e-mail de lembrete do chat do site abre agora a conversa também noutro dispositivo ou noutro navegador. Veja [Lembrete por e-mail](/inbox/website-chat-instellingen#herinnering-per-e-mail).

### Notificações [#meldingen]

- Escolha, por notificação, se o Tillor o contacta por e-mail ou push. Define isso em **Conta**, em **Notificações**, ou, para um colega, em **Definições de notificações** nos membros da organização. Veja [Utilizadores](/gebruikers).

### Tablets e quiosques [#tablets-en-kiosken]

- Cada tablet ou quiosque tem a sua própria página de dispositivo com ações remotas, diagnóstico, histórico e definições. Veja [Tablets e quiosques](/mobiele-app/tablets-en-kiosken).
- Bloqueio de quiosque, modo noturno e notificações por dispositivo para tablets Android.

### Faturas e pagamentos [#facturen-en-betalingen-1]

- Numa linha de fatura com um período, escolha o terreno no mapa. Ao lançar, o Tillor cria a reserva e faz o check-in do hóspede, consoante o produto. Veja [Faturas](/facturen/aanmaken-en-bewerken#periode-en-terrein-kiezen).
- Relatórios de pagamento em rascunho para o dia em curso. Veja [Relatórios de pagamento](/boekhouden/betalingsrapporten).
- Se o Mollie retiver uma reserva de saldo num pagamento, o Tillor lança-a como *Reserva de saldo* no fornecedor Mollie em vez de na conta de espera, e na libertação ela desaparece aí. Veja [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol#balansreserve).
- Os clientes recebem um lembrete para assinar o seu mandato SEPA antes de expirar.

### Clientes e ficheiros [#klanten-en-bestanden]

- Anexos, documentos e e-mails do Outlook consulta-os num único visualizador de ficheiros, sem descarregar. Pode reproduzir vídeos; os carregamentos podem ter até 250 MB.
- A visão geral de clientes mostra estadias ativas e em atraso. A faturação automática faz uma pausa quando o consumo de água é invulgarmente elevado.
- Num terreno vê o histórico das ocupações, com uma ligação ao cliente.

### Campos personalizados [#eigen-velden-1]

- Adicione você mesmo campos a clientes, terrenos, ocupações, contadores, tarefas, produtos, documentos, reservas e métodos de acesso, em <UIPath>Definições > Campos personalizados</UIPath>. Coloca-os entre os campos predefinidos, faz com que apareçam sob uma condição e define quem os vê ou edita. Veja [Campos personalizados](/eigen-velden).

### Produtos [#producten]

- Agende um novo preço a partir de uma data com **Preços agendados**; o Tillor aplica-o nesse dia e envia-lhe um e-mail. A **Calculadora de IVA** converte um preço ou ajusta-o com uma percentagem. Veja [Agendar uma alteração de preço](/producten/prijzen-plannen).

### Clientes [#klanten]

- No topo de um cliente está o cartão com os dados mais importantes, com comentários afixados. Os aniversários de clientes e parceiros são assinalados. Veja [Gestão de clientes](/klantenbeheer).
- Um endereço preenche-se com **Rua**, **N.º** e **Porta**, com sugestões de endereço enquanto escreve. Veja [Gestão de clientes](/klantenbeheer#adres-invullen).

### Controlo de acessos [#toegangscontrole]

- Num passe QR vê em que carteira está, e com **Sincronizar passe Wallet** volta a prepará-lo. Veja [Controlo de acessos](/toegangscontrole).

### Integrações [#integraties]

- Ligue o Partoo para enviar automaticamente os seus horários de funcionamento, épocas e exceções para o seu estabelecimento. Veja [Partoo](/integraties/partoo).

## Setembro de 2026 [#september-2026]

### Pagamentos [#betalingen]

- Os mandatos SEPA assina-os no próprio Tillor, à distância ou no tablet da receção. Veja [Mandato SEPA](/betalingsverwerking/mandaat).
- Uma nova página de pagamento com escolha própria do método de pagamento, código QR e reencaminhamento para a aplicação Bancontact. O Tillor avisa se um método de pagamento tiver uma avaria.

### Controlo de acessos [#toegangscontrole-1]

- Novo método de acesso: código PIN. Um código PIN pode ser convertido automaticamente numa matrícula. Veja [Controlo de acessos](/toegangscontrole#toegangsmethoden-beheren-via-het-klantprofiel).

### Tarefas [#taken-3]

- Vistas guardadas com um construtor de filtros, partilha com colegas e um feed de calendário por vista. Veja [Vistas](/taken/weergaven).
- Dependências entre tarefas, a prioridade **Urgente** e etiquetas que cria na hora.
- Associe uma tarefa a vários clientes, ou a terrenos, contadores, faturas e reservas.

### Parque e comunicação [#park-en-communicatie]

- Colora os terrenos no mapa por tipo e exporte o mapa como PDF A4. Veja [Mapa](/kaart).
- Para a telefonia Voys: encaminhamento por cliente e voicemail automático. Veja [Telefonia Voys](/communicatie/providers/voys).
- Exporte a visão geral de faturas de um cliente para Excel.


# Pesquisar no Tillor (/pt-PT/zoeken)

Com a pesquisa encontra de uma só vez um cliente, uma fatura, uma ocupação, uma reserva, uma chamada telefónica, um terreno, um contador, uma tarefa ou um relatório de pagamento, a partir de qualquer página. Assim, não precisa de ir primeiro à secção certa. O resultado abre diretamente a página certa.

<Callout type="info" title="Bom saber">
- Em **Todos os resultados**, o Tillor obtém no máximo dez resultados por categoria e mostra os três melhores. Escolha uma categoria para ver até cem.
- Nos clientes, o Tillor também encontra resultados com um pequeno erro de escrita, pelo que "Jansen" também devolve "Janssen".
- As notas das chamadas telefónicas são cifradas e não são pesquisadas. Pesquise pelo número de telefone.
- As etiquetas NFC e as matrículas não têm categoria própria. Encontra-as em **Clientes**.
</Callout>

## Pesquisar e abrir um resultado [#zoeken-en-een-resultaat-openen]

<Steps>
<Step>
### Abra a janela de pesquisa [#open-het-zoekvenster]
Clique em **Pesquisar** no cabeçalho (num ecrã estreito, na lupa) ou prima **⌘K** (Mac) ou **Ctrl+K** (Windows). Com o mesmo atalho fecha a janela novamente.

<DocScreenshot src="/screenshots/zoeken/search-dialog-open.png" alt="Pesquisa global aberta" />
</Step>
<Step>
### Escreva o termo de pesquisa [#typ-je-zoekterm]
Os resultados aparecem assim que faz uma pequena pausa na escrita. Surgem agrupados por categoria, e a categoria com o melhor resultado fica no topo: a primeira linha é, portanto, sempre o melhor resultado. Uma boa correspondência no título conta mais do que uma correspondência na descrição. Em cada categoria vê os três melhores resultados, e com **Mostrar mais …** abre a categoria inteira. Em baixo aparece em que categorias não foi encontrado nada.

<DocScreenshot src="/screenshots/zoeken/search-results.png" alt="Resultados da pesquisa por Jonas por categoria, com a categoria do melhor resultado no topo" />
</Step>
<Step>
### Limite a uma categoria (opcional) [#beperk-tot-één-categorie-optioneel]
Se pesquisar apenas num tipo de dados, escolha-o com o botão **Tudo** no início do campo de pesquisa, por exemplo **Clientes**. Pode fazê-lo antes ou depois de escrever; o campo de pesquisa mostra depois **Pesquisar em Clientes…**. Também pode clicar no nome de uma categoria nos resultados.

Com o teclado:
- **Shift+Tab** abre a lista de categorias.
- **⌥1** a **⌥9** (**Alt+1** a **Alt+9** no Windows) escolhe logo uma categoria, pela ordem dessa lista. O número também está ao lado do nome de cada categoria nos resultados.
- **Tab** percorre as categorias que têm resultados.

Voltar a tudo: escolha **Tudo** na lista, ou prima **Backspace** num campo de pesquisa vazio.
</Step>
<Step>
### Abra o resultado [#open-het-resultaat]
Use as teclas de seta para escolher e prima **Enter**. Com **Ctrl+Enter** (**⌘+Enter** no Mac) o resultado abre num novo separador. Também pode clicar com o rato. **Escape** fecha a janela.
</Step>
</Steps>

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- O resultado escolhido abre o cliente, a fatura ou outra página no mesmo separador. Com **Ctrl+Enter** (**⌘+Enter** no Mac) abre num novo separador.
- Os seus dados não se alteram: a pesquisa apenas lê.
- Junto a cada resultado aparece o campo em que foi encontrado, por exemplo **Telefone:** ou **Fatura:** com o valor que corresponde.

## O que o Tillor pesquisa [#wat-tillor-doorzoekt]

| Categoria | O que pode pesquisar |
|-----------|-----------------------|
| **Clientes** | Nome, número de cliente, e-mail, telefone, morada e localidade, número de IVA, observações, pessoas de contacto (nome, e-mail, telefone) e métodos de acesso, como um cartão NFC ou uma matrícula |
| **Faturas** | Número da fatura (com ou sem prefixo, ano e separadores), valor total, o ID da ligação da fatura e as notas (públicas e internas) |
| **Ocupações** | Nome do terreno, nome próprio e apelido do cliente e o ID da ocupação |
| **Reservas** | Número da reserva (por exemplo `RES/2026/0001`, com ou sem prefixo e ano, ou compacto `20260001`), nota, nome do cliente e o ID da ligação |
| **Chamadas telefónicas** | Número de entrada e de saída, ID da chamada e referência externa |
| **Terrenos** | Nome, descrição, ID e o número do contador de gás do terreno |
| **Contadores** | Nome, número de série e ID do contador |
| **Tarefas** | Título, descrição e ID. Um resultado mostra também o cliente ou o terreno associado |
| **Relatórios de pagamento** | Número do relatório |

<Callout type="info" title="NFC e matrícula">
Não existe uma categoria separada para etiquetas NFC. Os cartões NFC e outros valores de acesso pertencem a **Clientes** e aparecem aí assim que correspondem ao seu termo de pesquisa.
</Callout>

## Quantos resultados vê? [#hoeveel-resultaten-zie-je]

Se houver dez ou mais resultados numa categoria, aparece **10+** junto ao nome dessa categoria. Na vista geral vê os três melhores resultados por categoria. Escolha a categoria, ou clique em **Mostrar mais …**, para ver até cem resultados. Nas reservas e nas faturas, a tolerância a erros de escrita funciona sobretudo em números e notas.

## Dicas de pesquisa [#zoektips]

- **Matrícula, NFC ou código QR**: pesquise pelo valor registado no cliente. Encontra o cliente em **Clientes**.
- **Número de fatura ou de reserva**: escreva o número tal como aparece no documento, ou parte dele. Para `RES/2026/0042` também funcionam `2026/0042` e `20260042`.
- **Valor**: também encontra uma fatura pelo valor total, por exemplo `120,50`.
- **Quem está onde**: em **Ocupações**, pesquise pelo nome do terreno ou do cliente.
- **Nomes parciais**: nos clientes, normalmente basta uma parte do nome. Nas reservas, ajuda uma palavra da nota.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Vê Nenhum resultado encontrado">
Verifique a ortografia e experimente uma parte mais curta do termo. Se escolheu uma categoria, o Tillor pesquisa apenas nela. Se existirem resultados noutra categoria, a janela indica-o. Escolha **Tudo** com o botão no início do campo de pesquisa, ou clique em **Remover filtro**.
</Accordion>
<Accordion title="Vê Pesquisa indisponível">
Algo correu mal durante a pesquisa. Clique em **Tentar novamente**. Se continuar a falhar, consulte o [estado do sistema](https://status.tillor.eu).
</Accordion>
<Accordion title="Não encontro um cliente pela matrícula ou pelo cartão NFC">
Pesquise pelo valor exato registado no cliente. Encontra o cliente em **Clientes**, não numa categoria separada.
</Accordion>
<Accordion title="Não encontro uma reserva">
Escreva o número tal como no documento, ou parte dele: para `RES/2026/0042` também funcionam `2026/0042` e `20260042`. Em alternativa, pesquise pelo nome do cliente.
</Accordion>
<Accordion title="Uma chamada telefónica não é encontrada pela nota">
As notas das chamadas telefónicas são guardadas cifradas e, por isso, não são pesquisadas. Pesquise pelo número de telefone.
</Accordion>
<Accordion title="O atalho de teclado não funciona">
Alguns navegadores ou extensões usam Ctrl+K ou ⌘K para si. Nesse caso, clique em **Pesquisar** no cabeçalho.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Gestão de clientes" href="/klantenbeheer" description="Gerir clientes" />
  <Card title="Ocupações" href="/bezettingen" description="Um cliente num terreno" />
  <Card title="Reservas" href="/reserveringen" description="Gerir reservas" />
  <Card title="Faturas" href="/facturen" description="Gerir faturas" />
</Cards>


# Registo de atividade (/pt-PT/activiteitenlog)

No registo de atividade vê o que mudou no Tillor, quando e por quem. Abre-o num cliente, fatura, tarefa ou outro registo, e de forma centralizada em **Registo de auditoria** se tiver permissões para isso. É um rasto só de leitura, que usa para verificar ou provar algo.

<Callout type="info" title="Bom saber">
- Uma entrada não pode ser editada nem eliminada
- Numa exportação aparecem por defeito os últimos 30 dias, e no máximo um ano
- A abertura repetida do mesmo documento no prazo de dez minutos é registada uma só vez
- As horas são mostradas no seu fuso horário
- As ações de uma automatização, de uma chave de API ou do sistema também aparecem, com o tipo de ator
</Callout>

## Ver o registo de atividade [#activiteitenlog-bekijken]

Na aplicação, isto chama-se normalmente **Eventos** ou **Atividade**, consoante o local onde está. Quem tem a permissão *Ver o registo de auditoria* pode ainda abrir uma vista central através de *Registo de auditoria* na barra lateral (acima de Definições), com filtros por utilizador, tipo de evento e data.

| Onde | Navegação | Etiqueta na aplicação |
|------|-----------|-----------------------|
| Cliente (toda a atividade relacionada) | *Clientes > cliente > Eventos* | Eventos |
| Fatura | *Administração > Faturas > fatura* | Eventos |
| Reserva | *Clientes > cliente > Reservas > reserva* | Atividade |
| Terreno | *Parque > Terrenos > terreno* | Eventos |
| Contador | *Parque > Contadores > contador* | Atividade |
| Produto | *Administração > Produtos > produto* | Eventos |
| Tarefa | *Tarefas > tarefa* ou *Clientes > cliente > Tarefas > tarefa* | Atividade |
| Etiqueta NFC | *Controladores > Etiquetas NFC > etiqueta* | Atividade |
| Tablet, quiosque ou telefone | *Definições > Tablets e quiosques > dispositivo* | Histórico |
| Organização (central) | *Registo de auditoria* (acima de Definições, permissão *Ver o registo de auditoria*) | Registo de auditoria |
| Relatório de pagamento | *Administração > Relatórios de pagamento > relatório* | Registo de eventos |

Por cada atividade vê na cronologia:

- **Título** - tipo de evento (p. ex. "Fatura lançada", "Cliente atualizado")
- **Utilizador** - colega que executou a ação (ou o Tillor em ações automáticas)
- **Hora** - data e tempo relativo
- **Descrição** - detalhes adicionais; por vezes com ligações a faturas ou outros registos relacionados
- **Antes / depois** (por vezes) - ao criar, alterar ou eliminar dados de cliente, contacto, fatura, pagamento, mandato de pagamento, grupo de pagamento, documento, método de acesso, ponto de acesso, controlador, terreno, contador, leitura de contador, produto, ocupação, tarefa ou resposta, bem como ao digitalizar, atribuir ou desassociar um documento de identificação e ao alterar definições, direitos de membros, faturação ou NFC: que campos foram alterados. Os códigos PIN dos pontos de acesso e os dados pessoais de um documento de identificação não são guardados no registo
- **Anexos** (por vezes) - ficheiros para descarregar, por exemplo em caso de integrações falhadas
- **Início / fim de sessão** - quando um colega inicia ou termina sessão, visível na vista central do registo de auditoria
- **Aplicações OAuth e consentimento** - criar, alterar, eliminar ou rodar o segredo de aplicações OAuth, bem como consentimento dado, recusado ou revogado; visível na vista central do registo de auditoria. Os segredos de cliente não são guardados no registo
- **Gestão e segurança** - alterações ao perfil da organização (nome, dados legais, IVA, IBAN, logótipo, modo de manutenção), convites e novos membros, chaves de API pessoais (criar, alterar, renovar, eliminar), sessões terminadas, webhooks, automatizações, grupos de colegas, tipos de terreno, quadros de contadores, grupos de controladores, integrações instaladas ou removidas e a aceitação do acordo de tratamento de dados; visível na vista central do registo de auditoria. As chaves, os segredos de webhooks e as definições de integrações não são guardados; numa integração vê apenas que definições foram alteradas
- **Consulta de dados pessoais** - quem abriu ou descarregou um documento, quem viu ou descarregou as imagens ou os ficheiros de um documento de identificação, ou quem abriu o PDF de uma fatura ou o enviou para o tablet. A abertura repetida no prazo de dez minutos é registada uma só vez; cada descarga de um documento de identificação é registada em separado

## Atividade por registo [#activiteiten-per-record]

Nas páginas de detalhe vê uma cronologia com a atividade desse registo. No separador **Eventos** de um cliente estão todas as atividades associadas a esse cliente (faturas, pagamentos, ocupações, etc.).


<DocScreenshot src="/screenshots/activiteitenlog/customer-events.png" alt="Eventos no perfil do cliente Jonas Maes" />

Nas **reservas**, isto inclui, entre outros, a criação, o check-in e o check-out, os cancelamentos e as reversões relacionadas, e a atualização dos dados da reserva.

Nos **grupos de pagamento** vê também que pagamentos foram adicionados a um grupo ou retirados dele, e nos **controladores** que pedidos de adoção foram aprovados ou rejeitados.

Nos **relatórios de pagamento**, isto inclui, entre outros, a criação do relatório, a finalização de um relatório rascunho e o envio para a contabilidade.

Nos **pedidos de assinatura** vê cada passo: criado e alterado, enviado, ligação enviada (de novo), lembrete enviado, página de assinatura aberta, código enviado ou introduzido incorretamente, assinado, recusado, reposto como rascunho, cancelado, expirado e concluído. Veja [Prova e validade](/handtekeningen/bewijs-en-geldigheid).

Nas **notificações externas** vê quando um sistema associado atualizou ou eliminou uma notificação por si registada.

<Callout type="info">
O registo de atividade é só de leitura. As entradas não podem ser editadas nem eliminadas.
</Callout>

## Quem o fez? [#wie-heeft-het-gedaan]

Cada linha mostra, além do utilizador, também **que tipo de ator** executou a ação: um utilizador com sessão iniciada, uma chave de API, uma ligação OAuth, uma automatização, o conector do Tillor ou o próprio sistema. No caso de uma chave de API ou de uma ligação OAuth, o ID dessa chave ou ligação consta dos detalhes, para que, se uma chave for divulgada, veja exatamente o que foi feito com ela. Se aparecer **Desconhecido**, o Tillor não conseguiu determinar o ator; isto é deliberadamente diferente de "Sistema".

## Eventos de segurança [#beveiligingsgebeurtenissen]

Inícios de sessão falhados, chaves de API e tokens OAuth recusados, acessos recusados (permissões em falta), limites de pedidos excedidos e a abertura da sua organização por um administrador do Tillor também são mostrados no registo de atividade, com endereço IP e navegador. Os membros com a permissão **Alertas de segurança** recebem todas as horas uma notificação quando webhooks, chaves de API ou automatizações foram alterados ou quando o acesso foi recusado repetidamente.

O acesso à tua conta que dás à [Tillie](/vraag-het-tillie#tillie-in-je-account-laten-kijken) ou retiras, e cada alteração que confirmas através da Tillie, também aparecem aqui.

## Exportar para uma auditoria [#exporteren-voor-een-audit]

Com **Exportar** no registo de atividade descarrega todas as linhas do período escolhido (por defeito os últimos 30 dias, no máximo um ano) como ZIP com o ficheiro de dados (CSV ou JSON Lines), um `manifest.json` com o número de linhas, o período, quem exportou e a soma de controlo SHA-256 do ficheiro de dados, e um ficheiro `CHECKSUMS.sha256` que pode verificar com `sha256sum -c`. A própria exportação também fica registada no registo, com a mesma soma de controlo. Também a abertura do registo de atividade completo e as exportações em massa de dados de clientes (lista de clientes, registo de acessos, terrenos, contadores) são registadas.

Todas as horas são guardadas em **UTC** em servidores com sincronização horária NTP e mostradas no seu fuso horário; a exportação contém horas ISO 8601 em UTC.

## Para que serve o registo? [#waarvoor-gebruik-je-de-log]

- **Controlo** - verificar que colega lançou uma fatura ou alterou um cliente
- **Resolução de problemas** - apurar quando ocorreu um erro
- **Auditorias** - manter um rasto completo para controlos internos ou externos

## Ver também [#zie-ook]

<Cards>
  <Card title="Utilizadores" href="/gebruikers" description="Gerir utilizadores e permissões" />
  <Card title="Faturas" href="/facturen" description="Ver o histórico de faturas" />
</Cards>


# Primeiros passos (/pt-PT/automatiseringen/aan-de-slag)

Nesta página cria a sua primeira automação e fica a conhecer o editor, o ecrã onde desenha os fluxos. Precisa da permissão **Gerir automatizações** ou de **Todas as permissões**. Veja a [Visão geral](/automatiseringen) para o contexto.

## A vista geral [#het-overzicht]

Vá a **Administrador > Automações**. Vê uma lista com uma linha por automação:

- o nome e uma etiqueta como **2 problemas** se ainda houver algo errado no fluxo (veja [Problemas e ativação](/automatiseringen/problemen))
- a descrição
- o acionador escolhido, o número de passos e quem criou a automação (**por**)
- uma série de barrinhas com as últimas execuções, com ao lado a hora da última execução ou **Ainda não foi executada**. Uma barrinha vermelha é uma execução falhada
- um interruptor para ativar ou desativar a automação, e um menu com três pontos

<DocScreenshot src="/screenshots/automatiseringen/overview.png" alt="Vista geral das automações com a lista, os filtros e o campo de pesquisa" />

No topo da lista filtra com **Todas**, **Ativa** e **Em pausa**. Se uma automação tiver problemas, surge também um filtro **Problemas**. Com **Pesquisar automações** pesquisa por nome ou descrição.

Clique no nome para abrir o editor. Com o interruptor liga ou desliga uma automação. Não é possível ligá-la enquanto houver problemas. O menu **Ações da automação** tem duas opções:

| Opção | O que faz |
|---|---|
| **Duplicar** | Cria uma cópia com o nome *[nome] (cópia)*. A cópia fica em pausa |
| **Eliminar** | Elimina a automação e o histórico de execuções. O Tillor pede primeiro confirmação |

As execuções que nesse momento aguardam num atraso terminam se eliminar a automação.

## Criar uma nova automação [#een-nieuwe-automatisering-maken]

Clique em **Nova automação**. Abre-se uma galeria com seis pontos de partida. Pode ajustar cada passo depois.

| Ponto de partida | O que faz |
|---|---|
| **Começar de raiz** | Um fluxo vazio, apenas com um acionador |
| **Verificar a parcela após a partida** | Cria uma tarefa de verificação da parcela quando uma ocupação termina, com prioridade alta e atribuída a quem terminou a ocupação |
| **Acompanhar faturas por pagar** | Espera até depois da data de vencimento, envia um lembrete de pagamento e, uma semana depois, cria uma tarefa para telefonar ao cliente se a fatura continuar em aberto |
| **Enviar reservas para outro sistema** | Para cada nova reserva, envia um payload próprio para o seu endpoint de webhook e cria uma tarefa se a entrega falhar |
| **Verificar um contador que deixou de contar** | Cria uma tarefa para a receção quando um contador fica parado enquanto o terreno foi usado, com subtarefas para a verificação no local |
| **Chamar a Tillor API** | Adiciona um comentário a cada nova tarefa através da Tillor API |

<DocScreenshot src="/screenshots/automatiseringen/gallery.png" alt="Galeria Nova automação com os pontos de partida" />

Assim que escolhe, o Tillor cria a automação e abre o editor. A automação fica em pausa até a ativar.

## O editor [#de-editor]

O editor ocupa o ecrã todo e tem três partes: à esquerda a lista de passos, ao centro a tela e à direita o painel. O nome da automação aparece no topo, no caminho de navegação, e pode ser alterado diretamente aí.

<DocScreenshot src="/screenshots/automatiseringen/editor.png" alt="Editor com a lista de passos à esquerda, a tela ao centro e o painel à direita" />

Passe o rato sobre as marcas ℹ para ver uma breve explicação de cada parte.

**Lista de passos (esquerda).** Procure um passo com **Pesquisar passos**. No topo está o grupo **Utilitários** com **Comentário** e **Moldura** (veja [Comentários e molduras](#opmerkingen-en-kaders)). Por baixo estão os passos em seis grupos, com **Documentos** pelo meio:

- **Lógica**: o acionador **Quando isto acontece** e condições, esperas, pesquisas e ciclos, como **Se / senão**, **Desvio**, **Atraso**, **Aberto agora?**, **Procurar um registo**, **Para cada** e **Pedir uma decisão**. Veja [Condições, desvios e atrasos](/automatiseringen/logica)
- **Tarefas**: criar, procurar e atualizar tarefas
- **Documentos**: procurar e atualizar documentos
- **Hóspedes e mensagens**: mensagens a hóspedes e colegas, comentários, a caixa de entrada, clientes e reservas
- **Faturas e pagamentos**: faturas, ligações de pagamento, mandatos e consumo
- **Acesso e dispositivos**: meios de acesso, cancelas, eletricidade, etiquetas NFC e tablets
- **Integrações**: **Enviar webhook** e **Pedido à API**

O que cada ação faz está em [Ações](/automatiseringen/acties). No fim está **Pedir um passo**, para quando sentir falta de um passo.

**Tela (centro).** Aqui vê o fluxo. No topo está o acionador, por baixo os passos com linhas entre eles. Em baixo à esquerda aumenta e diminui o zoom.

**Painel (direita).** No topo está o interruptor **Ativo**, em caso de problemas um botão como **1 problema**, um botão **Arrumar** que organiza os passos bem uns debaixo dos outros (os comentários ficam onde estão) e um botão **Ocultar painel**. Se ocultar o painel, **Mostrar painel** volta a mostrá-lo. Por baixo escolhe um separador:

| Separador | O que faz aí |
|---|---|
| **Configurar** | Ajustar o passo selecionado. Se não selecionar nada, pode preencher uma **Descrição** para a automação |
| **Execução de teste** | Experimentar o fluxo, veja [Testes e execuções](/automatiseringen/testen-en-uitvoeringen) |
| **Execuções** | Ver o que as execuções reais fizeram |
| **Histórico** | Ver e repor versões guardadas anteriores, veja [Versões anteriores](#eerdere-versies) |

Se fez alterações, no fundo do painel aparece **Alterações não guardadas** com os botões **Reverter** e **Guardar**. **Reverter** repõe o fluxo na última versão guardada. Se o painel estiver oculto, esses botões estão no canto superior direito da tela.

Enquanto não tiver selecionado nenhum passo, por baixo da descrição aparece quem criou a automação. As execuções falhadas são enviadas por e-mail a essa pessoa, no máximo uma vez por hora por automação.

Num telemóvel, o painel começa oculto, para que a tela ocupe o ecrã todo. Toque num passo ou em **Mostrar painel** para o abrir.

### Adicionar e ligar passos [#stappen-toevoegen-en-verbinden]

Tem quatro formas de adicionar um passo:

- Clique num passo da lista à esquerda. Ele aparece no centro da tela
- Arraste um passo da lista para a tela
- Clique no sinal de mais por baixo de uma saída que ainda não leva a lado nenhum (**Adicionar um passo depois de "[saída]"**) e escolha um passo. O novo passo fica logo ligado
- Arraste um passo para cima de uma linha. Ele fica entre os dois passos (**Inserir um passo aqui**)

Para ligar passos entre si, arraste da saída por baixo de um passo para outro passo. Aplica-se o seguinte:

- Cada saída leva a um passo. Se voltar a ligar uma saída, a nova linha substitui a antiga
- Uma linha que criaria um círculo é recusada. Se mesmo assim existir um ciclo, não pode ativar a automação. Uma execução pára assim que fosse repetir um passo
- Um passo sem linha de entrada nunca é executado. O Tillor assinala isto como problema (**Não está ligado, por isso este passo nunca é executado.**)
- Pode ajustar, duplicar e adicionar mais acionadores a partir da lista à esquerda. Não pode eliminar o último acionador. Um acionador não pertence a uma linha: inicia uma execução própria

Dê a um passo um nome próprio no campo **Nome do passo**. Isso ajuda quando o fluxo crescer. Com os botões **Duplicar passo** e **Eliminar passo** no topo do painel, copia ou elimina o passo selecionado.

### Comentários e molduras [#opmerkingen-en-kaders]

Com um comentário explica na tela o que faz uma parte do fluxo, por exemplo porque existe uma condição. Uma **Moldura** é uma linha tracejada com um nome que coloca à volta de um grupo de passos.

- No grupo **Utilitários**, clique em **Comentário** ou **Moldura** e escreva o seu texto
- Arraste o comentário ou a moldura para os passos que explicam. Selecione-os para os aumentar ou diminuir com os cantos
- Elimine um comentário com **Eliminar comentário** ou uma moldura com **Eliminar moldura**, ou selecione-os e prima Delete
- Os comentários e as molduras nunca são executados e não contam para os problemas. Pode colocar no máximo 50 entre os dois. São guardados com **Guardar**, tal como os passos, e Ctrl/Cmd + Z desfaz uma alteração

### Versões anteriores [#eerdere-versies]

De cada vez que guarda uma alteração, o Tillor conserva a versão anterior. No separador **Histórico** vê as versões com o que mudou, por exemplo **1 passo adicionado** ou **Disposição ou ligações alteradas**, e por quem ou o quê veio a alteração (por exemplo **Através da API**). Com **Restaurar** coloca uma versão na tela. Isso conta como alteração não guardada: guarde para manter a versão, ou desfaça.

### Atalhos de teclado [#sneltoetsen]

| Tecla | O que faz |
|---|---|
| Ctrl/Cmd + S | Guardar |
| Ctrl/Cmd + Z | Desfazer |
| Ctrl/Cmd + Shift + Z ou Ctrl/Cmd + Y | Refazer |
| Ctrl/Cmd + C, Ctrl/Cmd + V | Copiar e colar os passos selecionados |
| Ctrl/Cmd + D | Duplicar os passos selecionados |
| Ctrl/Cmd + A | Selecionar tudo |
| Delete ou Backspace | Eliminar os passos ou linhas selecionados |
| Esc | Anular a seleção |

## Guardar e ativar [#opslaan-en-inschakelen]

O Tillor não guarda automaticamente. Clique em **Guardar** (ou prima Ctrl/Cmd + S) para conservar as suas alterações. O botão fica ativo assim que algo foi alterado e o nome não está vazio.

<Callout type="warn">
Se a automação estiver ligada, só pode guardar quando já não houver problemas. Um fluxo em execução tem de se manter sempre válido. Resolva os problemas ou ponha primeiro a automação em pausa.
</Callout>

Com o interruptor **Ativo** liga a automação. Isso também guarda logo o fluxo. O interruptor não funciona enquanto houver problemas, com a explicação **Corrija primeiro os problemas em aberto**. Depois, a automação arranca a cada evento correspondente. Pode demorar meio minuto até uma alteração produzir efeito em todo o lado.

Se mais tarde alterar um fluxo ligado, essas alterações aplicam-se apenas a novas execuções. As execuções que já estão em curso ou à espera num atraso terminam com o fluxo tal como era quando arrancaram.

## A sua primeira automação: uma tarefa após a partida [#je-eerste-automatisering-een-taak-na-vertrek]

Este exemplo cria uma tarefa quando uma ocupação termina.

1. Clique em **Nova automação** e escolha **Verificar a parcela após a partida**
2. Clique no acionador. Em **Evento** aparece `occupation:ended`
3. Clique no passo **Criar tarefa**. Ajuste o **Título**, a **Descrição** e a **Prioridade**, ou escolha em **Adicionar ao quadro** um quadro e uma **Coluna**
4. Abra o separador **Execução de teste** e clique em **Executar teste**. Vê que passos o fluxo percorreria
5. Clique em **Guardar** e ligue **Ativo**
6. Termine uma ocupação e veja no separador **Execuções** o que aconteceu

## Pedir um passo ou evento [#een-stap-of-gebeurtenis-aanvragen]

Sente falta de um acionador, condição ou ação? Clique em **Pedir um passo** por baixo da lista de passos. Na lista de eventos do acionador também há uma ligação **Falta um evento? Peça-o**.

1. Em **De que precisa?** escolha entre **Um acionador ou evento**, **Uma condição ou filtro**, **Uma ação** ou **Outra coisa**
2. Em **O que deve fazer?** descreva o que quer automatizar. Escreva pelo menos 10 carateres, no máximo 1000
3. Clique em **Enviar pedido**

O seu pedido vai para a equipa do Tillor, juntamente com o seu nome e o nome da sua organização. Recebe uma notificação de que o pedido foi enviado.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- Uma nova automação fica em pausa. Não acontece nada até ligar **Ativo**.
- Depois de ligada, a automação arranca a cada evento correspondente. Pode demorar meio minuto até uma alteração produzir efeito em todo o lado.
- Cada arranque é uma execução. Vê-as no separador **Execuções**, com o estado **Concluída**, **A aguardar**, **Falhou** ou **Cancelada**.
- Se uma execução falhar, quem criou a automação recebe um e-mail, no máximo um por hora por automação.
- Se alterar um fluxo em execução, as alterações aplicam-se apenas a novas execuções. O que já está em curso ou à espera termina com o fluxo antigo.
- As tarefas e os comentários que a automação cria ficam em nome de **Fluxo de trabalho**. Veja [Quem executa uma automação?](/automatiseringen/workflow-gebruiker).

## Problemas? [#problemen]

<Accordions>
<Accordion title="O interruptor Ativo não funciona">
O Tillor mostra **Corrija primeiro os problemas em aberto**. No topo do painel, clique no botão com o número de problemas e resolva-os. Veja [Problemas e ativação](/automatiseringen/problemen).
</Accordion>
<Accordion title="Não consigo guardar">
O botão **Guardar** só fica ativo quando algo foi alterado e o nome não está vazio. Se a automação estiver ligada, só pode guardar sem problemas. Resolva-os ou ponha primeiro em pausa.
</Accordion>
<Accordion title="O meu passo nunca é executado">
O Tillor indica **Não está ligado, por isso este passo nunca é executado.** Arraste da saída de um passo anterior para este passo.
</Accordion>
<Accordion title="Não consigo ligar uma linha">
Uma linha que criaria um círculo é recusada. Um fluxo só pode avançar.
</Accordion>
<Accordion title="Não vejo Automações no menu">
O menu só aparece se tiver a permissão **Ver automatizações**. Criar e alterar exige **Gerir automatizações**. Peça a um administrador que ajuste as suas permissões.
</Accordion>
<Accordion title="O fluxo não reage à minha ação">
Percorra os pontos de [Porque é que a minha automação não arranca?](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet).
</Accordion>
</Accordions>

## Próximos passos [#volgende-stappen]

<Cards>
  <Card
    title="Acionadores"
    href="/automatiseringen/triggers"
    description="Escolha quando uma automação arranca"
  />
  <Card
    title="Ações"
    href="/automatiseringen/acties"
    description="Tudo o que uma automação pode fazer"
  />
  <Card
    title="Exemplo: verificar a caravana de aluguer"
    href="/automatiseringen/voorbeeld-nalopen"
    description="Um fluxo completo com uma pesquisa, um desvio e subtarefas"
  />
</Cards>


# Documentos (/pt-PT/automatiseringen/acties/documenten)

Com estas ações trabalha com os documentos de um cliente, como um comprovativo de pagamento do seguro. O tipo e a data de validade de um documento estão nos dados do documento. Num fluxo, lê-os como `{document.userMetadata.documentType}` e `{document.userMetadata.insuranceExpiryDate}`.

## Encontrar documento [#document-zoeken]

Procura o documento mais recente de um cliente. O passo tem duas saídas: **Encontrada** e **Não encontrada**.

| Campo | O que preenche |
|---|---|
| **Cliente** | O id do cliente, por exemplo `{document.customerId}` ou `{customer.id}`. Obrigatório |
| **Tipo** | Por exemplo **Comprovativo de pagamento do seguro**. Deixe vazio para qualquer tipo |
| **Ignorar documentos arquivados** | Ligado por defeito |
| **Apenas documentos que não expiraram** | A data de validade tem de ser posterior a agora. Os documentos sem data de validade não contam. Desligado por defeito |

Se vários documentos corresponderem, o passo escolhe o mais recente. Através de **Encontrada**, os passos seguintes podem usar `{foundDocument.id}`, `{foundDocument.name}`, `{foundDocument.status}`, `{foundDocument.userMetadata.documentType}` e `{foundDocument.userMetadata.insuranceExpiryDate}`.

Assim, por exemplo, quando um seguro caduca, verifica se o cliente já tem um novo comprovativo de pagamento válido: procure com **Tipo** *Comprovativo de pagamento do seguro* e **Apenas documentos que não expiraram** ligado, e continue apenas por **Não encontrada**.

## Atualizar documento [#document-bijwerken]

Altera o tipo de um documento, ou arquiva-o ou restaura-o. Os campos vazios ficam como estão.

| Campo | O que preenche |
|---|---|
| **Documento** | O id do documento. Por defeito `{document.id}`. Obrigatório |
| **Novo tipo** | Deixe vazio para manter o tipo |
| **Estado** | **Ativo** ou **Arquivado**. Deixe vazio para manter o estado |

Um tipo que exige data de validade, como **Comprovativo de pagamento do seguro**, falha se o documento não tiver data de validade. A ação devolve `{updatedDocument.id}`.


# Faturas e pagamentos (/pt-PT/automatiseringen/acties/facturen-en-betalingen)

Estes passos estão no grupo **Faturas e pagamentos**. Como funcionam as saídas, leia em [Saídas de uma ação](/automatiseringen/acties#uitgangen-van-een-actie).

## Enviar lembrete de pagamento [#betalingsherinnering-versturen]

Envia ao cliente o lembrete de pagamento de uma fatura, tal como o botão de lembrete na fatura.

| Campo | O que preenche |
|---|---|
| **Fatura** | O id da fatura. Por defeito `{invoice.id}`. Obrigatório |

Tenha em atenção que o campo espera o id interno da fatura (`{invoice.id}`) e não o número da fatura (`{invoice.displayId}`).

O passo falha se:

- a fatura não estiver lançada
- já não houver nada em aberto, ou seja, a fatura já estiver paga
- o cliente não tiver e-mail, telefone e morada postal completa

A execução fica então com o estado **Falhou** e o resto do fluxo não é executado. Por isso, coloque antes do lembrete um **Se / senão** que verifique se a fatura ainda está em aberto, como no modelo **Acompanhar faturas por pagar**.

O passo também ignora uma fatura que tenha sido retirada dos lembretes automáticos, ou se o cliente tiver **Excluir dos lembretes automáticos** ligado.

## Sincronizar transações bancárias [#banktransacties-synchroniseren]

Obtém novas transações bancárias e espera até a importação terminar. Coloque este passo antes de **Enviar lembrete de pagamento**, para que uma fatura acabada de pagar não receba lembrete. Se o Ponto não estiver ligado, o passo é ignorado.

Guarde a automação a partir da rede do escritório. O Tillor memoriza então o IP de que a ligação bancária precisa. Sem esse IP, a sincronização não pode arrancar.

## Desativar lembretes automáticos para o cliente [#automatische-herinneringen-uitschakelen-voor-klant]

Liga **Excluir dos lembretes automáticos** nas definições de faturação do cliente. Os fluxos de lembrete passam a ignorar todas as faturas desse cliente. Continua a ser possível um lembrete manual.

| Campo | O que preenche |
|---|---|
| **Cliente** | O id do cliente. Obrigatório |

## Desativar lembretes automáticos para a fatura [#automatische-herinneringen-uitschakelen-voor-factuur]

Retira uma fatura dos fluxos de lembrete de atraso e dos lembretes automáticos. Os colaboradores podem continuar a enviar um lembrete manualmente.

| Campo | O que preenche |
|---|---|
| **Fatura** | O id da fatura. Obrigatório |

## Enviar fatura [#factuur-versturen]

Envia uma fatura ao cliente, da mesma forma que o botão de envio na fatura.

| Campo | O que preenche |
|---|---|
| **Fatura** | O id da fatura. Por defeito `{invoice.id}`. Obrigatório |

O passo falha se a fatura não estiver lançada ou se o cliente não tiver e-mail, telefone e morada postal completa.

## Lançar fatura [#factuur-boeken]

Lança uma fatura rascunho, para que receba o seu número de fatura.

| Campo | O que preenche |
|---|---|
| **Fatura** | O id da fatura. Por defeito `{invoice.id}`. Obrigatório |

Se a fatura já estiver lançada, não acontece nada e o fluxo continua por **Ignorado**. Depois de lançar, a ação devolve `{bookedInvoice.displayId}`, o número da fatura. Pode usá-lo numa mensagem ou tarefa. Combine o passo com **Enviar fatura** para lançar e enviar uma fatura rascunho de uma só vez.

## Imprimir fatura [#factuur-afdrukken]

Imprime uma fatura ou mostra-a no tablet da receção.

| Campo | O que preenche |
|---|---|
| **Fatura** | O id da fatura. Por defeito `{invoice.id}`. Obrigatório |
| **Onde** | **Impressora A4** (por defeito), **Impressora de talões** ou **Tablet da receção** |

As impressoras configura-as em [Definições de impressão](/printer/afdrukinstellingen). Uma fatura que imprima uma segunda vez com este passo é simplesmente impressa de novo.

## Criar link de pagamento [#betaallink-aanmaken]

Cria um link de pagamento online para o valor ainda em aberto numa fatura.

| Campo | O que preenche |
|---|---|
| **Fatura** | O id da fatura. Por defeito `{invoice.id}`. Obrigatório |
| **Método de pagamento** | **Deixar o cliente escolher** (por defeito), **Bancontact**, **iDEAL**, **Cartão de crédito** ou **Payconiq** |

O link só existe para uma fatura lançada com algum valor ainda em aberto. Se a fatura não estiver lançada ou já estiver paga, o fluxo continua por **Ignorado**. Depois, a ação devolve `{paymentLink.url}`. Coloque-o num texto, por exemplo numa mensagem através de [Enviar mensagem a um hóspede](/automatiseringen/acties/gasten-en-berichten#gast-een-bericht-sturen).

## Pedir mandato SEPA [#sepa-mandaat-aanvragen]

Envia a um cliente, por e-mail, um pedido para assinar um mandato SEPA, ou um lembrete de um pedido que ainda está em aberto. Veja [Mandato](/betalingsverwerking/mandaat) para o mandato em si.

| Campo | O que preenche |
|---|---|
| **Cliente** | O id do cliente. Por defeito `{customer.id}`. Obrigatório |
| **Enviar** | **Um novo pedido** (por defeito) ou **Um lembrete** |

Um novo pedido é ignorado se já houver um em aberto. Um lembrete é ignorado se não houver pedido em aberto, ou se o pedido tiver expirado. Em ambos os casos, o fluxo continua por **Ignorado**.

## Cobrar por débito direto [#innen-via-domiciliëring]

Cobra o que ainda está em aberto numa fatura com o mandato SEPA ativo do cliente.

| Campo | O que preenche |
|---|---|
| **Fatura** | O id da fatura. Por defeito `{invoice.id}`. Obrigatório |
| **Após dias** | Quantos dias o Tillor espera antes de cobrar. Com 0 cobra de imediato. O máximo é 7 dias, um número superior passa a 7. Por defeito 0 |

O passo cobra todo o valor em aberto. Se a fatura não estiver lançada ou já estiver paga, ou se o cliente não tiver mandato ativo, não acontece nada e o fluxo continua por **Ignorado**. Se o cliente tiver mais do que um mandato ativo, o passo usa o mais recente.

## Faturar consumo [#verbruik-factureren]

Fatura o consumo de contador em aberto de um cliente, lança a fatura e envia-a.

| Campo | O que preenche |
|---|---|
| **Cliente** | O id do cliente. Por defeito `{occupation.customerId}`. Obrigatório |
| **Enviar por e-mail** | Ligado por defeito |
| **Enviar por SMS** | Desligado por defeito |

Se não houver nada em aberto para faturar, não é criada fatura e o fluxo continua por **Ignorado**. Caso contrário, a ação devolve `{consumptionInvoice.id}`. Veja [Gestão de contadores](/meterbeheer) para saber como o consumo é registado.

## Rascunho de fatura de prolongamento [#conceptfactuur-voor-verlenging]

Cria um rascunho de fatura que prolonga uma ocupação, pronto a verificar. A fatura ainda não está lançada. É o mesmo tipo de fatura que obtém com **Prorrogar ocupação (fatura)** no perfil do cliente.

| Campo | O que preenche |
|---|---|
| **Ocupação** | O id da ocupação. Por defeito `{occupation.id}`. Obrigatório |
| **Adicionar consumo em aberto** | Coloca o consumo de contador em aberto do cliente na mesma fatura. Desligado por defeito |

A ação devolve `{extendInvoice.id}`. Se quiser lançar e enviar logo a fatura, use depois **Lançar fatura** e **Enviar fatura** com `{extendInvoice.id}` como fatura.


# Hóspedes e mensagens (/pt-PT/automatiseringen/acties/gasten-en-berichten)

Estes passos estão no grupo **Hóspedes e mensagens**. Como funcionam as saídas, leia em [Saídas de uma ação](/automatiseringen/acties#uitgangen-van-een-actie).

## Enviar mensagem a um hóspede [#gast-een-bericht-sturen]

Envia o seu próprio texto a um cliente por e-mail, SMS ou WhatsApp. Use-o para mensagens que não têm um modelo fixo do Tillor, como uma mensagem de boas-vindas no dia de chegada.

| Campo | O que preenche |
|---|---|
| **Cliente** | O id do cliente, por exemplo `{reservation.customerId}`. Obrigatório |
| **Assunto** | Apenas para e-mail. Vazio usa o nome da sua organização |
| **Mensagem** | O texto, sem formatação. As variáveis são preenchidas. Obrigatório |
| **Enviar por e-mail** | Ligado por defeito |
| **Enviar por SMS** | Desligado por defeito |
| **Enviar por WhatsApp** | Desligado por defeito |

Tenha em conta:

- Os clientes que não aceitam comunicações não recebem nada. O fluxo continua então por **Ignorado**
- Fora da janela de 24 horas do WhatsApp, o Tillor envia o seu texto como modelo aprovado. Dentro dessa janela, segue como mensagem normal
- Se o cliente não existir, o passo falha

## Notificar colegas [#collegas-verwittigen]

Envia aos colegas uma notificação push, um e-mail ou ambos.

| Campo | O que preenche |
|---|---|
| **Colegas** | Escolha um ou mais colegas |
| **Notificar também quem causou o evento** | Notifica também o colega que causou o evento. Se o sistema causou o evento, ninguém é acrescentado |
| **Título** | O título da notificação. Obrigatório |
| **Texto** | O conteúdo da notificação |
| **Enviar como notificação push** | Ligado por defeito |
| **Enviar por e-mail** | Desligado por defeito |

O utilizador **Fluxo de trabalho** nunca recebe uma notificação. Se não houver colegas a notificar, o passo não faz nada e o fluxo continua normalmente.

## Adicionar um comentário [#opmerking-toevoegen]

Coloca uma [nota](/notities), em nome de **Fluxo de trabalho**.

| Campo | O que preenche |
|---|---|
| **Comentário** | O texto do comentário. Obrigatório |
| **Em** | **Os registos do evento** (por defeito) ou **Uma tarefa** |
| **Tarefa** | Apenas com **Uma tarefa**: o id da tarefa, por exemplo `{createdTask.id}`. Obrigatório |

Tenha em conta:

- Mencione um colega com `@{triggeredBy.name}({triggeredBy.id})`. Esse colega recebe então uma notificação, tal como num comentário que escreva você mesmo. Isto só funciona se um colega tiver causado o evento
- Com **Os registos do evento**, o comentário fica no cliente, na fatura, na reserva, no pagamento, no terreno, no contador e na tarefa a que o evento diz respeito. Se o evento não tiver nenhum desses registos, o passo falha
- A ação devolve `{createdComment.id}`

## Responder na caixa de entrada [#antwoorden-in-de-inbox]

Envia uma resposta numa conversa da caixa de entrada, pelo mesmo canal por que o hóspede escreveu.

| Campo | O que preenche |
|---|---|
| **Conversa** | O id da conversa. Por defeito `{threadId}`. Obrigatório |
| **Resposta** | O texto, sem formatação. As variáveis são preenchidas. Mais de 4096 carateres é truncado. Obrigatório |
| **Manter o assistente de IA ativo** | Desligado por defeito |

Tenha em conta:

- `{threadId}` existe em eventos sobre mensagens da caixa de entrada, como `inbox:message-created`
- Esse evento aplica-se a cada nova mensagem, também à sua própria resposta. Por isso, verifique primeiro se a mensagem veio do hóspede, caso contrário a sua resposta volta a arrancar o fluxo. Coloque antes deste passo um [Procurar um registo](/automatiseringen/logica#record-opzoeken) em **Mensagem da caixa de entrada** com `{messageId}` e um **Se / senão** que verifique se `foundInboxMessage.direction` é igual a `INBOUND`
- Por defeito, a sua resposta silencia o [assistente de IA](/inbox/inbox-ai-assistant) nessa conversa, tal como quando um colega responde pessoalmente. Com **Manter o assistente de IA ativo**, o assistente continua a conversar. Se a conversa estiver então arquivada, o passo falha

## Etiquetar ou arquivar conversa [#gesprek-taggen-of-archiveren]

Dá etiquetas a uma conversa da caixa de entrada, arquiva-a, ou ambos.

| Campo | O que preenche |
|---|---|
| **Conversa** | O id da conversa. Por defeito `{threadId}`. Obrigatório |
| **Adicionar etiquetas** | Escolha uma ou mais etiquetas. São acrescentadas, as etiquetas existentes mantêm-se |
| **Arquivar a conversa** | Desligado por defeito |

## Atualizar cliente [#klant-bijwerken]

Altera o estado de um cliente ou adiciona uma nota. Os outros dados do cliente ficam inalterados.

| Campo | O que preenche |
|---|---|
| **Cliente** | O id do cliente, por exemplo `{invoice.customerId}`. Obrigatório |
| **Estado** | **Manter como está** (por defeito), **Predefinição**, **Preferido**, **VIP**, **Aviso** ou **Bloqueado** |
| **Adicionar às notas** | Texto que fica numa nova linha por baixo das notas existentes. Vazio não acrescenta nada |

## Check-in, check-out ou cancelar [#inchecken-uitchecken-of-annuleren]

Põe uma reserva no seu estado seguinte.

| Campo | O que preenche |
|---|---|
| **Reserva** | O id da reserva. Por defeito `{reservation.id}`. Obrigatório |
| **Ação** | **Fazer check-in** (por defeito), **Fazer check-out** ou **Cancelar** |

Para isso, a reserva tem de estar no estado certo. **Fazer check-in** e **Cancelar** funcionam numa reserva com o estado **Reservada**, **Fazer check-out** numa reserva com o estado **Check-in feito**. Se estiver noutro estado, não acontece nada e o fluxo continua por **Ignorado**.


# Visão geral (/pt-PT/automatiseringen/acties)

As ações são os passos que realmente fazem algo. Encontra-as na lista de passos, nos grupos **Tarefas**, **Documentos**, **Hóspedes e mensagens**, **Faturas e pagamentos**, **Acesso e dispositivos** e **Integrações**. Os passos do grupo **Lógica** controlam o próprio fluxo. Esses estão em [Condições, desvios e atrasos](/automatiseringen/logica). Todas as ações são executadas pelo [utilizador **Fluxo de trabalho**](/automatiseringen/workflow-gebruiker) da sua organização.

| Grupo | Ação | O que faz |
|---|---|---|
| Tarefas | [Criar tarefa](/automatiseringen/acties/taken#taak-aanmaken) | Cria uma tarefa, eventualmente com subtarefas, num quadro e associada a cliente, terreno ou fatura |
| Tarefas | [Definir estado](/automatiseringen/acties/taken#taakstatus-zetten) | Altera o estado de uma tarefa existente |
| Tarefas | [Procurar tarefa](/automatiseringen/acties/taken#taak-zoeken) | Procura uma tarefa pelo título e continua por **Encontrada** ou **Não encontrada** |
| Tarefas | [Definir prioridade da tarefa](/automatiseringen/acties/taken#taakprioriteit-zetten) | Aumenta, diminui ou escolhe a prioridade de uma tarefa existente |
| Tarefas | [Atualizar tarefa](/automatiseringen/acties/taken#taak-bijwerken) | Muda o nome de uma tarefa, adiciona pessoas ou etiquetas ou adia o prazo |
| Tarefas | [Eliminar tarefa](/automatiseringen/acties/taken#taak-verwijderen) | Elimina uma tarefa, por exemplo a tarefa que este fluxo criou |
| Documentos | [Encontrar documento](/automatiseringen/acties/documenten#document-zoeken) | Procura o documento mais recente de um cliente e continua por **Encontrada** ou **Não encontrada** |
| Documentos | [Atualizar documento](/automatiseringen/acties/documenten#document-bijwerken) | Altera o tipo de um documento, ou arquiva-o ou restaura-o |
| Hóspedes e mensagens | [Enviar mensagem a um hóspede](/automatiseringen/acties/gasten-en-berichten#gast-een-bericht-sturen) | Envia um texto próprio a um cliente por e-mail, SMS ou WhatsApp |
| Hóspedes e mensagens | [Notificar colegas](/automatiseringen/acties/gasten-en-berichten#collegas-verwittigen) | Envia aos colegas uma notificação push ou um e-mail |
| Hóspedes e mensagens | [Adicionar um comentário](/automatiseringen/acties/gasten-en-berichten#opmerking-toevoegen) | Coloca um comentário nos registos do evento ou numa tarefa |
| Hóspedes e mensagens | [Responder na caixa de entrada](/automatiseringen/acties/gasten-en-berichten#antwoorden-in-de-inbox) | Envia uma resposta numa conversa da caixa de entrada |
| Hóspedes e mensagens | [Etiquetar ou arquivar conversa](/automatiseringen/acties/gasten-en-berichten#gesprek-taggen-of-archiveren) | Adiciona etiquetas a uma conversa da caixa de entrada ou arquiva-a |
| Hóspedes e mensagens | [Atualizar cliente](/automatiseringen/acties/gasten-en-berichten#klant-bijwerken) | Altera o estado de um cliente ou adiciona uma nota |
| Hóspedes e mensagens | [Check-in, check-out ou cancelar](/automatiseringen/acties/gasten-en-berichten#inchecken-uitchecken-of-annuleren) | Põe uma reserva no seu estado seguinte |
| Faturas e pagamentos | [Enviar lembrete de pagamento](/automatiseringen/acties/facturen-en-betalingen#betalingsherinnering-versturen) | Envia ao cliente o lembrete de pagamento de uma fatura |
| Faturas e pagamentos | [Sincronizar transações bancárias](/automatiseringen/acties/facturen-en-betalingen#banktransacties-synchroniseren) | Obtém novas transações bancárias antes de o fluxo continuar |
| Faturas e pagamentos | [Desativar lembretes automáticos para o cliente](/automatiseringen/acties/facturen-en-betalingen#automatische-herinneringen-uitschakelen-voor-klant) | Ignora todas as faturas de um cliente nos lembretes automáticos |
| Faturas e pagamentos | [Desativar lembretes automáticos para a fatura](/automatiseringen/acties/facturen-en-betalingen#automatische-herinneringen-uitschakelen-voor-factuur) | Retira uma fatura dos fluxos de lembrete automático |
| Faturas e pagamentos | [Enviar fatura](/automatiseringen/acties/facturen-en-betalingen#factuur-versturen) | Envia uma fatura ao cliente |
| Faturas e pagamentos | [Lançar fatura](/automatiseringen/acties/facturen-en-betalingen#factuur-boeken) | Lança uma fatura rascunho |
| Faturas e pagamentos | [Imprimir fatura](/automatiseringen/acties/facturen-en-betalingen#factuur-afdrukken) | Imprime uma fatura ou mostra-a num tablet |
| Faturas e pagamentos | [Criar link de pagamento](/automatiseringen/acties/facturen-en-betalingen#betaallink-aanmaken) | Cria um link de pagamento online para o que ainda está em aberto |
| Faturas e pagamentos | [Pedir mandato SEPA](/automatiseringen/acties/facturen-en-betalingen#sepa-mandaat-aanvragen) | Pede a um cliente que assine um mandato, ou envia um lembrete |
| Faturas e pagamentos | [Cobrar por débito direto](/automatiseringen/acties/facturen-en-betalingen#innen-via-domiciliëring) | Cobra o que está em aberto com o mandato ativo do cliente |
| Faturas e pagamentos | [Faturar consumo](/automatiseringen/acties/facturen-en-betalingen#verbruik-factureren) | Fatura o consumo de contador em aberto de um cliente |
| Faturas e pagamentos | [Rascunho de fatura de prolongamento](/automatiseringen/acties/facturen-en-betalingen#conceptfactuur-voor-verlenging) | Cria um rascunho de fatura que prolonga uma ocupação |
| Acesso e dispositivos | [Criar método de acesso](/automatiseringen/acties/toegang-en-toestellen#toegangsmiddel-aanmaken) | Dá acesso a um cliente por código QR, matrícula, PIN ou NFC |
| Acesso e dispositivos | [Atualizar acesso](/automatiseringen/acties/toegang-en-toestellen#toegang-bijwerken) | Bloqueia, desbloqueia ou prolonga meios de acesso |
| Acesso e dispositivos | [Enviar ou imprimir código QR](/automatiseringen/acties/toegang-en-toestellen#qr-code-versturen-of-afdrukken) | Envia um código de acesso QR ao cliente ou imprime-o |
| Acesso e dispositivos | [Abrir ou fechar cancela](/automatiseringen/acties/toegang-en-toestellen#slagboom-openen-of-sluiten) | Abre ou fecha uma cancela ou portão |
| Acesso e dispositivos | [Ligar ou desligar energia](/automatiseringen/acties/toegang-en-toestellen#stroom-schakelen) | Liga ou desliga a eletricidade de um contador inteligente |
| Acesso e dispositivos | [Atualizar etiquetas NFC](/automatiseringen/acties/toegang-en-toestellen#nfc-tags-bijwerken) | Bloqueia, desbloqueia ou recarrega etiquetas NFC de um cliente |
| Acesso e dispositivos | [Controlar tablet ou quiosque](/automatiseringen/acties/toegang-en-toestellen#tablet-of-kiosk-bedienen) | Acorda um tablet ou quiosque, põe-no em modo de suspensão ou recarrega-o |
| Acesso e dispositivos | [Definir apresentação](/automatiseringen/acties/toegang-en-toestellen#diavoorstelling-instellen) | Coloca fotografias em tablets e quiosques, a partir de uma lista ou de um pedido anterior |
| Integrações | [Enviar webhook](/automatiseringen/acties/integraties#webhook-versturen) | Entrega uma mensagem própria a um dos seus endpoints de webhook |
| Integrações | [Pedido à API](/automatiseringen/acties/integraties#api-verzoek) | Chama a Tillor API ou outro site |

Em todos os campos de texto pode usar [variáveis](/automatiseringen/variabelen), como `{invoice.displayId}`. No canto superior direito de cada campo há um botão **Variável** para inserir uma. Os campos onde é pedido um cliente, fatura ou outro registo esperam o id interno desse registo, como `{invoice.id}`. Um número de fatura ou um nome não funciona.

## Saídas de uma ação [#uitgangen-van-een-actie]

Por baixo de um passo há uma ou mais saídas. Liga cada saída a um passo seguinte. Se deixar uma saída por ligar, a execução termina aí.

| Saída | Em que ações | Quando |
|---|---|---|
| **Seguinte** | A maioria das ações | O passo teve êxito |
| **Concluído** e **Ignorado** | Ações que por vezes não têm nada a fazer | **Concluído** se o passo fez o seu trabalho. **Ignorado** se não havia nada a fazer, por exemplo porque a fatura já estava lançada. Isso não é um erro |
| **Encontrada** e **Não encontrada** | **Procurar tarefa** | Se a tarefa existe |
| **Encontrada** e **Não encontrada** | **Encontrar documento** | Se o cliente tem um documento desses |
| **Sucesso** e **Falhou** | **Enviar webhook** e **Pedido à API** | Se o outro lado aceitou a mensagem |

**Concluído** e **Ignorado** existem em **Enviar mensagem a um hóspede**, **Check-in, check-out ou cancelar**, **Lançar fatura**, **Criar link de pagamento**, **Pedir mandato SEPA**, **Cobrar por débito direto** e **Faturar consumo**. Em cada uma delas, por baixo da ação indica-se quando um passo é ignorado.

### Continuar quando este passo falha [#doorgaan-als-deze-stap-mislukt]

Se uma ação correr mal, a execução pára normalmente com o estado **Falhou**. Se quiser decidir você o que acontece nesse caso, ligue no fim das definições do passo **Continuar quando este passo falha**. Isso é possível em qualquer ação exceto **Enviar webhook** e **Pedido à API**, que já têm uma saída própria **Falhou**.

O passo passa então a ter uma saída extra **Erro**. Se a ação falhar, o fluxo continua por **Erro** em vez de parar. Os passos seguintes podem usar estas variáveis:

| Variável | Conteúdo |
|---|---|
| `{error.message}` | A mensagem de erro. Pode estar em inglês |
| `{error.step}` | O nome do passo que falhou, tal como o preencheu em **Nome do passo** |

Algumas coisas a saber:

- Se a ação teve êxito ou foi ignorada, nada muda e **Erro** não é usado
- Se deixar **Erro** por ligar, a execução termina aí sem mais passos. A execução fica então com o estado **Concluída**, mas o próprio passo aparece no separador **Execuções** com a sua mensagem de erro
- Um segundo passo falhado no mesmo fluxo substitui `{error.message}` e `{error.step}` do primeiro

Um exemplo: deixe **Enviar mensagem a um hóspede** continuar se falhar e crie por **Erro** uma tarefa com `{error.message}` na descrição. Assim, um colega trata ele próprio da conversa com o hóspede.

## Quando um passo falha [#als-een-stap-mislukt]

Há três formas de uma falha decorrer.

- **Uma saída Falhou.** Acontece em **Enviar webhook** e **Pedido à API** quando o outro lado devolve um erro. O fluxo continua pela saída **Falhou**. Ligue-a a um seguimento, como uma tarefa para um colega. Se deixar a saída por ligar, a execução simplesmente termina aí
- **Uma saída Erro.** Se ligar **Continuar quando este passo falha** noutra ação, o passo passa a ter uma saída **Erro** e pode usar `{error.message}` para saber o motivo. Veja [Continuar quando este passo falha](#doorgaan-als-deze-stap-mislukt)
- **O passo pára a execução.** Se faltar um valor depois de as variáveis serem preenchidas, se uma fatura não puder ser enviada, se um endpoint já não existir ou se o JSON for inválido, a execução fica com o estado **Falhou**. Os passos seguintes não são executados e o Tillor não repete o passo. Isto só acontece se não tiver ligado **Continuar quando este passo falha**

A mensagem de erro aparece no passo, no separador **Execuções**. Essas mensagens podem estar em inglês.

<Callout type="idea" title="Não perder falhas">
Quer que uma falha nunca passe despercebida? Ligue a saída **Falhou** de um **Pedido à API** ou **Enviar webhook**, ou a saída **Erro** de outra ação, a um passo [Criar tarefa](/automatiseringen/acties/taken#taak-aanmaken). Assim, um colega pode tratar do assunto.
</Callout>

## Grupos [#groepen]

<Cards>
  <Card title="Tarefas" href="/automatiseringen/acties/taken" description="Criar, procurar e atualizar tarefas" />
  <Card title="Hóspedes e mensagens" href="/automatiseringen/acties/gasten-en-berichten" description="Mensagens, comentários, caixa de entrada e reservas" />
  <Card title="Faturas e pagamentos" href="/automatiseringen/acties/facturen-en-betalingen" description="Lembretes, faturas e pagamentos" />
  <Card title="Acesso e dispositivos" href="/automatiseringen/acties/toegang-en-toestellen" description="Acesso, energia, NFC e tablets" />
  <Card title="Integrações" href="/automatiseringen/acties/integraties" description="Webhooks e pedidos à API" />
</Cards>


# Integrações (/pt-PT/automatiseringen/acties/integraties)

Estes passos estão no grupo **Integrações**. Uma entrega falhada continua por **Falhou**. Para as outras ações, leia [Quando um passo falha](/automatiseringen/acties#als-een-stap-mislukt).

## Enviar webhook [#webhook-versturen]

Entrega uma mensagem própria a um dos endpoints de webhook da sua organização. É útil para avisar outro sistema, por exemplo o seu sistema de caixa ou o seu site.

| Campo | O que preencher |
|---|---|
| **Endpoint** | Escolha um dos seus endpoints de webhook. Reconhece-os pelo endereço. Obrigatório |
| **Nome do evento** | O nome que segue na mensagem para o destinatário a poder reconhecer, por exemplo `automation.invoice_unpaid`. Obrigatório |
| **Payload** | O conteúdo da mensagem, em JSON. As variáveis são preenchidas antes de a mensagem ser enviada. Obrigatório |

Os endpoints são criados e geridos no menu do perfil, em **Programadores**. O endpoint tem de existir e estar ativado. Se não estiver, o passo falha e a execução termina.

A mensagem é assinada com a chave própria do endpoint, exatamente como os outros webhooks que o endpoint recebe. A Tillor tenta de novo algumas vezes se o seu servidor não responder bem. O endpoint não tem de seguir o nome do seu evento: a mensagem chega de qualquer forma.

O passo tem duas saídas:

| Saída | Quando |
|---|---|
| **Sucesso** | O seu servidor respondeu com um estado de sucesso |
| **Falhou** | A entrega falhou após todas as tentativas. Depois disso, a mensagem continua a ser tentada em segundo plano, tal como um webhook normal |

O modelo **Enviar reservas para outro sistema** usa **Falhou** para criar uma tarefa, de modo a que alguém a trate.

Um payload pode ter, por exemplo, este aspeto:

```json
{
  "reservation": "{reservation.displayId}",
  "checkIn": "{reservation.checkIn}",
  "adults": {reservation.numberOfAdults},
  "customer": {
    "firstName": "{reservation.customer.firstName}",
    "email": "{reservation.customer.email}"
  }
}
```

Ponha o texto entre aspas e os números sem aspas. As datas seguem em JSON como data e hora internacionais, por exemplo `2026-10-05T08:00:00.000Z`. Leia [Variáveis e modelos](/automatiseringen/variabelen#hoe-waarden-worden-ingevuld) para os detalhes. A parte técnica, como a estrutura da mensagem, está em [Programadores > Automações](/ontwikkelaars/automatiseringen).

## Pedido à API [#api-verzoek]

Chama a API da Tillor da sua própria organização, ou outro endereço na internet. Com isto pode fazer quase tudo o que a Tillor faz, e procurar dados para depois os usar.

Em **Enviar para** escolhe entre **Tillor API** e **URL personalizado**. Em **Método** escolhe **GET** (consultar), **POST** (criar), **PUT** ou **PATCH** (alterar) ou **DELETE** (eliminar).

### Tillor API [#tillor-api]

| Campo | O que preencher |
|---|---|
| **Caminho** | A parte do endereço a seguir à API da sua organização, por exemplo `/tasks` ou `/tasks/{task.id}`. Tem de começar por `/`. Obrigatório |
| **Corpo** | Os dados que envia, em JSON. Deixe vazio se não enviar nada |

No topo do campo está **Escolha um endpoint da API**. Clique aí e procure na lista, por exemplo *tasks*. Ao escolher um endpoint, a Tillor preenche o método e o caminho. Se o **Corpo** ainda estiver vazio, recebe também um exemplo do que o endpoint espera. Substitua os nomes entre chavetas no caminho por variáveis de passos anteriores. Se houver parâmetros de query, vê-os por baixo do campo.

A chamada é feita como o utilizador **Fluxo de trabalho** e nunca pode sair da sua própria organização. Uma automação não pode gerir automações, por isso as chamadas que afetem automações ou as suas execuções são recusadas.

### URL personalizado [#eigen-url]

| Campo | O que preencher |
|---|---|
| **URL** | O endereço. Tem de começar por `https://`. Obrigatório |
| **Cabeçalhos** | Dados adicionais para o destinatário, por exemplo uma chave. Clique em **Adicionar cabeçalho** e preencha o **Nome** e o **Valor** |
| **Corpo** | Os dados que envia, em JSON. Deixe vazio se não enviar nada |

Aplicam-se estas regras:

- Os endereços sem `https://` são recusados
- Os endereços privados e internos são recusados, mesmo que um nome normal aponte para eles
- Os redirecionamentos não são seguidos. Se o servidor responder com um redirecionamento, conta como **Falhou**
- Os cabeçalhos são guardados de forma encriptada. Pode, por isso, pôr lá uma chave ou um token
- Em **GET** e **DELETE** não é enviado corpo

### Saídas e resposta [#uitgangen-en-antwoord]

O pedido tem duas saídas: **Sucesso** (o servidor respondeu com um estado de sucesso) e **Falhou** (o servidor respondeu com um estado de erro). Se a Tillor não chegar sequer ao servidor, por exemplo por um tempo limite após 15 segundos ou um endereço recusado, a execução termina com o estado **Falhou**.

Para os passos seguintes existem três variáveis:

| Variável | Conteúdo |
|---|---|
| `{response.status}` | O código de estado, por exemplo 200 |
| `{response.body}` | A resposta como texto, cortada nos primeiros 4000 carateres |
| `{response.data}` | A resposta como dados, para poder extrair campos com `{response.data.items.0.id}` |

Como usar isto está em [Usar uma resposta da API](/automatiseringen/variabelen#een-api-antwoord-gebruiken). Um exemplo completo com uma pesquisa está em [Verificação de caravana de aluguer](/automatiseringen/voorbeeld-nalopen).


# Tarefas (/pt-PT/automatiseringen/acties/taken)

Com estes passos, uma automação cria e atualiza tarefas, para que um colega as trate. Estão no grupo **Tarefas**. Para saber como funcionam as saídas, leia [Saídas de uma ação](/automatiseringen/acties#uitgangen-van-een-actie).

## Como se relaciona isto? [#hoe-hangt-dit-samen]

Uma tarefa de uma automação é uma tarefa normal: encontra-a na página de tarefas, nas vistas onde se enquadra e no cliente ou registo a que está associada.

```mermaid
flowchart LR
  A["Stap Taak aanmaken"] --> T["Taak op de takenpagina<br/>op naam van Workflow"]
  T --> V["Weergaven tonen hem<br/>als hij past of in de lijst staat"]
  T --> C["Een collega pakt hem op"]
  C -- "Status of toewijzing wijzigt" --> E["Een andere automatisering kan daarop starten"]
  D["Stap Vraag om een beslissing"] --> T2["Taak met keuzeknoppen"]
  T2 -- "Een collega kiest een knop" --> F["De automatisering gaat verder via die optie"]
```

Mais sobre o que os colegas veem e fazem está em [Tarefas](/taken) e [Tarefas com botões de escolha](/taken/taakdetails#taken-met-keuzeknoppen).

## Criar tarefa [#taak-aanmaken]

Cria uma tarefa no sistema de tarefas. A tarefa fica em nome de **Fluxo de trabalho**.

<DocScreenshot src="/screenshots/taken/automation-task-create-step.png" alt="Automação com o passo Criar tarefa selecionado e as definições à direita" />


| Campo | O que preencher |
|---|---|
| **Título** | O nome da tarefa. Obrigatório |
| **Descrição** | Uma explicação da tarefa |
| **Atribuir a** | Escolha um ou mais colegas. Clique num nome para o ativar ou desativar |
| **Atribuir a grupos** | Escolha um ou mais [grupos](/gebruikers/groepen). A tarefa passa a valer para todos os que estiverem nesse grupo nesse momento |
| **Etiquetas** | Escolha uma ou mais [etiquetas](/taken/labels) |
| **Atribuir também a quem causou o evento** | Atribui a tarefa também ao colega que causou o evento, por exemplo quem terminou a ocupação. Se o sistema causou o evento, ninguém é adicionado |
| **Prioridade** | **Baixa**, **Média**, **Alta** ou **Urgente**. Por predefinição **Média** |
| **Adicionar ao quadro** | Escolha um quadro onde a tarefa vai ficar, ou deixe vazio |
| **Coluna** | Escolha uma coluna do quadro acima. A lista mostra as colunas como *[quadro] · [coluna]* |
| **Subtarefas** | Uma subtarefa por linha, ou exatamente uma variável com uma lista, como `{result}` de [Executar código](/automatiseringen/logica#code-uitvoeren) |
| **Vence após** | Quantos minutos, horas, dias ou semanas após a execução do passo cai o prazo. Com 0, a tarefa não tem prazo. Por predefinição 1 dia |
| **Associar a registos** | Associa a tarefa aos registos abaixo e ao respetivo cliente, parcela, fatura, reserva ou contador. Por predefinição ativado |
| **Associar a** | Aparece quando **Associar a registos** está ativado. Escolha em que registos a tarefa aparece. De início está marcado tudo o que o passo conhece: os registos do gatilho e o que um passo de pesquisa anterior encontrou |
| **Só o fluxo a pode concluir** | Os colegas não podem concluir nem eliminar a tarefa. Mais à frente, ponha um passo **Eliminar tarefa** ou **Definir estado** para a concluir |

Tenha em conta:

- Se não escolher ninguém em **Atribuir a** ou **Atribuir a grupos** e deixar **Atribuir também a quem causou o evento** desativado, a tarefa fica sem colega atribuído. **Fluxo de trabalho** nunca é atribuído a si próprio
- As subtarefas têm o mesmo título que preencher, nenhum colega atribuído e nenhum prazo. As linhas vazias são ignoradas. Pode usar variáveis nas linhas
- Em **Associar a** trata-se de clientes, parcelas, faturas, reservas e contadores. Numa ocupação que termina, a tarefa fica por predefinição associada à parcela, ao cliente e à reserva. Se retirar um registo da lista, a tarefa fica de fora desse registo. Os registos que mais tarde chegarem ao fluxo não são adicionados automaticamente pela Tillor depois de ter alterado a lista. Se escolher tudo outra vez, o passo volta a seguir todos os registos disponíveis
- Se uma tarefa estiver apenas num quadro pessoal, só os envolvidos a veem. Veja [Tarefas privadas](/taken/prive-taken)

Para os passos seguintes, a ação devolve `{createdTask.id}` e `{createdTask.name}`. Com isso pode, por exemplo, definir o estado depois.

Se não quiser uma segunda tarefa quando já existe uma tarefa aberta para a mesma parcela ou o mesmo cliente, ponha primeiro um passo [Procurar tarefa](#taak-zoeken) e crie a tarefa apenas através de **Não encontrada**. O [exemplo Verificação de caravana de aluguer](/automatiseringen/voorbeeld-nalopen) faz isso.

Se ativar **Só o fluxo a pode concluir**, a tarefa mostra **Concluída pela sua automação**. Os colegas não a podem concluir nem eliminar.

## Eliminar tarefa [#taak-verwijderen]

Elimina uma tarefa, por exemplo a que este fluxo criou, quando já não é necessária.

| Campo | O que preencher |
|---|---|
| **Tarefa** | O id da tarefa. Por predefinição `{createdTask.id}`. Obrigatório |

Uma tarefa que já não existe é ignorada. O fluxo continua normalmente.

## Definir estado [#taakstatus-zetten]

Altera o estado de uma tarefa existente, por exemplo para a concluir.

| Campo | O que preencher |
|---|---|
| **Tarefa** | O id da tarefa. Por predefinição `{task.id}`. Obrigatório |
| **Estado** | **Pendente**, **Em curso**, **A aguardar resposta** ou **Concluída**. Por predefinição **Concluída** |

`{task.id}` funciona quando a automação começa num evento de tarefa, como `task:created`. Depois de um passo **Criar tarefa**, use `{createdTask.id}`. A ação devolve `{updatedTask.id}` e `{updatedTask.status}`.

## Procurar tarefa [#taak-zoeken]

Procura uma tarefa existente pelo título. O passo tem duas saídas: **Encontrada** e **Não encontrada**. Assim pode atualizar uma tarefa se já existir e, caso contrário, criar uma nova.

| Campo | O que preencher |
|---|---|
| **Título** | O título que a tarefa tem de ter exatamente, por exemplo `Nalopen {occupation.terrain.name}`. As variáveis são preenchidas primeiro. Obrigatório |
| **Ligada aos registos do evento** | Apenas tarefas associadas a pelo menos um dos mesmos registos, como a parcela ou o cliente. Por predefinição ativado |
| **Apenas tarefas não concluídas** | Ignora as tarefas concluídas. Por predefinição ativado |
| **Ignorar subtarefas** | Procura apenas tarefas principais. Por predefinição ativado |

Se várias tarefas corresponderem, o passo escolhe a mais recente. Se **Ligada aos registos do evento** estiver ativado mas o evento não tiver cliente, parcela, fatura, reserva nem contador, o fluxo segue por **Não encontrada**.

Através de **Encontrada**, os passos seguintes podem usar `{foundTask.id}`, `{foundTask.name}`, `{foundTask.priority}` e `{foundTask.status}`.

## Definir prioridade da tarefa [#taakprioriteit-zetten]

Altera a prioridade de uma tarefa existente.

| Campo | O que preencher |
|---|---|
| **Tarefa** | O id da tarefa. Por predefinição `{foundTask.id}`. Obrigatório |
| **Alteração** | **Um nível acima** (predefinição), **Um nível abaixo** ou **Para uma prioridade fixa** |
| **Prioridade** | Apenas em **Para uma prioridade fixa**: **Baixa**, **Média**, **Alta** ou **Urgente** |
| **Aumentar até** | Apenas em **Um nível acima**: a prioridade mais alta que o passo pode dar. Por predefinição **Alta**. Uma tarefa que já esteja nessa prioridade ou acima fica como está |

A ordem é **Baixa**, **Média**, **Alta**, **Urgente**. Um nível abaixo pára em **Baixa**. Se nada mudar, o passo tem sucesso na mesma, sem alterar a tarefa. A ação devolve `{updatedTask.id}` e `{updatedTask.priority}`.

## Atualizar tarefa [#taak-bijwerken]

Altera uma tarefa existente. Os campos que deixar vazios ficam como estão.

| Campo | O que preencher |
|---|---|
| **Tarefa** | O id da tarefa. Por predefinição `{foundTask.id}`. Obrigatório |
| **Novo título** | O novo nome da tarefa. Vazio mantém o título como está |
| **Responsáveis** | Escolha um ou mais colegas |
| **Grupos** | Escolha um ou mais [grupos](/gebruikers/groepen) |
| **Atribuir também a quem causou o evento** | Adiciona também o colega que causou o evento. Se o sistema causou o evento, ninguém é adicionado |
| **Responsáveis** (modo) | **Adicionar aos atuais** (predefinição) ou **Substituir os atuais** |
| **Adicionar etiquetas** | Escolha uma ou mais [etiquetas](/taken/labels). Ficam acrescentadas, as etiquetas existentes mantêm-se |
| **Vence após** | Define o prazo para este número de minutos, horas, dias ou semanas após a execução do passo. Com 0, o prazo fica como está |

Tenha em conta:

- Se escolher **Substituir os atuais** e não indicar ninguém, a tarefa fica depois sem ninguém atribuído
- Se a tarefa já não existir, o passo falha
- A ação devolve `{updatedTask.id}`


# Acesso e dispositivos (/pt-PT/automatiseringen/acties/toegang-en-toestellen)

Estas ações afetam o próprio parque: quem pode entrar, que contadores têm energia e o que fazem os tablets. Veja [Controlo de acessos](/toegangscontrole) para o contexto sobre os meios de acesso. Para saber como funcionam as saídas, leia [Saídas de uma ação](/automatiseringen/acties#uitgangen-van-een-actie).

## Criar método de acesso [#toegangsmiddel-aanmaken]

Dá acesso a um cliente através de um código QR, matrícula, código PIN ou NFC.

| Campo | O que preencher |
|---|---|
| **Cliente** | O id do cliente, por exemplo `{reservation.customerId}`. Obrigatório |
| **Tipo** | **Código QR** (predefinição), **Matrícula**, **Código PIN** ou **NFC** |
| **Valor** | A matrícula ou o número NFC. Deixe vazio para um código QR ou PIN, porque a Tillor cria-o por si |
| **Válido desde** | Uma variável de data, por exemplo `{reservation.checkIn}`. Vazio significa sem limite |
| **Válido até** | Uma variável de data, por exemplo `{reservation.checkOut}`. Vazio significa sem limite |

Em **Matrícula** e **NFC**, o **Valor** é obrigatório. A ação devolve `{createdAccessMethod.id}` e `{createdAccessMethod.value}`. O valor é o código do código QR ou do PIN. Com o id pode depois enviar o código através de **Enviar ou imprimir código QR**.

## Atualizar acesso [#toegang-bijwerken]

Bloqueia, desbloqueia ou prolonga um método de acesso, ou todos os métodos de acesso de um cliente.

| Campo | O que preencher |
|---|---|
| **Quais** | **Um método de acesso** (predefinição) ou **Todos de um cliente** |
| **Método de acesso** | Apenas em **Um método de acesso**: o id, por exemplo `{createdAccessMethod.id}`. Obrigatório |
| **Cliente** | Apenas em **Todos de um cliente**: o id do cliente, por exemplo `{occupation.customerId}`. Obrigatório |
| **Estado** | **Manter como está** (predefinição), **Ativo**, **Bloqueio suave**, **Bloqueado** ou **Inativo** |
| **Válido até** | Uma variável de data. Vazio mantém a data final atual |

Tenha em conta:

- Se deixar **Estado** em **Manter como está** e **Válido até** vazio, o passo não faz nada
- Em **Todos de um cliente**, os métodos de acesso marcados com **Não prolongar automaticamente** mantêm a data final, tal como acontece quando um cliente paga uma fatura. O estado deles muda. Em **Um método de acesso**, o passo altera a data final, mesmo que esse método de acesso esteja em **Não prolongar automaticamente**

## Enviar ou imprimir código QR [#qr-code-versturen-of-afdrukken]

Envia um código QR de acesso ao cliente, imprime-o, ou ambos.

| Campo | O que preencher |
|---|---|
| **Método de acesso** | O id do método de acesso. Por predefinição `{createdAccessMethod.id}`. Obrigatório |
| **Enviar por e-mail** | Por predefinição ativado |
| **Enviar por SMS** | Por predefinição desativado |
| **Enviar por WhatsApp** | Por predefinição desativado |
| **Imprimir** | **Não imprimir** (predefinição), **Impressora de etiquetas** ou **Impressora de talões** |

Se desativar os três canais e escolher **Não imprimir**, o passo não faz nada.

## Abrir ou fechar cancela [#slagboom-openen-of-sluiten]

Abre ou fecha uma cancela ou portão.

| Campo | O que preencher |
|---|---|
| **Ponto de acesso** | Escolha um dos seus pontos de acesso. Obrigatório |
| **Ação** | **Abrir** (predefinição) ou **Fechar** |

## Ligar ou desligar energia [#stroom-schakelen]

Liga ou desliga a energia de um contador inteligente. Por exemplo, para desligar a energia quando uma ocupação termina.

| Campo | O que preencher |
|---|---|
| **Que contadores** | **Todos os contadores comutáveis de uma parcela** (predefinição) ou **Um contador** |
| **Parcela** | Apenas em **Todos os contadores comutáveis de uma parcela**: o id da parcela. Por predefinição `{occupation.terrainId}`. Obrigatório |
| **Contador** | Apenas em **Um contador**: escolha o contador. Obrigatório |
| **Energia** | **Ligada** ou **Desligada**. Por predefinição **Desligada** |

Tenha em conta:

- Em **Todos os contadores comutáveis de uma parcela**, o passo comuta apenas os contadores que o podem fazer. Se a parcela não tiver nenhum, não acontece nada
- Se não for possível comutar um contador, o passo falha. Em **Um contador** isso também acontece se o contador não puder ser comutado. Os contadores que já tinham sido comutados antes ficam comutados

## Atualizar etiquetas NFC [#nfc-tags-bijwerken]

Atualiza todas as [etiquetas NFC](/nfc/nfc-tags) de um cliente.

| Campo | O que preencher |
|---|---|
| **Cliente** | O id do cliente, por exemplo `{occupation.customerId}`. A ação aplica-se a todas as etiquetas NFC deste cliente. Obrigatório |
| **Ação** | **Bloquear** (predefinição), **Desbloquear**, **Carregar** ou **Enviar mensagem de saldo baixo** |
| **Montante** | Apenas em **Carregar**: o montante em euros, por etiqueta. Tem de ser superior a 0. Obrigatório |

Se o cliente tiver duas etiquetas e preencher 20, cada etiqueta recebe mais 20 euros. Sem etiquetas, o passo não faz nada. Se o montante não for um número superior a 0, o passo falha.

## Controlar tablet ou quiosque [#tablet-of-kiosk-bedienen]

Envia um comando a um [tablet ou quiosque](/mobiele-app/tablets-en-kiosken).

| Campo | O que preencher |
|---|---|
| **Dispositivo** | Escolha o dispositivo. Obrigatório |
| **Comando** | **Ativar** (predefinição), **Suspender**, **Recarregar**, **Identificar** ou **Reproduzir som de teste** |

## Definir apresentação [#diavoorstelling-instellen]

Define a apresentação em cada tablet e quiosque, ou num só dispositivo. As restantes definições do dispositivo mantêm-se. Se a mesma apresentação já estiver lá, esse dispositivo é ignorado.

Um gatilho de hora a hora, depois um [Pedido à API](/automatiseringen/acties/integraties#api-verzoek) a um feed de atividades, e depois este passo: assim substitui uma sincronização avulsa. Ligue o passo à saída **Sucesso** do pedido.

| Campo | O que preencher |
|---|---|
| **Dispositivos** | **Cada tablet e quiosque** (predefinição) ou **Um dispositivo** |
| **Dispositivo** | Apenas em **Um dispositivo**. Obrigatório |
| **Modo** | **Proteção de ecrã** (predefinição, após algum tempo sem toque) ou **Fundo** |
| **Segundos por foto** | Quanto tempo fica cada foto. Por predefinição 10. De 3 a 600 |
| **Espera antes de começar** | Apenas em **Proteção de ecrã**: segundos sem toque. Por predefinição 15 |
| **Ajuste** | **Preencher** ou **Ajustar** |
| **Fotos** | **De um pedido anterior** (predefinição) ou **Endereços** |
| **Endereços das imagens** | Apenas em **Endereços**: um endereço https por linha. Obrigatório |
| **Lista** | Caminho da lista JSON, sem chavetas. Depois de um pedido à API é `response.data`. Obrigatório |
| **Campo da imagem** | Nome do campo com o endereço https, por exemplo `signage_image`. Obrigatório |
| **Campo do id** | Mantém o mesmo id para a mesma foto, de modo a que uma lista inalterada não envie uma nova mensagem ao dispositivo |
| **Campo do estado** e **Estado** | Apenas as linhas em que esse campo tem este valor, por exemplo `CONFIRMED` |
| **Ignorar se preenchido** | As linhas em que este campo tem um valor ficam de fora, por exemplo `deleted_at` |
| **Campo da data** e **Campo da data de fim** | Uma linha fica enquanto esse momento ainda não tiver passado. Se a data de fim estiver vazia, vale a data |
| **Campo de ordenação** | Ordena a lista de forma ascendente, por exemplo por `date` |
| **Número máximo de fotos** | Por predefinição 5, no máximo 20 |

Um endereço que não comece por `https://` não conta. Se a lista não for uma matriz JSON, o passo falha e a apresentação atual mantém-se.


# Resumo (/pt-PT/automatiseringen)

Com as automações, faz a Tillor agir sem que um colega tenha de se lembrar. Define uma regra: *quando isto acontecer, faça aquilo*. Alguns exemplos:

- Termina uma ocupação numa caravana residencial, por isso a Tillor cria uma tarefa de verificação com subtarefas e atribui-a ao colega que terminou a ocupação
- Uma fatura está vencida, por isso a Tillor envia um lembrete de pagamento e, uma semana depois, cria uma tarefa para telefonar ao cliente se a fatura continuar em aberto
- Chega uma nova reserva, por isso a Tillor envia os dados para o seu próprio sistema
- Todas as segundas-feiras às 08:00, a Tillor cria uma tarefa para a verificação semanal
- Chega uma nova reserva, por isso a Tillor cria um código QR para o hóspede e envia-o por e-mail

Uma automação constrói-se numa área de desenho, sem código. Escolhe um momento de início, adiciona passos e liga-os com linhas.

## Em palavras simples [#in-gewone-woorden]

Uma automação tem três tipos de blocos. Só precisa de conhecer os detalhes técnicos quando precisar deles.

- **O momento de início (gatilho)** é o "quando". Acontece algo na Tillor, como uma ocupação que termina, ou chega uma certa hora ou uma certa data. Veja [Gatilhos](/automatiseringen/triggers)
- **A lógica** é o "se". Aqui o fluxo olha para os dados e escolhe um caminho, ou espera até que algo aconteça. Um exemplo: *a fatura continua por pagar após uma semana?* Veja [Condições, desvios e atrasos](/automatiseringen/logica)
- **As ações** são o "então faça". Criar uma tarefa, enviar uma mensagem, lançar uma fatura. Veja [Ações](/automatiseringen/acties)

Além disso, as **variáveis** são os dados do próprio momento, como o nome da parcela ou do cliente. Coloca-as entre chavetas num texto, e a Tillor preenche o valor real. Veja [Variáveis e modelos](/automatiseringen/variabelen).

## Quem pode usar [#wie-kan-het-gebruiken]

<Callout type="warn" title="Apenas para administradores">
As automações funcionam com todos os direitos na sua organização. Para as ver é necessária a permissão **Ver automatizações**, para as construir e alterar **Gerir automatizações**. Os administradores com **Todas as permissões** podem fazer ambas as coisas. Veja [Quem pode usar automações?](/automatiseringen/veelgestelde-vragen#wie-kan-automatiseringen-gebruiken).
</Callout>

Encontra a página no menu lateral, em <UIPath>Administrador > Automações</UIPath>.

## Como se relaciona isto? [#hoe-hangt-dit-samen]

Cada automação é composta por passos que liga num fluxo. Uma automação trabalha em conjunto com as tarefas: cria tarefas, espera que um colega escolha um botão, ou começa assim que uma tarefa muda. Veja [Tarefas](/taken#hoe-hangt-dit-samen). Cada vez que uma automação começa, chamamos-lhe uma execução. Uma execução começa no momento de início e segue as linhas para baixo.

| Componente | O que faz |
|---|---|
| **Quando isto acontece** (gatilho) | O momento de início. Um evento na Tillor, um webhook, uma ação de tarefa escolhida, uma fatura vencida, uma data como a chegada de um hóspede, uma hora fixa ou um horário próprio. Um fluxo pode ter vários gatilhos. Cada gatilho começa uma execução própria |
| **Apenas quando** | Um filtro no gatilho. A automação só começa se os dados corresponderem, por exemplo apenas para caravanas residenciais |
| **Se / senão** | Divide o fluxo em **Sim** e **Não** com base numa ou mais condições |
| **Desvio** | Divide o fluxo em vários ramos, consoante o valor de um campo |
| **Atraso** e outros passos de espera | Fazem o fluxo esperar, por uma hora, uma data, o horário de funcionamento, uma condição, um evento ou uma decisão de um colega |
| **Aberto agora?**, **Procurar um registo**, **Para cada** | Verificam se está aberto, obtêm um registo ou executam os passos seguintes para cada item de uma lista |
| **Ações** | Fazem realmente alguma coisa: tarefas, mensagens a hóspedes e colegas, faturas, pagamentos e mandatos, acesso, contadores e dispositivos, webhooks e pedidos à API |

Os passos com várias saídas, como **Sim** e **Não**, **Concluído** e **Ignorado** ou **Sucesso** e **Falhou**, permitem escolher uma continuação diferente para cada resultado. Em cada ação pode também ativar uma saída **Erro**, para que o fluxo continue se o passo falhar.

```mermaid
flowchart TD
  A["Wanneer dit gebeurt<br/>Factuur is vervallen"] --> B["Betalingsherinnering versturen"]
  B --> C["Vertraging<br/>7 dagen"]
  C --> D{"Als / anders<br/>nog niet betaald?"}
  D -- Ja --> E["Taak aanmaken<br/>klant bellen"]
  D -- Nee --> F["Einde"]
```

## Variáveis [#variabelen]

Os campos de texto de um passo aceitam variáveis entre chavetas, como `{occupation.terrain.name}`. A Tillor preenche aí o nome da parcela que pertence ao evento. Assim cria mensagens e tarefas que são diferentes consoante o caso. Leia mais em [Variáveis e modelos](/automatiseringen/variabelen).

## Começar rapidamente [#snel-aan-de-slag]

1. Vá a **Administrador > Automações** e clique em **Nova automação**
2. Escolha um modelo ou **Começar de raiz**
3. Defina o gatilho e os passos e clique em **Guardar**
4. Experimente o fluxo no separador **Execução de teste**. Nada é realmente enviado ou criado
5. Ative **Ativo** quando estiver satisfeito

A nova automação fica em pausa até a ativar. Uma explicação passo a passo está em [Primeiros passos](/automatiseringen/aan-de-slag).

<Callout type="info" title="Bom saber">
- Uma nova automação fica em pausa até a ativar
- Uma automação tem no máximo 100 passos. As notas e molduras na área de desenho contam à parte, no máximo 50
- Um **Desvio** tem no máximo 8 ramos, e **Pedir uma decisão** no máximo 8 opções
- Os horários e as datas são verificados a cada minuto. Um evento começa de imediato
- As alterações podem demorar meio minuto até valerem em todo o lado
- Uma execução falhada é enviada por e-mail a quem criou a automação, no máximo uma vez por hora
- No separador **Execuções** estão as últimas 20 execuções
- Um fluxo não se pode iniciar a si próprio nem a outro fluxo através do que ele próprio cria
</Callout>

<Callout type="info" title="As automações fazem realmente alguma coisa">
Uma automação ativada envia lembretes reais e cria tarefas reais. Use o separador **Execução de teste** e veja as primeiras execuções no separador **Execuções** antes de ter a certeza de que tudo está certo.
</Callout>

## Componentes [#onderdelen]

<Cards>
  <Card
    title="Primeiros passos"
    href="/automatiseringen/aan-de-slag"
    description="O resumo, os modelos e o editor, e como guardar e ativar uma automação"
  />
  <Card
    title="Gatilhos"
    href="/automatiseringen/triggers"
    description="Eventos, datas, faturas vencidas e horários, além de filtros e início único"
  />
  <Card
    title="Condições, desvios e atrasos"
    href="/automatiseringen/logica"
    description="Fazer o fluxo dividir-se e esperar, procurar registos, percorrer listas e pedir uma decisão"
  />
  <Card
    title="Ações"
    href="/automatiseringen/acties"
    description="Tudo o que uma automação pode fazer, com todos os campos"
  />
  <Card
    title="Variáveis e modelos"
    href="/automatiseringen/variabelen"
    description="Usar os dados do evento nos seus textos"
  />
  <Card
    title="Quem executa uma automação?"
    href="/automatiseringen/workflow-gebruiker"
    description="Porque é que as tarefas e os comentários de uma automação ficam em nome de um utilizador de sistema fixo"
  />
  <Card
    title="Testes e execuções"
    href="/automatiseringen/testen-en-uitvoeringen"
    description="Fazer uma execução de teste e rever as execuções reais"
  />
  <Card
    title="Problemas e ativação"
    href="/automatiseringen/problemen"
    description="Porque é que uma automação não pode ser ativada e o que significam as mensagens"
  />
  <Card
    title="Exemplo: verificação de caravana de aluguer"
    href="/automatiseringen/voorbeeld-nalopen"
    description="Construir um fluxo completo passo a passo"
  />
  <Card
    title="Perguntas frequentes"
    href="/automatiseringen/veelgestelde-vragen"
    description="Limites, explicações sobre a pausa e o que fazer quando nada acontece"
  />
  <Card
    title="Para programadores"
    href="/ontwikkelaars/automatiseringen"
    description="O pedido à API, o envelope do webhook, a assinatura e a gestão através da API"
  />
</Cards>

<Cards>
  <Card title="Exemplos práticos" href="/praktijk" description="Exemplos desenvolvidos da prática" />
</Cards>

## Conceitos [#begrippen]

- **Automação**: uma regra de "quando isto acontecer, faça aquilo", construída como um fluxo
- **Fluxo**: a área de desenho de uma automação, com passos e linhas
- **Gatilho**: o momento de início de um fluxo
- **Execução**: uma vez que uma automação começa e percorre o fluxo
- **Ação**: um passo que faz realmente alguma coisa, como criar uma tarefa
- **Variável**: um dado do momento, entre chavetas num texto
- **Execução de teste**: uma experiência em que nada é realmente enviado ou criado
- **Fluxo de trabalho**: o utilizador em nome de quem uma automação trabalha

Mais termos estão no [glossário](/begrippen).


# Condições, desvios e atrasos (/pt-PT/automatiseringen/logica)

Com os passos do grupo **Lógica** decide para que lado um fluxo segue e quando: o "se" e o "espere um pouco". Um exemplo: *se a fatura continuar em aberto passada uma semana, crie uma tarefa*. Estes passos comandam as ações que vêm a seguir. Só [Pedir uma decisão](#vraag-om-een-beslissing) cria algo por si, uma tarefa.

| Passo | O que faz | Saídas |
|---|---|---|
| [Se / senão](#als--anders) | Divide segundo condições | **Sim**, **Não** |
| [Desvio](#schakel) | Escolhe um ramo segundo o valor de um campo | Uma por ramo e **Predefinição** |
| [Atraso](#vertraging) | Espera um tempo fixo ou até uma data | **Seguinte** |
| [Aberto agora?](#nu-open) | Verifica se está aberto neste momento | **Aberto**, **Fechado** |
| [Aguardar até abrir](#wachten-tot-open) | Espera até à próxima hora de abertura | **Seguinte** |
| [Aguardar até fechar](#wachten-tot-gesloten) | Espera até à próxima hora de fecho | **Seguinte** |
| [No máximo uma vez por período](#hoogstens-één-keer-per-periode) | Trava repetições | **Continuar**, **Já executado** |
| [Procurar um registo](#record-opzoeken) | Obtém um registo pelo seu ID | **Encontrada**, **Não encontrada** |
| [Para cada](#voor-elk) | Executa os passos seguintes por cada item de uma lista | **Para cada**, **Concluído** |
| [Aguardar até](#wachten-tot) | Espera até as condições se cumprirem | **Cumprida**, **Tempo esgotado** |
| [Aguardar um evento](#wachten-op-een-gebeurtenis) | Espera até acontecer algo no Tillor | **Recebido**, **Tempo esgotado**, por vezes **Eliminado** |
| [Pedir uma decisão](#vraag-om-een-beslissing) | Deixa um colega escolher entre as suas opções | Uma por opção e **Tempo esgotado** |

## Se / senão [#als--anders]

Divide o fluxo em dois caminhos com base nos dados. É o mesmo princípio do filtro em **Apenas quando** do acionador, mas agora a meio do fluxo.

O passo tem duas saídas: **Sim** (as condições verificam-se) e **Não** (não se verificam).

1. Adicione um passo **Se / senão**
2. Em **Condições**, clique em **Adicionar condição**
3. Escolha o campo com o botão **Variável**, ou escreva o caminho você mesmo, por exemplo `invoice.paymentStatus`
4. Escolha a comparação (**é**, **não é**, **contém**, **é maior que**, **é menor que**, **é um de**, **está vazio** ou **não está vazio**) e preencha o valor
5. Ligue a saída **Sim** e, se quiser, **Não** a um passo seguinte

Um passo **Se / senão** precisa de pelo menos uma condição. Caso contrário, o Tillor indica **Adicione uma condição.** Havendo várias condições, escolhe entre **Todas têm de corresponder** e **Basta uma corresponder**. As comparações funcionam como descrito em [Apenas quando](/automatiseringen/triggers#alleen-wanneer).

Não precisa de ligar as duas saídas. Se uma saída não leva a lado nenhum, a execução termina aí. Um fluxo que só faz algo em **Sim** está, por isso, perfeitamente bem.

Também pode usar campos de passos anteriores. Depois de um [Pedido à API](/automatiseringen/acties/integraties#api-verzoek) pode, por exemplo, verificar `response.status` ou `response.data.paymentStatus`.

## Desvio [#schakel]

Escolha **Desvio** quando precisar de mais de dois caminhos. O passo olha para o valor de um campo e escolhe o ramo que lhe corresponde.

1. Em **Campo**, escolha o campo que quer verificar, por exemplo `occupation.occupationType`
2. Em **Ramos**, clique em **Adicionar ramo**. Preencha o **Ramo** (o nome que aparece na saída) e **Igual a** (o valor que o campo tem de ter)
3. Repita para cada ramo
4. Ligue cada saída a um passo seguinte

Cada ramo recebe uma saída própria por baixo do passo. Além disso, existe sempre uma saída **Predefinição**. É usada quando nenhum ramo serve.

- O campo tem de coincidir exatamente com o valor, incluindo maiúsculas e minúsculas
- Se mais de um ramo servir, ganha o primeiro da lista
- Um ramo sem valor em **Igual a** não conta
- Pode definir no máximo 8 ramos, mais **Predefinição**
- Se o campo estiver vazio ou não existir, o fluxo segue por **Predefinição**

Os valores de campos de escolha estão na notação do Tillor. Uma ocupação do tipo caravana de aluguer tem, por exemplo, o valor `RENTAL_CARAVAN`, uma fatura paga `PAID`.

<Callout type="info">
A lista em **Campo** mostra os campos do evento e de passos anteriores. Os campos da resposta de um pedido à API só aparecem na lista quando o Tillor conhece um exemplo dessa resposta. Veja [Usar uma resposta da API](/automatiseringen/variabelen#een-api-antwoord-gebruiken).
</Callout>

## Atraso [#vertraging]

Com **Atraso** faz o fluxo esperar antes de continuar. Usa-se para coisas como *voltar a ver daqui a uma semana*.

Em **Aguardar** escolhe uma de duas formas.

### Um tempo fixo [#een-vaste-tijd]

Escolha **Durante um tempo fixo** e preencha em **Duração** uma quantidade e uma unidade: **segundos**, **minutos**, **horas**, **dias** ou **semanas**. Os segundos não são exatos. O fluxo pode continuar alguns segundos mais tarde.

Um atraso de 0 não faz nada, por isso o Tillor indica **Um atraso de 0 não faz nada.**

### Até uma data [#tot-een-datum]

Escolha **Até uma data** quando o tempo de espera depende de uma data dos dados, como a data de vencimento de uma fatura ou a data final de uma reserva.

| Campo | O que preenche |
|---|---|
| **Data** | Um campo com uma data, por exemplo `invoice.dueDate`. A lista só mostra campos que são datas |
| **Em relação a essa data** | **Antes** ou **Depois** |
| **Deslocamento** | Quanto tempo antes ou depois dessa data, em minutos, horas, dias ou semanas. Com 0, o fluxo continua exatamente nessa data |

Exemplos:

- **Data** `invoice.dueDate`, **Depois**, **Deslocamento** 1 dia: o fluxo continua um dia depois da data de vencimento
- **Data** `reservation.checkIn`, **Antes**, **Deslocamento** 2 dias: o fluxo continua dois dias antes da chegada

Se esse momento já estiver no passado, ou a data estiver vazia, o fluxo continua logo.

### O que acontece durante a espera [#wat-er-tijdens-het-wachten-gebeurt]

- A execução recebe o estado **A aguardar**. No separador **Execuções** indica quando continua (**Continua …**). Esperas longas, como semanas, não são problema
- Depois do atraso, o Tillor lê os dados de novo, para que os passos seguintes vejam a situação atual. Veja abaixo
- Se puser a automação em pausa durante a espera, a execução para assim que o tempo de espera termina. Não continua e fica com o estado **Cancelada**. Se voltar a ativar a automação antes de o tempo de espera terminar, a execução continua normalmente
- Se eliminar a automação, as execuções em espera param
- Se alterar o fluxo enquanto uma execução espera, essa execução termina com o fluxo tal como era quando começou

### Os dados são lidos de novo [#gegevens-worden-opnieuw-gelezen]

Uma execução guarda os dados do momento do evento, mas lê de novo os registos que lhe pertencem antes de continuar. São o registo do evento (por exemplo a fatura) e os registos para que este aponta (por exemplo o cliente).

Um exemplo: uma automação envia um lembrete de uma fatura, espera 7 dias e depois verifica com **Se / senão** se `invoice.paymentStatus` não é `PAID`. Se a fatura tiver sido paga nessa semana, a condição vê a fatura paga e o fluxo segue por **Não**.

Há duas exceções:

- Se o registo já não existir, por exemplo porque uma ocupação foi eliminada, a execução mantém a cópia do momento do evento
- Os dados que um passo anterior produziu, como a resposta de um pedido à API, não são obtidos de novo. Se quiser esses dados atualizados depois de um atraso, faça um novo pedido à API

<Callout type="info" title="Num teste nada é lido de novo">
Uma [execução de teste](/automatiseringen/testen-en-uitvoeringen) salta os atrasos e trabalha com os dados de exemplo que preencher. O que acontece depois de um atraso verdadeiro só vê numa execução verdadeira.
</Callout>

## Aberto agora? [#nu-open]

Verifica se a sua organização está aberta neste momento e divide o fluxo em **Aberto** e **Fechado**. Não há nada a configurar. O Tillor usa o horário em **Definições > Horário de funcionamento**, com períodos sazonais, feriados e exceções. Veja [Definições da organização](/gebruikers/organisaties#openingsuren).

Use-o, por exemplo, para enviar um texto diferente fora do horário ou criar uma tarefa. Se preferir esperar até voltar a abrir, use [Aguardar até abrir](#wachten-tot-open). Se quiser esperar até fechar, use [Aguardar até fechar](#wachten-tot-gesloten).

## Aguardar até abrir [#wachten-tot-open]

Faz o fluxo pausar até à próxima hora de abertura e continua depois. A sua organização já está aberta? Então o fluxo continua logo. Não há nada a configurar.

- A hora de abertura vem de **Definições > Horário de funcionamento**, no fuso horário da sua organização
- Se no próximo mês não houver nenhuma hora de abertura, o fluxo continua logo em vez de ficar à espera
- Durante a espera, a execução recebe o estado **A aguardar**. O que acontece aí está em [Atraso](#wat-er-tijdens-het-wachten-gebeurt)

## Aguardar até fechar [#wachten-tot-gesloten]

Faz o fluxo pausar até à próxima hora de fecho e continua depois. A sua organização já está fechada? Então o fluxo continua logo. Não há nada a configurar.

- A hora de fecho vem de **Definições > Horário de funcionamento**, no fuso horário da sua organização
- Blocos que se seguem diretamente, como 9:00–12:00 e 12:00–17:00, contam como um só. O fluxo espera até ao fim desse bloco
- Durante a espera, a execução recebe o estado **A aguardar**. O que acontece aí está em [Atraso](#wat-er-tijdens-het-wachten-gebeurt)

## No máximo uma vez por período [#hoogstens-één-keer-per-periode]

Só deixa o fluxo passar se ele ainda não tiver passado por este passo para o mesmo registo dentro do período. Assim não envia ao cliente o mesmo lembrete todos os dias.

| Campo | O que preenche |
|---|---|
| **Período** | Durante quanto tempo contam as execuções anteriores, em minutos, horas, dias ou semanas. Por predefinição, 1 dia |
| **Por** | O que se conta. Vazio significa por registo com que o fluxo começou, como a fatura ou a reserva. Preencha uma variável, por exemplo `{customer.id}`, para contar por cliente ou por parcela |

O passo tem duas saídas: **Continuar** se o fluxo ainda não passou por aqui no período, e **Já executado** se já passou. Ligue **Já executado** a outro passo, ou deixe-a vazia para que a execução termine aí.

Tenha em conta:

- Só contam as execuções da mesma automação, e só se passaram por este passo através de **Continuar**
- Se não ligar **Eliminado** a nada, o Tillor para os fluxos em espera desse registo e elimina as tarefas que o fluxo criou e que só o fluxo podia concluir. Se ligar a saída, o fluxo continua aí
- Se o fluxo começar sem registo, por exemplo com **Todos os dias a uma hora**, preencha você mesmo uma variável em **Por**. Sem esse valor, cada execução é nova e o passo não trava nada
- A execução que está a decorrer não conta para si própria

Um exemplo: **Período** 7 dias e **Por** `{invoice.customerId}` deixa passar, por cliente, no máximo um lembrete por semana, mesmo que esse cliente tenha várias faturas vencidas.

## Procurar um registo [#record-opzoeken]

Carrega um registo com base no seu ID, para que os passos seguintes possam usar os seus campos. É útil quando o evento só traz um ID, como a mensagem numa conversa da caixa de entrada.

| Campo | O que preenche |
|---|---|
| **Tipo de registo** | **Cliente**, **Reserva**, **Ocupação**, **Fatura**, **Pagamento**, **Parcela**, **Tarefa**, **Documento**, **Meio de acesso**, **Etiqueta NFC**, **Contador**, **Conversa da caixa de entrada** ou **Mensagem da caixa de entrada**. Por predefinição, **Mensagem da caixa de entrada** |
| **ID** | O ID do registo, por exemplo `{messageId}`. Obrigatório |

O passo tem duas saídas: **Encontrada** e **Não encontrada**. Se o registo não existir ou o ID estiver vazio, o fluxo segue por **Não encontrada**.

Depois de **Encontrada**, os campos do registo ficam em variáveis que começam por `found` e depois o tipo: `{foundCustomer.firstName}`, `{foundInvoice.displayId}`, `{foundReservation.checkIn}`, `{foundTerrain.name}`, `{foundInboxMessage.direction}`. Os outros tipos chamam-se `foundOccupation`, `foundPayment`, `foundTask`, `foundAccessMethod`, `foundNfcTag`, `foundMeter` e `foundInboxThread`. Também ficam disponíveis os registos para que este aponta, um nível abaixo, como `{foundReservation.customer.firstName}`. Tudo está na lista atrás do botão **Variável**.

Uma segunda pesquisa do mesmo tipo substitui a primeira. Atenção em **Tarefa**: usa o mesmo nome `foundTask` que [Procurar tarefa](/automatiseringen/acties/taken#taak-zoeken), e ganha a última das duas. O mesmo vale para **Documento** e `foundDocument` de [Procurar documento](/automatiseringen/acties/documenten#document-zoeken).

## Mapear variáveis [#variabelen-mappen]

Copia valores para novos nomes de variáveis, para que os passos seguintes possam usar uma única forma. É útil quando um fluxo começa por **Webhook recebido** (`{body.…}`) e por **Fatura vencida** (`{invoice.…}`).

| Campo | O que preenche |
|---|---|
| **Mapeamentos** | Linhas com **Variável de destino** (por ex. `invoice`) e **Origem** (por ex. `{foundInvoice}` ou `{body.invoiceId}`) |

O passo tem uma saída: **Seguinte**. Se a origem for exatamente uma variável entre chavetas, por exemplo `{foundInvoice}`, o Tillor copia o registo inteiro (objeto). Caso contrário, o Tillor preenche a origem como texto, como `Fatura {foundInvoice.displayId}` em `meta.label`.

Teste de webhook típico: **Webhook recebido** → **Procurar um registo** (Fatura, ID `{body.invoiceId}`) → **Mapear variáveis** (`invoice` ← `{foundInvoice}`) → as mesmas condições e aprovação que no acionador de agenda.

## Executar código [#code-uitvoeren]

Executa um pedaço de TypeScript sobre as variáveis do fluxo e guarda o que devolve como nova variável. Serve para lógica que não cabe em campos e condições: que subtarefas têm de surgir, calcular um montante ou uma data, transformar o corpo de um webhook.

| Campo | O que preenche |
|---|---|
| **Código** | TypeScript. As variáveis escrevem-se como nos textos, com chavetas: `{customer.firstName}` é lida como valor, não preenchida como texto. Termine com `return`. Obrigatório |
| **Variável de saída** | O nome com que os passos seguintes leem o resultado, como `result` (depois `{result}`) ou `result.names`. Por predefinição, `result` |

O passo tem uma saída: **Seguinte**. Funciona assim:

- O código só vê as variáveis que menciona. Uma variável que o fluxo não tem é `null`; uma data chega como texto (`2026-07-01T10:00:00.000Z`)
- Formatações e deslocamentos de datas (`{bedrag|currency}`, `{datum + 1 day}`) não funcionam aqui: calcule-os no código
- Devolva uma lista, texto, número ou objeto. Um objeto lê-se depois campo a campo: `{result.total}`
- O código não pode obter nem enviar nada: sem internet, sem base de dados. Só calcula. Se calcular durante demasiado tempo (mais de 50 ms), é interrompido
- Se o código lançar um erro, a execução pára com esse erro e o número da linha. Vê-los no separador **Execuções**
- À direita do código vê logo o que devolve no exemplo; ao testar, corre também

Um exemplo: após a partida quer subtarefas que dependem da parcela. Coloque um passo **Executar código** com:

```ts
const tasks = ["Plaats vegen", "Sanitair"];
if ({occupation.terrain.metadata.gasMeterNumber}) tasks.push("Gasmeterstand noteren");
return tasks;
```

Depois, em **Criar tarefa**, preencha o campo **Subtarefas** só com `{result}`: cada texto da lista torna-se uma subtarefa.

## Para cada [#voor-elk]

Executa os passos depois de **Para cada** uma vez por cada item de uma lista, por exemplo por cada fatura em aberto de um cliente. O próprio fluxo continua por **Concluído**.

| Campo | O que preenche |
|---|---|
| **Lista** | **Métodos de acesso de um cliente**, **Etiquetas NFC de um cliente**, **Faturas em aberto de um cliente**, **Reservas confirmadas de um cliente**, **Ocupações de um cliente**, **Documentos de um cliente** (só ativos) ou **Contadores de uma parcela**. Por predefinição, **Métodos de acesso de um cliente** |
| **De** | O cliente ou a parcela de que quer a lista, por exemplo `{customer.id}` ou `{occupation.terrainId}`. Obrigatório |

O passo tem duas saídas com significado próprio:

- **Para cada** leva aos passos que quer fazer por item
- **Concluído** é como o próprio fluxo continua

Funciona assim:

- Cada item recebe uma execução própria, que percorre os passos depois de **Para cada** até ao fim desse ramo. Vê-las no separador **Execuções**, que só mostra as últimas 20
- O item está na variável `item`, por exemplo `{item.id}`. As variáveis do evento e de passos anteriores continuam disponíveis
- O fluxo não espera que os itens terminem. Logo depois de eles começarem, continua por **Concluído**. Por isso não pode usar o resultado de um item nos passos depois de **Concluído**
- São processados no máximo 100 itens, os mais antigos primeiro. Se houver mais na lista, os restantes não são processados
- Se a lista estiver vazia ou o campo **De** estiver vazio, nada começa e o fluxo continua logo por **Concluído**
- **Faturas em aberto de um cliente** são faturas lançadas de que ainda há algo por pagar. **Reservas confirmadas de um cliente** são reservas com o estado **Reservada**

Um exemplo: uma fatura vence e quer criar uma ligação de pagamento para cada fatura em aberto desse cliente. Escolha **Faturas em aberto de um cliente**, preencha `{invoice.customerId}` em **De** e coloque depois de **Para cada** um passo **Criar link de pagamento** com `{item.id}` como fatura.

## Aguardar até [#wachten-tot]

Verifica condições uma e outra vez até se verificarem, ou pára ao fim de algum tempo. Use-o quando não sabe quando algo acontece mas sabe o que espera, por exemplo até uma fatura estar paga.

| Campo | O que preenche |
|---|---|
| **Até** | Uma ou mais condições, da mesma forma que em [Se / senão](#als--anders) |
| **Verificar a cada** | Com que frequência o Tillor volta a ver, em minutos, horas, dias ou semanas. No mínimo 5 minutos. Por predefinição, 1 hora |
| **Deixar de aguardar após** | Durante quanto tempo o passo espera no máximo. Por predefinição, 7 dias |

O passo tem duas saídas: **Cumprida** (as condições verificam-se) e **Tempo esgotado** (o tempo de espera terminou sem que se verificassem).

Tenha em conta:

- A primeira verificação é logo. Se as condições já se verificarem, o fluxo continua de imediato por **Cumprida**. Se não preencher nenhuma condição, verifica-se sempre
- Em cada verificação, o Tillor lê de novo os registos do evento, como num [atraso](#gegevens-worden-opnieuw-gelezen). Uma condição como `invoice.paymentStatus` é `PAID` vê, por isso, o pagamento assim que ele existe
- Um intervalo inferior a 5 minutos passa a 5 minutos
- Durante a espera, a execução recebe o estado **A aguardar**. Para pausar e alterar o fluxo vale o mesmo que em [Atraso](#wat-er-tijdens-het-wachten-gebeurt)

## Aguardar um evento [#wachten-op-een-gebeurtenis]

Faz o fluxo pausar até acontecer algo no Tillor, por exemplo a fatura ser paga.

| Campo | O que preenche |
|---|---|
| **Evento** | O que espera. A mesma lista que no [acionador](/automatiseringen/triggers#als-er-iets-gebeurt). Obrigatório |
| **Apenas para o mesmo registo** | Só continua se o evento disser respeito ao registo com que o fluxo começou. Ativo por predefinição |
| **Deixar de aguardar após** | Durante quanto tempo o passo espera no máximo. Por predefinição, 7 dias |

O passo tem duas saídas: **Recebido** (o evento chegou) e **Tempo esgotado** (o tempo de espera terminou sem evento). Se **Apenas para o mesmo registo** estiver ativo, surge uma terceira saída, **Eliminado**. Use-a quando o registo do fluxo foi eliminado enquanto o fluxo esperava.

Tenha em conta:

- Com **Apenas para o mesmo registo** ativo, conta, por exemplo, apenas o pagamento da fatura com que o fluxo começou. Se o desativar, qualquer evento desse tipo faz o fluxo continuar
- Se não ligar **Eliminado** a nada, o Tillor para os fluxos em espera desse registo e elimina as tarefas que o fluxo criou e que só o fluxo podia concluir. Se ligar a saída, o fluxo continua aí
- Se o fluxo começar sem registo, por exemplo com **Todos os dias a uma hora**, conta qualquer evento desse tipo
- Um evento que um passo de uma automação causa por si também conta. Os fluxos em espera continuam, portanto, também com trabalho de **Fluxo de trabalho**
- Depois de **Recebido**, os dados do evento que esperava estão nas variáveis, sem o colega que o causou. Se esperar por `invoice:paid`, então `{invoice.paymentStatus}` dá o novo estado
- Durante a espera, a execução recebe o estado **A aguardar**. Para pausar e alterar o fluxo vale o mesmo que em [Atraso](#wat-er-tijdens-het-wachten-gebeurt)

## Pedir uma decisão [#vraag-om-een-beslissing]

Cria uma tarefa com botões que define você mesmo, e espera até alguém escolher um botão. Assim constrói um momento em que uma pessoa acompanha, por exemplo antes de o fluxo bloquear um cliente ou lançar uma fatura. Cada opção é um botão na tarefa e uma saída do passo.

| Campo | O que preenche |
|---|---|
| **Título da tarefa** | O título da tarefa. Obrigatório |
| **Descrição** | Diga ao seu colega o que é preciso decidir |
| **Opções** | Os botões da tarefa. Veja abaixo. Pelo menos uma |
| **Atribuir a** | Escolha um ou mais colegas |
| **Atribuir a grupos** | Escolha um ou mais grupos |
| **Associar a** | Os registos em que a tarefa aparece, como o cliente ou a fatura. Preenchido de antemão com os registos conhecidos neste passo |
| **Deixar de aguardar após** | Durante quanto tempo o passo espera no máximo. Por predefinição, 3 dias |

### Definir opções [#opties-instellen]

1. Em **Opções**, clique em **Adicionar opção** e preencha o nome, por exemplo **Aprovar**. Esse nome aparece no botão e na saída
2. Clique na caixa colorida à esquerda do nome (**Ícone e cor**) para escolher uma cor e um ícone. Um ícone não é obrigatório
3. Ative **Pedir uma nota** se o colega tiver de indicar um motivo nesta escolha
4. Ative **Pedir confirmação** se o colega tiver primeiro de confirmar. Preenche então um **Título da confirmação** e uma **Mensagem de confirmação** e escolhe em **Gravidade** entre **Informação**, **Aviso** ou **Destrutivo**. Nestes textos pode usar variáveis
5. Repita para cada opção. Pode criar no máximo 8 opções

Se a lista ainda estiver vazia, o botão **Aprovar / Rejeitar** prepara logo duas opções: um **Aprovar** verde e um **Rejeitar** vermelho. Cada opção precisa de um nome, caso contrário o Tillor indica **Cada opção precisa de um nome.** Sem opções, o Tillor indica **Adicione pelo menos uma opção.**

### Saídas [#uitgangen]

O passo tem uma saída por opção, com o nome e a cor dessa opção, mais sempre **Tempo esgotado**.

| Saída | Quando |
|---|---|
| O nome de uma opção | Alguém escolheu esse botão na tarefa |
| **Tempo esgotado** | O tempo de espera terminou sem escolha, ou a tarefa foi eliminada |

Tenha em conta:

- Os botões estão no cartão da tarefa, na lista de tarefas e na própria tarefa. Uma tarefa assim não tem visto: não pode simplesmente concluí-la, só escolher um botão. Depois da escolha, a tarefa fica em **Concluída** e indica que opção foi escolhida. Veja [Tarefas com botões de escolha](/taken/taakdetails#taken-met-keuzeknoppen)
- Pode escolher quem está atribuído à tarefa, também através de um grupo, e os administradores. Se não atribuir ninguém, qualquer pessoa que veja a tarefa pode escolher
- A tarefa recebe prioridade **Alta**. Está em nome de **Fluxo de trabalho**
- Se a tarefa for eliminada antes de alguém escolher, o fluxo continua por **Tempo esgotado**. Depois de **Tempo esgotado** pelo tempo de espera, a tarefa continua a existir
- Os passos seguintes podem usar `{approvalTask.id}`, `{approval.decision}`, `{approval.label}`, `{approval.note}` e `{approval.decidedBy.name}`. `{approval.label}` é o nome da opção escolhida e `{approval.note}` a nota que o colega preencheu
- Durante a espera, a execução recebe o estado **A aguardar**. Para pausar e alterar o fluxo vale o mesmo que em [Atraso](#wat-er-tijdens-het-wachten-gebeurt)

<Callout type="info" title="Num teste escolhe você a saída">
Uma [execução de teste](/automatiseringen/testen-en-uitvoeringen) não pode saber se está aberto, o que um colega decide e se um registo existe. Em **O que acontece nestes passos?** escolhe, por isso, você mesmo a saída de **Aberto agora?**, **No máximo uma vez por período**, **Procurar um registo**, **Para cada**, **Aguardar até**, **Aguardar um evento** e **Pedir uma decisão**. Em **Para cada**, o teste segue pela saída que escolher, **Para cada** ou **Concluído**, não pelas duas.
</Callout>

## O que acontece depois? [#wat-gebeurt-er-daarna]

- Uma saída que não ligar faz a execução terminar aí.
- Num passo de espera, a execução recebe o estado <Status tone="info">A aguardar</Status> e continua mais tarde. Uma automação em pausa pára as execuções em espera assim que o tempo de espera termina.
- Depois de um tempo de espera, o Tillor lê os dados de novo, para que os passos vejam a situação atual.

## Problemas? [#problemen]

<Accordions>
<Accordion title="O Tillor diz Adicione uma condição">
Um passo **Se / senão** precisa de pelo menos uma condição. Clique em **Adicionar condição**.
</Accordion>
<Accordion title="O Tillor diz Um atraso de 0 não faz nada">
Preencha em **Duração** uma quantidade superior a 0.
</Accordion>
<Accordion title="O fluxo segue sempre por Predefinição">
Um **Desvio** compara o valor exatamente, incluindo maiúsculas e minúsculas. Os valores de escolha estão na notação do Tillor, como `RENTAL_CARAVAN`. Se o campo estiver vazio, o fluxo também segue por **Predefinição**.
</Accordion>
<Accordion title="O Tillor diz Adicione pelo menos uma opção ou Cada opção precisa de um nome">
Um passo **Pedir uma decisão** precisa de pelo menos uma opção com nome. Em **Opções**, clique em **Adicionar opção**.
</Accordion>
<Accordion title="A execução fica em A aguardar">
O fluxo espera por um tempo, condição, evento ou decisão. No separador **Execuções** indica quando continua ou expira. Em **Aguardar até**, por predefinição é ao fim de 7 dias, em **Pedir uma decisão** ao fim de 3 dias.
</Accordion>
<Accordion title="A tarefa de Pedir uma decisão desapareceu">
Se a tarefa for eliminada antes de alguém escolher, o fluxo continua por **Tempo esgotado**. Veja [Tarefas com botões de escolha](/taken/taakdetails#taken-met-keuzeknoppen).
</Accordion>
</Accordions>


# Problemas e ativação (/pt-PT/automatiseringen/problemen)

O Tillor verifica continuamente o seu fluxo enquanto o constrói. Enquanto houver problemas em aberto, não pode ativar a automação. Isto evita que um fluxo que não pode funcionar tente enviar lembretes ou tarefas verdadeiros.

## Onde vê os problemas [#waar-zie-je-de-problemen]

- Em cada passo com um problema aparece um pequeno número de aviso
- No painel à direita, os problemas do passo selecionado aparecem num bloco laranja por cima das definições
- No topo do painel há um botão com o total, por exemplo **3 problemas**. Clique nele para ver a lista e clique num aviso para saltar para o passo
- Na vista geral das automações aparece uma etiqueta como **3 problemas** junto ao nome, e um filtro **Problemas**

<DocScreenshot src="/screenshots/automatiseringen/issues.png" alt="Botão 1 problema no topo do painel com o aviso O título é obrigatório" />

## Porque não consigo ativar [#waarom-kan-ik-niet-inschakelen]

O interruptor **Ativo** não funciona enquanto houver problemas, com o texto **Corrija primeiro os problemas em aberto**. Na vista geral também não consegue ligar o interruptor da automação.

Se a automação já estiver ligada, não pode guardar alterações com problemas. Um fluxo que está a funcionar tem de se manter válido. Resolva os problemas ou ponha primeiro a automação em pausa.

## O que significam os avisos [#wat-de-meldingen-betekenen]

| Aviso | O que se passa | O que faz |
|---|---|---|
| **Adicione um acionador para começar.** | O fluxo não tem acionador | Um fluxo precisa sempre de pelo menos um acionador. Arraste **Quando isto acontece** da lista à esquerda para a tela |
| **Este evento já não existe. Escolha outro.** | O evento do acionador já não existe | Em **Evento**, escolha outro |
| **Não está ligado, por isso este passo nunca é executado.** | Nenhuma linha chega ao passo | Ligue o passo a uma saída de outro passo, ou elimine-o |
| **Este passo faz parte de um ciclo. Um fluxo só pode avançar.** | Uma linha volta a um passo anterior | Elimine a linha que aponta para trás. Um fluxo não pode andar em círculo |
| **[Campo] é obrigatório.** | Um campo obrigatório está vazio, como o **Título** de uma tarefa | Preencha o campo. Os campos obrigatórios têm um asterisco |
| **[Campo]: [variável] não está disponível neste passo.** | Está a usar uma variável que não existe neste passo | Escolha uma variável da lista atrás do botão **Variável**. Verifique também se o passo que produz a variável vem antes no fluxo |
| **[Campo] não é um JSON válido.** | O **Payload** ou o **Corpo** não está correto como JSON | Verifique chavetas, vírgulas e aspas. As variáveis são permitidas |
| **Adicione pelo menos uma opção.** | Um passo **Pedir uma decisão** não tem opções | Em **Opções**, clique em **Adicionar opção** |
| **Cada opção precisa de um nome.** | Uma opção de **Pedir uma decisão** não tem nome | Preencha o nome ou elimine a opção |
| **Adicione uma condição.** | Um passo **Se / senão** não tem condições | Clique em **Adicionar condição** |
| **Uma condição não tem um campo válido.** | O campo de uma condição está vazio ou é desconhecido | Escolha ou escreva um campo que conste da lista atrás de **Variável** |
| **Introduza um valor para [variável].** | Uma condição tem uma comparação mas ainda não tem valor | Preencha o valor, ou escolha uma comparação como **está vazio** que não precise de nenhum |
| **[Campo]: [variável] não é um formato conhecido.** | Está a usar, depois do `\|`, um formato que não existe | Use `currency`, `number`, `date`, `datetime`, `time`, `upper` ou `lower`. Veja [Formatar um valor](/automatiseringen/variabelen#een-waarde-opmaken) |
| **[Campo]: [variável] não é uma unidade.** | Está a escrever um deslocamento de data com uma unidade que não existe | Use `minutes`, `hours`, `days`, `weeks` ou `months` |
| **[Campo]: o campo personalizado [variável] não existe.** | Está a usar um campo personalizado que já não existe | Escolha um campo existente da lista atrás de **Variável** |
| **[Campo]: [variável] tem um formato ou um desvio de data, que só funciona em textos.** | Está a usar um formato no campo de código de **Executar código** | Calcule-o no código |
| **[Campo]: [variável] não é um nome de variável.** | O nome de um resultado contém carateres não permitidos | Use letras, algarismos e pontos, como `result` ou `result.names` |
| **Um atraso de 0 não faz nada.** | O atraso está em 0 | Preencha uma duração superior a 0 |
| **O caminho tem de começar por / e ficar dentro da API da sua organização.** | O **Caminho** de um pedido à API não é permitido | Faça o caminho começar por um só `/` e não ponha `..` nem `\` |
| **O URL tem de começar por https://.** | O **URL** de um pedido à API não é seguro | Use um endereço que comece por `https://` |
| **A expressão cron é inválida. Use cinco campos, como 0 8 * * 1.** | A expressão cron não está correta | Veja [Segundo uma expressão cron](/automatiseringen/triggers#volgens-een-cron-expressie) |

## O que o Tillor não pode verificar de antemão [#wat-tillor-niet-vooraf-kan-controleren]

Alguns erros só se revelam quando o fluxo corre mesmo.

- Um URL composto por variáveis só pode ser verificado depois de preenchido
- Nos eventos cujos dados não estão descritos, o Tillor não verifica as variáveis
- Se um registo existe, se uma fatura pode ser enviada ou se outro servidor está acessível só se descobre durante uma execução

Um fluxo sem avisos não é, por isso, necessariamente um fluxo que tem sempre êxito. Teste-o com [Testes e execuções](/automatiseringen/testen-en-uitvoeringen) e reveja as primeiras execuções verdadeiras.

<Callout type="info" title="Um evento que desaparece">
Se mudar um evento ou um campo em que o seu fluxo se apoia, vê isso como aviso no passo em causa. Ajuste o passo antes de voltar a ativar a automação.
</Callout>


# Testes e execuções (/pt-PT/automatiseringen/testen-en-uitvoeringen)

No editor trabalha com dois separadores para verificar se um fluxo faz o que quer: **Execução de teste** para uma experiência e **Execuções** para o que realmente aconteceu. Abre-os à direita, no painel. O quarto separador, **Histórico**, mostra versões anteriores do fluxo, veja [Versões anteriores](/automatiseringen/aan-de-slag#eerdere-versies).

## Uma execução de teste [#een-testuitvoering]

Escolha o separador **Execução de teste**. Um teste percorre o fluxo com dados de exemplo e mostra que passos daria.

<Callout type="info" title="Não acontece nada de verdadeiro">
Uma execução de teste não envia nada, não cria nada e não altera nada. Os atrasos são saltados, para ver logo o resultado final. As ações só mostram o que fariam, com o texto **Não executado num teste.**
</Callout>

<DocScreenshot src="/screenshots/automatiseringen/test-run.png" alt="Separador Execução de teste com dados de exemplo e o resultado por passo" />

### Dados de exemplo [#voorbeeldgegevens]

No topo está **Testar com um registo real**. Para cada registo do acionador, como **Ocupação**, escolha um registo em **Escolher um registo** (pesquise por nome ou número). O Tillor carrega o registo tal como está agora, com os registos para que aponta, nos dados de exemplo. O teste continua a não enviar, criar nem alterar nada.

Em **Dados de exemplo do evento** estão os dados com que o teste trabalha, em formato JSON. Se a automação já tiver começado de verdade alguma vez, o teste começa com os dados da última execução verdadeira. Caso contrário, o Tillor preenche um exemplo com a forma do evento: um texto passa a *example*, um número a 1 e uma data ao momento atual.

Ajuste os valores para experimentar outros casos, por exemplo outro tipo de parcela ou uma fatura com outro estado. Se o texto não for um JSON válido, aparece **Os dados de exemplo não são um JSON válido.** e não pode iniciar o teste.

Se o fluxo contiver um **Pedido à API**, há também um campo **Exemplo de resposta da API**. Cole aí a resposta que espera do pedido. Com isso o teste pode percorrer os passos depois do pedido, e o Tillor indica os campos da resposta como variáveis. Veja [Usar uma resposta da API](/automatiseringen/variabelen#een-api-antwoord-gebruiken).

### O que acontece nestes passos [#wat-gebeurt-er-bij-deze-stappen]

Em alguns passos o resultado depende do mundo exterior: **Enviar webhook**, **Pedido à API**, ações com uma saída **Ignorado** ou **Erro**, e lógica como **Aberto agora?**, **Procurar um registo**, **Aguardar um evento** e **Pedir uma decisão**. Em **O que acontece nestes passos?** escolhe, passo a passo, por que saída o teste continua. Assim testa também o caminho para quando algo corre mal.

### O resultado [#het-resultaat]

Clique em **Executar teste**. Vê os passos por ordem, com, por passo:

- os valores preenchidos, por exemplo o título de uma tarefa tal como seria criada
- numa condição, linha a linha, o que foi comparado e se se verificou. Verde é êxito, vermelho não, com o valor que realmente lá estava (*era …*)
- por que saída o fluxo continuou (**Continua por: Sim**)
- num atraso, até quando se esperaria

Depois de executar, o botão passa a chamar-se **Executar novamente**. O teste reproduz os passos um a um (**Passo 2 de 5…**). Com **Mostrar tudo** salta essa reprodução. Na tela, o caminho que o teste seguiu fica colorido, e os passos que não chegaram a vez ficam esbatidos. Clique no nome de um passo no resultado para saltar para esse passo. Em baixo aparece **Terminou após 5 passos.**

Se o filtro em **Apenas quando** não corresponder aos seus dados de exemplo, vê **O filtro do acionador não corresponde a estes dados, por isso o fluxo não iniciaria.** Verifique então que condição está a vermelho. Com **Limpar** retira o resultado da tela.

### O que um teste não mostra [#wat-een-test-niet-laat-zien]

- Se uma fatura pode mesmo ser enviada, se um endpoint está acessível ou se um caminho da API existe
- Como os registos ficam depois de um atraso. O teste trabalha com os seus dados de exemplo e não lê nada de novo
- Erros que só surgem com dados verdadeiros, como um campo vazio

Por isso, veja sempre as primeiras execuções verdadeiras no separador **Execuções**.

## Execuções verdadeiras [#echte-uitvoeringen]

No separador **Execuções** estão as últimas 20 execuções verdadeiras desta automação, as mais recentes em cima. A lista atualiza-se sozinha aproximadamente a cada 15 segundos. Enquanto nada tiver começado, aparece **Ainda sem execuções. Ative a automação e aguarde pelo respetivo evento.**

Cada execução mostra a hora de início, o número de passos ou (em espera) quando continua, e um estado.

| Estado | O que significa |
|---|---|
| **Em execução** | A execução está a decorrer neste momento |
| **A aguardar** | A execução está num [atraso](/automatiseringen/logica#vertraging), à espera de um evento ou de uma aprovação, e continua mais tarde |
| **Concluída** | O fluxo foi percorrido até ao fim |
| **Falhou** | Um passo não pôde ser executado. O aviso aparece como **Falhou: …** |
| **Cancelada** | A execução parou porque a automação foi posta em pausa ou eliminada enquanto esperava |

Clique numa execução para a abrir. Vê então:

- todos os passos que foram feitos, com a hora e o que o passo fez
- os valores preenchidos, por exemplo o título que a tarefa realmente recebeu
- numa condição, que linhas se verificaram
- num passo falhado, a mensagem de erro, que pode estar em inglês

Na tela, o caminho que esta execução seguiu fica colorido. Os passos que não chegaram a vez ficam esbatidos. Clique no nome de um passo para saltar para esse passo.

Por baixo dos passos há um botão como **3 conjuntos de dados**. Mostra os dados com que a execução começou e o que cada ação produziu, como o ID da tarefa criada ou a resposta de um pedido à API. Assim pode verificar que valores tinha uma variável.

Em baixo, numa execução aberta, há também um **Rastreio**: um código de letras e algarismos. Se algo não estiver certo numa execução, indique esse código ao suporte. Assim encontramos exatamente esta execução.

<Callout type="info">
Os eventos que não passaram o filtro em **Apenas quando**, ou para os quais a automação já correu em **Executar uma vez por registo**, não iniciam nenhuma execução e por isso não aparecem na lista.
</Callout>

Na vista geral das automações, junto a cada automação aparece a hora da última execução, com ao lado uma barrinha por execução recente.

## O que acontece depois? [#wat-gebeurt-er-daarna]

- Depois de uma execução de teste, nada mudou no Tillor. Só quando ativa **Ativo** é que a automação corre de verdade.
- As execuções verdadeiras ficam no separador **Execuções**. Mostra as últimas 20.
- Uma execução falhada gera um e-mail para quem criou a automação, no máximo um por hora.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Os dados de exemplo não são um JSON válido">
O Tillor mostra **Os dados de exemplo não são um JSON válido.** e não deixa o teste começar. Verifique chavetas, vírgulas e aspas.
</Accordion>
<Accordion title="O filtro do acionador não corresponde a estes dados">
Com estes dados de exemplo o fluxo não iniciaria. Veja que condição está a vermelho e ajuste os dados ou a condição.
</Accordion>
<Accordion title="Não vejo execuções">
O Tillor mostra **Ainda sem execuções. Ative a automação e aguarde pelo respetivo evento.** Os eventos que não passaram o filtro não aparecem. Veja [Perguntas frequentes](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet).
</Accordion>
<Accordion title="O teste tem êxito, mas a execução verdadeira falha">
Um teste não envia nada e não lê os registos de novo. Se uma fatura pode ser enviada ou se um endereço está acessível só se descobre de verdade. Abra a execução para ver a mensagem de erro e os dados por passo. Precisa de ajuda do suporte? Indique o código de **Rastreio** da execução.
</Accordion>
</Accordions>

## Uma execução que não quer começar [#een-uitvoering-die-niet-wil-starten]

Veja [Perguntas frequentes](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet) para uma lista de verificação.


# Acionadores (/pt-PT/automatiseringen/triggers)

O acionador é o momento de arranque de uma automação: o "quando". Está no topo de cada fluxo, sob o nome **Quando isto acontece**. Um exemplo: *começar quando uma ocupação termina*. Determina também que dados os passos seguintes podem usar. Um fluxo pode ter vários acionadores. Cada acionador inicia uma execução própria, com o seu próprio filtro. Adiciona um a partir da lista à esquerda. O último acionador não pode ser eliminado.

<DocScreenshot src="/screenshots/automatiseringen/trigger-settings.png" alt="Acionador selecionado com os campos Começa por e Evento, o filtro Apenas quando e os dados que o evento fornece" />

## Em que é que a automação começa [#waar-start-de-automatisering-op]

Em **Começa por** escolhe um de sete momentos de arranque.

| Escolha | Começa quando |
|---|---|
| **Quando algo acontece** | Ocorre um evento no Tillor, como uma ocupação que termina ou uma fatura que é paga |
| **Fatura vencida** | Uma fatura lançada continua em aberto depois da data de vencimento |
| **Webhook recebido** | Outro sistema envia uma mensagem para o endereço próprio da automação |
| **É escolhida uma ação de tarefa** | Alguém escolhe, numa tarefa, um botão de escolha ligado a esta automação |
| **Uma data é atingida** | É atingida uma data de um registo, eventualmente algum tempo antes ou depois. Por exemplo, um dia antes da chegada de uma reserva |
| **Todos os dias a uma hora** | Chega, todos os dias, a hora escolhida |
| **Segundo uma expressão cron** | Chega a vez do calendário que indicar |

Escolhe, portanto, primeiro o tipo de momento de arranque e depois os detalhes. Se escolher outro momento de arranque, os filtros em **Apenas quando** são esvaziados. Foram escritos para a escolha anterior e já não servem.

## Quando algo acontece [#als-er-iets-gebeurt]

Em **Evento** escolha o que deve iniciar a automação. Clique no campo e escreva para pesquisar, por exemplo *occupation* ou *invoice*. Os eventos aparecem na notação do Tillor, como `occupation:ended`: primeiro aquilo de que se trata, depois o que aconteceu.

Estes são os eventos de que precisa com mais frequência:

| Evento | Começa quando |
|---|---|
| `occupation:ended` | Uma ocupação termina |
| `reservation:created` | É criada uma reserva |
| `reservation:updated` | Uma reserva é alterada |
| `customer:created` | É criado um cliente |
| `customer:updated` | Um cliente é alterado |
| `invoice:created` | É criada uma fatura |
| `invoice:updated` | Uma fatura é alterada |
| `invoice:paid` | Uma fatura é paga |
| `payment:created` | Entra um pagamento |
| `task:created` | É criada uma tarefa |
| `task:status-changed` | O estado de uma tarefa muda |
| `task:assigned` | Uma tarefa é atribuída a alguém |
| `task:action-chosen` | Alguém escolhe um botão de escolha numa tarefa |
| `integration-alarm:created` | Um contador emite um alarme |
| `comment:created` | É publicado um comentário |
| `document:created` | É adicionado um documento |
| `signatureRequest:updated` | Um pedido de assinatura é atualizado |
| `signatureRequest:completed` | Todos os signatários de um pedido de assinatura assinaram |
| `mandate-agreement:signed` | Um cliente assinou um mandato SEPA |
| `mandate-agreement:activated` | Um mandato SEPA ficou ativo |
| `mandate-agreement:expired` | Um pedido de mandato SEPA expirou sem assinatura |
| `mandate-agreement:failed` | A ativação de um mandato SEPA foi recusada ou falhou |
| `productPriceChange:applied` | Entra em vigor um [preço de produto agendado](/producten/prijzen-plannen) |

Esta é a mesma lista dos [webhooks](/ontwikkelaars/events). Pode, por isso, usar qualquer evento para o qual o Tillor possa enviar um webhook. Alguns eventos extremamente frequentes, como o estado físico das cancelas, a escrita na caixa de entrada, os registos dos controladores e a presença de veículos, não estão na lista.

<Callout type="info" title="Falta um evento?">
Sob o campo **Evento** está a ligação **Falta um evento? Peça-o**. Veja [Pedir um passo ou evento](/automatiseringen/aan-de-slag#een-stap-of-gebeurtenis-aanvragen).
</Callout>

### Que dados recebe [#welke-gegevens-krijg-je-mee]

À maioria dos eventos corresponde um registo, como uma ocupação, uma fatura ou uma tarefa. Esse registo, mais os registos para que remete, ficam depois disponíveis como variáveis nos passos. Em `occupation:ended` pode usar, por exemplo:

- `{occupation.terrain.name}` para o nome do terreno
- `{occupation.customer.firstName}` para o nome próprio do cliente
- `{occupation.reservation.displayId}` para o número da reserva. Nem toda a ocupação tem uma reserva: nesse caso fica vazio

Além disso, existem sempre `{triggeredBy.name}` e `{triggeredBy.id}`: o colega que causou o evento. Se o evento foi causado pelo sistema, por exemplo por uma sincronização bancária, estes campos ficam vazios.

Sob as definições do acionador está **Dados que este evento fornece**. Aí vê exatamente que variáveis pode usar. Num evento cujos dados não estão descritos, o Tillor diz que não há nada para escolher. As variáveis que escrever você mesmo continuam a funcionar. Veja [Variáveis e modelos](/automatiseringen/variabelen).

## É escolhida uma ação de tarefa [#er-wordt-een-taakactie-gekozen]

Algumas tarefas têm botões de escolha em vez de uma marca de verificação, por exemplo a partir de [Pedir uma decisão](/automatiseringen/logica#vraag-om-een-beslissing). Um botão pode estar ligado a uma automação. Com este acionador, essa automação começa assim que alguém escolhe esse botão. Veja também [Tarefas com botões de escolha](/taken/taakdetails#taken-met-keuzeknoppen).

Ligar um botão a uma automação não se faz no editor de fluxos. Se precisar disto, peça ao administrador do Tillor ou ao suporte.

Os passos recebem os dados da tarefa, por exemplo `{task.name}` e `{task.id}`, mais `{action.label}` (o nome do botão escolhido) e `{note}` (a nota que o colega preencheu, se o botão a pedia). Em **Dados que este evento fornece** vê a lista completa.

## Fatura vencida [#factuur-is-vervallen]

Este acionador começa para cada fatura que:

- está lançada (rascunhos e faturas anuladas não contam)
- não é uma nota de crédito
- ainda tem um montante em aberto
- tem uma data de vencimento anterior a hoje

Para cada uma dessas faturas começa uma execução própria. Os dados da fatura e do cliente estão disponíveis como `{invoice.…}`, por exemplo `{invoice.displayId}`, `{invoice.amountOutstanding}` e `{invoice.customer.firstName}`.

Se desativar **Executar uma vez por registo**, a automação começa para a mesma fatura no máximo uma vez por dia enquanto estiver vencida. Se o deixar ativo, começa exatamente uma vez para cada fatura. É normalmente o que quer para um lembrete.

Em **A lembrar** escolhe há quanto tempo a fatura tem de estar em aberto, a mesma regra da lista de faturas. Ative **Ignorar clientes excluídos de avisos automáticos** para saltar os clientes que o têm indicado nas suas definições de faturação. Uma fatura que foi ela própria retirada dos lembretes automáticos também não inicia o fluxo.

## Webhook recebido [#inkomende-webhook]

Um webhook é uma mensagem que outro sistema envia para um endereço. Com este acionador, esse sistema inicia a automação, por exemplo o seu site, um formulário ou uma plataforma de reservas. Cada automação recebe um endereço próprio e secreto.

1. Em **Começa por** escolha **Webhook recebido**
2. Guarde a automação. Em **Endereço** aparece o URL
3. Clique em **Copiar** e configure o endereço no outro sistema
4. Ative a automação

O outro sistema envia um `POST` com JSON para esse endereço. O conteúdo fica depois disponível como `{body.…}`, por exemplo `{body.email}` ou `{body.reservering.nummer}`, e os parâmetros no URL como `{query.…}`. Com **Apenas quando** também pode filtrar por esses campos.

Como funciona, em mais pormenor:

- O endereço é o segredo. Quem o conhecer pode iniciar a automação. Partilhe-o, por isso, apenas com o sistema que dele precisa
- Se o endereço vazar, clique em **Novo endereço** e guarde. O endereço antigo deixa de funcionar a partir daí
- Uma automação desativada ou um endereço errado dá um erro `404`
- O conteúdo pode ter no máximo 100 KB
- Cada chamada inicia uma execução por acionador de webhook no fluxo. O endereço pertence ao primeiro acionador de webhook. **Novo endereço** nesse acionador substitui-o
- Não há nenhum registo associado, pelo que **Executar uma vez por registo** não tem efeito

### Ignorar repetições [#herhalingen-negeren]

Se o outro sistema enviar por vezes a mesma chamada duas vezes, com **Ignorar repetições** evita que o fluxo comece duas vezes. O Tillor memoriza uma chave da chamada. Se a mesma chave chegar de novo, não começa nada.

| Escolha | O que é a chave |
|---|---|
| **Cada chamada inicia o fluxo** | Não há chave. Predefinição |
| **De um cabeçalho** | O valor de um cabeçalho que escolhe em **Nome do cabeçalho**, por exemplo `Idempotency-Key` |
| **Do corpo JSON** | O valor de um campo do JSON, que escolhe em **Campo**, como `id` ou `data.eventId` |
| **O mesmo corpo JSON** | Todo o conteúdo. Uma chamada com exatamente o mesmo conteúdo conta como repetição |

Em **Memorizar a chave durante** escolhe durante quanto tempo a chave vale, em horas, dias ou semanas. Passado esse tempo, a mesma chave inicia o fluxo de novo. Com 0, a chave vale até eliminar a automação. Uma chamada sem o cabeçalho escolhido ou sem o campo escolhido é recusada.

## Uma data é atingida [#een-datum-is-bereikt]

Este acionador começa numa data de um registo. Em **Data** escolhe qualquer campo de data de um registo que o Tillor também envia nos eventos, escrito como registo e campo. Alguns exemplos:

| Data | Registo |
|---|---|
| `reservation.checkIn` | A data de chegada de uma reserva |
| `reservation.checkOut` | A data de partida de uma reserva |
| `invoice.dueDate` | A data de vencimento de uma fatura |
| `task.dueDate` | O prazo de uma tarefa |
| `occupation.paidUntil` | Até quando uma ocupação está paga |
| `accessMethod.periodTo` | O fim da validade de um código QR, matrícula ou outro método de acesso |
| `nfcTag.activatedUntil` | Até quando uma etiqueta NFC está ativada |
| `mandateAgreement.expiresAt` | Quando expira um pedido para assinar um mandato SEPA |
| `customer.birthday` | A data de nascimento de um cliente |
| `contact.birthday` | A data de nascimento de uma pessoa de contacto |

Por predefinição o acionador começa uma vez, na própria data. Ative **Repetir todos os anos** para que contem apenas o dia e o mês: o fluxo começa então todos os anos de novo, como no aniversário em `contact.birthday`. Um 29 de fevereiro cai, nos outros anos, a 28 de fevereiro.

Também pode escolher dados guardados num registo como campos adicionais. `document.userMetadata.insuranceExpiryDate` é a data de validade de um documento, como um comprovativo de pagamento do seguro. Uma data dessas, sem hora, conta como meia-noite (UTC, a hora padrão internacional). Com **Apenas quando** limita então o acionador a um tipo, por exemplo `document.userMetadata.documentType` é `INSURANCE_PAYMENT_PROOF`, e a documentos ativos com `document.status` é `ACTIVE`.

Com **Quanto tempo** e **Antes ou depois** desloca o momento. *1 dia* e **Antes** em `reservation.checkIn` inicia o fluxo um dia antes da chegada. Com 0 começa na própria data. Uma data sem hora conta como meia-noite.

Com **Hora** escolhe a que horas desse dia o fluxo começa. **A hora da data** usa o momento que está no campo, como a hora de chegada de uma reserva. **Hora fixa do dia** começa no dia da data à hora e ao minuto que escolher, no fuso horário da sua organização. Assim, `contact.birthday` com **Repetir todos os anos** começa todos os anos às 09:00 no dia do aniversário. **Quanto tempo** conta então a partir dessa hora: *1 dia* e **Antes** começa na véspera às 09:00, mesmo que o relógio mude nessa noite.

Para cada registo começa uma execução própria, com os dados desse registo como variáveis, por exemplo `{reservation.displayId}` e `{reservation.customer.firstName}`. Com **Apenas quando** restringe-o, por exemplo apenas a reservas com o estado lançada.

Como funciona, em mais pormenor:

- Por registo e por momento, o fluxo começa uma vez. Se a data se deslocar para mais tarde, por exemplo porque um hóspede chega mais tarde, começa de novo no novo momento
- Se o momento já tinha passado quando guardou ou ativou a automação, esta já não começa para ele
- Os momentos perdidos, por exemplo durante uma manutenção, o Tillor recupera-os até uma hora depois

## Todos os dias a uma hora [#elke-dag-op-een-uur]

Em **Hora** escolha uma hora (0 a 23) e em **Minuto** um minuto de 0 a 59. A hora é a do fuso horário da sua organização.

Os passos recebem `{now}`: o momento em que a execução começou.

## Segundo uma expressão cron [#volgens-een-cron-expressie]

Escolha um ritmo, como todos os dias, todas as segundas-feiras às 08:00, ou as segundas-feiras ímpares (a 1.ª, a 3.ª e a 5.ª). Em **Personalizado** define o intervalo, os dias da semana e a hora, ao minuto. Em **Expressão cron** escreve você mesmo o calendário.

Uma expressão cron é uma notação curta para uma hora repetida. Tem cinco partes, separadas por um espaço: **minuto**, **hora**, **dia do mês**, **mês** e **dia da semana**.

| Expressão | Significado |
|---|---|
| `0 8 * * 1` | Todas as segundas-feiras às 08:00 |
| `7 8 * * 1` | Todas as segundas-feiras às 08:07 |
| `30 7 * * 1-5` | Todos os dias úteis às 07:30 |
| `0 9 1 * *` | No dia 1 de cada mês às 09:00 |
| `0 8 * * 1#1,1#3,1#5` | Todas as segundas-feiras ímpares (1.ª, 3.ª e 5.ª do mês) às 08:00 |
| `0 8 * * 1L` | A última segunda-feira do mês às 08:00 |
| `0 8 * * 1 W2:2026-10-05` | De duas em duas semanas, à segunda-feira, às 08:00, a partir da semana de 5 de outubro de 2026 |
| `*/15 * * * *` | A cada quarto de hora |
| `* * * * *` | A cada minuto |

Em cada parte pode usar um número, uma lista com vírgulas (`8,17`), um intervalo (`1-5`), um passo (`*/15`) ou um asterisco (`*`, qualquer valor). O dia da semana 0 e 7 são ambos domingo. `1#2` é a segunda segunda-feira, `1L` a última. Um sexto campo `W2:2026-10-05` repete de duas em duas semanas, contadas a partir dessa semana. Nomes como *MON* ou *JAN* não funcionam. Se preencher tanto um dia do mês como um dia da semana, a automação começa num dos dois.

Se a expressão for inválida, o Tillor indica-o no acionador. As horas valem no fuso horário da sua organização.

## A que horas começa exatamente um calendário [#hoe-laat-start-een-schema-precies]

<Callout type="warn" title="Um calendário começa no minuto em que chega a sua vez">
O Tillor verifica a cada minuto que calendários chegaram à sua vez. Uma automação que deve começar às 08:07 começa nesse minuto. Isto vale para **Fatura vencida**, **Uma data é atingida**, **Todos os dias a uma hora** e **Segundo uma expressão cron**.
</Callout>

Por minuto, um calendário começa no máximo uma vez. Uma verificação que só corre no minuto seguinte não recupera o minuto anterior.

Os eventos começam de imediato, sem este atraso.

## Apenas quando [#alleen-wanneer]

Com **Apenas quando** só deixa a automação começar se os dados corresponderem. Assim começa, por exemplo, apenas para caravanas fixas, ou apenas para faturas acima de um montante. Deixe vazio para começar em cada evento deste tipo.

1. Clique em **Adicionar condição**
2. Escolha o campo com o botão **Variável** (ou escreva o caminho, por exemplo `invoice.status`)
3. Escolha como comparar
4. Preencha o valor. Em campos com uma escolha fixa, como um estado, um tipo de terreno ou um colega, escolhe numa lista

Pode usar as seguintes comparações:

| Escolha | Verifica-se quando |
|---|---|
| **é** | O campo é igual ao valor |
| **não é** | O campo não é igual ao valor |
| **contém** | O valor aparece algures no campo |
| **é maior que** | O campo é maior do que o valor (em números e datas) |
| **é menor que** | O campo é menor do que o valor (em números e datas) |
| **é um de** | O campo é igual a um dos valores escolhidos |
| **está vazio** | O campo está vazio |
| **não está vazio** | O campo não está vazio |

As maiúsculas não importam. Os números são comparados como números, pelo que 10 é maior que 9.

Se tiver mais do que uma condição, escolhe como colaboram: **Todas têm de corresponder** ou **Basta uma corresponder**.

<Callout type="info">
Os eventos retidos pelo filtro não iniciam nenhuma execução e, por isso, também não deixam rasto no separador **Execuções**. Se quiser ver se o seu filtro está certo, use **Testar**: aí vê, por condição, se se verificou.
</Callout>

## Executar uma vez por registo [#eén-keer-per-record-uitvoeren]

Com **Executar uma vez por registo** a automação começa no máximo uma vez por fatura, reserva ou outro registo, por muitas vezes que o evento ocorra para ele.

É especialmente útil em eventos que se repetem muito, como `invoice:updated`: uma fatura é alterada dezenas de vezes, mas só quer enviar um lembrete. O Tillor memoriza, por registo, que a automação já começou. Essa memória desaparece se eliminar a automação.

Só funciona em eventos a que corresponde um registo, e em **Fatura vencida** e **Uma data é atingida**. Em **Uma data é atingida** significa: mesmo que a data se desloque mais tarde, o fluxo não volta a começar. Num calendário como **Todos os dias a uma hora** não tem efeito.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- Sempre que o momento de arranque ocorre e o filtro se verifica, começa uma execução com os dados desse momento como variáveis.
- Um evento começa de imediato. Uma data, hora ou calendário começa no minuto em que chega a sua vez.
- Se o filtro não corresponder, não começa nada e não fica rasto no separador **Execuções**.

## Problemas? [#problemen]

<Accordions>
<Accordion title="A automação não começa no meu evento">
Verifique se a automação está ligada, se escolheu o **Evento** certo e se o filtro em **Apenas quando** não é demasiado restrito. Teste com os dados de um caso real no separador **Execução de teste**. Mais em [Perguntas frequentes](/automatiseringen/veelgestelde-vragen#waarom-start-mijn-automatisering-niet).
</Accordion>
<Accordion title="O Tillor diz A expressão cron é inválida">
Use cinco campos separados por um espaço, como `0 8 * * 1`. Nomes como *MON* não funcionam.
</Accordion>
<Accordion title="Um webhook recebido dá um erro 404">
A automação está desligada ou o endereço não está certo. Ative a automação e copie o endereço de novo.
</Accordion>
<Accordion title="O meu filtro desapareceu quando escolhi outro momento de arranque">
Num outro momento de arranque, os filtros em **Apenas quando** são esvaziados, porque foram escritos para o momento de arranque anterior. Adicione-os de novo.
</Accordion>
<Accordion title="O fluxo não começa de novo para a mesma fatura">
**Executar uma vez por registo** está ativo. Nesse caso começa no máximo uma vez por fatura, reserva ou outro registo.
</Accordion>
</Accordions>

## Ler mais [#meer-lezen]

<Cards>
  <Card
    title="Condições, desvios e atrasos"
    href="/automatiseringen/logica"
    description="Fazer o fluxo dividir-se e esperar"
  />
  <Card
    title="Variáveis e modelos"
    href="/automatiseringen/variabelen"
    description="Usar nos seus passos os dados do evento"
  />
</Cards>


# Variáveis e modelos (/pt-PT/automatiseringen/variabelen)

Com variáveis cria textos que mudam consoante o caso. Escreve uma variável entre chavetas e o Tillor preenche o valor real quando a automação corre.

Um exemplo de título de tarefa:

```text
Controleer {occupation.terrain.name}
```

Se a ocupação terminar no terreno 12, a tarefa chama-se *Controleer 12*.

## Inserir uma variável [#een-variabele-invoegen]

Acima de cada campo de texto onde as variáveis funcionam está o botão **Variável**. Clique nele e vê uma lista com todos os dados disponíveis, agrupados por registo. Escreva para pesquisar (**Pesquisar variáveis**) e clique numa linha. O Tillor coloca a variável na posição do cursor.

<DocScreenshot src="/screenshots/automatiseringen/variables-picker.png" alt="Botão Variável no campo Título com a lista das variáveis disponíveis aberta" />

Também pode simplesmente escrever uma variável você mesmo. Sob o campo, uma caixa cinzenta mostra o aspeto do texto com dados de exemplo, para ver logo se está certo.

As variáveis funcionam em campos de texto como títulos, descrições, subtarefas, mensagens, o ID de um cliente, fatura ou outro registo, o caminho ou o URL de um pedido à API, o corpo, o payload de um webhook, o nome do evento do webhook e os valores dos cabeçalhos. Nos dois últimos falta o botão **Variável**, mas uma variável que escreva você mesmo é preenchida na mesma. O Tillor não verifica erros nesses dois campos e não mostra um exemplo.

Nos campos em que escolhe um dado para comparar, escreve a variável sem chavetas. Isto aplica-se a **Apenas quando**, **Se / senão** e **Até** em **Aguardar até** (por exemplo `invoice.status`), ao **Campo** de um **Desvio** e à **Data** de um **Atraso**.

## Que variáveis existem [#welke-variabelen-zijn-er]

| Variável | Disponível | Conteúdo |
|---|---|---|
| `{occupation.…}`, `{invoice.…}`, `{task.…}`, `{reservation.…}` e outras | Após um evento | Os campos do registo a que o evento diz respeito. O nome do registo é também o início da variável |
| `{occupation.terrain.name}` | Após um evento | Campos dos registos para que o registo remete, como o cliente ou o terreno. Funciona um nível em profundidade |
| `{triggeredBy.name}`, `{triggeredBy.id}` | Sempre | O colega que causou o evento. Vazio se foi o sistema |
| `{invoice.…}` | Em **Fatura vencida** | Os campos da fatura vencida e do cliente |
| `{reservation.…}`, `{task.…}` e outras | Em **Uma data é atingida** | Os campos do registo cuja data foi atingida, mais os registos para que remete |
| `{now}`, `{today}` | Sempre | O momento em que o passo corre, e a meia-noite desse dia no fuso horário da organização. Com um deslocamento (abaixo), `{today + 1 day}` dá amanhã |
| `{threadId}`, `{messageId}` | Em eventos sobre mensagens da caixa de entrada, como `inbox:message-created` | O ID da conversa e da mensagem |
| Os campos do evento | Após **Aguardar um evento**, através de **Recebido** | Os dados do evento que se esperava. Substituem os dados dos mesmos registos do início do fluxo |
| `{createdTask.id}`, `{createdTask.name}` | Após **Criar tarefa** | A tarefa que acabou de ser criada |
| `{foundTask.id}`, `{foundTask.name}`, `{foundTask.priority}`, `{foundTask.status}` | Após **Procurar tarefa**, através de **Encontrada** | A tarefa que o passo encontrou |
| `{updatedTask.id}`, `{updatedTask.status}` | Após **Definir estado** | A tarefa cujo estado foi alterado |
| `{updatedTask.id}`, `{updatedTask.priority}` | Após **Definir prioridade da tarefa** | A tarefa cuja prioridade foi alterada |
| `{updatedTask.id}` | Após **Atualizar tarefa** | A tarefa que foi modificada |
| `{foundDocument.id}`, `{foundDocument.name}`, `{foundDocument.status}`, `{foundDocument.userMetadata.documentType}`, `{foundDocument.userMetadata.insuranceExpiryDate}` | Após **Encontrar documento**, através de **Encontrada** | O documento que o passo encontrou |
| `{updatedDocument.id}` | Após **Atualizar documento** | O documento que foi modificado |
| `{response.status}`, `{response.body}`, `{response.data.…}` | Após **Pedido à API** | A resposta do pedido |
| `{foundCustomer.…}`, `{foundInvoice.…}`, `{foundReservation.…}` e outras | Após **Procurar um registo**, através de **Encontrada** | Os campos do registo que o passo encontrou, mais os registos para que remete. O nome é `found` mais o tipo de registo: `foundCustomer`, `foundReservation`, `foundOccupation`, `foundInvoice`, `foundPayment`, `foundTerrain`, `foundTask`, `foundDocument`, `foundAccessMethod`, `foundNfcTag`, `foundMeter`, `foundInboxThread` ou `foundInboxMessage` |
| `{body.…}`, `{query.…}`, `{receivedAt}` | Após **Webhook recebido** | O corpo JSON, os parâmetros de consulta e o momento de receção da chamada do webhook |
| Cada nome de destino de **Mapear variáveis** | Após **Mapear variáveis** | O que preencher nesse passo como destino, por exemplo `{invoice.displayId}` após `invoice` ← `{foundInvoice}` |
| `{item.…}` | Nos passos a seguir a **Para cada** | Os campos do item para o qual o passo está a correr, como `{item.id}` |
| `{approvalTask.id}`, `{approval.decision}`, `{approval.label}`, `{approval.note}`, `{approval.decidedBy.name}` | Após **Pedir uma decisão**, através de uma opção | A tarefa, a opção escolhida, o nome dessa opção, a nota e o colega que escolheu |
| `{task.…}`, `{action.label}`, `{note}` | Em **É escolhida uma ação de tarefa** | A tarefa, o botão escolhido e a nota que lhe foi preenchida |
| `{createdComment.id}` | Após **Adicionar um comentário** | O comentário que acabou de ser publicado |
| `{bookedInvoice.displayId}` | Após **Lançar fatura**, através de **Concluído** | O número da fatura lançada |
| `{paymentLink.url}` | Após **Criar link de pagamento**, através de **Concluído** | A ligação com que o cliente pode pagar online |
| `{consumptionInvoice.id}` | Após **Faturar consumo**, através de **Concluído** | A fatura do consumo do contador |
| `{extendInvoice.id}` | Após **Rascunho de fatura de prolongamento** | O rascunho de fatura que prolonga a ocupação |
| `{createdAccessMethod.id}`, `{createdAccessMethod.value}` | Após **Criar método de acesso** | O novo método de acesso e o seu valor, como o código de um código QR ou PIN |
| `{error.message}`, `{error.step}` | Após uma ação com **Continuar quando este passo falha**, através de **Erro** | A mensagem de erro e o nome do passo que falhou |

Que campos tem exatamente um registo, vê na lista atrás do botão **Variável**. No acionador existe também o resumo **Dados que este evento fornece**.

### Apenas o que vem antes no fluxo [#alleen-wat-eerder-in-de-flow-komt]

Um passo só pode usar variáveis do acionador que o alcança e de passos que estão antes no mesmo caminho. Se vários acionadores alcançarem o mesmo passo, só estão disponíveis as variáveis que cada um desses acionadores fornece. Um campo de um passo anterior conta se cada um desses acionadores também passar por esse passo. Se usar uma variável que não existe nesse ponto, o Tillor indica **[Campo]: [variável] não está disponível neste passo.** Um fluxo com uma indicação destas não pode ser ativado.

Alguns registos guardam dados adicionais num só campo, como os dados do documento em `userMetadata`. Cada chave abaixo dele é uma variável: `{document.userMetadata.documentType}`, `{document.userMetadata.insuranceExpiryDate}` ou outra chave. As chaves conhecidas, como o tipo e a data de validade de um documento, estão também na lista e pode compará-las como data. Uma data sem hora, como `2026-10-07`, aparece numa mensagem como `07-10-2026`.

As variáveis de **Para cada** (`{item.…}`) só existem nos passos a seguir à saída **Para cada**, não a seguir a **Concluído**. As variáveis de uma saída que não seguiu também não existem: `{paymentLink.url}` só existe se o passo correu por **Concluído**, e `{foundTask.id}` só após **Encontrada**.

Em eventos cujos dados não estão descritos, o Tillor não consegue verificar que variáveis existem. Então não recebe essa indicação. Verifique por isso estes fluxos com especial cuidado através de uma execução de teste.

### Um novo valor substitui o antigo [#een-nieuwe-waarde-vervangt-de-oude]

Um segundo **Pedido à API** no mesmo fluxo substitui a `response` do primeiro. O mesmo vale para `createdTask` após uma segunda **Criar tarefa**, para `foundTask` após uma segunda **Procurar tarefa** ou **Procurar um registo** em **Tarefa**, e para `error` após um segundo passo falhado. Use por isso os dados de uma resposta no passo que vem imediatamente a seguir.

## Como os valores são preenchidos [#hoe-waarden-worden-ingevuld]

O Tillor adapta a notação ao tipo de campo.

**Em texto simples** (títulos, descrições, subtarefas):

- As datas aparecem no fuso horário da sua organização, por exemplo `05-10-2026`. Se a hora não for exatamente meia-noite, aparece também uma hora, como `05-10-2026 14:30`
- Um campo vazio dá um texto vazio
- Uma variável que o Tillor não conhece fica como a escreveu, por exemplo `{occupation.terain.name}`. Um erro de escrita nota-se assim logo na tarefa ou na mensagem
- Se um registo associado não existir, a variável fica vazia. Uma ocupação sem reserva não dá, portanto, nada para `{occupation.reservation.displayId}`, e um evento causado pelo sistema não dá nada para `{triggeredBy.name}`. Se nesse caso quiser outro texto, coloque antes um **Se / senão** com **está vazio**

**Em JSON** (o **Payload** de um webhook e o **Corpo** de um pedido à API):

- O texto é preenchido em segurança. Aspas, novas linhas e outros carateres especiais no valor não podem quebrar o JSON
- Números e valores sim/não vão sem aspas, pelo que não coloca aspas à volta. O texto, esse, coloca entre aspas
- As datas seguem como data e hora internacionais, como `2026-10-05T08:00:00.000Z`, para que o sistema recetor as trate bem

```json
{
  "reservation": "{reservation.displayId}",
  "adults": {reservation.numberOfAdults}
}
```

Se o JSON não for válido após o preenchimento, por exemplo porque um número está vazio, a execução para com uma mensagem de erro.

**Num caminho ou URL** (num pedido à API):

- Os valores são convertidos para caberem num endereço. Um nome com um espaço não dá, por isso, um endereço quebrado
- As datas também aqui seguem como data e hora internacionais
- O que escreve você mesmo fica como o escreve. Se quiser um espaço num termo de pesquisa, escreva você mesmo `%20`

## Deslocar uma data [#een-datum-verschuiven]

Depois de uma variável de data pode vir um deslocamento: `{reservation.checkOut + 1 day}`, `{today - 2 weeks}`, `{invoice.dueDate + 3 hours|date}`. As unidades são `minutes`, `hours`, `days`, `weeks` e `months` (o singular também é aceite). Dias e semanas têm comprimentos fixos, de modo que uma validade atravessa a hora de verão e de inverno com a mesma duração; os meses seguem o calendário, pelo que 31 de janeiro mais um mês é 28 ou 29 de fevereiro. Num valor que não é uma data, o deslocamento não faz nada, e uma unidade que não existe é um erro no passo. Campos de data como **Válido até** aceitam a mesma notação.

## Formatar um valor [#een-waarde-opmaken]

Depois da variável coloque um `|` e um formato, por exemplo `{invoice.amountOutstanding|currency}`. Sem formato, um montante aparece em bruto, como `1295.3`. Com `|currency` passa a `€ 1.295,30`.

| Formato | Exemplo | Resultado |
|--------|-----------|-----------|
| `currency` | `{invoice.amountOutstanding\|currency}` | `€ 1.295,30` |
| `currency:USD` | `{invoice.amountOutstanding\|currency:USD}` | `US$ 1.295,30` |
| `number` | `{invoice.amountOutstanding\|number}` | `1.295,3` |
| `number:2` | `{invoice.amountOutstanding\|number:2}` | `1.295,30` (número fixo de casas decimais) |
| `date` | `{invoice.dueDate\|date}` | `30-06-2026` |
| `datetime` | `{invoice.createdAt\|datetime}` | `01-06-2026 16:04` |
| `time` | `{invoice.createdAt\|time}` | `16:04` |
| `upper` / `lower` | `{customer.lastName\|upper}` | `VAN DEN BROECKE` |

- Números e montantes aparecem sempre na notação belga: um ponto para os milhares e uma vírgula para os decimais
- Datas e horas aparecem no fuso horário da sua organização
- Se o formato não conseguir ler o valor, por exemplo `|currency` em texto, o valor aparece simplesmente sem formato
- Um formato que o Tillor não conhece fica como o escreveu, e o editor mostra um aviso sobre isso
- Em JSON e num URL, o valor formatado é preenchido como texto. Em JSON, coloque por isso aspas à volta

## Usar uma resposta da API [#een-api-antwoord-gebruiken]

Após um [Pedido à API](/automatiseringen/acties/integraties#api-verzoek) pode usar campos da resposta com `{response.data.…}`. A resposta a uma pesquisa de tarefas tem, por exemplo, este aspeto:

```json
{
  "items": [
    { "id": "task_1", "priority": "LOW" }
  ]
}
```

Então `{response.data.items.0.id}` dá o ID da primeira tarefa (o primeiro de uma lista é o número 0) e `{response.data.items.0.priority}` a sua prioridade.

O Tillor só pode oferecer os campos de uma resposta como variável se souber o aspeto da resposta. Há duas maneiras:

- Deixe a automação correr uma vez a sério. O Tillor usa então a resposta da última execução
- Cole um exemplo no separador **Execução de teste**, no campo **Exemplo de resposta da API**. Esse campo aparece assim que o fluxo contém um **Pedido à API**. Por baixo estão **Campos nesta resposta**. Clique num campo para o copiar, incluindo as chavetas

Depois os campos estão na lista atrás do botão **Variável** e na lista de **Campo** de um **Desvio**.

Se escrever você mesmo um caminho sob `response.data`, é sempre aceite, mesmo sem exemplo. Além disso:

- `{response.body}` contém os primeiros 4000 carateres da resposta. Se a resposta for mais longa, o resto é cortado
- `{response.data}` fica vazio se a resposta não for JSON, ou se a resposta for muito grande (mais de 100 000 carateres)
- Numa pesquisa sem resultado, `{response.data.items.0.id}` não existe. Um **Desvio** nesse campo segue então por **Predefinição**

<Callout type="info" title="Um exemplo no teste">
No separador **Execução de teste** preenche também os dados de exemplo do evento. Assim vê, na execução de teste, que valores o Tillor preencheria. Veja [Testes e execuções](/automatiseringen/testen-en-uitvoeringen).
</Callout>

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- Assim que a automação corre, o Tillor substitui cada variável pelo valor real. Uma variável que o Tillor não conhece fica como a escreveu.
- Se um dado estiver vazio, o espaço fica vazio. Se então quiser outro texto, coloque antes um **Se / senão** com **está vazio**.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Vejo {occupation.terain.name} na minha tarefa">
Uma variável que o Tillor não conhece fica literalmente como está. Normalmente há um erro de escrita. Escolha a variável através do botão **Variável**.
</Accordion>
<Accordion title="O Tillor diz que uma variável não está disponível neste passo">
Está a usar um dado que ainda não existe neste ponto do fluxo, por exemplo de um passo que vem mais tarde ou de uma saída que não seguiu. Coloque o passo que fornece o dado mais cedo no fluxo. Enquanto a indicação estiver lá, não pode ativar a automação.
</Accordion>
<Accordion title="O JSON não está certo depois de preenchido">
Um número que está vazio torna o JSON inválido. O texto coloca-se entre aspas, os números não. Verifique os campos com uma execução de teste.
</Accordion>
<Accordion title="Não vejo na lista os campos de uma resposta da API">
O Tillor ainda não conhece a forma da resposta. Deixe a automação correr uma vez a sério, ou cole um exemplo em **Exemplo de resposta da API** no separador **Execução de teste**.
</Accordion>
</Accordions>


# Perguntas frequentes (/pt-PT/automatiseringen/veelgestelde-vragen)

## Quem pode usar automações? [#wie-kan-automatiseringen-gebruiken]

Quem tem **Ver automatizações** vê as automações e as suas execuções. Quem tem **Gerir automatizações** pode também criá-las, alterá-las, ativá-las e eliminá-las. Os administradores com **Todas as permissões** podem tudo. Atribui estas permissões nos membros da sua organização.

Atenção a **Gerir automatizações**: uma automação funciona com todas as permissões da sua organização. Quem pode construir fluxos pode, por isso, fazer tudo através de um fluxo. Atribua-o apenas a pessoas em quem confia para isso. Quem não tem nenhuma das duas permissões não vê o item de menu **Administrador > Automações**.

## Porque é que a minha automação não começa? [#waarom-start-mijn-automatisering-niet]

Percorra estes pontos.

1. **Está ligada?** Uma automação com o interruptor desligado (filtro **Em pausa**) não começa. Se houver problemas, não a pôde ativar. Veja [Problemas e ativação](/automatiseringen/problemen)
2. **É o evento certo?** Uma nova reserva é `reservation:created`, uma alteração `reservation:updated`. Verifique também se o evento ocorre mesmo com a ação que faz
3. **O filtro está a retê-la?** Os eventos que não passam o filtro em **Apenas quando** não deixam nenhuma execução. Use o separador **Execução de teste** com os dados de um caso real para ver que condição não se verifica. Atenção aos valores dos campos de escolha: um estado de fatura é, por exemplo, `BOOKED`
4. **Está ativo Executar uma vez por registo?** Nesse caso a automação não volta a começar para uma fatura ou reserva para a qual já correu. Veja [Executar uma vez por registo](/automatiseringen/triggers#eén-keer-per-record-uitvoeren)
5. **É um calendário?** Então começa no minuto em que chega a sua vez. Uma hora fixa e um calendário usam o fuso horário da sua organização
6. **Acabou de a ativar ou alterar?** Pode demorar meio minuto até tudo o notar
7. **Chegam muitos eventos ao mesmo tempo?** Então as execuções são tratadas uma a uma e pode demorar um pouco até chegar a vez da sua

Se a automação começar mas depois algo correr mal, veja no separador **Execuções** o que aconteceu e onde a execução ficou presa.

## Porque é que o meu calendário começa tarde? [#waarom-start-mijn-schema-te-laat]

Os calendários são verificados a cada minuto. Uma automação que começa numa data, numa hora ou segundo um calendário arranca nesse minuto. Um evento começa de imediato.

## Uma automação pode continuar a iniciar-se a si própria? [#kan-een-automatisering-zichzelf-blijven-starten]

Dentro de um só fluxo, não. Se ligar uma saída de modo a que o fluxo voltasse a um passo anterior, o Tillor recusa essa linha. Um fluxo com um ciclo desses não pode ser ativado. Se uma execução chegar mesmo a um passo que já fez, para, em vez de repetir esse passo.

Também não através de eventos. O que um passo faz acontece como o utilizador **Fluxo de trabalho**, e os eventos que o **Fluxo de trabalho** causa não iniciam automações. Uma automação que começa em `task:created` e faz **Criar tarefa** não começa, portanto, de novo na tarefa que ela própria criou. Isto vale também entre automações: uma não pode iniciar a outra.

Se chegarem muitos eventos em pouco tempo, por exemplo por causa de um grande envio, cada evento inicia uma execução. O Tillor trata-as algumas de cada vez. Nada se perde, mas pode demorar um pouco.

## Que limites existem? [#welke-grenzen-gelden-er]

| O quê | Limite |
|---|---|
| Passos numa automação | 100 |
| Ramos num **Desvio** | 8, além de **Predefinição** |
| Ligações a partir de uma saída | 1 passo. Se ligar de novo, a nova linha substitui a antiga |
| Comprimento do nome | 120 carateres |
| Comprimento da descrição | 500 carateres |
| Comentários e molduras na tela | 50 no total |
| Opções em **Pedir uma decisão** | 8 |
| Tempo de espera de um pedido à API | 15 segundos |
| A resposta em `{response.body}` | Os primeiros 4000 carateres |
| A resposta em `{response.data}` | Até 100 000 carateres, se for maior fica vazia |
| Atraso em segundos | Não exato, pode ser alguns segundos mais tarde |
| Calendários | Verificação a cada minuto |
| Itens num **Para cada** | 100 de cada vez |
| Verificação em **Aguardar até** | No máximo de 5 em 5 minutos |
| Conteúdo de um webhook recebido | 100 KB |
| Execuções no separador **Execuções** | As últimas 20 |

## Podem várias automações começar no mesmo evento? [#kunnen-er-meerdere-automatiseringen-op-dezelfde-gebeurtenis-starten]

Sim. Cada automação ativa cujo acionador e filtro correspondam inicia a sua própria execução. Não conte com uma ordem fixa.

## Posso fazer duas coisas ao mesmo tempo depois de uma saída? [#kan-ik-na-één-uitgang-twee-dingen-tegelijk-laten-doen]

Não, uma saída leva a um passo. Coloque as ações umas a seguir às outras, ou crie uma segunda automação com o mesmo acionador.

## O que acontece às execuções em curso se eu alterar algo? [#wat-gebeurt-er-met-lopende-uitvoeringen-als-ik-iets-verander]

| O que faz | O que acontece às execuções |
|---|---|
| Alterar o fluxo e guardar | As novas execuções usam o novo fluxo. As execuções que já estão em curso ou à espera terminam com o fluxo como era |
| Pôr a automação em pausa | As execuções que esperam num atraso param assim que o tempo de espera passa e ficam com o estado **Cancelada**. O que já está em curso nesse momento termina. Se a voltar a ligar antes de o tempo de espera passar, a execução continua normalmente |
| Eliminar a automação | As execuções e o histórico são eliminados. As execuções em espera param |

## O que acontece se um passo falhar? [#wat-gebeurt-er-als-een-stap-mislukt]

A execução para com o estado **Falhou** e os passos seguintes não são executados. Quem criou a automação recebe um e-mail sobre a execução falhada, no máximo um por hora por automação. O Tillor não tenta o passo de novo. Em **Enviar webhook** e **Pedido à API** pode tratar uma falha com a saída **Falhou**. Noutras ações, ative **Continuar quando este passo falha**: o passo passa a ter uma saída **Erro** e o fluxo continua por aí. Veja [Quando um passo falha](/automatiseringen/acties#als-een-stap-mislukt).

## É mesmo enviado algo durante um teste? [#wordt-er-echt-iets-verstuurd-tijdens-een-test]

Não. Uma execução de teste não envia nada, não cria nada e não altera nada. Veja [Testes e execuções](/automatiseringen/testen-en-uitvoeringen).

## Os meus dados estão guardados em segurança? [#zijn-mijn-gegevens-veilig-opgeslagen]

Os seus fluxos e o histórico de execuções, incluindo cabeçalhos com chaves ou tokens, são guardados de forma cifrada. Para endereços na internet, só é permitido `https` e os endereços internos são recusados.

## Falta-me um evento, condição ou ação [#ik-mis-een-gebeurtenis-voorwaarde-of-actie]

Use **Pedir um passo** no editor. Veja [Pedir um passo ou evento](/automatiseringen/aan-de-slag#een-stap-of-gebeurtenis-aanvragen).

## Posso gerir as automações também a partir do meu próprio sistema? [#kan-ik-automatiseringen-ook-vanuit-mijn-eigen-systeem-beheren]

Sim, se a sua ligação tiver todas as permissões. Veja [Para programadores](/ontwikkelaars/automatiseringen).

<Callout type="idea" title="Comece pequeno">
Comece com um acionador e uma ação, deixe-a correr alguns dias e reveja as execuções. Só depois alargue com condições e atrasos.
</Callout>


# Exemplo: verificação da caravana de aluguer (/pt-PT/automatiseringen/voorbeeld-nalopen)

Este exemplo constrói um fluxo com um filtro, **Procurar tarefa**, **Definir prioridade da tarefa**, um **Se / senão** e uma tarefa com subtarefas. Não precisa de nenhum pedido à API para isso.

Nos ambientes de demonstração do Tillor, este fluxo já está pronto, em pausa, como exemplo, com o nome **Verificação da caravana de aluguer**. Pode vê-lo aí enquanto o constrói.

## O que o fluxo faz [#wat-de-flow-doet]

Um hóspede parte de uma caravana fixa. A caravana tem de ser verificada para o hóspede seguinte.

- Se ainda não houver nenhuma tarefa de verificação aberta para esse terreno, o fluxo cria uma, com cinco subtarefas e um prazo de 7 dias. A tarefa vai também para o colega que terminou a ocupação
- Se já houver uma tarefa de verificação aberta, por exemplo porque a caravana ficou livre duas vezes em pouco tempo, o fluxo não cria uma segunda tarefa. Em vez disso, a prioridade da tarefa existente sobe um nível

```mermaid
flowchart TD
  A["Ocupação terminada<br/>apenas caravanas fixas"] --> F{"Tarefa de verificação aberta?"}
  F -- Encontrada --> P["Prioridade um nível acima<br/>até Alta"]
  F -- Não encontrada --> B{"Terminada por um colega?"}
  B -- Sim --> C["Criar tarefa de verificação<br/>com o nome do colega"]
  B -- Não --> D["Criar tarefa de verificação"]
```

Os dois passos de tarefa em baixo são quase iguais. Só a descrição difere: se foi o sistema a terminar a ocupação, não há colega a mencionar.

## O que precisa [#wat-je-nodig-hebt]

- Tem a permissão **Gerir automatizações**, ou **Todas as permissões**
- Na sua organização existe um tipo de terreno para caravanas fixas, neste exemplo **Caravana**
- Opcional: um quadro e uma coluna para as tarefas de verificação

## Construir o fluxo [#de-flow-bouwen]

### 1. Criar um fluxo vazio [#1-een-lege-flow-maken]

1. Vá a **Administrador > Automações** e clique em **Nova automação**
2. Escolha **Começar de raiz**
3. No caminho de navegação no topo, preencha o nome **Verificação da caravana de aluguer**
4. Clique na tela, ao lado dos passos, e no painel, em **Descrição**, preencha para que serve o fluxo

### 2. Configurar o acionador [#2-de-trigger-instellen]

1. Clique no acionador. Deixe **Começa por** em **Quando algo acontece**
2. Em **Evento** escolha `occupation:ended`. Escreva *occupation* para pesquisar
3. Em **Nome do passo** dê à etapa o nome *Ocupação terminada*

Agora o fluxo começa em cada ocupação que termina. Quer que seja só para caravanas fixas:

1. Em **Apenas quando**, clique em **Adicionar condição**
2. Clique em **Variável** e escolha `occupation.terrain.terrainTypeId`
3. Deixe a comparação em **é**
4. No valor, escolha o tipo de terreno **Caravana**

<DocScreenshot src="/screenshots/automatiseringen/trigger-filter.png" alt="Acionador com a condição tipo de terreno é Caravana" />

### 3. Procurar uma tarefa de verificação aberta [#3-een-open-nalooptaak-zoeken]

1. Adicione um passo **Procurar tarefa**, ligue-lhe o acionador e dê-lhe o nome *Tarefa de verificação aberta?*
2. Em **Título** preencha `Verificar {occupation.terrain.name}`
3. Deixe ativos **Ligada aos registos do evento**, **Apenas tarefas não concluídas** e **Ignorar subtarefas**

O passo procura agora uma tarefa principal que ainda não está concluída, que se chama exatamente *Verificar* seguido do nome do terreno e que está ligada ao mesmo terreno, ao mesmo cliente ou à mesma reserva. Depois o fluxo continua por **Encontrada** ou **Não encontrada**.

### 4. Aumentar a prioridade [#4-de-prioriteit-verhogen]

1. Adicione um passo **Definir prioridade da tarefa**, dê-lhe o nome *Aumentar prioridade* e ligue-lhe a saída **Encontrada**
2. Deixe **Tarefa** em `{foundTask.id}`
3. Deixe **Alteração** em **Um nível acima** e **Aumentar até** em **Alta**

### 5. Verificar quem terminou a ocupação [#5-nagaan-wie-de-bezetting-stopzette]

1. Adicione um passo **Se / senão**, ligue-lhe a saída **Não encontrada** de *Tarefa de verificação aberta?* e dê-lhe o nome *Terminada por um colega?*
2. Clique em **Adicionar condição** e em **Variável** escolha `triggeredBy.id`
3. Escolha a comparação **não está vazio**

`{triggeredBy.id}` está vazio se foi o sistema a terminar a ocupação, por exemplo uma tarefa agendada. Nesse caso o fluxo segue por **Não**.

### 6. Criar a tarefa [#6-de-taak-aanmaken]

Adicione um passo **Criar tarefa**, dê-lhe o nome *Criar tarefa de verificação* e ligue-lhe a saída **Sim**. Preencha os campos assim:

| Campo | Valor |
|---|---|
| **Título** | `Verificar {occupation.terrain.name}` |
| **Descrição** | `Gerada automaticamente.`, uma linha vazia, e `Ocupação terminada por @{triggeredBy.name}({triggeredBy.id})` |
| **Prioridade** | **Baixa** |
| **Vence após** | 7 dias |
| **Atribuir também a quem causou o evento** | Ativo |
| **Associar a registos** | Ativo |
| **Subtarefas** | Cinco linhas: *Limpeza*, *Recheio*, *Internet + TV*, *Moldura com código QR*, *Verificar pequenos trabalhos* |

Com `@{triggeredBy.name}({triggeredBy.id})` o colega é mencionado na descrição. Se quiser que a tarefa vá para um quadro, escolha em **Adicionar ao quadro** um quadro e em **Coluna** uma coluna. Quem deve receber sempre a tarefa, escolhe em **Atribuir a**.

Deixe o título igual ao de *Tarefa de verificação aberta?*. Caso contrário, o passo de pesquisa não encontra a tarefa da próxima vez.

<DocScreenshot src="/screenshots/automatiseringen/task-step.png" alt="Passo Criar tarefa de verificação com as definições no painel" />

### 7. A tarefa para o sistema [#7-de-taak-voor-het-systeem]

1. Clique no passo *Criar tarefa de verificação* e depois em **Duplicar passo**
2. Dê à cópia o nome *Criar tarefa de verificação (sistema)* e ligue-lhe a saída **Não**
3. Defina a **Descrição** apenas como `Gerada automaticamente.`

### 8. Testar e ativar [#8-testen-en-inschakelen]

1. Verifique que não há nenhum botão com problemas (como **1 problema**) no topo do painel
2. Abra o separador **Execução de teste** e clique em **Executar teste**. Vê que caminho o fluxo segue e que título e descrição a tarefa receberia. Não é criado nada
3. Ative o interruptor **Ativa**

## Porquê dois passos em vez de um [#waarom-twee-stappen-in-plaats-van-één]

Pode também usar os passos **Procurar tarefa** e **Definir prioridade da tarefa** em separado. Se, por exemplo, não quiser fazer nada quando a tarefa já existe, simplesmente não ligue nada a **Encontrada**. Se quiser dar à tarefa existente um comentário ou outro estado, coloque outro passo a seguir a **Encontrada**, como **Definir estado** com `{foundTask.id}`.

## O que acontece na prática [#wat-er-in-de-praktijk-gebeurt]

| Situação | O que o fluxo faz |
|---|---|
| Nenhuma tarefa de verificação aberta para este terreno | Cria uma nova tarefa com cinco subtarefas |
| Tarefa aberta com prioridade **Baixa** | Passa-a para **Média** |
| Tarefa aberta com prioridade **Média** | Passa-a para **Alta** |
| Tarefa aberta com prioridade **Alta** ou **Urgente** | Deixa a prioridade como está |
| Ocupação num outro tipo de terreno | Não começa |

<Callout type="info" title="Como a tarefa aparece no Tillor">
A tarefa está em nome de [**Fluxo de trabalho**](/automatiseringen/workflow-gebruiker) e está ligada ao terreno e ao cliente da ocupação, e à reserva, se existir. Nem toda a ocupação tem uma reserva. O colega que terminou a ocupação aparece como pessoa atribuída à tarefa.
</Callout>


# Quem executa uma automatização? (/pt-PT/automatiseringen/workflow-gebruiker)

Uma automatização não trabalha em seu nome. Todos os passos são executados por um utilizador fixo da sua organização chamado **Workflow**.

## O que nota na prática [#wat-je-ervan-merkt]

- Uma tarefa criada por uma automatização aparece em nome de **Workflow**
- Um comentário adicionado por uma automatização através de um [Pedido à API](/automatiseringen/acties/integraties#api-verzoek) também aparece em nome de **Workflow**
- No editor, enquanto não tiver selecionado nenhum passo, o painel da direita mostra o lembrete de que os passos são executados como o utilizador **Workflow** da sua organização, nunca como você

Assim fica sempre claro o que fez um colega e o que fez uma automatização. O seu nome não aparece em algo que não fez pessoalmente.

## O que é o **Workflow** [#wat-workflow-is]

- Um utilizador de sistema, não um colega. Não é possível iniciar sessão com ele e não tem caixa de correio
- Existe um por organização. Só existe dentro da sua organização e não pode fazer nada noutro lugar
- Tem todas as permissões dentro da sua organização, tal como um administrador. É também por isso que só os administradores podem criar e alterar automatizações
- Não é membro da organização, ao contrário de um colega

<Callout type="warn" title="Uma automatização pode fazer muito">
Como o **Workflow** pode fazer tudo, uma automatização também pode fazer tudo o que a API da Tillor permite. Um **Pedido à API** pode, por exemplo, alterar ou eliminar dados. Por isso, mantenha os seus fluxos pequenos e teste-os bem.
</Callout>

## O que o **Workflow** não pode fazer [#wat-workflow-niet-mag]

Uma automatização não pode criar, alterar, ativar nem eliminar automatizações, e não pode ver as respetivas execuções. Um pedido à API para isso é recusado. Assim, um fluxo não pode alterar-se a si próprio nem a outro fluxo.

## Evento causado pelo **Workflow** [#gebeurtenis-veroorzaakt-door-workflow]

O que o **Workflow** faz causa eventos normais, por exemplo uma nova tarefa. Na cronologia e nos webhooks aparece então **Workflow** como autor. Esses eventos não iniciam automatizações: um fluxo não pode, por isso, iniciar-se a si próprio nem a outro fluxo. Uma execução que espera com **Aguardar um evento** continua com ele: isso não pode iniciar um novo fluxo, portanto também não cria um ciclo. Encontra mais informações em [Perguntas frequentes](/automatiseringen/veelgestelde-vragen#kan-een-automatisering-zichzelf-blijven-starten).

## A quem atribuir [#wie-wijs-je-toe]

O **Workflow** nunca é atribuído a uma tarefa e nunca recebe uma notificação de **Notificar colegas**. Se quiser que um colega assuma a tarefa, escolha um colega em **Atribuir a** ou ative **Atribuir também a quem causou o evento**.


# Registar um pagamento (/pt-PT/betalingsverwerking/betaling-registreren)

Um pagamento é registado numa fatura lançada com saldo em aberto. O ecrã de pagamento é igual para todos os métodos. Só os campos em **Método de pagamento** variam.

<Steps>
<Step>
### Abra a fatura [#open-de-factuur]
Vá a <UIPath>Administração > Faturas</UIPath> ou abra a fatura a partir de <UIPath>Clientes > cliente > Faturação</UIPath>. A fatura tem de estar lançada e ter um saldo em aberto.

<DocScreenshot src="/screenshots/facturen/invoice-booked-actions.png" alt="Fatura lançada - Efetuar pagamento" />
</Step>
<Step>
### Clique em Efetuar pagamento [#klik-op-maak-betaling]
Abre-se o ecrã **Novo pagamento para** a fatura. Na parte superior aparecem o total da fatura e o montante em aberto.
</Step>
<Step>
### Escolha o método de pagamento [#kies-de-betaalmethode]
Em **Método de pagamento**, escolha como o pagamento é recebido. As opções que vê dependem da fatura e do que a sua organização configurou.

- **Terminal** envia o pedido para um terminal de pagamento. Consulte [Terminal](/betalingsverwerking/terminal).
- **Numerário**, **Transferência bancária** e, eventualmente, **Outros** registam dinheiro recebido fora da Tillor. Consulte [Numerário e transferência](/betalingsverwerking/contant).
- **Transferência interna** move saldo para outra fatura do mesmo cliente. Consulte [Transferência interna](/betalingsverwerking/interne-overboeking).
- **Mandato SEPA** cobra o montante com um mandato ativo do cliente. Consulte [Cobrar uma fatura por débito direto](/betalingsverwerking/incasso).
</Step>
<Step>
### Introduza o montante [#vul-het-bedrag-in]
O **Montante** está predefinido para o montante em aberto. Com os botões 25%, 50%, 75% e 100% preenche rapidamente uma parte, ou pode escrever você mesmo um montante. O montante não pode ser superior ao montante em aberto.
</Step>
<Step>
### Execute o pagamento [#voer-de-betaling-uit]
Clique em **Efetuar pagamento**.
</Step>
</Steps>

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

O montante em aberto e o estado de pagamento da fatura são atualizados. O pagamento aparece na fatura em **Pagamentos** e em <UIPath>Administração > Pagamentos</UIPath>. Como os encontrar está descrito em [Encontrar pagamentos](/betalingsverwerking/betalingen-bekijken).

Prefere que o cliente pague por si próprio? Então envie a fatura com **Enviar notificação**. Consulte [Pagar online](/betalingsverwerking/online).

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não vejo o botão Efetuar pagamento">
O botão só existe numa fatura lançada com saldo em aberto. Uma fatura em rascunho tem de ser lançada primeiro. Uma fatura totalmente paga já não tem o botão.
</Accordion>
<Accordion title="Mandato SEPA está a cinzento">
O cliente não tem um mandato ativo cujo montante máximo seja suficiente para este montante. Numa nota de crédito, o método não aparece na lista. Consulte [Cobrar uma fatura por débito direto](/betalingsverwerking/incasso).
</Accordion>
<Accordion title="O método Terminal não aparece">
O Terminal só aparece na lista se a Mollie estiver ligada e a sua organização puder receber pagamentos por terminal. Consulte [Terminal](/betalingsverwerking/terminal).
</Accordion>
</Accordions>


# Encontrar pagamentos (/pt-PT/betalingsverwerking/betalingen-bekijken)

Vê os pagamentos em três locais: na própria fatura, na lista de todos os pagamentos e no ecrã de detalhes de um pagamento.

## Ver os pagamentos de uma fatura [#betalingen-van-een-factuur-bekijken]

Abra a fatura e desloque-se até **Pagamentos**. Só vê os pagamentos associados a esta fatura.

<DocScreenshot src="/screenshots/facturen/invoice-payments.png" alt="Pagamentos na fatura" />

## Pesquisar todos os pagamentos [#alle-betalingen-doorzoeken]

Vá a <UIPath>Administração > Pagamentos</UIPath>. Filtre por data, método de pagamento, estado ou cliente, ou pesquise pelo nome do cliente ou pelo número da fatura.

<DocScreenshot src="/screenshots/betalingen/payments-list.png" alt="Lista de pagamentos - Todos os pagamentos" />

No menu de ações (três pontos) de um pagamento pode, consoante o pagamento:

| Ação | O que faz |
|---|---|
| **Detalhes** | Abre o ecrã de detalhes |
| **PDF de pagamento** | Cria um comprovativo de pagamento |
| **Sincronizar** | Obtém o estado atual junto da Mollie. Apenas em pagamentos Mollie que já existem na Mollie |
| **Ignorar atraso** | Envia já para o banco um débito direto agendado. Consulte [Cobrar uma fatura por débito direto](/betalingsverwerking/incasso) |
| **Desassociar da fatura** | Retira o pagamento da fatura |
| **Cancelar** | Cancela um pagamento que ainda não foi concluído |
| **Eliminar** | Elimina o pagamento |

## Ler os detalhes de um pagamento [#de-details-van-een-betaling-lezen]

Clique em **Detalhes** para abrir o ecrã **Detalhes do pagamento**. Vê aí o montante, o estado, o método, a fatura e uma cronologia.

- **Data de vencimento** aparece num débito direto SEPA em curso. O estado mostra então <Status tone="warning">Esperado</Status> com essa data.
- **Enviar após** aparece num débito direto que a Tillor ainda não enviou para o banco.
- **Relatório de pagamento** mostra o relatório em que o pagamento fica incluído. Enquanto o pagamento ainda não consta de um relatório, aparece o número do relatório seguido de **(esperado)**. Num pagamento Mollie aparece **Com o próximo pagamento da Mollie**, porque o relatório só é conhecido aquando do pagamento.

Encontra mais informações sobre relatórios em [Relatórios de pagamento](/boekhouden/betalingsrapporten).

## Etiquetas de estado [#statuslabels]

| Estado | Significado |
|---|---|
| <Status tone="warning">Pendente</Status> | O pagamento ainda está em curso |
| <Status tone="info">Autorizado</Status> | Aprovado, ainda não concluído |
| <Status tone="success">Pago</Status> | Concluído |
| <Status tone="error">Falhado</Status> | Não foi bem-sucedido |
| <Status>Cancelado</Status> | Interrompido antes de estar concluído |
| <Status>Expirado</Status> | A sessão de pagamento expirou |
| <Status>Reembolsado</Status> e <Status>Parcialmente reembolsado</Status> | O montante foi devolvido na totalidade ou em parte |
| <Status tone="error">Estornado</Status> | O banco ou o emissor do cartão recuperou o montante |

## Acompanhar montantes em aberto [#openstaande-bedragen-opvolgen]

Vá a <UIPath>Administração > Faturas</UIPath>. O cartão **Faturas com saldo em aberto** mostra as faturas lançadas que ainda não estão totalmente pagas. Nas tabelas, filtre pelo estado de pagamento **Em aberto** e ordene pela data de vencimento.

<DocScreenshot src="/screenshots/facturen/invoice-open-balance.png" alt="Faturas com saldo em aberto" />

### Enviar um lembrete de pagamento [#een-aanmaning-versturen]

Um lembrete de pagamento é enviado por fatura, não em massa.

<Steps>
<Step>
### Abra a fatura [#open-de-factuur]
Escolha uma fatura que ainda esteja em aberto.
</Step>
<Step>
### Envie o lembrete [#verstuur-de-aanmaning]
Clique em **Enviar notificação** e escolha **Enviar lembrete**. Confirme o envio.
</Step>
</Steps>

O cliente recebe um lembrete com uma ligação para pagar online. Consulte [Pagar online](/betalingsverwerking/online).

## Problemas? [#problemen]

<Accordions>
<Accordion title="O estado não corresponde ao da Mollie">
Utilize **Sincronizar** no menu de ações do pagamento. A Tillor obtém então os dados atuais. Isto ajuda sobretudo quando se perdeu uma notificação da Mollie.
</Accordion>
<Accordion title="Não vejo Sincronizar">
A ação só existe em pagamentos Mollie que já têm uma transação na Mollie. Num débito direto que a Tillor ainda não enviou, não há nada para obter.
</Accordion>
</Accordions>


# Registar numerário e transferência (/pt-PT/betalingsverwerking/contant)

Com **Numerário**, **Transferência bancária** e, eventualmente, **Outros** regista que um cliente pagou fora da Tillor. A Tillor não envia nada. Apenas atualiza o saldo em aberto da fatura.

- **Numerário**: o cliente paga em dinheiro no balcão.
- **Transferência bancária**: recebeu uma transferência bancária que não foi associada automaticamente à fatura.
- **Outros**: para outros pagamentos com uma descrição própria, como um cheque ou uma troca. O método só aparece se a sua organização o tiver ativado.

## Registar um pagamento [#een-betaling-registreren]

<Steps>
<Step>
### Abra o ecrã de pagamento [#open-het-betaalscherm]
Abra uma fatura lançada com saldo em aberto e clique em **Efetuar pagamento**.

<DocScreenshot src="/screenshots/betalingen/payment-dialog-cash.png" alt="Caixa de diálogo de pagamento - Numerário" />
</Step>
<Step>
### Escolha o método [#kies-de-methode]
Em **Método de pagamento**, escolha a opção **Numerário** ou **Transferência bancária**.
</Step>
<Step>
### Introduza o montante [#vul-het-bedrag-in]
Escreva um montante ou utilize os botões 25%, 50%, 75% e 100%.
</Step>
<Step>
### Verifique a data de receção [#controleer-de-datum-van-ontvangst]
A **Data de receção** está predefinida para hoje. Altere-a se o dinheiro foi recebido noutro dia.
</Step>
<Step>
### Adicione um comentário, se quiser [#voeg-eventueel-een-opmerking-toe]
Em **Comentário** pode indicar um número de referência ou uma nota. Em **Outros**, a descrição é obrigatória.
</Step>
<Step>
### Execute o pagamento [#voer-de-betaling-uit]
Clique em **Efetuar pagamento**.
</Step>
</Steps>

<Callout type="idea" title="Data de receção">
A data determina em que relatório de pagamento o pagamento fica incluído. Se registar hoje um pagamento de ontem, defina a data como ontem para que o relatório correto seja completado.
</Callout>

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

O pagamento aparece de imediato na fatura e em <UIPath>Administração > Pagamentos</UIPath>. Consulte [Encontrar pagamentos](/betalingsverwerking/betalingen-bekijken).

Em **Transferência bancária** pode também fazer com que o cliente receba um e-mail com a sugestão de utilizar a comunicação estruturada nas próximas transferências. A opção **Enviar lembrete de comunicação estruturada** encontra-se no ecrã de pagamento. Fica a cinzento se o cliente não tiver endereço de e-mail.

## Definições para pagamentos manuais [#instellingen-voor-handmatige-betalingen]

Em <UIPath>Apoio > Definições > Pagamentos</UIPath> encontra estas definições:

| Definição | O que faz |
|---|---|
| **Mostrar método de pagamento "Outros"** | Coloca o método **Outros** no ecrã de pagamento |
| **Máximo em numerário** | O montante máximo em numerário por pagamento, por predefinição 2999 euros |
| **Predefinição: lembrete de transferência bancária manual** | Ativa por predefinição a opção do lembrete |
| **Máximo em numerário** | Montante máximo que pode registar como pagamento em numerário, em euros inteiros (predefinição 2999) |

## Problemas? [#problemen]

<Accordions>
<Accordion title="A Tillor recusa o meu montante em numerário">
Um pagamento em numerário não pode exceder o **Máximo em numerário** em <UIPath>Apoio > Definições > Pagamentos</UIPath> (predefinição 2999 euros). Registe o montante em partes ou escolha outro método.
</Accordion>
<Accordion title="Não vejo o método Outros">
O método está desativado. Ative **Mostrar método de pagamento "Outros"** em <UIPath>Apoio > Definições > Pagamentos</UIPath>.
</Accordion>
<Accordion title="Não vejo métodos manuais">
Os pagamentos manuais não estão disponíveis para todas as faturas. O ecrã indica-o nesse caso.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Registar um pagamento" href="/betalingsverwerking/betaling-registreren" />
  <Card title="Terminal" href="/betalingsverwerking/terminal" />
</Cards>


# Grupos de pagamentos (/pt-PT/betalingsverwerking/groepen)

Um grupo de pagamentos agrupa vários pagamentos recebidos sob um nome, para que possa associá-los de uma só vez a uma fatura lançada. É útil quando só quer reconciliar no final do dia ou de uma atividade.

Exemplos:

- **Fechar um turno de caixa**: todos os pagamentos por terminal do dia ficam num grupo. Associa-os à fatura da faturação diária.
- **Faturar uma atividade**: os participantes pagam online com antecedência. Ao lançar, associa o grupo inteiro à fatura.
- **Uma reserva com sinal e saldo**: o sinal e o pagamento final ficam juntos num grupo e são atribuídos de uma só vez.

## As regras [#de-regels]

- Um grupo tem o estado <Status tone="info">Aberto</Status> (ainda não associado) ou <Status tone="success">Atribuído</Status> (já associado a uma fatura).
- Um grupo não tem cliente próprio. O cliente resulta da fatura à qual associa o grupo.
- Os pagamentos de um grupo só se movem em conjunto. Não pode associar a outra fatura um pagamento individual de um grupo.
- Só pode associar um grupo a uma fatura lançada. As faturas em rascunho ainda podem mudar ou desaparecer.

## Associar um grupo a uma fatura [#een-groep-aan-een-factuur-koppelen]

<Steps>
<Step>
### Abra os grupos de pagamentos [#open-de-betalingsgroepen]
Vá a <UIPath>Administração > Pagamentos</UIPath> e consulte **Grupos de pagamentos**. Por predefinição, a lista mostra apenas grupos abertos. Altere o filtro **Estado** para ver também os grupos atribuídos.

<DocScreenshot src="/screenshots/betalingen/payment-groups.png" alt="Lista de pagamentos - Grupos de pagamentos" />
</Step>
<Step>
### Escolha Associar [#kies-koppelen]
Abra o menu de ações (três pontos) de um grupo aberto e escolha **Associar**.
</Step>
<Step>
### Escolha a fatura [#kies-de-factuur]
Selecione a fatura lançada à qual o grupo inteiro deve ficar associado.
</Step>
<Step>
### Confirme [#bevestig]
Clique em **Associar** na janela. Todos os pagamentos do grupo passam de uma só vez para essa fatura, e o grupo fica com o estado <Status tone="success">Atribuído</Status>.
</Step>
</Steps>

Também o pode fazer a partir da fatura. Aí, escolha **Atribuir pagamento** no menu de ações, vá ao separador **Grupos de pagamentos** e clique em **Atribuir grupo**.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

Um grupo atribuído aparece no PDF da fatura como uma linha com o total do grupo. Os pagamentos individuais pode expandi-los na lista de pagamentos da fatura. O próprio grupo vê-o nos detalhes de cada pagamento que lhe pertence.

Se o grupo contiver um pagamento Mollie que já existe na Mollie, aparece também **Sincronizar** ao lado de **Associar**. Essa ação obtém de uma só vez os dados atuais de todos os pagamentos elegíveis do grupo. Ajuda quando tem dúvidas sobre o estado ou se perdeu uma notificação. Pode eliminar um grupo vazio com **Eliminar**.

## Como entram os pagamentos num grupo? [#hoe-komen-betalingen-in-een-groep]

O seu sistema de caixa ou de atividades pode indicar um nome de grupo ao criar um pagamento Mollie. A Tillor cria então ela própria um grupo, ou utiliza um grupo aberto existente, e coloca lá o pagamento. Os campos para isso encontram-se em [Metadados da Mollie](/ontwikkelaars/mollie-metadata#ingestie-hints-voor-betalingsgroepen).

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não consigo associar o grupo à minha fatura">
A fatura ainda está em rascunho. Lance-a primeiro, porque só as faturas lançadas podem receber um grupo.
</Accordion>
<Accordion title="Quero colocar um pagamento do grupo noutra fatura">
Isso não é possível para um pagamento que ainda está num grupo. Trabalhe ao nível do grupo.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Encontrar pagamentos" href="/betalingsverwerking/betalingen-bekijken" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Metadados da Mollie" href="/ontwikkelaars/mollie-metadata" />
</Cards>


# Cobrar uma fatura com um mandato (/pt-PT/betalingsverwerking/incasso)

Se um cliente tem um mandato ativo, a Tillor pode cobrar uma fatura da sua conta bancária. A forma é você que escolhe: associa o mandato à fatura para que a cobrança comece sozinha após o lançamento, ou inicia a cobrança manualmente com **Efetuar pagamento**.

Um mandato é pedido através de [Pedir a assinatura de um mandato SEPA](/betalingsverwerking/mandaat). Não é possível cobrar uma nota de crédito.

## Deixar uma fatura ser cobrada automaticamente [#een-factuur-automatisch-laten-innen]

<Steps>
<Step>
### Abra a fatura [#open-de-factuur]
Vá a <UIPath>Administração > Faturas</UIPath> e abra uma fatura do cliente, em rascunho ou lançada.
</Step>
<Step>
### Escolha o mandato [#kies-het-mandaat]
Em **Mandato de débito direto**, escolha o mandato do cliente. Só os mandatos ativos aparecem na lista. Escolha **Sem mandato** para remover novamente a associação.

O campo indica o que acontece: a Tillor cria de imediato um pagamento em aberto, e o banco é debitado dois dias após o lançamento. Até lá pode cancelar o pagamento.
</Step>
<Step>
### Lance a fatura [#boek-de-factuur]
Após o lançamento, a fatura mostra **A cobrança está agendada para** com a data. Nesse dia a Tillor envia a cobrança para o banco.
</Step>
</Steps>

Se a fatura já estava lançada quando associou o mandato, aplica-se o mesmo prazo de dois dias a partir desse momento. Se a Tillor já enviou a cobrança para o banco, já não pode alterar o mandato na fatura.

### O montante máximo de um mandato [#het-maximumbedrag-van-een-mandaat]

Cada mandato tem um montante máximo. Vê-o na lista de mandatos como **máx.** com um montante. Se uma fatura for superior:

- o mandato aparece a cinzento na lista, com a indicação de que o máximo é inferior ao montante da fatura;
- a fatura mostra a indicação de que o montante da fatura excede o máximo do mandato;
- a Tillor não consegue lançar uma fatura com um mandato associado nestas condições.

Escolha então um mandato com um máximo superior, ou deixe o cliente pagar de outra forma.

## Iniciar uma cobrança manualmente [#een-incasso-handmatig-starten]

<Steps>
<Step>
### Abra o ecrã de pagamento [#open-het-betaalscherm]
Abra a fatura lançada e clique em **Efetuar pagamento**.

<DocScreenshot src="/screenshots/facturen/invoice-booked-actions.png" alt="Fatura lançada - Efetuar pagamento" />
</Step>
<Step>
### Escolha Mandato SEPA [#kies-sepa-mandaat]
Em **Método de pagamento**, escolha a opção **Mandato SEPA**. Se estiver a cinzento, o cliente não tem um mandato ativo que suporte o montante.
</Step>
<Step>
### Escolha o mandato e o atraso [#kies-het-mandaat-en-de-vertraging]
Selecione o **Mandato**. A Tillor escolhe por si o primeiro mandato ativo que suporte o montante. Em **Atraso (dias)** introduza de 0 a 7 dias. Com 0, a cobrança vai de imediato para o banco; com um número superior, a Tillor espera esse número de dias.
</Step>
<Step>
### Execute o pagamento [#voer-de-betaling-uit]
Clique em **Efetuar pagamento**.
</Step>
</Steps>

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

O pagamento aparece na fatura e em <UIPath>Administração > Pagamentos</UIPath>.

- Enquanto a cobrança aguarda, os detalhes mostram **Enviar após** com a data. Escolha **Ignorar atraso** no menu de ações para a enviar já para o banco, ou **Cancelar** para a interromper.
- Depois de enviado, o pagamento fica com o estado <Status tone="warning">Pendente</Status> com a **Data de vencimento**. Um débito direto SEPA demora alguns dias. Depois passa a <Status tone="success">Pago</Status>, ou a <Status tone="error">Falhado</Status> se o banco recusar a cobrança.
- Uma cobrança em curso já conta na contabilidade como pagamento pendente. Se falhar ou a cancelar, volta a desaparecer do rascunho. Consulte [Relatórios de pagamento](/boekhouden/betalingsrapporten).
- Na página de pagamento, o cliente vê **Cobrado por débito direto** com o montante e a data, e não vê botões de pagamento. Assim ninguém paga em duplicado. O PDF da fatura e o e-mail da fatura indicam o montante e a data da cobrança.

O pequeno primeiro pagamento com que um cliente confirmou o seu mandato é deduzido pela Tillor na fatura seguinte.

## Cobrar automaticamente faturas de consumos [#nutsfacturen-automatisch-innen]

Pode deixar as faturas de consumo de água, eletricidade e gás serem cobradas automaticamente com o mandato do cliente.

- Se, ao assinar, o cliente assinalar **Usar também este mandato para pagar automaticamente as minhas faturas de consumos (água, luz, gás)**, a Tillor define este mandato assim que ficar ativo. A opção vem assinalada por predefinição.
- Pode também escolher o mandato você mesmo em <UIPath>Clientes > cliente > Faturação</UIPath>, no cartão **Definições de faturação**, em **Mandato**.
- Na lista de mandatos, o mandato para consumos está identificado com **Consumos**.

Uma nova fatura de consumo recebe então este mandato automaticamente como **Mandato de débito direto**.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Mandato SEPA está a cinzento em Efetuar pagamento">
O cliente não tem um mandato com o estado <Status tone="success">Ativo</Status> cujo máximo seja suficientemente elevado. Verifique o cartão **Mandatos** em <UIPath>Clientes > cliente > Faturação</UIPath>.
</Accordion>
<Accordion title="Não consigo lançar a fatura">
O mandato associado tem um máximo inferior ao montante da fatura. Escolha outro mandato ou retire o mandato da fatura.
</Accordion>
<Accordion title="Já não consigo alterar o mandato na fatura">
A Tillor já enviou a cobrança para o banco. Acompanhe o pagamento em <UIPath>Administração > Pagamentos</UIPath>.
</Accordion>
<Accordion title="A cobrança falhou">
Abra o pagamento para ver o motivo. A fatura volta a ficar em aberto. Escolha **Efetuar pagamento** para uma nova cobrança ou outro método, ou envie ao cliente uma ligação de pagamento com **Enviar notificação**.
</Accordion>
<Accordion title="Quero ainda impedir a cobrança">
Enquanto o pagamento em <UIPath>Administração > Pagamentos</UIPath> ainda mostrar **Enviar após**, pode cancelá-lo. Se já foi enviado, já não é possível. Pode, no entanto, revogar o mandato para as faturas seguintes, consulte [Revogar um mandato](/betalingsverwerking/mandaat-beheren).
</Accordion>
</Accordions>

As automatizações também podem cobrar: o passo [Cobrança por débito direto](/automatiseringen/acties/facturen-en-betalingen#innen-via-domiciliëring).

## Ver também [#zie-ook]

<Cards>
  <Card title="Pedir a assinatura de um mandato SEPA" href="/betalingsverwerking/mandaat" />
  <Card title="Revogar ou reenviar um mandato" href="/betalingsverwerking/mandaat-beheren" />
  <Card title="Encontrar pagamentos" href="/betalingsverwerking/betalingen-bekijken" />
</Cards>


# Visão geral (/pt-PT/betalingsverwerking)

Um pagamento na Tillor fica normalmente associado a uma fatura lançada. O cliente pode pagar online por si próprio, você pode registar um pagamento ao balcão, ou a Tillor cobra o montante automaticamente através de um mandato SEPA. Nesta página vê para que serve cada método.

<Callout type="info" title="Bom saber">
- Um pagamento fica associado a uma fatura lançada. Num rascunho não é possível pagar.
- Um pagamento em numerário pode, por predefinição, ir até 2999 euros. Pode alterá-lo com **Máximo em numerário** em <UIPath>Apoio > Definições > Pagamentos</UIPath>.
- Acima de 2500 euros, a página de pagamento avisa o cliente de que o banco ou o cartão podem recusar o pagamento online. O cliente recebe então o IBAN e a comunicação estruturada para fazer uma transferência.
- Uma cobrança com um mandato vai para o banco dois dias após o lançamento. Em **Efetuar pagamento** escolhe você mesmo um atraso de 0 a 7 dias. Até a cobrança partir, pode cancelá-la.
- Se uma fatura for superior ao máximo do mandato, não é possível cobrar. Se esse mandato estiver na fatura, também não pode lançar a fatura.
- A ligação de assinatura de um mandato é válida durante 14 dias. A Tillor lembra o cliente aos 7 dias, 2 dias antes de expirar e no último dia.
- Uma transferência interna só é possível entre duas faturas lançadas do mesmo cliente.
- A Tillor não pode reembolsar dinheiro a um cliente. Um reembolso trata-se fora da Tillor, por exemplo com uma transferência bancária.
</Callout>

## Como tudo se liga [#hoe-hangt-dit-samen]

Todos os métodos terminam no mesmo sítio: um pagamento na fatura. Depois segue para o relatório de pagamento e para a sua contabilidade.

```mermaid
flowchart LR
  F[Fatura lançada] --> M{Método de pagamento}
  M -- Online --> P[Pagamento]
  M -- Terminal --> P
  M -- Numerário ou transferência --> P
  M -- Débito direto SEPA --> P
  M -- Transferência interna --> P
  P -- Estado e saldo --> F
  P -- Por dia --> R[Relatório de pagamento]
  R --> B[Contabilidade]
```

Uma cobrança fica primeiro <Status tone="warning">Pendente</Status>. A fatura já aparece então como paga (pendente). Se a cobrança falhar, a fatura volta a ficar em aberto. Os relatórios de pagamento e a ligação ao software de contabilidade encontram-se em [Contabilidade](/boekhouden).

## Que método escolher? [#welke-methode-kies-je]

| Método | Quando | Como paga o cliente | O que a Tillor regista |
|---|---|---|---|
| [Pagar online](/betalingsverwerking/online) | O cliente paga por si próprio, em casa ou em viagem | Através da ligação no e-mail ou SMS da fatura, com iDEAL, Bancontact, cartão de crédito ou outro método | O pagamento assim que o parceiro de pagamento o confirma, mesmo que o cliente já não faça mais nada |
| [Terminal](/betalingsverwerking/terminal) | O cliente está ao balcão | Com cartão ou telemóvel num terminal de pagamento Mollie | O pagamento assim que o terminal o conclui |
| [Numerário e transferência](/betalingsverwerking/contant) | Dinheiro recebido fora da Tillor | Dinheiro ao balcão ou uma transferência bancária | O pagamento que você regista, com a data de receção |
| [Mandato SEPA](/betalingsverwerking/incasso) | Faturas recorrentes ou de valor elevado, consumos | Não paga. A Tillor cobra o montante da conta bancária | Um pagamento pendente até o banco confirmar a cobrança |
| [Transferência interna](/betalingsverwerking/interne-overboeking) | Mover saldo entre duas faturas do mesmo cliente | Não paga. Não entra dinheiro | Dois pagamentos associados, um positivo e um negativo |

Os pagamentos online, os pagamentos por terminal e as cobranças passam pela Mollie. Os pagamentos em numerário e as transferências registá-los você mesmo.

<Cards>
  <Card title="Registar um pagamento" href="/betalingsverwerking/betaling-registreren" icon={<ReceiptTextIcon />} description="O ecrã de pagamento numa fatura lançada" />
  <Card title="Encontrar pagamentos" href="/betalingsverwerking/betalingen-bekijken" icon={<SearchIcon />} description="Por fatura, na lista e nos detalhes" />
  <Card title="Pagar online" href="/betalingsverwerking/online" icon={<GlobeIcon />} description="A página de pagamento que o cliente vê" />
  <Card title="Terminal" href="/betalingsverwerking/terminal" icon={<MonitorSmartphoneIcon />} description="Pagamentos por terminal ao balcão" />
  <Card title="Numerário e transferência" href="/betalingsverwerking/contant" icon={<BanknoteIcon />} description="Registar pagamentos fora da Tillor" />
  <Card title="Transferência interna" href="/betalingsverwerking/interne-overboeking" icon={<ArrowLeftRightIcon />} description="Mover saldo entre faturas" />
  <Card title="Pedir a assinatura de um mandato SEPA" href="/betalingsverwerking/mandaat" icon={<FileSignatureIcon />} description="À distância ou na receção" />
  <Card title="Cobrar uma fatura" href="/betalingsverwerking/incasso" icon={<LandmarkIcon />} description="Cobrar automaticamente com um mandato" />
  <Card title="Grupos de pagamentos" href="/betalingsverwerking/groepen" icon={<LayersIcon />} description="Agrupar pagamentos e associá-los de uma só vez" />
  <Card title="Exemplos práticos" href="/praktijk" icon={<ReceiptTextIcon />} description="Exemplos detalhados da prática" />
</Cards>

## Conceitos [#begrippen]

- **Pagamento**: um montante recebido ou em curso, com um método, um estado e, normalmente, uma fatura.
- **Mandato**: a autorização de um cliente para cobrar faturas da sua conta bancária. Consulte [Mandato SEPA](/betalingsverwerking/mandaat).
- **Grupo de pagamentos**: um conjunto de pagamentos que mais tarde associa de uma só vez a uma fatura. Consulte [Grupos de pagamentos](/betalingsverwerking/groepen).
- **Relatório de pagamento**: o resumo diário dos pagamentos recebidos para a contabilidade. Consulte [Relatórios de pagamento](/boekhouden/betalingsrapporten).
- **Transferência interna**: mover saldo entre duas faturas do mesmo cliente, sem entrada de dinheiro.
- **Cobrança**: a Tillor recebe o montante da conta bancária do cliente, com o seu mandato.
- **Cliente**: o cliente a quem pertence a fatura. Consulte [Cliente](/begrippen#klant).


# Fazer uma transferência interna (/pt-PT/betalingsverwerking/interne-overboeking)

Com **Transferência interna** move um montante de uma fatura lançada para outra fatura lançada do mesmo cliente. Não entra dinheiro. A Tillor cria um pagamento positivo na fatura que está a abater e um pagamento negativo associado na fatura de destino.

Isto não é um pagamento em numerário, por terminal nem uma transferência bancária. Esses métodos aparecem em separado no ecrã de pagamento.

## Registar uma transferência interna [#een-interne-overboeking-registreren]

<Steps>
<Step>
### Abra o ecrã de pagamento [#open-het-betaalscherm]
Abra a fatura lançada com saldo em aberto e clique em **Efetuar pagamento**.

<DocScreenshot src="/screenshots/betalingen/payment-dialog-internal-transfer.png" alt="Caixa de diálogo de pagamento - Transferência interna com a lista da fatura de destino aberta" />
</Step>
<Step>
### Escolha Transferência interna [#kies-interne-overboeking]
Em **Método de pagamento**, escolha a opção **Transferência interna**.
</Step>
<Step>
### Escolha a fatura de destino [#kies-de-doelfactuur]
Em **Fatura de destino**, selecione a fatura lançada para a qual o montante vai. A lista mostra apenas faturas lançadas do mesmo cliente.
</Step>
<Step>
### Introduza o montante [#vul-het-bedrag-in]
Escreva um montante ou utilize os botões 25%, 50%, 75% e 100%.
</Step>
<Step>
### Execute o pagamento [#voer-de-betaling-uit]
Se quiser, preencha a **Data de receção** e clique em **Efetuar pagamento**.
</Step>
</Steps>

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- A Tillor cria dois pagamentos associados, **Transferência interna de** e **Transferência interna para**, cada um com o número da outra fatura.
- O saldo em aberto de ambas as faturas é atualizado.
- Se eliminar um dos dois pagamentos, a Tillor elimina também o outro.

## Transferência interna e contabilidade [#interne-overboeking-en-boekhouding]

- Uma transferência interna consta do relatório de pagamento do dia em que a regista. Se a registar hoje, consta de imediato do [relatório provisório](/boekhouden/betalingsrapporten#concept-en-definitief) de hoje.
- Segue para a exportação contabilística, juntamente com os pagamentos Mollie.
- Os pagamentos em numerário, as transferências bancárias e as contas bancárias não seguem para a exportação contabilística.

## Depois de estornar uma fatura com Prorrogar ocupação [#na-het-omkeren-van-een-factuur-met-bezetting-verlengen]

Com **Estornar fatura** transforma uma fatura numa nota de crédito. Uma transferência interna entre essas duas faturas é apenas um acerto na contabilidade. Não prolonga nem encurta de novo a ocupação.

O que isto significa para **Pago até**:

- Na fatura original, **Pago até** não muda.
- Na nota de crédito, **Pago até** só recua se a fatura original já tiver sido paga com um pagamento real, como numerário, transferência bancária ou Mollie. Se só tiver sido compensada com uma transferência interna, **Pago até** mantém-se.
- **Faturado até** já foi ajustado no momento do lançamento.

## Problemas? [#problemen]

<Accordions>
<Accordion title="A fatura de destino não aparece na lista">
Só aparecem faturas lançadas do mesmo cliente. Lance primeiro uma fatura em rascunho e não escolha a mesma fatura em que faz o pagamento.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Registar um pagamento" href="/betalingsverwerking/betaling-registreren" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Contas bancárias" href="/boekhouden/betalingsrapporten/betaalmethodes/ponto" />
</Cards>


# Revogar ou reenviar um mandato (/pt-PT/betalingsverwerking/mandaat-beheren)

Todas as ações de um mandato encontram-se no menu (três pontos) no fim da linha, no cartão **Mandatos**. Encontra esse cartão em <UIPath>Clientes > cliente > Faturação</UIPath>. As ações que vê dependem do estado.

| Estado | Ações no menu |
|---|---|
| <Status tone="info">A aguardar assinatura</Status> | **Mostrar no iPad**, **Enviar lembrete**, **Reenviar ligação de assinatura**, **Cancelar pedido** |
| <Status>Ligação expirada</Status> | **Reenviar ligação de assinatura**, **Cancelar pedido** |
| <Status tone="error">Ativação falhou</Status> | **Cancelar pedido** |
| <Status tone="success">Ativo</Status> | **Abrir mandato assinado**, **Revogar mandato** |
| <Status>Revogado</Status> | **Abrir mandato assinado** |

**Mostrar no iPad** só aparece se a aplicação Tillor estiver online num dispositivo da sua organização.

## Reenviar um pedido pendente [#een-openstaande-aanvraag-opnieuw-versturen]

<Steps>
<Step>
### Abra o menu do pedido [#open-het-menu-bij-de-aanvraag]
Procure o pedido com o estado <Status tone="info">A aguardar assinatura</Status> ou <Status>Ligação expirada</Status>.
</Step>
<Step>
### Escolha a ação [#kies-de-actie]
- **Enviar lembrete** envia novamente um e-mail ao cliente, com uma nova ligação. A data limite não muda.
- **Reenviar ligação de assinatura** envia por e-mail uma nova ligação, válida de novo durante 14 dias.

Uma ligação enviada anteriormente deixa de funcionar após ambas as ações.
</Step>
</Steps>

A Tillor indica **Lembrete enviado** ou **Ligação de assinatura reenviada**. O cliente recebe um e-mail. Como funcionam os lembretes automáticos está descrito em [Pedir a assinatura de um mandato SEPA](/betalingsverwerking/mandaat#herinneringen-voor-het-tekenen).

## Cancelar um pedido [#een-aanvraag-annuleren]

Escolha **Cancelar pedido** se o cliente já não tiver de assinar. O pedido fica com o estado <Status>Cancelado</Status>. Se estiver no tablet, desaparece de lá. Depois pode iniciar um novo pedido.

## Revogar um mandato ativo [#een-actief-mandaat-intrekken]

Revogue um mandato quando o cliente já não puder ser cobrado, por exemplo numa mudança de morada, num contrato rescindido ou a pedido do cliente.

<Callout type="warn" title="A revogação não pode ser desfeita">
Para o pagamento automático é depois necessário um novo mandato, com uma nova assinatura do cliente.
</Callout>

<Steps>
<Step>
### Escolha Revogar mandato [#kies-mandaat-intrekken]
Abra o menu do mandato ativo e escolha **Revogar mandato**.
</Step>
<Step>
### Confirme [#bevestig]
No ecrã **Revogar este mandato?** clique em **Revogar**. A Tillor indica **Mandato revogado**.
</Step>
</Steps>

O que acontece a seguir:

- Deixam de ser cobradas faturas através deste mandato. As cobranças que a Tillor ainda não tinha enviado para o banco são canceladas.
- O estado do mandato passa a <Status>Revogado</Status>.
- O documento assinado é conservado como prova, mas passa para o arquivo. Nos documentos do cliente encontra-o em **Arquivados**, para que a lista mostre apenas mandatos que ainda são válidos.
- O cliente recebe um e-mail a informar que o mandato foi revogado, com uma cópia do documento assinado.

Os mandatos configurados fora da Tillor mostram apenas **Revogar mandato** no menu.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não vejo Revogar mandato">
A ação só existe num mandato com o estado <Status tone="success">Ativo</Status>. Um pedido que ainda não foi assinado cancela-se com **Cancelar pedido**.
</Accordion>
<Accordion title="Uma cobrança já estava a caminho do banco">
A revogação só cancela cobranças que a Tillor ainda não tinha enviado para o banco. Uma cobrança que já está a caminho acompanha-a em <UIPath>Administração > Pagamentos</UIPath>.
</Accordion>
<Accordion title="Quero utilizar outro mandato para uma fatura">
Escolha o mandato em **Mandato de débito direto** na fatura. Consulte [Cobrar uma fatura](/betalingsverwerking/incasso).
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Pedir a assinatura de um mandato SEPA" href="/betalingsverwerking/mandaat" />
  <Card title="Cobrar uma fatura" href="/betalingsverwerking/incasso" />
</Cards>


# Pedir a assinatura de um mandato SEPA (/pt-PT/betalingsverwerking/mandaat)

Com um mandato SEPA, um cliente autoriza a cobrança automática de faturas da sua conta bancária. O cliente assina o mandato na própria Tillor. A Tillor guarda o documento assinado junto do cliente e, depois, pode cobrar faturas. Isso está descrito em [Cobrar uma fatura](/betalingsverwerking/incasso).

Antes de começar:

- Os mandatos têm de estar ativados para a sua organização. Se não estiverem, o botão **Criar mandato** indica que deve contactar o administrador.
- O cliente precisa de um endereço de e-mail.
- Um cliente só pode ter um pedido em aberto de cada vez.

## Pedir um mandato [#een-mandaat-aanvragen]

<Steps>
<Step>
### Abra o cliente [#open-de-klant]
Vá a <UIPath>Clientes > cliente > Faturação</UIPath>. Em baixo encontra o cartão **Mandatos** com todos os mandatos e pedidos do cliente.
</Step>
<Step>
### Clique em Criar mandato [#klik-op-mandaat-aanmaken]
Abre-se um menu com uma ou duas opções. Escolha como o cliente assina.
</Step>
</Steps>

<Tabs items={["À distância", "Na receção"]}>
<Tab value="À distância">
Escolha **Enviar convite de mandato**. O cliente recebe um e-mail com uma ligação para a página de assinatura, e a Tillor indica **Mandato enviado para assinatura para** o endereço de e-mail do cliente.

A ligação é válida durante 14 dias, até ao último dia inclusive. O cliente não tem de indicar o IBAN. É ele que escolhe como confirma o mandato.
</Tab>
<Tab value="Na receção">
Escolha **Assinar no iPad da receção**. O mandato aparece no tablet da receção, e a Tillor indica **O mandato está no iPad para o cliente assinar**.

Esta opção só aparece no menu se a aplicação Tillor estiver online num dispositivo da sua organização. Consulte [Tablets e quiosques](/mobiele-app/tablets-en-kiosken). O cliente assina com o dedo no tablet. O documento assinado regista que foi assinado na receção e que colega utilizou o tablet.

O pedido já foi enviado e quer mostrá-lo ainda assim no tablet? Abra o menu do pedido e escolha **Mostrar no iPad**.
</Tab>
</Tabs>

## O que faz o cliente? [#wat-doet-de-klant]

O cliente percorre vários ecrãs. No tablet são os mesmos ecrãs, com algumas diferenças indicadas abaixo.

<Steps>
<Step>
### Ver o mandato [#het-mandaat-bekijken]
A página **Assine o seu mandato SEPA para** a sua organização mostra quem é o credor, para quem cobra e que tipo de pagamento é. O cliente toca em **Assinar mandato**.
</Step>
<Step>
### Aceitar o texto [#de-tekst-accepteren]
O cliente lê o resumo ou, através de **Ler o texto completo do mandato**, o texto completo, e assinala que concorda.

Por baixo há uma segunda opção para utilizar também o mandato para faturas de consumos (água, eletricidade, gás). Essa opção vem assinalada por predefinição. Consulte [Cobrar uma fatura](/betalingsverwerking/incasso#nutsfacturen-automatisch-innen).
</Step>
<Step>
### Assinar [#tekenen]
O cliente assina com o dedo ou com o rato.
</Step>
<Step>
### Escolher a confirmação [#de-bevestiging-kiezen]
Em **Como pretende autorizar?** o cliente escolhe entre duas formas de confirmar.

- **Um pequeno primeiro pagamento** com o seu próprio banco ou cartão, por exemplo através de iDEAL, Bancontact, cartão de crédito ou Apple Pay. O montante está entre 0 e 1 euro, consoante o método. O banco confirma assim que a conta pertence ao cliente, e o cliente não tem de copiar o IBAN. A Tillor deduz o montante da fatura seguinte.
- **Conta bancária (SEPA)**: o cliente preenche o seu IBAN, confirma que a conta é sua e introduz um código de seis dígitos. Esse código chega por SMS ao número de telefone do cliente, ou por e-mail se não houver número conhecido.
</Step>
</Steps>

No tablet, o percurso com IBAN funciona da mesma forma: o código vai por SMS para o telefone do cliente. Se o cliente optar pelo primeiro pagamento, o tablet mostra um código QR que o cliente digitaliza com o telemóvel para pagar.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- O mandato aparece na lista com o estado <Status tone="warning">Assinado, a ativar</Status>, ou <Status tone="warning">A aguardar o primeiro pagamento</Status> se o cliente tiver optado pelo pequeno pagamento.
- Assim que o mandato é válido junto do parceiro de pagamento, o estado passa a <Status tone="success">Ativo</Status>. O cliente recebe por e-mail uma cópia do mandato assinado.
- A Tillor guarda o documento assinado nos documentos do cliente. Abre-o através do menu do mandato com **Abrir mandato assinado**. O documento é selado e tem um carimbo de data e hora, pelo que uma alteração posterior fica visível num leitor de PDF. Consulte [Selo e carimbo de data e hora](/handtekeningen/bewijs-en-geldigheid#zegel-en-tijdstempel).
- Se a janela do cliente for fechada antes de o primeiro pagamento ficar concluído, o pedido continua em aberto. O cliente pode tentar de novo através da mesma ligação ou passar a utilizar o IBAN.

## Estados [#statussen]

| Estado | Significado |
|---|---|
| <Status tone="info">A aguardar assinatura</Status> | O cliente ainda não assinou |
| <Status tone="warning">Assinado, a ativar</Status> | Assinado com IBAN, a Tillor está a criar o mandato |
| <Status tone="warning">A aguardar o primeiro pagamento</Status> | Assinado, o pequeno pagamento ainda tem de ser concluído |
| <Status tone="success">Ativo</Status> | Pode utilizar o mandato para cobranças |
| <Status tone="error">Ativação falhou</Status> | O parceiro de pagamento recusou o mandato. A Tillor tenta novamente mais tarde |
| <Status>Ligação expirada</Status> | O cliente não assinou no prazo de 14 dias |
| <Status>Cancelado</Status> | Cancelou o pedido |
| <Status>Revogado</Status> | O mandato ativo foi revogado |

Os mandatos configurados fora da Tillor mostram os estados <Status tone="warning">Pendente</Status>, <Status tone="success">Ativo</Status>, <Status tone="error">Inativo</Status> e <Status>Cancelado</Status>. Só um mandato ativo pode ser utilizado para cobranças.

## Lembretes antes da assinatura [#herinneringen-voor-het-tekenen]

A Tillor envia ela própria lembretes por e-mail ao cliente enquanto o pedido estiver em aberto: quando faltarem 7 dias, dois dias antes de expirar e no último dia. Cada lembrete contém uma nova ligação de assinatura.

Quer dar você mesmo um empurrão ao cliente? No menu do pedido, escolha **Enviar lembrete**. A data limite mantém-se. Se a ligação expirou, ou se quiser dar novamente 14 dias, escolha **Reenviar ligação de assinatura**. Encontra mais informações sobre estas ações em [Revogar ou reenviar um mandato](/betalingsverwerking/mandaat-beheren).

Quer que uma automatização reaja quando um pedido expira? Para isso existe o acionador **Pedido de mandato expirado**, consulte [Automatizações](/automatiseringen).

## Problemas? [#problemen]

<Accordions>
<Accordion title="O botão Criar mandato está a cinzento">
Passe o rato sobre o botão para ver o motivo. Normalmente o cliente não tem endereço de e-mail, ou os mandatos não estão ativados para a sua organização. Adicione um endereço de e-mail ao cliente ou peça ao seu administrador que ative os mandatos.
</Accordion>
<Accordion title="A Tillor diz que já existe um mandato a aguardar assinatura">
Por cliente só pode haver um pedido em aberto de cada vez. Reenvie o pedido existente ou cancele-o e crie depois um novo.
</Accordion>
<Accordion title="A opção de assinar na receção não aparece">
A opção só aparece se a aplicação Tillor num dispositivo da sua organização tiver comunicado recentemente com a Tillor. Abra a aplicação no tablet, aguarde um momento e tente novamente.
</Accordion>
<Accordion title="O cliente não recebe o código por SMS">
O código vai para o número de telefone que consta da ficha do cliente. Verifique se está correto. Se o cliente não tiver número, o código chega por e-mail. O cliente pode pedir um novo código.
</Accordion>
<Accordion title="O cliente vê que a ligação expirou">
O cliente vê **Esta ligação de assinatura expirou**. No pedido, escolha **Reenviar ligação de assinatura**.
</Accordion>
<Accordion title="O estado continua em Ativação falhou">
O parceiro de pagamento recusou o mandato. A Tillor tenta novamente de forma automática mais tarde. Se continuar a falhar, cancele o pedido com **Cancelar pedido** e peça ao cliente que assine de novo, eventualmente com outra confirmação.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Cobrar uma fatura" href="/betalingsverwerking/incasso" />
  <Card title="Revogar ou reenviar um mandato" href="/betalingsverwerking/mandaat-beheren" />
  <Card title="Métodos de pagamento" href="/betalingsverwerking" />
</Cards>


# Deixar um cliente pagar online (/pt-PT/betalingsverwerking/online)

O pagamento online passa pela página de pagamento pessoal de uma fatura. O cliente abre a página, escolhe um método de pagamento e conclui o pagamento junto do seu banco ou emissor do cartão. Para isso, a Tillor trabalha com a [Mollie](https://www.mollie.com), pelo que a Mollie tem de estar ligada.

Não existe um botão separado para enviar a ligação de pagamento. Partilha a página com uma notificação ou com o URL pessoal da fatura.

Antes de começar:

- A fatura está lançada e há um montante em aberto. Caso contrário, o cliente não tem nada para pagar.
- A Mollie está ligada. Sem métodos da Mollie, o cliente vê apenas um botão de pagamento, consulte [Problemas?](#problemen).
- O cliente tem um endereço de e-mail ou número de telefone, ou você partilha a ligação por si próprio.

## Enviar a ligação de pagamento ao cliente [#de-betaallink-naar-de-klant-sturen]

<Steps>
<Step>
### Lance a fatura [#boek-de-factuur]
O pagamento online só é possível numa fatura lançada com saldo em aberto.
</Step>
<Step>
### Envie uma notificação [#verstuur-een-notificatie]
Clique em **Enviar notificação** e escolha um canal, como e-mail ou SMS. O cliente recebe uma mensagem com o botão **Consultar e pagar online**.
</Step>
</Steps>

Prefere partilhar você mesmo? Abra o menu de ações (três pontos) na fatura e escolha **URL pessoal**. A Tillor copia a ligação para a sua área de transferência. Um lembrete de pagamento com a mesma ligação envia-o com **Enviar lembrete**, consulte [Encontrar pagamentos](/betalingsverwerking/betalingen-bekijken#een-aanmaning-versturen). O cliente só quer pagar uma parte? Então crie uma [ligação para um pagamento parcial](/facturen/betalingen-registreren#een-link-voor-een-deelbetaling-maken).

## O que vê o cliente? [#wat-ziet-de-klant]

O cliente abre a página **A sua fatura de** a sua organização. Aí aparecem o montante a pagar, um resumo das linhas da fatura e um botão para ver a fatura. A partir desse ecrã, o cliente avança em três passos.

<Steps>
<Step>
### Pagar [#betaal]
O cliente toca em **Pagar** com o montante. Se existir um botão Apple Pay, o cliente pode pagar diretamente com ele.
</Step>
<Step>
### Escolher um método [#kies-een-methode]
Em **Como pretende pagar?** aparecem os métodos disponíveis, como iDEAL, Bancontact e cartão de crédito. A ordem vem da Mollie e adapta-se ao idioma do cliente. Aplicam-se estas regras:

- O método que o cliente utilizou da última vez nesse dispositivo aparece com **Última utilização**.
- Para clientes francófonos, o Pay By Bank aparece em primeiro lugar com **Muitas vezes a melhor opção**.
- Se um método tiver uma falha na Mollie, aparece um aviso, por exemplo de que o método está parcialmente inacessível ou em manutenção. O cliente ainda pode tentar o método, mas o aviso indica que pode não funcionar. O texto da falha vem da Mollie.
</Step>
<Step>
### Conclua o pagamento [#rond-de-betaling-af]
O que acontece a seguir depende do método e do dispositivo. Veja abaixo.
</Step>
</Steps>

### Concluir no computador ou no telemóvel [#afronden-op-computer-of-telefoon]

<Tabs items={["Num computador", "Num telemóvel"]}>
<Tab value="Num computador">
No iDEAL e no Bancontact, a Tillor mostra um código QR em **Digitalize para pagar**. O cliente abre a app do banco no telemóvel e digitaliza o código. A página avança sozinha assim que o pagamento é recebido. Se o cliente preferir pagar no computador, pode fazê-lo com **Pagar no navegador**.
</Tab>
<Tab value="Num telemóvel">
No Bancontact, a Tillor mostra o botão **Abrir a app Bancontact**. O cliente conclui o pagamento na app e volta depois à página. Através de **Pagar no navegador**, o cliente também pode pagar no navegador do telemóvel.
</Tab>
</Tabs>

Nos outros métodos, como o cartão de crédito, a Tillor encaminha o cliente para a página de pagamento do parceiro de pagamento e traz depois de volta. Se o reencaminhamento não acontecer sozinho, aparece uma ligação para continuar.

### Se não resultar [#als-het-niet-lukt]

- **Escolher outro método** leva o cliente de volta à lista.
- **Recomeçar** inicia um novo pagamento com o mesmo método. É útil se o cliente cancelou na app do banco ou se nada aconteceu.
- Num pagamento falhado, cancelado ou expirado, a página indica o resultado e o cliente pode escolher outro método.

## O que mais a página pode mostrar [#wat-de-pagina-nog-meer-kan-tonen]

| Situação | O que o cliente vê |
|---|---|
| A fatura está paga | **Paga na totalidade** com o montante recebido, e uma confirmação por e-mail |
| O banco iniciou uma transferência | **A confirmar o seu pagamento**. No Pay By Bank isso demora normalmente alguns segundos e, no máximo, alguns dias úteis |
| Está agendado um débito direto SEPA | **Cobrado por débito direto** com o montante e a data. O cliente não tem de fazer nada. Não há opções de pagamento, para que ninguém pague em duplicado |
| O montante é superior a 2500 euros | Um aviso de que o banco ou o cartão podem recusar o pagamento online devido a limites, com o IBAN e a comunicação estruturada para fazer uma transferência |
| O pagamento online não é possível para esta fatura | **Pagar por transferência** com os dados bancários |

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

A ligação pessoal não tem data de validade. O cliente pode, por isso, abri-la também mais tarde. Assim que a Mollie confirma o pagamento, este aparece na fatura e em <UIPath>Administração > Pagamentos</UIPath>. A fatura passa a <Status tone="success">Pago</Status> quando o montante total é recebido. Não tem de registar nada. Consulte [Encontrar pagamentos](/betalingsverwerking/betalingen-bekijken) para os estados.

## Problemas? [#problemen]

<Accordions>
<Accordion title="O cliente não vê métodos de pagamento">
A Mollie não está a transmitir métodos. O cliente vê apenas o botão de pagamento e, com ele, vai diretamente para a página de pagamento da Mollie. Se continuar assim, verifique a ligação com a Mollie.
</Accordion>
<Accordion title="O cliente pagou, mas a fatura continua em aberto">
Abra o pagamento em <UIPath>Administração > Pagamentos</UIPath> e utilize **Sincronizar**. No Pay By Bank, a confirmação pode demorar alguns dias úteis.
</Accordion>
<Accordion title="O cliente recebe um aviso sobre uma falha num método">
A Mollie indica que o método tem falhas. O cliente pode escolher outro método ou tentar novamente mais tarde.
</Accordion>
</Accordions>

Está a integrar um sistema próprio com pagamentos Mollie? Consulte [Metadados da Mollie](/ontwikkelaars/mollie-metadata).

## Ver também [#zie-ook]

<Cards>
  <Card title="Encontrar pagamentos" href="/betalingsverwerking/betalingen-bekijken" />
  <Card title="Mandato SEPA" href="/betalingsverwerking/mandaat" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
</Cards>


# Pagar com um terminal de pagamento (/pt-PT/betalingsverwerking/terminal)

Com o método de pagamento **Terminal** envia o montante em aberto de uma fatura para um terminal de pagamento na receção. O cliente paga com cartão ou telemóvel e a Tillor regista o pagamento assim que o terminal o conclui.

A Tillor é Tech Partner exclusivo da [Mollie](https://www.mollie.com) para pagamentos com cartão. A Tillor fornece os terminais Mollie e configura consigo o Mollie Connect, o dispositivo e a ligação às faturas. As dúvidas sobre pagamentos com cartão na receção ficam, por isso, com a Tillor.

<Callout type="info" title="Apenas terminais Mollie">
A Tillor não liga terminais Worldline, CCV nem outros. Se já tem um terminal desses, receberá de nós um dispositivo Mollie. Assim, os pagamentos online, os pagamentos com cartão e o [relatório de pagamentos](/boekhouden/betalingsrapporten) continuam a ser uma única cadeia.
</Callout>

## Iniciar um pagamento com cartão [#een-pinbetaling-starten]

<Steps>
<Step>
### Abra o ecrã de pagamento [#open-het-betaalscherm]
Abra uma fatura lançada com saldo em aberto e clique em **Efetuar pagamento**.

<DocScreenshot src="/screenshots/betalingen/payment-dialog-terminal.png" alt="Caixa de diálogo de pagamento - método de pagamento Terminal selecionado" />
</Step>
<Step>
### Escolha Terminal [#kies-terminal]
Em **Método de pagamento**, escolha a opção **Terminal**.
</Step>
<Step>
### Escolha o terminal [#kies-de-terminal]
Selecione o terminal da sua receção. A Tillor mostra apenas os terminais disponíveis nesse momento. Se só tiver um, já vem selecionado.
</Step>
<Step>
### Introduza o montante [#vul-het-bedrag-in]
Escreva um montante ou utilize os botões 25%, 50%, 75% e 100%. Um montante parcial é útil num sinal ou quando o cliente paga uma parte em numerário e outra com cartão.
</Step>
<Step>
### Envie o pagamento [#stuur-de-betaling]
Clique em **Efetuar pagamento**. O ecrã **A processar pagamento** aparece enquanto a Tillor envia o pedido para o terminal.
</Step>
</Steps>

## O que acontece depois? [#wat-gebeurt-er-daarna]

O ecrã acompanha o pagamento em direto. O cliente paga no terminal e o ecrã passa de **Pagamento em curso** para **Pagamento bem-sucedido**. Fecha-se sozinho passados alguns segundos e o saldo em aberto da fatura fica atualizado.

Enquanto o terminal aguarda, pode ativar duas opções:

- **Imprimir A4 quando pago** coloca o PDF da fatura na fila da impressora A4 assim que o pagamento é concluído. A opção fica a cinzento se nenhum conector estiver online.
- **Enviar por e-mail após o pagamento** envia a fatura por e-mail ao cliente assim que o pagamento é concluído. A opção fica a cinzento se o cliente não tiver endereço de e-mail.

Se o pagamento falhar ou expirar, recebe a mensagem **Pagamento falhado** ou **Pagamento expirado**. Clique em **Reenviar para o terminal** para tentar de novo.

## Definir o terminal predefinido [#de-standaardterminal-instellen]

A Tillor ativa o dispositivo de pagamento com a sua conta Mollie. Depois de ligar a Mollie, a Tillor escolhe o terminal por si quando existe exatamente um terminal ativo. Pode escolher outro em <UIPath>Definições > Integrações</UIPath>, na Mollie, no campo **Terminal predefinido** (junto ao **Perfil principal**). A Tillor propõe então esse terminal num pagamento com cartão.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não vejo Terminal em Método de pagamento">
O método só aparece quando a Mollie está ligada e existe um terminal associado à sua conta. Verifique a ligação em <UIPath>Definições > Integrações</UIPath>.
</Accordion>
<Accordion title="O terminal não aparece na lista">
A Tillor mostra apenas os terminais que estão online e ativos. Verifique se o terminal está ligado e conectado, e tente de novo.
</Accordion>
<Accordion title="Ainda há um pagamento antigo pendente">
Após uma nova tentativa, pode ficar um pagamento antigo com o estado <Status tone="warning">Pendente</Status>. Cancele-o em <UIPath>Administração > Pagamentos</UIPath> com **Cancelar** no menu de ações, para que a fatura fique certa.
</Accordion>
<Accordion title="Avaria ou uma receção adicional">
Envie um e-mail para **support@tillor.eu**.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Registar um pagamento" href="/betalingsverwerking/betaling-registreren" />
  <Card title="Grupos de pagamento" href="/betalingsverwerking/groepen" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
</Cards>


# Ocupações (/pt-PT/bezettingen)

Uma ocupação regista que um cliente utiliza uma determinada parcela (um lugar de campismo, um poste de eletricidade e semelhantes). Enquanto a ocupação estiver ativa, a Tillor atribui automaticamente ao cliente o consumo dos contadores dessa parcela. Gere as ocupações no perfil do cliente. Comece em [Criar uma ocupação](#een-bezetting-aanmaken).

<Callout type="info" title="Bom saber">
- Uma parcela só pode estar ocupada por um cliente de cada vez. As parcelas com uma ocupação ativa não aparecem na lista de seleção.
- **Pago até** só aceita hoje ou uma data posterior.
- Não pode alterar a parcela de uma ocupação depois de criada. Se um cliente mudar de parcela, termine a ocupação e crie uma nova.
- Eliminar uma ocupação não pode ser anulado, mas o consumo até à data de fim fica guardado e ainda pode ser faturado.
- Em **Prorrogar ocupação (fatura)**, a fatura em rascunho recebe uma data de vencimento de 14 dias após a criação.
- Apenas os campos **Tipo**, **Frequência da renda** e **Preço** são informativos. Não controlam automaticamente o registo de contadores nem a faturação.
</Callout>

## Como se relaciona tudo? [#hoe-hangt-dit-samen]

Uma ocupação liga três coisas: o cliente, a parcela e os contadores dessa parcela. Assim, a Tillor sabe em nome de quem fica o consumo.

```mermaid
flowchart LR
  K[Klant] --> B[Bezetting]
  B --> T[Terrein]
  T --> M[Meters op het terrein]
  M --> V[Verbruiksperiode van de klant]
  V --> F[Factuur]
  B -->|Bezetting verlengen| F
```

Ao criar, a Tillor regista as leituras iniciais dos contadores e, ao terminar, as leituras finais. O consumo entre ambas pertence ao cliente. Uma nova ocupação na mesma parcela inicia um novo período.

## Ver ocupações [#bezettingen-bekijken]

Abra um perfil de cliente em <UIPath>Clientes > Visão geral</UIPath> e vá ao cartão **Ocupações** no separador **Visão geral**.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations.png" alt="Ocupações no perfil do cliente" />

- A tabela mostra, por ocupação, a **Parcela**, o **Tipo**, a **Frequência da renda**, o **Preço**, o **Estado** e **Pago até**, com uma indicação relativa como "dentro de 12 dias".
- Junto a **Pago até** há um ícone de informação com **Faturado até** numa dica, se essa data estiver preenchida ou for igual a **Pago até**.
- Com **Filtrar ocupações...** pesquisa pelo nome da parcela.
- As ações de cada ocupação (editar, prorrogar, eliminar) estão no menu de três pontos no fim da linha.

## Criar uma ocupação [#een-bezetting-aanmaken]

Antes de começar:

- A parcela tem de estar livre. Se não aparecer na lista, já está ocupada. Veja Problemas no fim.
- Se a parcela tiver contadores, tenha à mão as leituras iniciais. Se não preencher nada, a Tillor usa a última leitura conhecida.

<Steps>
<Step>
### Abra o perfil do cliente [#open-het-klantprofiel]
Vá a <UIPath>Clientes > Visão geral</UIPath>, abra o cliente e vá ao cartão **Ocupações**.
</Step>
<Step>
### Clique em Criar ocupação [#klik-op-bezetting-aanmaken]
O botão está na barra de ferramentas da tabela. Abre-se uma caixa de diálogo.
</Step>
<Step>
### Preencha os dados [#vul-de-gegevens-in]
Apenas **Parcela** é obrigatória. O resto é opcional.

- **Parcela**: escolha através de **Selecione uma parcela**. Só aparecem parcelas disponíveis na lista. Se nenhuma parcela estiver disponível, vê **Nenhuma parcela disponível encontrada.**
- **Pago até (opcional)**: até quando o cliente pagou antecipadamente. Escolha hoje ou mais tarde.
- **Faturado até (opcional)**: deixe vazio para seguir a mesma data de **Pago até**, ou escolha uma data própria.
- **Tipo**: **Alojamento próprio** (predefinição) ou **Caravana de aluguer**.
- **Frequência da renda (opcional)**: uma das opções definidas pela sua organização, cada uma com um mês de início e um número de meses (por exemplo, início em janeiro, 6 meses). Escolha **Sem frequência** se não quiser registar nenhuma.
- **Descrição (opcional)**: uma nota, por exemplo acordos de tarifa.
- **Preço**: a ocupação assume o preço da parcela. Com **Substituir o preço herdado da parcela** indica um preço próprio.
- **Leituras iniciais dos contadores (opcional)**: aparece assim que a parcela tem contadores. Se não tiver contadores, vê **Nenhum contador associado**.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations-actions-menu.png" alt="Menu de ações de uma ocupação com Editar, Prorrogar e Eliminar" />
</Step>
<Step>
### Confirme [#bevestig]
Clique em **Criar ocupação** para guardar.
</Step>
</Steps>

### Preencher leituras dos contadores [#meterstanden-invullen]

<Tabs items={["Contador manual", "Contador automático"]}>
<Tab value="Contador manual">
Escreva a leitura no separador **Manual**. O campo mostra a última leitura conhecida como exemplo. Se houver leituras anteriores, também pode escolher uma leitura existente através de **Selecionar**.
</Tab>
<Tab value="Contador automático">
Um contador que envia leituras por si próprio não permite introdução manual. Escolha uma leitura existente através de **Selecionar uma leitura**.
</Tab>
</Tabs>

Se introduzir uma leitura inferior à última leitura guardada, a Tillor mostra um aviso. Pode então confirmar mesmo assim o valor mais baixo ou corrigir a introdução.

### O que acontece a seguir? [#wat-gebeurt-er-daarna]

- A ocupação fica ativa de imediato e aparece na tabela do perfil do cliente.
- A Tillor inicia, para cada contador da parcela, um período de consumo para este cliente. As novas leituras contam, a partir de agora, como consumo do cliente.
- A parcela deixa de estar disponível para outra ocupação.

## Editar uma ocupação [#een-bezetting-bewerken]

<Steps>
<Step>
### Abra o menu da ocupação [#open-het-menu-van-de-bezetting]
Clique no menu de três pontos junto à ocupação e escolha **Editar**.
</Step>
<Step>
### Ajuste os campos [#pas-de-velden-aan]
Pode alterar **Tipo**, **Frequência da renda**, **Descrição**, **Pago até**, **Faturado até** e **Preço**. **Parcela** é só de leitura. Se a sua organização tiver [campos personalizados](/eigen-velden) para ocupações, aparecem no fim da caixa de diálogo.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations-edit-dialog.png" alt="Caixa de diálogo Editar ocupação" />
</Step>
<Step>
### Guarde [#sla-op]
Clique em **Guardar alterações**. A alteração aparece, com uma comparação antes/depois, no separador **Eventos** do cliente.
</Step>
</Steps>

## Terminar uma ocupação [#een-bezetting-beëindigen]

Terminar remove a ligação entre cliente e parcela. A parcela volta depois a ficar disponível.

<Steps>
<Step>
### Escolha Remover [#kies-verwijderen]
Clique no menu de três pontos junto à ocupação e escolha **Remover**. Abre-se a janela **Eliminar ocupação**.
</Step>
<Step>
### Escolha a data e as leituras finais [#kies-de-datum-en-de-eindmeterstanden]
Se a parcela tiver contadores, pode preencher **Leituras finais dos contadores (opcional)**. Escolha primeiro, em **Data**, o dia em que a ocupação termina (hoje ou antes). Depois aparece um campo para a leitura final de cada contador. Um contador manual preenche-se em **Manual** ou escolhe-se através de **Selecionar**. Um contador automático exige sempre uma leitura existente através de **Selecionar uma leitura**.
</Step>
<Step>
### Confirme [#bevestig-1]
Clique em **Remover**. Isto não pode ser anulado.
</Step>
</Steps>

### O que acontece a seguir? [#wat-gebeurt-er-daarna-1]

- A Tillor encerra os períodos de consumo em aberto do cliente. O consumo até à data de fim fica guardado e ainda pode ser faturado.
- A parcela volta a estar disponível para uma nova ocupação.
- A ocupação desaparece da tabela.

## Faturação: prorrogar ocupação [#facturatie-bezetting-verlengen]

Com **Prorrogar ocupação (fatura)** cria uma fatura em rascunho para o período seguinte de uma ocupação, por exemplo o aluguer anual do lugar. Pode fazê-lo para uma ocupação ou para todas as ocupações do cliente de uma vez.

Antes de começar: tem de existir pelo menos um produto com a ação **Prorrogar ocupação** (muitas vezes o aluguer do lugar). Veja [Produtos](/producten).

<Steps>
<Step>
### Inicie a ação [#start-de-actie]
<Tabs items={["Uma ocupação", "Todas as ocupações"]}>
<Tab value="Uma ocupação">
Abra o menu de três pontos junto à ocupação e escolha **Prorrogar ocupação (fatura)**.
</Tab>
<Tab value="Todas as ocupações">
Clique, na barra de ferramentas, em **Prorrogar todas**. Todas as ocupações ficam numa única fatura em rascunho, com uma linha principal por ocupação.
</Tab>
</Tabs>
</Step>
<Step>
### Escolha se fatura também o consumo [#kies-of-je-verbruik-meefactureert]
Assinale **Faturar o consumo em aberto desta parcela** (em **Prorrogar todas**: **Faturar o consumo em aberto (todas as parcelas)**) se quiser faturar também o consumo em aberto na mesma fatura em rascunho. Se não houver nada em aberto nos contadores em causa, ficam apenas as linhas de prorrogação da ocupação.
</Step>
<Step>
### Crie a fatura em rascunho [#maak-de-conceptfactuur]
Clique em **Criar fatura em rascunho**. A Tillor usa o primeiro produto com a ação **Prorrogar ocupação** (por ordem alfabética do nome) e monta as linhas por si. Depois complete o período na fatura e lance-a quando estiver pronto.
</Step>
</Steps>

### O que acontece a seguir? [#wat-gebeurt-er-daarna-2]

- Fica uma fatura em rascunho pronta no cliente, com a mensagem **Concluído** e uma descrição do que foi criado.
- Se lançar a fatura, a Tillor define **Faturado até** para o momento final da linha.
- Após o pagamento, a Tillor atualiza **Pago até**. **Faturado até** só avança se ainda for anterior a esse momento final.

<Callout type="warn" title="Atenção com um rascunho existente">
Se já existir uma fatura em rascunho que prorroga esta parcela, a Tillor mostra **Verifique antes de continuar**. Um segundo rascunho pode gerar linhas duplicadas ou saltar um período. Abra o rascunho existente com **Abrir rascunho ...**, ou escolha **Criar rascunho mesmo assim**.
</Callout>

## Pago até, tipo, frequência da renda e preço [#betaald-tot-type-huurfrequentie-en-prijs]

| Campo | Significado |
|---|---|
| **Pago até** | Até quando o cliente pagou antecipadamente. Ao criar ou editar, escolhe hoje ou mais tarde. |
| **Faturado até** | Até quando foi faturado. Se o deixar vazio, a apresentação segue **Pago até**. |
| **Tipo** | Distingue alojamento próprio de arrendamento. |
| **Frequência da renda** | Regista o ritmo da renda para acompanhamento administrativo. |
| **Preço** | Segue por predefinição a parcela, mas pode ser ajustado por ocupação. |

## Cenários frequentes [#veelvoorkomende-scenarios]

### Um novo hóspede faz check-in [#een-nieuwe-gast-checkt-in]

1. Procure o cliente ou adicione-o.
2. No perfil do cliente, crie uma ocupação na parcela.
3. Preencha a leitura inicial do contador, ou deixe a Tillor assumir a última leitura.
4. A Tillor passa a associar a este cliente o consumo dos contadores dessa parcela.

### Um hóspede parte [#een-gast-vertrekt]

1. Na ocupação, escolha **Remover**.
2. Escolha a data de partida e preencha as leituras finais dos contadores.
3. Confirme. A Tillor encerra os períodos de consumo e a parcela volta a estar disponível.

### Um cliente muda para outra parcela [#een-klant-verhuist-naar-een-ander-terrein]

1. Termine a ocupação atual com as leituras finais dos contadores da parcela antiga.
2. Crie uma nova ocupação na nova parcela com as leituras iniciais dos contadores.
3. A Tillor mantém os períodos de consumo separados por parcela.

## Problemas? [#problemen]

<Accordions>
<Accordion title="A parcela não aparece na lista de seleção">
Só aparecem na lista as parcelas sem ocupação ativa. Se outro cliente ainda tiver a parcela, termine primeiro essa ocupação. Se não houver nada disponível, vê **Nenhuma parcela disponível encontrada.** Se faltarem todas as parcelas e vir **Ocorreu um erro ao carregar as parcelas.**, recarregue a página.
</Accordion>
<Accordion title="Não é possível criar a ocupação porque a parcela já está ocupada">
Outro utilizador foi mais rápido e ocupou a parcela. Recarregue a página do cliente, escolha outra parcela ou termine primeiro a ocupação do outro cliente.
</Accordion>
<Accordion title="Não consigo escolher uma data no passado em Pago até">
É intencional. Ao criar ou editar, **Pago até** só aceita hoje ou mais tarde.
</Accordion>
<Accordion title="As leituras finais não aparecem ao remover">
Escolha primeiro, em **Data**, o dia em que a ocupação termina. Depois aparece um campo por contador. Se a parcela não tiver contadores, não há campo.
</Accordion>
<Accordion title="Não consigo escrever uma leitura num contador">
É um contador que envia leituras por si próprio. Escolha uma leitura existente através de **Selecionar uma leitura**. Se vir **Nenhuma leitura de contador disponível**, o contador ainda não enviou nenhuma leitura.
</Accordion>
<Accordion title="A Tillor diz: Não foi possível criar a fatura">
Normalmente não existe um produto com a ação **Prorrogar ocupação**. Crie um, veja [Produtos](/producten), e tente de novo. Se prorrogar todas as ocupações de uma vez, verifique também que pertencem ao mesmo cliente.
</Accordion>
<Accordion title="A Tillor mostra Verifique antes de continuar ao prorrogar">
Já existe um rascunho para esta parcela, ou a parcela está faturada até uma data que ainda não está paga. Leia a mensagem. Com **Criar rascunho mesmo assim** continua conscientemente, com **Abrir rascunho ...** verifica primeiro o rascunho existente.
</Accordion>
<Accordion title="Removi uma ocupação por engano">
Isso não pode ser anulado. Crie uma nova ocupação na mesma parcela. O consumo até à data de fim da ocupação antiga ficou guardado.
</Accordion>
</Accordions>

## Conceitos [#begrippen]

- **Ocupação**: um cliente numa parcela durante um período. Veja [ocupação](/begrippen#bezetting).
- **Parcela**: o lugar em si, com eventuais contadores. Veja [parcela](/begrippen#terrein).
- **Pago até**: a data até à qual o cliente pagou antecipadamente.
- **Faturado até**: a data até à qual já foi faturado.
- **Período de consumo**: o período em que o consumo de um contador é atribuído a um só cliente. Veja [lote de consumo](/begrippen#verbruiksbatch).
- **Frequência da renda**: o ritmo da renda, por exemplo anual ou semestral.

## Ver também [#zie-ook]

<Cards>
  <Card title="Gestão de clientes" href="/klantenbeheer" description="Adicionar e gerir clientes" />
  <Card title="Gestão de contadores" href="/meterbeheer" description="Como os contadores são lidos e associados às ocupações" />
  <Card title="Lotes de consumo" href="/meterbeheer/consumptie-batches" description="Como os períodos de consumo são acompanhados e faturados" />
  <Card title="Exemplos práticos" href="/praktijk" />
  <Card title="Conquistar um cliente sazonal" href="/praktijk/seizoensklant-binnenhalen" />
  <Card title="Uma caravana residencial fica livre" href="/praktijk/stacaravan-komt-vrij" />
</Cards>


# IVA e impostos (/pt-PT/boekhouden/belasting)

Aqui lê como o IVA chega às suas faturas e como a Tillor verifica o número de IVA de um cliente. A verificação é feita através do VIES, o serviço europeu com o qual se pode consultar um número de IVA.

## Taxas de IVA [#btw-tarieven]

As taxas de IVA definem-se por produto. Vá a **Administração > Produtos** e abra um produto para escolher o **% IVA** entre as taxas disponíveis (por predefinição 0%, 6%, 9%, 12% e 21%).

<DocScreenshot src="/screenshots/producten/products-list.png" alt="Lista de produtos - coluna de IVA por produto" />

## Autoliquidação e outros regimes sem IVA [#btw-verlegd-en-andere-regimes-zonder-btw]

Por vezes não cobra IVA, mas isso não é uma simples taxa de 0%: o cliente tem de declarar o IVA ele próprio, ou a transmissão está isenta. Na lista de seleção **% IVA** de um produto existem, por isso, cinco regimes abaixo das taxas. Se escolher um, o produto fica a 0% e a Tillor sabe porquê.

| Regime | Quando | Quadro na declaração de IVA |
|--------|--------|-----------------------------|
| **Autoliquidação (serviços UE)** | Um serviço para um cliente sujeito passivo de IVA noutro país da UE | 44 |
| **Autoliquidação (cocontratante)** | Trabalhos em bens imóveis para um cliente belga sujeito passivo de IVA que entrega declarações periódicas | 45 |
| **Transmissão intracomunitária** | Mercadorias que envia para um cliente sujeito passivo de IVA noutro país da UE | 46 |
| **Exportação para fora da UE** | Mercadorias que saem da UE | 47 |
| **Isento de IVA** | Uma transmissão isenta pela sua natureza (artigo 44.º do Código do IVA belga) | 00 |

Um regime faz quatro coisas que uma simples taxa de 0% não faz:

- **Na fatura**, a linha mostra `0%*` e, por baixo dos totais, a menção legal do regime, por exemplo *Autoliquidação: o IVA é devido pelo adquirente*. Se houver dois regimes numa fatura, o segundo recebe `**`.
- **Só é possível lançar com um número de IVA** nos dois regimes de autoliquidação e numa transmissão intracomunitária. Preencha o número no perfil do cliente; passa então também a constar da fatura.
- **Para a contabilidade** segue a linha com o código do regime, para que fique no quadro certo da sua declaração de IVA. Veja [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol#btw-regimes).
- **Através do Peppol**, a linha recebe a categoria de IVA do regime.

<Callout type="warn" title="Decide você qual o regime aplicável">
A Tillor não verifica se um cliente ou uma transmissão tem direito a um regime. Em caso de dúvida, pergunte ao seu contabilista.
</Callout>

## Validação do número de IVA [#btw-nummer-validatie]

Quando introduz um número de IVA no perfil do cliente, a Tillor verifica-o automaticamente através do serviço europeu VIES, assim que o país estiver preenchido.

### Como funciona [#hoe-het-werkt]

1. Abra **Clientes > cliente** (secção **Dados do cliente**)
2. Defina o **país** e introduza o número de IVA (por exemplo `NL123456789B01` ou `BE0123456789`)
3. A Tillor valida o número automaticamente (após uma breve pausa)
4. Se o número de IVA for válido, aparece um visto verde; clique nele para ver os dados da empresa do VIES
5. Quer assumir o nome e a morada? Clique em **Aplicar morada da empresa** nessa janela (o nome da empresa vai para o campo do primeiro nome)
6. Se o número de IVA for inválido, aparece um ícone vermelho com explicação

<DocScreenshot src="/screenshots/klanten/customer-profile.png" alt="Perfil do cliente - Dados do cliente com campos de IVA" />

<Callout type="info">
A validação de IVA funciona para todos os países da UE. Para empresas fora da UE, pode introduzir o número de IVA manualmente, sem validação.
</Callout>

### Países suportados [#ondersteunde-landen]

A validação suporta todos os Estados-Membros da UE, incluindo os Países Baixos (NL), a Bélgica (BE), a Alemanha (DE), a França (FR) e todos os outros países da UE.

### Código do país no PDF da fatura [#landcode-op-de-factuur-pdf]

No PDF da fatura, a Tillor completa automaticamente um código de país em falta nos países em que essa é a grafia habitual: se introduzir `0123456789` num cliente belga, na fatura aparece `BE0123456789`. Para Espanha, Itália e Portugal isto não acontece, porque o número fiscal nacional se escreve aí sem código de país (um NIF espanhol como `B04876793` fica, portanto, inalterado). Se escrever você mesmo o código do país no campo, ele é sempre assumido.

## Clientes belgas e Peppol [#belgische-klanten-en-peppol]

Para clientes belgas com número de IVA, tem de existir um **ID Peppol** no separador **Faturação** antes de poder lançar faturas. Isto é legalmente obrigatório para a faturação B2B na Bélgica.

Veja a [documentação do Peppol](/boekhouden/peppol) para mais informações.

## IVA nas faturas [#btw-op-facturen]

Todas as linhas da fatura mostram automaticamente a taxa de IVA correta com base no produto associado. Na fatura vê **Subtotal**, **IVA** e **Total**; no PDF da fatura consta ainda um resumo por taxa de IVA.

<Callout type="info" title="Ajustar o IVA por linha">
Tem permissões para alterar as definições da organização? Vá a **Definições > Faturação** e ative **Lista de taxa de IVA nas linhas da fatura em rascunho**. Nas **faturas em rascunho** aparece então uma coluna para escolher a taxa por linha (as opções seguem as taxas configuradas para a sua organização). Ao selecionar um produto, a taxa predefinida do produto continua a ser o valor inicial. Na mesma coluna escolhe também um [regime sem IVA](#btw-verlegd-en-andere-regimes-zonder-btw) para uma linha.
</Callout>

## Problemas? [#problemen]

<Accordions>
<Accordion title="O número de IVA do cliente recebe um ícone vermelho">
A Tillor não conseguiu confirmar o número através do VIES. Verifique o país e o número. Para uma empresa fora da UE, também pode introduzir o número sem validação.
</Accordion>
<Accordion title="Não consigo lançar uma fatura com autoliquidação">
O cliente não tem número de IVA. A autoliquidação e uma transmissão intracomunitária só existem para um cliente sujeito passivo de IVA. Preencha o número em <UIPath>Clientes > cliente</UIPath>, secção **Dados do cliente**, e lance de novo.
</Accordion>
<Accordion title="Não consigo enviar pelo Peppol uma fatura com dois regimes">
Uma fatura Peppol só pode indicar um motivo para a ausência de IVA. Coloque as linhas de cada regime numa fatura própria.
</Accordion>
<Accordion title="Falta-me uma taxa de IVA num produto">
Só pode escolher entre as taxas permitidas, por predefinição 0%, 6%, 9%, 12% e 21%.
</Accordion>
<Accordion title="Não consigo escolher a taxa de IVA numa linha da fatura">
A coluna com as taxas só existe em faturas em rascunho e apenas se **Lista de taxa de IVA nas linhas da fatura em rascunho** estiver ativa.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Produtos" href="/producten" description="Associar taxas de IVA a produtos" />
  <Card title="Peppol" href="/boekhouden/peppol" description="Faturação eletrónica na Bélgica" />
  <Card title="Faturas" href="/facturen" description="Criar e lançar faturas" />
</Cards>


# Métodos de pagamento (/pt-PT/boekhouden/betalingsrapporten/betaalmethodes)

Os relatórios de pagamentos contêm pagamentos de várias origens. Apenas a **Mollie** e as **transferências internas** são enviadas para a contabilidade.

| Método | No relatório da Tillor | Para a contabilidade |
|---------|-------------------|------------------|
| [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie) | Sim (através do acerto da Mollie) | Sim |
| [Contas bancárias](/boekhouden/betalingsrapporten/betaalmethodes/ponto) | Sim (no dia do pagamento) | Não |
| [Transferência interna](/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers) | Sim | Sim |

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Relatório de pagamentos - pagamentos de várias origens" />

```mermaid
flowchart LR
  Mollie[Mollie] --> R[Tillor-rapport]
  Bank[Bankrekeningen] --> R
  Internal[Interne overboeking] --> R
  R --> BH[Boekhouding]
  Mollie --> BH
  Internal --> BH
```

## Ver também [#zie-ook]

<Cards>
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Contas bancárias" href="/boekhouden/betalingsrapporten/betaalmethodes/ponto" />
  <Card title="Transferência interna" href="/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers" />
</Cards>


# Transferências internas (/pt-PT/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers)

Com **Transferência interna** move um montante em aberto de uma fatura para outra fatura **lançada** do **mesmo cliente**. A Tillor cria um pagamento positivo na fatura que paga e um pagamento negativo associado na fatura de destino.

Veja [Transferência interna - Registar](/betalingsverwerking/interne-overboeking) para o processo de registo passo a passo com capturas de ecrã.

## Nos relatórios de pagamentos [#in-betalingsrapporten]

- As transferências internas constam do relatório de pagamentos da Tillor do dia em que as regista (Bruxelas).
- Seguem **sim** para a exportação contabilística: juntamente com os pagamentos Mollie, e **não** juntamente com contas bancárias ou outros métodos manuais (numerário, transferência, ...).
- Na exportação contabilística, cada linha aparece como `Tillor - Interne overboeking - {factuurnummer}`, associada à fatura e ao cliente em causa.

## Ver também [#zie-ook]

<Cards>
  <Card title="Registar" href="/betalingsverwerking/interne-overboeking" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Contas bancárias" href="/boekhouden/betalingsrapporten/betaalmethodes/ponto" />
</Cards>


# Mollie (/pt-PT/boekhouden/betalingsrapporten/betaalmethodes/mollie)

Os pagamentos Mollie (iDEAL, cartão de crédito, Bancontact, terminal, etc.) são sincronizados na Tillor e associados aos relatórios de pagamentos através do **acerto da Mollie**.

## Ligar na Tillor [#koppelen-in-tillor]

1. Vá a **Definições > Integrações** e escolha **Mollie** na lista.
2. Siga os passos OAuth da Mollie se a ligação ainda não estiver ativa.
3. Na página de detalhe, em **Perfil de website**, escolha um **Perfil principal** (o perfil de website da Mollie para pagamentos e sincronização). Opcionalmente, escolha um **Terminal predefinido** (o dispositivo de pagamento que a Tillor propõe por predefinição nas faturas).
4. Clique em **Guardar**. Sem perfil principal, os pagamentos Mollie não funcionam na Tillor; um terminal só é necessário para pagamentos com cartão.

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/betaalmethodes/mollie/mollie-marketplace-install.png" alt="Definições > Integrações - Mollie na lista" />

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/betaalmethodes/mollie/mollie-connection-settings.png" alt="Definições da Mollie - Perfil principal e Terminal predefinido" />

### Ícones de estado nas listas de seleção [#statusiconen-in-de-keuzelijsten]

À esquerda do nome do perfil e do terminal há um ícone colorido. Esse é o estado na Mollie, não o nome em si.

| Ícone | Perfil de website | Terminal |
|-------|----------------|----------|
| Verde (visto) | Verificado - adequado para pagamentos reais | Ativo - pronto para pagamentos com cartão |
| Laranja (relógio) | Ainda não verificado na Mollie | Pendente - ainda não ativo |
| Vermelho (proibido) | Bloqueado | - |
| Cinzento | - | Inativo |

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/betaalmethodes/mollie/mollie-profile-select-open.png" alt="Perfil principal aberto - ícone de estado junto ao nome do perfil" />

Escolha de preferência um perfil **verificado**. Um terminal **ativo** é opcional e só é necessário se quiser que a Tillor proponha pagamentos com cartão. Sem perfil principal, os pagamentos e a sincronização não funcionam.

## Acertos da Mollie [#mollie-settlements]

Enquanto a Mollie ainda não pagou um pagamento, este consta como **adiantamento** no relatório rascunho em aberto. Só ao finalizar é que o acerto decide a que relatório pertence; veja [Pagamentos Mollie no rascunho](/boekhouden/betalingsrapporten#mollie-betalingen-op-het-concept).

Para o **dia de relatório D**, a Tillor procura um acerto por esta ordem:

1. Acerto **criado no dia D**
2. Caso contrário, acerto **criado no dia D+1** (tipicamente: a receita de D é paga na manhã seguinte)

```mermaid
flowchart TD
  D[Rapportdag D] --> E{Settlement aangemaakt op D?}
  E -- ja --> F[Koppel aan rapport D]
  E -- nee --> G{Settlement aangemaakt op D+1?}
  G -- ja --> F
  G -- nee --> H[Nog geen Mollie op dit rapport]
  F --> I[Eén settlement-id per rapport]
```

**Regras fixas:**

- Cada ID de acerto consta de **no máximo um** relatório de pagamentos.
- Um relatório já tem um acerto? Essa associação **mantém-se**; a Tillor não a substitui.
- Se faltarem D e D+1 (por exemplo, fim de semana): o relatório pode já existir apenas com pagamentos manuais/de contas bancárias; assim que a Mollie publicar, a sincronização diária acrescenta a Mollie.

## Exemplos [#voorbeelden]

| Dia de relatório D | Acerto criado na Mollie | Resultado |
|--------------|----------------------------------|-----------|
| Ter 20 mai | Ter 20 mai (`stl_aaa`) | `PAYR/2026/0140` (20 mai) recebe `stl_aaa` |
| Ter 20 mai | Qua 21 mai cedo (`stl_bbb`) | `PAYR/2026/0140` (20 mai) recebe `stl_bbb` (regra D+1) |
| Dom 18 mai | Seg 19 mai (`stl_ccc`) | `PAYR/2026/0138` (domingo) recebe `stl_ccc`, **não** o relatório de segunda-feira |
| Seg 19 mai | Seg 19 mai (`stl_ccc`) | O relatório de segunda-feira procura o seu próprio acerto (`stl_ddd` na terça ou mais tarde), não `stl_ccc` |
| Sáb 17 mai | Nenhum acerto sáb/dom/manhã de seg | Relatório de 17 mai: primeiro manual/contas bancárias; a Mollie segue quando houver acerto |
| Ter 20 mai | O relatório já existia sem acerto | Próxima execução às 09:00: o acerto é ainda associado a 20 mai, pagamentos associados |

**Concretamente (D+1):** a receita de **terça-feira, 20 de maio** está no acerto `stl_6necch`, criado na **quarta-feira, 21 de maio** às 06:08. A Tillor associa `stl_6necch` a **`PAYR/2026/0140` (dia de relatório 20 de maio)**, não ao relatório de 21 de maio.

**Relatório existente:** o `PAYR/2026/0140` já existia na Tillor sem acerto Mollie associado e com duas linhas manuais? Após a sincronização, `stl_6necch` é ainda associado; as linhas existentes mantêm-se; os pagamentos Mollie desse acerto são acrescentados.

**Já associado:** o relatório de **15 de maio** já tem `stl_old`. A Tillor **não** altera esse ID. Pagamentos Mollie soltos com o mesmo ID de acerto vão, ainda assim, para o relatório que já tem esse acerto.

## Sincronização em relatórios existentes [#synchronisatie-op-bestaande-rapporten]

Depois de criar os relatórios em falta, a Tillor procura **apenas relatórios sem acerto Mollie associado** numa janela móvel de **um mês civil antes de ontem** até ontem. Os relatórios que já têm um acerto Mollie **não** são novamente obtidos através da lista de acertos da Mollie.

```mermaid
flowchart TD
  start[Synchronisatie<br/>ma-za 09:00] --> scope[Rapportdag vanaf<br/>maand vóór gisteren t/m gisteren]
  scope --> nullOnly[Alleen rapporten<br/>zonder Mollie-afrekening]
  nullOnly --> U{Zoek settlement voor D of D+1}
  U -- gevonden --> V[Settlement vastleggen]
  U -- niet --> W[Geen Mollie-stap]
  V --> X[Ongekoppelde Mollie-betalingen<br/>uit settlement koppelen]
  X --> Z[Betalingen met dezelfde<br/>settlement-id op dat rapport]
```

Os pagamentos que já têm um ID de acerto da Mollie, mas ainda não constam de um relatório, vão para o relatório com o mesmo ID de acerto.

## Pagamentos Mollie na Tillor [#mollie-betalingen-in-tillor]

A Tillor obtém os pagamentos Mollie **a cada 15 minutos** (por organização com ligação Mollie ativa). Os webhooks da Mollie funcionam além disso de imediato: um pagamento passa logo a **Pago**, **Reembolsado** ou **Estornado**, mesmo que tenha sido criado fora da Tillor (por exemplo, num terminal de pagamento). Em caso de dúvida ou de um webhook perdido: **Sincronizar** no menu de ações do pagamento.

Um pagamento entra num relatório se:

- constar do **acerto** associado (lista da Mollie), ou
- o pagamento já tiver um ID de acerto que pertence ao relatório.

| Tipo no relatório | Significado |
|-----------------|-----------|
| Conhecido | Pagamento associado a uma fatura na Tillor |
| Desconhecido | Sem associação a fatura na Tillor → conta de espera 499000, a menos que envie dados contabilísticos através da Mollie |

Os pagamentos de acerto que **não** existem na Tillor aparecem como pagamento Mollie desconhecido no relatório.

Num relatório de pagamentos vê os pagamentos Mollie associados na tabela **Pagamentos**:

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Detalhe do relatório de pagamentos - pagamentos e Enviar para a contabilidade" />

## Metadados da Mollie [#mollie-metadata]

Tem uma caixa registadora ou outro sistema que cria ele próprio pagamentos Mollie? Pode orientar a Tillor através de metadados nesse pagamento: associação a uma fatura ou a um [grupo de pagamentos](/betalingsverwerking/groepen), ou diretamente para a contabilidade. Os campos estão em [Metadados da Mollie](/ontwikkelaars/mollie-metadata).

## Ver também [#zie-ook]

<Cards>
  <Card title="Relatórios de pagamentos" href="/boekhouden/betalingsrapporten" />
  <Card title="Grupos de pagamentos" href="/betalingsverwerking/groepen" />
  <Card title="Contas bancárias" href="/boekhouden/betalingsrapporten/betaalmethodes/ponto" />
  <Card title="Transferências internas" href="/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers" />
  <Card title="Admisol" href="/boekhouden/betalingsrapporten/boekhoudsystemen/admisol" />
  <Card title="Metadados da Mollie (API)" href="/ontwikkelaars/mollie-metadata" />
</Cards>


# Contas bancárias (/pt-PT/boekhouden/betalingsrapporten/betaalmethodes/ponto)

A ligação bancária liga-se, através de open banking, à sua conta bancária e obtém as transações automaticamente.

## Como funciona [#hoe-het-werkt]

1. **Transações**: a cada 5 minutos, a Tillor obtém as transações bancárias no seu banco
2. **Comunicação estruturada**: +++123/4567/89002+++ ou o número da fatura (INV/2024/0001) é lido
3. **Associação**: a Tillor procura uma fatura correspondente → o pagamento é criado e associado
4. **Transferência manual duplicada**: se já existir uma transferência manual na mesma fatura com o mesmo montante, é removida para que o pagamento não conte duas vezes
5. Na Tillor vê esse pagamento como **transferência bancária**

## Ligar [#koppelen]

A integração chama-se **Contas bancárias** e encontra-se em <UIPath>Definições > Integrações > Contas bancárias</UIPath>. Preenche um **Client ID** e um **Client secret**; um administrador da Tillor ajuda-o na configuração e acompanha o onboarding.

## Ver transações bancárias [#banktransacties-bekijken]

As transações bancárias importadas estão em **Administração > Transações bancárias**. Essa página só é visível para utilizadores com a permissão **Ver transações bancárias**. Sem essa permissão, não vê a página no menu.

<DocScreenshot src="/screenshots/boekhouden/bank-transactions/bank-transactions-list.png" alt="Lista de transações bancárias com coluna Fatura" />

Na tabela **Transações**, a coluna **Fatura** está entre **Data-valor** e **Comunicação**:

- A transação já está numa fatura? Então vê o número da fatura como ligação (por exemplo, `INV/2026/0001`).
- Ainda sem associação? Abra o menu de ações (três pontos) no fim da linha e escolha **Atribuir à fatura**. Se necessário, a Tillor cria primeiro um pagamento e associa-o à transação. Para isso precisa da permissão **Atribuir pagamento**; sem essa permissão, não vê esta ação no menu.
- A transação já está numa fatura? Abra o mesmo menu de ações e escolha **Desassociar da fatura** para remover a associação (manual e automática).

Clique no ícone (i) junto ao IBAN para abrir o painel de detalhe dessa transação: montante, data-valor, contraparte e IBAN, comunicação, os dados do extrato bancário (referência bancária, referência do ordenante, número do cartão, ...), a fatura, o pagamento e o relatório de pagamentos associados, e as referências. O menu de ações também está no topo desse painel.

No menu de ações escolhe ainda:

- **Criar tarefa** para associar uma tarefa à transação, por exemplo para tratar um pagamento manualmente. A tarefa mostra a transação como item associado; clique nela para abrir o painel de detalhe. Veja [Itens associados](/taken/taakdetails#gekoppelde-items).
- **Copiar ligação** para uma ligação que abre a página **Transações bancárias** com o painel de detalhe dessa transação, por exemplo para colar num comentário ou numa mensagem.

<DocScreenshot src="/screenshots/boekhouden/bank-transactions/bank-transactions-assign-dialog.png" alt="Caixa de diálogo Atribuir à fatura numa transação bancária" />

A mesma coluna **Fatura** vê num **relatório de pagamentos** na tabela **Transações da conta bancária**, desde que tenha a permissão de leitura.

## Desassociar [#ontkoppelen]

Em **Administração > Transações bancárias** (e num relatório de pagamentos em **Transações da conta bancária**) abre o menu de ações numa linha associada e escolhe **Desassociar da fatura**. Isto funciona tanto para transações associadas manualmente como para transações associadas automaticamente.

Em **Administração > Pagamentos**, **Desassociar da fatura** só existe nos pagamentos que você próprio associou ou moveu para uma fatura. Assim evita remover por engano, através da lista de pagamentos, uma associação automática correta.

<DocScreenshot src="/screenshots/betalingen/payment-unassign-menu.png" alt="Menu de ações do pagamento com Desassociar da fatura" />

## Sincronizar manualmente [#handmatig-synchroniseren]

Em **Administração > Transações bancárias** e num **relatório de pagamentos** (tabela **Transações da conta bancária**) existe o botão **Sincronizar conta bancária** se a ligação bancária estiver instalada e tiver a permissão **Sincronizar transações bancárias**. Com ele pede uma nova sincronização bancária; a Tillor importa depois as novas transações e tenta associá-las a faturas.

Sem ligação bancária ou sem essa permissão, o botão não aparece. A Tillor também importa novas transações automaticamente, a cada 5 minutos.

Define ambas as permissões em **Definições > Permissões de utilizadores** (grupo **Transações bancárias**).

## Nos relatórios de pagamentos [#in-betalingsrapporten]

As transferências bancárias constam **sim** do relatório de pagamentos da Tillor da data de pagamento (Bruxelas), juntamente com os pagamentos manuais desse dia. **Não** seguem para a exportação contabilística: apenas a Mollie e as transferências internas. A ligação bancária destina-se sobretudo à associação automática a faturas na Tillor.

<Callout type="idea" title="Associação automática">
O cliente transfere com comunicação estruturada → a Tillor obtém do seu banco → a fatura é associada → pagamento + fatura paga.
</Callout>

## Ver também [#zie-ook]

<Cards>
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Transferências internas" href="/boekhouden/betalingsrapporten/betaalmethodes/internal-transfers" />
</Cards>


# Admisol (/pt-PT/boekhouden/betalingsrapporten/boekhoudsystemen/admisol)

O Admisol é um pacote de contabilidade que a Tillor suporta para o envio de relatórios de pagamentos. Os relatórios de pagamentos são convertidos para XML do Admisol e enviados para o Admisol de forma automática ou manual.

## Instalação [#installatie]

1. Vá a **Definições** (marca **1** na captura de ecrã) e escolha **Integrações**.
2. Procure **Admisol** na lista de integrações (marca **2**) e abra a página de detalhe.
3. Na página de detalhe, preencha o seu **ID da empresa** e a **Chave do serviço web** (dados do Admisol) e clique em **Instalar**.

<DocScreenshot src="/screenshots/boekhouden/boekhoudsystemen/admisol-marketplace-install.png" alt="Definições > Integrações - Admisol na lista" />

<DocScreenshot src="/screenshots/boekhouden/boekhoudsystemen/admisol-credentials-dialog.png" alt="Detalhe do Admisol - ID da empresa e Chave do serviço web" />

## Envio automático [#automatisch-versturen]

Quando um relatório de pagamentos **muda em termos de conteúdo** (por exemplo, após associar pagamentos ou após **Recalcular relatório**):

1. A Tillor verifica se o Admisol está instalado para a organização
2. O relatório é convertido para XML do Admisol
3. O XML é enviado para o Admisol

Na **criação diária** (09:00), a Tillor percorre os dias em falta **do mais antigo para o mais recente**. Cada novo relatório só segue para o Admisol quando o relatório anterior tiver recebido uma resposta (aceitação ou rejeição). Se o envio falhar, a Tillor pára para essa organização até à execução seguinte.

O [relatório rascunho](/boekhouden/betalingsrapporten#concept-en-definitief) do dia em curso segue para o Admisol logo que tenha um pagamento Mollie ou uma transferência interna, e depois só volta a ser enviado quando o lançamento mudar. Os pagamentos em numerário no rascunho não provocam um envio. Os pagamentos Mollie num rascunho são contra-lançados no fornecedor Mollie **sem referência de documento**; o Admisol lança isso como **adiantamento** ("ainda a receber"). Os reembolsos que a Mollie ainda não reteve aparecem como uma segunda linha de adiantamento, separada, na Mollie ("ainda a reter"). No envio definitivo, o pagamento real com custos bancários passa a ocupar o seu lugar, e os pagamentos que não estavam no acerto passam como adiantamento para o rascunho seguinte. Enquanto o relatório for rascunho, a referência do documento no Admisol é `PAYR/2026/0275 - Concept`; esse sufixo desaparece no envio definitivo. Se o relatório se tornar definitivo no dia útil seguinte, a Tillor envia-o de novo, agora com o acerto da Mollie, sob **o mesmo número de documento e a mesma data de lançamento**.

Num envio automático falhado recebe uma notificação e aparece uma linha na cronologia de eventos do relatório.

## Envio manual [#handmatig-versturen]

1. Vá a **Administração > Relatórios de pagamentos**
2. Abra o relatório que quer enviar
3. Clique em **"Enviar para a contabilidade"**

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Relatório de pagamentos - Enviar para a contabilidade" />

## Que pagamentos seguem? [#welke-betalingen-gaan-mee]

Apenas pagamentos com:

- **Mollie** como fornecedor, ou
- **Transferência interna** como método de pagamento

Os pagamentos de contas bancárias não são enviados para a contabilidade.

## Reembolso parcial (Mollie) [#gedeeltelijke-terugbetaling-mollie]

Se um pagamento Mollie associado foi reembolsado em parte ou na totalidade, a Tillor envia o **montante original do pagamento** no relatório de pagamentos do **acerto da Mollie em que o pagamento entrou**. O **reembolso** surge como linha negativa no relatório do **acerto em que a Mollie deduz o reembolso** (etiqueta *Terugbetaling*). Podem ser acertos posteriores; vários reembolsos recebem cada um a sua linha no relatório do respetivo acerto. Assim, o relatório coincide com o que a Mollie efetivamente paga. Ao lançar os reembolsos apenas nesse dia de acerto, não é necessária nenhuma linha adicional na conta de espera **499000** (*restant saldo*).

## Custos bancários por fatura da Mollie [#bankkosten-per-mollie-factuur]

A Mollie retém os seus custos em cada pagamento e fatura-os uma vez por mês. Por isso, a Tillor lança os custos retidos **por período de faturação**: cada linha indica o mês para o qual a Mollie fatura os custos, por exemplo *Bankkosten 01/2026*. Um pagamento nos primeiros dias do mês contém muitas vezes ainda custos do mês anterior; esses aparecem como linha separada no mesmo relatório.

Todas as linhas do mesmo período somam o montante da fatura da Mollie desse mês. As linhas do mês em curso ficam em aberto até a Mollie emitir a fatura.

### No fornecedor Mollie [#op-de-leverancier-mollie]

Os custos retidos não são um segundo custo: a Mollie paga com eles a sua própria fatura. Por isso, a Tillor lança-os no **fornecedor Mollie**, sem referência de documento. O custo e o IVA entram apenas através da fatura de compra da Mollie. Todos os meses concilia, no fornecedor Mollie, a fatura com as linhas *Bankkosten* desse período; juntas têm o mesmo valor. Não é necessária uma correção através de uma operação diversa.

A Mollie costuma reter os custos de um pagamento logo no momento em que o pagamento entra, mesmo que o pagamento ao comerciante só se siga mais tarde. Um relatório rascunho lança por isso esses custos já por período de faturação, e o adiantamento na Mollie é o montante após custos. Um pagamento com cartão que a Mollie ainda retém não tem ainda custo retido: esse custo só surge no relatório com o pagamento ao comerciante. Até lá, o mês no fornecedor Mollie ainda não está completo.

No Admisol, **não concilie linhas de um relatório rascunho** (a referência do documento termina em *- Concept*). No envio definitivo, o Admisol substitui as linhas do relatório, e as conciliações nessas linhas podem desaparecer. Isso também pode acontecer quando reenvia um relatório definitivo, mesmo que nada tenha mudado: verifique depois as conciliações no fornecedor Mollie.

## Reserva de saldo [#balansreserve]

A Mollie retém por vezes parte do pagamento como **reserva de saldo**: dinheiro que lhe é devido, mas que a Mollie retém temporariamente. Como não é um custo nem um reembolso, a Tillor lança esse montante no **fornecedor Mollie** com a etiqueta *Balansreserve*, tal como o próprio pagamento. Assim, continua como crédito em aberto na Mollie em vez de ficar na conta de espera. Se a Mollie libertar a reserva mais tarde, no relatório desse acerto aparece uma linha *Balansreserve* de sinal contrário que volta a abater o crédito. Não precisa de fazer nada; no fornecedor Mollie, as duas linhas anulam-se.

## Faturas já conciliadas no Admisol [#facturen-die-in-admisol-al-afgepunt-zijn]

O Admisol recusa uma linha numa fatura ou nota de crédito que tenha conciliado manualmente no Admisol com outro lançamento que não o relatório de pagamentos. A Tillor lança então as linhas dessa fatura no cliente **sem referência de documento**, para que o relatório siga na mesma. Os montantes e o cliente mantêm-se; só a associação com a fatura é que concilia de novo no próprio Admisol. Na cronologia de eventos do relatório consta, no XML enviado, de que fatura se trata.

## Parâmetros contabilísticos [#boekhoudparameters]

Após a instalação, define os parâmetros contabilísticos em **Definições** na aplicação Admisol (o mesmo ecrã do ID da empresa e da Chave do serviço web). Aí constam, entre outros, os tipos de documento para faturas e acertos, o código de fornecedor da Mollie, a conta do razão predefinida para linhas de fatura e o departamento predefinido. Os campos em falta recebem valores predefinidos da Tillor.

Os pagamentos Mollie desconhecidos são lançados na conta de espera **499000**. Por pagamento também pode indicar departamento e ano fiscal através de [metadados da Mollie](/ontwikkelaars/mollie-metadata#directe-boekhoudmetadata-tillorbookkeeping).

### Regimes de IVA [#btw-regimes]

Uma linha de fatura com um [regime sem IVA](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw) segue para o Admisol com um **perfil de endereço fiscal** e um **código fiscal** próprios. Em conjunto, determinam em que quadro da declaração de IVA a linha fica. Os valores predefinidos são os de um dossiê novo do Admisol:

| Regime | Perfil de endereço fiscal | Código fiscal | Quadro |
|--------|------------------|----------|---------|
| Autoliquidação (serviços UE) | `EU` | `vd21` | 44 |
| Autoliquidação (cocontratante) | `MED` | `v21` | 45 |
| Transmissão intracomunitária | `EU` | `v21` | 46 |
| Exportação para fora da UE | `EXP` | `v21` | 47 |
| Isento de IVA | `NA` | `v0` | 00 |

Se o seu dossiê usar outros códigos, ajuste-os nos parâmetros contabilísticos: por regime existe um campo para o perfil de endereço fiscal e outro para o código fiscal. Encontra os códigos do seu dossiê no Admisol em **Instellingen > BTW-instellingen > Tax-relaties**. A ficha do cliente no Admisol mantém o seu próprio perfil de endereço fiscal; só a linha da fatura recebe o do regime.

## Ver também [#zie-ook]

<Cards>
  <Card title="Odoo" href="/boekhouden/betalingsrapporten/boekhoudsystemen/odoo" />
  <Card title="Exact Online" href="/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online" />
  <Card title="Mollie" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
</Cards>


# Exact Online (/pt-PT/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online)

O Exact Online é o pacote de contabilidade que muitos parques neerlandeses e os seus escritórios utilizam. A Tillor liga **clientes**, **faturas lançadas** e **relatórios de pagamentos** ao Exact Online. A ligação está **disponível a pedido** - ainda não em autoatendimento na App Marketplace.

<Callout type="info" title="A pedido">
Quer ligar a Tillor ao Exact Online? Peça a ativação através da [demonstração](https://tillor.eu/demo) ou envie um e-mail para **support@tillor.eu**. Configuramos a ligação em conjunto com o seu contabilista.
</Callout>

## O que a ligação abrange [#wat-de-koppeling-dekt]

A exportação prevista segue a mesma cadeia que o [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) e o [Odoo](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo). O mapeamento exato de diários e contas de proveitos acertamo-lo na ativação.

- **Clientes** da Tillor para o Exact Online
- **Faturas lançadas** (linhas e IVA)
- **Relatórios de pagamentos** - apenas **Mollie** e **transferências internas**, como nas outras exportações contabilísticas

Os pagamentos de contas bancárias constam do relatório da Tillor, mas não seguem para a exportação contabilística. Veja [sistemas de contabilidade](/boekhouden/betalingsrapporten/boekhoudsystemen).

## Ainda sem autoatendimento [#nog-geen-zelfbediening]

Ainda não encontra o Exact Online em **Definições > Integrações**. A escolha da administração, o mapeamento do razão e a primeira exportação são feitos em conjunto com o suporte da Tillor. Não existe um formulário de instalação para preencher por si.

<Callout type="warn" title="Um sistema de contabilidade ativo">
A Tillor exporta para um pacote de contabilidade por organização. Se já utiliza o Admisol ou o Odoo, acertamos qual o sistema que continua ativo.
</Callout>

## Pedir [#aanvragen]

1. Anote a sua administração do Exact Online (divisão) e se o seu contabilista acompanha.
2. Peça a ligação através de [tillor.eu/demo](https://tillor.eu/demo) ou **support@tillor.eu**.
3. A Tillor planeia a ativação e o mapeamento de diários e contas de proveitos.

## Ver também [#zie-ook]

<Cards>
  <Card title="Admisol" href="/boekhouden/betalingsrapporten/boekhoudsystemen/admisol" />
  <Card title="Odoo" href="/boekhouden/betalingsrapporten/boekhoudsystemen/odoo" />
  <Card title="Sistemas de contabilidade" href="/boekhouden/betalingsrapporten/boekhoudsystemen" />
</Cards>


# Resumo (/pt-PT/boekhouden/betalingsrapporten/boekhoudsystemen)

A Tillor suporta a integração com software de contabilidade para o envio de relatórios de pagamentos. Os relatórios de pagamentos são convertidos para o formato do seu pacote de contabilidade (atualmente o Admisol) e enviados de forma automática ou manual. O [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) está disponível a pedido.

## Sistemas suportados [#ondersteunde-systemen]

| Sistema | Estado |
|---------|--------|
| [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) | Suportado |
| [Odoo](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo) | Clientes e faturas lançadas |
| [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) | A pedido |

## Geral [#algemeen]

- **Automático**: na criação ou numa atualização relevante de um relatório de pagamentos, este é enviado para o Admisol (apenas se o Admisol estiver instalado)
- **Manual**: em **Administração > Relatórios de pagamentos** → abra o relatório → **Enviar para a contabilidade**
- **Que pagamentos**: apenas **Mollie** e **transferências internas**. As contas bancárias constam do relatório da Tillor, mas não seguem para a exportação contabilística.

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Relatório de pagamentos - envio manual para a contabilidade" />

## Ver também [#zie-ook]

<Cards>
  <Card title="Admisol" href="/boekhouden/betalingsrapporten/boekhoudsystemen/admisol" />
  <Card title="Odoo" href="/boekhouden/betalingsrapporten/boekhoudsystemen/odoo" />
  <Card title="Exact Online" href="/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online" />
</Cards>


# Odoo (/pt-PT/boekhouden/betalingsrapporten/boekhoudsystemen/odoo)

A ligação ao Odoo no Tillor exporta **clientes** e **faturas lançadas** para o Odoo. Os relatórios de pagamentos para o Odoo chegam numa versão posterior; até lá, utilize o [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) se quiser enviar automaticamente os relatórios de pagamentos.

## Instalação [#installatie]

1. Aceda a **Definições** e abra o App Marketplace.
2. Procure o cartão **Odoo** e clique em **Instalar**.
3. Preencha primeiro, em **Ligação**:
   - **URL do Odoo** - por exemplo `https://mijnbedrijf.odoo.com` ou apenas `mijnbedrijf` (o Tillor completa então o URL `.odoo.com`)
   - **Nome de utilizador** - utilizador com acesso à API
   - **Chave API** - chave API (Odoo: perfil do utilizador > chaves API)
4. Clique em **Continuar para a base de dados**. O Tillor obtém as bases de dados disponíveis (ou permite-lhe introduzir o nome manualmente).
5. Escolha a base de dados em **Base de dados** e conclua a instalação.

Ao guardar, o Tillor testa a ligação.

<Callout type="info" title="Um único sistema de contabilidade ativo">
Se o Admisol e o Odoo estiverem ambos instalados, o Tillor utiliza o **Admisol** para a exportação (prioridade fixa). Instale o Odoo apenas se já não utilizar o Admisol.
</Callout>

## Parâmetros de contabilidade (app Odoo) [#boekhoudparameters-odoo-app]

Após a instalação, defina os parâmetros de exportação em **Definições** na app Odoo (além do URL, da base de dados, do utilizador e da chave API). O Tillor obtém em direto, a partir do Odoo, os diários de vendas e as contas de proveitos; escolhe-os através de um campo de pesquisa (código e nome).

| Campo na app | Predefinição | Significado |
|---|---|---|
| **Código do diário de vendas** | INV | Diário de vendas no Odoo com este código |
| **Conta de proveitos predefinida** | 700000 | Conta de proveitos quando a linha da fatura não tem número de razão próprio |
| **Registar faturas automaticamente** | desativado | Registar logo no Odoo após a exportação |
| **Anexar PDF da fatura** | ativado | PDF da fatura do Tillor como anexo da fatura no Odoo |
| **Anexar UBL Peppol** | ativado | UBL Peppol como anexo adicional (apenas se o Tillor já tiver esse UBL) |

Para cada linha de fatura, o Tillor procura primeiro uma conta do Odoo com o mesmo código que o **número de razão** da linha; caso contrário, usa a conta de proveitos predefinida. Para o IVA, o Tillor procura no Odoo um IVA de vendas com a mesma percentagem que a da linha.

### Regimes de IVA [#btw-regimes]

Uma linha de fatura com um [regime sem IVA](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw), como a autoliquidação, precisa no Odoo de um IVA de vendas próprio: um 0% normal vai parar à grelha errada da sua declaração. Por isso, nas definições de exportação, introduza para cada regime que utiliza o **nome do IVA de vendas no Odoo**, exatamente como aparece no Odoo em **Contabilidade > Configuração > Impostos** (num Odoo belga, por exemplo, `0% EU S` para serviços na UE). Existem cinco campos: autoliquidação (serviços na UE), autoliquidação (cocontratante), entrega intracomunitária, exportação para fora da UE e isento de IVA.

Se o campo de um regime estiver vazio ou o IVA não existir no Odoo, a exportação dessa fatura termina com uma mensagem de erro. Introduza o nome e envie a fatura novamente.

## PDF da fatura no Odoo [#factuur-pdf-in-odoo]

Com **Anexar PDF da fatura** (ativado por predefinição), o Tillor carrega o mesmo PDF que existe no Tillor. Numa nova exportação, isso acontece **antes** do lançamento no Odoo, para que a pré-visualização possa ser associada à direita da fatura. O nome do ficheiro segue o número da fatura do Tillor (p. ex. `INV_2026_0001.pdf`). O Tillor define também esse PDF como anexo principal da fatura no Odoo.

Nos **Eventos** da fatura do Tillor pode ver se a exportação foi bem-sucedida, incluindo cliente, fatura, PDF e UBL.

- Se a fatura do Odoo já existir (mesma referência: o número da fatura do Tillor), o Tillor atualiza o cliente, as linhas, as datas e a referência de pagamento. Se a fatura já estava lançada no Odoo, o Tillor repõe-na primeiro como rascunho, ajusta os dados e volta a lançá-la quando **Registar faturas automaticamente** está ativado ou a fatura já estava lançada.
- Depois, os anexos PDF e UBL são substituídos ou adicionados, quando essas opções estão ativadas.
- Se o carregamento falhar após a criação de uma fatura em rascunho, essa fatura do Odoo é eliminada, para que uma exportação seguinte possa tentar de novo.

## UBL Peppol no Odoo [#peppol-ubl-in-odoo]

Com **Anexar UBL Peppol** (ativado por predefinição), o Tillor carrega o UBL Peppol como anexo adicional da fatura no Odoo. O nome do ficheiro segue o número da fatura do Tillor (p. ex. `INV_2026_0001.xml`).

- O Tillor não gera UBL por si: o ficheiro só fica disponível após uma entrega Peppol bem-sucedida.
- Se o UBL ainda não estiver pronto no momento da exportação, o Tillor ignora o anexo UBL; assim que o UBL chegar, é colocado na fatura do Odoo já existente.
- Se o carregamento do UBL falhar, a exportação completa para o Odoo **não** falha (ao contrário do PDF). Apenas um erro de PDF após uma fatura nova reverte o rascunho do Odoo.

## Faturas [#facturen]

- Ao **lançar** ou **relançar** uma fatura, o Tillor exporta-a automaticamente para o Odoo.
- Manualmente: ações da fatura > exportar para a contabilidade (o mesmo botão que no Admisol).
- Apenas as faturas com o estado **Lançada** são exportadas.
- Se já existir uma fatura do Odoo com o mesmo número de fatura do Tillor, não é criada uma segunda fatura. O Tillor atualiza o cliente, as linhas e as datas nessa fatura (por exemplo, após a mudança para outro cliente ou um relançamento) e substitui os anexos PDF/UBL quando essas opções estão ativadas.
- Se o PDF da fatura mudar após um **pagamento** (ou outro montante no documento), o Tillor substitui o anexo PDF existente no Odoo assim que o novo PDF estiver pronto. Não surge uma segunda fatura no Odoo e nenhum pagamento é lançado no Odoo.

## Clientes [#klanten]

Os clientes são atualizados ou criados no Odoo com o número de cliente do Tillor como referência. Os parceiros existentes com o mesmo número são atualizados.

## Relatórios de pagamentos [#betalingsrapporten]

O envio automático e manual de relatórios de pagamentos para o Odoo **ainda não está disponível**. O processo diário de relatórios de pagamentos ignora o Odoo sem mensagem de erro.

## Requisitos no Odoo [#vereisten-in-odoo]

- Diário de vendas com o código definido (por predefinição `INV`)
- Contas de razão com códigos que correspondam às linhas do Tillor ou à conta de proveitos predefinida
- Opcional: taxas de IVA de vendas no Odoo com as mesmas percentagens que no Tillor

## Ver também [#zie-ook]

<Cards>
  <Card title="Admisol" href="/boekhouden/betalingsrapporten/boekhoudsystemen/admisol" />
  <Card title="Exact Online" href="/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online" />
  <Card title="Sistemas de contabilidade" href="/boekhouden/betalingsrapporten/boekhoudsystemen" />
</Cards>


# Resumo (/pt-PT/boekhouden/betalingsrapporten)

Um **relatório de pagamento** é um resumo diário dos pagamentos de um único dia civil. Numeração: `PAYR/YYYY/DDDD` (dia do ano, quatro algarismos; p. ex. `PAYR/2026/0054`).

**Conteúdo:** pagamentos conhecidos e desconhecidos, o pagamento do Mollie (se aplicável) e transações bancárias não associadas das suas contas bancárias. Um pagamento do Mollie chama-se, na contabilidade, um settlement: o montante que o Mollie deposita na sua conta bancária por um conjunto de pagamentos.

O seu contabilista trabalha com estes relatórios. Não precisa de os criar nem de os encerrar. Veja também [Como tudo se liga](/boekhouden#hoe-hangt-dit-samen).

## Rascunho e definitivo [#concept-en-definitief]

Um relatório tem um **estado**:

| Estado | Significado |
|--------|-------------|
| **Rascunho** | O relatório do **dia em curso**. Os pagamentos de hoje (transferências internas, numerário, contas bancárias e Mollie) já são associados a ele e o relatório já segue para a contabilidade. Os pagamentos do Mollie aparecem como **adiantamento**: dinheiro que o Mollie ainda tem de pagar. Ainda não existe settlement do Mollie e o relatório ainda não é impresso automaticamente. |
| **Definitivo** | O dia está encerrado. O Tillor associou o settlement do Mollie (se aplicável), imprimiu o relatório e enviou a versão definitiva para a contabilidade. |

O relatório em rascunho de hoje surge automaticamente: na execução das 09:00 ou antes, assim que registar o primeiro pagamento manual ou pagamento de conta bancária desse dia. Nunca precisa de tornar um rascunho definitivo; é o Tillor que o faz na execução diária seguinte, depois de o dia terminar.

Reconhece um rascunho pelo **número de relatório cinzento com sublinhado ponteado** e pelo selo **Rascunho**, na lista (coluna e filtro **Estado**), na página de detalhe e em todo o lado onde se faz ligação ao relatório. O PDF de um rascunho tem **(rascunho)** no título. O número do relatório e a data de lançamento na contabilidade mantêm-se quando o rascunho passa a definitivo.

### Pagamentos do Mollie no rascunho [#mollie-betalingen-op-het-concept]

Cada pagamento do Mollie efetuado e ainda não pago pelo Mollie entra de imediato no relatório em rascunho aberto. Na contabilidade, o total aparece como **adiantamento ao fornecedor Mollie**: assim vê em qualquer momento quanto ainda tem a receber do Mollie.

Um **débito direto SEPA ainda em curso** conta da mesma forma, mesmo que a cobrança só siga para o Mollie dentro de alguns dias. A fatura já aparece no Tillor como paga (em processamento) e assim aparece também na contabilidade. Se a cobrança falhar ou for cancelada, o pagamento desaparece do rascunho.

Quando o rascunho passa a definitivo, o Tillor compara o relatório com o settlement do Mollie:

- Os pagamentos que **estão no settlement** ficam no relatório. O adiantamento é substituído pelo pagamento real, com os custos bancários.
- Os pagamentos que **não** estão (por exemplo, cartão de crédito com pagamento posterior, ou receitas após o fecho do Mollie) passam para o **relatório em rascunho seguinte** e aí ficam como adiantamento.
- Se um pagamento do settlement já estava num rascunho posterior, o Tillor traz-o de volta para o relatório do settlement.

Só são considerados pagamentos recentes: pagos no último mês e ainda sem settlement no Mollie.

Os **reembolsos** contam de imediato. Um reembolso que o Mollie ainda não deduziu de um pagamento aparece como linha negativa no rascunho aberto. Na contabilidade continuam a ser dois adiantamentos distintos ao Mollie: um para os pagamentos ainda a receber e outro para os reembolsos ainda por deduzir; não são compensados entre si. Isto também se aplica quando o pagamento original já consta de um relatório definitivo mais antigo: o Mollie deduz então o montante num pagamento posterior. Assim que um settlement compensa o reembolso, este fica no relatório desse settlement e desaparece do rascunho.

<Callout type="info" title="Rascunho na contabilidade">
Um rascunho segue para a contabilidade assim que tiver algo que a contabilidade lança (um pagamento do Mollie ou uma transferência interna). Depois, o Tillor só o volta a enviar se o lançamento mudar, sempre com o mesmo número de documento. As alterações são agrupadas: o envio parte cerca de dez segundos após a última alteração e, no máximo, após um minuto, de modo que, por exemplo, atribuir um pagamento a uma fatura resulte num único envio. Um rascunho apenas com pagamentos em numerário ou de contas bancárias não é, por isso, enviado, e um pagamento em numerário adicional não provoca novo envio.
</Callout>

## Geração diária [#dagelijkse-generatie]

Em cada **dia útil às 09:00** (segunda a sábado, fuso horário Europa/Bruxelas), o Tillor processa todos os relatórios de **1 de janeiro até ontem** que ainda faltam ou ainda são **rascunho**, **do mais antigo para o mais recente**: os rascunhos tornam-se definitivos e os dias em falta são logo criados como relatório definitivo. Para cada relatório, o Tillor aguarda a resposta do Admisol (sucesso ou erro) antes de processar e enviar o seguinte. Depois, o Tillor abre o **relatório em rascunho de hoje**. Por cada organização com ligação Mollie ativa segue-se uma sincronização **limitada**: relatórios **sem** settlement do Mollie, desde **um mês civil antes de ontem** até ontem (veja [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie)).

```mermaid
flowchart TD
  start[Start werkdag 09:00] --> create[Concepten t/m gisteren definitief maken<br/>ontbrekende dagen aanmaken]
  create --> manual[Handmatige en bankrekeningbetalingen<br/>op rapportdag koppelen]
  manual --> rollover[Niet-uitbetaalde Mollie-betalingen<br/>naar volgend concept]
  rollover --> concept[Conceptrapport van vandaag openen]
  concept --> mollieCheck{Mollie actief?}
  mollieCheck -- nee --> done[Klaar]
  mollieCheck -- ja --> sync[Rapporten zonder settlement<br/>afgelopen maand bijwerken]
  sync --> done
```

### O que contém um relatório? [#wat-zit-in-een-rapport]

| Origem | Quando é associado |
|------|-------------------|
| Pagamentos manuais | Dia civil da data de criação (Bruxelas) |
| Pagamentos de contas bancárias | Dia civil da data de pagamento (Bruxelas) |
| Mollie | Settlement do dia de relatório D (veja [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie)) |

Os pagamentos de contas bancárias **constam** do relatório do Tillor desse dia, mas **não** seguem para a exportação contabilística (apenas Mollie e transferências internas).

### Ontem sem settlement do Mollie [#gisteren-zonder-mollie-settlement]

O relatório de **ontem** ainda tem de ser tornado definitivo (ou criado) e o Mollie ainda não tem settlement para ontem nem para hoje? Então o Tillor **aguarda** até ao dia útil seguinte; entretanto o relatório fica em **rascunho**. Os dias mais antigos sem settlement recebem um relatório (manual/contas bancárias); o Mollie é associado mais tarde na sincronização.

<Callout type="warn" title="Fim de semana">
As receitas de sábado e domingo recebem muitas vezes o settlement do Mollie apenas na manhã de segunda-feira. Esse settlement pertence ao relatório de **domingo** (regra D+1), não ao de segunda-feira. Veja [exemplos na página do Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie#voorbeelden).
</Callout>

## Exemplos [#voorbeelden]

| Situação | O que vê |
|----------|-----------|
| Dia útil, settlement na manhã seguinte | O relatório de **ontem** recebe ainda o Mollie (regra D+1) |
| Transferência interna registada hoje | Fica logo no **relatório em rascunho de hoje** e segue para a contabilidade |
| Pagamento do Mollie recebido hoje | Fica logo no rascunho, na contabilidade como adiantamento ao Mollie |
| Pagamento do Mollie que não está no settlement do relatório | Passa para o rascunho seguinte quando o relatório se torna definitivo |
| Relatório de ontem ainda em rascunho, sem settlement | O Tillor **aguarda** que o Mollie publique (dia útil seguinte às 09:00); o relatório continua em rascunho |
| Relatório existia sem Mollie | A execução das 09:00 seguinte completa settlement + pagamentos |
| Relatório já tinha um id de settlement | O id **mantém-se**; só podem ainda ser associados pagamentos adicionais |

Mais exemplos de datas (fim de semana, settlement duplicado): [Mollie > Exemplos](/boekhouden/betalingsrapporten/betaalmethodes/mollie#voorbeelden).

## Abrir e navegar num relatório de pagamento [#betalingsrapport-openen-en-navigeren]

1. Aceda a **Administração > Relatórios de pagamento** (marca verde **1** na captura de ecrã).
2. Abra um relatório na lista.
3. Na página de detalhe, utilize as setas na barra de ações à direita para ir para o relatório anterior ou seguinte.

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-reports-list.png" alt="Lista de relatórios de pagamento" />

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-report-detail.png" alt="Detalhe do relatório de pagamento - Enviar para a contabilidade e setas de navegação" />

Ao passar o rato sobre uma seta, vê contexto adicional (número do relatório, data e número de pagamentos) do relatório para onde vai navegar.

À direita na página de detalhe encontra-se o **Registo de eventos**. Aí vê quando o relatório foi criado, quando foi tornado definitivo e se foi enviado para a contabilidade.

## Problemas? [#problemen]

<Accordions>
<Accordion title="O relatório de ontem continua em Rascunho">
O Mollie ainda não publicou um pagamento para ontem. O Tillor aguarda então até ao dia útil seguinte às 09:00. O relatório torna-se definitivo sozinho, não tem de fazer nada.
</Accordion>
<Accordion title="Um pagamento não está no relatório do dia que esperava">
Um pagamento entra no relatório do dia em que foi recebido. Em numerário e transferência, é a **Data de receção** que preencheu. Ajuste essa data ao registar, veja [Numerário e transferência](/betalingsverwerking/contant).
</Accordion>
<Accordion title="Um pagamento do Mollie está no relatório seguinte">
O pagamento não estava no pagamento do relatório. Passa para o rascunho seguinte e aí fica como adiantamento até o Mollie pagar.
</Accordion>
<Accordion title="O relatório não está na minha contabilidade">
Só seguem pagamentos do Mollie e transferências internas. Um relatório apenas com pagamentos em numerário ou de contas bancárias não é enviado. Um erro no envio encontra-o no **Registo de eventos** do relatório.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Sistemas de contabilidade" href="/boekhouden/betalingsrapporten/boekhoudsystemen" />
  <Card title="Métodos de pagamento" href="/boekhouden/betalingsrapporten/betaalmethodes" />
</Cards>

## Glossário [#begrippen]

- **Relatório de pagamento**: o resumo diário dos pagamentos de um único dia civil, com o número `PAYR/ano/dia`.
- **Rascunho**: o relatório do dia em curso. Ainda pode mudar.
- **Definitivo**: o dia está encerrado e o relatório foi enviado para a contabilidade.
- **Adiantamento**: um pagamento do Mollie que o Mollie ainda não pagou.
- **Settlement**: o pagamento do Mollie a si.


# Resumo (/pt-PT/boekhouden)

Aqui transfere pagamentos e faturas do Tillor para o seu software de contabilidade. O Tillor agrupa os pagamentos por dia num relatório de pagamento e reencaminha-o, para que o seu contabilista não tenha de copiar nada.

<Callout type="info" title="Bom saber">
- Existe um relatório de pagamento por dia civil. O relatório de hoje já existe como **Rascunho** e torna-se definitivo assim que o dia termina.
- O Tillor processa os relatórios em cada dia útil (segunda a sábado) às 09:00, hora belga.
- Apenas os pagamentos do Mollie e as transferências internas seguem para a contabilidade. Numerário, transferências e contas bancárias constam do relatório, mas não são reencaminhados.
- Os pagamentos do Mollie são atualizados a cada 15 minutos, as contas bancárias a cada 5 minutos.
- O Mollie paga normalmente no dia seguinte. O fim de semana recebe muitas vezes o pagamento apenas na manhã de segunda-feira.
- O Tillor agrupa as alterações a um rascunho e envia-o cerca de dez segundos após a última alteração e, no máximo, após um minuto.
- Um cliente belga com número de IVA precisa de um ID Peppol antes de poder lançar uma fatura.
</Callout>

## Como tudo se liga [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  F[Geboekte factuur] --> B[Betaling]
  B --> R[Betalingsrapport van de dag]
  R -- Mollie en interne overboekingen --> X[Boekhoudsoftware]
  R -- Bankrekeningen en contant --> O[Alleen overzicht in Tillor]
```

- Um pagamento está associado a uma fatura. Veja [Faturas](/facturen).
- Cada pagamento entra no relatório do dia em que foi recebido.
- Um pagamento do Mollie aparece primeiro como adiantamento no relatório em rascunho. Assim que o Mollie paga, esse adiantamento passa a ser o pagamento real.
- O relatório segue para o seu software de contabilidade. Quais os sistemas possíveis, leia em [Sistemas de contabilidade](/boekhouden/betalingsrapporten/boekhoudsystemen).

## O que faz? [#wat-doet-het]

- **Relatórios de pagamento**: resumos diários com o número `PAYR/YYYY/DDDD`, em que DDDD é o dia do ano
- **Sistemas de contabilidade**: ligação com o Admisol, o Odoo para clientes e faturas (os relatórios de pagamentos para o Odoo chegam mais tarde) e o [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) a pedido
- **Métodos de pagamento**: Mollie, contas bancárias e transferências internas

**Exemplo:** a receita de **20 de maio** é paga a **21 de maio** e consta do relatório **`PAYR/2026/0140` (20 de maio)**. Mais exemplos: [exemplos do Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie#voorbeelden).

Na aplicação web vê os pagamentos e as faturas como abaixo.

<DocScreenshot src="/screenshots/betalingen/payments-list.png" alt="Lista de pagamentos - Todos os pagamentos" />

<DocScreenshot src="/screenshots/facturen/invoices-list.png" alt="Lista de faturas - Todas as faturas" />

## Ver também [#zie-ook]

<Cards>
  <Card title="Relatórios de pagamento" href="/boekhouden/betalingsrapporten" />
  <Card title="Sistemas de contabilidade" href="/boekhouden/betalingsrapporten/boekhoudsystemen" />
  <Card title="Métodos de pagamento" href="/boekhouden/betalingsrapporten/betaalmethodes" />
  <Card title="IVA e impostos" href="/boekhouden/belasting" />
  <Card title="Peppol" href="/boekhouden/peppol" />
  <Card title="Exemplos práticos" href="/praktijk" />
</Cards>

## Glossário [#begrippen]

- **Relatório de pagamento**: o resumo diário dos pagamentos de um único dia civil.
- **Rascunho**: o relatório do dia em curso, que ainda pode mudar.
- **Definitivo**: um relatório encerrado que foi enviado para a contabilidade.
- **Pagamento (settlement)**: o montante que o Mollie deposita na sua conta bancária por um conjunto de pagamentos.
- **Adiantamento ao Mollie**: dinheiro que o Mollie ainda lhe deve pagar, tal como consta na contabilidade.
- **Razão**: o número de conta na sua contabilidade. Veja [Produtos](/producten).
- **Peppol**: a rede europeia para enviar faturas diretamente para o sistema do destinatário. Veja [Peppol](/boekhouden/peppol).


# Peppol (/pt-PT/boekhouden/peppol)

Com o Peppol, envia uma fatura diretamente para o sistema de contabilidade do destinatário, sem PDF. O Peppol é a rede europeia de faturação eletrónica. No Tillor, isto acontece automaticamente: se um cliente tiver um ID Peppol, a fatura segue sozinha após ser lançada.

## Quando utilizar o Peppol? [#wanneer-gebruik-je-peppol]

O Peppol é obrigatório para:

- **Faturas B2B belgas** - o envio de faturas a empresas belgas com número de IVA
- **Contratos públicos** - faturação a entidades públicas na maioria dos países da UE

Para clientes neerlandeses, o Peppol é opcional mas suportado.

<Callout type="warn">
A partir de 2026, o Peppol é obrigatório para todas as faturas B2B na Bélgica. Certifique-se de que os IDs Peppol dos seus clientes belgas estão corretamente definidos.
</Callout>

## Configurar o Peppol [#peppol-instellen]

### Peppol para a sua organização [#peppol-voor-je-organisatie]

O Peppol utiliza o **número de IVA** e a **morada** da sua organização. Verifique que estes dados estão corretos em **Definições**.

No primeiro envio via Peppol, o Tillor regista automaticamente a sua organização como remetente na rede Peppol.

<Callout type="info">
Contacte o apoio do Tillor se o Peppol ainda não estiver disponível para a sua organização.
</Callout>

### Definir o ID Peppol de um cliente [#peppol-id-instellen-voor-een-klant]

Para cada cliente a quem quer faturar via Peppol:

1. Aceda a *Clientes > [cliente] > Faturação*
2. Abra **Definições de faturação**
3. Introduza o **ID Peppol** ou escolha um destinatário através do ícone de pesquisa
4. Clique em **Guardar**

<Callout type="warn">
Tem um cliente belga com número de IVA? Então não pode lançar uma fatura enquanto não existir um ID Peppol definido.
</Callout>

## Procurar um destinatário Peppol [#een-peppol-ontvanger-opzoeken]

Não sabe o ID Peppol de um cliente? Utilize o ícone de pesquisa à esquerda do campo:

1. Aceda a *Clientes > [cliente] > Faturação*
2. Clique no ícone de pesquisa à esquerda de **ID Peppol**
3. O Tillor pesquisa automaticamente com base no número de IVA do cliente
4. Selecione o destinatário correto nos resultados

<Callout type="info">
Nem todas as empresas estão registadas na rede Peppol. Se uma empresa não for encontrada, pode na mesma enviar a fatura por e-mail.
</Callout>

## Enviar faturas via Peppol [#facturen-via-peppol-versturen]

Quando um cliente tem um ID Peppol definido, o Tillor envia a fatura automaticamente via Peppol após o lançamento:

1. Crie a fatura como habitualmente
2. Verifique que o **ID Peppol** do cliente está corretamente definido
3. Verifique as linhas e os montantes na fatura em rascunho e depois clique em **Lançar fatura**

<DocScreenshot src="/screenshots/facturen/invoice-draft-detail.png" alt="Fatura em rascunho com Lançar fatura" />

4. O Tillor envia a fatura automaticamente através da rede Peppol (normalmente poucos minutos após o lançamento)

### Verificar o estado do envio [#verzendstatus-controleren]

Abra a fatura lançada e veja os **Eventos** no painel direito. Aí vê se a fatura foi enviada via Peppol ou se o envio ou a entrega falhou.

## O que acontece depois? [#wat-gebeurt-er-daarna]

- A fatura é enviada automaticamente assim que a lança. Não tem de enviar nada.
- Uma fatura enviada via Peppol recebe a etiqueta **Enviada via Peppol** na lista do perfil do cliente.
- Uma fatura assim já não pode ser reposta como rascunho nem movida para outro cliente. Corrige-a com uma nota de crédito. Veja [Corrigir uma fatura](/facturen/corrigeren).
- Se o envio falhar, vê-o em **Eventos** na fatura e surge uma mensagem em <UIPath>Comunicação > Notificações</UIPath>. Envie então a fatura por e-mail, veja [Enviar uma fatura](/facturen/versturen).

## Problemas? [#problemen]

<Accordions>
<Accordion title="A fatura não pode ser lançada porque o cliente não tem ID Peppol">
O cliente é belga e tem um número de IVA. Preencha o ID Peppol em <UIPath>Clientes > cliente > Faturação</UIPath>, **Definições de faturação**. Se não souber o ID, utilize o ícone de pesquisa à esquerda do campo.
</Accordion>
<Accordion title="Não encontro o destinatário nos resultados da pesquisa">
Nem todas as empresas estão ligadas ao Peppol. Envie então a fatura por e-mail.
</Accordion>
<Accordion title="A fatura não foi enviada via Peppol">
Verifique se o ID Peppol do cliente está preenchido antes de lançar.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Faturas" href="/facturen" description="Criar e lançar faturas" />
  <Card title="IVA e impostos" href="/boekhouden/belasting" description="Validar números de IVA" />
  <Card title="Contabilidade" href="/boekhouden" description="Resumo financeiro" />
</Cards>


# Enviar uma fatura ou um lembrete (/pt-PT/communicatie/e-mails)

Com **Enviar notificação** envia uma fatura lançada ao cliente. Com **Enviar lembrete** lembra o cliente de uma fatura em aberto. Escolhe você o canal: e-mail, SMS, correio ou WhatsApp, e depois acompanha a entrega em [Notificações](/notificaties).

O Tillor não envia estas mensagens sozinho ao lançar. É você que decide quando o cliente recebe algo. Se quiser que aconteça automaticamente, pode fazê-lo com uma [automatização](/begrippen#automatisering).

Antes de começar:

- A fatura tem de estar **lançada**. Numa fatura em rascunho, o botão não aparece.
- O cliente tem pelo menos um endereço de e-mail, um número de telefone ou uma morada postal completa (rua, código postal e localidade). Caso contrário, não vê **Enviar notificação**.
- Para um lembrete, tem de existir ainda um montante em aberto. Uma fatura paga não oferece a opção **Enviar lembrete**.
- Por canal, o dado correspondente tem de ser conhecido. Caso contrário, o canal aparece a cinzento, com a mensagem **Nenhum endereço de e-mail registado**, **Nenhum número de telefone registado** ou **Nenhuma morada postal registada**.

## Enviar uma fatura [#een-factuur-versturen]

<Steps>
<Step>
### Abra a fatura [#open-de-factuur]
Aceda a <UIPath>Administração > Faturas</UIPath> e abra uma fatura lançada.

<DocScreenshot src="/screenshots/communicatie/invoice-send-notification-button.png" alt="Fatura lançada com o botão Enviar notificação na barra de ações" />
</Step>
<Step>
### Clique em Enviar notificação [#klik-op-verstuur-notificatie]
Abre-se a janela **Enviar notificação**. Escolha os canais pelos quais o cliente recebe a fatura.

<DocScreenshot src="/screenshots/communicatie/invoice-send-notification.png" alt="A janela Enviar notificação com E-mail, SMS e Correio" />
</Step>
<Step>
### Escolha os canais e clique em Enviar [#kies-de-kanalen-en-klik-op-versturen]
O Tillor indica **Notificação enviada**. Se não resultar, vê **Notificação não enviada**.
</Step>
</Steps>

Os canais funcionam assim:

| Canal | O que o cliente recebe |
|---|---|
| **E-mail** | Está ativado por predefinição. A fatura segue em PDF com a mensagem, para o endereço de e-mail do perfil do cliente |
| **SMS** | Um texto curto com a ligação pessoal para a fatura |
| **Correio** | A fatura como carta para a morada postal do perfil do cliente. Está desativado por predefinição. O Tillor mostra um valor indicativo de porte por carta |
| **WhatsApp** | Aparece se tiver ligado o WhatsApp Business. Se a janela de 24 horas do cliente estiver fechada e não tiver método de pagamento na Meta, o Tillor bloqueia o envio |

## Enviar um lembrete [#een-aanmaning-versturen]

<Steps>
<Step>
### Abra o menu junto a Enviar notificação [#open-het-menu-naast-verstuur-notificatie]
Clique na seta junto ao botão e escolha **Enviar lembrete**.
</Step>
<Step>
### Escolha os canais [#kies-de-kanalen]
Num lembrete, o **SMS** está ativado por predefinição se o cliente tiver número de telefone. Se escolher **Correio**, o cliente recebe uma carta de lembrete com a fatura em anexo e um código QR na carta. Veja [Enviar uma fatura](/facturen/versturen).

<DocScreenshot src="/screenshots/facturen/invoice-reminder-dialog.png" alt="Enviar lembrete com a escolha de Correio e registado" />
</Step>
<Step>
### Confirme [#bevestig]
Clique em **Enviar**. Se também escolheu **Correio registado com aviso de receção**, aparece **Enviar com custo extra**. Esta opção só existe se o correio registado for suportado no país da morada postal. O Tillor repercute os custos extra na sua organização.
</Step>
</Steps>

## O que acontece depois? [#wat-gebeurt-er-daarna]

- A mensagem aparece em <UIPath>Comunicação > Notificações</UIPath> com canal, estado e uma ligação para a fatura. Também a vê no cliente.
- O e-mail e o SMS começam em <Status tone="info">Pendente</Status> e passam a <Status tone="success">Enviado</Status> assim que são entregues. O cliente pode ler a mensagem e clicar na ligação. Ambos os eventos aparecem na janela de detalhe.
- No correio, o estado passa a <Status tone="success">Enviado</Status> quando o serviço postal confirma que a carta está a caminho ou foi entregue. No correio vê o valor do porte no momento do envio e, no correio registado, também o montante extra.
- Se uma mensagem ficar parada mais de 5 minutos, o Tillor tenta de novo. Passados 2 dias sem envio, fica <Status tone="error">Falhado</Status>.
- Se a mensagem falhar, a fatura mantém-se como estava. Pode sempre enviar de novo.

Quer que o Tillor reaja por si, por exemplo avisando um colega quando um lembrete falha? Para isso pode criar uma [automatização](/begrippen#automatisering).

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não vejo o botão Enviar notificação">
A fatura ainda é um rascunho, ou o cliente não tem endereço de e-mail, número de telefone nem morada postal completa. Lance a fatura ou preencha um desses dados no perfil do cliente.
</Accordion>
<Accordion title="Não vejo Enviar lembrete no menu">
A fatura já está paga ou ainda não foi lançada. Um lembrete só pode ser enviado para uma fatura lançada com um montante ainda em aberto.
</Accordion>
<Accordion title="Um canal está a cinzento com Nenhum endereço de e-mail registado">
O dado em falta no perfil do cliente. Adicione o endereço de e-mail, o número de telefone ou a morada postal e abra a janela de novo.
</Accordion>
<Accordion title="O Tillor indica Notificação não enviada">
Abra <UIPath>Comunicação > Notificações</UIPath> e clique no canal da mensagem. Na janela de detalhe está a mensagem de erro. Na maioria dos casos, o endereço ou número está incorreto. Corrija-o no perfil do cliente e envie de novo.
</Accordion>
<Accordion title="Não vejo Correio registado em Correio">
O envio registado só é possível para moradas postais em países onde o Tillor o suporta. Para outras moradas, o correio normal continua possível.
</Accordion>
<Accordion title="O cliente diz que não recebeu nada">
Veja o estado em <UIPath>Comunicação > Notificações</UIPath>. Se a mensagem estiver em **Devolvido**, o endereço não existe. Se estiver em **Enviado**, peça ao cliente que verifique o spam. Veja [Notificações](/notificaties#problemen).
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Notificações" href="/notificaties" description="Estado de entrega das mensagens enviadas" />
  <Card title="Tipos de notificação" href="/communicatie/notificatietypes" description="Todos os tipos de mensagens que o Tillor envia" />
  <Card title="Enviar uma fatura" href="/facturen/versturen" description="Correio, código QR e cartas de lembrete" />
</Cards>


# Resumo (/pt-PT/communicatie)

Em Comunicação acompanha tudo o que é dito ou enviado entre o seu parque e os seus clientes: chamadas telefónicas, mensagens que o Tillor envia e notas internas. Aqui decide também que mensagens vão para um cliente e vê se chegaram. As conversas que os clientes iniciam por chat ou redes sociais estão na [caixa de entrada](/inbox).

<DocScreenshot src="/screenshots/communicatie/providers/voys/calls-overview.png" alt="Lista de chamadas telefónicas em Comunicação" />

<Callout type="info" title="Bom saber">
- Uma mensagem de fatura ou um lembrete nunca sai sozinho ao lançar. É você quem o inicia, ou uma [automatização](/begrippen#automatisering)
- Se uma mensagem ficar parada mais de 5 minutos, o Tillor tenta de novo. Passados 2 dias sem envio, fica em **Falhado**
- Um SMS com os dados da organização só pode ser enviado durante uma chamada em curso, a partir do painel em baixo à direita
- Uma nova mensagem na caixa de entrada aparece como cartão em baixo à direita e desaparece após cerca de dez segundos
- As chamadas telefónicas só chegam depois de o Voys estar instalado e o plano de chamadas apontar para o Tillor
</Callout>

## Como tudo se liga [#hoe-hangt-dit-samen]

Toda a comunicação com um cliente reúne-se no perfil do cliente. O que sai e o que entra passa por vários canais.

```mermaid
flowchart LR
  K[Klant] -->|belt| T[Telefoongesprekken]
  K -->|chat, WhatsApp, Messenger, Instagram| I[Inbox]
  P[Park] -->|factuur of aanmaning| N[Notificaties]
  N -->|e-mail, sms, post, WhatsApp| K
  P -->|interne opmerking| O[Opmerkingen]
  T --> KP[Klantprofiel]
  I --> KP
  N --> KP
```

- As **chamadas** chegam através do seu fornecedor de telefone e ficam associadas ao cliente pelo número de telefone.
- As **mensagens de clientes** por chat ou redes sociais chegam à caixa de entrada.
- As **mensagens para clientes** envia-as a partir de uma fatura. A entrega acompanha-a em Notificações.
- As **notas** são internas. Os clientes não as veem.

## Componentes [#onderdelen]

<Cards>
  <Card title="Caixa de entrada" href="/inbox" description="WhatsApp, Messenger, Instagram e chat do website num só lugar" />
  <Card title="Chamadas telefónicas" href="/communicatie/telefoongesprekken" description="Acompanhar chamadas, ouvir gravações e enviar dados por SMS" />
  <Card title="Enviar uma fatura ou um lembrete" href="/communicatie/e-mails" description="Enviar você mesmo uma mensagem a um cliente" />
  <Card title="Notificações" href="/notificaties" description="Ver o estado de entrega das mensagens enviadas" />
  <Card title="Tipos de notificação" href="/communicatie/notificatietypes" description="Todos os tipos de mensagens e quando são enviadas" />
  <Card title="Notas" href="/notities" description="Notas internas em clientes, faturas e outros registos" />
  <Card title="Fornecedores" href="/communicatie/providers" description="Voys e Twilio: quem telefona e quem envia os SMS" />
</Cards>

## Glossário [#begrippen]

- **Fornecedor de telefone**: a empresa que fornece a sua linha telefónica, por exemplo o Voys.
- **Notificação**: uma mensagem que o Tillor envia a um cliente ou [utilizador](/begrippen#gebruiker).
- **Canal**: o caminho por onde segue uma mensagem, como e-mail, SMS, correio ou WhatsApp.
- **Caixa de entrada**: o local onde chegam as mensagens de clientes por chat e redes sociais.
- **Nota**: uma nota interna num [cliente](/begrippen#klant), fatura ou outro registo.

Mais termos estão no [glossário](/begrippen).


# Tipos de notificação (/pt-PT/communicatie/notificatietypes)

Esta lista mostra cada tipo de mensagem que pode encontrar na [lista de notificações](/notificaties) e quando o Tillor a envia. Vê o tipo na coluna **Tipo** e pode filtrar por ele com o filtro **Tipo**. Os nomes correspondem ao ecrã.

As mensagens a clientes seguem por e-mail, SMS, correio ou WhatsApp. As mensagens a colegas seguem por push, e-mail ou telefone, conforme as preferências desse colega. Veja [Avisos na aplicação](/notificaties#meldingen-in-de-app).

<Callout type="info" title="As mensagens de fatura não saem sozinhas">
Mensagens como **Nova fatura** ou **Lembrete de fatura** não são enviadas pelo Tillor automaticamente ao lançar uma fatura. É você que as inicia com **Enviar notificação** ou **Enviar lembrete** na fatura. Veja [Enviar uma fatura ou um lembrete](/communicatie/e-mails).
</Callout>

## Faturas e pagamentos [#facturen-en-betalingen]

| Tipo | Quando é enviado |
|---|---|
| Nova fatura | Para o cliente, quando envia uma fatura. A fatura segue em anexo à mensagem |
| Fatura paga | Para o cliente, quando uma fatura é paga |
| Lembrete de fatura | Para o cliente, como lembrete de uma fatura em aberto |
| Lembrete de transferência bancária manual | Para o cliente que paga por transferência, com a dica de utilizar a referência estruturada |
| Arquivo de faturas | Para o endereço de apoio da sua organização, com o seu contabilista em cópia, quando um arquivo de faturas está pronto |
| Falha no envio da fatura Peppol | Quando uma fatura não pôde ser enviada via Peppol |
| Falha ao enviar fatura para o software de contabilidade | Quando o reencaminhamento de uma fatura para o seu software de contabilidade falha |
| Envio da fatura para o software de contabilidade recuperado | Quando esse reencaminhamento acabou por resultar, após avisos anteriores |
| Falha ao enviar relatório de pagamento para o software de contabilidade | Quando o reencaminhamento de um relatório de pagamentos falha |
| Faturas revertidas registadas novamente | Quando faturas repostas foram automaticamente lançadas de novo durante a noite |
| Pagamento bancário que não liquida a fatura | Quando um pagamento bancário foi associado a uma fatura, mas a fatura continua depois em aberto |
| Consumo muito acima do habitual, retido da faturação automática | Quando um cliente não foi faturado automaticamente porque a eletricidade ou a água está muito acima do habitual |
| Preço de produto agendado aplicado | Para a sua organização, no dia em que entra em vigor um [preço agendado](/producten/prijzen-plannen). O preço antigo e o novo aparecem lado a lado |
| Reembolso automático de arranque de máquina | Quando um pagamento online por um arranque de máquina foi devolvido porque a máquina não arrancou |
| Revisão de pagamentos NFC offline | Quando os pagamentos NFC offline não puderam ser verificados após a sincronização |
| Saldo baixo da etiqueta NFC | Para o cliente, quando o saldo de uma etiqueta NFC está baixo |

## Mandatos SEPA e assinatura [#sepa-mandaten-en-ondertekenen]

| Tipo | Quando é enviado |
|---|---|
| Pedido de assinatura de mandato SEPA | Para o cliente com a ligação para assinar o mandato, também para os lembretes antes de a ligação expirar |
| Código de verificação do mandato SEPA | Para o cliente com o código que introduz na página de assinatura, por SMS ou e-mail |
| Cópia do mandato SEPA assinado | Para o cliente, assim que o mandato fica ativo |
| Mandato SEPA revogado | Para o cliente, com o documento assinado novamente em anexo |
| Pedido de assinatura | Para um signatário quando chega a sua vez, por e-mail ou por SMS se não houver endereço de e-mail |
| Código de assinatura | Para o signatário com o código para assinar, por SMS ou e-mail |
| Documento assinado | Para todos os signatários com o PDF assinado, assim que o último assinou |
| Assinatura recusada | Para o colega que enviou o pedido, quando um signatário recusa |
| Aceitação do DPA | Confirmação da aceitação do DPA, com o DPA assinado em anexo |
| Código de verificação do DPA | Por SMS para o responsável com o código para aceitar o acordo de subcontratação |

## Contadores, controladores e acesso [#meters-controllers-en-toegang]

| Tipo | Quando é enviado |
|---|---|
| Alarme de contador ou controlador | Quando um contador tem um novo alarme |
| Alarme de contador ou controlador resolvido | Quando um alarme de contador foi resolvido |
| Remoção de contador | Quando contadores foram removidos |
| Contadores que precisam de atenção | Resumo de contadores cujas leituras não chegam ou que têm um alarme há muito tempo |
| Controlador offline | Quando um controlador não dá sinal de vida há mais de 5 minutos |
| Controlador sobreaquecido | Aviso urgente quando um controlador aquece demasiado |
| Conector offline | Quando o conector do seu parque deixa de dar sinal de vida |
| Conector novamente online | Quando o conector volta a estar acessível |
| Gateway HTTP do conector indisponível | Quando o conector ainda funciona, mas as câmaras já não o alcançam |
| Câmara LPR offline | Quando uma câmara de matrículas não responde há mais de 5 minutos |
| Ponto de acesso aberto há demasiado tempo | Quando um ponto de acesso fica aberto mais tempo do que o permitido |
| Resumo de saídas com matrícula expirada | Resumo de veículos com um período de acesso expirado que saíram enquanto a receção estava fechada |
| Código de acesso QR | Para o cliente com o código QR para o acesso |
| Tablet ou quiosque offline | Quando um tablet ou quiosque não dá sinal de vida fora do seu período de descanso |
| Bateria fraca em tablet ou quiosque | Quando um tablet ou quiosque está quase sem bateria e não está a carregar |

## Tarefas, notas e caixa de entrada [#taken-opmerkingen-en-inbox]

| Tipo | Quando é enviado |
|---|---|
| Tarefa atribuída | Para o colega a quem foi atribuída uma tarefa |
| Tarefa desatribuída | Para o colega a quem foi retirada uma tarefa |
| Tarefa concluída | Quando uma tarefa é concluída |
| Lembrete de tarefa | Quando chega o momento de lembrete de uma tarefa |
| Prazo da tarefa | Quando uma tarefa atinge o seu prazo sem estar terminada |
| Resumo diário de uma vista | Por e-mail, o resumo diário de uma vista de tarefas que segue |
| Resposta a comentário | Alguém respondeu a um comentário |
| Menção em comentário | Foi mencionado num comentário |
| Comentário resolvido | Um comentário foi marcado como resolvido |
| Resposta ao comentário recusada | Quando uma resposta por e-mail a um comentário não foi publicada porque o endereço do remetente não corresponde |
| Mensagem da caixa de entrada | Quando chega uma nova mensagem à caixa de entrada |
| Transferência urgente da IA | Quando o assistente de IA lhe transfere uma conversa urgente |
| Seguimento do chat do website | Para um visitante do website com uma resposta por ler, com uma ligação para retomar a conversa |

## Automatizações e integrações [#automatiseringen-en-integraties]

| Tipo | Quando é enviado |
|---|---|
| Mensagem de automação | Texto que uma automatização envia a um cliente |
| Aviso de automação | Aviso que uma automatização envia a um colega, por push, e-mail ou ambos |
| Execução de automatização falhou | Para o criador de uma automatização quando uma execução terminou com um erro |
| Entrega de webhook a falhar | Quando as entregas ao seu webhook falham e o Tillor continua a tentar de novo |
| Entrega de webhook falhou definitivamente | Quando o Tillor, após todas as tentativas, não conseguiu entregar um evento de webhook |
| Notificação externa | Mensagem que um sistema ligado enviou ele próprio, veja [Notificações externas](/notificaties#externe-notificaties) |

Um webhook é uma ligação com a qual o Tillor transmite automaticamente um evento a outro sistema.

## Conta e organização [#account-en-organisatie]

| Tipo | Quando é enviado |
|---|---|
| Boas-vindas ao utilizador | Mensagem de boas-vindas para um novo utilizador |
| Verificação do e-mail | A ligação para confirmar um endereço de e-mail |
| Convite para a organização | Convite para alguém sem conta Tillor se tornar membro da sua organização |
| Dados da organização | SMS para quem telefona com uma ligação para os dados da sua organização |
| Submissão do formulário de contacto | Quando alguém preenche o formulário de contacto |
| Lembrete de horário em feriados | Lembrete para preencher o horário de funcionamento de um feriado próximo |
| Documento eliminado | Para o utilizador que eliminou um documento |

## Avisos da equipa Tillor [#meldingen-van-het-tillor-team]

Estas mensagens destinam-se à equipa Tillor e normalmente não as vê: **Incidente do sistema**, **Alerta de segurança**, **Alerta do Grafana** e **Falha do gateway LoRa**.

## Ver também [#zie-ook]

<Cards>
  <Card title="Notificações" href="/notificaties" description="Estado de entrega e avisos na aplicação" />
  <Card title="Enviar uma fatura ou um lembrete" href="/communicatie/e-mails" description="Enviar você mesmo uma mensagem" />
  <Card title="Automatizações" href="/automatiseringen" description="Mensagens por uma automatização" />
</Cards>


# Resumo (/pt-PT/communicatie/providers)

Através de um fornecedor de telefone como o Voys, o Tillor vê quem telefona e guarda chamadas, gravações e transcrições. Liga o fornecedor em <UIPath>Definições > Integrações</UIPath>. O Twilio não é um fornecedor de telefone: envia os SMS do Tillor e foi configurado pelo próprio Tillor.

<DocScreenshot src="/screenshots/communicatie/providers/marketplace-overview.png" alt="Definições > Integrações" />

## Fornecedores disponíveis [#beschikbare-providers]

<Cards>
  <Card
    title="Voys"
    href="/communicatie/providers/voys"
    description="Associe as chamadas telefónicas recebidas a perfis de clientes"
  />
  <Card
    title="Twilio"
    href="/communicatie/providers/twilio"
    description="Entrega de SMS e WhatsApp através de definição da plataforma"
  />
  <Card title="Caixa de entrada" href="/inbox" description="Messenger e WhatsApp Business para a caixa de entrada omnicanal" />
</Cards>


# Twilio (/pt-PT/communicatie/providers/twilio)

O Twilio envia, em nome do Tillor, os SMS e, se estiver configurado, as notificações por WhatsApp. Não é um fornecedor de telefonia como o Voys e não o instala você mesmo: o Tillor configurou-o para toda a plataforma.

## Diferença em relação ao Voys [#verschil-met-voys]

| | Voys | Twilio |
|---|---|---|
| Telefonia (telefonar, chamadas) | Sim | Não |
| Configuração no Tillor | **Definições > Integrações** | Não - definição da plataforma |
| Visível para os utilizadores | Chamadas, gravações, transcrições | SMS enviados e notificações por WhatsApp |

## O que faz o Twilio no Tillor? [#wat-doet-twilio-in-tillor]

Assim que o Twilio está configurado, o Tillor utiliza-o, entre outras coisas, para:

- Enviar **notificações por SMS** (por exemplo lembretes de pagamento, confirmações de reserva e notificações de fatura)
- Enviar **dados da organização por SMS** a partir de **Comunicação > Chamadas telefónicas** (botão de SMS com a dica **Enviar os dados da organização ao autor da chamada por SMS**)
- Entregar **notificações por WhatsApp** quando o WhatsApp está configurado através do Twilio na plataforma
- Utilizar **códigos de verificação por SMS** ao assinar o acordo de tratamento de dados (DPA)

Os SMS e as notificações por WhatsApp enviados acompanha-os em **Comunicação > Notificações**:

<DocScreenshot src="/screenshots/notificaties/notifications-overview.png" alt="Lista de notificações - estado de entrega das mensagens" />

<Callout type="info">
Configurar o Twilio não é algo que faça você mesmo no Tillor. Peça ao administrador da plataforma ou ao apoio do Tillor a ligação correta para o seu ambiente.
</Callout>

## Sem instalação em Integrações [#geen-installatie-in-integraties]

Ao contrário do Voys, o Twilio **não** o encontra em **Definições > Integrações**. A ligação é gerida pelo administrador do ambiente Tillor.

## Ver também [#zie-ook]

<Cards>
  <Card
    title="Telefonia Voys"
    href="/communicatie/providers/voys"
    description="Integração de telefonia para chamadas"
  />
  <Card
    title="Chamadas telefónicas"
    href="/communicatie/telefoongesprekken"
    description="Enviar dados da organização por SMS"
  />
</Cards>


# Telefonia Voys (/pt-PT/communicatie/providers/voys)

Com a integração Voys, o Tillor vê quem está a ligar e mostra logo os dados do cliente. As chamadas, gravações e transcrições ficam depois em [Chamadas telefónicas](/communicatie/telefoongesprekken). O Voys é um fornecedor de telefonia para empresas.

Antes de começar:

- Precisa de uma conta VoIP Voys ativa e de acesso às definições do plano de chamadas no Voys.
- Precisa da permissão **Gerir integrações**.
- O número de telefone de quem liga tem de constar do perfil do cliente ou de uma pessoa de contacto, caso contrário o Tillor não associa a chamada a um cliente.

<DocScreenshot src="/screenshots/communicatie/providers/voys/incoming-call.png" alt="Chamada recebida no painel" />

## Configurar o Voys [#voys-instellen]

1. Vá a **Definições** (barra lateral, em **Apoio**)

<DocScreenshot src="/screenshots/communicatie/providers/voys/marketplace-nav.png" alt="Navegação para Definições" />

2. Escolha **Integrações** e abra **Voys** na lista
3. Na página de detalhe, preencha os seus dados do Voys (`username`, `password`, `client_uuid`, `token`) e clique em **Instalar**

Precisa de uma conta VoIP Voys ativa.

<DocScreenshot src="/screenshots/communicatie/providers/voys/marketplace-voys.png" alt="Definições > Integrações - Voys na lista" />

<Callout type="info">
Depois da instalação e da configuração, o Tillor associa automaticamente as chamadas aos clientes quando o número de telefone corresponde a um cliente ou contacto.
</Callout>

## Encontrar os URLs para o Voys [#urls-voor-voys-terugvinden]

O Tillor e o Voys comunicam entre si através de endereços (URLs). Em alguns passos, o Voys pede uma resposta ao Tillor, por exemplo se está aberto. Essa resposta é **ACK** (sim, continuar) ou **NAK** (não, seguir o outro caminho). Um webhook é um endereço que o Voys chama durante uma chamada.


Para webhooks, identificação do nome de quem liga e códigos de acesso, utilize os URLs que o Tillor gera para si.

1. Vá a **Definições > Integrações** e abra **Voys**
2. Depois da instalação, na página de detalhe, em **Definições**, está o bloco **URLs a configurar** - copie aí o URL certo para cada finalidade

Encontra aqui, entre outros:

- **Notificações de conversas** - URL de webhook para eventos de chamadas
- **Webhook para identificação do chamador** - URL para a identificação do nome de quem liga (caller name lookup) no seu plano de chamadas do Voys
- **Lista telefónica XML** - URL para os telefones VoIP obterem a lista telefónica
- **Códigos de acesso** - URL para comandar o ponto de acesso (cancela, portão ou porta) através do plano de chamadas
- **Webhook de horário de abertura** - ACK se o Tillor está aberto, NAK se o Tillor está fechado
- **Webhook de chamador permitido** - ACK se a chamada pode ser reencaminhada, NAK se quem liga deve ir para o correio de voz
- **Webhook de encaminhamento** - ACK com um destino, NAK se não estiver definido nenhum destino

No plano de chamadas do Voys, utilize as mesmas variáveis que estão indicadas no Tillor (como `{callerid}`, `{did}`, `{callername}`, `{callid}` e `{code}`).

<DocScreenshot src="/screenshots/communicatie/providers/voys/config-urls-dialog.png" alt="Detalhe do Voys - URLs a configurar na página" />

## Configurar as notificações de conversas no Voys [#gespreksnotificaties-in-voys-configureren]

1. No Voys, abra o módulo [Notificações de conversas](https://freedom.voys.nl/redirect/CallNotification)
2. Clique em **Adicionar**
3. Em package/service, escolha **Personalizado**
4. Cole o URL do Tillor de **Notificações de conversas**
5. Guarde

Documentação do Voys:

- [Notificações de conversas](https://help.voys.nl/gespreksnotificaties)

## Configurar os nomes de quem liga (caller lookup) no plano de chamadas [#bellernamen-caller-lookup-in-call-plan-configureren]

Para a identificação do nome de quem liga, utilize no Voys um passo de webhook no plano de chamadas.

1. No Tillor, abra o URL **Webhook para identificação do chamador** (em **Definições > Integrações > Voys**, em **URLs a configurar**) e copie-o
2. No Voys, abra o módulo [Webhooks](https://help.voys.nl/webhooks) e crie um webhook com este modelo de URL
3. Ative esse webhook no seu plano de chamadas através do passo de webhook
4. No modelo de URL, utilize as variáveis que o Voys suporta (`{callerid}`, `{did}`, `{callername}` e, se necessário, `{code}`)
5. Na definição do encaminhamento do webhook, configure **Variável nome do chamador** para que o nome devolvido seja mostrado nos telefones

Os webhooks de horário de abertura e de encaminhamento não fazem identificação do nome de quem liga. Para isso, utilize este passo separado.

Mais informação:

- [Webhooks](https://help.voys.nl/webhooks)
- [O que são notificações de conversas (diferença em relação aos webhooks)](https://help.voys.nl/gespreksnotificaties)

## Horário de abertura e destinos no plano de chamadas [#openingsuren-en-bestemmingen-in-het-belplan]

O Tillor é a fonte do horário de abertura, das férias e das exceções por feriado. O Voys já não precisa de conhecer esse calendário.

1. Em **Definições > Integrações > Voys**, escolha o telefone Voys para **aberto** e, opcionalmente, para **fechado**
2. Copie o **Webhook de horário de abertura** ou o **Webhook de encaminhamento** de **URLs a configurar**
3. No Voys, crie um [webhook](https://help.voys.nl/webhooks) com esse modelo de URL
4. Coloque esse webhook como passo do plano de chamadas, **acima** de eventuais menus de escolha
5. Deixe **Utilizar menu** desativado

Dois padrões:

- **Webhook de horário de abertura** - `status=ACK` segue o caminho **HTTP e menu bem-sucedidos** (aberto), `status=NAK` segue **HTTP ou menu falhado** (fechado). Se estiver definido um destino para aberto, este vai com o ACK como `destination`.
- **Webhook de encaminhamento** - o Tillor escolhe o destino. No passo bem-sucedido, configure **Variável destino final**. ACK + `destination` se houver um destino, caso contrário NAK.

Em caso de erro ou timeout, o Voys segue o caminho falhado. Trate isso como fechado.

Documentação do Voys: [Webhooks](https://help.voys.nl/webhooks).

## Enviar automaticamente os chamadores para o correio de voz [#bellers-automatisch-naar-voicemail-sturen]

Com o **Webhook de chamador permitido**, o Voys decide, para cada chamador, se uma chamada é reencaminhada. O Tillor verifica se o número de quem liga pertence a um cliente que tem o correio de voz automático ativado.

Primeiro, configure o plano de chamadas:

1. Copie o **Webhook de chamador permitido** de **URLs a configurar**, em **Definições > Integrações > Voys**
2. No Voys, crie um [webhook](https://help.voys.nl/webhooks) com esse modelo de URL
3. Coloque esse webhook como passo do plano de chamadas, **acima** dos passos que reencaminham a chamada
4. Deixe **Utilizar menu** desativado
5. Encaminhe o caminho **HTTP e menu bem-sucedidos** para o seu encaminhamento normal e o caminho **HTTP ou menu falhado** para o correio de voz
6. Em **Definições > Integrações > Voys**, em **Encaminhamento de chamadas**, assinale **Correio de voz automático no Voys**

Enquanto estiver desativado, não vê **Enviar chamadas para o correio de voz** no perfil do cliente.

Depois, ative o correio de voz automático para cada cliente:

1. Abra o perfil do cliente e vá ao separador **Comunicação**
2. Em **Definições de comunicação**, assinale a opção **Enviar chamadas para o correio de voz**
3. Clique em **Guardar**

Assim funciona a resposta:

- **ACK** - quem liga pode passar. Isto também vale para números desconhecidos e para chamadores com número oculto.
- **NAK** - o número pertence a um cliente com correio de voz automático. O Voys segue o caminho falhado.

O Tillor compara o número de quem liga com o número de telefone no perfil do cliente, independentemente de espaços ou da notação do indicativo do país. Os números de telefone das pessoas de contacto não contam.

<Callout type="warn">
Em caso de erro ou timeout, o Voys também segue o caminho falhado. Nesse caso, todos os chamadores vão temporariamente para o correio de voz, e não apenas os bloqueados. Por isso, utilize um destino de correio de voz cujas mensagens verifique regularmente.
</Callout>

Este webhook não tem em conta o horário de abertura. Combine-o com o webhook de horário de abertura ou de encaminhamento, colocando ambos como passos separados no plano de chamadas.

Documentação do Voys: [Webhooks](https://help.voys.nl/webhooks).

## Encaminhamento fixo por chamador [#vaste-routering-per-beller]

O mesmo **Webhook de encaminhamento** pode reencaminhar logo um chamador para um telefone Voys próprio, uma extensão ou um número de telefone. Isto só vale para clientes para os quais escolheu um destino, e só se **Encaminhamento fixo no Voys** estiver ativado.

1. Coloque o **Webhook de encaminhamento** no plano de chamadas, como no horário de abertura
2. No passo bem-sucedido, configure **Variável destino final**
3. Em **Definições > Integrações > Voys**, em **Encaminhamento de chamadas**, assinale **Encaminhamento fixo no Voys**

Enquanto estiver desativado, não vê **Encaminhamento fixo de chamadas** no perfil do cliente. O webhook utiliza então apenas o telefone para aberto ou fechado.

Depois, defina o destino para cada cliente:

1. Abra o perfil do cliente e vá ao separador **Comunicação**
2. Em **Encaminhamento fixo de chamadas**, escolha um telefone Voys ou **Outro** para um número de telefone ou extensão (por exemplo 411)
3. Escolha **Nenhum** para desativar o encaminhamento fixo
4. Clique em **Guardar**

Assim o webhook de encaminhamento escolhe o destino:

- Se existir um destino fixo para este chamador, esse é o `destination`.
- Caso contrário, o `destination` é o telefone Voys para aberto ou fechado.
- **NAK** - não existe destino fixo nem telefone para o estado atual. Isto também vale para números desconhecidos e para chamadores com número oculto, enquanto não houver telefone para aberto ou fechado.

O Tillor compara o número de quem liga com o número de telefone no perfil do cliente, independentemente de espaços ou da notação do indicativo do país. Os números de telefone das pessoas de contacto não contam.

Em caso de erro ou timeout, o Voys segue o caminho falhado.

Documentação do Voys: [Webhooks](https://help.voys.nl/webhooks).

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- Cada chamada que entra ou sai fica em <UIPath>Comunicação > Chamadas telefónicas</UIPath>, com o cliente associado se o número corresponder. Veja [Chamadas telefónicas](/communicatie/telefoongesprekken).
- Numa chamada recebida, quem liga aparece como cartão no canto inferior direito do Tillor, com os dados do cliente.
- As gravações e transcrições chegam assim que a chamada termina, se as gravações de chamadas estiverem ativadas na sua conta Voys.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não vejo o bloco URLs a configurar">
O bloco só aparece depois da instalação. Clique primeiro em **Instalar** na página de detalhe do Voys.
</Accordion>
<Accordion title="Não chegam chamadas ao Tillor">
O Voys só reencaminha as chamadas se o módulo Notificações de conversas utilizar o URL **Notificações de conversas** do Tillor. Verifique no Voys se esse URL lá está e se vem do bloco **URLs a configurar**.
</Accordion>
<Accordion title="O nome de quem liga não aparece no telefone">
Verifique se o webhook de identificação do nome de quem liga está no plano de chamadas e se **Variável nome do chamador** está configurada no passo bem-sucedido. Os webhooks de horário de abertura e de encaminhamento não procuram nomes.
</Accordion>
<Accordion title="Não vejo Enviar chamadas para o correio de voz no perfil do cliente">
Assinale primeiro **Correio de voz automático no Voys** em <UIPath>Definições > Integrações > Voys</UIPath>, em **Encaminhamento de chamadas**. Só depois a opção aparece no separador **Comunicação** do cliente. O mesmo vale para **Encaminhamento fixo de chamadas**.
</Accordion>
<Accordion title="De repente, todos os chamadores vão para o correio de voz">
Em caso de erro ou timeout de um webhook, o Voys segue o caminho falhado. Verifique se o Tillor está acessível e se o URL no webhook ainda está correto. Veja o aviso em [Enviar automaticamente os chamadores para o correio de voz](#bellers-automatisch-naar-voicemail-sturen).
</Accordion>
<Accordion title="Uma chamada não pertence a nenhum cliente">
O Tillor compara o número com o número de telefone no perfil do cliente. Os números das pessoas de contacto contam para a associação das chamadas, mas não para o correio de voz e o encaminhamento fixo.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card
    title="Chamadas telefónicas"
    href="/communicatie/telefoongesprekken"
    description="Ações de chamada, como os dados da organização por SMS"
  />
  <Card title="Gestão de clientes" href="/klantenbeheer" description="Perfis de clientes e dados de contacto" />
  <Card title="Twilio" href="/communicatie/providers/twilio" description="Como são enviados os SMS" />
</Cards>


# Chamadas telefónicas (/pt-PT/communicatie/telefoongesprekken)

Em <UIPath>Comunicação > Chamadas telefónicas</UIPath> encontra todas as chamadas que entram ou saem através do seu fornecedor de telefonia, com o cliente associado quando o Tillor reconhece o número. Utilize a página para acompanhar as chamadas e, durante uma chamada em curso, enviar por SMS os dados da sua organização a quem liga.

Antes de começar:

- As chamadas só aparecem depois de ter instalado e configurado o [Voys](/communicatie/providers/voys). Sem ligação, a lista fica vazia.
- As gravações e transcrições só existem se as gravações de chamadas estiverem ativadas na sua conta Voys.
- O botão de SMS numa chamada em curso só funciona se o envio de SMS estiver configurado para o seu ambiente. Veja [Twilio](/communicatie/providers/twilio).

## Ver as chamadas [#gesprekken-bekijken]

<DocScreenshot src="/screenshots/communicatie/providers/voys/calls-overview.png" alt="Vista geral das chamadas telefónicas" />

Na tabela **Todas as chamadas** vê, para cada chamada:

| Coluna | O que vê |
|---|---|
| **Direção** | **Recebida** ou **Efetuada** |
| **Iniciada em** | Data e hora |
| **De** e **Para** | Os números de telefone |
| **Duração** | A duração da chamada, depois de terminar |
| **Cliente** | O cliente associado, ou um nome indicado pelo Voys (não verificado) se não houver cliente associado |
| **Estado** | Em que ponto está a chamada |

O Tillor associa uma chamada a um cliente com base no número de telefone. Se o número ainda não pertence a nenhum cliente, adicione-o ao perfil do cliente ou a uma pessoa de contacto. As novas chamadas ficam então associadas automaticamente.

Uma chamada passa por estes estados:

| Estado | Significado |
|---|---|
| <Status tone="info">Criada</Status> | A chamada acabou de começar |
| <Status tone="info">A tocar</Status> | O telefone está a tocar |
| <Status tone="warning">Atendida</Status> | Alguém atendeu |
| <Status tone="warning">Em curso</Status> | A chamada está em curso |
| <Status tone="warning">Transferência assistida</Status> e <Status tone="warning">Transferência direta</Status> | A chamada foi transferida, com ou sem anúncio |
| <Status>Desligada</Status> e <Status>Terminada</Status> | A chamada terminou |
| <Status tone="error">Falhado</Status> | A chamada não chegou a ser estabelecida |

## Enviar os dados da organização por SMS [#organisatiegegevens-via-sms-versturen]

Alguém que liga pede a sua morada ou o horário de abertura? Envie-os por SMS em poucos segundos, enquanto a chamada decorre.

<Steps>
<Step>
### Espere até a chamada estar em curso [#wacht-tot-het-gesprek-loopt]
A ação está no painel de chamadas ativas, em baixo à direita, e não na lista. A chamada tem de estar no estado **Em curso**. Num telefone, toque primeiro no ícone de telefone em cima à direita.
</Step>
<Step>
### Expanda a chamada [#klap-het-gesprek-uit]
Se a chamada estiver recolhida, expanda-a.
</Step>
<Step>
### Clique no ícone de mensagem [#klik-op-het-berichtenpictogram]
A dica diz **Enviar os dados da organização ao autor da chamada por SMS**.
</Step>
<Step>
### Escolha o idioma [#kies-de-taal]
O Tillor assinala com *(detetado)* o idioma que reconhece em quem liga. Escolha o idioma do SMS.
</Step>
</Steps>

Quem liga recebe uma ligação curta para uma página pública com os dados da sua organização. Se a morada da sua organização estiver preenchida, aparecem também botões de rota para **Waze**, **Google Maps** e **Apple Maps**. O botão de e-mail nessa página já tem assunto e texto da mensagem, com o número e a hora da chamada quando são conhecidos. A ligação para o site recebe etiquetas de rastreio, para que possa medir quantas pessoas clicam.

## Gravações e transcrições [#opnames-en-transcripties]

<Steps>
<Step>
### Abra a chamada [#open-het-gesprek]
Na lista, clique em **Transcrição** na chamada. Abre-se a janela **Detalhes da chamada**.
</Step>
<Step>
### Escolha um separador [#kies-een-tabblad]
Em **Gravação**, a chamada é reproduzida no seu navegador. Em **Transcrição** está o texto escrito por interlocutor, e em **Resumo** um resumo curto.
</Step>
</Steps>

O Tillor cria a transcrição e o resumo por si assim que a chamada termina e existe uma gravação. Demora um pouco. Numa chamada sem gravação, não há separadores.

<Callout type="warn">
As gravações de chamadas podem conter informação sensível do ponto de vista da privacidade. Garanta que cumpre a legislação de privacidade (RGPD) ao gravar chamadas e informe quem liga de que as chamadas são gravadas.
</Callout>

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- Depois de terminar, uma chamada fica na lista com a duração, o cliente e, se existir gravação, uma transcrição e um resumo.
- Um SMS enviado com dados da organização fica em <UIPath>Comunicação > Notificações</UIPath> com o tipo **Dados da organização**.

## Problemas? [#problemen]

<Accordions>
<Accordion title="A lista de chamadas está vazia">
Verifique se o Voys está instalado em <UIPath>Definições > Integrações</UIPath> e se as notificações de conversas no Voys apontam para o URL do Tillor. Veja [Telefonia Voys](/communicatie/providers/voys).
</Accordion>
<Accordion title="Uma chamada não pertence a nenhum cliente">
O Tillor compara o número de quem liga com o número de telefone no perfil do cliente ou de uma pessoa de contacto. Adicione o número e as novas chamadas ficam associadas. As chamadas que já entraram mantêm-se como estavam.
</Accordion>
<Accordion title="Não encontro o botão de SMS">
O botão só está no painel de chamadas ativas, em baixo à direita, e só enquanto a chamada estiver no estado **Em curso**. Na lista desta página não existe.
</Accordion>
<Accordion title="Não vejo o separador Gravação">
O Voys não gravou a chamada. Ative as gravações de chamadas na sua conta Voys. As chamadas anteriores não podem ser gravadas depois.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Telefonia Voys" href="/communicatie/providers/voys" description="Instalar o Voys e configurar o plano de chamadas" />
  <Card title="Twilio" href="/communicatie/providers/twilio" description="Como são enviados os SMS" />
  <Card title="Notificações" href="/notificaties" description="Estado de entrega dos SMS enviados" />
</Cards>


# Connector (/pt-PT/connector)

O Tillor Connector é uma pequena caixa na rede do seu parque. Liga o Tillor aos dispositivos no local: impressoras de talões, cancelas, controladores de acesso e leitores de identificação. Sem o connector, o Tillor não consegue comandar esses dispositivos. Se estiver desligado, imprimir e comandar cancelas a partir do Tillor não funciona. Como avançar nesse caso está em [Problemas](#problemen).

O Tillor fornece o connector pré-configurado e acompanha-o à distância. Não tem de instalar nem atualizar nada.

<Callout type="info" title="Bom saber">
- Cada organização tem um connector. Se gere vários parques, cada parque (organização) recebe a sua própria caixa.
- O connector comunica com o Tillor de 15 em 15 segundos.
- Se o Tillor não ouvir nada dele durante 3 minutos, a equipa do Tillor recebe automaticamente um aviso.
- O Tillor instala as atualizações por si, sem que tenha de fazer nada.
- O connector estabelece por si próprio uma ligação segura de saída. Não tem de abrir portas no seu router.
</Callout>

## Como se relaciona tudo isto? [#hoe-hangt-dit-samen]

O connector fica entre o Tillor na internet e os dispositivos na sua própria rede. O Tillor envia uma ordem ao connector, e o connector executa-a no dispositivo certo. No sentido inverso, o connector comunica o que aconteceu, por exemplo uma matrícula lida.

```mermaid
flowchart LR
  T[Tillor] <-->|ligação segura através da internet| C[Connector no seu parque]
  C --> P[Impressora de talões]
  C --> S[Cancela ou controlador de acesso]
  C --> I[Leitor de identificação]
```

Por exemplo:

- Imprime um talão ou uma etiqueta. O Tillor envia-o ao connector, que o coloca na sua impressora.
- Dá a um cliente um método de acesso. O Tillor envia a alteração através do connector para os controladores de acesso, veja [Controlo de acessos](/toegangscontrole#hoe-hangt-dit-samen).
- Um hóspede digitaliza um cartão de identificação no check-in. O connector envia a leitura para o Tillor, veja [Leituras de identificação](/identiteitsscans).

## O que o Tillor faz por si [#wat-tillor-voor-je-doet]

- **Entrega**: a caixa chega pré-configurada para a sua organização.
- **Instalação e ligação**: ligamos as suas impressoras, cancelas e scanners durante o arranque.
- **Atualizações**: as novas versões são instaladas automaticamente, sem interrupção.
- **Monitorização**: o Tillor vê se o connector está ligado e dá o alerta por si em caso de falha.

## O que precisa de ter [#wat-je-zelf-nodig-hebt]

- Uma tomada perto do seu equipamento de rede
- Um cabo de rede para o seu router ou switch, na mesma rede que as suas impressoras e cancelas
- Uma ligação à internet estável

## Dispositivos ligados [#gekoppelde-apparaten]

- **Impressoras**: veja [Impressora](/printer) para configurar e utilizar.
- **Cancelas, portões e controladores de acesso**: veja [Controlo de acessos](/toegangscontrole).
- **Leitores de identificação**: veja [Leituras de identificação](/identiteitsscans) para criar clientes a partir de uma leitura e os prazos de conservação.

<Callout type="info" title="Para o leitor técnico">
Na rede do seu parque pode ver o estado do connector em `http://[adres-van-de-connector]:3000/`. Aí vê a ligação ao Tillor, a fila de impressão e as últimas matrículas lidas. O suporte do Tillor dá-lhe o endereço na instalação. Mais sobre o protocolo está em [MQTT](/ontwikkelaars/mqtt).
</Callout>

## Problemas? [#problemen]

<Accordions>
<Accordion title="O connector não está ligado">
Verifique se a caixa recebe corrente e se o cabo de rede está bem encaixado. Veja se a internet no seu parque funciona. Depois retire a ficha da caixa por instantes e volte a ligá-la. Se o problema continuar, contacte o suporte do Tillor. Normalmente, vemos uma falha logo por nós.
</Accordion>
<Accordion title="Não consigo imprimir nem comandar uma cancela">
Veja primeiro o estado do connector, consulte a dica técnica acima. Verifique se o dispositivo está ligado e na mesma rede. Se o connector estiver ligado e o dispositivo acessível mas não acontecer nada, contacte o suporte.
</Accordion>
<Accordion title="Os novos métodos de acesso não chegam à cancela">
Veja em **Operações do controlador** na página Controlo de acessos. Se uma ordem ficar em **Pendente**, o connector está offline.
</Accordion>
</Accordions>

## Conceitos [#begrippen]

- **Connector**: a caixa no seu parque que liga o Tillor aos seus dispositivos.
- **Controlador de acesso**: uma caixa junto a uma cancela que lê etiquetas e códigos QR.
- **Solução gerida**: o Tillor fornece, configura e mantém a caixa por si.

Mais explicações estão no [glossário](/begrippen).

## Ver também [#zie-ook]

<Cards>
  <Card title="Controladores" href="/controllers" description="Leitores de etiquetas em duches, portas e pontos de carregamento" />
  <Card title="Impressora" href="/printer" description="Configurar e utilizar impressoras" />
  <Card title="Controlo de acessos" href="/toegangscontrole" description="Cancelas e métodos de acesso" />
  <Card title="Leituras de identificação" href="/identiteitsscans" description="Digitalizar cartões de identificação no check-in" />
</Cards>


# Documentos (/pt-PT/documenten)

Com a gestão de documentos guarda ficheiros junto de um cliente, como apólices de seguro, cartões de identidade, contratos, licenças e outros anexos. Os ficheiros que ainda não pertencem a ninguém ficam na lista central de documentos até os associar a um cliente. Comece por [Documentos de um cliente](#documenten-bij-een-klant) ou por [A lista central de documentos](#de-centrale-documentenlijst).

<Callout type="info" title="Bom saber">
- Um ficheiro pode ter no máximo 250 MB.
- Pode carregar PDF, Word, mensagens do Outlook (.msg), Excel, PowerPoint, imagens (JPEG, PNG, GIF) e ficheiros de texto.
- O Tillor converte as imagens em PDF depois do carregamento. Os outros tipos de ficheiro ficam como estão, com uma pré-visualização em PDF ao lado.
- Quando um documento é eliminado, recebe uma cópia como anexo no seu endereço de e-mail, se o ficheiro tiver podido ser guardado em segurança.
- Um PDF que pertence a um pedido de assinatura, e o PDF assinado, podem ser arquivados mas não eliminados.
- Um documento arquivado continua guardado, mas já não aparece entre os documentos ativos.
</Callout>

## Como se relaciona tudo isto? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  U[Carregamento ou e-mail] --> C[Lista central de documentos]
  C -->|Associar a cliente| K[Documentos do cliente]
  K --> S[Pedido de assinatura]
  S --> O[PDF assinado junto do cliente]
  M[Mandato SEPA] --> K
```

Um documento está num só sítio: ou na lista central, ou junto de um cliente. Se o associar a um cliente, desaparece da lista central. Os PDF assinados e os mandatos assinados ficam automaticamente nos documentos do cliente.

## Documentos de um cliente [#documenten-bij-een-klant]

### Ver documentos [#documenten-bekijken]

1. Vá a <UIPath>Clientes > Visão geral</UIPath> e abra o perfil do cliente.
2. Clique no separador **Documentos**.
3. Vê os documentos deste cliente, repartidos por **Ativos** e **Arquivados**.
4. Clique num documento (ou no olho) para o ver à direita em **Pré-visualização**. Com o ícone de descarregamento guarda-o.

### Editar, mover ou arquivar um documento [#een-document-bewerken-verplaatsen-of-archiveren]

O menu **…** ao lado de um documento contém **Editar**, **Mover para o cliente**, **Descarregar**, **Arquivar** (ou **Restaurar do arquivo**) e **Eliminar**.

### Eliminar um documento [#een-document-verwijderen]

Antes de começar: não pode eliminar um documento que pertence a um pedido de assinatura. Arquive-o nesse caso.

<Steps>
<Step>
### Escolha Eliminar [#kies-verwijderen]
Escolha **Eliminar** no menu **…** ao lado do documento.
</Step>
<Step>
### Confirme [#bevestig]
Confirme na janela de diálogo com **Eliminar**, ou cancele com **Cancelar**. A eliminação não pode ser desfeita.

<DocScreenshot src="/screenshots/documenten/document-delete-dialog.png" alt="Diálogo de confirmação para eliminar um documento" />
</Step>
</Steps>

Depois de eliminar, recebe no endereço de e-mail da sua conta uma mensagem com o documento eliminado como anexo, pelo que normalmente fica com uma cópia à mão.

### Pedir a assinatura de um documento [#een-document-laten-ondertekenen]

Nos documentos de um cliente encontra os **Pedidos de assinatura**. Com **Pedir assinaturas** faz com que um PDF seja assinado online pelo cliente, por uma pessoa de contacto, por um colega ou por uma parte externa. O PDF assinado fica nos documentos como **[título] (assinado)**, com o tipo **Acordo assinado** se o PDF original não tinha tipo. Veja [Assinaturas](/handtekeningen).

## A lista central de documentos [#de-centrale-documentenlijst]

Além dos documentos dos clientes, o Tillor tem uma lista central. Aqui aparecem ficheiros que ainda não estão associados a um cliente, por exemplo documentos que chegam por e-mail. Vá a <UIPath>Administração > Documentos</UIPath>.

<DocScreenshot src="/screenshots/documenten/documents-upload.png" alt="Lista central de documentos com a zona de carregamento" />

### Carregar um documento [#een-document-uploaden]

<Tabs items={["Arrastar ou escolher", "Por e-mail"]}>
<Tab value="Arrastar ou escolher">
Arraste um ficheiro para a área de carregamento, ou clique em **Selecionar ficheiro**. O ficheiro é guardado automaticamente e aparece como novo item na lista.
</Tab>
<Tab value="Por e-mail">
Na área de carregamento está um endereço de e-mail especial. Envie o ficheiro como anexo para esse endereço e ele aparece automaticamente na lista central.
</Tab>
</Tabs>

### Associar um documento a um cliente [#een-document-koppelen-aan-een-klant]

Cada documento na lista central tem um formulário de edição e um painel de pré-visualização.

<Steps>
<Step>
### Encontre o documento [#zoek-het-document]
Vá a <UIPath>Administração > Documentos</UIPath> e desloque-se até ao documento.
</Step>
<Step>
### Preencha os campos [#vul-de-velden-in]
- **Nome do documento**: o nome do documento.
- **Atribuir ao cliente**: o cliente a que este documento pertence (opcional).
- **Tipo de documento**: por exemplo **Apólice de seguro**, **Comprovativo de pagamento do seguro**, **Cartão de identidade**, **Mandato SEPA**, **Acordo assinado** ou **Outro** (opcional).
- **Data de validade do seguro**: a data em que um seguro ou uma licença expira. Este campo só existe em tipos de documento que podem ter data de validade.
- **Notas**: notas livres sobre o documento (opcional).
</Step>
<Step>
### Guarde [#sla-op]
Clique em **Guardar alterações**.
</Step>
</Steps>

### O que acontece a seguir? [#wat-gebeurt-er-daarna]

- O documento desaparece da lista central e fica no separador **Documentos** desse cliente.
- Se preencheu uma **Data de validade do seguro**, vê-a como etiqueta no documento.

## Sugestões de IA para documentos [#ai-suggesties-bij-documenten]

Quando carrega um PDF, o Tillor analisa o conteúdo em segundo plano. Se o Tillor reconhecer um nome que corresponde a um cliente na sua administração, aparece ao lado de **Atribuir ao cliente** um botão de sugestão com o nome do cliente e uma percentagem que indica a certeza do Tillor. Para uma data de validade do seguro também pode aparecer uma sugestão.

Clique no botão para aceitar a sugestão, ou escolha você mesmo outro cliente. Uma sugestão é sempre uma proposta. Clique em **Guardar alterações** para tornar a sua escolha definitiva.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não consigo eliminar um documento">
Se o documento pertence a um pedido de assinatura, como PDF original ou como PDF assinado, o Tillor recusa a eliminação, porque é prova. Arquive-o com **Arquivar** no menu **…**.
</Accordion>
<Accordion title="O Tillor diz: O arquivo falhou">
A mensagem é **O documento não pôde ser arquivado.** Tente novamente. O mesmo vale para **Falha ao restaurar** em **Restaurar do arquivo**.
</Accordion>
<Accordion title="O Tillor diz: A atualização falhou">
As suas alterações ao **Nome do documento**, ao cliente, ao tipo ou às notas não foram guardadas. Verifique o formulário e clique novamente em **Guardar alterações**.
</Accordion>
<Accordion title="O Tillor diz: Falha no descarregamento">
Não foi possível descarregar o documento. Tente novamente.
</Accordion>
<Accordion title="O campo Data de validade do seguro não aparece">
Esse campo só aparece em tipos de documento que podem ter data de validade, como **Apólice de seguro**. Escolha primeiro o tipo certo em **Tipo de documento**.
</Accordion>
<Accordion title="O meu ficheiro não é aceite">
Verifique o tipo de ficheiro (PDF, Word, mensagem do Outlook, Excel, PowerPoint, JPEG, PNG, GIF ou texto) e o tamanho (máximo 250 MB).
</Accordion>
<Accordion title="O documento já não está na lista central">
Assim que um documento é associado a um cliente, fica apenas junto desse cliente em **Documentos**. Se estiver no arquivo, encontra-o em **Arquivados**.
</Accordion>
</Accordions>

## Conceitos [#begrippen]

- **Tipo de documento**: o género de documento, por exemplo **Apólice de seguro** ou **Cartão de identidade**.
- **Arquivado**: um documento que continua guardado mas já não aparece entre os documentos ativos.
- **Lista central de documentos**: ficheiros que ainda não estão associados a um cliente.
- **Pedido de assinatura**: uma ordem para fazer assinar um PDF. Veja [pedido de assinatura](/begrippen#ondertekenverzoek).
- **Cliente**: o registo no Tillor a que um documento está ligado. Veja [cliente](/begrippen#klant).

## Ver também [#zie-ook]

<Cards>
  <Card title="Gestão de clientes" href="/klantenbeheer" />
  <Card title="Assinaturas" href="/handtekeningen" />
</Cards>


# Visão geral (/pt-PT/eigen-velden)

Com os campos personalizados adiciona você mesmo campos a um registo. Pense num número de caução da botija de gás num cliente, num suplemento numa parcela ou numa hora de chegada prevista numa reserva. O campo aparece no formulário desse registo, tal como os campos que o Tillor já traz.

Gere-os em <UIPath>Definições > Campos personalizados</UIPath>.

<DocScreenshot src="/screenshots/eigen-velden/custom-fields-list.png" alt="Definições > Campos personalizados com o separador Clientes e a lista de campos" />

<Callout type="info" title="Bom saber">
- O tipo de um campo e a chave já não podem ser alterados depois de criados
- Texto: por defeito no máximo 1.000 carateres, Texto longo 10.000. Uma lista de escolha tem no máximo 200 opções
- Um grupo de campos tem no máximo 30 subcampos. Linhas repetidas: por defeito no máximo 100 linhas, nunca mais de 500
- Ficheiros: por defeito no máximo 20 por campo (nunca mais de 50), cada um com no máximo 50 MB
- Um campo que desaparece por causa de uma condição é esvaziado quando o registo é guardado
- Um campo eliminado desaparece dos formulários. Os valores preenchidos continuam, no entanto, nos registos
- Todos os limites por tipo estão em [Tipos de campo e definições](/eigen-velden/veldtypes)
</Callout>

## Como se relaciona tudo isto? [#hoe-hangt-dit-samen]

Cria um campo uma só vez e ele aparece depois em todo o lado onde esse tipo de registo é preenchido.

```mermaid
flowchart LR
  L[Lista de escolha com opções] -->|usada por| V[Campo personalizado do tipo Escolha]
  V -->|está no formulário de| R[Cliente, parcela, ocupação, tarefa e outros registos]
  T[Acesso: quem pode ver e editar] --> V
  R -->|os valores voltam em| E[Exportações, filtros e automatizações]
```

- **As listas de escolha** cria-as separadamente dos campos. Se alterar uma opção, fica correto em todos os campos que usam a lista.
- **Um campo** pertence a um só tipo de registo. O tipo e a chave ficam fixos.
- **O acesso** define-se por campo. Quem não pode ver um campo nunca vê o valor, nem em exportações nem em automatizações.

## Onde pode adicionar campos personalizados [#waar-kun-je-eigen-velden-toevoegen]

Cada tipo de registo tem o seu separador. Depois do nome está o número de campos.

| Separador | Registo |
|---|---|
| **Clientes** | Perfil de cliente |
| **Parcelas** | Parcela |
| **Ocupações** | Ocupação |
| **Contadores** | Contador |
| **Tarefas** | Tarefa |
| **Produtos** | Produto |
| **Documentos** | Documento |
| **Reservas** | Reserva |
| **Métodos de acesso** | Método de acesso |

O separador **Listas de escolha** não tem registos. Aí cria listas com opções que reutiliza nos campos de escolha.

## O que pode fazer com eles [#wat-je-ermee-kunt]

- Adicionar um campo de um determinado tipo, como texto, número, montante, data, escolha ou ficheiro. Veja [Tipos de campo e definições](/eigen-velden/veldtypes)
- Colocar o campo no formulário entre os campos existentes, ou mostrá-lo apenas quando outro valor corresponder
- Tornar o campo obrigatório, eventualmente só sob uma condição
- Definir quem pode ver o campo e quem o pode editar. Veja [Visibilidade e acesso](/eigen-velden/zichtbaarheid-en-toegang)

Os valores estão disponíveis na exportação de clientes e parcelas e nas automatizações. Uma automatização também pode preencher um campo personalizado com o passo **Definir campo personalizado**.

## Quem o pode utilizar [#wie-kan-het-gebruiken]

<Callout type="info" title="Gerir exige uma permissão">
Criar, alterar, reordenar e eliminar campos é possível com a permissão **Gerir campos personalizados**. Quem não a tiver pode abrir a página se puder ver as definições, mas os botões ficam desativados.
Preencher um campo num registo pode fazê-lo qualquer pessoa que possa ver e editar o campo.
</Callout>

## Componentes [#onderdelen]

<Cards>
  <Card
    title="Criar um campo personalizado"
    href="/eigen-velden/veld-aanmaken"
    description="Adicionar, colocar e ajustar um campo passo a passo"
  />
  <Card
    title="Listas de escolha"
    href="/eigen-velden/keuzelijsten"
    description="Definir opções para os tipos Escolha e Escolha múltipla"
  />
  <Card
    title="Tipos de campo e definições"
    href="/eigen-velden/veldtypes"
    description="Que definições e limites existem por tipo"
  />
  <Card
    title="Visibilidade e acesso"
    href="/eigen-velden/zichtbaarheid-en-toegang"
    description="Onde estão os valores e quem os pode ver ou editar"
  />
</Cards>

## Conceitos [#begrippen]

- **[Campo personalizado](/begrippen#eigen-veld)**: um campo adicional que você mesmo junta a um registo
- **Etiqueta**: o nome que os colegas veem por cima do campo de introdução
- **Chave**: o nome fixo do campo, por exemplo `gasMeterNumber`. Vê-o na lista e é utilizado em exportações e filtros
- **Tipo**: que género de valor o campo guarda
- **[Lista de escolha](/begrippen#keuzelijst)**: uma lista de opções que utiliza em vários campos de escolha

Mais termos estão no [glossário](/begrippen). Um exemplo desenvolvido está em [Exemplos práticos](/praktijk).


# Criar listas de escolha (/pt-PT/eigen-velden/keuzelijsten)

Um campo do tipo **Escolha** ou **Escolha múltipla** precisa de uma lista de escolha. Cria a lista uma só vez e utiliza-a em quantos campos quiser. Se alterar uma opção, fica logo correto em todo o lado.

<Requires permission="Gerir campos personalizados" />

<Steps>
<Step>
### Abra o separador Listas de escolha [#open-het-tabblad-keuzelijsten]
Vá a <UIPath>Definições > Campos personalizados</UIPath> e clique em **Listas de escolha**. Cada lista mostra as suas opções com cor e quantos campos a utilizam.

<DocScreenshot src="/screenshots/eigen-velden/custom-fields-enums.png" alt="O separador Listas de escolha com a lista Tipo de contrato" />
</Step>
<Step>
### Crie uma lista [#maak-een-lijst-aan]
Clique em **Nova lista de escolha**. Preencha um **Nome** e, se quiser, uma **Descrição**. O Tillor cria por si uma **Chave**.
</Step>
<Step>
### Adicione opções [#voeg-opties-toe]
Clique em **Adicionar opção** e preencha a **Etiqueta**, por exemplo *Época*. Escolha uma cor com o ponto de cor. Uma lista precisa de pelo menos uma opção.

<DocScreenshot src="/screenshots/eigen-velden/custom-fields-enum-dialog.png" alt="Diálogo Nova lista de escolha" />
</Step>
<Step>
### Guarde [#sla-op]
Clique em **Guardar**. Depois, escolha a lista ao criar um campo do tipo **Escolha** ou **Escolha múltipla**.
</Step>
</Steps>

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- A lista fica disponível ao criar um campo do tipo **Escolha** ou **Escolha múltipla**.
- Se mais tarde alterar a etiqueta ou a cor de uma opção, fica logo correto em todos os campos que utilizam a lista.
- O **Valor** de uma opção fica fixo assim que é utilizado num registo.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não consigo eliminar uma lista">
Não pode eliminar uma lista que ainda é utilizada num campo. O Tillor indica que a lista ainda é utilizada por um campo. Retire primeiro a lista desses campos ou elimine esses campos.
</Accordion>
<Accordion title="No meu campo de escolha aparece Crie primeiro uma lista de escolha">
Ainda não existe nenhuma lista. Crie uma no separador **Listas de escolha** e escolha-a depois no campo.
</Accordion>
<Accordion title="Não consigo guardar a lista">
Uma lista precisa de pelo menos uma opção e de no máximo 200. Adicione uma opção com **Adicionar opção**.
</Accordion>
</Accordions>


# Criar um campo personalizado (/pt-PT/eigen-velden/veld-aanmaken)

Com um campo personalizado guarda um dado que o Tillor não conhece, como o número de caução de uma botija de gás num cliente. Cria-o em poucos minutos e, à direita na página, vê logo como os colegas vão receber o campo. Depois preenche-o no próprio registo, veja [Visibilidade e acesso](/eigen-velden/zichtbaarheid-en-toegang).

Antes de começar:

- Precisa da permissão **Gerir campos personalizados**. Sem essa permissão, o botão **Novo campo** está a cinzento.
- Se o campo precisar de uma escolha, crie primeiro uma [lista de escolha](/eigen-velden/keuzelijsten). Caso contrário aparece **Crie primeiro uma lista de escolha**.
- Escolha o tipo com cuidado: depois já não o pode alterar.

<Requires permission="Gerir campos personalizados" />

<Steps>
<Step>
### Abra Campos personalizados e escolha o separador [#open-eigen-velden-en-kies-het-tabblad]
Vá a <UIPath>Definições > Campos personalizados</UIPath> e abra o separador do registo a que o campo pertence, por exemplo **Clientes**. Clique em **Novo campo**.

Se o separador ainda estiver vazio, vê em **Início rápido** algumas propostas, como **Número de cães** nos clientes. Clique numa proposta para abrir o formulário já preenchido. As propostas com uma lista de escolha pedem primeiro uma lista. Veja [Listas de escolha](/eigen-velden/keuzelijsten).
</Step>
<Step>
### Preencha o campo [#vul-het-veld-in]
Em **1. Campo**, escolha em **Aplica-se a** o tipo de registo, dê ao campo uma **Etiqueta** e escolha o **Tipo**. Cada cartão de tipo tem uma breve explicação.

O Tillor cria por si uma **Chave** a partir da sua etiqueta. Em **3. Chave** pode alterá-la com **Alterar** antes de guardar.

<DocScreenshot src="/screenshots/eigen-velden/field-new-form.png" alt="Novo campo personalizado com os cartões de tipo, as definições e a pré-visualização à direita" />
</Step>
<Step>
### Afine o campo [#stel-het-veld-af]
Em **2. Definições** estão as opções que pertencem ao tipo escolhido. Veja [Tipos de campo e definições](/eigen-velden/veldtypes). Além disso, pode escolher:

- **Largura**: **Metade** ou **Largura total** no formulário
- **Posição no formulário**: deixe o campo em baixo (**Secção padrão (em baixo)**), ou escolha um campo existente do formulário e coloque o campo **Antes** ou **Após** esse campo
- **Obrigatório**: o registo não pode ser guardado enquanto o campo estiver vazio
- **Visibilidade**: mostre o campo apenas se for cumprida uma condição
- **Obrigatório quando**: torne o campo obrigatório apenas se for cumprida uma condição
- **Regras de validação**: compare o valor com outro campo, ou verifique-o com uma expressão
- **Texto de ajuda**: uma breve explicação por baixo do campo de introdução
</Step>
<Step>
### Defina quem pode aceder [#bepaal-wie-erbij-mag]
Em **4. Acesso** está por defeito que todos podem ver e editar o campo. Clique em **Restringir** para o ajustar. Veja [Visibilidade e acesso](/eigen-velden/zichtbaarheid-en-toegang).
</Step>
<Step>
### Guarde o campo [#sla-het-veld-op]
Clique em **Guardar**. O Tillor indica **Campo guardado** e leva-o de volta à lista. O campo fica logo no formulário do registo.
</Step>
</Steps>

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- O campo fica logo no formulário do registo, no lugar que escolheu.
- Os registos existentes ainda têm um valor vazio. Se o campo for obrigatório, um colega tem de o preencher antes de voltar a guardar esse registo.
- Os valores acompanham a exportação de clientes e parcelas e estão disponíveis nas automatizações.
- Quem pode ver ou editar o campo define-se em **4. Acesso**.

## Posição e condições [#plaats-en-voorwaarden]

Com **Posição no formulário** coloca um campo junto dos campos a que pertence, em vez de em baixo. Com **Visibilidade** mostra um campo apenas se outro valor o exigir. Neste exemplo, **Parque de inverno** só aparece numa parcela com o **Tipo de contrato** Época, logo a seguir a **Descrição**.

<DocScreenshot src="/screenshots/eigen-velden/field-edit-conditions.png" alt="Editar campo com Posição no formulário e uma condição em Visibilidade e Obrigatório quando" />

Uma condição é composta por uma ou mais regras. Em **Tipo de condição** escolhe **Regras** ou **Expressão**. A expressão destina-se a casos complicados e exige um pouco de código. Para a maioria dos campos bastam regras.

<Callout type="info" title="Um campo oculto é esvaziado">
Se um campo desaparece porque a condição já não se verifica, o Tillor apaga o valor ao guardar o registo. Se o campo voltar, está vazio. Um campo que é obrigatório sob uma condição só é obrigatório enquanto estiver visível.
</Callout>

## Editar, mover ou eliminar um campo [#een-veld-bewerken-verplaatsen-of-verwijderen]

Na lista, cada campo tem quatro botões.

| Botão | O que faz |
|---|---|
| **Subir** e **Descer** | Altera a ordem dos campos no formulário |
| **Editar campo** | Abre o campo. O tipo, a chave e o registo a que o campo pertence ficam então fixos |
| **Eliminar** | Elimina o campo após uma confirmação |

Um campo eliminado desaparece dos formulários. Os valores preenchidos continuam nos registos, mas já não são mostrados nem editados.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não consigo clicar em Novo campo">
O botão está desativado sem a permissão **Gerir campos personalizados**. Peça a um administrador que atribua a permissão.
</Accordion>
<Accordion title="Quero alterar o tipo ou a chave de um campo existente">
Não é possível. Crie um novo campo com o tipo certo e elimine depois o campo antigo. O Tillor não transfere os valores do campo antigo.
</Accordion>
<Accordion title="O meu campo não está onde espero">
Verifique em **Posição no formulário** se escolheu um campo. Com **Secção padrão (em baixo)**, o campo fica depois dos campos padrão do formulário. Se tiver uma condição em **Visibilidade**, só aparece quando ela se verifica.
</Accordion>
</Accordions>


# Tipos de campo e definições (/pt-PT/eigen-velden/veldtypes)

Ao criar um campo, escolhe um tipo. Depois já não pode alterar o tipo. Em **2. Definições** estão as opções desse tipo. Todas as opções são facultativas, salvo indicação em contrário abaixo.

Em quase todos os tipos pode também preencher uma **Mensagem de erro**. Esta substitui a mensagem padrão quando um valor não está correto. Com **Texto de exemplo** define o que aparece no campo de introdução vazio.

## Texto e Texto longo [#tekst-en-lange-tekst]

**Texto** é uma linha, **Texto longo** várias linhas.

| Definição | O que faz |
|---|---|
| **Comprimento mínimo** e **Comprimento máximo** | O número de carateres. Sem máximo, aplicam-se 1.000 carateres em Texto e 10.000 em Texto longo |
| **Formato** | **Texto livre**, **Endereço de e-mail**, **Número de telefone**, **Endereço web**, **IBAN**, **Código postal**, **Apenas dígitos** ou **Padrão personalizado** |
| **Padrão (expressão regular)** | Em **Padrão personalizado**. O valor inteiro tem de corresponder. O Tillor recusa padrões com repetições aninhadas ou retrorreferências e padrões com mais de 200 carateres |

## Número e Montante [#getal-en-bedrag]

**Montante** utiliza a moeda da sua organização.

| Definição | Aplica-se a | O que faz |
|---|---|---|
| **Mínimo** e **Máximo** | Número, Montante | Limite inferior e limite superior |
| **Apenas números inteiros** | Número | Não são permitidas casas decimais |
| **Aparência** | Número, só em números inteiros | **Campo de entrada** ou **Contador (− / +)** com botões |
| **Incremento** | Número | O valor tem de ser o mínimo (ou 0) mais um número inteiro de passos |
| **Casas decimais máximas** | Número | Limita as casas decimais |

## Sim / não [#ja--nee]

Um interruptor de ligar/desligar. Com **Deve estar marcada**, o registo só pode ser guardado com a caixa marcada. Útil para um consentimento.

## Data [#datum]

| Definição | O que faz |
|---|---|
| **Data mais cedo** e **Data mais tarde** | Limites fixos |
| **Não no passado** e **Não no futuro** | Comparado com hoje no fuso horário da sua organização |
| **A até dias de hoje** | No máximo tantos dias antes ou depois de hoje |

## Escolha e Escolha múltipla [#keuze-en-meerkeuze]

Escolhe uma [lista de escolha](/eigen-velden/keuzelijsten). **Escolha** guarda uma opção, **Escolha múltipla** várias. Em Escolha múltipla define **Mínimo selecionado** e **Máximo selecionado**. Uma lista tem no máximo 200 opções.

## Ligação a registo [#koppeling-naar-record]

O campo aponta para outro registo no Tillor.

| Definição | O que faz |
|---|---|
| **Liga a** | Cliente, Parcela, Ocupação, Contador, Tarefa, Fatura, Reserva, Relatório de pagamentos, Chamada telefónica, Pessoa de contacto, Produto, Armário de contadores, Pagamento, Documento, Etiqueta NFC ou Método de acesso |
| **Vários registos** | Permite mais do que um registo ligado. Pode então definir também um mínimo e um máximo |
| **Aparência** | **Lista de escolha** ou **Menu suspenso** (uma lista única com pesquisa) |
| **Apenas os registos deste cliente** | Limita as opções aos registos do cliente que está a editar. Só em Pessoa de contacto, Fatura, Reserva, Ocupação, Pagamento, Documento, Etiqueta NFC e Método de acesso |
| **Apenas registos do terreno** | Limita as opções aos contadores da parcela: numa ocupação, a parcela dessa ocupação, numa parcela, a própria parcela. Só em Contador. Não pode guardar um contador de outra parcela |
| **Filtrar opções** | TypeScript opcional que decide, para cada opção, se entra na lista, veja [Filtrar opções](#opties-filteren). Em Pessoa de contacto, Produto, Armário de contadores, Pagamento, Documento, Etiqueta NFC, Método de acesso, Fatura, Reserva, Ocupação, Contador e Parcela |

Se um registo ligado for eliminado mais tarde, o campo mostra **Eliminado**.

Se houver pelo menos 50 registos para escolher, escreve primeiro 2 carateres para pesquisar. Se forem menos, como os contadores de uma parcela, vê-los todos logo.

### Filtrar opções [#opties-filteren]

Com **Filtrar opções** decide você mesmo que registos o campo oferece. Escreve TypeScript, tal como a [fórmula de tarifa](/terreinen#tariefformule), que o Tillor executa para cada opção. Se devolver `true`, a opção entra na lista; caso contrário, não.

No filtro lê campos com chavetas. O menu **Variável** mostra o que existe, incluindo campos personalizados:

| Variável | O que é |
|-----------|------------|
| `{option.…}` | O registo que poderia escolher, por exemplo `{option.type}` ou `{option.terrainId}` num contador |
| `{occupation.…}`, `{terrain.…}`, … | O registo que está a editar, com o nome do seu tipo, com `customFields` para os seus próprios campos |

Exemplo: apenas contadores de eletricidade da parcela da ocupação.

```ts
return {option.type} === "ELECTRICITY" && {option.terrainId} === {occupation.terrainId};
```

### Etiquetas próprias [#eigen-labels]

O mesmo filtro também pode decidir como uma opção se chama na lista. O que devolve determina o resultado:

| O que devolve | Resultado |
|----------------|-----------|
| `true` | A opção está na lista com o seu próprio nome |
| `false`, `null` ou um texto vazio | A opção não está na lista |
| Um texto | A opção está na lista com esse texto |
| `{ label, group }` | A opção recebe essa etiqueta e fica sob o título `group`. Ambos são facultativos |

Exemplo: apenas contadores da ICY e da Hydrodigit, com o tipo indicado e agrupados por fornecedor.

```ts
if (!["ICY", "TILLOR_HYDRODIGIT"].includes({option.provider})) return false;
return { label: {option.name} + " · " + {option.type}, group: {option.provider} };
```

A etiqueta aplica-se na lista de escolha e nas etiquetas escolhidas no formulário. Nos sítios que só mostram o valor, como a página de detalhe ou uma exportação, aparece o nome próprio do registo.

**Inserir exemplo** por baixo do campo dá um ponto de partida. Não pode guardar um filtro que não compila; a mensagem por baixo do campo diz o que está errado.

O filtro não limita apenas a lista. Se escolher, através da API ou de um formulário antigo, um registo que o filtro exclui, o Tillor recusa guardar indicando o nome do campo. As automatizações e as importações não são verificadas, tal como podem preencher campos ocultos.

## Grupo de campos [#groep-velden]

Um conjunto fixo de subcampos que estão juntos no formulário, como **Cães** e **Outros animais** em **Animais**.

| Definição | O que faz |
|---|---|
| **Adicionar subcampo** | Cada subcampo tem uma etiqueta, tipo e definições próprias. Clique em **Mais** para a chave, a largura e as condições. Um grupo pode ter no máximo 30 subcampos |
| **Aparência** | **Moldura** (com contorno) ou **Em linha** (os campos continuam no formulário) |
| **Colunas** | 1 a 4 |
| **Largura no grupo** | Quantas colunas ocupa cada subcampo |

## Linhas repetidas [#herhalende-rijen]

Uma tabela a que acrescenta linhas com **Adicionar linha**, por exemplo vários veículos. Define os subcampos como num grupo. Com **Linhas mínimas** e **Máximo de linhas** limita a lista. Sem máximo aplicam-se 100 linhas, e mais de 500 não é possível.

Um grupo ou linha repetida pode conter, um nível abaixo, outro grupo ou linha repetida, mas não mais do que isso.

## Ficheiros [#bestanden]

Para documentos e fotografias. Um ficheiro que carrega só pode ser aberto por quem pode ver o campo.

| Definição | O que faz |
|---|---|
| **Vários arquivos** | Permite mais do que um ficheiro |
| **Arquivos mínimos** e **Arquivos máximos** | Sem máximo aplicam-se 20 ficheiros, e mais de 50 não é possível |
| **Tamanho máximo por arquivo (MB)** | No máximo 50 MB por ficheiro, mesmo que queira um valor mais alto |
| **Tipos de arquivo permitidos** | **Qualquer arquivo**, **Imagens**, **PDF**, **Documentos do Office**, ou uma extensão própria como `.dwg` ou um tipo MIME como `application/zip` |

O Tillor verifica o tipo com base no conteúdo do ficheiro, e não apenas no nome.

## JSON [#json]

Destinado a dados estruturados que uma ligação a outro sistema fornece. Os colegas raramente o preenchem no formulário. Com **Tamanho máximo (KB)** define um limite, por defeito 64 KB e no máximo 256 KB.

## Definições para todos os tipos [#instellingen-voor-elk-type]

| Definição | O que faz |
|---|---|
| **Criptografar este valor** | Guarda o valor cifrado. Um campo cifrado não pode ser pesquisado, filtrado nem ordenado e não está disponível como variável nas automatizações. Só para campos de nível superior, ou seja, não para subcampos. Todos os campos personalizados são de qualquer forma guardados cifrados, quer ative isto ou não |
| **Apenas API** | Oculta o campo em formulários e vistas de detalhe. Uma ligação preenche-o através da API. Um campo assim não pode ser obrigatório |
| **Apenas API, só de leitura** | Mostra o campo, mas desativado, para que os colegas vejam o valor mas não o alterem |
| **Regras de validação** | Compare uma data, um número ou um montante com outro campo (**Antes**, **Em ou antes de**, **Após**, **Em ou depois de**, com um deslocamento em dias, semanas ou meses), ou verifique o valor com uma expressão. No máximo 10 regras por campo |

Um limite alterado não se aplica retroativamente. Um valor que não ajusta não bloqueia a gravação do registo, mesmo que já não cumpra a nova regra.


# Visibilidade e acesso (/pt-PT/eigen-velden/zichtbaarheid-en-toegang)

Um campo personalizado aparece no formulário do registo a que pertence. Por predefinição, todos os que têm acesso a esse registo podem ver e preencher o campo. Pode restringir isso campo a campo.

## Onde vê os valores [#waar-je-de-waarden-ziet]

Preenche os campos personalizados no mesmo sítio dos restantes dados do registo.

| Registo | Onde |
|---|---|
| Cliente | O bloco **Dados do cliente** no perfil do cliente |
| Parcela, contador, ocupação, reserva, produto, documento, método de acesso | O formulário para criar ou editar o registo |
| Tarefa | A janela da tarefa. Guarda as alterações com **Guardar campos** |

Um campo aparece no sítio que escolheu em **Posição no formulário**. Sem escolha, aparece depois dos campos predefinidos.

<DocScreenshot src="/screenshots/eigen-velden/customer-custom-fields.png" alt="O perfil do cliente com campos personalizados como Cães, Data de chegada e Número da caução da botija de gás entre os campos predefinidos" />

Se um campo for obrigatório, não pode guardar o registo enquanto ele estiver vazio. Um campo com **Visibilidade** só aparece quando a condição se verifica.

Os campos personalizados também constam da exportação de clientes e parcelas e podem ser usados em automatizações.

## Quem pode ver ou editar um campo [#wie-mag-een-veld-zien-of-bewerken]

Abra o campo em <UIPath>Definições > Campos personalizados</UIPath> e vá a **4. Acesso**. Clique em **Restringir**.

<Requires permission="Gerir campos personalizados" />

<DocScreenshot src="/screenshots/eigen-velden/field-edit-access.png" alt="Editar campo com Quem pode ver este campo e Quem pode editar este campo" />

Tem dois blocos.

| Bloco | O que faz |
|---|---|
| **Quem pode ver este campo** | Se o deixar vazio, qualquer membro o pode ver. Quem não o pode ver nunca vê o valor, nem em exportações ou automatizações que edite |
| **Quem pode editar este campo** | Se o deixar vazio, todos os que veem o campo também o podem editar. Os outros veem-no só em leitura |

Em cada bloco escolhe um **colega ou grupo** e/ou uma **permissão**. Se alguém corresponder a um dos colegas, grupos ou permissões escolhidos, tem acesso. Só pode editar se também puder ver o campo.

Na lista, esse campo recebe a etiqueta **Restrito**. Passe o rato por cima para ver a explicação: apenas determinados colegas, grupos ou permissões podem ver ou editar este campo.

<Callout type="warn" title="Um campo oculto não é um campo protegido">
A opção **Visibilidade** (uma condição) apenas oculta um campo no formulário. Quem pode ver o campo continua a conseguir encontrar o valor. Use **Quem pode ver este campo** se mais ninguém o deve poder ler.
</Callout>

## Quem pode gerir campos [#wie-mag-velden-beheren]

Criar, alterar, reordenar e eliminar campos e gerir listas de escolha exige a permissão **Gerir campos personalizados**. Como atribuir permissões está explicado em [Convidar utilizadores e atribuir permissões](/gebruikers/gebruikers-en-rechten). A página **Campos personalizados** é visível para quem pode ver ou editar as definições, ou tem esta permissão. Sem a permissão, só vê os campos que pode ler, e **Novo campo**, editar e eliminar ficam desativados.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Um colega não vê um campo">
Verifique em **Quem pode ver este campo** se esse colega, o seu grupo ou uma das suas permissões está selecionado. Se o campo for um campo **Apenas API**, não aparece nos formulários.
</Accordion>
<Accordion title="Um colega não consegue alterar um campo">
Veja **Quem pode editar este campo**. Se houver aí colegas, grupos ou permissões selecionados, os outros ficam limitados à leitura. Se alguém tentar alterar o valor mesmo assim, o Tillor recusa.
</Accordion>
</Accordions>


# Criar e editar uma fatura (/pt-PT/facturen/aanmaken-en-bewerken)

Uma nova fatura é sempre um rascunho: cria-a no perfil do cliente e preenche as linhas. Enquanto for um rascunho, pode adicionar, ajustar, mover e eliminar linhas. Depois [lança-a](/facturen/boeken).

Antes de começar:

- O cliente já existe no Tillor. Veja [Gestão de clientes](/klantenbeheer).
- Para produtos com uma parcela ou ocupação, o cliente tem uma ocupação nessa parcela. Sem ocupação, cria uma proposta que não pode lançar.

## Criar uma fatura [#een-factuur-aanmaken]

As faturas criam-se no perfil do cliente, não em <UIPath>Administração > Faturas</UIPath>.

<Steps>
<Step>
### Abra o cliente [#open-de-klant]
Vá a <UIPath>Clientes > Visão geral</UIPath> e abra o perfil do cliente.
</Step>
<Step>
### Crie a fatura [#maak-de-factuur-aan]
No bloco **Faturas**, clique em **Nova fatura**. O Tillor cria um rascunho de fatura e abre logo a página da fatura.

<DocScreenshot src="/screenshots/klanten/customer-new-invoice.png" alt="Nova fatura a partir do perfil do cliente" />
</Step>
</Steps>

A fatura recebe um número de rascunho provisório. O número de fatura definitivo, a data da fatura e a data de vencimento só surgem ao [lançar](/facturen/boeken).

## Adicionar e ajustar linhas [#regels-toevoegen-en-aanpassen]

Na página da fatura há uma tabela com as linhas da fatura. No fim há uma linha vazia onde começa uma nova linha.

<Steps>
<Step>
### Escolha um produto ou escreva uma descrição [#kies-een-product-of-typ-een-omschrijving]
Escolha um **Produto** da lista e o Tillor preenche a **Descrição** e o preço. Também pode escrever você mesmo uma descrição.
</Step>
<Step>
### Preencha a quantidade e o preço [#vul-aantal-en-prijs-in]
Ajuste a **Quantidade** e o **Preço (c/ IVA)** por unidade, se necessário. O **Total** da linha é calculado automaticamente. Se a definição de IVA por linha estiver ativa para a sua organização, escolhe também a taxa de IVA.
</Step>
<Step>
### Adicione uma nota (opcional) [#voeg-een-notitie-toe-optioneel]
Por baixo da tabela pode preencher uma **Nota (opcional)**. Esse texto fica na fatura e é visível para o cliente.
</Step>
</Steps>

As alterações são guardadas automaticamente quase de imediato. Também pode clicar em **Guardar alterações**, ou em **Cancelar** para desfazer alterações não guardadas.

### Reordenar ou eliminar linhas [#regels-herschikken-of-verwijderen]

- Arraste uma linha pela pega à esquerda para alterar a ordem.
- Clique na cruz à direita de uma linha para a eliminar.

Na linha do tempo **Eventos** ao lado da fatura vê o que foi alterado e quando, com o antes e depois dos campos e linhas.

## Linhas com uma ação [#regels-met-een-actie]

Se o produto escolhido tem uma ação na linha da fatura, aparecem campos extra por baixo da linha. Que ações um produto tem, define-o no próprio produto. Veja [Ações de produto](/producten/productacties).

| Ação | O que preenche na fatura |
|------|--------------------------|
| **Carregar etiqueta NFC** | A etiqueta a carregar. Após o pagamento, o Tillor soma o montante ao saldo da etiqueta. |
| **Período** | Data de início e de fim e, num produto com parcela, também a **Parcela** (numa lista ou **Escolher no mapa**). |
| **Prorrogar período de ocupação** | A parcela para a qual prorroga a ocupação, mais data de início e de fim. |
| **Pedir dados de contacto** | Endereço de e-mail e número de telefone do cliente. Se forem obrigatórios, não pode lançar sem eles. |
| **Criar método de acesso** | O tipo de método de acesso e, eventualmente, uma matrícula ou um PIN. |
| **Mostrar alerta** | Nada. Só vê um alerta com o texto definido no produto. |
| **Impedir lançamento** | Nada. A fatura não pode ser lançada enquanto a linha lá estiver. |

### Escolher o período e a parcela [#periode-en-terrein-kiezen]

Numa linha com **Período** escolhe uma data de início e de fim. Por baixo vê o número de dias e a **Quantidade** que o Tillor cobra. Se o período não coincide exatamente com uma semana ou um mês do produto, o Tillor arredonda por excesso e aparece **Arredondado por excesso**. Com a caixa **Pro rata** cobra uma semana ou um mês parcial proporcionalmente. Essa caixa só aparece em produtos com período semanal ou mensal.

Se o produto pede uma parcela, escolhe primeiro o período e depois a **Parcela**.

Ao lançar, o Tillor cria a reserva. Na linha aparece depois um cartão com número de reserva, estado, parcela e datas. Se o cliente regista logo a entrada depende do produto: com **Registar entrada ao reservar** acontece ao lançar, com **Registar a entrada no pagamento** só quando a fatura estiver paga. Um adiantamento apenas reserva a parcela.

### Prorrogar uma ocupação [#een-bezetting-verlengen]

Com **Prorrogar período de ocupação** fatura um período para uma ocupação do cliente, por exemplo o estacionamento.

<Steps>
<Step>
### Escolha a parcela [#kies-het-terrein]
Em **Selecionar ocupação ativa** escolha a parcela. A lista mostra as ocupações ativas do cliente.
</Step>
<Step>
### Escolha o período [#kies-de-periode]
Escolha a **Data de início**. Depois o Tillor abre logo o calendário para a **Data de fim**. Por baixo das datas vê até quando a ocupação está faturada e quantos dias e que quantidade a linha abrange.
</Step>
<Step>
### Defina o arredondamento [#stel-het-afronden-in]
A caixa **Arredondar para o limite do período seguinte** está ativa por predefinição. Então a linha termina no limite de período seguinte da frequência de aluguer, de modo que o cliente siga o mesmo ciclo a prazo. Com a caixa desativada, a linha dura exatamente um período a partir da data de início.
</Step>
</Steps>

A linha recebe uma descrição no formato **Nome do produto | Nome da parcela | Período**. A data de fim conta como último dia, e meio período também é cobrado a metade.

Se a ocupação já tem uma data **Pago até** e o arredondamento está ativo, a nova linha começa no dia seguinte. Se **Pago até** ainda estiver vazio, escolhe você a data de início e o Tillor calcula a data de fim até ao limite de período seguinte. O que acontece com **Pago até** e **Faturado até** após lançar e pagar está em [Ocupações](/bezettingen).

Duas caixas extra ajudam em situações excecionais:

- **Mostrar todas as parcelas (proposta)** permite-lhe escolher uma parcela qualquer para criar uma proposta. Se o cliente não tem essa parcela em ocupação, não pode lançar a fatura. Os utilizadores com a permissão **Correções de fatura** podem ainda assim lançar essa fatura, veja [Lançar uma fatura](/facturen/boeken#problemen).
- **Marcar como crédito (reembolso)** transforma a linha num reembolso. A quantidade fica negativa e o período vai de hoje até **Pago até**. Com **Arredondar para o limite do período** arredonda isso a um limite de período.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- As alterações são guardadas automaticamente quase de imediato. A linha do tempo **Eventos** mostra quem alterou o quê.
- Nada vai para o cliente e nada muda em ocupações ou etiquetas. Isso só acontece ao [lançar](/facturen/boeken) e no pagamento.
- Um rascunho com uma linha **Impedir lançamento** não pode ser lançado.
- Um rascunho elimina-se com **Eliminar fatura** no menu de ações.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Já não consigo ajustar as linhas">
Só os rascunhos de fatura são editáveis. Uma fatura lançada pode, sob condições, ser revertida para rascunho, veja [Corrigir uma fatura](/facturen/corrigeren#terugzetten-naar-concept).
</Accordion>
<Accordion title="Uma linha com Carregar etiqueta NFC não mostra etiquetas">
O cliente não tem etiqueta disponível. Associe primeiro uma etiqueta NFC ao cliente. Veja [NFC](/nfc).
</Accordion>
<Accordion title="Não vejo o botão Nova fatura">
O botão está no perfil do cliente, no bloco **Faturas**, não na lista de faturas em **Administração**.
</Accordion>
<Accordion title="O cliente não está na lista Selecionar ocupação ativa">
Em **Prorrogar período de ocupação**, a lista mostra apenas ocupações ativas do cliente. Crie primeiro uma ocupação, veja [Ocupações](/bezettingen), ou use **Mostrar todas as parcelas (proposta)** para uma proposta.
</Accordion>
</Accordions>

## Mais [#verder]

<Cards>
  <Card title="Lançar uma fatura" href="/facturen/boeken" />
  <Card title="Produtos" href="/producten" description="Definir ações em linhas de fatura" />
</Cards>


# Imprimir, descarregar ou partilhar uma fatura (/pt-PT/facturen/afdrukken-en-downloaden)

Com **Imprimir** imprime uma fatura, guarda-a como PDF ou envia-a para uma impressora. O botão está em todas as páginas de fatura, também num rascunho. A seta ao lado abre um menu com as outras opções. Uma ligação para o cliente cria-se em [Partilhar uma ligação pessoal](#een-persoonlijke-link-delen).

Antes de começar: para as opções de impressora, tem de estar a funcionar um Tillor Connector para a sua organização. Sem conector, essas opções ficam a cinzento.

## Imprimir ou guardar [#afdrukken-of-opslaan]

| Opção | O que faz |
|-------|-----------|
| **Imprimir** | Abre a janela de impressão do seu navegador. Também pode usar o atalho Ctrl+P (Cmd+P num Mac). |
| **Abrir numa nova janela** | Mostra o PDF numa nova janela. |
| **Descarregar PDF** | Guarda a fatura como ficheiro PDF. |
| **Enviar para a impressora A4** | Envia a fatura para a sua impressora A4 ligada. |
| **Enviar para impressora de recibos** | Envia a fatura para a sua impressora de recibos ligada. |

As duas opções de impressora ficam a cinzento enquanto não houver um Tillor Connector ativo para a sua organização. Como configurar impressoras está em [Impressora](/printer).

## Mostrar a fatura num tablet [#de-factuur-tonen-op-een-tablet]

Se houver na receção um tablet que mostra documentos ao cliente, pode fazer a fatura aparecer aí. Abra os três pontos no canto superior direito da página da fatura e escolha **Pré-visualizar no iPad**. Num pagamento em numerário, o mesmo botão também está na janela de pagamento.

## Partilhar uma ligação pessoal [#een-persoonlijke-link-delen]

Numa fatura lançada pode criar uma ligação que o cliente abre para ver a fatura e, se ainda houver algo em aberto, pagar online.

<Steps>
<Step>
### Abra o menu de ações [#open-het-actiemenu]
Clique nos três pontos no canto superior direito da página da fatura e escolha **URL pessoal**.
</Step>
<Step>
### Partilhe a ligação [#deel-de-link]
O Tillor copia a ligação para a área de transferência e mostra a mensagem **URL gerado**. Cole-a numa mensagem ou e-mail para o cliente.
</Step>
</Steps>

<DocScreenshot src="/screenshots/facturen/invoice-actions-menu.png" alt="Menu de ações da fatura - URL pessoal, Copiar fatura, Estornar fatura" />

O menu de ações tem mais opções. Veja [Corrigir uma fatura](/facturen/corrigeren) para copiar, estornar e recalcular uma fatura.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- Imprimir, descarregar e enviar para a impressora não alteram nada na fatura.
- Com **Pré-visualizar no iPad**, o cliente vê a fatura no tablet. Na linha do tempo da fatura consta que o PDF foi enviado para o tablet.
- A ligação pessoal não tem data de validade. O cliente vê aí o montante em aberto e pode pagar online. Veja [Deixar um cliente pagar online](/betalingsverwerking/online).
- Os produtos também podem imprimir automaticamente no pagamento. Veja [Ações de produto](/producten/productacties#thermisch-printen-en-a4-printen).

## Problemas? [#problemen]

<Accordions>
<Accordion title="Enviar para a impressora A4 está a cinzento">
Não há nenhum Tillor Connector ativo para a sua organização. Verifique a ligação e as definições da impressora, veja [Impressora](/printer).
</Accordion>
<Accordion title="URL pessoal não aparece">
Essa opção só existe no menu de ações de uma fatura lançada.
</Accordion>
<Accordion title="A impressão falha">
O Tillor mostra então uma mensagem com o motivo, por exemplo que o papel ou o toner acabou. Resolva isso e tente novamente.
</Accordion>
</Accordions>

## Mais [#verder]

<Cards>
  <Card title="Impressora" href="/printer" description="Configurar impressoras e imprimir automaticamente" />
  <Card title="Enviar uma fatura" href="/facturen/versturen" />
</Cards>


# Registar um pagamento (/pt-PT/facturen/betalingen-registreren)

Numa fatura lançada com um montante em aberto, efetua um pagamento ou regista um, por exemplo um pagamento por terminal, em numerário ou um débito direto. O montante, o estado do pagamento e a lista **Pagamentos** ao lado da fatura são depois atualizados. Todos os métodos estão também em [Processamento de pagamentos](/betalingsverwerking).

Antes de começar:

- A fatura está lançada e ainda há um montante em aberto. Caso contrário, **Efetuar pagamento** não aparece.
- Para **Terminal**, o Mollie está ligado. Para **Mandato SEPA**, o cliente tem um mandato ativo. Caso contrário, o método não está na lista ou está a cinzento.

## Efetuar um pagamento [#een-betaling-uitvoeren]

<Steps>
<Step>
### Abra a fatura lançada [#open-de-geboekte-factuur]
Vá a <UIPath>Administração > Faturas</UIPath> e abra uma fatura lançada. O botão **Efetuar pagamento** está lá enquanto houver um montante em aberto.

<DocScreenshot src="/screenshots/facturen/invoice-booked-actions.png" alt="Fatura lançada - Efetuar pagamento" />
</Step>
<Step>
### Escolha o método de pagamento [#kies-de-betaalmethode]
Clique em **Efetuar pagamento** e escolha um **Método de pagamento**.

<DocScreenshot src="/screenshots/betalingen/payment-dialog-cash.png" alt="Caixa de diálogo de pagamento - método de pagamento e montante" />

| Método | Para que serve |
|--------|----------------|
| **Terminal** | Um pagamento com cartão. Escolhe um terminal de pagamento e o Tillor envia o pagamento para lá. Veja [Terminal](/betalingsverwerking/terminal). |
| **Transferência interna** | Mover o montante para outra fatura lançada do mesmo cliente (**Fatura de destino**). Veja [Transferência interna](/betalingsverwerking/interne-overboeking). |
| **Numerário** | Registar um pagamento em numerário. Veja [Numerário](/betalingsverwerking/contant). |
| **Transferência bancária** | Registar uma transferência bancária recebida. |
| **Mandato SEPA** | Um débito direto automático através de um **Mandato** ativo do cliente. Veja [Mandato](/betalingsverwerking/mandaat). |
| **Outros** | Outra forma de pagamento, como um cheque. Está em **Mais métodos de pagamento** e só é visível se o tiver ativado. Neste caso, uma descrição é obrigatória. |

**Terminal** e **Mandato SEPA** só aparecem se estiverem disponíveis para a sua organização. **Mandato SEPA** fica a cinzento enquanto o cliente não tiver um mandato ativo, e não existe para notas de crédito.
</Step>
<Step>
### Preencha o montante [#vul-het-bedrag-in]
O **Montante** está, por predefinição, no total do montante em aberto. Escreva outro montante ou use os botões **25%**, **50%**, **75%** e **100%**. O montante não pode ser superior ao que está em aberto.
</Step>
<Step>
### Preencha os campos adicionais [#vul-de-extra-velden-in]
Em **Numerário**, **Transferência bancária** e **Outros** preenche, opcionalmente, a **Data de receção** (não no futuro) e um **Comentário**. Num débito direto escolhe o **Mandato** e, se quiser, um **Atraso (dias)**, em que 0 envia de imediato.

Se escolher **Transferência bancária** e o cliente tiver endereço de e-mail, pode marcar **Enviar lembrete de comunicação estruturada**. O cliente recebe então um e-mail com a sugestão de usar a comunicação estruturada nos pagamentos seguintes.
</Step>
<Step>
### Efetue o pagamento [#voer-de-betaling-uit]
Clique em **Efetuar pagamento**.

<DocScreenshot src="/screenshots/facturen/invoice-payments.png" alt="Pagamentos na fatura" />
</Step>
</Steps>

Em **Numerário** há também um botão **Pré-visualizar no iPad** para mostrar a fatura ao cliente num tablet ligado.

## Montantes máximos [#maximumbedragen]

Um pagamento em numerário não pode ser superior ao **Máximo em numerário** em <UIPath>Apoio > Definições > Pagamentos</UIPath> (por predefinição 2999 euros). Num débito direto, o montante não pode exceder o máximo do mandato.

## Associar um pagamento existente [#een-bestaande-betaling-koppelen]

Se já chegou um pagamento ou transação bancária que pertence a esta fatura, associe-o em vez de criar um novo.

<Requires permission="Atribuir pagamento" />

<Steps>
<Step>
### Abra o menu de ações [#open-het-actiemenu]
Clique nos três pontos no canto superior direito da página da fatura e escolha **Atribuir pagamento**.
</Step>
<Step>
### Escolha o pagamento [#kies-de-betaling]
Na janela, escolha um pagamento ou grupo. Nos separadores **Grupos de pagamentos**, **Pagamentos com cartão e online** e **Transações bancárias** está o que está disponível. No topo há sugestões que correspondem ao montante em aberto.
</Step>
<Step>
### Associe [#koppel]
Clique em **Atribuir pagamento**, **Atribuir grupo** ou **Atribuir transação bancária**, consoante o que escolheu.
</Step>
</Steps>

Para transações bancárias também precisa da permissão **Ver transações bancárias**.

## Criar uma ligação para um pagamento parcial [#een-link-voor-een-deelbetaling-maken]

Se o cliente só quer pagar parte do montante em aberto, cria uma ligação de pagamento para um montante que escolher. Isto é possível em qualquer fatura lançada com um montante em aberto.

<Steps>
<Step>
### Abra o menu de ações [#open-het-actiemenu-1]
Clique nos três pontos ao lado de **Enviar notificação** e escolha **Ligação de pagamento parcial**.

<DocScreenshot src="/screenshots/facturen/invoice-part-payment-menu.png" alt="Menu de ações de uma fatura com Ligação de pagamento parcial" />
</Step>
<Step>
### Preencha o montante [#vul-het-bedrag-in-1]
Em **Montante** escreva o que o cliente pode pagar. O montante tem de ser superior a 0 e não pode ser superior ao que ainda está em aberto.
</Step>
<Step>
### Crie a ligação [#maak-de-link]
Clique em **Criar e copiar a ligação**. O Tillor copia a ligação para a área de transferência e mostra-a em **Ligação de pagamento**. Com o botão de copiar ao lado, copia-a novamente.

<DocScreenshot src="/screenshots/facturen/invoice-part-payment-dialog.png" alt="Caixa de diálogo Ligação de pagamento parcial com montante e ligação de pagamento" />
</Step>
</Steps>

Envie a ligação você mesmo ao cliente, por exemplo por e-mail ou chat. O cliente abre a página de pagamento normal da fatura, mas esta pede agora apenas o seu montante, com a indicação de que é um pagamento parcial do montante que ainda está em aberto. O cliente paga então da forma que escolher na [página de pagamento](/betalingsverwerking/online).

A ligação continua válida, mas nunca pede mais do que o que está em aberto nesse momento. Se entretanto já foi paga uma parte, a página de pagamento ajusta-se. Depois de um pagamento, a fatura fica em <Status tone="warning">Parcial</Status> até chegar o montante total.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- O montante em aberto diminui e o estado do pagamento muda: <Status tone="warning">Parcial</Status> enquanto houver algo em aberto, <Status tone="success">Paga</Status> quando tudo chegou.
- Num débito direto ou pagamento por terminal, a fatura fica primeiro em <Status tone="info">Pendente</Status> até o dinheiro chegar de forma definitiva.
- Se uma linha tem uma ação de pagamento, o Tillor executa-a assim que a fatura está paga. Pense em carregar uma etiqueta NFC, prorrogar **Pago até** de uma ocupação ou imprimir um recibo. Veja [Como tudo se liga](/producten#hoe-hangt-dit-samen).
- O pagamento entra no relatório de pagamentos do dia. Veja [Relatórios de pagamentos](/boekhouden/betalingsrapporten).

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não vejo Efetuar pagamento">
A fatura tem de estar lançada e tem de haver um montante em aberto. Num rascunho de fatura não pode pagar.
</Accordion>
<Accordion title="Não vejo Ligação de pagamento parcial">
A fatura tem de estar lançada e ainda tem de haver um montante em aberto.
</Accordion>
<Accordion title="Mandato SEPA está a cinzento">
O cliente não tem mandato ativo. Defina-o nos dados do cliente, veja [Mandato](/betalingsverwerking/mandaat).
</Accordion>
<Accordion title="Não consigo escolher Outros">
Esse método de pagamento está desativado por predefinição. Ative **Mostrar método de pagamento "Outros"** em <UIPath>Apoio > Definições > Pagamentos</UIPath>.
</Accordion>
<Accordion title="A fatura está em Pendente">
O pagamento foi iniciado, por exemplo um débito direto, mas o dinheiro ainda não chegou de forma definitiva. Assim que o pagamento for processado, o estado passa para **Paga**. Veja [Estados](/facturen/statussen).
</Accordion>
</Accordions>

## Mais [#verder]

<Cards>
  <Card title="Processamento de pagamentos" href="/betalingsverwerking" description="Todos os métodos de pagamento em detalhe" />
  <Card title="Estados" href="/facturen/statussen" />
</Cards>


# Lançar uma fatura (/pt-PT/facturen/boeken)

Lançar transforma um rascunho numa fatura definitiva com o seu próprio número de fatura. Só depois pode [enviar](/facturen/versturen) a fatura e [fazê-la pagar](/facturen/betalingen-registreren). Verifique por isso as linhas antes de lançar, pois uma fatura lançada já não se altera livremente.

Antes de começar:

- A fatura tem pelo menos uma linha, ou um total diferente de zero.
- As linhas com **Período** ou **Prorrogar período de ocupação** têm data de início e de fim.
- Se uma linha tem uma ação que pede dados, estão preenchidos. Pense em **Pedir dados de contacto** ou **Criar método de acesso**.
- Para um cliente belga com número de IVA, está preenchido um ID Peppol. Veja [Peppol](/boekhouden/peppol).

Se algo estiver errado, **Lançar fatura** fica a cinzento. Passe o rato por cima do botão para ler porquê. Veja também [Problemas?](#problemen).

## Lançar uma fatura [#een-factuur-boeken]

<Steps>
<Step>
### Abra o rascunho de fatura [#open-de-conceptfactuur]
Vá a <UIPath>Administração > Faturas</UIPath> e abra uma fatura com o estado <Status>Rascunho</Status>, por exemplo através da lista **Rascunhos**.
</Step>
<Step>
### Verifique a fatura [#controleer-de-factuur]
Reveja as linhas e a nota.

<DocScreenshot src="/screenshots/facturen/invoice-draft-detail.png" alt="Rascunho de fatura - linhas e Lançar fatura" />
</Step>
<Step>
### Clique em Lançar fatura [#klik-op-boek-factuur]
A fatura recebe um número de fatura sequencial. O Tillor avisa que a fatura foi lançada.
</Step>
</Steps>

## O que muda? [#wat-verandert-er]

Assim fica uma fatura antes e depois de lançar. São dois exemplos de faturas diferentes, mas vê a diferença no número, no estado e nos botões.

**Antes de lançar**: um número de rascunho provisório e o botão **Lançar fatura**.

<DocScreenshot src="/screenshots/facturen/invoice-before-title.png" alt="Título de um rascunho de fatura com o número de rascunho CON/2026/0001" />

<DocScreenshot src="/screenshots/facturen/invoice-before-toolbar.png" alt="Botões de um rascunho de fatura: Lançar fatura e Imprimir" />

**Depois de lançar**: um número de fatura definitivo, um estado do pagamento e os botões **Efetuar pagamento** e **Enviar notificação**.

<DocScreenshot src="/screenshots/facturen/invoice-after-title.png" alt="Título de uma fatura lançada com o número INV/2026/0001 e o estado do pagamento Parcial" />

<DocScreenshot src="/screenshots/facturen/invoice-after-toolbar.png" alt="Botões de uma fatura lançada: Efetuar pagamento, Imprimir e Enviar notificação" />

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- A **data da fatura** é o dia do lançamento. A **data de vencimento** é esse dia mais o **Vencimento predefinido (dias)** da sua organização, por predefinição 7 dias. Altera-o em <UIPath>Apoio > Definições > Faturação</UIPath>.
- Se o total não for múltiplo de 5 cêntimos, o Tillor acrescenta ele próprio uma linha **Arredondamento**.
- Se a fatura tiver um total negativo, passa a **Nota de crédito**.
- Se o cliente tiver um ID Peppol, o Tillor envia a fatura automaticamente via Peppol. Veja [Peppol](/boekhouden/peppol).
- As linhas com **Prorrogar período de ocupação** colocam **Faturado até** da ocupação no fim da linha. **Pago até** só segue no pagamento. Veja [Como tudo se liga](/producten#hoe-hangt-dit-samen).
- As linhas com **Período** e **Pedir parcela** criam uma reserva. Se o cliente regista logo a entrada depende do produto.
- Se um mandato de débito direto estiver associado, o Tillor cria de imediato um pagamento em aberto. O banco é acionado dois dias após o lançamento.
- O cliente não recebe nada automaticamente. A notificação envia-a você, veja [Enviar uma fatura](/facturen/versturen).
- Quer ainda assim alterar algo? Dentro de 7 dias e enquanto nada tiver sido enviado, [reverta a fatura para rascunho](/facturen/corrigeren#terugzetten-naar-concept).

## Escolher outro prazo de pagamento [#een-andere-betaaltermijn-kiezen]

Se a data de vencimento diferir do seu predefinido, não precisa de o configurar antecipadamente.

<Steps>
<Step>
### Abra o menu de escolha [#open-het-keuzemenu]
Clique na seta ao lado de **Lançar fatura** e escolha **Condições de pagamento personalizadas…**.
</Step>
<Step>
### Escolha o prazo [#kies-de-termijn]
Em **Condições de pagamento** escolha uma opção, de **Vencimento na data da fatura** a **Prazo de 60 dias**. Vê logo a **Data de vencimento estimada**.
</Step>
<Step>
### Lance [#boek]
Clique em **Lançar fatura**.
</Step>
</Steps>

## Enviar para a sua contabilidade [#doorsturen-naar-je-boekhouding]

O envio para o seu software de contabilidade acontece normalmente sozinho. Se quiser reiniciá-lo, por exemplo após um erro, pode fazê-lo por fatura.

<Requires permission="Enviar para a contabilidade" />

Abra a fatura lançada, clique nos três pontos no canto superior direito e escolha **Enviar para o software de contabilidade**. Que sistemas estão disponíveis, lê em [Contabilidade](/boekhouden). O [Exact Online](/boekhouden/betalingsrapporten/boekhoudsystemen/exact-online) está disponível a pedido.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Lançar fatura está a cinzento">
Passe o rato por cima do botão. O Tillor indica o motivo. Os mais frequentes estão abaixo.
</Accordion>
<Accordion title="Este rascunho de fatura contém uma linha Impedir lançamento">
O produto dessa linha não permite o lançamento. Elimine a linha ou escolha outro produto.
</Accordion>
<Accordion title="Preencha a data de início e de fim em cada linha com Período ou período de ocupação prorrogado">
Uma linha com **Período** ou **Prorrogar período de ocupação** não tem uma data. Preencha a data de início e de fim.
</Accordion>
<Accordion title="Adicione pelo menos uma linha ou um montante total diferente de zero">
Adicione uma linha, ou garanta que o total não é zero.
</Accordion>
<Accordion title="Preencha os dados de contacto obrigatórios, ou escolha um tipo de método de acesso">
Nas linhas com **Pedir dados de contacto**, preencha os campos obrigatórios. Nas linhas com **Criar método de acesso**, escolha um tipo e, no caso de reconhecimento de matrícula, também a matrícula.
</Accordion>
<Accordion title="Esta fatura prorroga uma parcela que o cliente não tem em ocupação (proposta)">
Uma fatura assim é uma proposta e não a pode lançar. Peça primeiro ao cliente que ocupe a parcela. Se tiver a permissão **Correções de fatura**, pode, através da seta ao lado de **Lançar fatura**, escolher **Forçar lançamento**. A ocupação só é então prorrogada quando o cliente ocupar a parcela.
</Accordion>
<Accordion title="O montante da fatura excede o máximo do mandato associado">
O montante da fatura não pode exceder o montante máximo do mandato associado. Ajuste o mandato em **Mandato de débito direto** nas **Informações da fatura** ao lado da fatura, ou reduza o montante. Veja [Mandato SEPA](/betalingsverwerking/mandaat).
</Accordion>
<Accordion title="Esta fatura leva o saldo do cliente abaixo de zero">
Um produto com conta controlada (por exemplo uma caução) não pode levar o saldo do cliente abaixo de zero. Se tiver a permissão **Ignorar o saldo da conta**, pode lançar mesmo assim com uma justificação. Veja [Vigiar o saldo do cliente](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken).
</Accordion>
<Accordion title="A fatura não pode ser lançada porque o cliente não tem ID Peppol">
Para um cliente belga com número de IVA tem de ser conhecido um ID Peppol. Abra <UIPath>Clientes > cliente > Faturação</UIPath>, vá a **Definições de faturação** e preencha o ID. Veja [Peppol](/boekhouden/peppol).
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Enviar uma fatura" href="/facturen/versturen" />
  <Card title="Registar pagamentos" href="/facturen/betalingen-registreren" />
  <Card title="Corrigir uma fatura" href="/facturen/corrigeren" description="Se quiser alterar algo depois de lançar" />
</Cards>


# Corrigir uma fatura (/pt-PT/facturen/corrigeren)

Uma fatura lançada não se altera sem mais. A via a escolher depende do ponto em que a fatura já está.

Todas as correções, exceto a reversão, estão no menu de ações (três pontos) ao lado de **Enviar notificação**.

<DocScreenshot src="/screenshots/facturen/invoice-correct-menu.png" alt="Menu de ações de uma fatura lançada com Copiar fatura e Estornar fatura" />

| Situação | O que faz |
|----------|-----------|
| A fatura acabou de ser lançada e ainda não foi enviada | [Reverter para rascunho](#terugzetten-naar-concept) |
| A fatura já foi enviada ou é demasiado antiga | [Estornar](#een-factuur-omkeren) com uma nota de crédito |
| Quer reutilizar as mesmas linhas | [Copiar](#een-factuur-kopiëren) |
| A fatura está no cliente errado | [Mover](#een-factuur-verplaatsen-naar-een-andere-klant) |
| Os montantes não estão certos | [Recalcular](#een-factuur-herberekenen) |

## Reverter para rascunho [#terugzetten-naar-concept]

Enquanto a fatura ainda não saiu, reverte-a para rascunho e lança-a novamente depois de a ajustar.

É possível se tudo isto se verificar:

- A fatura está lançada.
- O Tillor ainda não enviou nenhuma notificação para ela, por qualquer canal.
- A fatura não foi enviada via Peppol.
- A data da fatura é de há menos de 7 dias.

<Steps>
<Step>
### Abra a fatura lançada [#open-de-geboekte-factuur]
Vá a <UIPath>Administração > Faturas</UIPath> e abra a fatura.
</Step>
<Step>
### Reverta-a [#zet-hem-terug]
Clique em **Reverter para rascunho** e confirme com **Sim, reverter para rascunho**. Se o botão não aparecer, a fatura não cumpre as condições.
</Step>
<Step>
### Ajuste a fatura e lance novamente [#pas-de-factuur-aan-en-boek-opnieuw]
Altere as linhas e clique em **Lançar fatura**.
</Step>
</Steps>

Entretanto, a fatura tem um número de rascunho com o número original entre parênteses. A linha **Arredondamento** é retirada e volta quando lança de novo. Ao lançar novamente, a fatura recupera o seu número original, com a data da fatura e a data de vencimento originais. Um rascunho que vem de uma fatura lançada não pode ser eliminado.

Depois de uma reversão, esse evento na linha do tempo **Eventos** tem um botão **Restaurar versão**. Com ele substitui as linhas atuais pelas linhas tal como estavam no momento da reversão. Se a fatura estiver novamente lançada, o Tillor reverte-a primeiro para rascunho.

<Callout type="warn" title="Atenção">
Se a fatura já foi impressa, mostrada ao cliente ou partilhada de outra forma, tenha cuidado. O cliente tem então uma versão que depois deixa de estar certa.
</Callout>

### Quando já não é possível reverter [#als-terugzetten-niet-meer-kan]

<Requires permission="Correções de fatura" />

Se a fatura já não cumpre as condições, por exemplo porque já foi enviada uma notificação ou a fatura tem mais de 7 dias, pode reverter mesmo assim com a permissão **Correções de fatura**. Abra os três pontos no canto superior direito da página da fatura e escolha **Forçar reversão para rascunho**. Use isto apenas se for possível do ponto de vista jurídico e contabilístico. Uma nota de crédito através de [estornar](#een-factuur-omkeren) é normalmente a solução mais limpa.

## Estornar uma fatura [#een-factuur-omkeren]

Ao estornar, cria uma nota de crédito que anula uma fatura lançada. Funciona sempre, mesmo que a fatura já tenha sido enviada ou paga.

<Steps>
<Step>
### Estorne a fatura [#keer-de-factuur-om]
Abra os três pontos no canto superior direito da fatura lançada e escolha **Estornar fatura**. O Tillor cria um novo rascunho com as mesmas linhas em montantes negativos e abre-o.
</Step>
<Step>
### Verifique e lance [#controleer-en-boek]
Ajuste o rascunho se necessário e clique em **Lançar fatura**. Passa então a ser uma **Nota de crédito**.
</Step>
</Steps>

As duas faturas remetem uma para a outra. Nas **Informações da fatura** consta, na nota de crédito, **Estorno de** e, na fatura original, **Estornada como**. Na lista de faturas do perfil do cliente vê, no rascunho, a etiqueta **Rascunho de anulação** e, na fatura original, **Esta fatura foi anulada**.

Se já estornou uma fatura antes, o Tillor pede confirmação com **Sim, estornar novamente**, para não criar duas notas de crédito por engano.

Se quiser compensar a nota de crédito com a fatura original, escolha **Transferência interna** ao pagar. Veja [Transferência interna](/betalingsverwerking/interne-overboeking).

## Copiar uma fatura [#een-factuur-kopiëren]

Escolha **Copiar fatura** no menu de ações de uma fatura lançada. O Tillor cria um novo rascunho com as mesmas linhas, a mesma nota e o mesmo mandato de débito direto, e abre-o. A linha **Arredondamento** não é copiada.

## Mover uma fatura para outro cliente [#een-factuur-verplaatsen-naar-een-andere-klant]

<Requires permission="Correções de fatura" />

Se uma fatura está no cliente errado, move-a.

<Steps>
<Step>
### Abra o menu de ações [#open-het-actiemenu]
Clique nos três pontos no canto superior direito da página da fatura e escolha **Mover para o cliente**.
</Step>
<Step>
### Escolha o cliente [#kies-de-klant]
Escolha o **Cliente de destino** e clique em **Mover fatura**.
</Step>
</Steps>

A fatura muda-se com os pagamentos associados, lotes de contador e comentários. Uma fatura lançada é depois enviada novamente para a sua contabilidade. Se a fatura já foi enviada via Peppol, não a pode mover.

## Recalcular uma fatura [#een-factuur-herberekenen]

Se os montantes de uma fatura lançada não correspondem às linhas, escolha **Recalcular fatura** no menu de ações. O Tillor recalcula os totais.

## Eliminar um rascunho [#een-concept-verwijderen]

Pode eliminar um rascunho de fatura com **Eliminar fatura** no menu de ações. Volta então ao perfil do cliente. As faturas lançadas não se podem eliminar, estorna-as.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

| Via | Consequência |
|-----|--------------|
| Reverter para rascunho | O número da fatura mantém-se. Ao lançar de novo, a fatura recupera o seu número e datas originais. |
| Estornar | Surge uma nota de crédito que remete para a fatura original. A compensação pode fazer-se com uma [transferência interna](/betalingsverwerking/interne-overboeking). |
| Copiar | Surge um novo rascunho. A fatura original não muda. |
| Mover | Pagamentos, lotes de contador e comentários mudam-se com ela. Uma fatura lançada segue novamente para a sua contabilidade. |
| Recalcular | Os totais são recalculados a partir das linhas. |

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não vejo Reverter para rascunho">
Uma das condições não se verifica. Já foi enviada uma notificação ou a fatura tem 7 dias ou mais? Então pode estornar, ou, com a permissão **Correções de fatura**, reverter de forma forçada.
</Accordion>
<Accordion title="Mover para o cliente não aparece">
Para isso precisa da permissão **Correções de fatura**. Se a fatura foi enviada via Peppol, não é possível movê-la.
</Accordion>
<Accordion title="Que permissões tem o meu utilizador?">
Um administrador define-as. Veja [Utilizadores](/gebruikers).
</Accordion>
</Accordions>

## Mais [#verder]

<Cards>
  <Card title="Lançar uma fatura" href="/facturen/boeken" />
  <Card title="Estados" href="/facturen/statussen" />
  <Card title="Peppol" href="/boekhouden/peppol" description="Enviar faturas via Peppol" />
</Cards>


# Resumo (/pt-PT/facturen)

Em <UIPath>Administração > Faturas</UIPath> encontra todas as faturas do seu parque, com os montantes em aberto no topo. Uma fatura começa como rascunho e só se torna definitiva quando a lança. Depois pode enviá-la, fazê-la pagar e, se necessário, corrigi-la.

<Callout type="info" title="Bom saber">
- Uma nova fatura cria-se no perfil do cliente, não a partir desta lista.
- Uma fatura lançada recebe uma data de vencimento: o dia do lançamento mais o prazo de vencimento predefinido da sua organização, por predefinição 7 dias. Pode escolher outro prazo por fatura.
- Se o total não for múltiplo de 5 cêntimos, o Tillor acrescenta uma linha **Arredondamento** ao lançar.
- O Tillor não envia sozinho uma fatura lançada ao cliente. Faz isso você com **Enviar notificação**.
- Reverter para rascunho é possível até 7 dias após a data da fatura, desde que não tenha sido enviada nenhuma notificação e a fatura não tenha sido enviada via Peppol. Depois disso, estorna a fatura com uma nota de crédito.
- Um pagamento em numerário pode ser, por predefinição, no máximo 2999 euros. Altera-o com **Máximo em numerário** em <UIPath>Apoio > Definições > Pagamentos</UIPath>.
- Um débito direto com mandato SEPA segue para o banco dois dias após o lançamento. Até lá pode cancelar o pagamento.
- A ligação pessoal de uma fatura não tem data de validade. O cliente vê aí o que ainda está em aberto.
- Se o cliente tiver um ID Peppol, o Tillor envia a fatura automaticamente via Peppol após o lançamento.
</Callout>

## Como tudo se liga [#hoe-hangt-dit-samen]

Uma fatura é o início de uma cadeia. Um pagamento está associado a uma fatura lançada, os pagamentos de um dia vão para um relatório de pagamentos e esse relatório segue para a sua contabilidade.

```mermaid
flowchart LR
  A[Rascunho de fatura] -- Lançar --> B[Fatura lançada]
  B -- Enviar notificação --> K[Cliente recebe a fatura]
  K -- Cliente paga online --> C[Pagamento]
  B -- Você regista um pagamento --> C
  C -- Saldo e estado do pagamento --> B
  C -- Agrupado por dia --> D[Relatório de pagamentos]
  D -- Mollie e transferências internas --> E[Contabilidade]
```

- O saldo em aberto e o estado do pagamento da fatura resultam automaticamente dos pagamentos.
- Um pagamento sem fatura pode ser associado mais tarde a uma fatura lançada.
- Que pagamentos seguem para a contabilidade, lê em [Contabilidade](/boekhouden).

## A lista de faturas [#de-facturenlijst]

No topo há quatro contadores: **Total de faturas**, **Faturas em aberto** (por pagar ou parcialmente pagas), **Faturas vencidas** (data de vencimento ultrapassada) e **Total em aberto** (o montante total das faturas em aberto).

Por baixo há quatro listas:

- **Pagamentos pendentes**: faturas lançadas cujo pagamento foi iniciado mas ainda não chegou de forma definitiva
- **Faturas com saldo em aberto**: faturas lançadas com um montante ainda por pagar, ordenadas por data de vencimento
- **Rascunhos**: os dez rascunhos de fatura criados mais recentemente
- **Todas as faturas**: a lista completa, filtrada por predefinição para faturas lançadas

<DocScreenshot src="/screenshots/facturen/invoices-list.png" alt="Resumo de faturas - Todas as faturas" />

As novas faturas não se criam a partir desta lista. Faz isso no perfil do cliente, veja [Criar uma fatura](/facturen/aanmaken-en-bewerken#een-factuur-aanmaken).

### Pesquisar e filtrar [#zoeken-en-filteren]

A barra de pesquisa procura por número de fatura, nome próprio ou apelido do cliente, endereço de e-mail e montante. Na lista **Todas as faturas** pode ainda filtrar por:

| Filtro | O que faz |
|--------|-----------|
| **Período** | Apenas faturas dentro de um determinado período |
| **Estado** | **Rascunho** ou **Lançada** |
| **Estado do pagamento** | **Por pagar**, **Parcial**, **Pendente** ou **Paga** |
| **Tipo de cliente** | **Predefinido**, **Caravana de aluguer para trabalhadores** ou **Caravana de reboque para trabalhadores** |
| **Cliente** | Todas as faturas de um cliente |
| **Produtos** | Faturas com um determinado produto numa linha |
| **Montante** | Faturas com um montante mínimo ou máximo |

Na lista **Faturas com saldo em aberto** existe também o filtro **Pronto para lembrete**. Escolhe um número de dias (7 a 90) e vê as faturas vencidas criadas há pelo menos esse tempo e para as quais não foi enviado lembrete por e-mail ou SMS nos últimos dias. Útil para decidir a quem voltar a enviar lembrete.

<DocScreenshot src="/screenshots/facturen/invoice-open-balance.png" alt="Faturas com saldo em aberto" />

### Faturas por cliente [#facturen-per-klant]

No perfil de um cliente encontra todas as faturas desse cliente no bloco **Faturas** do separador **Visão geral**, ou no separador **Faturação**. Aí também cria uma nova fatura.

## Guias [#handleidingen]

<Cards>
  <Card title="Criar e editar" href="/facturen/aanmaken-en-bewerken" description="Criar um rascunho de fatura e adicionar linhas" />
  <Card title="Lançar uma fatura" href="/facturen/boeken" description="Tornar a fatura definitiva" />
  <Card title="Enviar uma fatura" href="/facturen/versturen" description="Notificação ou lembrete ao cliente" />
  <Card title="Registar pagamentos" href="/facturen/betalingen-registreren" description="Registar ou atribuir um pagamento" />
  <Card title="Imprimir e descarregar" href="/facturen/afdrukken-en-downloaden" description="PDF, impressora e ligação pessoal" />
  <Card title="Corrigir" href="/facturen/corrigeren" description="Reverter, estornar, copiar e mover" />
  <Card title="Estados" href="/facturen/statussen" description="O que significam Rascunho, Lançada e Paga" />
</Cards>

## Relacionado [#gerelateerd]

<Cards>
  <Card title="Processamento de pagamentos" href="/betalingsverwerking" description="Métodos de pagamento em detalhe" />
  <Card title="Produtos" href="/producten" description="Ações nas linhas de fatura" />
  <Card title="Contabilidade" href="/boekhouden" description="Relatórios de pagamentos e ligações contabilísticas" />
  <Card title="Exemplos práticos" href="/praktijk" description="Exemplos desenvolvidos da prática" />
</Cards>

## Conceitos [#begrippen]

- **Rascunho**: uma fatura que ainda pode alterar, com um número de rascunho provisório.
- **Lançada**: uma fatura definitiva com o seu próprio número de fatura. Veja [Lançar](/begrippen#boeken).
- **Nota de crédito**: uma fatura lançada com total negativo, por exemplo depois de estornar uma fatura.
- **Estado do pagamento**: se e quanto da fatura foi pago. Veja [Estados](/facturen/statussen).
- **Cliente**: o cliente a quem a fatura se destina. Veja [Cliente](/begrippen#klant).
- **Ocupação**: um cliente numa parcela durante um período. Veja [Ocupação](/begrippen#bezetting).


# Estados da fatura (/pt-PT/facturen/statussen)

Cada fatura tem um **estado** (se já é definitiva) e, depois de lançada, um **estado do pagamento** (quanto foi pago). Pode filtrar ambos na [lista de faturas](/facturen).

<DocScreenshot src="/screenshots/facturen/invoices-list.png" alt="Lista de faturas com estado e estado do pagamento por fatura" />

## Estado da fatura [#factuurstatus]

| Estado | Significado |
|--------|-------------|
| <Status>Rascunho</Status> | A fatura ainda é editável e tem um número de rascunho provisório. Ainda não a pode enviar nem fazer pagar. |
| <Status tone="success">Lançada</Status> | A fatura é definitiva e tem o seu próprio número de fatura. Pode enviá-la, fazê-la pagar e corrigi-la. |

Um rascunho que foi revertido a partir de uma fatura lançada tem um número de rascunho com o número de fatura original entre parênteses. Veja [Corrigir uma fatura](/facturen/corrigeren).

## Estado do pagamento [#betalingsstatus]

O estado do pagamento aparece ao lado do número de uma fatura lançada.

| Estado | Significado |
|--------|-------------|
| <Status tone="error">Por pagar</Status> | Ainda nada foi pago. |
| <Status tone="warning">Parcial</Status> | Foi paga uma parte e ainda há um montante em aberto. |
| <Status tone="info">Pendente</Status> | O montante total foi iniciado, por exemplo um débito direto, mas o dinheiro ainda não foi processado de forma definitiva. |
| <Status tone="success">Paga</Status> | A fatura está totalmente liquidada. |

Uma fatura está **vencida** quando a data de vencimento passou e ainda há um montante em aberto. Isso não é um estado separado. Vê-o no contador **Faturas vencidas** na lista de faturas.

## Tipo de fatura [#factuurtype]

| Tipo | Significado |
|------|-------------|
| **Fatura** | Uma fatura normal com total positivo. |
| **Nota de crédito** | Uma fatura lançada com total negativo, por exemplo depois de [estornar uma fatura](/facturen/corrigeren#een-factuur-omkeren). |

## Etiquetas na lista do perfil do cliente [#labels-in-de-lijst-op-het-klantprofiel]

| Etiqueta | Significado |
|----------|-------------|
| **Enviada via Peppol** | A fatura foi enviada via Peppol. |
| **Rascunho de anulação** | Este rascunho foi criado para estornar outra fatura. |
| **Esta fatura foi anulada** | Existe uma nota de crédito ou um rascunho que anula esta fatura. |

## Mais [#verder]

<Cards>
  <Card title="Resumo" href="/facturen" description="A lista de faturas e os filtros" />
  <Card title="Registar pagamentos" href="/facturen/betalingen-registreren" />
</Cards>


# Enviar uma fatura (/pt-PT/facturen/versturen)

Com **Enviar notificação** envia ao cliente uma fatura lançada por e-mail, SMS, WhatsApp ou correio. O Tillor nunca o faz sozinho. Se a fatura já foi enviada mas ainda não está paga, envia um lembrete. O cliente pode depois pagar através da ligação na mensagem, veja [Deixar um cliente pagar online](/betalingsverwerking/online).

Antes de começar:

- A fatura está lançada. Num rascunho, os botões não aparecem.
- O cliente tem pelo menos um endereço de e-mail, um número de telefone ou uma morada postal completa (rua, código postal e localidade). Caso contrário, os botões não aparecem.
- Para um lembrete, ainda há um montante em aberto.

## Enviar uma fatura [#een-factuur-versturen]

<Steps>
<Step>
### Abra a fatura lançada [#open-de-geboekte-factuur]
Vá a <UIPath>Administração > Faturas</UIPath> e abra uma fatura com o estado <Status tone="success">Lançada</Status>.
</Step>
<Step>
### Clique em Enviar notificação [#klik-op-verstuur-notificatie]
Abre-se uma janela **Enviar notificação**.
</Step>
<Step>
### Escolha os canais [#kies-de-kanalen]
Pode escolher entre:

- **E-mail**: o cliente recebe um e-mail com a fatura em anexo. Fica ativo por predefinição se houver um endereço de e-mail.
- **SMS**: o cliente recebe uma mensagem SMS. Só disponível com um número de telefone.
- **WhatsApp**: só visível se o WhatsApp Business estiver instalado. Exige um número de telefone e um método de pagamento na Meta ou uma conversa em curso com o cliente.
- **Correio**: a fatura segue em PDF por correio. Só disponível com uma morada postal completa. Fica desativado por predefinição e mostra um valor indicativo de porte por carta.

Um canal que não é possível para este cliente fica desativado com o motivo, por exemplo **Nenhum endereço de e-mail registado**. Escolha pelo menos um canal.
</Step>
<Step>
### Envie [#verstuur]
Clique em **Enviar**.
</Step>
</Steps>

## Enviar um lembrete [#een-aanmaning-versturen]

Um lembrete é possível assim que a fatura está lançada e ainda há um montante em aberto.

<Steps>
<Step>
### Abra o menu de escolha [#open-het-keuzemenu]
Clique na seta ao lado de **Enviar notificação** e escolha **Enviar lembrete**.
</Step>
<Step>
### Escolha os canais [#kies-de-kanalen-1]
Aqui, **E-mail** e **SMS** ficam ativos por predefinição se o cliente tiver endereço de e-mail e número de telefone. Com **Correio**, o cliente recebe uma carta de lembrete com a fatura em anexo, com um código QR para ver ou pagar online.

<DocScreenshot src="/screenshots/facturen/invoice-reminder-dialog.png" alt="Caixa de diálogo de confirmação de envio de lembrete" />
</Step>
<Step>
### Escolha, se quiser, correio registado [#kies-eventueel-aangetekend]
Se marcou **Correio**, pode escolher **Correio registado com aviso de receção**. Isto só é possível num lembrete, não na primeira notificação da fatura, e apenas se o correio registado estiver disponível para essa morada. O Tillor mostra então o valor extra indicativo a somar aos custos normais de porte. O botão passa a chamar-se **Enviar com custo extra**.
</Step>
<Step>
### Envie [#verstuur-1]
Clique em **Enviar**.
</Step>
</Steps>

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

Na página da fatura, o bloco **Notificações** mostra que mensagens foram enviadas. Todas as mensagens da sua organização estão em <UIPath>Comunicação > Notificações</UIPath>.

Os envios por correio começam em **Pendente**. Depois segue o estado da carta: **PDF recebido**, **Validado**, **A processar**, **No centro de impressão** e **Entregue ao serviço postal**. Assim que a transportadora o confirma, o estado passa a **Enviado**. O correio que não pode ser entregue passa a **Falhou**. Uma carta cancelada na transportadora fica com o estado **Ignorado**. Abra a mensagem para ver o valor do porte, a referência da transportadora e o último estado de rastreio. Mais sobre isto em [Notificações](/notificaties).

- O Tillor envia a mensagem de imediato. O cliente recebe uma ligação para ver a fatura e pagar online.
- Um lembrete continua a ser uma ação avulsa por fatura. O filtro **Pronto para lembrete** na [lista de faturas](/facturen) ajuda a escolher a quem voltar a enviar lembrete.
- As automatizações também podem enviar lembretes automaticamente. Veja [Automatizações](/automatiseringen).

<Callout type="info">
Uma fatura para a qual já foi enviada uma notificação já não se reverte facilmente para rascunho. Veja [Corrigir uma fatura](/facturen/corrigeren#terugzetten-naar-concept).
</Callout>

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não vejo Enviar notificação">
A fatura tem de estar lançada, e o cliente tem de ter um endereço de e-mail, um número de telefone ou uma morada postal completa. Complete os dados no perfil do cliente.
</Accordion>
<Accordion title="Não vejo Enviar lembrete">
Um lembrete só é possível numa fatura lançada com um montante em aberto.
</Accordion>
<Accordion title="A mensagem falhou">
Abra a mensagem em <UIPath>Comunicação > Notificações</UIPath> para ver a mensagem de erro. Depois verifique o endereço de e-mail, o número de telefone ou a morada postal do cliente e envie novamente. Veja [Notificações](/notificaties).
</Accordion>
</Accordions>

## Mais [#verder]

<Cards>
  <Card title="Notificações" href="/notificaties" description="Estado e histórico das mensagens enviadas" />
  <Card title="Registar pagamentos" href="/facturen/betalingen-registreren" />
</Cards>


# Convidar utilizadores e atribuir permissões (/pt-PT/gebruikers/gebruikers-en-rechten)

Um colega com conta Tillor chama-se utilizador no Tillor. É você que decide quem tem acesso à sua organização e o que essa pessoa pode ver e fazer, através de permissões. Para colegas que contacta com frequência em conjunto, crie depois um [grupo](/gebruikers/groepen).

Antes de começar:

- Precisa da permissão **Gerir permissões de utilizadores**. Sem ela, os botões **Convidar utilizador** e **Editar permissões** ficam a cinzento.
- Só pode atribuir permissões que tem. Uma permissão que não tem, não a pode ativar para outra pessoa.
- A permissão **Gerir permissões de utilizadores** só pode ser atribuída a outra pessoa por um utilizador com **Todas as permissões**.

## Convidar um colega [#een-collega-uitnodigen]

<Steps>
<Step>
### Abra os utilizadores [#open-de-gebruikers]
Vá a <UIPath>Apoio > Definições > Utilizadores</UIPath>. Vê os **Membros** da sua organização e os **Convites pendentes**.

<DocScreenshot src="/screenshots/gebruikers/settings-membership-permissions.png" alt="Definições > Utilizadores com a lista de membros" />
</Step>
<Step>
### Clique em Convidar utilizador [#klik-op-gebruiker-uitnodigen]
Abre-se a janela **Convidar utilizador**.

<DocScreenshot src="/screenshots/gebruikers/settings-members-invite-dialog.png" alt="A janela Convidar utilizador" />
</Step>
<Step>
### Preencha o endereço de e-mail [#vul-het-e-mailadres-in]
Escreva o **Endereço de e-mail** do seu colega e clique em **Convidar**.
</Step>
</Steps>

O que acontece a seguir depende do endereço de e-mail:

<Tabs items={["Já existe uma conta Tillor", "Ainda não há conta Tillor"]}>
<Tab value="Já existe uma conta Tillor">
O utilizador passa logo a ser membro da sua organização. O Tillor indica **Utilizador adicionado à organização**. A pessoa vê imediatamente a sua organização entre as suas organizações.
</Tab>
<Tab value="Ainda não há conta Tillor">
O Tillor indica **Convite enviado** e envia um convite por e-mail. Até a pessoa iniciar sessão pela primeira vez, aparece em **Convites pendentes** com o selo **Pendente**. No primeiro início de sessão, passa a ser membro da sua organização. Com **Revogar convite** retira o convite, e o Tillor indica **Convite revogado**.
</Tab>
</Tabs>

Um novo utilizador começa com estas permissões: **Ver definições**, **Editar definições**, **Ver integrações**, **Gerir integrações**, **Notificações de alarme de contadores**, **Notificações de mensagens da caixa de entrada**, **Alertas de tablet e quiosque**, **Gerir pedidos de assinatura** e **Gerir campos personalizados**. Verifique se isso serve e ajuste-o.

## Editar permissões [#rechten-bewerken]

<Steps>
<Step>
### Clique em Editar permissões junto do utilizador [#klik-bij-de-gebruiker-op-rechten-bewerken]
Abre-se a janela **Editar permissões do utilizador**. No topo estão os grupos de que o utilizador é membro. Com **Pesquisar permissões** encontra rapidamente uma permissão.

<DocScreenshot src="/screenshots/gebruikers/settings-membership-permissions-dialog.png" alt="A janela Editar permissões do utilizador com as permissões por área" />
</Step>
<Step>
### Ative ou desative permissões [#zet-rechten-aan-of-uit]
As permissões estão agrupadas por área, como **Faturação**, **Pagamentos** ou **Caixa de entrada**. No fim aparece quantas permissões efetivas o utilizador tem.
</Step>
<Step>
### Guarde as permissões [#sla-de-rechten-op]
Clique em **Guardar permissões**. O Tillor indica **Permissões do utilizador guardadas**.
</Step>
</Steps>

### De onde vem uma permissão? [#waar-komt-een-recht-vandaan]

Cada permissão mostra a sua origem. Assim vê porque é que alguém consegue ou não fazer determinada coisa.

| Origem | Significado |
|---|---|
| **Direto** | Atribuiu a permissão diretamente a este utilizador. Pode desativá-la aqui |
| Um nome de grupo | Esse [grupo](/gebruikers/groepen#groepsrechten) concede a permissão. Não a pode desativar aqui, apenas no grupo |
| **Bloqueado** com um nome de grupo | Esse grupo recusa a permissão. Mesmo que o utilizador a tivesse por si, continua bloqueada |
| **Não concedido** | Ninguém concede a permissão |

O botão **Editar permissões** fica a cinzento na sua própria linha e para utilizadores com o selo **Todas as permissões**. Esses utilizadores têm tudo e não os pode limitar.

## Configurar as notificações de um colega [#meldingen-van-een-collega-instellen]

Com o ícone do sino (**Definições de notificações**) junto de um utilizador abre as notificações dessa pessoa nesta organização. Para cada notificação escolhe e-mail, push ou chamada telefónica. Com **Todas as notificações** desativa um canal de uma só vez. As alterações têm efeito imediato e aplicam-se apenas a esta organização.

<DocScreenshot src="/screenshots/gebruikers/settings-members-notifications-dialog.png" alt="A janela com as notificações de um colega" />

As notificações que são sempre enviadas não podem ser desativadas. O que é uma notificação e onde as vê de novo está em [Notificações](/notificaties#meldingen-in-de-app).

## Remover um utilizador [#een-gebruiker-verwijderen]

Clique no ícone do caixote do lixo (**Remover da organização**) e confirme com **Remover utilizador**. O Tillor indica **Utilizador removido da organização**. A pessoa perde logo o acesso a esta organização. A sua conta Tillor continua a existir, tal como as eventuais outras organizações.

Não se pode remover a si próprio. Um utilizador com **Todas as permissões** só o pode remover se também tiver **Todas as permissões**.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- O utilizador vê a sua organização entre as suas organizações e pode usar aquilo para que tem permissões.
- Uma alteração de permissões aplica-se logo depois de guardar.
- Um utilizador removido perde logo o acesso. A sua conta Tillor continua a existir.

## Problemas? [#problemen]

<Accordions>
<Accordion title="O botão Convidar utilizador está a cinzento">
Não tem a permissão **Gerir permissões de utilizadores**. Peça a um colega com **Todas as permissões** que lha atribua.
</Accordion>
<Accordion title="O Tillor indica Falha ao convidar o utilizador">
Esse endereço de e-mail já é membro da sua organização, ou já existe um convite pendente para esse endereço. Veja as listas **Membros** e **Convites pendentes**. Se o convite já lá estiver, revogue-o e convide de novo se a pessoa não recebeu o e-mail.
</Accordion>
<Accordion title="A pessoa convidada não encontra o e-mail">
Peça-lhe que verifique o spam. Só passa a ser membro quando inicia sessão exatamente com o endereço de e-mail com que a convidou. Se iniciar sessão com outro endereço, revogue o convite e convide esse endereço.
</Accordion>
<Accordion title="Uma permissão está a cinzento e não a consigo ativar">
Só pode atribuir permissões que tem. Se junto da permissão aparecer um nome de grupo, esse grupo concede ou bloqueia a permissão e ajusta-a no grupo.
</Accordion>
<Accordion title="Editar permissões está a cinzento num colega">
O colega tem **Todas as permissões**, ou é a sua própria linha. Não os pode editar.
</Accordion>
<Accordion title="A um colega falta um botão, embora eu lhe tenha atribuído a permissão">
Verifique na janela **Editar permissões do utilizador** se um grupo mostra a permissão como **Bloqueado**. Uma recusa de um grupo prevalece sempre sobre uma permissão que atribuiu diretamente.
</Accordion>
<Accordion title="Não consigo remover um utilizador">
Não se pode remover a si próprio. Um utilizador com **Todas as permissões** só o remove se também tiver **Todas as permissões**.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Grupos" href="/gebruikers/groepen" description="Agrupar colegas e definir permissões por grupo" />
  <Card title="Notificações" href="/notificaties" description="Como chegam as notificações" />
  <Card title="Visibilidade e acesso dos campos personalizados" href="/eigen-velden/zichtbaarheid-en-toegang" description="Permissões por campo personalizado" />
  <Card title="Organização" href="/gebruikers/organisaties" description="Todas as secções das Definições" />
</Cards>


# Grupos (/pt-PT/gebruikers/groepen)

Um grupo é um conjunto fixo de colegas, por exemplo **Receção** ou **Serviço técnico**. Usa um grupo nestes locais:

- **Atribuir tarefas**: ao atribuir uma tarefa, procure pelo nome do grupo
- **Mencionar e avisar**: uma menção ou notificação a um grupo chega a todos os membros
- **Partilhar vistas**: numa vista de tarefas escolha **Grupos específicos**, veja [Vistas](/taken/weergaven#wie-ziet-een-weergave)
- **Automatizações**: os passos que criam ou atualizam uma tarefa podem atribuir a grupos

## Criar um grupo [#een-groep-maken]

<Steps>
<Step>
### Abra Grupos [#open-groepen]
Vá a <UIPath>Apoio > Definições > Grupos</UIPath>.

<DocScreenshot src="/screenshots/gebruikers/settings-groups.png" alt="Definições > Grupos com dois grupos" />
</Step>
<Step>
### Clique em Novo grupo [#klik-op-nieuwe-groep]
Preencha um **Nome**, por exemplo Receção.
</Step>
<Step>
### Escolha os membros [#kies-de-leden]
Em **Membros** escolha as pessoas. Só pode adicionar utilizadores que já sejam membros da organização.
</Step>
<Step>
### Clique em Guardar [#klik-op-opslaan]
O Tillor indica **Grupo guardado**.
</Step>
</Steps>

Clique num grupo para alterar o nome ou os membros. Se eliminar um grupo, as tarefas continuam atribuídas a quem estiver indicado diretamente. Só o próprio grupo desaparece.

## Permissões do grupo [#groepsrechten]

Um grupo também pode conceder ou retirar permissões. No grupo, clique na chave (**Permissões do grupo**). Para cada permissão escolhe:

| Escolha | O que faz |
|---|---|
| **Permitir** | Todos no grupo recebem a permissão ("Concedida a todos") |
| **Herdar** | O grupo não faz nada com esta permissão. Cada membro mantém o seu próprio acesso ("Segue o acesso próprio"). Este é o estado inicial |
| **Negar** | A permissão fica bloqueada para todos no grupo ("Bloqueada para todos") |

<DocScreenshot src="/screenshots/gebruikers/settings-group-permissions-dialog.png" alt="A janela Permissões do grupo com Negar, Herdar e Permitir" />

Com **Pesquisar permissões** encontra rapidamente uma permissão. No fim aparece quantas permissões definiu. Clique em **Guardar**, e o Tillor indica **Permissões do grupo guardadas**.

<Requires permission="Gerir permissões de utilizadores" />

Sem essa permissão, o botão **Permissões do grupo** fica a cinzento. Também não pode eliminar um grupo que ainda tenha permissões de grupo.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- As permissões do grupo somam-se às permissões próprias de cada membro. Uma recusa prevalece sempre: se uma permissão estiver em **Negar** num grupo e em **Permitir** noutro, continua bloqueada.
- Na janela **Editar permissões do utilizador** de um membro vê, para cada permissão, que grupo a concede ou bloqueia. Veja [Editar permissões](/gebruikers/gebruikers-en-rechten#rechten-bewerken).
- Se adicionar um membro, as permissões do grupo também se aplicam a esse membro. Se o retirar, deixam de se aplicar.
- Atribuir uma tarefa, mencionar alguém ou enviar uma notificação ao grupo chega a todos os que forem membros nesse momento.

## Grupos do Microsoft Entra [#groepen-uit-microsoft-entra]

Se já gere o seu pessoal no Microsoft Entra ID, o Entra pode manter automaticamente os membros de um grupo. Por baixo da lista de grupos aparece então a tabela **Grupos do Entra**, onde associa cada grupo do Entra a um grupo do Tillor.

<Callout type="info">
Num grupo associado, o Entra é a fonte. Um membro que adicione ou retire à mão no Tillor volta a ficar igual ao Entra na sincronização seguinte.
</Callout>

Veja [Grupos do Microsoft Entra](/gebruikers/microsoft-entra) para configurar a associação.

## Problemas? [#problemen]

<Accordions>
<Accordion title="O Tillor indica Não foi possível guardar o grupo">
Tente de novo. Se continuar a falhar, contacte o suporte do Tillor.
</Accordion>
<Accordion title="O botão Permissões do grupo está a cinzento">
Não tem a permissão **Gerir permissões de utilizadores**.
</Accordion>
<Accordion title="Um membro não consegue fazer algo, embora o grupo o permita">
Outro grupo desse membro recusa essa permissão. Uma recusa prevalece sempre. Abra a janela **Editar permissões do utilizador** do membro para ver que grupo a bloqueia.
</Accordion>
<Accordion title="Não vejo um membro na lista de escolha">
Só os utilizadores da sua organização aparecem na lista. Convide primeiro a pessoa. Veja [Convidar utilizadores](/gebruikers/gebruikers-en-rechten).
</Accordion>
<Accordion title="Um membro desaparece sempre do grupo">
Se o grupo estiver associado ao Microsoft Entra, o Entra é a fonte e a sincronização seguinte volta a igualar os membros. Ajuste o membro no Entra.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Grupos do Microsoft Entra" href="/gebruikers/microsoft-entra" description="Manter grupos automaticamente a partir do Entra" />
  <Card title="Vistas" href="/taken/weergaven" description="Partilhar uma vista de tarefas com um grupo" />
  <Card title="Organização" href="/gebruikers/organisaties" description="Definições e permissões de utilizadores" />
</Cards>


# Visão geral (/pt-PT/gebruikers)

Aqui define quem trabalha com o Tillor e o que pode fazer: convidar utilizadores, atribuir permissões, colocar colegas em grupos e ajustar as definições da sua organização. Um utilizador é qualquer pessoa com uma conta que tem acesso à sua organização. Gere isto em <UIPath>Apoio > Definições</UIPath>.

<DocScreenshot src="/screenshots/gebruikers/settings-membership-permissions.png" alt="Definições > Utilizadores com a lista de membros" />

<Callout type="info" title="Bom saber">
- Um novo utilizador recebe um conjunto fixo de permissões iniciais (definições, integrações, algumas notificações, pedidos de assinatura e campos personalizados). Tudo o resto é você que atribui
- Só pode atribuir permissões que tem. A permissão **Gerir permissões de utilizadores** só pode ser passada por um utilizador com **Todas as permissões**
- Uma recusa através de um grupo prevalece sempre sobre uma permissão que atribuiu diretamente
- Não pode remover-se a si próprio nem editar as suas próprias permissões
- Não tem uma palavra-passe Tillor separada: inicia sessão através do Google, da Microsoft ou da Apple
- Os dados da empresa, como o número de IVA ou o IBAN, não os altera você. Isso é feito pelo suporte do Tillor
</Callout>

## Como está tudo ligado? [#hoe-hangt-dit-samen]

Um utilizador tem permissões de duas formas: diretamente ou através de um grupo. Um grupo também pode recusar uma permissão.

```mermaid
flowchart TD
  U[Utilizador] -->|atribuída diretamente| R[Permissões do utilizador]
  U -->|é membro de| G[Grupo]
  G -->|Permitir| R
  G -->|Herdar| N[Não faz nada, o utilizador mantém as suas permissões]
  G -->|Negar| B[Permissão bloqueada, mesmo que o utilizador a tivesse]
  R --> A[O que o utilizador vê e pode fazer no Tillor]
  B --> A
```

- **Direto**: ativa uma permissão na janela **Editar permissões do utilizador**. Veja [Convidar utilizadores e atribuir permissões](/gebruikers/gebruikers-en-rechten).
- **Através de um grupo**: em **Permissões do grupo** escolhe, para cada permissão, **Permitir**, **Herdar** ou **Negar**. Isso aplica-se a todos no grupo. Veja [Grupos](/gebruikers/groepen).
- **Recusada**: se uma permissão estiver em **Negar** num grupo, fica bloqueada, por muitos que sejam os outros grupos ou permissões diretas que a concedam.
- Usa os mesmos grupos para atribuir tarefas, mencionar e partilhar vistas.

## A sua própria conta [#je-eigen-account]

Na barra lateral, clique no seu nome (em baixo) e escolha **Conta**. Aí gere o seu perfil, número de telefone, sessões ativas, aplicações OAuth e plataformas de início de sessão associadas. Em **Notificações** escolhe, para cada notificação, se o Tillor o contacta por e-mail ou push. Veja [Início de sessão e acesso](/inloggen).

## Chaves de API [#api-sleutels]

Uma chave de API permite que outro programa fale com o Tillor em seu nome. Pertence à sua conta. Gira-as na página da sua conta.

<Steps>
<Step>
### Abra a sua conta [#open-je-account]
Na barra lateral, clique no seu nome (em baixo) e escolha **Conta**.
</Step>
<Step>
### Crie a chave [#maak-de-sleutel]
Abra a secção **Chaves de API** e clique em **Criar chave de API**.
</Step>
<Step>
### Copie-a de imediato [#kopieer-hem-meteen]
Depois disso, o Tillor deixa de mostrar a chave por inteiro.
</Step>
</Steps>

Em **Programadores** (o mesmo menu de utilizador) encontra também o atalho **Ir para as chaves de API**.

<Callout type="warn">
Guarde as chaves de API em segurança e nunca as partilhe por canais não seguros. Se uma chave tiver sido divulgada, elimine-a ou clique em **Regenerar** e crie uma nova, se necessário.
</Callout>

## Secções [#onderdelen]

<Cards>
  <Card title="Convidar utilizadores e atribuir permissões" href="/gebruikers/gebruikers-en-rechten" description="Adicionar colegas e definir o que podem fazer" />
  <Card title="Grupos" href="/gebruikers/groepen" description="Atribuir, mencionar e dar permissões a colegas em conjunto" />
  <Card title="Grupos do Microsoft Entra" href="/gebruikers/microsoft-entra" description="Manter automaticamente os membros do grupo a partir do Entra" />
  <Card title="Organização" href="/gebruikers/organisaties" description="Todas as secções das Definições" />
  <Card title="Definições de faturação" href="/gebruikers/instellingen-facturatie" description="PDF, prazo de vencimento e taxas de IVA" />
  <Card title="Definições de pagamentos" href="/gebruikers/instellingen-betalingen" description="Outros, lembretes e endereço de remetente" />
  <Card title="Configurar períodos de renda" href="/gebruikers/instellingen-huurperiodes" description="Frequências de renda para ocupações" />
  <Card title="Definições de controlo de acesso" href="/gebruikers/instellingen-toegangscontrole" description="Saída com matrícula expirada" />
  <Card title="Programadores" href="/ontwikkelaars" description="Documentação de integração e webhooks" />
</Cards>

## Termos [#begrippen]

- **Utilizador**: alguém com uma conta que tem acesso à sua [organização](/begrippen#organisatie).
- **[Permissão](/begrippen#recht)**: uma autorização para ver ou fazer algo, como **Editar produtos**.
- **Todas as permissões**: um selo para utilizadores que podem fazer tudo. As suas permissões não se editam.
- **[Grupo](/begrippen#groep)**: um conjunto fixo de colegas, eventualmente com permissões próprias.
- **Convite**: um pedido pendente a alguém sem conta para se tornar membro.
- **Chave de API**: um código com que outro programa trabalha com o Tillor.

Há mais termos na [lista de termos](/begrippen).


# Definições de pagamentos (/pt-PT/gebruikers/instellingen-betalingen)

Em <UIPath>Apoio > Definições > Pagamentos</UIPath> estão algumas definições que influenciam o registo de pagamentos e o envio de notificações. As definições aplicam-se a toda a sua organização.

<Requires permission="Editar definições" />

<DocScreenshot src="/screenshots/instellingen/settings-payments.png" alt="Definições > Pagamentos" />

## Definições [#instellingen]

| Definição | O que faz |
|---|---|
| **Mostrar método de pagamento "Outros"** | Coloca o método **Outros** no ecrã de pagamento. Com ele regista pagamentos com uma descrição própria, por exemplo um cheque ou uma troca. Desativado por predefinição. |
| **Predefinição: lembrete de transferência bancária manual** | Ativa por predefinição a opção do lembrete sobre a referência estruturada quando regista uma transferência bancária manual. Pode ainda ativar ou desativar a opção em cada pagamento. Desativado por predefinição. |
| **Máximo em numerário** | Um montante em euros inteiros. Predefinição 2999. |
| **Endereço de remetente do e-mail** | O endereço com que o Tillor envia notificações por e-mail. |

## Máximo em numerário [#maximumbedrag-contant]

Com **Máximo em numerário** define o valor máximo de um único pagamento em numerário. Por predefinição são 2999 euros. O Tillor verifica-o em cada pagamento em numerário, mesmo que chegue através de uma ligação. Se o montante for superior, registe-o em partes ou escolha outro método. Veja [Numerário e transferência](/betalingsverwerking/contant).

## Endereço de remetente das notificações [#afzenderadres-van-meldingen]

Se deixar o **Endereço de remetente do e-mail** vazio, o remetente das notificações é o nome da sua organização, com um endereço do Tillor. Se indicar um endereço de e-mail válido, por exemplo `meldingen@recreatiepark-het-meer.be`, o Tillor usa esse endereço, com o nome da sua organização como nome do remetente. Indique apenas o endereço, sem nome. Um endereço inválido não é guardado.

## Guardar alterações [#wijzigingen-opslaan]

Clique em **Guardar definições** no fim. Com **Cancelar** repõe o formulário nos valores guardados.

## Ver também [#zie-ook]

<Cards>
  <Card title="Numerário e transferência" href="/betalingsverwerking/contant" description="Registar pagamentos que chegaram fora do Tillor" />
  <Card title="Registar pagamentos numa fatura" href="/facturen/betalingen-registreren" description="Métodos de pagamento e campos no ecrã de pagamento" />
  <Card title="Definições de faturação" href="/gebruikers/instellingen-facturatie" description="Prazo de vencimento, IVA e PDF" />
</Cards>


# Definições de faturação (/pt-PT/gebruikers/instellingen-facturatie)

Em <UIPath>Apoio > Definições > Faturação</UIPath> define as predefinições das faturas e do PDF que envia aos clientes. As definições aplicam-se a toda a sua organização.

<Requires permission="Editar definições" />

<DocScreenshot src="/screenshots/instellingen/settings-invoicing.png" alt="Definições > Faturação" />

## O que aparece no PDF da fatura [#wat-staat-er-op-de-factuur-pdf]

| Definição | O que faz |
|---|---|
| **Condições gerais no PDF da fatura** | O PDF recebe, em cada página, um verso com as condições gerais. No rodapé há uma referência a elas. O texto das condições é fixo e indica o nome jurídico da sua organização. Desativado por predefinição. |
| **Tabela de discriminação de IVA no PDF da fatura** | Junto aos totais aparece uma tabela com a base tributável e o valor do IVA por taxa de IVA. Desativado por predefinição. |
| **Linhas por página do PDF da fatura** | O número máximo de linhas numa página. Se houver mais linhas, segue-se uma nova página. Predefinição 20, mínimo 1. |

## Prazo de pagamento [#betaaltermijn]

Em **Vencimento predefinido (dias)** indica o número de dias entre a data da fatura e a data de vencimento. Aplica-se às faturas nas quais não escolheu você uma data de vencimento. A predefinição é 7 dias. Pode indicar 0, e a fatura vence no dia em que é lançada. Veja [Lançar uma fatura](/facturen/boeken).

## Escolher taxas de IVA [#btw-tarieven-kiezen]

Em **Taxas de IVA permitidas** estão as taxas que pode escolher na lista de IVA das faturas em rascunho. Por predefinição são 0%, 6%, 9%, 12% e 21%.

1. Escreva uma percentagem entre 0 e 100 no campo por baixo da lista. Pode usar vírgula ou ponto.
2. Clique em **Adicionar taxa**.
3. Retire uma taxa com a cruz junto da percentagem.
4. Clique em **Guardar definições**.

A lista fica sempre ordenada do mais baixo para o mais alto. Uma taxa que já está na lista não se adiciona duas vezes. Se uma linha de fatura existente tiver uma taxa que depois retire da lista, essa taxa mantém-se nessa linha.

Esta lista só aparece se **Lista de taxa de IVA nas linhas da fatura em rascunho** estiver ativada. Nesse caso, uma fatura em rascunho tem uma coluna de IVA em que escolhe uma taxa por linha. Se escolher um produto, a taxa desse produto mantém-se como valor inicial. Veja [IVA](/boekhouden/belasting) e [Criar e editar faturas](/facturen/aanmaken-en-bewerken).

## Faturas automáticas de consumo [#automatische-facturen-voor-verbruik]

Em **Montante mínimo para faturas de utilidades automáticas** indica um montante em euros. Para clientes com faturação automática de utilidades, o Tillor só cria uma fatura quando o montante em aberto atinge este valor. Se deixar o campo vazio (**Sem mínimo**), é faturado qualquer montante em aberto.

Se um cliente tiver um mínimo próprio no perfil do cliente, esse mínimo aplica-se a esse cliente em vez desta definição. Veja [Gestão de contadores](/meterbeheer).

## Guardar alterações [#wijzigingen-opslaan]

Clique em **Guardar definições** no fim. Com **Cancelar** repõe o formulário nos valores guardados. Se só tiver a permissão **Ver definições**, os campos ficam a cinzento.

## Ver também [#zie-ook]

<Cards>
  <Card title="Lançar uma fatura" href="/facturen/boeken" description="Data da fatura e data de vencimento" />
  <Card title="IVA" href="/boekhouden/belasting" description="Taxas de IVA e IVA nas faturas" />
  <Card title="Definições de pagamentos" href="/gebruikers/instellingen-betalingen" description="Numerário, Outros e endereço de remetente" />
</Cards>


# Configurar períodos de renda (/pt-PT/gebruikers/instellingen-huurperiodes)

Numa ocupação escolhe uma **Frequência da renda**. As opções que aí vê definem-se em <UIPath>Apoio > Definições > Períodos de renda</UIPath>. Cada período que adicionar aqui passa a ser uma opção da lista.

<Requires permission="Editar definições" />

<DocScreenshot src="/screenshots/instellingen/settings-occupation.png" alt="Definições > Períodos de renda com um novo período" />

## Adicionar um período [#een-periode-toevoegen]

<Steps>
<Step>
### Adicione um período [#voeg-een-periode-toe]
Abra **Períodos de renda** e clique em **Adicionar período**. Aparece um bloco com os valores iniciais: janeiro, 12 meses.
</Step>
<Step>
### Preencha o período [#vul-de-periode-in]
Escolha o **Mês de início** e indique em **Duração (meses)** um número de 1 a 12. Um período de 12 meses que começa em janeiro é um ano civil. Um período de 1 mês é uma renda mensal. Em **Etiqueta** pode pôr um nome próprio, por exemplo Anual.
</Step>
<Step>
### Escolha como arredondar [#kies-hoe-je-afrondt]
A opção **Arredondar datas de início para o período seguinte** vem ativada por predefinição. O que faz está em [Arredondar para o período seguinte](#afronden-naar-de-volgende-periode).
</Step>
<Step>
### Guarde [#sla-op]
Clique em **Guardar definições**. Com **Remover período** retira um período. Com **Cancelar** repõe o formulário na lista guardada.
</Step>
</Steps>

Se ainda não adicionou períodos, aparece **Sem períodos de renda configurados**. No formulário de uma ocupação não pode então escolher uma frequência da renda.

## Onde voltar a ver os períodos [#waar-zie-je-de-periodes-terug]

No formulário de uma ocupação, a lista está em **Frequência da renda**, com **Sem frequência** no topo. Um período de 1 mês chama-se aí **Mensal**. Um período de 12 meses aparece como **Ano (jan - dez)**, com o primeiro e o último mês do seu período. Outras durações aparecem como **6 meses (abr - set)**. Se indicou uma **Etiqueta** num período, essa etiqueta aparece em vez desse texto, na lista e na coluna **Frequência da renda** das ocupações.

Se retirar um período das definições, as ocupações já criadas com ele mantêm a sua frequência da renda.

## Arredondar para o período seguinte [#afronden-naar-de-volgende-periode]

A opção determina o estado inicial de **Arredondar para o limite do período seguinte** na linha de fatura com que prolonga uma ocupação. Na linha de fatura pode sempre ativar ou desativar a opção por si.

- Se a opção estiver ativada, a linha termina no limite do período seguinte. Se começar a meio de um período, a primeira parte é calculada proporcionalmente. Depois, o cliente segue o mesmo ciclo que os outros arrendatários.
- Se a opção estiver desativada, a linha dura exatamente um período a partir da data de início.

Veja [Criar e editar faturas](/facturen/aanmaken-en-bewerken) e [Ocupações](/bezettingen).

## Ver também [#zie-ook]

<Cards>
  <Card title="Ocupações" href="/bezettingen" description="Associar um cliente a um lote a longo prazo" />
  <Card title="Criar e editar faturas" href="/facturen/aanmaken-en-bewerken" description="Arredondar para o limite do período seguinte numa linha de fatura" />
</Cards>


# Definições de controlo de acesso (/pt-PT/gebruikers/instellingen-toegangscontrole)

Em <UIPath>Apoio > Definições > Controlo de acesso</UIPath> define o comportamento das cancelas para matrículas cujo período de acesso expirou.

<Requires permission="Editar definições" />

<DocScreenshot src="/screenshots/instellingen/settings-access-control.png" alt="Definições > Controlo de acesso" />

## Permitir a saída de matrículas expiradas [#verlopen-kentekens-laten-uitrijden]

Um visitante com uma matrícula cujo período de acesso expirou deixaria de passar pela cancela de saída. Com **Permitir a saída de matrículas expiradas**, a cancela de saída abre na mesma, durante um período de tolerância após a expiração. Isto só funciona fora do horário de funcionamento. Se a receção estiver aberta, o pessoal trata do veículo ao balcão.

A opção vem ativada por predefinição. Se a desativar, a cancela de saída fica fechada para uma matrícula expirada.

| Definição | O que faz |
|---|---|
| **Permitir a saída de matrículas expiradas** | Ativa ou desativa o período de tolerância. |
| **Período de tolerância de saída (dias)** | O número de dias após a expiração em que um veículo ainda pode sair fora do horário de funcionamento. Predefinição 2, no máximo 30. Com 0 não há tolerância. |

A tolerância só se aplica a matrículas numa saída. Uma matrícula bloqueada ou inativa nunca recebe tolerância. Para outros métodos de acesso, como etiquetas NFC ou códigos QR, a tolerância não existe.

O horário de funcionamento vem de <UIPath>Apoio > Definições > Horário de funcionamento</UIPath>. Veja [Horário de funcionamento](/gebruikers/organisaties#openingsuren).

## Guardar alterações [#wijzigingen-opslaan]

Clique em **Guardar definições** no fim. Com **Cancelar** repõe o formulário nos valores guardados.

## Ver também [#zie-ook]

<Cards>
  <Card title="Controlo de acesso" href="/toegangscontrole" description="Pontos de acesso, veículos e registo" />
  <Card title="Organização" href="/gebruikers/organisaties" description="Horário de funcionamento e outras definições" />
</Cards>


# Grupos do Microsoft Entra (/pt-PT/gebruikers/microsoft-entra)

Com o aprovisionamento, o Microsoft Entra ID envia os seus utilizadores e grupos para o Tillor. Se associar um grupo do Entra a um [grupo](/gebruikers/groepen) do Tillor, os membros desse grupo seguem o Entra: quem adicionar no Entra recebe as tarefas e vistas do grupo, e quem retirar ou desativar perde-as. Ninguém precisa de iniciar sessão de novo para isso.

O Entra usa para isso o protocolo SCIM. O Tillor não lê nada por si do seu inquilino Microsoft: é o Entra que decide que utilizadores e grupos envia. Só durante [Configuração rápida](#snel-instellen) é que o seu navegador fala com a Microsoft para criar a aplicação por si.

## O que acontece e o que não acontece [#wat-er-wel-en-niet-gebeurt]

- **Só membros existentes.** O Entra não cria contas Tillor. Alguém que ainda não seja membro da sua organização não conta enquanto não o [convidar](/gebruikers/organisaties). Assim que passa a ser membro, entra logo nos seus grupos associados
- **Sem dados de não membros.** De pessoas sem conta Tillor, o Tillor não guarda nome nem endereço de e-mail, apenas um código ilegível com que as reconhece se mais tarde se tornarem membros
- **Nada sem associação.** Um grupo do Entra só altera algo no Tillor quando o associa a um grupo do Tillor em **Grupos do Entra não ligados**
- **Um para um.** Um grupo do Tillor pertence, no máximo, a um grupo do Entra
- **O nome continua a ser do Tillor.** Se mudar o nome ao grupo no Entra, vê o novo nome a seguir a **Entra ·**, mas o grupo do Tillor mantém o seu próprio nome
- **Grupos aninhados** não são expandidos. Um grupo que é membro de outro grupo não conta como membro. Se quiser também essas pessoas, atribua o grupo aninhado em separado no Entra e associe-o ao mesmo grupo do Tillor ou a outro
- **O início de sessão não muda.** As pessoas iniciam sessão normalmente com a Microsoft, veja [Início de sessão](/inloggen)

## Antes de começar [#voordat-je-begint]

Precisa de:

- No Tillor, a permissão **Editar definições**
- No Microsoft Entra, a função **Cloud Application Administrator** ou **Application Administrator** (ou superior)
- Uma licença do Entra que permita aprovisionamento automático para aplicações próprias (Microsoft Entra ID P1 ou superior)

Certifique-se de que os seus colegas têm no Tillor a mesma conta Microsoft ou o mesmo endereço de e-mail que no Entra. Assim o Tillor reconhece quem é quem, veja [Como o Tillor reconhece as pessoas](#hoe-tillor-mensen-herkent).

## Configuração rápida [#snel-instellen]

Se você próprio for administrador do Entra, o Tillor deixa a associação pronta de uma só vez.

1. Vá a **Apoio > Definições** e escolha **Grupos**
2. Em **Microsoft Entra** clique em **Configurar com a Microsoft** e depois em **Iniciar sessão na Microsoft**
3. Na janela da Microsoft, inicie sessão com a sua conta de administrador e dê a autorização. A Microsoft pede para poder gerir aplicações e aprovisionamento e ler os seus grupos

O Tillor cria então a aplicação no Entra, preenche o URL do inquilino e o token, faz com que os utilizadores sejam reconhecidos pela sua conta Microsoft e faz com que o Entra envie o tipo de cada grupo. Depois inicia-se a sincronização e o Tillor envia logo você e todos os seus grupos, para que não tenha de esperar pela primeira sincronização. Por fim, o Tillor lê, por grupo, o tipo e se existe uma equipa associada. Vê cada passo a ser assinalado. O Tillor faz isto em segundo plano: pode fechar a janela ou até a página. Se mais tarde clicar de novo em **Configurar com a Microsoft**, vê em que ponto está, ou, até uma hora depois de terminar, se correu bem ou mal. Depois pode recomeçar com **Configurar de novo**.

O Entra envia assim todos os seus utilizadores e grupos. Não tem de escolher nada antes: os grupos ficam em **Grupos do Entra não ligados** e não alteram nada até os associar. Continue para isso em [Associar grupos no Tillor](#groepen-koppelen-in-tillor). Os membros dos grupos seguem com a primeira sincronização. Demora alguns minutos, em organizações grandes algumas horas.

<Callout type="info">
O Tillor usa o acesso apenas para esta configuração. Vai encriptado para a tarefa em segundo plano e depois não é guardado em lado nenhum; a Microsoft deixa-o expirar por si passada cerca de uma hora. Se percorrer **Configurar com a Microsoft** de novo, o Tillor volta a encontrar a mesma aplicação e não cria uma segunda.
</Callout>

<Callout type="warn">
A configuração rápida cria um novo token. Um token que tenha colado antes à mão no Entra deixa de funcionar. Se a configuração parar a meio, clique em **Tentar novamente**.
</Callout>

Se não conseguir iniciar sessão, por exemplo porque a sua organização bloqueia a autorização de aplicações, ou se quiser que o Entra envie apenas determinados grupos, configure a associação à mão como abaixo.

## Configuração manual [#handmatig-instellen]

<Steps>
<Step>

### Criar um token no Tillor [#token-maken-in-tillor]

1. Vá a **Apoio > Definições** e escolha **Grupos**
2. No topo está **Microsoft Entra**. Se a associação já estiver configurada, clique em **Ligação**
3. Copie o **URL do inquilino**. Tem este aspeto: `https://…/api/orgs/<organisatie>/scim/v2`
4. Clique em **Gerar token** e copie o token que aparece

<Callout type="warn">
O token só é mostrado uma vez. Cole-o logo no Entra. Se o perder, clique em **Substituir token** e use o novo token.
</Callout>

</Step>
<Step>

### Criar uma aplicação no Entra [#een-app-maken-in-entra]

1. Abra o [centro de administração do Microsoft Entra](https://entra.microsoft.com)
2. Vá a **Identity > Applications > Enterprise applications** e clique em **New application**
3. Clique em **Create your own application**
4. Dê um nome à aplicação, por exemplo **Tillor**, escolha **Integrate any other application you don't find in the gallery (Non-gallery)** e clique em **Create**

Se já tiver uma enterprise application para o Tillor, também a pode usar.

</Step>
<Step>

### Associar o aprovisionamento [#provisioning-koppelen]

1. Na aplicação, abra **Provisioning** e clique em **Get started** (ou **New configuration**)
2. Defina **Provisioning Mode** como **Automatic**
3. Em **Admin Credentials** preencha:
   - **Tenant URL**: o URL do inquilino do Tillor
   - **Secret Token**: o token do Tillor
4. Clique em **Test Connection**. O Entra deve indicar que a ligação foi bem-sucedida
5. Clique em **Save**

</Step>
<Step>

### Verificar os atributos [#attributen-controleren]

Em **Mappings** abra a regra **Provision Microsoft Entra ID Users**:

- Defina **externalId** como **objectId** (por predefinição está **mailNickname**). Assim o Tillor reconhece alguém pela sua conta Microsoft, mesmo que o endereço de e-mail seja diferente
- Deixe **userName** (← **userPrincipalName**), **active** e **emails[type eq "work"].value** (← **mail**) como estão

Deixe **Provision Microsoft Entra ID Groups** ativado. As predefinições (**displayName**, **externalId** ← **objectId**, **members**) estão corretas.

Se quiser ver no Tillor que tipo de grupo é, adicione estes atributos aos grupos. Em **Show advanced options** escolha primeiro **Edit attribute list for customappsso** e adicione os atributos de destino, depois **Add New Mapping** por linha:

| Origem no Entra | Atributo de destino | Tipo |
|---|---|---|
| Expressão `Join(",", [groupTypes])` | `urn:ietf:params:scim:schemas:extension:tillor:2.0:Group:groupTypes` | String |
| **securityEnabled** | `urn:ietf:params:scim:schemas:extension:tillor:2.0:Group:securityEnabled` | Boolean |
| **mailEnabled** | `urn:ietf:params:scim:schemas:extension:tillor:2.0:Group:mailEnabled` | Boolean |
| **onPremisesSyncEnabled** | `urn:ietf:params:scim:schemas:extension:tillor:2.0:Group:onPremisesSyncEnabled` | Boolean |
| **mail** | `urn:ietf:params:scim:schemas:extension:tillor:2.0:Group:mail` | String |
| **description** | `urn:ietf:params:scim:schemas:extension:tillor:2.0:Group:description` | String |

Se faltar uma origem na lista do Entra, salte essa linha. O Entra não consegue enviar assim se existe uma equipa associada a um grupo; isso o Tillor só vê através de **Configurar com a Microsoft**.

Pode deixar outros atributos como estão. O Tillor não os guarda.

</Step>
<Step>

### Atribuir grupos [#groepen-toewijzen]

1. Na aplicação, abra **Users and groups** e clique em **Add user/group**
2. Escolha os grupos que o Tillor deve receber, por exemplo **Receção**, e clique em **Assign**
3. Verifique em **Provisioning > Settings** que **Scope** está em **Sync only assigned users and groups**

O Entra envia um grupo juntamente com os seus membros. Não tem de atribuir os membros em separado.

</Step>
<Step>

### Iniciar o aprovisionamento [#provisioning-starten]

Em **Provisioning** defina **Provisioning Status** como **On** e clique em **Save**.

A primeira ronda pode demorar um pouco, consoante o número de utilizadores. Depois, o Entra envia as alterações cerca de 40 em 40 minutos. Se quiser atualizar uma pessoa de imediato, use **Provision on demand** no Entra.

</Step>
<Step>

### Associar grupos no Tillor [#groepen-koppelen-in-tillor]

Atualize **Definições > Grupos**. No topo está a linha **Microsoft Entra** com a última sincronização e quantos grupos estão associados. Por baixo dos seus grupos do Tillor está **Grupos do Entra não ligados**, com os grupos enviados que ainda não fazem nada. Clique em **Mostrar** se a lista estiver fechada e use o campo de pesquisa para encontrar um grupo. Para cada grupo, escolha em **Ligar a…** o que deve acontecer e depois clique em **Guardar**. Com **Reverter** deita fora as suas escolhas. Um grupo do Tillor só pode estar ligado a um grupo do Entra; os grupos que já estão associados não os pode escolher outra vez.

| Escolha | O que acontece |
|---|---|
| **Criar novo** | O Tillor cria um grupo com o nome vindo do Entra e preenche-o com os membros reconhecidos |
| Um grupo existente | Os membros desse grupo são substituídos pelos membros reconhecidos do Entra. Se o Entra ainda não tiver enviado os membros desse grupo, os membros atuais mantêm-se até a sincronização os entregar |

A partir daí, o Entra atualiza os membros em cada sincronização. O grupo associado desaparece da lista e, nos seus grupos do Tillor, aparece por baixo do grupo **Entra · [nome]** com o tipo de grupo.

A associação só se faz a partir de **Grupos do Entra não ligados**. Um grupo do Tillor que gere à mão, como TI, não o associa a partir do próprio grupo.

A seguir a cada nome de grupo aparece o tipo de grupo que é no Entra. Com os botões acima da lista mostra apenas um tipo.

| Etiqueta | O que é |
|---|---|
| **Segurança** | Um grupo de segurança normal, muitas vezes o grupo que quer associar |
| **Segurança com email** | Um grupo de segurança com endereço de e-mail próprio |
| **Lista de distribuição** | Apenas uma lista de e-mail |
| **Microsoft 365** | Um grupo com uma caixa de correio partilhada e um site do SharePoint, por vezes com uma equipa |
| **Windows Server AD** | Vem do seu Active Directory local (híbrido) e é gerido aí |
| **Dinâmico** | O Entra determina os membros por si com uma regra |
| **Teams** | Existe uma equipa associada |
| **Tipo desconhecido** | O Tillor ainda não sabe o tipo. Percorra de novo **Configurar com a Microsoft** |

Os grupos de site do SharePoint, como **Proprietários**, **Membros** e **Visitantes** de um site, não são grupos do Entra. Esses nunca chegam ao Tillor. O que vê é o grupo do Microsoft 365 por trás do site.

</Step>
</Steps>

## Como o Tillor reconhece as pessoas [#hoe-tillor-mensen-herkent]

Para cada utilizador que o Entra envia, o Tillor procura um membro existente da sua organização:

1. Primeiro pela **conta Microsoft** com que essa pessoa inicia sessão no Tillor (o ID de objeto do Entra, se definir **externalId** como **objectId**)
2. Caso contrário, pelo **endereço de e-mail**: o endereço de trabalho do Entra, ou o **userPrincipalName** se for um endereço de e-mail

Se o Tillor não encontrar ninguém, ou se o utilizador estiver desativado no Entra, não conta no grupo. Assim que a pessoa passa a ser membro da organização, conta logo. Se voltar a ativá-lo no Entra, conta na sincronização seguinte.

## O que acontece com alterações no Entra [#wat-er-gebeurt-bij-wijzigingen-in-entra]

| No Entra | No Tillor |
|---|---|
| Membro adicionado a um grupo associado | Entra no grupo do Tillor (se for membro da organização) |
| Membro retirado do grupo | Sai do grupo do Tillor |
| Utilizador desativado (**Account enabled** desligado) | Sai de todos os grupos do Tillor associados. A sua conta Tillor continua a existir |
| Utilizador ou grupo deixa de estar atribuído à aplicação | O Entra envia uma desativação ou eliminação, com o mesmo efeito |
| Grupo eliminado | Por baixo do grupo do Tillor aparece **Removido no Entra. Os membros foram mantidos.** O grupo do Tillor continua a existir com os seus últimos membros e deixa de ser atualizado |

Retirar alguém por completo da sua organização faz-se no Tillor, em [Organização](/gebruikers/organisaties). O Entra gere apenas os membros dos grupos.

## O que vê no registo de atividade [#wat-je-terugziet-in-het-activiteitenlog]

No [registo de atividade](/activiteitenlog) vê:

- Cada alteração aos membros de um grupo do Tillor que o Entra efetua, com quem entrou ou saiu. Aparece em nome do sistema, não de um utilizador
- Cada ronda de sincronização do Entra, uma linha por ronda. Uma ronda em que o Entra não envia nada não aparece
- Quem associou ou desassociou um grupo do Entra a um grupo do Tillor, e quem substituiu o token

## Alterar ou parar a associação [#koppeling-wijzigen-of-stoppen]

- **Desassociar**: no grupo do Tillor, clique em **Desligar**. O grupo do Tillor fica como está e volta a geri-lo à mão. O grupo do Entra volta a aparecer em **Grupos do Entra não ligados**
- **Outro grupo do Tillor**: desligue e depois associe o grupo do Entra, em **Grupos do Entra não ligados**, a outro grupo. O grupo anterior mantém os seus membros, mas deixa de ser atualizado
- **Parar por completo**: no Entra, defina **Provisioning Status** como **Off**, ou elimine a enterprise application

## Substituir o token [#token-vervangen]

Na linha **Microsoft Entra** clique em **Ligação** e depois em **Substituir token** se o token foi divulgado ou se precisar dele de novo. O token antigo deixa logo de funcionar. Cole o novo token no Entra em **Provisioning > Admin Credentials > Secret Token** e clique em **Save**. Até o fazer, a sincronização falha no Entra.

## Resolver problemas [#problemen-oplossen]

**Configurar com a Microsoft pára num passo**

No passo aparece a mensagem da Microsoft. Normalmente falta à sua conta a função de administrador ou a autorização. Verifique as funções em [Antes de começar](#voordat-je-begint) e clique em **Tentar novamente**. O Tillor reutiliza a aplicação e o aprovisionamento que já tinham sido criados.

**Test Connection falha**

Verifique se o URL do inquilino foi copiado por inteiro, incluindo `/scim/v2`, e se o token é o último gerado. Depois de **Substituir token**, um token antigo deixa de funcionar.

**Um grupo não está na lista**

Espere que a primeira sincronização termine e atualize a página. Se configurou a associação à mão, o Entra só envia grupos atribuídos à aplicação: verifique **Users and groups** na aplicação e aguarde a ronda seguinte, ou use **Provision on demand**.

**Alguém falta no grupo do Tillor**

- Essa pessoa é membro da sua organização no Tillor? O Entra não cria contas
- O endereço de e-mail no Entra coincide com o do Tillor? Caso contrário, defina **externalId** como **objectId**, para que o Tillor o reconheça pela sua conta Microsoft. Isso só funciona se já tiver iniciado sessão no Tillor com a Microsoft
- O utilizador está ativo no Entra?
- É membro direto do grupo, e não através de um grupo aninhado?

**A minha alteração manual desaparece**

Num grupo associado, o Entra é a fonte. Ajuste os membros no Entra, ou desassocie o grupo.

**Mais detalhes sobre uma ronda falhada**

No Entra, abra **Provisioning > Provisioning logs**. Aí vê, por utilizador e grupo, o que o Entra tentou e que resposta o Tillor deu.

## Ver também [#zie-ook]

<Cards>
  <Card title="Grupos" href="/gebruikers/groepen" description="Criar e usar grupos" />
  <Card title="Vistas" href="/taken/weergaven" description="Partilhar uma vista de tarefas com um grupo" />
  <Card title="Início de sessão" href="/inloggen" description="Iniciar sessão com a Microsoft" />
</Cards>


# Organização (/pt-PT/gebruikers/organisaties)

Na página **Definições** (em baixo no menu principal, <UIPath>Apoio > Definições</UIPath>) gere as definições da sua organização. À esquerda alterna entre as secções. As secções que vê dependem das suas permissões.

| Secção | Para quê |
|---|---|
| **Geral** | Perfil da organização, fuso horário, país predefinido e cores da imagem de marca. Veja [Geral](#algemeen) |
| **Horário de funcionamento** | Horário semanal, épocas, exceções e feriados. Veja [Horário de funcionamento](#openingsuren) |
| **Faturação** | PDF, prazo de vencimento e taxas de IVA. Veja [Definições de faturação](/gebruikers/instellingen-facturatie) |
| **Impressão** | Impressoras e momentos de impressão. Veja [Impressão](#afdrukken) |
| **Pagamentos** | Método de pagamento Outros e endereço de remetente. Veja [Definições de pagamentos](/gebruikers/instellingen-betalingen) |
| **Períodos de renda** | Frequências de renda para ocupações. Veja [Configurar períodos de renda](/gebruikers/instellingen-huurperiodes) |
| **Tarifa do lote** | A fórmula da tarifa calculada. Veja [Fórmula da tarifa](/terreinen#tariefformule) |
| **Controlo de acesso** | Saída com matrícula expirada. Veja [Definições de controlo de acesso](/gebruikers/instellingen-toegangscontrole) |
| **Mapa** | Centro e orientação do mapa. Veja [Definir o mapa predefinido](/kaart#kaartstandaard-instellen) |
| **Tipos de parcela** | Tipos de lotes. Veja [Tipos de parcela](/terreinen#terreintypes) |
| **Etiquetas de tarefas** | Etiquetas para tarefas. Veja [Etiquetas](/taken/labels) |
| **Grupos** | Agrupar colegas. Veja [Grupos](/gebruikers/groepen) |
| **Campos personalizados** | Campos extra em clientes, lotes e mais. Veja [Campos personalizados](/eigen-velden) |
| **Apple Wallet** | Fundo do passe e ponto de acesso. Veja [Apple Wallet](#apple-wallet) |
| **Tablets e quiosques** | Tablets e quiosques. Veja [Tablets e quiosques](/mobiele-app/tablets-en-kiosken) |
| **Integrações** | Ligações com outros serviços. Veja [Integrações](#integraties) |
| **Utilizadores** | Membros, convites e permissões. Veja [Gerir permissões de utilizadores](#gebruikersrechten-beheren) |

<Callout type="info" title="Bom saber">
- As secções que vê dependem das suas permissões. Guarde as alterações em baixo com **Guardar definições**
- Cerca de uma semana antes de um feriado legal, o Tillor envia um e-mail para o endereço de suporte se o horário de funcionamento desse dia ainda estiver vazio
- Depois de guardar as definições da wallet, o Tillor reenvia todos os passes de wallet ativos. Os visitantes veem-no normalmente depois de abrirem o passe
- Assim que a sua organização tiver faturas ou pagamentos, a moeda já não pode ser alterada
</Callout>

<Callout type="info">
Os dados da empresa nas faturas (nome, morada, número de IVA, IBAN, logótipo) são definidos durante a integração inicial. Contacte o suporte do Tillor se os quiser alterar.
</Callout>

## Integrações [#integraties]

Escolha **Integrações** para ver as ligações disponíveis, como telefonia Voys, contas bancárias, Mollie ou software de contabilidade (por exemplo Admisol). Em **Integrações**, no menu da esquerda, estão categorias (comunicação, pagamentos, contabilidade, contadores). Clique numa integração da lista para abrir a página de detalhe. Aí instala a ligação ou ajusta as definições (sem janela de diálogo à parte). Veja também a [visão geral das integrações](/integraties).

<DocScreenshot src="/screenshots/communicatie/providers/marketplace-overview.png" alt="Definições - visão geral das integrações" />

## Geral [#algemeen]

Em **Geral** define o perfil da organização, o fuso horário, o país predefinido e as cores da imagem de marca. Precisa da permissão **Editar definições** para guardar alterações.

## Horário de funcionamento [#openingsuren]

Em **Horário de funcionamento** edita um horário semanal. Com as opções coloridas alterna para **períodos de época** (por exemplo 1 de julho a 31 de agosto) ou uma **exceção** (uma data ou um período como 24 a 26 de dezembro). Os **feriados legais** dos próximos 12 meses já lá estão: escolha um feriado e preencha as horas (ou deixe-as vazias se estiver encerrado nesse dia). Deixe um dia da semana vazio se estiver encerrado nesse dia. A IA da caixa de entrada usa estas horas como horário do escritório. Cerca de uma semana antes de um feriado legal, o Tillor envia um e-mail de lembrete para o **endereço de suporte** da organização (ou para o endereço de e-mail geral, se não houver endereço de suporte) quando as horas desse feriado ainda não estão preenchidas. Se usar o Partoo, o horário de funcionamento é sincronizado automaticamente. Veja [Partoo](/integraties/partoo). Um site pode obter as horas resolvidas (incluindo etiquetas de época como Verão ou Inverno) e os próximos feriados através da [API de horário de funcionamento](/ontwikkelaars/voorbeelden/opening-hours).

## Impressão [#afdrukken]

Em **Impressão** define as impressões em PDF, os endereços IP das impressoras e o **horário dos momentos de impressão**. Adicione, por dia da semana, uma ou mais horas (ou deixe o dia vazio). Os pagamentos online, por mandato e por transferência esperam pelo momento seguinte desse dia antes de a fatura ir para a fila da impressora.

## Apple Wallet [#apple-wallet]

Em **Apple Wallet** define duas coisas lado a lado: à esquerda o **fundo do passe**, à direita a **localização do ponto de acesso**.

**Fundo do passe** (esquerda): fotografia opcional em ecrã inteiro para o layout Poster Generic em iPhone com **iOS 27**. Carregue JPEG, PNG ou WebP; os ficheiros grandes são reduzidos automaticamente. Arraste na pré-visualização para escolher que parte da fotografia fica visível atrás do código QR. A pré-visualização mostra logo a sua escolha; só depois de **Guardar** em baixo em **Definições** é que a fotografia (ou a remoção) entra em vigor e o Tillor envia o foco para os passes de acesso.

Em iPhone com **iOS 26 ou anterior**, o passe usa o layout generic clássico com os mesmos dados (estado, nome do visitante, validade, código QR). Sem imagem própria, todos os passes recebem o fundo em degradê Tillor predefinido. Com uma fotografia própria, no topo está o **logótipo da organização** dos dados da sua empresa, a cores sobre a fotografia. No degradê predefinido, o logótipo é branco sobre o degradê escuro.

Nos passes Poster Generic (iOS 27), o código QR é **quadrado**; em dispositivos mais antigos é retangular, como num passe generic clássico.

**Localização do ponto de acesso** (direita): clique no mapa ou arraste o pino para definir o ponto GPS do ponto de acesso principal. A **Apple Wallet** e a **Google Wallet** usam essa localização no passe de acesso. No iPhone, o iOS pode sugerir o passe no ecrã de bloqueio quando um visitante está por perto. Escolha **Usar o centro do mapa do parque** para remover o pino e usar o centro do mapa do parque.

Depois de guardar as **Definições**, o Tillor atualiza todos os passes de wallet ativos da organização (a Apple através de push silencioso, a Google através de sincronização de objetos). Os hóspedes veem a atualização normalmente depois de abrirem o passe na Wallet; por vezes ainda é necessário um refrescamento manual na aplicação Wallet. A pré-visualização no Tillor mostra o mesmo recorte que no passe: arraste a imagem para que o ponto central fique no sítio pretendido.

<DocScreenshot src="/screenshots/gebruikers/settings-wallet-barrier-map.png" alt="Definições > Apple Wallet com fundo do passe e ponto de acesso no mapa" />

No verso do passe de wallet constam o número de telefone e o endereço de e-mail da organização (o e-mail de suporte, se estiver definido, caso contrário o endereço geral). Em passes bloqueados, expirados ou revogados, esses dados também aparecem atrás do texto da receção no ecrã de bloqueio (Apple) ou na Google Wallet.

<DocScreenshot src="/screenshots/gebruikers/settings-dialog.png" alt="Definições > Geral" />

## Gerir permissões de utilizadores [#gebruikersrechten-beheren]

Em **Utilizadores** vê os **Membros** da sua organização e os **Convites pendentes**. Como convidar e remover colegas e configurar as suas notificações está em [Convidar utilizadores e atribuir permissões](/gebruikers/gebruikers-en-rechten).

### Editar permissões [#rechten-bewerken]

Junto de um utilizador, clique em **Editar permissões**. Toda a explicação, também sobre grupos e permissões bloqueadas, está em [Editar permissões](/gebruikers/gebruikers-en-rechten#rechten-bewerken). Abaixo estão as permissões que costumam levantar perguntas.

### Contas bancárias [#bankrekeningen]

| Permissão | O que pode o utilizador fazer? |
|---|---|
| **Ver transações bancárias** | Página **Administração > Transações bancárias** e o bloco **Transações da conta bancária** em **Administração > Relatórios de pagamento** |
| **Sincronizar transações bancárias** | Botão **Sincronizar conta bancária** (importação manual) |

As permissões estão na janela de permissões, no grupo **Transações bancárias**.

Veja também [Contas bancárias](/boekhouden/betalingsrapporten/betaalmethodes/ponto) para a ligação com open banking.

### Atribuir pagamento [#betaling-koppelen]

| Permissão | O que pode o utilizador fazer? |
|---|---|
| **Atribuir pagamento** | **Atribuir pagamento** numa fatura lançada, **Associar** em grupos de pagamentos e **Atribuir à fatura** em transações bancárias (não visível sem a permissão) |

A permissão está na janela de permissões, no grupo **Pagamentos**.

### Aplicações OAuth [#oauth-apps]

| Permissão | O que pode o utilizador fazer? |
|---|---|
| **Autorizar aplicações OAuth** | Dar autorização a terceiros (por exemplo Cursor, Claude, ChatGPT) através de OAuth, e continuar a usar tokens OAuth existentes |

Os utilizadores existentes mantêm a permissão após a migração. Os novos utilizadores não a recebem automaticamente. Assinale-a na janela de permissões do utilizador. Desative-a para evitar que esse utilizador associe novas aplicações OAuth; os tokens existentes desse utilizador deixam então também de funcionar. Os utilizadores com esta permissão em pelo menos uma organização podem autorizar.

Veja também [MCP](/ontwikkelaars/mcp).

## Acordo de tratamento de dados [#verwerkersovereenkomst]

Se, em vez do Tillor, aparecer um ecrã **Acordo de tratamento de dados necessário**, a sua organização tem de assinar o acordo de tratamento de dados (DPA) em vigor antes de poder continuar. Pode primeiro descarregar o documento com **Descarregar documento do DPA**. Depois solicita um código de verificação. Esse código vai por SMS para o número de telefone da pessoa responsável. Introduza o código e clique em **Aceitar DPA**.

## Dados nas faturas [#gegevens-op-facturen]

Dados da empresa como o nome, a morada, o número de IVA e o IBAN aparecem automaticamente nas faturas. São definidos durante a integração inicial. Contacte o suporte do Tillor para os alterar.

## Ver também [#zie-ook]

<Cards>
  <Card title="Utilizadores" href="/gebruikers" description="Gerir o acesso das contas" />
  <Card title="Grupos" href="/gebruikers/groepen" description="Agrupar colegas, também com permissões de grupo" />
  <Card title="Faturas" href="/facturen" description="Criar e enviar faturas" />
</Cards>


# Prova e validade (/pt-PT/handtekeningen/bewijs-en-geldigheid)

O Tillor regista em cada assinatura quem assinou, quando e como, e sela o PDF para que qualquer alteração posterior fique visível. O resultado é uma assinatura eletrónica simples, adequada para contratos de arrendamento, regras da casa, termos de responsabilidade e condições. Para documentos em que a lei exige uma assinatura mais forte, o Tillor não é o sítio certo.

## O que consta nas páginas de prova? [#wat-staat-er-op-de-bewijspaginas]

O PDF assinado recebe no fim uma ou mais páginas **Prova de assinatura**. Nelas consta:

- o título do documento, o pedido, a sua organização, o número de páginas e quando o pedido foi criado, enviado e concluído
- duas impressões digitais do ficheiro: a do PDF tal como o carregou e a das páginas assinadas antes de as páginas de prova serem acrescentadas. Se mudar um único carácter no ficheiro, a impressão digital deixa de corresponder
- por signatário: nome, função, tipo, e-mail, número de telefone e idioma, quando a ligação foi enviada e quando essa pessoa abriu a página pela primeira vez, a hora da assinatura, o endereço IP e o dispositivo
- como o signatário foi confirmado: com um código de utilização única, para que canal o código foi enviado e quando, ou com sessão iniciada no Tillor, no caso dos colaboradores
- a frase com que o signatário deu o seu acordo, exatamente como estava no ecrã
- o que o signatário preencheu: cada campo de texto, data e caixa de seleção com o seu valor, incluindo os que ficaram vazios
- a assinatura e a rubrica tal como foram desenhadas, e em que páginas estão. Uma assinatura escrita aparece como imagem do nome escrito, tal como uma desenhada
- como se assinou: na página de assinatura através da ligação, no Tillor por um colaborador com sessão iniciada, ou no tablet à receção (com código, ou com a identidade confirmada por um colaborador)
- o **registo de auditoria**: cada passo com hora, quem o fez e a partir de que endereço IP e dispositivo. Por exemplo *Ligação de assinatura enviada*, *Página de assinatura aberta*, *Código de verificação enviado*, *Código errado introduzido*, *Assinado* e *Concluído e selado*

As horas estão no fuso horário da sua organização, com a hora UTC (a hora padrão mundial) ao lado. O Tillor guarda os endereços IP e os dispositivos encriptados. Vê-os no Tillor e nas páginas de prova. As assinaturas e os valores preenchidos estão no documento, nos locais que escolheu. O seu carregamento original fica guardado à parte e nunca muda.

Os mesmos passos aparecem na página do pedido, em **Histórico**, e no cliente, em **Eventos**.

<Callout type="info" title="Para o leitor técnico">
As duas impressões digitais são somas de verificação SHA-256. Uma impressão digital SHA-256 muda por completo assim que um único byte de um ficheiro muda, por isso prova que o ficheiro não foi alterado. Nas páginas de prova consta também a impressão digital do certificado de selo (ver abaixo).
</Callout>

## Selo e carimbo temporal [#zegel-en-tijdstempel]

O PDF assinado é **selado** no último passo com uma assinatura digital da sua organização, criada pelo Tillor. Se o abrir no Adobe Reader ou noutro leitor de PDF, vê um painel de assinaturas. Se depois da selagem algo mudar no ficheiro, o leitor avisa.

O leitor pode indicar o signatário como **desconhecido** ou **não fidedigno**. É normal: o certificado vem do Tillor e não de uma autoridade de certificação paga. Qual é o certificado consta, com a sua impressão digital, nas páginas de prova.

O selo recebe também um **carimbo temporal** de um serviço de carimbo temporal independente e gratuito (FreeTSA, ou DigiCert se este não responder). Isso prova, independentemente do Tillor, quando o ficheiro existia exatamente nesta forma. A hora consta na página do pedido, em **Carimbo temporal**.

## Que tipo de assinatura [#welk-soort-handtekening]

Esta é uma **assinatura eletrónica simples** segundo as regras europeias eIDAS. O Tillor verifica o endereço de e-mail ou o número de telefone com um código, regista o desenho e guarda a prova. Isto adequa-se a contratos de arrendamento, regras da casa, termos de responsabilidade e condições.

Uma assinatura **qualificada**, por exemplo com itsme ou um cartão eID, não é possível. Se tiver um documento para o qual a lei o exige, faça-o assinar fora do Tillor.

## O que acontece à prova? [#wat-gebeurt-er-met-het-bewijs]

- O PDF original e o PDF assinado ficam nos documentos do cliente. Pode arquivá-los, mas não eliminá-los.
- A prova faz parte do PDF assinado. Quem recebeu uma cópia tem, portanto, também as páginas de prova.
- O registo de auditoria permanece na página do pedido, mesmo que o pedido seja recusado, cancelado ou expire.

## Problemas? [#problemen]

<Accordions>
<Accordion title="O meu leitor de PDF diz que a assinatura não é fidedigna">
Está correto e é normal. O selo vem do Tillor, não de uma autoridade de certificação paga. O importante é que o leitor não indique nenhuma alteração depois da selagem. O certificado consta, com a sua impressão digital, nas páginas de prova.
</Accordion>
<Accordion title="O meu leitor de PDF indica que o documento foi alterado depois de assinado">
O ficheiro foi alterado depois da selagem, por exemplo ao guardá-lo de novo ou ao editá-lo. Descarregue novamente o PDF assinado a partir da página de detalhe do pedido ou dos documentos do cliente. Esse ficheiro está inalterado.
</Accordion>
<Accordion title="Um cliente quer uma assinatura qualificada com itsme ou eID">
Isso não é possível no Tillor. Faça esse documento ser assinado fora do Tillor.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Como alguém assina" href="/handtekeningen/ondertekenen" />
  <Card title="Acompanhar um pedido" href="/handtekeningen/opvolgen" />
  <Card title="Todos os conceitos" href="/begrippen" />
</Cards>


# Pedir assinaturas (/pt-PT/handtekeningen/handtekening-vragen)

Com um pedido de assinatura faz assinar online um PDF por uma ou mais pessoas. Cria-o em duas partes: primeiro escolhe o cliente e o PDF, depois define no editor os signatários e os campos. Como acompanhar depois quem já assinou está em [Acompanhar um pedido](/handtekeningen/opvolgen).

<Requires permission="Gerir pedidos de assinatura" />

Antes de começar:

- Precisa da permissão **Gerir pedidos de assinatura**. Se não a tiver, o botão **Pedir assinaturas** fica a cinzento.
- O ficheiro tem de ser um PDF, até 250 MB. O Tillor recusa outro tipo de ficheiro com **Isto não é um PDF. Escolha um ficheiro PDF.**
- Cada signatário precisa de um e-mail ou número de telefone para receber a ligação ou o código. Num cliente ou contacto, preencha-o primeiro nos dados deles.
- Cada signatário precisa de pelo menos um campo de assinatura ou de rubrica.

## Criar um pedido de assinatura [#een-ondertekenverzoek-maken]

<Steps>
<Step>
### Inicie o pedido [#start-het-verzoek]
Escolha onde começa.

<Tabs items={["A partir de Assinaturas", "A partir do cliente"]}>
<Tab value="A partir de Assinaturas">
Vá a <UIPath>Administração > Assinaturas</UIPath> e clique em **Pedir assinaturas**. Escolha o **Cliente**.
</Tab>
<Tab value="A partir do cliente">
Abra o separador **Documentos** do cliente e clique em **Pedir assinaturas**. O cliente já vem preenchido.
</Tab>
</Tabs>

Em **Documento**, escolha um PDF que já esteja nesse cliente, ou deixe **Carregar um novo PDF** e arraste o PDF para a caixa (ou clique em **Escolher PDF**). Preencha um **Título**, por exemplo *Contrato de arrendamento 2027*. Se o deixar vazio, o Tillor usa o nome do documento. Clique depois em **Continuar**.

<DocScreenshot src="/screenshots/handtekeningen/signatures-create-dialog.png" alt="Caixa de diálogo Pedir assinaturas com cliente, título e documento" />

Um PDF carregado fica nos documentos do cliente. O Tillor nunca o altera: as assinaturas vão para uma cópia à parte.
</Step>
<Step>
### Adicione signatários [#voeg-ondertekenaars-toe]
Em **Signatários**, clique em **Adicionar signatário** e escolha:

- **Cliente: [nome]**
- **Contacto do cliente**
- **Colaborador**
- **Parte externa**: preencha **Nome**, **Endereço de e-mail** e/ou **Número de telemóvel** e **Idioma**. É necessário pelo menos um dos dois dados de contacto. Sem e-mail, a pessoa recebe a ligação por SMS.

<DocScreenshot src="/screenshots/handtekeningen/signatures-add-signer-menu.png" alt="Menu Adicionar signatário" />

<DocScreenshot src="/screenshots/handtekeningen/signatures-external-dialog.png" alt="Caixa de diálogo Adicionar parte externa" />

Pode adicionar no máximo 10 signatários. Assinam de cima para baixo, e o seguinte só recebe a ligação quando o anterior tiver assinado. Com **Assinar mais cedo** e **Assinar mais tarde** (as setas) muda a ordem, com o caixote do lixo remove alguém. Na caixa por baixo do nome pode preencher, opcionalmente, uma **Função**, por exemplo *Inquilino* ou *Fiador*.

Cada signatário tem uma cor própria. Essa cor volta a ver-se nos campos dele no documento.
</Step>
<Step>
### Coloque os campos [#plaats-de-velden]
Em **Campos para**, escolha o signatário para quem coloca campos. Escolha depois o tipo de campo e toque ou arraste numa página do documento. Arraste um campo para o mover e arraste o canto para o aumentar ou diminuir.

<DocScreenshot src="/screenshots/handtekeningen/signatures-editor.png" alt="Editor com signatários, Campos para e os tipos de campos" />

| Campo | O que o signatário faz |
| --- | --- |
| **Assinatura** | Coloca a assinatura desenhada ao tocar na caixa |
| **Rubrica** | Coloca a rubrica desenhada ao tocar na caixa |
| **Nome** | Nada: o Tillor preenche o nome do signatário |
| **Data de assinatura** | Nada: o Tillor preenche o dia da assinatura |
| **Texto** | Escreve uma linha, até 200 carateres, por exemplo uma matrícula |
| **Texto longo** | Escreve algumas linhas, até 2.000 carateres, por exemplo uma observação |
| **Caixa de seleção** | Assinala uma condição |
| **Data** | Escolhe uma data, por exemplo um dia de chegada |

Clique num campo colocado para o selecionar. Por baixo dos botões vê então:

- **Signatário**: passa o campo para o nome de outro signatário, sem o voltar a desenhar.
- Em **Texto**, **Texto longo**, **Caixa de seleção** e **Data**, também uma **Pergunta ou etiqueta** (que o signatário vê junto da caixa de preenchimento) e **Obrigatório**. Um campo que não é obrigatório pode ficar vazio.
- A cruz no campo elimina-o.

<DocScreenshot src="/screenshots/handtekeningen/signatures-editor-fields.png" alt="Última página com os campos do inquilino, do coinquilino e do senhorio, cada um na sua cor" />

Se alguém precisar de uma rubrica em todas as páginas, use **Rubrica em todas as páginas**. O Tillor coloca então um campo de rubrica em todas as páginas para esse signatário. Enquanto um signatário não tiver campo de assinatura ou de rubrica, vê **Ainda sem campo de assinatura** junto dessa pessoa.
</Step>
<Step>
### Defina a mensagem e o prazo [#stel-bericht-en-termijn-in]
Em **Pedido** preencha:

- **Título**: tal como os signatários o veem.
- **Mensagem para os signatários**: opcional, aparece no e-mail e na página de assinatura.
- **Assinar até**: a data limite. Por defeito são 14 dias após a criação. Pode assinar-se até ao fim desse dia.
- **Lembrete após**: após quantos dias (1 a 14) um signatário a quem chegou a vez recebe um lembrete. Por defeito 3 dias.
</Step>
<Step>
### Envie o pedido [#verstuur-het-verzoek]
Clique em **Enviar** e confirme. O primeiro signatário recebe a ligação.

<DocScreenshot src="/screenshots/handtekeningen/signatures-send-dialog.png" alt="Confirmação Enviar o pedido?" />

Se quiser continuar mais tarde, clique em **Guardar rascunho**. Com o caixote do lixo ao lado (**Eliminar rascunho**) deita fora o pedido, após confirmação. O PDF fica nos documentos do cliente.
</Step>
</Steps>

## O que acontece depois? [#wat-gebeurt-er-daarna]

- O pedido passa ao estado <Status tone="info">Em curso</Status>. Encontra-o no cliente, em **Documentos**, e em <UIPath>Administração > Assinaturas</UIPath>. O Tillor indica **Enviado ao primeiro signatário**.
- O primeiro signatário recebe um e-mail com uma ligação pessoal, ou um SMS se só houver número de telefone. Cada signatário seguinte recebe a ligação assim que o anterior assinar.
- Um signatário a quem chegou a vez e que não responde recebe automaticamente um lembrete após o número de dias em **Lembrete após**, no máximo 2 vezes. Também pode enviar um lembrete você mesmo a qualquer momento, ver [Acompanhar um pedido](/handtekeningen/opvolgen#een-herinnering-sturen).
- Assim que todos assinarem, o pedido passa a <Status tone="success">Concluído</Status> e o PDF assinado fica no cliente.
- Se o prazo terminar sem que todos tenham assinado, o pedido passa a <Status tone="warning">Expirado</Status>.

Se quiser alterar algo enquanto ainda ninguém assinou, ou só você, clique em **Voltar a editar**. O pedido volta a ser um rascunho: as ligações enviadas deixam de funcionar e todos assinam de novo quando o enviar outra vez. Se outra pessoa já assinou, cancele o pedido e crie um novo.

Quer que uma automação reaja a um pedido concluído, por exemplo com uma tarefa? Use o gatilho **Pedido de assinatura concluído**, ver [Gatilhos](/automatiseringen/triggers).

## Problemas? [#problemen]

<Accordions>
<Accordion title="O botão Pedir assinaturas está a cinzento">
Falta-lhe a permissão **Gerir pedidos de assinatura**. Peça a um administrador que a adicione em <UIPath>Definições > Utilizadores</UIPath>.
</Accordion>
<Accordion title="O Tillor diz: Isto não é um PDF. Escolha um ficheiro PDF.">
Escolheu outro tipo de ficheiro, por exemplo Word. Guarde primeiro o documento como PDF e escolha esse ficheiro.
</Accordion>
<Accordion title="O Tillor diz: Escolha um cliente, ou: Carregue um PDF ou escolha um documento do cliente">
No primeiro ecrã, **Cliente** ou **Documento** está vazio. Preencha ambos e clique de novo em **Continuar**.
</Accordion>
<Accordion title="Não consigo enviar">
O Tillor verifica o pedido antes de ele seguir e diz o que falta:

- **Adicione pelo menos um signatário antes de enviar.**
- Um signatário ainda não tem campo de assinatura nem de rubrica. O Tillor seleciona essa pessoa. Arraste então no documento para colocar um campo.
- Um signatário não tem e-mail nem número de telefone e por isso não pode receber uma ligação nem um código. Isto vale também para um cliente ou contacto: preencha primeiro um e-mail ou número de telefone nos dados deles. Na lista, essa pessoa aparece com **Sem e-mail nem número de telefone**.
- **Dê um título ao pedido.**
</Accordion>
<Accordion title="O Tillor diz: Não foi possível enviar o pedido">
O pedido pode não ter sido enviado. Recarregue a página. Se o pedido ainda estiver como <Status>Rascunho</Status>, clique de novo em **Enviar**.
</Accordion>
<Accordion title="O Tillor diz: Não foi possível guardar o rascunho">
As suas alterações não foram guardadas. Recarregue a página e verifique o que ainda lá está antes de continuar.
</Accordion>
<Accordion title="O documento não carrega no editor">
Recarregue a página. Se ainda não funcionar, verifique se o ficheiro é um PDF válido.
</Accordion>
<Accordion title="Coloquei um campo na pessoa errada">
Clique no campo e escolha em **Signatário** a pessoa certa. O campo fica no mesmo sítio.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Acompanhar um pedido" href="/handtekeningen/opvolgen" />
  <Card title="Como alguém assina" href="/handtekeningen/ondertekenen" />
  <Card title="Prova e validade" href="/handtekeningen/bewijs-en-geldigheid" />
</Cards>


# Visão geral (/pt-PT/handtekeningen)

Com **Assinaturas** pode fazer assinar online um PDF, como um contrato de arrendamento, regras da casa, um termo de responsabilidade ou uma fiança. Os signatários assinam um a seguir ao outro, e é você quem decide onde nas páginas fica cada assinatura, rubrica ou caixa de preenchimento. Como fazê-lo está em [Pedir assinaturas](/handtekeningen/handtekening-vragen).

Quando todos tiverem assinado, o Tillor cria um PDF assinado com páginas de prova no fim. Fica depois nos **Documentos** do cliente e cada signatário recebe uma cópia. O seu PDF original fica guardado sem alterações.

<Requires permission="Gerir pedidos de assinatura" />

Preparar, enviar, lembrar, retomar e cancelar pedidos de assinatura exige a permissão **Gerir pedidos de assinatura**, no grupo **Assinaturas** em <UIPath>Definições > Utilizadores</UIPath>. Se não tiver essa permissão, esses botões ficam a cinzento. Todos os utilizadores da sua organização podem ver pedidos e assinar eles próprios quando for a sua vez.

<Callout type="info" title="Bom saber">
- Um pedido tem no máximo 10 signatários e aceita apenas ficheiros PDF, até 250 MB.
- Por defeito pode assinar-se durante 14 dias, até ao fim do último dia. Pode escolher outra data.
- Um signatário a quem chegou a vez recebe por defeito um lembrete após 3 dias (pode escolher de 1 a 14 dias), com um máximo de 2 lembretes automáticos. Estes seguem com a verificação diária do Tillor.
- Ao assinar, o signatário confirma com um código de 6 dígitos. O código é válido durante 10 minutos e, passados 2 minutos, pode pedir-se um novo.
- O seu PDF original nunca muda. O original e o PDF assinado podem ser arquivados, mas não eliminados, porque são a prova.
- O pedido passa ao estado Expirado durante a verificação diária, não no momento exato em que o prazo termina.
</Callout>

## Onde encontrar [#waar-vind-je-het]

- <UIPath>Administração > Assinaturas</UIPath> mostra todos os pedidos de assinatura com o seu estado e quantas assinaturas já existem.
- No perfil de um cliente, no separador **Documentos**, está o botão **Pedir assinaturas**, com por baixo os **Pedidos de assinatura** desse cliente.

<DocScreenshot src="/screenshots/handtekeningen/signatures-list.png" alt="Lista de pedidos de assinatura em Administração > Assinaturas" />

## Como tudo se liga [#hoe-hangt-dit-samen]

Um pedido de assinatura pertence sempre a um cliente e a um PDF. Os signatários não têm de ser o próprio cliente: também um contacto, um colega ou uma parte externa pode assinar.

```mermaid
flowchart LR
  A[PDF no cliente] --> B[Pedido de assinatura com signatários e campos]
  B --> C[Signatário 1 assina]
  C --> D[Signatário 2 assina]
  D --> E[PDF assinado com páginas de prova]
  E --> F[Documentos do cliente]
  E --> G[Cópia para cada signatário]
```

## Como decorre um pedido [#hoe-een-verzoek-verloopt]

```mermaid
flowchart LR
  A[Rascunho] -->|Enviar| B[Em curso]
  B -->|todos assinaram| C[Concluído]
  B -->|signatário recusa| D[Recusado]
  B -->|Cancelar pedido| E[Cancelado]
  B -->|prazo terminou| F[Expirado]
  B -->|Voltar a editar| A
```

## Estados [#statussen]

| Estado | Significado |
|---|---|
| <Status>Rascunho</Status> | Ainda está a preparar o pedido. Ainda não foi enviado nada. |
| <Status tone="info">Em curso</Status> | O pedido foi enviado e está a ser assinado. |
| <Status tone="success">Concluído</Status> | Todos assinaram e o PDF assinado está no cliente. |
| <Status tone="error">Recusado</Status> | Um signatário recusou. O pedido foi interrompido. |
| <Status>Cancelado</Status> | Você ou um colega retirou o pedido. |
| <Status tone="warning">Expirado</Status> | Não se assinou a tempo. |

Por signatário vê **A aguardar** (ainda não é a sua vez), **Ligação enviada** (é a sua vez), **Assinado** ou **Recusado**.

## Quem pode assinar [#wie-kan-ondertekenen]

| Tipo | Como essa pessoa assina |
|---|---|
| **Cliente** | Através de uma ligação pessoal por e-mail, ou por SMS se só houver número de telefone |
| **Contacto** | Como o cliente, para um contacto desse cliente |
| **Colaborador** | No próprio Tillor, sem código |
| **Parte externa** | Como o cliente, com um nome e um e-mail ou número de telefone que preenche você |

Um cliente, contacto ou parte externa também pode assinar ao balcão, num tablet com a app Tillor. Ver [No tablet à receção](/handtekeningen/ondertekenen#op-de-tablet-aan-de-receptie).

## Automatizar [#automatiseren]

Um pedido de assinatura pode iniciar uma [automação](/automatiseringen/triggers). Com **Pedido de assinatura concluído** cria, por exemplo, uma tarefa assim que um contrato de arrendamento é assinado, com **Pedido de assinatura alterado** reage a cada mudança de estado. Pode enviar os mesmos eventos como [webhook](/ontwikkelaars/webhooks) para o seu próprio sistema.

<Cards>
  <Card title="Pedir assinaturas" href="/handtekeningen/handtekening-vragen" />
  <Card title="Acompanhar um pedido" href="/handtekeningen/opvolgen" />
  <Card title="Como alguém assina" href="/handtekeningen/ondertekenen" />
  <Card title="Prova e validade" href="/handtekeningen/bewijs-en-geldigheid" />
  <Card title="Angariar um cliente sazonal" href="/praktijk/seizoensklant-binnenhalen" description="Com assinatura do contrato de arrendamento" />
</Cards>

## Conceitos [#begrippen]

- **Pedido de assinatura**: a ordem para fazer assinar um PDF, com signatários, campos e um prazo. Ver [pedido de assinatura](/begrippen#ondertekenverzoek).
- **Signatário**: alguém que tem de assinar. Um cliente, contacto, colaborador ou parte externa.
- **Campo**: um local no PDF onde um signatário assina, rubrica ou preenche algo.
- **Rascunho**: um pedido que ainda está a preparar. Ainda não foi enviado nada.
- **Páginas de prova**: as páginas no fim do PDF assinado com quem assinou, quando e como. Ver [página de prova](/begrippen#bewijspagina).
- **Selo**: a assinatura digital da sua organização com que o PDF assinado é fechado. Ver [selo](/begrippen#zegel).


# Como alguém assina (/pt-PT/handtekeningen/ondertekenen)

Esta página mostra o que os seus signatários vivem, para que possa responder a perguntas, e como faz alguém assinar ao balcão no tablet. Um pedido envia-o você através de [Pedir assinaturas](/handtekeningen/handtekening-vragen).

Antes de começar:

- O pedido tem de estar no estado <Status tone="info">Em curso</Status> e o signatário tem de ter a vez. Se ainda não for a vez de ninguém, aparece **Ainda não é a sua vez**.
- Para o tablet precisa da permissão **Gerir pedidos de assinatura** e a app Tillor tem de estar online num dispositivo da sua organização.
- O signatário precisa de um número de telefone ou e-mail, porque é para aí que vai o código. Só um colaborador assina sem código.

## No tablet à receção [#op-de-tablet-aan-de-receptie]

Se alguém estiver à sua frente, essa pessoa não precisa de abrir a ligação. Isto é possível com um cliente, contacto ou parte externa a quem chegou a vez.

<Steps>
<Step>
### Abra o pedido [#open-het-verzoek]
Vá a <UIPath>Administração > Assinaturas</UIPath> e abra o pedido, ou abra-o através do separador **Documentos** do cliente.
</Step>
<Step>
### Clique em Assinar no tablet [#klik-op-op-tablet-tekenen]
No signatário a quem chegou a vez, clique em **Assinar no tablet** e escolha como a identidade é confirmada:

- **Com código**: o signatário confirma no tablet com o código que chega por SMS ou e-mail, como através da ligação.
- **Sem código**: você verificou a identidade ao balcão, por exemplo com um cartão de identidade. Não é pedido código. Na página de prova consta que a identidade foi confirmada por um colaborador, e no histórico quem foi.

O Tillor indica **Aberto no tablet**.
</Step>
<Step>
### Deixe a pessoa assinar [#laat-de-persoon-tekenen]
O documento abre na app no tablet, com o nome do signatário em letras grandes no topo. Verifique esse nome junto com a pessoa. Os passos são os mesmos que através da ligação, ver abaixo. Logo após o envio, o tablet pode ainda mostrar durante algum tempo **A preparar o documento**.
</Step>
</Steps>

Depois de assinar ou recusar, o tablet volta ao ecrã inicial passados alguns segundos. Com vários signatários, envia cada um separadamente para o tablet assim que lhe chegar a vez. Na página de prova consta que a assinatura foi feita no tablet.

## O que faz o signatário? [#wat-doet-de-ondertekenaar]

<Tabs items={["Através da ligação", "No tablet"]}>
<Tab value="Através da ligação">
O signatário recebe um e-mail, ou um SMS se só houver número de telefone. Contém uma ligação pessoal para a página de assinatura, com a sua mensagem e o nome da sua organização. A página funciona num telemóvel, tablet e computador, no idioma do signatário.
</Tab>
<Tab value="No tablet">
O signatário vê o documento diretamente na app, depois de você ter escolhido **Assinar no tablet**. Não é preciso ligação nem e-mail. Quem assina no tablet com código recebe o código no seu próprio telemóvel ou no seu e-mail.
</Tab>
</Tabs>

Depois, os passos são os mesmos.

<Steps>
<Step>
### Começar [#beginnen]
No primeiro cartão consta quem mais assina, o lugar na fila (por exemplo *Signatário 2 de 3*) e os passos. À direita está o documento, com as assinaturas dos signatários anteriores já no seu lugar. Com **Começar a assinar** o signatário começa. Cada passo tem um botão de voltar. O botão de voltar do telemóvel também funciona.

<DocScreenshot src="/screenshots/handtekeningen/signing-public-start.png" alt="Página de assinatura para o fiador com o cartão inicial e o documento" />
</Step>
<Step>
### Desenhe a sua assinatura [#teken-je-handtekening]
O signatário desenha uma **Assinatura** com o dedo ou o rato, ou escolhe **Escrever** e escreve o seu nome completo. O Tillor coloca então esse nome escrito numa letra manuscrita. Se houver campos de rubrica, segue-se da mesma forma uma **Rubrica** (iniciais desenhadas ou escritas). Com **Limpar** o signatário recomeça. Alternar entre **Desenhar** e **Escrever** esvazia a caixa.

<DocScreenshot src="/screenshots/handtekeningen/signing-public-type.png" alt="Passo Desenhe a sua assinatura com Escrever escolhido" />
</Step>
<Step>
### Coloque a sua assinatura [#plaats-je-handtekening]
O signatário toca em cada caixa marcada no documento (**Clique para assinar** ou **Clique para rubricar**). **Campo seguinte** salta para a caixa vazia seguinte. Com **Caixa anterior** e **Caixa seguinte** o signatário percorre todas as caixas. Um segundo toque numa caixa preenchida não faz nada.
</Step>
<Step>
### Preencha os seus dados [#vul-je-gegevens-in]
Apenas se tiver colocado caixas de preenchimento: texto, data ou uma marca. Em cada caixa consta **obrigatório** ou **opcional**. Uma caixa obrigatória vazia bloqueia o passo. O que é escrito aparece logo no documento. O Tillor preenche sozinho o nome e a data de assinatura.
</Step>
<Step>
### Confirme e assine [#bevestig-en-onderteken]
O signatário assinala que leu o documento. Se ainda faltar algo, aparece uma lista com botões que levam a esse passo.

Só quando tudo estiver pronto é que o signatário faz enviar um código de 6 dígitos com **Enviar código de verificação**: por SMS se houver número de telefone, caso contrário por e-mail. O código é válido durante 10 minutos. Se não chegar, passados 2 minutos pode usar **Reenviar código**. Depois o signatário clica ele próprio em **Assinar**. Nunca se assina automaticamente.
</Step>
</Steps>

## O que vê depois? [#wat-zie-je-daarna]

- Se ainda não for a vez de alguém, aparece **Ainda não é a sua vez** e segue-se uma mensagem assim que chegar a vez.
- Quem já assinou vê **Assinou** até os outros terminarem.
- Assim que todos tiverem assinado, cada signatário pode descarregar o PDF assinado através da mesma ligação (**Assinado por todos**).
- Num pedido retirado, o signatário vê **Pedido retirado**, num pedido expirado **Prazo de assinatura terminado** e num pedido recusado **Assinatura interrompida**.
- Um colaborador assina no Tillor, através do botão **Assinar agora** na página de detalhe ou através da ligação na mensagem. Não é necessário código, porque essa pessoa já tem sessão iniciada. Também aqui a assinatura pode ser desenhada ou escrita.

## Recusar [#weigeren]

Com **Recusar assinar**, um signatário pode rejeitar o pedido e, opcionalmente, indicar um motivo (até 500 carateres). O pedido é então interrompido, ninguém mais é convidado a assinar e quem criou o pedido recebe uma mensagem. Ver [Acompanhar um pedido](/handtekeningen/opvolgen#wat-gebeurt-er-daarna).

## Problemas? [#problemen]

<Accordions>
<Accordion title="O botão Assinar no tablet não aparece">
O botão só aparece se a app Tillor num dispositivo da sua organização esteve em contacto com o Tillor nos últimos minutos, e apenas com um cliente, contacto ou parte externa a quem chegou a vez. Abra a app no tablet, aguarde um pouco e recarregue a página. Verifique também que **Mostrar recibos e documentos** está ativado nas [definições do dispositivo](/mobiele-app/toestelinstellingen#kassabonnen-en-geluid). Ver também [Tablets e quiosques](/mobiele-app/tablets-en-kiosken).
</Accordion>
<Accordion title="O Tillor diz: Não foi possível abrir no tablet">
O Tillor não conseguiu chegar a nenhum tablet que mostre documentos. Verifique se a app está aberta e se o dispositivo tem ligação, e tente de novo.
</Accordion>
<Accordion title="O signatário não recebe o código">
O código vai para o número de telefone, ou para o e-mail se não houver número de telefone. Peça ao signatário que veja a pasta de spam e use **Reenviar código** passados 2 minutos. Se o número ou o endereço não estiver certo, corrija-o no cliente ou contacto e envie um lembrete. Numa parte externa, cancele o pedido e crie um novo com os dados corretos.
</Accordion>
<Accordion title="O Tillor diz: Não foi possível verificar o código">
O código introduzido não está certo ou expirou. Um código é válido durante 10 minutos. O signatário pede um novo com **Reenviar código** e introduz esse. Cada tentativa errada consta no histórico como **Código errado introduzido**.
</Accordion>
<Accordion title="O signatário não consegue clicar em Assinar">
Falta ainda algo. Em **Falta fazer antes de poder assinar** consta o que ainda é preciso: desenhar a assinatura ou rubrica, tocar numa caixa, ou preencher uma caixa obrigatória. Também a marca de que leu o documento tem de estar ativada.
</Accordion>
<Accordion title="A ligação já não funciona">
Se o pedido foi devolvido a rascunho, cancelado ou expirou, a ligação antiga deixa de funcionar. Depois de enviar de novo, o signatário recebe uma ligação nova. Num pedido cancelado ou expirado tem de criar um novo pedido.
</Accordion>
<Accordion title="O signatário vê: Este pedido mudou entretanto">
A página já estava aberta enquanto o pedido mudava, por exemplo porque já está assinado. A página mostra agora o seu estado. Não correu nada mal.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Acompanhar um pedido" href="/handtekeningen/opvolgen" />
  <Card title="Prova e validade" href="/handtekeningen/bewijs-en-geldigheid" />
  <Card title="Tablets e quiosques" href="/mobiele-app/tablets-en-kiosken" />
</Cards>


# Acompanhar um pedido (/pt-PT/handtekeningen/opvolgen)

Depois de enviar, acompanha um pedido de assinatura na página de detalhe: quem já assinou, a quem chegou a vez e o que ainda pode fazer. É também aqui que envia um lembrete, cancela um pedido e descarrega o PDF assinado.

Antes de começar:

- Qualquer pessoa pode ver. Lembrar, cancelar, devolver a rascunho e enviar para o tablet exige a permissão **Gerir pedidos de assinatura**. Sem essa permissão, esses botões ficam a cinzento.
- O pedido tem de ter sido enviado. Um <Status>Rascunho</Status> edita-se no editor, ver [Pedir assinaturas](/handtekeningen/handtekening-vragen).

## Abrir o pedido [#het-verzoek-openen]

Abra <UIPath>Administração > Assinaturas</UIPath>. A lista mostra por pedido o **Título**, o **Cliente**, o **Estado**, quantos já estão **Assinado**, quando foi **Criado** e até quando se pode assinar (**Assinar até**). Pesquise por título ou nome do cliente, ou filtre com **Estado** por exemplo só os pedidos que ainda estão em curso. Clique num pedido para o abrir.

Os mesmos pedidos estão também no cliente, no separador **Documentos**, em **Pedidos de assinatura**.

<DocScreenshot src="/screenshots/handtekeningen/signatures-customer-documents.png" alt="Separador Documentos de um cliente com o PDF assinado e os pedidos de assinatura" />

## A página de detalhe [#de-detailpagina]

À esquerda vê os dados do pedido, os signatários por ordem e o **Histórico**. À direita está o documento, com as assinaturas que já foram colocadas. No topo consta quem o pedido está a aguardar, por exemplo *À espera da assinatura de Marc Janssens.*

Por signatário vê se ainda tem de esperar (**A aguardar**), se recebeu a ligação (**Ligação enviada**), se **Assinado** ou **Recusado**, com a hora. A página atualiza-se sozinha quando alguém assina.

### Antes e depois: de Em curso a Concluído [#voor-en-na-van-bezig-naar-afgerond]

Assim se vê o mesmo tipo de pedido durante a assinatura e depois. Primeiro está em <Status tone="info">Em curso</Status>: o inquilino assinou e o fiador tem a vez.

<DocScreenshot src="/screenshots/handtekeningen/signatures-detail-in-progress.png" alt="Antes: pedido Em curso, o inquilino assinou e o fiador tem a vez" />

Assim que o último signatário assina, está em <Status tone="success">Concluído</Status>. Todas as assinaturas estão no documento, o histórico foi completado e no topo está o botão para descarregar o PDF assinado.

<DocScreenshot src="/screenshots/handtekeningen/signatures-detail-completed.png" alt="Depois: pedido concluído com as assinaturas no documento e o histórico" />

## Enviar um lembrete [#een-herinnering-sturen]

Num signatário a quem chegou a vez, clique em **Enviar lembrete**. Essa pessoa recebe de novo a mesma ligação, e o Tillor indica **A ligação foi enviada novamente**. A ligação da primeira mensagem continua também a funcionar. O botão não aparece nos colaboradores, que assinam no Tillor, nem nos signatários que ainda têm de esperar.

Além disso, o Tillor envia lembretes por si. Um signatário a quem chegou a vez recebe, após o número de dias que definiu em **Lembrete após** (por defeito 3), um lembrete, contado a partir da primeira mensagem ou do lembrete anterior. Isto acontece no máximo 2 vezes por signatário, e durante a verificação diária do Tillor. Um lembrete pode por isso chegar até um dia mais tarde do que o número de dias que definiu.

## Fazer assinar no tablet [#laten-tekenen-op-de-tablet]

Se o signatário estiver ao balcão, clique nessa pessoa em **Assinar no tablet**. Como funciona e porque é que o botão por vezes falta, lê-se em [No tablet à receção](/handtekeningen/ondertekenen#op-de-tablet-aan-de-receptie).

## Assinar você mesmo como colaborador [#zelf-ondertekenen-als-medewerker]

Se a vez for de um colega ou sua, essa pessoa recebe uma mensagem com uma ligação para o Tillor. Na página de detalhe aparece então o botão **Assinar agora**.

<DocScreenshot src="/screenshots/handtekeningen/signatures-detail-staff-turn.png" alt="Pedido em que a vez é do colaborador, com o botão Assinar agora" />

## Cancelar um pedido [#een-verzoek-annuleren]

Clique em **Cancelar pedido** e confirme. As ligações de assinatura deixam então de funcionar e as assinaturas já dadas não são usadas. Se mesmo assim quiser continuar, clique em **Manter**.

<DocScreenshot src="/screenshots/handtekeningen/signatures-cancel-dialog.png" alt="Confirmação Cancelar este pedido?" />

Só se pode cancelar enquanto o pedido estiver <Status tone="info">Em curso</Status>. Um pedido concluído, recusado ou expirado está fechado.

## Voltar a editar [#terug-naar-bewerken]

Se ainda ninguém assinou, ou só você, a página de detalhe tem **Voltar a editar**. O pedido volta a ser um rascunho, as ligações enviadas deixam de funcionar e todos assinam de novo após o envio. Se outra pessoa já assinou, o botão não existe. Cancele então o pedido e crie um novo.

## O que acontece depois? [#wat-gebeurt-er-daarna]

- **Alguém assina**: o signatário passa ao estado **Assinado** e o seguinte recebe a ligação. A página atualiza-se sozinha.
- **Todos assinaram**: vê brevemente *Todos assinaram. O PDF assinado está a ser preparado.* O pedido passa a <Status tone="success">Concluído</Status>. O PDF assinado fica como **[título] (assinado)** nos **Documentos** do cliente, com o mesmo tipo de documento que o PDF original. Se este não tinha tipo, fica com o tipo **Acordo assinado**. Cada signatário recebe uma cópia.
- **Alguém recusa**: o pedido é interrompido com o estado <Status tone="error">Recusado</Status>. Quem criou o pedido recebe uma notificação e os restantes signatários deixam de ser convidados. No signatário consta o motivo, se foi preenchido.
- **Você cancela**: o pedido fica com o estado <Status>Cancelado</Status> e as ligações deixam de funcionar.
- **O prazo terminou**: depois do dia em **Assinar até**, ninguém pode assinar. O Tillor passa o pedido a <Status tone="warning">Expirado</Status> durante a verificação diária. Até essa verificação, vê na página de detalhe que o prazo terminou. Se quiser que mais alguém assine, crie um novo pedido.

<DocScreenshot src="/screenshots/handtekeningen/signatures-detail-declined.png" alt="Pedido recusado com o motivo do cliente" />

## O PDF assinado [#de-ondertekende-pdf]

Na página de detalhe descarrega o PDF com **Descarregar PDF assinado**, por baixo do histórico. Aí está também o **Carimbo temporal**, ver [Prova e validade](/handtekeningen/bewijs-en-geldigheid#zegel-en-tijdstempel).

Por e-mail, o PDF vai como anexo na mensagem ao signatário. Se isso não resultar, há um botão para o descarregar. Quem só tem número de telefone recebe um SMS com uma ligação.

O PDF assinado e o PDF original são a prova da assinatura. Por isso não os pode eliminar, apenas arquivar.

## Histórico e eventos [#verloop-en-gebeurtenissen]

Em **Histórico** consta cada passo com a hora e quem o fez: criado, enviado, ligação enviada, página aberta, código enviado, código errado, assinado, recusado, devolvido a rascunho, cancelado, expirado e concluído. A mesma linha está no cliente, no separador **Eventos**, e no [registo de atividade](/activiteitenlog).

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não vejo o botão Enviar lembrete">
O botão só aparece num signatário com o estado **Ligação enviada**, ou seja, a quem chegou a vez. Num colaborador nunca aparece, porque assina no Tillor. Se aparece mas a cinzento, falta-lhe a permissão **Gerir pedidos de assinatura**.
</Accordion>
<Accordion title="O Tillor diz: Não foi possível enviar o lembrete">
Tente de novo. Se continuar a falhar, verifique o e-mail e o número de telefone do signatário. Num cliente ou contacto, corrija-os nos dados deles. Numa parte externa, cancele o pedido e crie um novo com os dados corretos.
</Accordion>
<Accordion title="O botão Voltar a editar não aparece">
Já assinou alguém que não é você. Nesse caso o pedido já não pode voltar a rascunho. Cancele o pedido com **Cancelar pedido** e crie um novo.
</Accordion>
<Accordion title="O Tillor diz: Não foi possível cancelar o pedido">
Só se pode cancelar um pedido que esteja <Status tone="info">Em curso</Status>. Recarregue a página e veja qual é agora o estado. Um pedido concluído, recusado ou expirado já não se pode cancelar.
</Accordion>
<Accordion title="O pedido ainda está Em curso, mas o prazo terminou">
Vê *O prazo de assinatura terminou; o pedido expira na próxima verificação diária.* Ninguém pode assinar agora. Assim que a verificação correr, o pedido fica <Status tone="warning">Expirado</Status>.
</Accordion>
<Accordion title="Vejo Todos assinaram, mas ainda não há PDF assinado">
O Tillor ainda está a preparar o PDF. Recarregue a página passados alguns minutos. Assim que estiver pronto, fica nos documentos do cliente e aparece **Descarregar PDF assinado**. Se passado um quarto de hora ainda não estiver pronto, o Tillor tenta de novo na verificação diária seguinte.
</Accordion>
<Accordion title="Não consigo eliminar o documento nem o PDF assinado">
É intencional. O PDF original e o PDF assinado são a prova. Pode arquivá-los.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Como alguém assina" href="/handtekeningen/ondertekenen" />
  <Card title="Prova e validade" href="/handtekeningen/bewijs-en-geldigheid" />
  <Card title="Documentos" href="/documenten" />
</Cards>


# Digitalizações de identidade (/pt-PT/identiteitsscans)

Com um leitor de identidade digitaliza passaportes, cartões de identidade, cartas de condução, vistos e documentos de residência. O Tillor reconhece o tipo de documento, lê os dados e cria com eles um cliente rapidamente, sem ter de reescrever tudo. O leitor envia a digitalização para a sua organização através do [conector Tillor](/connector) na sua rede local. Como criar depois um cliente está em [Criar cliente a partir de uma digitalização](#klant-aanmaken-vanuit-een-scan).

<Callout type="info" title="Bom saber">
- Uma digitalização sem cliente associado é eliminada automaticamente pelo Tillor ao fim de 7 dias, juntamente com os ficheiros que lhe pertencem.
- Uma digitalização associada fica guardada até você a desassociar ou eliminar. O prazo de conservação é você quem o define.
- Criar um cliente com base numa digitalização exige pelo menos um nome próprio na digitalização.
- Se já existir um cliente com o mesmo número de identificação nacional, associe a digitalização a esse cliente em vez de criar um duplicado.
- Os ficheiros da digitalização são guardados encriptados. Nas imagens das páginas consta uma marca de água **Not valid as ID**. O retrato fica sem marca de água.
- O conector escuta por defeito na porta 8765.
</Callout>

## Como tudo se liga [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  subgraph lokaal[Rede local]
    R[Leitor de identidade]
    C[Conector Tillor]
  end
  T[Digitalização pendente no Tillor]
  K[Cliente ou contacto]
  R --> C
  C --> T
  T -->|Criar ou associar cliente| K
  T -->|Não associada após 7 dias| X[Eliminada automaticamente]
```

Uma digitalização começa como digitalização pendente. Se a associar a um cliente ou contacto, fica guardada nesse cliente.

## Criar cliente a partir de uma digitalização [#klant-aanmaken-vanuit-een-scan]

Antes de começar:

- A digitalização tem de estar no Tillor como digitalização pendente. Se não estiver, veja Problemas no fim.
- A digitalização precisa de um nome próprio.

<Steps>
<Step>
### Abra a lista de clientes [#open-de-klantenlijst]
Vá a <UIPath>Clientes > Visão geral</UIPath> e clique em **Criar novo cliente**. Enquanto houver digitalizações pendentes, o botão mostra um menu: escolha **Manual** ou uma digitalização da lista.

<DocScreenshot src="/screenshots/klanten/customer-create-scan-menu.png" alt="Criar novo cliente - menu com digitalização de identidade pendente" />
</Step>
<Step>
### Verifique a digitalização [#controleer-de-scan]
Depois de escolher uma digitalização abre uma confirmação com uma pré-visualização do documento e os dados da zona de leitura. Clique em **Criar cliente**.

<DocScreenshot src="/screenshots/klanten/customer-create-from-scan-confirm.png" alt="Confirmação depois de escolher uma digitalização pendente com pré-visualização do documento" />
</Step>
</Steps>

O mesmo caminho funciona através de **Iniciar reserva** (**Novo cliente…**) e através do painel em baixo à direita com **Criar cliente com base na digitalização**.

<DocScreenshot src="/screenshots/klanten/identity-scan-dock.png" alt="Painel em baixo à direita - digitalização de identidade pendente com pré-visualização do documento" />

### O que acontece depois? [#wat-gebeurt-er-daarna]

- O Tillor cria o cliente, associa a digitalização e preenche, sempre que possível, nome próprio, apelido, data de nascimento, morada e outros campos.
- Chega ao novo perfil do cliente.
- A digitalização deixa de estar na fila e fica guardada no cliente.
- A associação consta no separador **Eventos** do cliente.

## Associar a um cliente ou contacto existente [#koppelen-aan-een-bestaande-klant-of-contactpersoon]

Além de um novo cliente, também pode associar uma digitalização a um cliente ou contacto existente.

<Tabs items={["A um cliente", "A um contacto"]}>
<Tab value="A um cliente">
No perfil do cliente aparece um cartão tracejado **Atribuir uma digitalização de identidade pendente** enquanto houver digitalizações pendentes adequadas. Escolha uma digitalização com **Escolher digitalização…** e clique em **Atribuir a este cliente**.
</Tab>
<Tab value="A um contacto">
No cartão de um contacto pode associar uma digitalização que ainda não tenha contacto e contenha pelo menos um nome próprio, com **Associar ao contacto**. Também pode fazer criar um novo contacto com **Criar contacto a partir da digitalização**.
</Tab>
</Tabs>

Depois de associar, o Tillor completa, sempre que possível, os dados do cliente ou contacto. Como nome próprio, o Tillor aproveita apenas a primeira parte do nome próprio, por exemplo `Andy` de `Andy Adhemar R`. Na digitalização continuam visíveis todos os nomes próprios.

## Desassociar, exportar ou eliminar uma digitalização [#een-scan-ontkoppelen-exporteren-of-verwijderen]

Numa digitalização associada há ações para **Descarregar**, **Exportar PDF**, **Desassociar digitalização** e **Eliminar digitalização**. Eliminar remove permanentemente a digitalização e todos os ficheiros encriptados e não pode ser anulado.

## Prazo de conservação e a sua responsabilidade [#bewaartermijn-en-jouw-verantwoordelijkheid]

<Callout type="warn" title="7 dias para digitalizações pendentes">
As digitalizações que ainda não estão associadas a um cliente são eliminadas automaticamente pelo Tillor ao fim de 7 dias (a digitalização e os ficheiros que lhe pertencem). Associe ou trate as digitalizações pendentes a tempo através de **Criar novo cliente**, do painel em baixo à direita ou do cartão tracejado num perfil de cliente.
</Callout>

Para as digitalizações associadas aplica-se outra regra: ficam guardadas até a sua organização as desassociar ou eliminar. É você quem decide se, quando e com que fundamento legal os documentos de identidade são digitalizados e durante quanto tempo as digitalizações associadas são necessárias. O Tillor trata as digitalizações como subcontratante, segundo as suas instruções. O cumprimento da legislação de privacidade, os prazos de conservação das digitalizações associadas e a eliminação atempada quando o armazenamento deixa de ser necessário são da sua responsabilidade como responsável pelo tratamento.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não chega nenhuma digitalização ao Tillor">
Verifique no leitor o endereço IP do conector e a porta 8765, e se o conector está a funcionar. Ver [Conector](/connector).
</Accordion>
<Accordion title="A digitalização não está no menu nem no painel">
Só contam como pendentes as digitalizações sem cliente associado. Se a digitalização já está associada, ou tem mais de 7 dias e por isso foi eliminada, já não aparece.
</Accordion>
<Accordion title="Criar cliente com base na digitalização está a cinzento">
Na digitalização consta o motivo. Se a digitalização não tem nome próprio, aparece *adicione um no leitor ou associe esta digitalização manualmente*. Se o documento ainda é válido e já existe um cliente com este número de identificação nacional, abra o cliente sugerido no topo do cartão ou associe a digitalização a esse cliente.
</Accordion>
<Accordion title="O Tillor diz: Não foi possível criar o cliente a partir desta digitalização">
O cliente não foi criado e a digitalização continua pendente. Tente de novo. Se não resultar, crie o cliente manualmente e associe a digitalização com **Atribuir ao cliente**.
</Accordion>
<Accordion title="O Tillor diz: Não foi possível associar a digitalização ao cliente">
Tente de novo, ou use o painel em baixo à direita.
</Accordion>
</Accordions>

## Conceitos [#begrippen]

- **Digitalização de identidade**: os dados e imagens lidos de um documento de identidade.
- **Digitalização pendente**: uma digitalização que ainda não está associada a um cliente e desaparece após 7 dias.
- **Zona de leitura (MRZ)**: as linhas com letras e números na parte inferior do documento que o leitor lê.
- **Conector**: a caixinha na sua rede local que reencaminha as digitalizações para o Tillor. Ver [conector](/begrippen#connector).
- **Cliente**: o registo no Tillor. Ver [cliente](/begrippen#klant).

## Ver também [#zie-ook]

<Cards>
  <Card title="Gestão de clientes" href="/klantenbeheer" description="Criar cliente, incluindo o caminho com uma digitalização" />
  <Card title="Conector" href="/connector" description="A caixinha conector no seu parque" />
  <Card title="Exemplos práticos" href="/praktijk" />
</Cards>


# Ler e responder a conversas (/pt-PT/inbox/gesprekken)

Na caixa de entrada ficam reunidas todas as conversas dos seus canais ligados. Aqui lê-as, responde e arruma-as. Como ligar um canal está descrito em [Caixa de entrada](/inbox).

Antes de começar:

- Precisa da permissão **Ver caixa de entrada** para ler conversas e de **Gerir caixa de entrada** para responder ou arquivar. Sem **Ver caixa de entrada**, a caixa de entrada não aparece na barra lateral.
- Tem de haver pelo menos um canal ligado. Caso contrário, vê uma ligação para <UIPath>Definições > Integrações</UIPath>.

<Requires permission="Inbox bekijken" />

## Abrir a caixa de entrada [#de-inbox-openen]

<Steps>
<Step>
### Aceda à caixa de entrada [#ga-naar-de-inbox]
Na barra lateral, em **Apoio**, escolha o item **Caixa de entrada** (marcação **1** na captura de ecrã). Se ainda não houver nenhum canal ligado, o Tillor mostra uma ligação para <UIPath>Definições > Integrações</UIPath>.
</Step>
<Step>
### Escolha uma conversa [#kies-een-gesprek]
À esquerda está a lista **Conversas** com os fios de todos os canais. Alterne entre conversas ativas e concluídas com **Abertas** e **Arquivadas**. Clique numa conversa para a abrir à direita.
</Step>
</Steps>

<DocScreenshot src="/screenshots/communicatie/inbox/inbox-overview.png" alt="Caixa de entrada - lista de conversas com conversas de demonstração e coluna de detalhe vazia" />

Uma conversa aberta mostra as mensagens por ordem, com nome e hora. Na parte inferior está o campo de resposta (marcação **2** no exemplo).

<DocScreenshot src="/screenshots/communicatie/inbox/inbox-conversation-whatsapp.png" alt="Caixa de entrada - conversa de WhatsApp com campo de resposta" />

O fundo de uma conversa segue o canal: bege para WhatsApp, balões azuis para Messenger, rosa para Instagram e cinzento-claro para o chat do website.

## Enviar uma resposta [#een-antwoord-sturen]

<Requires permission="Inbox beheren" />

<Steps>
<Step>
### Abra a conversa [#open-het-gesprek]
Clique na conversa na lista.
</Step>
<Step>
### Escreva a resposta [#typ-je-antwoord]
Escreva no campo de resposta, na parte inferior.
</Step>
<Step>
### Envie [#verstuur]
Clique em **Enviar** ou prima **Ctrl+Enter**.
</Step>
</Steps>

Nas suas próprias mensagens, junto à hora, aparece um visto para enviada, um visto duplo para entregue e um visto duplo azul para lida. As respostas que enviar através da aplicação WhatsApp Business ou da aplicação Messenger também aparecem na conversa enquanto a integração estiver ativa.

Uma mensagem que enviou não pode ser editada. Os canais não o permitem. No Messenger e no Instagram, junto a uma mensagem de texto própria há um botão de eliminar. Este só oculta a mensagem no Tillor; o cliente mantém a mensagem na sua própria aplicação.

As fotografias recebidas pelo Messenger são guardadas e mostradas na conversa; na lista aparece então um ícone de fotografia em vez de texto. As reações com emojis a mensagens do Messenger aparecem como contadores por baixo da mensagem.

### WhatsApp e a janela de resposta de 24 horas [#whatsapp-en-het-antwoordvenster-van-24-uur]

Um cliente que lhe envia uma mensagem no WhatsApp abre uma janela de resposta gratuita de 24 horas. O Tillor mostra **Janela de resposta gratuita aberta** com uma contagem decrescente. Se a janela estiver fechada, aparece **Janela de 24 horas fechada** e a sua resposta segue como modelo de WhatsApp pago, até o cliente voltar a escrever.

- Se não tiver sido adicionado um método de pagamento à sua conta WhatsApp Business no Meta WhatsApp Manager, o Tillor bloqueia as respostas pagas. As respostas gratuitas dentro da janela continuam a ser possíveis.
- Se a Meta ainda não tiver aprovado o modelo no idioma da sua organização, a sua resposta fica a aguardar. Isto costuma demorar alguns minutos e pode chegar às 48 horas.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- A sua resposta fica na conversa com um visto: enviada, entregue ou lida. Se a entrega falhar, aparece **Não entregue**.
- Uma conversa arquivada desaparece de **Abertas**. Se o cliente voltar a escrever, a conversa reaparece.
- A conversa também fica no cliente, em <UIPath>Clientes > cliente > Comunicação</UIPath>.

## Encontrar e arrumar conversas [#gesprekken-terugvinden-en-opruimen]

- **Pesquisar**: filtre os fios por nome ou número de telefone, dentro de **Abertas** ou **Arquivadas**.
- **Não lidas**: em **Abertas**, as conversas não lidas aparecem a negrito, com uma bolinha vermelha. Clique em **Marcar todas como lidas** no topo da lista para as marcar todas de uma vez.
- **Arquivar**: clique em **Arquivar** numa conversa concluída em **Abertas**.
- **Restaurar**: abra uma conversa em **Arquivadas** e clique em **Restaurar** para a repor e poder voltar a responder.
- **Menu de contexto**: clique com o botão direito ou prima longamente uma conversa para **Marcar como lida**, **Marcar como não lida**, **Fixar conversa** ou **Desafixar conversa**, **Arquivar** e **Restaurar**.

O número junto a **Caixa de entrada** na barra lateral conta as conversas abertas cuja última mensagem é do cliente e ainda aguarda resposta. As mensagens novas aparecem em direto; o número atualiza-se sozinho.

## Etiquetas [#tags]

Com etiquetas identifica conversas para toda a sua equipa.

1. Abra uma conversa e use, no painel lateral, o bloco **Etiquetas**.
2. Crie uma etiqueta com **Nova etiqueta** ou escolha uma existente. No menu de etiquetas edita ou elimina etiquetas.
3. Filtre a lista com o ícone de etiqueta junto ao filtro de plataforma.

As etiquetas com **A IA pode aplicar** podem ser adicionadas pela Tillie após uma resposta automática. As etiquetas que a sua equipa já tinha definido mantêm-se.

## Notificações [#meldingen]

Os utilizadores com **Notificações de mensagens da caixa de entrada** recebem uma notificação push a cada nova mensagem de um cliente. As suas próprias respostas não geram notificação.

Com **Ver caixa de entrada**, numa nova mensagem vê também uma notificação em baixo à direita, no mesmo dock das verificações de identidade em aberto e das chamadas telefónicas ativas. Aí constam o remetente, o canal e um excerto do texto. Clique nela para abrir a conversa. A notificação desaparece ao fim de cerca de dez segundos, a menos que mantenha o rato por cima. Se a conversa já estiver aberta, não aparece notificação.

## Conversas e clientes [#gesprekken-en-klanten]

Sempre que possível, o Tillor associa uma conversa a um cliente:

- WhatsApp pelo número de telefone.
- Messenger por um nome correspondente, ou por um número de telefone ou endereço de e-mail que o próprio cliente partilhe na conversa.
- Instagram por um nome correspondente ou por um nome de utilizador com `@`.

A Meta não transmite endereço de e-mail nem número de telefone através do Messenger e do Instagram. As conversas abertas de um cliente também constam em <UIPath>Clientes > cliente > Comunicação</UIPath>.

O painel lateral à direita mostra, por canal, os dados do participante, como o número de WhatsApp, o nome de utilizador do Instagram com ligação para o perfil ou a página no chat do website. Com o ícone de painel acima da conversa oculta ou mostra o painel.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não vejo a Caixa de entrada na barra lateral">
Precisa da permissão **Ver caixa de entrada**. Peça a um administrador que a atribua em <UIPath>Definições > Utilizadores</UIPath>, com **Editar permissões** junto ao seu nome.
</Accordion>
<Accordion title="Não consigo enviar uma resposta">
Para responder precisa de **Gerir caixa de entrada**. Numa conversa arquivada também não pode responder: clique primeiro em **Restaurar**.
</Accordion>
<Accordion title="O Tillor indica Falha ao enviar a mensagem">
Verifique se a conversa está aberta e se tem **Gerir caixa de entrada**. No WhatsApp, a causa também pode ser a janela de resposta fechada, veja acima. Depois tente novamente.
</Accordion>
<Accordion title="Na minha mensagem aparece Não entregue">
O canal não conseguiu entregar a mensagem. No WhatsApp, isso deve-se normalmente à janela de 24 horas fechada ou à falta de um método de pagamento na Meta.
</Accordion>
<Accordion title="A caixa de entrada está vazia">
Ainda não há nenhum canal ligado, ou ainda não chegaram mensagens. Ligue um canal em <UIPath>Definições > Integrações</UIPath>.
</Accordion>
<Accordion title="Um cliente editou ou eliminou uma mensagem">
O Tillor ajusta a conversa automaticamente quando um cliente edita ou retira uma mensagem no Messenger ou no Instagram, ou a edita no WhatsApp (nos primeiros 15 minutos).
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Visão geral" href="/inbox" description="Canais e permissões" />
  <Card title="Conversas pelo chat do website" href="/inbox/website-chat-gesprekken" description="Extras do chat no seu site" />
  <Card title="Assistente de IA da caixa de entrada" href="/inbox/inbox-ai-assistant" description="Tillie em todos os canais" />
</Cards>


# Assistente de IA da caixa de entrada (Tillie) (/pt-PT/inbox/inbox-ai-assistant)

A **Tillie** é o nome predefinido do assistente de IA na [caixa de entrada do Tillor](/inbox). Responde a perguntas frequentes, recolhe dados para pedidos de reserva ou de venda e transfere a conversa para a sua equipa quando é preciso um colega. A Tillie funciona em **todos os canais da caixa de entrada**: [chat do website](/inbox/website-chat), [WhatsApp Business](/inbox/whatsapp-business-inbox), [Messenger](/inbox/messenger) e [Instagram Direct](/inbox/instagram).

<Callout type="info" title="Independente do chat do website">
Instale o **Assistente de IA da caixa de entrada** em separado em **Definições > Integrações**. O assistente pertence à caixa de entrada, não apenas ao widget do site.
</Callout>

## Instalar a integração [#integratie-installeren]

1. Aceda a **Definições > Integrações** (barra lateral, em **Apoio**)
2. Abra **Assistente de IA da caixa de entrada** na lista
3. Clique em **Instalar**
4. Em **Definições**, defina o que a Tillie pode fazer (veja os campos abaixo)

| Campo | O que faz? |
|------|----------------|
| **IA da caixa de entrada ativada** | Interruptor principal de todas as funções de IA da caixa de entrada. Desligue para parar sem desinstalar |
| **Enviar respostas automáticas** | Desligado: a Tillie não envia mensagens aos visitantes. As traduções, a deteção do idioma e os rascunhos de resposta para a equipa podem continuar ativos em separado |
| **Ativar automaticamente a IA em conversas novas** | Só se aplica quando as respostas automáticas estão ativadas. Desligado: cada conversa nova começa sem IA; ativa a IA por conversa na barra lateral. Ligado: as novas conversas da caixa de entrada, em todos os canais, passam logo a ter IA (com 30 minutos de pausa após uma mensagem da equipa) |
| **Gerar rascunhos para a equipa** | Permite aos colegas gerar um rascunho de IA na caixa de composição. Esse rascunho nunca é enviado automaticamente |
| **Traduzir mensagens** | Traduz as mensagens recebidas para o idioma da organização e as respostas da equipa para o idioma do contacto. As respostas da equipa recebem ainda pontuação correta, maiúsculas e abreviaturas de chat escritas por extenso (mesmo quando não é preciso traduzir) |
| **Detetar o idioma do contacto** | Usa IA para detetar o idioma do visitante quando ainda não é conhecido, e guarda-o na conversa |
| **Nome do assistente de IA** | Nome usado nas respostas e nos prompts (predefinição **Tillie**) |
| **Servidores MCP (JSON)** | Opcional. Ligações MCP só de leitura (URL e cabeçalhos) |
| **Ferramentas MCP** | Depois de guardar: **Carregar ferramentas**, listar as ferramentas só de leitura e ativar ou desativar cada uma |

<Callout type="info" title="Só traduzir, sem respostas automáticas">
Ative **IA da caixa de entrada ativada**, ative **Traduzir mensagens** (e, se quiser, a deteção do idioma) e desative **Enviar respostas automáticas**. A Tillie traduz então, mas não envia nada aos visitantes.
</Callout>

### Ferramentas MCP (opcional) [#mcp-tools-optioneel]

Se o seu parque tiver um servidor MCP com ligações só de leitura, o Tillor pode obter **dados do parque em direto** durante uma conversa. Pense em atividades, caravanas à venda ou outros dados que o seu servidor disponibilize.

O Tillor **não tem uma lista fixa de nomes de ferramentas**. As ferramentas que existem vê-as depois de **Carregar ferramentas** nas definições da integração. Só pode ativar ferramentas que o seu servidor MCP marque como só de leitura.

1. Preencha **Servidores MCP (JSON)** (URL e cabeçalhos).
2. Guarde e clique em **Carregar ferramentas**.
3. Ative as ferramentas que fazem sentido para o seu parque.

Consoante a configuração de IA do seu ambiente, a Tillie escolhe por si qual das ferramentas ativadas é adequada, com base na descrição da ferramenta no seu servidor. Nunca chama ferramentas que não tenha ativado.

Os resultados do MCP entram na resposta da Tillie. Não substituem a base de conhecimento: preços, disponibilidade e regras continuam a não ser inventados quando não vêm de lado nenhum.

<Callout type="info" title="A Tillie não responde?">
A Tillie usa um modelo de IA que o Tillor configura para o seu ambiente. Se o assistente não responder, contacte o suporte do Tillor.
</Callout>

## O que a Tillie faz após uma mensagem de um visitante [#wat-tillie-doet-na-een-bezoekersbericht]

Após cada nova mensagem recebida numa conversa em que a IA está ativa:

1. O Tillor mostra um **indicador de escrita** no canal enquanto a resposta é gerada
2. O Tillor determina a intenção: **reserva**, **venda** ou **outro** (nas organizações com fluxo de caravanas de aluguer, também **caravana de aluguer**)
3. A Tillie responde no idioma do visitante; depois o indicador de escrita desaparece

A Tillie decide por si, com base nas suas instruções, quando responde e quando fica em silêncio. A uma saudação inicial ("olá", "oi") responde com uma breve boas-vindas e a pergunta sobre em que pode ajudar. Depois de um agradecimento final, não volta a reagir a um curto "obrigado", "ok" ou "não" do visitante, para que não surja um ciclo de agradecimentos.

| Intenção | Comportamento |
|-----------|--------|
| **Reserva** | Pede os dados em falta: chegada, partida, tipo (tenda, mobile home, caravana de turismo), cães sim/não (e quantos), número de pessoas, crianças e idades, depois nome, e-mail e número de telefone, e opcionalmente a matrícula para o check-in (pode ser ignorada). Os dados que o Tillor já conhece (por exemplo, do widget do site ou do WhatsApp) são preenchidos; só se pedem os campos em falta. Perante um dia da semana ("segunda-feira"), a Tillie faz primeiro uma pergunta de confirmação ("Refere-se a …?") antes de continuar. Cada resposta termina com uma pergunta. Responde a perguntas curtas de política a partir da base de conhecimento (por exemplo, alterar a reserva mais tarde) e depois continua a recolher dados. Quando está tudo completo, a Tillie resume o **pedido** e transfere a conversa para um colega - ainda não há uma reserva definitiva |
| **Caravana de aluguer** | Recolhe nome, e-mail, morada, país e motivo da estadia (a pedido), depois transfere para a sua equipa |
| **Venda** | Explica que o visitante tem de passar pelo escritório para uma visita ou compra, e comunica-o à sua equipa |
| **Outro** | Só responde se a resposta constar da base de conhecimento. Caso contrário, a Tillie diz com franqueza que não sabe, oferece-se para passar a pergunta a um colega e transfere a conversa |

A Tillie **não inventa preços, disponibilidade nem regras**. Só o que consta da base de conhecimento pode ser dito como facto.

### Formulário de reserva no seu site [#boekingsformulier-op-je-website]

Ligou um formulário próprio ao [Chat do website](/inbox/website-chat)? Então pode deixar a Tillie apenas confirmar e transferir logo, sem perguntas de admissão. Isto convém a um formulário cujo separador fecha depois. Veja [API do chat do website - metadados](/ontwikkelaars/website-chat#metadata-boekingsformulier).

## Por conversa: Automático, Ativado ou Desativado [#per-gesprek-automatisch-aan-of-uit]

Nos detalhes da conversa, na barra lateral, escolhe por fio:

| Estado | Comportamento |
|-------|--------|
| **Automático** | A Tillie responde, mas faz uma pausa de **30 minutos** após cada mensagem da sua equipa |
| **Ativado** | A Tillie responde sempre, mesmo logo a seguir a uma mensagem da equipa |
| **Desativado** | A Tillie não responde a esta conversa |

Durante a pausa vê uma contagem decrescente na barra lateral.

## Etiquetas após uma resposta de IA [#tags-na-een-ai-antwoord]

No painel lateral pode criar e atribuir **etiquetas** a nível da organização (permissão **Gerir caixa de entrada**). Use **Nova etiqueta** para criar uma etiqueta. Abra o menu de etiquetas numa conversa para atribuir etiquetas; editar e eliminar cada etiqueta está nesse mesmo menu. Marque **A IA pode aplicar** se a Tillie puder adicionar essa etiqueta após uma resposta automática. A Tillie escolhe então por si zero ou mais dessas etiquetas com base na conversa; as etiquetas que a sua equipa já tinha definido mantêm-se.

Etiquetas típicas são, por exemplo, **Verkoop**, **Boeking** e **Urgent**. A Tillie reconhece esses nomes e associa-os ao que já apurou na conversa:

| Intenção da Tillie | Corresponde a nomes de etiqueta como |
|---|---|
| Venda | Verkoop, Sale |
| Reserva | Boeking, Reservatie, Booking |
| Caravana de aluguer | Caravan, Verhuur |
| Transferência urgente | Urgent, Spoed, Dringend |

O nome da etiqueta não tem de coincidir exatamente: **Boeking aanvragen** também conta como etiqueta de reserva. Só as etiquetas com **A IA pode aplicar** são consideradas.

## Idioma, tom e dados de contacto [#taal-toon-en-contactgegevens]

As respostas seguem o idioma do visitante - não só os quatro idiomas do widget (`en`, `nl`, `de`, `fr`), mas qualquer idioma em que a Tillie consiga responder (por exemplo, espanhol, polaco, turco). Se alguém pedir expressamente outro idioma, a Tillie muda e guarda o idioma escolhido na conversa.

Os **resumos de transferência** (visíveis apenas para a sua equipa) seguem sempre o **idioma da organização** no Tillor, em cada transferência (reserva, caravana de aluguer, venda, pergunta em aberto, pedido explícito de um colega), independentemente do idioma da conversa. A Tillie recebe esse idioma da organização em cada prompt.

As mensagens aos visitantes (IA e equipa) são sempre **texto simples**, sem markdown, porque o WhatsApp, o Instagram, o Messenger e o widget não o suportam. No WhatsApp, a Tillie pode colocar até três botões de resposta por baixo de uma resposta curta, quando um toque é uma escolha que a própria mensagem já refere. A mensagem continua legível se o cliente escrever em vez de tocar. Fora da janela de 24 horas, a resposta segue como modelo, sem botões.

A Tillie mantém-se calma e profissional, não fala de concorrentes e não ignora regras de segurança se um visitante pedir para ignorar instruções. Os dados de contacto para encaminhamento vêm do seu **perfil de organização no Tillor** (nome, morada, telefone, e-mail, site). O **horário de funcionamento do escritório** define-o em **Definições > Horário de funcionamento** (horários semanais, períodos sazonais, feriados e exceções); a Tillie usa esses horários para dizer quando um colega pode responder. Mantenha esses campos atualizados. Cerca de uma semana antes de um feriado legal, o Tillor lembra por e-mail o endereço de suporte se os horários desse dia ainda não estiverem preenchidos.

## Eventos na conversa (apenas para a sua equipa) [#gebeurtenissen-in-het-gesprek-alleen-voor-je-team]

Durante a admissão de uma reserva, a Tillie atualiza nome, e-mail e telefone assim que o visitante os indica. Na caixa de entrada aparece então um evento **Dados atualizados pela IA** (de → para), visível apenas para a sua equipa.

Numa transferência aparece um evento **Transferência da IA**: um cartão em destaque com um resumo (tabela para os dados de reserva ou de caravana de aluguer, mais notas para perguntas em aberto). O resumo está sempre no **idioma da sua organização** (nl, en, de ou fr), mesmo quando o visitante conversa noutro idioma. O visitante não vê esse cartão.

<DocScreenshot src="/screenshots/communicatie/inbox/inbox-conversation-website.png" alt="Caixa de entrada - chat do website com transferência da IA e detalhes da conversa" />

## Base de conhecimento: factos que a Tillie pode usar [#kennisbank-feiten-die-tillie-mag-gebruiken]

A Tillie responde a perguntas com base numa **base de conhecimento**: artigos curtos com factos verificados sobre o seu parque, por exemplo horários, regras para animais, a piscina, postos de carregamento ou como alterar uma reserva mais tarde.

Alguns artigos aplicam-se a todas as organizações do Tillor, outros são específicos do seu parque. Numa conversa, a Tillie só usa os artigos gerais mais os artigos que foram adicionados para a sua organização.

Quer que se acrescentem, alterem ou removam temas? Comunique-o ao suporte do Tillor. Nós preenchemos e mantemos a base de conhecimento consigo, ajustada ao que a sua receção quer poder responder.

## Fluxos de conversa: guião por intenção [#gespreksflows-draaiboek-per-bedoeling]

Além da base de conhecimento, a Tillie segue **fluxos de conversa**: acordos sobre que dados pede, em que ordem e quando transfere a conversa para a sua equipa. Cada intenção (reserva, caravana de aluguer, venda, outro - veja a tabela acima) tem um fluxo destes.

Os fluxos vêm configurados por predefinição, mas o Tillor ajusta-os consigo ao seu parque. Quer, por exemplo, que se peçam outros dados num pedido de reserva, ou que a Tillie transfira mais depressa? Comunique-o ao suporte do Tillor.

<Callout type="warn" title="Primeira versão">
Verifique as respostas de IA na caixa de entrada antes de as confiar aos visitantes. Uma reserva por chat continua a ser um **pedido** - não uma reserva definitiva.
</Callout>

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- Uma conversa que a Tillie transfere aparece na caixa de entrada com um bloco **Tillie passou esta conversa à sua equipa** e os dados recolhidos.
- A sua equipa recebe uma notificação. Numa transferência urgente, isso faz-se através da notificação **Transferência urgente da IA**. Veja [Tipos de notificação](/communicatie/notificatietypes).
- Se um colega responder, a Tillie faz uma pausa de 30 minutos no estado **Automático**.

## Problemas? [#problemen]

<Accordions>
<Accordion title="A Tillie não responde">
Verifique se **IA da caixa de entrada ativada** e **Enviar respostas automáticas** estão ligados em <UIPath>Definições > Integrações > Assistente de IA da caixa de entrada</UIPath>. Depois veja, na barra lateral da conversa, se o estado não está em **Desativado** ou se há uma contagem decrescente após uma mensagem da sua equipa.
</Accordion>
<Accordion title="As conversas novas começam sem a Tillie">
**Ativar automaticamente a IA em conversas novas** está desligado. Ligue o interruptor, ou escolha **Ativado** por conversa.
</Accordion>
<Accordion title="A Tillie diz que não sabe algo">
A Tillie só usa o que consta da base de conhecimento e não inventa preços, disponibilidade nem regras. Complete a base de conhecimento.
</Accordion>
</Accordions>

## Relacionado [#gerelateerd]

<Cards>
  <Card title="Caixa de entrada" href="/inbox" description="Ler e responder a conversas" />
  <Card title="Chat do website" href="/inbox/website-chat" description="Chat em direto no seu próprio site" />
  <Card title="WhatsApp Business" href="/inbox/whatsapp-business-inbox" description="WhatsApp na caixa de entrada" />
  <Card title="Messenger" href="/inbox/messenger" description="Ligar o Facebook Messenger" />
  <Card title="Instagram" href="/inbox/instagram" description="Ligar o Instagram Direct" />
</Cards>


# Visão geral (/pt-PT/inbox)

Na caixa de entrada lê e responde a mensagens de clientes e visitantes que chegam por WhatsApp, Messenger, Instagram ou pelo chat do seu site, tudo num só lugar. Encontra-a na barra lateral em **Apoio > Caixa de entrada**. Primeiro liga os canais que quer usar e depois trabalha no dia a dia em [Ler e responder a conversas](/inbox/gesprekken).

<Callout type="info" title="Não serve para notificações automáticas">
A caixa de entrada destina-se à comunicação nos dois sentidos com clientes. As notificações automáticas de WhatsApp, por exemplo com um saldo NFC baixo, passam pela Twilio e não por estas integrações.
</Callout>

<Callout type="info" title="Bom saber">
- Uma mensagem nova aparece como cartão em baixo à direita e desaparece ao fim de cerca de dez segundos. O número junto a **Caixa de entrada** conta as conversas abertas que aguardam resposta
- A assistente de IA Tillie faz uma pausa de 30 minutos depois de um colega ter respondido
- Uma mensagem de chat no site pode ter no máximo 4096 caracteres, sem imagens nem ficheiros
- Um cliente pode editar uma mensagem de WhatsApp até 15 minutos depois de a enviar, e vê-lo na conversa
- O lembrete por e-mail a um visitante do site é enviado ao fim de cerca de 5 minutos de inatividade. A ligação funciona durante 30 dias
- Uma mensagem própria que elimine no Tillor (Messenger e Instagram) desaparece apenas no Tillor, não no cliente

</Callout>

## Como tudo se liga? [#hoe-hangt-dit-samen]

Cada canal é instalado em separado. Depois, todas as conversas ficam na mesma lista, e o Tillor associa-as, sempre que possível, a um cliente.

```mermaid
flowchart LR
  W[WhatsApp] --> I[Inbox]
  M[Messenger] --> I
  G[Instagram] --> I
  C[Chat no teu site] --> I
  I --> K[Cliente associado por telefone ou nome]
  I --> A[Tillie responde ou transfere]
  A --> T[A tua equipa]
  I --> T
  T -->|resposta| W
  T -->|resposta| M
  T -->|resposta| G
  T -->|resposta| C
```

- A sua equipa responde no Tillor. A resposta volta ao cliente pelo mesmo canal.
- A Tillie, a assistente de IA, pode responder e transferir uma conversa para a sua equipa. Decide isso por conversa.
- As respostas que enviar fora do Tillor, por exemplo na aplicação WhatsApp Business, também aparecem na conversa.

## Ligar canais [#kanalen-koppelen]

Instale uma integração por canal em <UIPath>Definições > Integrações</UIPath>.

<Cards>
  <Card title="Chat do website" href="/inbox/website-chat" description="Botão de chat no seu próprio site, sem conta externa" />
  <Card title="WhatsApp Business" href="/inbox/whatsapp-business-inbox" description="Ligar um número de WhatsApp através da Meta" />
  <Card title="Messenger" href="/inbox/messenger" description="Ligar uma página do Facebook através da Meta" />
  <Card title="Instagram" href="/inbox/instagram" description="Ligar o Instagram Direct através da Meta" />
  <Card title="Assistente de IA da caixa de entrada" href="/inbox/inbox-ai-assistant" description="A Tillie responde e transfere em todos os canais" />
</Cards>

No Messenger, o Tillor importa as conversas existentes da página ao ligar. Se o Messenger já estiver ligado, também pode iniciar essa sincronização manualmente a partir da caixa de entrada.

## Trabalhar no dia a dia [#dagelijks-werken]

<Cards>
  <Card title="Ler e responder a conversas" href="/inbox/gesprekken" description="Responder, arquivar, etiquetas e notificações" />
  <Card title="Conversas pelo chat do website" href="/inbox/website-chat-gesprekken" description="O que vê de um visitante do site" />
</Cards>

## Permissões [#rechten]

| Permissão | O que pode fazer o utilizador? |
|-----------|------------------------|
| **Ver caixa de entrada** | Abrir a caixa de entrada e ler conversas |
| **Gerir caixa de entrada** | Enviar respostas, arquivar, restaurar e fixar conversas, marcá-las como não lidas e eliminar mensagens próprias no Tillor (Messenger e Instagram) |
| **Notificações de mensagens da caixa de entrada** | Receber notificações push de novas mensagens de clientes |

Defina as permissões em <UIPath>Definições > Utilizadores</UIPath>.

## Conceitos [#begrippen]

- **Conversa ou fio**: todas as mensagens com um cliente ou visitante num canal.
- **Abertas e Arquivadas**: os dois separadores da lista de conversas. Arquivar tira uma conversa de **Abertas**, restaurar repõe-na.
- **Tillie**: o nome predefinido da assistente de IA na caixa de entrada. Pode alterar o nome.


Mais termos estão no [glossário](/begrippen).


# Instagram (/pt-PT/inbox/instagram)

Com o **Instagram** recebe mensagens do Instagram Direct na [caixa de entrada do Tillor](/inbox). A integração usa uma **página do Facebook** ligada com uma **conta profissional do Instagram** no Meta Business Suite.

Antes de começar:

- Precisa da permissão **Gerir integrações**.
- A sua conta de Instagram é uma conta profissional (Business ou Creator), ligada a uma página do Facebook.

## Instalar a integração [#integratie-installeren]

1. Aceda a **Definições** (barra lateral, em **Apoio**)

<DocScreenshot src="/screenshots/communicatie/providers/instagram/marketplace-nav.png" alt="Navegação para Definições" />

2. Escolha **Integrações** e abra **Instagram** na lista (marcação **2**)

<DocScreenshot src="/screenshots/communicatie/providers/instagram/marketplace-instagram.png" alt="Definições > Integrações - Instagram na lista" />

3. Clique em **Instalar** (marcação **1**) e conclua o fluxo OAuth da Meta (permissões de mensagens do Instagram)

<DocScreenshot src="/screenshots/communicatie/providers/instagram/instagram-install.png" alt="Detalhe do Instagram - Instalar" />

4. Escolha a **página do Facebook** ligada à sua conta profissional do Instagram
5. Verifique o campo **Nome de utilizador do Instagram** por baixo da escolha da página (o Tillor mostra a conta ligada, por exemplo `@uwaccount`)
6. Guarde as definições

Sem uma conta profissional do Instagram ligada à página selecionada, o Tillor não consegue concluir a integração.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- Depois da instalação, as mensagens recebidas do Instagram Direct chegam sozinhas à [caixa de entrada](/inbox).
- As respostas enviadas pela aplicação Instagram também aparecem na caixa de entrada. As mensagens que enviar pelo Tillor não são mostradas em duplicado.
- Se mesmo assim não chegarem mensagens, contacte o suporte do Tillor. A ligação do Instagram à Meta tem de estar configurada para toda a plataforma.
- Messenger e Instagram são integrações separadas. Se quiser os dois canais na caixa de entrada, instale ambos.

## Problemas? [#problemen]

### A ligação falha ou não há Instagram na página [#koppelen-mislukt-of-geen-instagram-op-de-pagina]

Se a instalação parar com *Não foi possível ligar a aplicação* ou *Sem conta profissional do Instagram*, verifique na Meta:

1. **Instagram profissional** - a sua conta de Instagram tem de ser Business ou Creator (não uma conta pessoal).
2. **Ligar a página** - no [Meta Business Suite](https://business.facebook.com/) ou nas Definições da empresa: ligue a conta de Instagram à **página do Facebook** com que inicia sessão.
3. **Acesso às mensagens** - na aplicação Instagram: **Definições** > **Mensagens e respostas a stories** > **Ferramentas ligadas** > permita o acesso às mensagens (necessário para o Direct em aplicações de caixa de entrada).
4. **Início de sessão correto na Meta** - use uma conta que seja **administradora** da página do Facebook com permissões de mensagens.


Na instalação, o Tillor procura todas as páginas do Facebook da sua conta e escolhe a primeira página com uma conta profissional do Instagram ligada. Se tiver várias páginas, depois da instalação pode escolher outra nas definições da integração.

<Callout type="info" title="Para o leitor técnico">
Na instalação, o Tillor pede sempre as permissões `instagram_basic`, `instagram_manage_messages` e `pages_read_engagement`. Coloque-as primeiro em **Ready for testing** em **Use cases** (Messenger/Instagram) na Meta Developer Console. **Invalid Scopes** significa que ainda não estão na aplicação da Meta. As permissões `instagram_business_*` pertencem a outro método de início de sessão e não servem para o Tillor.
</Callout>

## Relacionado [#gerelateerd]

<Cards>
  <Card title="Caixa de entrada" href="/inbox" description="Ler e responder a conversas" />
  <Card
    title="Messenger"
    href="/inbox/messenger"
    description="Ligar o Facebook Messenger à caixa de entrada"
  />
  <Card
    title="WhatsApp Business"
    href="/inbox/whatsapp-business-inbox"
    description="Ligar um número de WhatsApp à caixa de entrada"
  />
</Cards>


# Messenger (/pt-PT/inbox/messenger)

Com o **Messenger** recebe mensagens de clientes, através de uma página do Facebook ligada, na [caixa de entrada do Tillor](/inbox).

Antes de começar:

- Precisa da permissão **Gerir integrações**.
- Inicia sessão na Meta com uma conta que seja administradora da página do Facebook.

## Instalar a integração [#integratie-installeren]

1. Aceda a **Definições** (barra lateral, em **Apoio**)

<DocScreenshot src="/screenshots/communicatie/providers/messenger/marketplace-nav.png" alt="Navegação para Definições" />

2. Escolha **Integrações** e abra **Messenger** na lista (marcação **2**)

<DocScreenshot src="/screenshots/communicatie/providers/messenger/marketplace-messenger.png" alt="Definições > Integrações - Messenger na lista" />

3. Clique em **Instalar** (marcação **1**) e conclua o fluxo OAuth da Meta

<DocScreenshot src="/screenshots/communicatie/providers/messenger/messenger-install.png" alt="Detalhe do Messenger - Instalar" />

4. Na página de detalhe, escolha qual a **página do Facebook** que recebe as mensagens do Messenger
5. Guarde as definições

O Tillor mostra a página ligada em **Definições**, na página de detalhe. Depois da instalação, o Tillor recebe automaticamente as mensagens recebidas do Messenger. As respostas que enviar também pela aplicação Messenger aparecem na caixa de entrada. As mensagens que enviar pelo Tillor não são mostradas em duplicado.

Para o **Instagram Direct** instale a integração separada [Instagram](/inbox/instagram).

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- O Tillor importa as conversas existentes da página. Mais tarde, também pode iniciar essa sincronização a partir da caixa de entrada.
- As mensagens novas chegam sozinhas à [caixa de entrada](/inbox). O Tillor associa-as a um cliente com o mesmo nome, ou por um número de telefone ou endereço de e-mail que o cliente partilhe na conversa.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não chegam mensagens">
Verifique em <UIPath>Definições > Integrações > Messenger</UIPath> se foi escolhida a **página do Facebook** correta e se as definições foram guardadas.
</Accordion>
<Accordion title="Uma conversa não está associada a um cliente">
A Meta não transmite endereço de e-mail nem número de telefone através do Messenger. O Tillor só associa por um nome correspondente ou por dados que o próprio cliente partilhe.
</Accordion>
</Accordions>

## Relacionado [#gerelateerd]

<Cards>
  <Card title="Caixa de entrada" href="/inbox" description="Ler e responder a conversas" />
  <Card
    title="Instagram"
    href="/inbox/instagram"
    description="Ligar o Instagram Direct à caixa de entrada"
  />
  <Card
    title="WhatsApp Business"
    href="/inbox/whatsapp-business-inbox"
    description="Ligar um número de WhatsApp à caixa de entrada"
  />
</Cards>


# Conversas pelo chat do website (/pt-PT/inbox/website-chat-gesprekken)

Uma conversa aparece na caixa de entrada assim que o visitante envia a primeira mensagem, com o canal **Chat do website**. Como reage está em [Ler e responder a conversas](/inbox/gesprekken). Esta página explica o que há a mais no chat do website.

<DocScreenshot src="/screenshots/communicatie/inbox/inbox-conversation-website.png" alt="Caixa de entrada - chat do website com detalhes da conversa" />

No painel lateral à direita há um botão **Abrir no website** com a página onde o visitante esteve ativo pela última vez, além de dados do visitante e da sessão. Os campos extra do formulário do visitante também aparecem aí.

## Quem é o visitante? [#wie-is-de-bezoeker]

- O Tillor reconhece um visitante pelo seu navegador. O mesmo navegador no mesmo dispositivo abre, portanto, a mesma conversa.
- Nome, e-mail e telefone do formulário do visitante ficam guardados nesse navegador depois da primeira mensagem. Se o visitante voltar mais tarde, não tem de preencher nada de novo.
- Se esse armazenamento estiver vazio, por exemplo noutro navegador ou após uma limpeza, o widget completa os dados a partir da conversa existente.
- As mensagens são texto até 4096 caracteres. Imagens e ficheiros não são suportados.

## Escrita e presença [#typen-en-aanwezigheid]

| O quê | Quem vê | Onde |
|-----|--------------|------|
| **A escrever…** enquanto o visitante escreve | A sua equipa | Por baixo da conversa na caixa de entrada, mesmo antes da primeira mensagem |
| **A escrever…** enquanto um colega escreve | O visitante | No widget |
| **Online** (ponto verde) ou **Visto pela última vez** com uma hora | A sua equipa | Por cima da conversa |

O visitante conta como online enquanto o separador estiver visível. O widget envia um sinal de vida cerca de cada 20 segundos. Obter mensagens, escrever e ler também contam como atividade.

## Vistos [#vinkjes]

Os visitantes veem vistos nas suas próprias mensagens:

| Vistos | Significado |
|---------|-----------|
| Um | Enviada |
| Dois cinzentos | A sua equipa abriu a conversa e carregou as mensagens |
| Dois azuis | A sua equipa marcou a conversa como lida |

Na caixa de entrada vê vistos nas suas próprias respostas:

| Vistos | Significado |
|---------|-----------|
| Um | Enviada |
| Dois cinzentos | O visitante está na página e obteve as mensagens, mesmo com o chat fechado |
| Dois azuis | O visitante tem a janela de chat aberta |

As respostas da caixa de entrada aparecem automaticamente no widget, mesmo que o visitante abra a janela mais tarde.

## Atividade do visitante na conversa [#bezoekersactiviteit-in-het-gesprek]

Depois da primeira mensagem, a sua equipa vê texto informativo a cinzento na conversa. O visitante não o vê. Estas linhas não aumentam nenhum contador de não lidas nem geram notificação push.

| Evento | Texto na caixa de entrada |
|-------------|-------------------|
| Chat fechado | Utilizador fechou o chat |
| Outro separador ou janela minimizada | Utilizador mudou de separador ou minimizou o navegador |
| Outra página aberta | Utilizador navegou para o URL da página |

A navegação também é detetada em sites que mudam de página internamente sem recarregar. O widget transmite a página atual cerca de cada 20 segundos, para que o painel lateral mostre a última página ativa.

## Tillie no chat do website [#tillie-op-website-chat]

A Tillie, a assistente de IA, também funciona no widget. Para isso, instale o **Assistente de IA da caixa de entrada** em separado. A instalação, a base de conhecimento e o comportamento estão em [Assistente de IA da caixa de entrada (Tillie)](/inbox/inbox-ai-assistant). As mensagens da Tillie recebem no widget um robozinho em vez do logótipo da organização.

<Callout type="info" title="A primeira mensagem">
Assim que o visitante escreve, a sua equipa pode ver **A escrever…**. A primeira mensagem só segue ao clicar em **Enviar**, juntamente com os dados de contacto preenchidos.
</Callout>

## Ver também [#zie-ook]

<Cards>
  <Card title="Ler e responder a conversas" href="/inbox/gesprekken" description="Responder, arquivar, etiquetas" />
  <Card title="Definições do chat do website" href="/inbox/website-chat-instellingen" description="Widget e formulário do visitante" />
  <Card title="API do chat do website" href="/ontwikkelaars/website-chat" description="Criar uma interface de chat própria" />
</Cards>


# Definições do chat do website (/pt-PT/inbox/website-chat-instellingen)

Encontra as definições em <UIPath>Definições > Integrações > Chat do website</UIPath>. Instalar e colocar o fragmento de código está em [Pôr o chat no seu website](/inbox/website-chat).

## Widget [#widget]

| Campo | O que faz? |
|------|---------------|
| **Widget ativo** | Oculta o chat em todo o lado sem remover a integração. Ligado por predefinição |
| **Mostrar nas páginas públicas Tillor** | Mostra o botão de chat nas páginas públicas do Tillor, como o passe de acesso, a fatura em aberto e o mapa público. O seu próprio site usa o fragmento de código. Ligado por predefinição |
| **Mensagem de boas-vindas** | Texto no cabeçalho do chat e antes da primeira mensagem do visitante. Máximo de 500 caracteres. Se ficar vazio, usa um texto predefinido no idioma do widget |
| **Dica do botão flutuante** | Etiqueta do botão flutuante, pensada para leitores de ecrã. Máximo de 80 caracteres |
| **Mensagem de resposta breve** | Linha por baixo do nome da organização no cabeçalho do chat, por exemplo "Normalmente respondemos depressa" |
| **Ícone do botão flutuante** | Ícone no botão de chat: **Balão de fala**, **Chat arredondado**, **Ponto de interrogação**, **Pesquisar** ou **Pessoa** |
| **Cor de destaque** | Cor do botão de chat e das mensagens do visitante. Escolha uma cor ou introduza um valor hexadecimal, por exemplo `#2563eb` |
| **Domínios permitidos** | Nomes de anfitrião separados por vírgulas que podem carregar o chat. Vazio significa: qualquer domínio |
| **Enviar e-mail aos visitantes sobre respostas não lidas** | Veja [abaixo](#herinnering-per-e-mail). Ligado por predefinição |

O cabeçalho do chat mostra automaticamente o logótipo da sua organização. As mensagens da assistente de IA recebem um robozinho em vez desse logótipo. Nenhum dos dois é configurável em Chat do website.

<Callout type="info" title="Que idioma recebe o visitante?">
Se não definir **Mensagem de boas-vindas**, **Dica do botão flutuante** ou **Mensagem de resposta breve**, o widget usa um texto predefinido no seu próprio idioma. Esse idioma define-o no fragmento de código com `data-locale` (veja [Opções no fragmento de código](#opties-op-het-snippet)).
</Callout>

## Formulário do visitante [#bezoekersformulier]

Aqui define o que o visitante preenche antes da primeira mensagem. Se houver campos obrigatórios, aparecem juntamente com o campo da mensagem num único ecrã. O visitante preenche tudo e clica em **Enviar**, sem passo intermédio.

### Campos predefinidos [#standaardvelden]

| Campo | O que faz? |
|------|---------------|
| **Nome obrigatório** | Os visitantes preenchem o nome. O nome fica guardado na conversa |
| **E-mail obrigatório** | Os visitantes preenchem o endereço de e-mail. O endereço fica guardado na conversa |
| **Telefone obrigatório** | Os visitantes preenchem um número de telefone. O Tillor converte-o para um formato fixo e usa-o para associar a conversa a chamadas e clientes |

Cada campo está ligado ou desligado em separado. Se só o telefone estiver ligado, o visitante vê apenas o campo de telefone.

### Campos extra [#extra-velden]

Clique em **Adicionar campo** para perguntas próprias. Pode adicionar no máximo 8 campos extra. Remova um campo com **Remover campo**.

| Opção | Explicação |
|-------|--------|
| **Etiqueta do campo** | O que o visitante vê no widget. Máximo de 80 caracteres |
| **Chave do campo** | Nome interno do campo. Comece com uma letra minúscula e use apenas letras minúsculas, algarismos e `_` (máximo de 32 caracteres) |
| **Tipo de campo** | **Texto** ou **E-mail** |
| **Obrigatório** | O visitante tem de preencher o campo antes de poder conversar. Um campo novo é obrigatório por predefinição |
| **Texto de exemplo** | Sugestão no campo de entrada. Máximo de 120 caracteres |

As respostas aos campos extra aparecem na caixa de entrada, na conversa, ao lado do canal e do ID do visitante.

## Lembrete por e-mail [#herinnering-per-e-mail]

Os visitantes fecham muitas vezes a página antes de a sua equipa ou a Tillie responder. Com **Enviar e-mail aos visitantes sobre respostas não lidas**, o visitante recebe um e-mail com o botão **Continuar a conversa** assim que houver uma resposta que não leu.

- O visitante tem de ter indicado um endereço de e-mail, através do formulário do visitante ou preenchido previamente. Sem endereço, não acontece nada.
- O e-mail só é enviado quando o visitante está inativo há cerca de 5 minutos. Por cada série de respostas não lidas, recebe um e-mail.
- O botão abre o chat e retoma a conversa, mesmo noutro dispositivo ou noutro navegador. A ligação funciona durante 30 dias.
- O visitante também pode responder diretamente ao e-mail. Essa resposta aparece na mesma conversa na caixa de entrada, com um pequeno ícone de envelope na mensagem.
- As respostas da Tillie contam, tal como as da sua equipa.

## Opções no fragmento de código [#opties-op-het-snippet]

Além de `data-org-id` e `data-widget-key`, pode colocar atributos opcionais no script. Destina-se a quem coloca o fragmento de código no site.

| Atributo | O que faz? |
|-----------|---------------|
| `data-locale` | Idioma do widget: `en`, `nl`, `de`, `fr`, `pt` ou `ro`, eventualmente com região como `nl-BE`. Predefinição `en`; outro idioma recorre ao inglês. A região define o formato de data e hora |
| `data-accent-color` | Cor de destaque para esta página como hexadecimal de 6 algarismos. Prevalece sobre a cor em **Definições** |
| `data-messages` | Objeto JSON para ajustar textos individuais, por exemplo `{"send":"Versturen","messagePlaceholder":"Typ uw bericht…"}` |
| `data-sounds` | `false` desliga os sons em novas respostas da equipa e ao enviar. Ligado por predefinição |
| `data-launcher` | `false` oculta o botão de chat flutuante. Depois abre o chat com o seu próprio botão através do [SDK do widget](/ontwikkelaars/website-chat#widget-sdk) |
| `data-visitor` | Objeto JSON para preencher previamente nome, e-mail e telefone, por exemplo `{"name":"Jan","email":"jan@voorbeeld.nl","phone":"+32470123456"}` |
| `data-visitor-name`, `data-visitor-email`, `data-visitor-phone` | Preenche previamente um desses campos |
| `data-debug` | `true` mostra linhas de registo na consola do navegador |

Os atributos só completam campos vazios. Se o visitante já tiver preenchido dados neste navegador, esses mantêm-se.

Um exemplo com textos em neerlandês:

```html
<script
  src="https://tillor.eu/inbox-widget.js"
  data-org-id="org_abc123"
  data-widget-key="iwk_xxx"
  data-locale="nl"
  async
  defer
></script>
```

Também é possível ativar o debug sem alterar o fragmento de código: execute na consola do navegador `localStorage.setItem('tillor-inbox-debug', '1')` e atualize a página.

## Proteção contra spam [#spambeveiliging]

O widget não usa captcha. O Tillor protege o envio com a chave do widget e com **Domínios permitidos**. Se o seu formulário de contacto tiver um captcha próprio, pode mantê-lo como camada adicional.

## Condições para visitantes [#voorwaarden-voor-bezoekers]

Por baixo do campo da mensagem há um breve aviso de que, ao enviar, o visitante concorda com as [condições do chat do website](https://tillor.eu/chat-terms). A ligação abre num novo separador e segue o idioma de `data-locale`.

## Ver também [#zie-ook]

<Cards>
  <Card title="Pôr o chat no seu website" href="/inbox/website-chat" description="Instalar e colocar o fragmento de código" />
  <Card title="Conversas pelo chat do website" href="/inbox/website-chat-gesprekken" description="O que vê você e o visitante" />
  <Card title="API do chat do website" href="/ontwikkelaars/website-chat" description="SDK do widget e interface de chat própria" />
</Cards>


# Pôr o chat no seu website (/pt-PT/inbox/website-chat)

Com a integração Chat do website, o seu site ganha um botão de chat. As mensagens dos visitantes chegam à [caixa de entrada](/inbox), junto com WhatsApp, Messenger e Instagram.

<Requires permission="Integraties beheren" />

<Steps>
<Step>
### Instale a integração [#installeer-de-integratie]
Aceda a <UIPath>Definições > Integrações</UIPath> e abra **Chat do website**. Clique em **Instalar**. Não é preciso ligar a uma conta externa; o Tillor cria a chave do widget por si.
</Step>
<Step>
### Configure o widget [#stel-de-widget-in]
Em **Definições**, na mesma página, preencha pelo menos a **Mensagem de boas-vindas** e a **Cor de destaque**. Preencha também **Domínios permitidos** para que só o seu site possa carregar o chat. Todas as opções estão em [Definições do chat do website](/inbox/website-chat-instellingen).
</Step>
<Step>
### Copie o fragmento de código [#kopieer-het-snippet]
Em **Incorporar no seu website**, clique em **Copiar fragmento**. Se o bloco não aparecer, guarde as definições e atualize a página.
</Step>
<Step>
### Cole o fragmento de código no seu site [#plak-het-snippet-op-je-site]
Cole o fragmento de código antes da etiqueta de fecho `</body>` em cada página onde o botão de chat deva aparecer. Num site com um modelo ou rodapé partilhado, coloque-o uma só vez nesse modelo.
</Step>
</Steps>

## O que vê depois? [#wat-zie-je-daarna]

Abra o seu site. Em baixo à direita há um botão de chat. Envie você mesmo uma mensagem de teste: a conversa aparece na caixa de entrada com o canal **Chat do website**. A explicação do que você e o visitante veem está em [Conversas pelo chat do website](/inbox/website-chat-gesprekken).

<Callout type="info" title="A chave do widget é pública">
A chave está legível no fragmento de código, como noutros produtos de chat. Limite abusos com **Domínios permitidos** (nomes de anfitrião separados por vírgulas, por exemplo `recreatiepark-het-meer.be, www.recreatiepark-het-meer.be`). Se deixar o campo vazio, o chat funciona em qualquer domínio onde o fragmento de código esteja.
</Callout>

## Chat nas páginas públicas Tillor [#chat-op-publieke-tillor-paginas]

Se o **Chat do website** estiver instalado, **Widget ativo** estiver ligado e **Mostrar nas páginas públicas Tillor** estiver ligado, o botão de chat também aparece nas páginas públicas da sua organização. Aí não precisa de colocar nenhum fragmento de código. Trata-se, entre outras, das páginas do passe de acesso, de uma fatura em aberto, de uma etiqueta NFC, dos dados da organização e do mapa público.

- Nessas páginas, o Tillor usa a **Cor de destaque** das definições.
- **Domínios permitidos** aplica-se apenas ao seu próprio website, não às páginas do Tillor.
- Se desligar **Widget ativo**, o botão desaparece em todo o lado. Se desligar apenas **Mostrar nas páginas públicas Tillor**, o chat continua a funcionar no seu próprio site.

## Desligar o chat temporariamente [#de-chat-tijdelijk-uitzetten]

Desligue **Widget ativo** em <UIPath>Definições > Integrações > Chat do website</UIPath>. A integração continua instalada e a chave do widget não muda. Volte a ligar o interruptor para repor o chat.

## Problemas? [#problemen]

<Accordions>
<Accordion title="O botão de chat não aparece no meu site">
Verifique primeiro se **Widget ativo** está ligado. Se houver uma lista em **Domínios permitidos**, veja se o nome de anfitrião da página consta nela, incluindo `www.` se o seu site funcionar com isso. Verifique também se o fragmento de código está mesmo nessa página e não apenas num modelo que essa página não usa.
</Accordion>
<Accordion title="O fragmento de código de incorporação não carrega nas definições">
O Tillor mostra então a mensagem de que não foi possível carregar o fragmento de código. Guarde as definições e atualize a página.
</Accordion>
<Accordion title="O chat está nas páginas do Tillor, mas não no meu site">
Nas páginas do Tillor não é preciso fragmento de código. O seu próprio site só mostra o chat com o fragmento de código do passo 3.
</Accordion>
<Accordion title="Quero ligar um formulário de contacto próprio ou substituir o botão">
Isso trata-o um programador com o SDK do widget. Veja [API do chat do website](/ontwikkelaars/website-chat).
</Accordion>
<Accordion title="Um visitante vê Enviou muitas mensagens em pouco tempo">
O Tillor limita o que um visitante envia pelo chat, para que um script não consiga inundar a tua caixa de entrada e as respostas da Tillie: 10 mensagens por minuto e 200 por dia por visitante, e 30 por minuto e 600 por dia para todos na mesma rede em conjunto (como o wifi do teu parque de campismo). Anexos: 10 por hora por visitante e 50 por hora por rede. Passado um minuto o visitante pode continuar; nenhuma mensagem já enviada se perde.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Definições do chat do website" href="/inbox/website-chat-instellingen" description="Todos os campos e opções de incorporação" />
  <Card title="Conversas pelo chat do website" href="/inbox/website-chat-gesprekken" description="O que vê você e o visitante" />
  <Card title="API do chat do website" href="/ontwikkelaars/website-chat" description="Ligar um formulário ou uma interface de chat própria" />
  <Card title="Assistente de IA da caixa de entrada" href="/inbox/inbox-ai-assistant" description="Deixar a Tillie responder" />
</Cards>


# WhatsApp Business (/pt-PT/inbox/whatsapp-business-inbox)

Com o **WhatsApp Business** recebe e responde a mensagens de clientes por WhatsApp na [caixa de entrada do Tillor](/inbox). Isto **não** é o mesmo que as notificações de WhatsApp através da Twilio.

<Callout type="info">
Para mensagens automáticas de WhatsApp (notificações), veja [Twilio](/communicatie/providers/twilio). A aplicação do marketplace **WhatsApp Business** serve apenas para conversas da caixa de entrada.
</Callout>

Antes de começar:

- Precisa da permissão **Gerir integrações**.
- Tem uma conta WhatsApp Business na Meta e inicia sessão com uma conta que a gere.

## Instalar a integração [#integratie-installeren]

1. Aceda a **Definições > Integrações**
2. Abra **WhatsApp Business** na lista (marcação **2**)

<DocScreenshot src="/screenshots/communicatie/providers/whatsapp-business-inbox/marketplace-whatsapp.png" alt="Definições > Integrações - WhatsApp Business na lista" />

3. Clique em **Instalar** (marcação **1**) e conclua o fluxo OAuth da Meta

<DocScreenshot src="/screenshots/communicatie/providers/whatsapp-business-inbox/whatsapp-install.png" alt="Detalhe do WhatsApp Business - Instalar" />

4. Escolha qual o **número de WhatsApp** que recebe as mensagens da caixa de entrada
5. Guarde as definições

Depois da instalação, o Tillor recebe automaticamente as mensagens recebidas. As respostas que enviar também pela aplicação WhatsApp Business ou por um dispositivo ligado aparecem na caixa de entrada. As mensagens que enviar pelo Tillor não são mostradas em duplicado.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- As mensagens recebidas aparecem sozinhas na [caixa de entrada](/inbox), associadas ao cliente com o mesmo número de telefone.
- As respostas envia-as no Tillor. Fora da janela de 24 horas seguem como modelo pago, veja [Ler e responder a conversas](/inbox/gesprekken#whatsapp-en-het-antwoordvenster-van-24-uur).

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não chegam mensagens">
Verifique em <UIPath>Definições > Integrações > WhatsApp Business</UIPath> se foi escolhido o **número de WhatsApp** correto e se as definições foram guardadas.
</Accordion>
<Accordion title="As minhas respostas não saem fora da janela de resposta">
Adicione um método de pagamento à sua conta WhatsApp Business no Meta WhatsApp Manager. Sem método de pagamento, o Tillor bloqueia as respostas pagas.
</Accordion>
</Accordions>

## Relacionado [#gerelateerd]

<Cards>
  <Card title="Caixa de entrada" href="/inbox" description="Ler e responder a conversas" />
  <Card title="Messenger" href="/inbox/messenger" description="Facebook Messenger para a caixa de entrada" />
</Cards>


# Visão geral (/pt-PT/integraties)

Uma integração liga o Tillor a outro serviço, por exemplo para pagamentos, contabilidade, telefonia, câmaras ou a sua ficha do Google. Gere-as todas em <UIPath>Definições > Integrações</UIPath>. Como instalar uma está em [Instalar uma integração](/integraties/integratie-installeren).

<Requires permission="Integraties bekijken" />

## Como tudo se liga? [#hoe-hangt-dit-samen]

Uma integração pertence a toda a sua organização, não a um único utilizador. Depois de instalada, a ligação funciona onde é necessária: a ligação de câmaras nos pontos de acesso, a ligação de e-mail no perfil do cliente, a ligação de pagamentos nas faturas. Algumas ligações passam pelo conector, um pequeno programa num computador da sua própria rede. Esse tem então de estar online.

```mermaid
flowchart LR
  A[Definições > Integrações] --> B[Instalar integração]
  B --> C[Pagamentos e faturas]
  B --> D[Perfil do cliente e caixa de entrada]
  B --> E[Pontos de acesso e câmaras]
  E -. através de .-> F[Conector na sua rede]
```

<Callout type="info" title="Bom saber">
- Ver é possível com a permissão **Ver integrações**. Instalar, alterar e desinstalar exige **Gerir integrações**.
- Desinstalar não pode ser desfeito. Depois, volta a instalar a integração e preenche novamente os dados.
- A Partoo recebe o seu horário de funcionamento dos próximos 90 dias e uma atualização todas as noites. Veja [Partoo](/integraties/partoo).
- Os pagamentos feitos há mais de 24 horas deixam de receber sobreposição de câmara. Veja [UniFi Protect](/integraties/unifi-protect).
- As integrações que vê dependem da sua organização. Falta alguma? Pergunte ao seu administrador do Tillor ou ao suporte.
</Callout>

## Integrações disponíveis [#beschikbare-integraties]

| Integração | Para quê | Explicação |
|---|---|---|
| Mollie | Pagamentos online e por terminal, débito direto SEPA | [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie) |
| Contas bancárias | Importar transações bancárias e associá-las a faturas | [Ponto e contas bancárias](/boekhouden/betalingsrapporten/betaalmethodes/ponto) |
| Admisol | Enviar relatórios de pagamentos para a sua contabilidade | [Admisol](/boekhouden/betalingsrapporten/boekhoudsystemen/admisol) |
| Odoo | Exportar clientes e faturas para o Odoo | [Odoo](/boekhouden/betalingsrapporten/boekhoudsystemen/odoo) |
| ICY | Ler contadores | [Gestão de contadores](/meterbeheer) |
| Voys | Associar chamadas telefónicas a clientes | [Voys](/communicatie/providers/voys) |
| WhatsApp Business | Mensagens de WhatsApp na caixa de entrada | [WhatsApp Business](/inbox/whatsapp-business-inbox) |
| Messenger | Conversas do Facebook Messenger na caixa de entrada | [Messenger](/inbox/messenger) |
| Instagram | Conversas do Instagram Direct na caixa de entrada | [Instagram](/inbox/instagram) |
| Chat do website | Chat em direto no seu website | [Chat do website](/inbox/website-chat) |
| Assistente de IA da caixa de entrada | Responder automaticamente a perguntas frequentes | [Assistente de IA da caixa de entrada](/inbox/inbox-ai-assistant) |
| UniFi Protect | Ligar câmaras a pontos de acesso e pagamentos | [UniFi Protect](/integraties/unifi-protect) |
| Partoo | Manter o horário de funcionamento igual no Google e noutras fichas | [Partoo](/integraties/partoo) |
| Outlook | Ver o e-mail de um cliente no perfil do cliente | [Outlook](/integraties/outlook) |

## Conceitos [#begrippen]

- **Integração**: uma ligação entre o Tillor e um serviço externo.
- **Conector**: o programa na sua rede que liga ao Tillor dispositivos como câmaras e impressoras. Veja [Conector](/connector).
- **Instalar e desinstalar**: ativar ou remover uma ligação. Remover não pode ser revertido.
- **Chave de API**: um código secreto com que o Tillor pode trabalhar noutro serviço.
- **Sobreposição**: texto que corre sobre as imagens da câmara, por exemplo um pagamento.

Mais explicações estão no [glossário](/begrippen).

<Cards>
  <Card title="Instalar uma integração" href="/integraties/integratie-installeren" description="Procurar, preencher e ligar" />
  <Card title="UniFi Protect" href="/integraties/unifi-protect" description="Imagens de câmara em acessos e pagamentos" />
  <Card title="Partoo" href="/integraties/partoo" description="Enviar automaticamente o horário de funcionamento" />
  <Card title="Outlook" href="/integraties/outlook" description="E-mail do cliente no perfil do cliente" />
</Cards>


# Instalar uma integração (/pt-PT/integraties/integratie-installeren)

Instala uma integração em <UIPath>Definições > Integrações</UIPath>. Procura-a, preenche os dados do serviço externo e clica em **Instalar**. Depois, ajusta-a no bloco **Definições** ou remove-a com **Desinstalar**. O que está disponível encontra-se na [visão geral](/integraties).

<Requires permission="Gerir integrações" />

Antes de começar:

- Com apenas a permissão **Ver integrações**, vê a lista e as definições, mas não pode alterar nada.
- Tenha à mão as credenciais ou chaves do serviço externo. No Outlook, é reencaminhado para iniciar sessão no próprio serviço.
- Numa ligação que passa pelo connector, como o UniFi Protect, o connector tem de estar online.

## Instalar uma integração [#een-integratie-installeren]

<Steps>
<Step>
### Procure a integração [#zoek-de-integratie]
Utilize a barra de pesquisa ou escolha à esquerda, em **Integrações**, uma categoria: **Comunicação**, **Vigilância**, **Pagamentos**, **Contabilidade** ou **Contadores**. **Todas as integrações** mostra tudo. Uma integração já ligada tem a etiqueta **Ligado**.

<DocScreenshot src="/screenshots/integraties/integrations-overview.png" alt="Definições > Integrações com a lista de integrações" />
</Step>
<Step>
### Abra a integração [#open-de-integratie]
Clique nela. Algumas páginas têm no topo a ligação **Ver documentação**.
</Step>
<Step>
### Preencha os dados e clique em Instalar [#vul-de-gegevens-in-en-klik-op-installeren]
O que preenche varia consoante o serviço. No Outlook, é reencaminhado para o próprio serviço para iniciar sessão.
</Step>
</Steps>

## Ajustar ou remover [#aanpassen-of-verwijderen]

Depois de instalar, a mesma página mostra um bloco **Definições**. Ajuste aí a ligação e guarde. Com **Desinstalar** remove a ligação. Isto não pode ser anulado.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- A ligação funciona de imediato para toda a sua organização.
- O que a ligação faz vê-se no sítio a que pertence, por exemplo no perfil do cliente ou num ponto de acesso.
- Depois de **Desinstalar**, a ligação para. O que já está no outro serviço permanece lá.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Vejo Nenhuma integração encontrada">
Não há nenhuma integração que corresponda ao termo ou à categoria. Experimente outro termo ou escolha **Todas as integrações**. Se faltar uma integração que esperava, ela não está ativada para a sua organização. Peça ao apoio.
</Accordion>
<Accordion title="O botão Instalar está cinzento ou não aparece">
Não tem a permissão **Gerir integrações**. Fale com o seu administrador.
</Accordion>
<Accordion title="O Tillor diz Não foi possível ligar">
Não foi possível ligar a integração. Verifique os dados preenchidos e tente novamente.
</Accordion>
<Accordion title="O Tillor diz Não foi possível desligar">
Tente novamente. Se não resultar, escreva para support@tillor.eu.
</Accordion>
<Accordion title="O Tillor diz Falha ao atualizar as definições da aplicação">
A sua alteração não foi guardada. Tente guardar novamente.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Visão geral das integrações" href="/integraties" description="Todas as ligações disponíveis" />
  <Card title="Connector" href="/connector" description="O programa na sua rede" />
</Cards>


# Ligar o Outlook (/pt-PT/integraties/outlook)

Com a ligação ao Outlook, vê no perfil do cliente os e-mails que a sua organização trocou com esse cliente. O Tillor obtém-nos em direto do Outlook e não os guarda.

<Requires permission="Gerir integrações" />

Antes de começar:

- Precisa de uma conta Microsoft cujo correio o Tillor possa ler.
- Para ver o correio no perfil do cliente, precisa da permissão **Ver caixa de entrada**. Sem ela, o separador **Outlook** não aparece.

## Instalar [#installeren]

<Steps>
<Step>
### Abra a integração [#open-de-integratie]
Vá a <UIPath>Definições > Integrações > Outlook</UIPath>.
</Step>
<Step>
### Clique em Instalar [#klik-op-installeren]
É reencaminhado para a Microsoft.
</Step>
<Step>
### Inicie sessão e dê autorização [#log-in-en-geef-toestemming]
Inicie sessão com a conta cujo correio o Tillor pode ler.

<DocScreenshot src="/screenshots/integraties/integrations-outlook.png" alt="Instalar o Outlook" />
</Step>
</Steps>

Depois de ligar, vê em **Definições** o nome, o endereço de e-mail e o nome de utilizador da conta ligada, e até quando a ligação está ativa.

## Escolher caixas de correio [#mailboxen-kiezen]

Por defeito, o Tillor pesquisa apenas na caixa de correio da conta ligada. Em **Caixas de correio** escolhe caixas adicionais, por exemplo uma caixa partilhada da receção.

- **Pessoal** é a caixa de correio da conta ligada.
- **Partilhada** são as caixas partilhadas a que essa conta tem acesso. O Tillor procura-as sozinho.
- **Adicionada manualmente** são endereços que escreve você. Escreva o endereço e escolha **Adicionar [endereço]**.

## Correio no perfil do cliente [#mail-op-het-klantprofiel]

No perfil do cliente aparece um separador **Outlook**, entre **Comunicação** e **Eventos**. O separador só existe se o Outlook estiver ligado e tiver a permissão **Ver caixa de entrada**.

- No topo vê o número de mensagens e as caixas de correio pesquisadas. Com **Atualizar** obtém o correio mais recente.
- O Tillor pesquisa pelo endereço de e-mail do cliente e dos seus contactos. Se ninguém tiver endereço de e-mail, aparece a indicação de que não há nada para pesquisar.
- Cada mensagem mostra o assunto, se foi **Recebida** ou **Enviada**, de quem para quem, e um clipe se tiver anexos. Clique numa mensagem para abrir o texto e os anexos. Com **Abrir no Outlook** vai para a mensagem no próprio Outlook.
- O mesmo e-mail presente em várias caixas de correio aparece uma só vez na lista.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- O Tillor apenas lê o correio e não guarda nada. Se remover a ligação, o separador **Outlook** desaparece do perfil do cliente.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Detalhes da conta indisponíveis">
O Tillor não conseguiu obter a conta Microsoft ligada. Atualize a página ou volte a ligar o Outlook com **Instalar**.
</Accordion>
<Accordion title="Volte a ligar para detetar caixas partilhadas">
O Outlook foi ligado antes de o Tillor poder procurar caixas partilhadas. Clique em **Voltar a ligar o Outlook**, ou escreva você o endereço da caixa partilhada.
</Accordion>
<Accordion title="Não foi possível carregar as caixas partilhadas">
Pode continuar a escrever manualmente um endereço de caixa de correio em **Adicionada manualmente**.
</Accordion>
<Accordion title="Correio do Outlook indisponível">
O Tillor não conseguiu carregar o correio do Outlook. Tente novamente com **Atualizar** ou verifique a ligação.
</Accordion>
<Accordion title="Não foi possível pesquisar algumas caixas de correio">
A conta ligada não tem acesso a essa caixa de correio. Verifique as permissões da caixa no Outlook.
</Accordion>
<Accordion title="Não vejo o separador Outlook no perfil do cliente">
O Outlook não está ligado, ou falta-lhe a permissão **Ver caixa de entrada**.
</Accordion>
<Accordion title="Não foi possível carregar esta mensagem">
Tente abrir a mensagem mais uma vez. Se não ajudar, vá à própria mensagem com **Abrir no Outlook**.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Gestão de clientes" href="/klantenbeheer" description="O perfil do cliente e os seus separadores" />
  <Card title="Integrações" href="/integraties" description="Todas as ligações disponíveis" />
</Cards>


# Ligar o Partoo (/pt-PT/integraties/partoo)

O Partoo gere as suas listagens no Google e noutros sítios. Com esta ligação, o Tillor envia o seu horário de funcionamento para o seu estabelecimento no Partoo, para que não tenha de o manter em dois sítios. Os horários em si gere-os no Tillor, veja [Definições da organização](/gebruikers/organisaties#openingsuren).

<Requires permission="Gerir integrações" />

Antes de começar:

- Crie no Partoo um utilizador próprio para o Tillor, sem autenticação em dois passos. Com autenticação em dois passos, o Tillor não consegue iniciar sessão.
- Preencha o seu horário de funcionamento no Tillor, veja o título Horário de funcionamento nas definições da organização.

## Instalar [#installeren]

<Steps>
<Step>
### Abra a integração [#open-de-integratie]
Vá a <UIPath>Definições > Integrações > Partoo</UIPath>.
</Step>
<Step>
### Preencha os dados do utilizador do Partoo [#vul-de-gegevens-van-de-partoo-gebruiker-in]
Preencha o **E-mail** e a **Palavra-passe** desse utilizador.
</Step>
<Step>
### Escolha o seu estabelecimento [#kies-je-vestiging]
A lista de estabelecimentos só aparece depois de preencher o e-mail e a palavra-passe. Em **Estabelecimento**, escolha o seu estabelecimento. Escreva em **Pesquisar estabelecimentos…** para procurar.
</Step>
<Step>
### Clique em Instalar [#klik-op-installeren]

<DocScreenshot src="/screenshots/integraties/integrations-partoo.png" alt="Instalar o Partoo" />
</Step>
</Steps>

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

O Tillor envia os seus horários semanais, épocas e dias excecionais a partir do [horário de funcionamento da sua organização](/gebruikers/organisaties#openingsuren):

- Os horários semanais são os da semana atual. O Partoo não conhece épocas, por isso o Tillor envia os horários da época que está em vigor.
- Os dias nos próximos 90 dias cujo horário difere, como outra época, um feriado ou uma exceção, seguem como datas separadas. Um período de encerramento torna-se um único período.
- O Tillor envia isto todas as noites e logo após cada alteração ao horário de funcionamento, ao fuso horário, ao país por defeito ou à própria ligação. Só é alterado o que difere do Partoo.

## Ajustar ou remover [#aanpassen-of-verwijderen]

Ajuste o e-mail, a palavra-passe ou o estabelecimento no bloco **Definições**. Deixe a palavra-passe vazia para manter a atual. Com **Desinstalar**, o reencaminhamento para. O que já está no Partoo permanece lá.

## Problemas? [#problemen]

<Accordions>
<Accordion title="O Partoo recusa este endereço de e-mail ou esta palavra-passe">
Verifique os dados do utilizador do Partoo. Se esse utilizador tiver a autenticação em dois passos ativa, desative-a ou crie um utilizador próprio.
</Accordion>
<Accordion title="Este utilizador do Partoo não vê nenhum estabelecimento">
No Partoo, dê ao utilizador acesso ao seu estabelecimento e volte a tentar.
</Accordion>
<Accordion title="Não foi possível carregar os estabelecimentos do Partoo">
Tente novamente daqui a pouco. Se persistir, escreva para support@tillor.eu.
</Accordion>
<Accordion title="Os horários no Google não estão certos">
Verifique primeiro o horário de funcionamento no Tillor, o fuso horário e o país por defeito. Após uma alteração, o Tillor envia-os de imediato, e novamente todas as noites.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Definições da organização" href="/gebruikers/organisaties" description="Horário de funcionamento, épocas e exceções" />
  <Card title="Integrações" href="/integraties" description="Todas as ligações disponíveis" />
</Cards>


# Ligar o UniFi Protect (/pt-PT/integraties/unifi-protect)

Com a ligação ao UniFi Protect, a partir de uma tentativa de acesso ou de um evento de ponto de acesso chega com um clique à gravação da câmara correspondente. Os pagamentos em numerário e por cartão podem ainda aparecer como texto sobre as imagens de uma câmara, para poder rever as imagens quando há uma diferença de caixa. A instalação é igual à de qualquer integração, veja [Instalar uma integração](/integraties/integratie-installeren).

<Requires permission="Gerir integrações" />

Antes de começar:

- As câmaras são lidas no seu parque através do [connector](/connector). Este tem de estar online. Se não estiver, o Tillor indica **O connector Tillor está offline ou inacessível.**
- Precisa dos dados da sua consola UniFi OS. É a caixa ou o servidor onde corre o UniFi Protect.
- Para a ligação com pontos de acesso, esses pontos de acesso têm de existir, veja [Controlo de acesso](/toegangscontrole).

## Instalar [#installeren]

<Steps>
<Step>
### Abra a integração [#open-de-integratie]
Vá a <UIPath>Definições > Integrações > UniFi Protect</UIPath>.
</Step>
<Step>
### Preencha a consola [#vul-de-console-in]
- **Anfitrião da consola**: o endereço IP local ou o nome de anfitrião da sua consola UniFi OS.
- **Chave API**: um código secreto que cria na consola, com o qual o Tillor pode ler as câmaras.
- **ID da consola na cloud**: o ID longo a seguir a `/consoles/` no URL unifi.ui.com da sua consola.
</Step>
<Step>
### Escolha as câmaras de pagamento [#kies-de-betaalcameras]
Em **Câmara de pagamentos em numerário** e **Câmara de pagamentos POS**, escolha uma câmara, ou deixe **Não registar**. POS é o terminal de pagamento por cartão.
</Step>
<Step>
### Clique em Instalar [#klik-op-installeren]
Assim que o anfitrião e a chave API estão preenchidos, o Tillor carrega as câmaras da consola.

<DocScreenshot src="/screenshots/integraties/integrations-unifi-protect.png" alt="Instalar o UniFi Protect" />
</Step>
</Steps>

## Associar câmaras a pontos de acesso [#cameras-koppelen-aan-toegangspunten]

Depois de instalar, o bloco **Definições** mostra a tabela **Câmaras dos pontos de acesso**. Associe cada **Ponto de acesso** a uma **Câmara**. Se a lista estiver vazia, adicione primeiro pontos de acesso.

Depois, nos detalhes de uma tentativa de acesso e de um evento de ponto de acesso aparece a ligação **Abrir no UniFi Protect**. Abre a gravação desse momento no UniFi Protect, num novo separador.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- Se escolheu uma câmara em **Câmara de pagamentos em numerário** ou **Câmara de pagamentos POS**, o Tillor envia para essa câmara cada pagamento que passa a **Pago**. Os pagamentos em numerário vão para a câmara de numerário, os pagamentos por cartão num terminal para a câmara POS.
- Os pagamentos efetuados há mais de 24 horas deixam de receber texto sobre as imagens.
- Os pagamentos através do Mollie só contam se pertencerem ao perfil principal do Mollie.
- Se alterar os dados, guarde. Se deixar a **Chave API** vazia, a chave existente continua a valer. Com **Desinstalar** remove a ligação.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Nenhuma câmara encontrada nesta consola UniFi Protect">
A consola não tem câmaras, ou a chave API não tem acesso a elas. Verifique a chave e se as câmaras estão visíveis no UniFi Protect.
</Accordion>
<Accordion title="Não foi possível obter câmaras do UniFi Protect">
Verifique o anfitrião, a chave API e se o connector está online. O Tillor indica: **Verifique o anfitrião, a chave API e o connector.**
</Accordion>
<Accordion title="O connector Tillor está offline ou inacessível">
As câmaras são carregadas através do connector na sua rede local. Inicie o connector ou restabeleça a ligação, veja [Connector](/connector).
</Accordion>
<Accordion title="Não vejo Abrir no UniFi Protect numa tentativa de acesso">
Não há nenhuma câmara associada a esse ponto de acesso. Associe uma na tabela **Câmaras dos pontos de acesso**.
</Accordion>
<Accordion title="O pagamento não aparece sobre as imagens">
Verifique se a câmara em **Câmara de pagamentos em numerário** ou **Câmara de pagamentos POS** não está em **Não registar**. Um pagamento efetuado há mais de 24 horas deixa de receber a sobreposição. Um pagamento do Mollie só conta no perfil principal.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Controlo de acesso" href="/toegangscontrole" description="Registo de acessos e pontos de acesso" />
  <Card title="Connector" href="/connector" description="A ligação à sua rede local" />
  <Card title="Integrações" href="/integraties" description="Todas as ligações disponíveis" />
</Cards>


# Mapa (/pt-PT/kaart)

Na planta vê num relance que parcelas estão livres, reservadas ou ocupadas, para cada dia que escolher. Também desenha aqui os limites das suas parcelas, para que o Tillor conheça a sua área, e mede distâncias. As próprias parcelas gere-as em [Parcelas](/terreinen).

<Callout type="info" title="Bom saber">
- O mapa abre sempre no dia de hoje. O seu estilo, etiquetas e camadas são guardados.
- Reservas com check-out efetuado e reservas canceladas não contam para a cor, a etiqueta de partida nem a reserva dupla.
- As etiquetas de noites e partida desaparecem abaixo do nível de zoom 17,5. O nome da parcela mantém-se.
- Uma parcela sem limite desenhado não aparece no mapa. Só pode desenhar com o **Modo de edição** ativado.
- O mapa abre no centro do mapa que define em **Definições > Mapa**. Esse mesmo ponto determina também a meteorologia.
</Callout>

## Abrir o mapa [#de-kaart-openen]

Vá a <UIPath>Parque > Mapa</UIPath>. Vê de imediato todas as parcelas com o seu estado de ocupação.


<DocScreenshot src="/screenshots/park/map-overview.png" alt="Mapa com a parcela 12 desenhada" />

- **Área verde** - parcela reservável e livre
- **Área cinzenta** - a parcela está **Não reservável** e não tem estadia ativa na data escolhida (sem reserva nem ocupação); faltam as etiquetas de noites e partida
- **Área ciano** - reserva **Reservada**, ainda sem check-in (também nos dias seguintes do período de estadia enquanto não houver check-in)
- **Área azul** - reserva **Check-in efetuado** (estadia ativa na data escolhida)
- **Área amarela** - a parcela tem uma ocupação ativa (arrendamento de longa duração; vale em qualquer data escolhida enquanto a ocupação durar)
- **Área vermelha** (sobreposição leve, contorno vermelho) - reserva dupla: períodos de reserva sobrepostos na mesma parcela

Clique numa parcela no mapa para abrir uma janela com o nome, as reservas, a eventual ocupação ativa (hóspede) e atalhos.

## Escolher a data [#datum-kiezen]

À direita de **Definições do mapa** escolhe uma **data** (por defeito hoje). O mapa mostra então o aspeto das parcelas nesse dia. Depois de atualizar a página, a data volta a ser **hoje**; só as restantes definições do mapa (estilo, etiquetas, camadas) são guardadas. As reservas com **check-out efetuado** e as **canceladas** não contam para a cor, a etiqueta de partida nem a reserva dupla (também não aparecem na janela do mapa). Nos lugares livres aparece, por baixo do nome da parcela, uma etiqueta com um ícone de lua e o número de noites até ao próximo check-in. Numa reserva ou ocupação com data de partida, aparece uma etiqueta com um ícone de partida e o número de noites até ao check-out (0 = hoje). Passe o rato por cima de uma etiqueta para ver o texto completo. Numa **reserva dupla** (duas ou mais reservas com períodos de estadia sobrepostos na mesma parcela), a parcela fica com contorno vermelho e uma ligeira sobreposição vermelha; um ícone de triângulo vermelho aparece antes do número da parcela. Na janela vê um aviso com as reservas envolvidas. Abaixo do nível de zoom **17,5**, o mapa esconde automaticamente as etiquetas de noites e partida; o nome da parcela continua visível. Aproxime até pelo menos **17,5** (ou desative **Noites e check-out** nas definições do mapa) para ver essas etiquetas. Com o mapa afastado, os nomes das parcelas são mostrados mais pequenos, para se sobreporem menos.

## Camadas e cores [#lagen-en-kleuren]

Em baixo à esquerda há três botões: **Camadas**, **Exportar PDF** e **Definições do mapa**, com o seletor de data à direita. Com **Camadas** decide o que vê e como as parcelas são coloridas.

<DocScreenshot src="/screenshots/instellingen/map-layers.png" alt="Mapa com o painel Camadas" />

- Em **Cores** escolhe **Ocupação** ou **Tipo de parcela**. Com **Ocupação**, as parcelas são coloridas como descrito acima. Com **Tipo de parcela**, cada parcela recebe a **Cor do mapa** do seu tipo, veja [Tipos de parcela](/terreinen#terreintypes).
- Com **Ocupação**, em **Camadas de parcelas** há uma caixa por tipo: **Livre**, **Reservada**, **Check-in efetuado**, **Ocupada**, **Não reservável** e **Reserva dupla**. Desmarque uma caixa para esconder essas parcelas.
- Em **Tipos de parcela** escolhe que tipos aparecem no mapa. **Sem tipo** corresponde às parcelas sem tipo.

Com **Exportar PDF** descarrega um PDF com as parcelas que estão agora no mapa: nome, área, gás e preço calculado, na data escolhida.

## Definições do mapa [#kaartinstellingen]

Com **Definições do mapa** ajusta a apresentação.

<DocScreenshot src="/screenshots/instellingen/map-settings.png" alt="Mapa com o painel Definições do mapa" />

| Definição | Descrição |
|------------|--------------|
| **Estilo** | **Satélite**, **Híbrido** ou **Ruas** |
| **Modo de edição** | Mostra as ferramentas para desenhar e editar limites de parcelas |
| **Nomes das parcelas** | Mostra os nomes das parcelas no mapa. Só funciona se pelo menos uma camada estiver ativada |
| **Noites e check-out** | Mostra junto aos nomes das parcelas quantas noites estão livres e quando termina uma estadia. Só funciona se **Nomes das parcelas** estiver ativado |

As suas definições são guardadas automaticamente.

## Definir o padrão do mapa [#kaartstandaard-instellen]

<Requires permission="Editar definições" />

Em <UIPath>Apoio > Definições > Mapa</UIPath> define onde o mapa abre e como está orientado.

<DocScreenshot src="/screenshots/instellingen/settings-map.png" alt="Definições > Mapa" />

| Definição | Descrição |
|---|---|
| **Centro do mapa** | Clique no mapa ou arraste o marcador para o centro do seu parque. Por baixo ficam as coordenadas. |
| **Rumo do mapa** | A direção da bússola em graus (0-360) com que a planta abre. |

O centro do mapa conta também fora do mapa. É o local para o qual a meteorologia é obtida em <UIPath>Parque > Meteorologia</UIPath>, e as sugestões de morada ao preencher uma morada dão prioridade a locais próximos. Se em **Apple Wallet** não definiu **Localização do ponto de acesso**, o Apple Wallet e o Google Wallet usam o centro do mapa para o cartão de acesso. Veja [Organização](/gebruikers/organisaties#apple-wallet). Se o centro estiver no sítio errado, a meteorologia também não estará certa.

## Desenhar limites de parcelas [#terreingrenzen-intekenen]

Com o modo de edição fixa o limite exato de uma parcela no mapa. O Tillor calcula a partir daí a área em m², e a fórmula da tarifa usa-a.

1. Vá a **Parque > Mapa**
2. Clique em **Definições do mapa** em baixo à esquerda
3. Ative o **Modo de edição**
4. Clique nos pontos pretendidos no mapa para desenhar um polígono
5. Feche o polígono clicando no ponto inicial
6. Na caixa de diálogo, selecione a parcela que quer associar

<DocScreenshot src="/screenshots/park/map-terrain-select-dialog.png" alt="Caixa de diálogo de associação de parcela depois de desenhar o polígono" />

7. Clique em **"Atualizar"**

A parcela aparece agora como uma área colorida na planta.

<Callout type="info">
As parcelas sem localização desenhada ficam no topo da lista de escolha, para as encontrar e associar facilmente.
</Callout>

## Medir distâncias [#afstanden-meten]

Com a função de medição pode medir rapidamente distâncias e áreas no mapa - útil ao organizar o terreno ou ao estimar distâncias entre locais.

1. Clique em **Medir distância** ou **Medir área**, em cima à esquerda no mapa
2. Coloque pontos no mapa (feche uma área clicando no ponto inicial)
3. A medição é mostrada no mapa; utilize **Limpar medições** para recomeçar

## Abrir uma parcela a partir do mapa [#een-terrein-openen-vanaf-de-kaart]

Pelo mapa pode ir rapidamente a uma parcela:

1. Clique numa parcela no mapa
2. A janela mostra o nome, o estado de ocupação, as reservas ativas e, numa ocupação, o hóspede
3. Clique em **"Ver detalhes"** para ir à página de detalhes
4. Enquanto não houver ocupação ativa, pode iniciar **"Criar reserva"**

## O que acontece depois de desenhar? [#wat-gebeurt-er-na-het-intekenen]

- A parcela recebe uma cor no mapa e o Tillor preenche a **Área** na página da parcela.
- O **Preço calculado** é recalculado, porque a área conta. Veja [Parcelas](/terreinen#hoe-het-tarief-tot-stand-komt).
- A **Área total** no topo da lista de parcelas passa a incluir a parcela.

## Problemas? [#problemen]

<Accordions>
<Accordion title="A minha parcela não aparece no mapa">
A parcela ainda não tem limite desenhado. Ative o **Modo de edição**, desenhe a parcela e escolha-a na caixa de diálogo. As parcelas sem localização ficam no topo da lista de escolha. Se a parcela já lá estiver, verifique em **Camadas** se a camada do seu estado está ativada.
</Accordion>
<Accordion title="Faltam as etiquetas de noites e partida">
Aproxime até pelo menos o nível 17,5 e verifique em **Definições do mapa** se **Nomes das parcelas** e **Noites e check-out** estão ambos ativados. As parcelas cinzentas, não reserváveis e sem estadia nunca têm essa etiqueta.
</Accordion>
<Accordion title="O mapa abre no sítio errado ou mostra a meteorologia errada">
O centro do mapa está errado. Mova o marcador em <UIPath>Apoio > Definições > Mapa</UIPath>.
</Accordion>
<Accordion title="Não vejo Criar reserva na janela">
Essa opção só aparece se a parcela não tiver ocupação ativa.
</Accordion>
<Accordion title="O mapa mostra a data de hoje, mesmo depois da minha escolha">
A data escolhida não é guardada. Depois de atualizar, o mapa volta a mostrar hoje.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Parcelas" href="/terreinen" description="Criar parcelas, tarifa e contadores" />
  <Card title="Reservas" href="/reserveringen" description="Planear e gerir estadias" />
  <Card title="Parque" href="/park" description="Visão geral da gestão do parque" />
</Cards>


# Gestão de clientes (/pt-PT/klantenbeheer)

Um cliente é o sítio no Tillor onde converge tudo sobre uma pessoa ou empresa: dados, contactos, faturas, ocupações, reservas, documentos e acesso. Cria um cliente, volta a encontrá-lo na lista e atualiza os seus dados no perfil do cliente. Comece por [Adicionar um novo cliente](#een-nieuwe-klant-toevoegen).

<Callout type="info" title="Bom saber">
- Ao criar, só o **Nome próprio** é obrigatório. Todos os outros dados preenche-os mais tarde no perfil do cliente.
- O Tillor avisa de um **Possível cliente duplicado** se o nome próprio e o apelido em conjunto, o endereço de e-mail ou o número de telefone já constarem de outro cliente. Um endereço de e-mail ou número de telefone conta a partir de 4 carateres.
- As sugestões de morada aparecem a partir de 3 carateres escritos no campo **Rua**.
- As digitalizações de documentos de identidade sem cliente associado são eliminadas pelo Tillor ao fim de 7 dias.
- Eliminar um cliente remove também todos os dados relacionados e não pode ser anulado.
</Callout>

## Como tudo se liga [#hoe-hangt-dit-samen]

Tudo o que regista no Tillor está ligado a um cliente. Uma ocupação associa o cliente a uma parcela e, por isso, também aos contadores dessa parcela. O consumo desses contadores vai para a fatura do cliente.

```mermaid
flowchart LR
  K[Klant] --> C[Contactpersonen]
  K --> R[Reserveringen]
  K --> B[Bezettingen]
  B --> T[Terrein]
  T --> M[Meters]
  M --> V[Verbruik]
  V --> F[Facturen]
  K --> F
  F --> P[Betalingen]
  K --> D[Documenten en ondertekenverzoeken]
  K --> O[Opmerkingen en taken]
```

## Adicionar um novo cliente [#een-nieuwe-klant-toevoegen]

Antes de começar:

- Uma digitalização de identidade, se quiser criar o cliente a partir dela. Se não houver nenhuma digitalização na fila, escolha simplesmente a introdução manual.
- Não tem a certeza de que o cliente já existe? Procure-o primeiro na lista, veja [Procurar e filtrar clientes](#klanten-zoeken-en-filteren).

<Steps>
<Step>
### Abra a lista de clientes [#open-de-klantenlijst]
Vá a <UIPath>Clientes > Visão geral</UIPath> e clique em **Criar novo cliente**, em cima à direita. Enquanto houver digitalizações de identidade pendentes, o botão mostra um menu com **Manual** e as digitalizações da fila.

<DocScreenshot src="/screenshots/klanten/customer-create-scan-menu.png" alt="Criar novo cliente com o menu para uma digitalização de identidade pendente" />
</Step>
<Step>
### Escolha como criar o cliente [#kies-hoe-je-de-klant-aanmaakt]
<Tabs items={["Manualmente", "A partir de uma digitalização de identidade"]}>
<Tab value="Manualmente">
Escolha **Manual**. Abre-se um formulário com **Nome próprio**, **Apelido**, **E-mail** e **Número de telefone**. Preencha o que sabe e clique em **Criar cliente**. Se já existir um cliente com dados semelhantes, aparece em baixo um aviso amarelo com uma ligação para esse cliente.

<DocScreenshot src="/screenshots/klanten/customer-create-dialog.png" alt="Caixa de diálogo Criar novo cliente (Manual)" />
</Tab>
<Tab value="A partir de uma digitalização de identidade">
Escolha uma digitalização no menu, por exemplo **Lotte Peeters**. Na confirmação vê uma pré-visualização do documento (frente, verso, retrato) e os dados da zona de leitura ótica. Clique em **Criar cliente**. O Tillor cria o cliente, associa a digitalização e preenche os dados do documento.

<DocScreenshot src="/screenshots/klanten/customer-create-from-scan-confirm.png" alt="Confirmação depois de escolher uma digitalização de identidade pendente" />

As digitalizações pendentes aparecem também no painel em baixo à direita, com **Criar cliente com base na digitalização**. Mais sobre digitalizações em [Digitalizações de identidade](/identiteitsscans).

<DocScreenshot src="/screenshots/klanten/identity-scan-dock.png" alt="Painel em baixo à direita com uma digitalização de identidade pendente" />
</Tab>
</Tabs>
</Step>
<Step>
### Verifique se há um cliente duplicado [#controleer-op-een-dubbele-klant]
Se já existir um cliente com o mesmo nome, o mesmo endereço de e-mail ou o mesmo número de telefone, o Tillor mostra **Possível cliente duplicado** com o nome e o número de cliente. Clique em **Usar este cliente** para abrir esse cliente, ou em **Criar mesmo assim** se for mesmo outra pessoa.
</Step>
</Steps>

<Callout type="warn" title="Prazo de conservação e responsabilidade">
O Tillor elimina as digitalizações sem cliente associado **automaticamente ao fim de 7 dias**. Trate-as a tempo.

Nas digitalizações **associadas**, é **a sua organização** que determina o prazo de conservação e o fundamento jurídico. O Tillor conserva-as até as desassociar ou eliminar. O cumprimento da legislação de privacidade e dos prazos de conservação adequados é **da sua responsabilidade** como responsável pelo tratamento.
</Callout>

### O que acontece a seguir? [#wat-gebeurt-er-daarna]

- Chega ao novo perfil do cliente, onde preenche o resto: morada, número de IVA, contactos e campos personalizados.
- Se o cliente foi criado a partir de uma digitalização, essa digitalização passa a pertencer ao cliente e deixa de estar na fila.
- A criação aparece como primeira linha no separador **Eventos** do cliente.
- Se quiser que algo aconteça de imediato com um novo cliente, por exemplo um e-mail de boas-vindas, utilize uma [automatização](/automatiseringen).

## Verificar um número de IVA [#een-btw-nummer-controleren]

No separador **Visão geral**, no bloco **Dados do cliente**, preenche o **Número de IVA**. O Tillor verifica o número no registo europeu VIES assim que o **País** também estiver preenchido e o número for suficientemente longo.

- Se o número for válido, vê uma marca verde e uma janela com o nome oficial da empresa e a morada do VIES. Clique em **Aplicar morada da empresa** para copiar essa morada para o formulário.
- Se o número for inválido, vê um ícone vermelho e uma mensagem de erro.

## O perfil do cliente [#het-klantprofiel]

Quando clica num cliente, vê o perfil do cliente. No topo estão os dados resumidos do cliente, com as notas fixadas por baixo. Pelos separadores chega ao resto.

<DocScreenshot src="/screenshots/klanten/customer-profile.png" alt="Perfil do cliente - bloco Dados do cliente" />

| Separador | O que encontra lá |
|---|---|
| **Visão geral** | Dados do cliente (formulário editável), comunicações recentes, faturas, leituras, notas, ocupações e notificações |
| **Faturação** | Todas as faturas deste cliente e o [saldo por conta do razão](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken) |
| **Controlo de acesso** | Direitos de acesso e matrículas |
| **Contactos** | Pessoas de contacto adicionais |
| **Tags NFC** | Tags NFC associadas |
| **Reservas** | Todas as reservas |
| **Comunicação** | Mensagens e histórico de comunicação |
| **Outlook** | Correio de e para o cliente a partir das suas caixas de correio do Outlook. Este separador só aparece se o [Outlook](/integraties/outlook) estiver ligado e puder **Ver caixa de entrada** |
| **Eventos** | Cronologia com alterações, incluindo a criação de cliente ou contacto, a atribuição ou desassociação de um documento de identidade, e antes/depois nas atualizações de cliente, contacto, definição de faturação e método de acesso |
| **Documentos** | Ficheiros e anexos guardados, e os [pedidos de assinatura](/handtekeningen) |
| **Tarefas** | Tarefas associadas a este cliente |

<DocScreenshot src="/screenshots/klanten/customer-access-control.png" alt="Perfil do cliente - separador Controlo de acesso com métodos de acesso" />

### Num relance [#in-één-oogopslag]

No separador **Visão geral**, em cima à esquerda, está o cartão **Num relance**. Mostra apenas o que requer atenção nesse momento e recolhe-se quando não há nada para mostrar:

- **Reservas ativas** e **Próximas reservas**, com um botão **Ver reserva**
- **Contadores ativos com alarmes**
- **Tarefas em aberto** deste cliente
- **Digitalizações de identidade** deste cliente

<DocScreenshot src="/screenshots/klanten/customer-key-info.png" alt="Perfil do cliente - cartão Num relance" />

Os mesmos dados vê no cartão de uma chamada recebida. Uma nota que fixa fica logo por baixo dos dados do cliente, no topo do perfil. Veja [Notas](/notities#opmerking-vastzetten).

### Aniversários [#verjaardagen]

Se o cliente ou o seu parceiro fizer anos hoje, aparece no topo do perfil do cliente um bloco verde **Aniversário hoje**, com o nome e a idade, e caem confettis sobre a página. Para o cliente, a data vem do campo **Data de nascimento**. O parceiro é o contacto com a relação **Parceiro**. Uma data de nascimento de 29 de fevereiro conta, nos anos sem dia bissexto, a 28 de fevereiro.

## Editar dados do cliente [#klantgegevens-bewerken]

No separador **Visão geral**, no bloco **Dados do cliente**, ajusta os campos. Na parte inferior do formulário estão **Cancelar** e **Guardar**. Cada alteração aparece no separador **Eventos**, com um resumo **Antes / depois** por campo, para ver exatamente o que foi ajustado.

Se a sua organização criou [campos personalizados](/eigen-velden) para clientes, eles aparecem como campos adicionais no mesmo bloco.

### Preencher a morada [#adres-invullen]

A morada é composta por **Rua**, **N.º** e **Porta**, seguidos de **Código postal**, **Localidade** e **País**.

<DocScreenshot src="/screenshots/klanten/customer-address-input.png" alt="Campo de morada com rua, número e porta" />

- Se escrever pelo menos três carateres da rua, o Tillor sugere moradas. Escolha uma: a rua, o número, o código postal, a localidade e o país são preenchidos. As sugestões vêm do OpenStreetMap, uma base de dados de mapas gratuita.
- Se escrever **Kerkstraat 5** no campo **Rua**, o algarismo passa para **N.º**. Um espaço depois do número leva-o a **Porta**. Se colar uma morada completa, ela também é repartida. Nos países em que o número vem antes da rua, o número não é movido automaticamente.
- Se o código postal ou a localidade já estiverem preenchidos, o Tillor verifica a morada. Uma marca verde com **Morada encontrada** significa que a morada existe. Um ícone amarelo com **Grafia sugerida** mostra a grafia habitual. Clique em **Atualizar morada** para a adotar.
- A morada é guardada numa só linha, por exemplo em faturas e exportações.

As sugestões são uma ajuda, não uma obrigação. Pode sempre preencher você.

## Procurar e filtrar clientes [#klanten-zoeken-en-filteren]

Vá a <UIPath>Clientes > Visão geral</UIPath>. No topo há uma barra de pesquisa.

<DocScreenshot src="/screenshots/klanten/customers-list.png" alt="Lista de clientes com barra de pesquisa" />

- Escreva um nome, endereço de e-mail, número de telefone ou número de cliente.
- Os resultados são atualizados enquanto escreve, com um pequeno atraso.
- Também pode filtrar por **Criado** (intervalo de datas), **Estado** e **Tipo**.

## Eliminar um cliente [#een-klant-verwijderen]

Utilize **Eliminar cliente** no menu no topo do perfil do cliente. O Tillor pergunta **Tem a certeza de que pretende eliminar este cliente?** Se confirmar, todos os dados relacionados desaparecem também. Isto não pode ser anulado.

## Cenários frequentes [#veelvoorkomende-scenarios]

### Um novo cliente reserva pela primeira vez [#een-nieuwe-klant-boekt-voor-het-eerst]

1. O cliente telefona ou reserva online.
2. Adiciona o cliente com **Criar novo cliente**.
3. Preenche a morada e os restantes dados no perfil do cliente (separador **Visão geral** > **Dados do cliente**).
4. Cria uma ocupação na parcela pretendida, veja [Ocupações](/bezettingen#een-bezetting-aanmaken).
5. O Tillor regista automaticamente o consumo dos contadores associados. Vê-o em **Leituras** em **Visão geral**.

### Alterar dados do cliente [#klantgegevens-wijzigen]

Abra o perfil do cliente, ajuste a morada no formulário e clique em **Guardar**.

## Problemas? [#problemen]

<Accordions>
<Accordion title="O Tillor diz: Cliente não criado">
A mensagem é **Não foi possível criar o cliente.** Verifique se o **Nome próprio** está preenchido e se o endereço de e-mail é válido, com uma arroba e um domínio. Depois tente novamente.
</Accordion>
<Accordion title="O Tillor diz: Possível cliente duplicado">
Já existe um cliente com o mesmo nome próprio e apelido, o mesmo endereço de e-mail ou o mesmo número de telefone. Clique em **Usar este cliente** se for a mesma pessoa, ou em **Criar mesmo assim** se for outra pessoa.
</Accordion>
<Accordion title="O Tillor diz: Algo correu mal. Não foi possível atualizar o cliente">
As suas alterações não foram guardadas. Verifique no formulário se há um endereço de e-mail inválido ou um campo obrigatório vazio, e clique novamente em **Guardar**.
</Accordion>
<Accordion title="A digitalização não está no menu de Criar novo cliente">
Só as digitalizações sem cliente associado contam como pendentes. Se a digitalização já estiver associada a um cliente, ou tiver mais de 7 dias, já não aparece. Veja [Digitalizações de identidade](/identiteitsscans).
</Accordion>
<Accordion title="Criar cliente com base na digitalização está cinzento">
Junto à digitalização está o motivo. Normalmente a digitalização não tem nome próprio: *preencha-o no scanner ou associe esta digitalização manualmente*. Ou já existe um cliente com o mesmo número de registo nacional. Abra esse cliente e associe-lhe a digitalização.
</Accordion>
<Accordion title="O Tillor diz: Número de IVA inválido">
O número não é válido ou não está registado no VIES. Verifique se o **País** está certo e se o número está completo. O Tillor indica também **O número de IVA tem de ter pelo menos ... carateres** se o número for demasiado curto para o país escolhido, e pede tanto um número como um país se faltar um dos dois.
</Accordion>
<Accordion title="Não vejo o separador Outlook">
O separador só aparece se o [Outlook](/integraties/outlook) estiver ligado e tiver a permissão **Ver caixa de entrada**.
</Accordion>
<Accordion title="Não aparecem sugestões de morada">
Escreva pelo menos três carateres no campo **Rua**. Se as sugestões continuarem a faltar, preencha simplesmente a morada você.
</Accordion>
</Accordions>

## Conceitos [#begrippen]

- **Cliente**: o registo no Tillor de uma pessoa ou empresa. Veja [cliente](/begrippen#klant).
- **Pessoa de contacto**: uma pessoa adicional junto de um cliente, por exemplo um parceiro ou um contacto de emergência.
- **Ocupação**: um cliente numa parcela durante um período. Veja [ocupação](/begrippen#bezetting).
- **Reserva**: uma marcação para uma estadia. Veja [reserva](/begrippen#reservering).
- **Eventos**: a cronologia com todas as alterações de um cliente. Veja [evento](/begrippen#gebeurtenis).
- **VIES**: o registo europeu em que o Tillor verifica um número de IVA.

## Ver também [#zie-ook]

<Cards>
  <Card title="Digitalizações de identidade" href="/identiteitsscans" description="Criar cliente a partir de uma digitalização, prazo de conservação e connector" />
  <Card title="Ocupações" href="/bezettingen" />
  <Card title="Reservas" href="/reserveringen" />
  <Card title="Faturas" href="/facturen" />
  <Card title="Parcelas" href="/terreinen" />
  <Card title="Conquistar um cliente sazonal" href="/praktijk/seizoensklant-binnenhalen" />
</Cards>


# Alarmes e estado do contador (/pt-PT/meterbeheer/alarmen-en-status)

Um contador dispara um alarme quando comunica uma anomalia, como um problema de ligação ou uma avaria técnica. Aqui lê onde o vê, o que significa o indicador de estado e como limpar um alarme.

## Acompanhar um alarme [#een-alarm-opvolgen]

<Steps>
<Step>
### Encontre o contador com um alarme [#zoek-de-meter-met-een-alarm]
Vá a <UIPath>Parque > Contadores</UIPath>. Um contador com um alarme ativo tem um triângulo.
</Step>
<Step>
### Abra o contador e leia o alarme [#open-de-meter-en-lees-het-alarm]
Na lista de alarmes vê, por alarme, a mensagem, **Iniciado em** e se está Ativo ou Resolvido. A mensagem depende do tipo de contador e do fornecedor.
</Step>
<Step>
### Resolva o problema [#los-het-probleem-op]
Verifique a bateria e o sinal nos detalhes do contador e, se necessário, vá ao contador.
</Step>
<Step>
### Limpe o alarme [#wis-het-alarm]
No menu de ações do contador, escolha **Limpar alarmes**.
</Step>
</Steps>

## O que significa o estado [#wat-de-status-betekent]

- **Indicador de estado**: os contadores inteligentes (ICY e Tillor Hydrodigit) mostram se comunicaram recentemente e se há alarmes. O indicador muda de cor quando há um alarme ativo ou quando o contador não envia nada há mais de um dia.
- **Nível da bateria** e **qualidade do sinal**: em percentagem nos detalhes do contador, para contadores que os comunicam.

## Controladores ICY [#icy-controllers]

Os módulos ICY nas parcelas comunicam através de um controlador no quadro dos contadores. Se um controlador falhar, nenhum contador ligado a esse controlador envia nada.

Se o seu parque tem contadores ICY, em <UIPath>Parque > Contadores</UIPath> aparece acima da lista o cartão **Controladores ICY**. Indica quantos controladores existem, quantos o ICY deixou de ver na última hora e quantos alarmes estão abertos em controladores. Clique em **Mostrar** para ver a tabela:

- **Controlador**: o nome do quadro dos contadores onde está ligada a maioria dos contadores do controlador, com uma bolinha verde ou vermelha. Se o nome no ICY for diferente, aparece ao lado a cinzento. Se os contadores não estiverem em nenhum quadro, vê apenas o nome do ICY.
- **Contadores**: quantos dos seus contadores comunicam através deste controlador. Num contador, esse nome aparece em **Controlador** no cartão **Informações**.
- **Alarmes**: os alarmes que o ICY comunica no próprio controlador, com a data desde quando. Um alarme desaparece da lista assim que o ICY deixa de o comunicar; não precisa de o limpar. Um alarme que o Tillor ainda não conhece pelo nome aparece como **Alarme desconhecido** com o código do ICY. Quem recebe notificações push de alarmes de contadores recebe também uma notificação quando um alarme novo e um resolvido aparecem num controlador.
- **Visto pela última vez**: quando o ICY viu o controlador pela última vez. Se foi há mais de uma hora, a hora aparece a vermelho.

Um controlador com um alarme ou parado há mais de uma hora fica no topo, e o cartão abre-se automaticamente.
O Tillor atualiza a lista sempre que os contadores ICY são lidos.

## Quando todos os seus contadores param ao mesmo tempo [#als-al-je-meters-tegelijk-stilvallen]

Os contadores Tillor Hydrodigit e Tillor EM300 enviam a sua leitura para o Tillor através de um recetor, o gateway LoRa. Normalmente enviam uma medição cerca de duas vezes por dia. Se todos os contadores LoRa recentemente ativos da sua organização não enviam nada há mais de 24 horas, o problema está provavelmente no gateway ou na ligação ao Tillor e não nos contadores. Um único contador silencioso não dispara este aviso: são precisos pelo menos dois contadores ativos.

Nesse caso, os administradores do Tillor recebem um aviso, com a última medição recebida e os contadores envolvidos. Esses contadores não aparecem então também, em separado, como contador que precisa de atenção. Não precisa de definir nada. Se vir nos seus contadores uma **Última leitura** antiga e comum, contacte o apoio.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- Um alarme limpo deixa de aparecer como ativo na lista. O triângulo junto ao contador em <UIPath>Parque > Contadores</UIPath> só existe para alarmes ativos.
- Se o contador voltar a comunicar o problema, recebe um novo alarme.

## Problemas? [#problemen]

<Accordions>
<Accordion title="O alarme volta sempre">
A causa ainda existe. Verifique a bateria, o sinal e o local do contador e, se necessário, ligue para o apoio.
</Accordion>
<Accordion title="Vários contadores não têm leitura recente">
Veja se todos têm uma **Última leitura** antiga. Nesse caso, a causa é o gateway ou a ligação. Contacte o apoio.
</Accordion>
<Accordion title="Um grupo de contadores ICY deixou de enviar ao mesmo tempo">
Veja no cartão **Controladores ICY** se um controlador tem um alarme ou está a vermelho. Nesse caso, o problema é desse controlador ou da sua ligação e não dos contadores. Verifique a alimentação e a rede do quadro dos contadores e, se necessário, contacte o ICY.
</Accordion>
<Accordion title="Um contador deixou de enviar, mas não há aviso">
O aviso do gateway exige pelo menos dois contadores ativos. Veja você o estado, a bateria e o sinal desse contador.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Ver leituras e tendências" href="/meterbeheer/meterstanden-en-trends" />
  <Card title="Faturar consumos" href="/meterbeheer/verbruik-factureren" />
</Cards>


# Lotes de consumo (/pt-PT/meterbeheer/consumptie-batches)

Esta página explica como o Tillor divide o consumo de um cliente em períodos, para que perceba porque é que um montante tem o valor que tem. Um **lote de consumo** (ou período de consumo) é um período de consumo de um contador para um cliente e um contador. O Tillor regista automaticamente quando um período começa, quando termina e se já foi faturado. Se só quer faturar, vá a [Faturar consumo](/meterbeheer/verbruik-factureren).

## Ciclo de vida de um lote [#levenscyclus-van-een-batch]

```mermaid
flowchart TD
  A[Criado<br/>apenas leitura inicial] -- leituras --> B[Aberto<br/>leitura inicial e final]
  B -- fechar --> C[Fechado<br/>fixado]
  C -- faturar --> D[Faturado<br/>concluído]
```

### Estados [#statussen]

| Estado | Descrição |
|--------|-----------|
| **Aberto** | As novas leituras são adicionadas automaticamente ao período |
| **Fechado** | O período foi encerrado e aguarda faturação |
| **Faturado** | O consumo foi incluído numa fatura |

## Quando é criado um lote? [#wanneer-wordt-een-batch-aangemaakt]

- **Na ocupação**: quando associa um cliente a uma parcela com contadores e indica uma leitura inicial
- **Numa leitura manual**: quando introduz uma leitura de um contador numa parcela com ocupação ativa e ainda não existe um lote aberto para essa combinação de cliente e contador

## Quando é fechado um lote? [#wanneer-wordt-een-batch-gesloten]

- **No fim da ocupação**: quando o cliente deixa a parcela (a ocupação é removida)
- **Numa correção ou reposição do contador**: quando a leitura desce (por exemplo, contador substituído ou corrigido), o sistema fecha o período anterior, cria um lote "salto" fechado com consumo negativo (por exemplo, -90 em 100→10) e a leitura seguinte inicia um novo lote aberto
- **Numa nova ocupação**: quando outro cliente (ou o mesmo cliente outra vez) é associado com leituras iniciais explícitas

<Callout type="info" title="A leitura do contador desce">
Se a leitura de um contador desce (correção, reposição ou substituição), o Tillor fecha automaticamente o lote em curso, cria um lote "salto" fechado com consumo negativo e abre logo um novo lote na nova leitura. O lote "salto" é fácil de reconhecer e de marcar como pago. A leitura seguinte é adicionada ao novo lote.
</Callout>

## Exemplos [#voorbeelden]

<Accordions type="multiple">
  <Accordion title="Ocupação normal (fluxo habitual)">
    O cliente ocupa a parcela, consome e parte. O cenário mais comum.

    ```
    1. Ocupação criada com leitura inicial 100 m³ (15 jan)
       → Lote: início 100 m³, aberto

    2. Leituras: 150 m³ (20 jan), 200 m³ (25 jan)
       → Lote: início 100 m³, fim 200 m³, consumo 100 m³

    3. Ocupação terminada com leitura final 250 m³
       → Lote fechado: consumo 150 m³, aguarda faturação

    4. Faturar consumo
       → Lote faturado, concluído
    ```
  </Accordion>

  <Accordion title="Faturação contínua (fluxo habitual)">
    A ocupação continua; fatura por período sem fechar o lote.

    ```
    1. Lote: 0 → 50 m³ (aberto)
    2. Marcar como faturado
       → Lote 1 fechado, lote 2 criado automaticamente: 50 → (aberto)
    3. Novas leituras: 75, 100 m³
       → Lote 2: 50 → 100 m³, consumo 50 m³
    4. Marcar outra vez como faturado
       → Lote 2 fechado, lote 3: 100 → (aberto)
    ```
  </Accordion>

  <Accordion title="A leitura desce - simples (100 → 10)">
    Só leitura inicial e depois uma correção. Lote "salto" com consumo -90 m³ e a seguir um novo lote aberto.

    ```
    1. Lote: início 100 m³ (15 jan), ainda sem leitura final
    2. Leitura a 16 jan: 10 m³ (contador corrigido)
       → Lote 1 fechado (consumo 0)
       → Lote "salto": início 100 m³, fim 10 m³ (consumo -90 m³) - fechado
       → Novo lote aberto: início 10 m³
    3. Leitura seguinte: 20 m³ → lote: 10 → 20 m³, consumo 10 m³
    ```
  </Accordion>

  <Accordion title="A leitura desce - com consumo (100 → 150 → 10)">
    Primeiro consumo normal e depois o contador é substituído. Lote "salto" com consumo -140 m³ e a seguir um novo lote aberto.

    ```
    1. Lote: início 100 m³ (15 jan), fim 150 m³ (20 jan) → consumo 50 m³
    2. Leitura a 25 jan: 10 m³ (contador substituído)
       → Lote 1 fechado com fim 150 m³ (consumo 50 m³)
       → Lote "salto": início 150 m³, fim 10 m³ (consumo -140 m³) - fechado
       → Novo lote aberto: início 10 m³
    3. Leitura seguinte: 20 m³ → lote: 10 → 20 m³, consumo 10 m³
    ```
  </Accordion>

  <Accordion title="Período sem consumo">
    Leitura com o mesmo valor do início. O Tillor ajusta a data de início.

    ```
    1. Lote: início 982 m³ (1 dez), aberto
    2. Leitura a 5 jan: 982 m³ (mesmo valor)
       → Início ajustado automaticamente para 5 jan
       → O período mostra "5 jan → ..." em vez de "1 dez → ..."
    3. Leitura a 5 jan (mais tarde): 990 m³
       → Consumo 8 m³, período "5 jan → 5 jan"
    ```
  </Accordion>

  <Accordion title="O cliente regressa">
    O cliente deixa a parcela e volta mais tarde. Novo lote, não ligado ao anterior.

    ```
    1. Cliente A: lote 0 → 50 m³, ocupação terminada
    2. Cliente B: lote 55 → 100 m³, ocupação terminada
    3. O cliente A regressa com leitura inicial 110 m³
       → Novo lote: início 110 m³ (não 50 m³)
       → Sem ligação ao período anterior
    ```
  </Accordion>

  <Accordion title="Rascunho de fatura eliminado - a continuação volta a ser um só lote">
    Faturou o consumo enquanto a ocupação continuava; depois elimina o rascunho de fatura.

    ```
    1. Lote aberto: 100 m³ (1 fev) → 200 m³ (7 mar), a ocupação continua
    2. Faturar consumo (rascunho de fatura)
       → Lote A: 100 → 200 m³, ligado à fatura, encerrado para essa fatura
       → Lote B automático: início 200 m³ (mesma leitura que o fim de A), aberto
    3. Nova leitura: 250 m³ (15 mar)
       → Lote B: 200 → 250 m³
    4. Eliminar o rascunho de fatura
       → Lote A: deixa de estar ligado à fatura, não faturado
       → O lote B (que ainda começa em 200 m³) é fundido em A
       → Resultado: um lote aberto 100 m³ → 250 m³, pronto para ser faturado de novo
    ```
  </Accordion>

  <Accordion title="Rascunho de fatura eliminado - sem fusão (início diferente)">
    Dois períodos distintos no mesmo contador: o segundo lote **não** começa na leitura final do primeiro. O Tillor **não** os funde.

    ```
    1. Lote A: 12,49 m³ → 13,21 m³ (leitura final = leitura X)
    2. Mais tarde, outro período / salto no contador
    3. Lote B: 0,10 m³ → 0,77 m³ (início = leitura Y, Y ≠ X)
    4. A mesma fatura ou outra - não importa para este exemplo
    5. Se eliminar uma fatura que só pertencia a A:
       → A volta a ficar disponível para faturação
       → O lote B mantém-se; não é puxado para A (o início Y não é igual ao fim X)
    ```
  </Accordion>

  <Accordion title="Rascunho de fatura eliminado - continuação já faturada de novo">
    A primeira fatura cobre o período até à leitura X; depois há novas leituras e uma **segunda** fatura sobre a continuação. Eliminar a primeira fatura não altera a segunda.

    ```
    1. Fatura 1: lote A 0 → 50 m³ → após faturação lote B: início 50 m³, aberto
    2. Leituras: 60, 75 m³ no lote B
    3. Fatura 2: lote B faturado → lote C: início 75 m³
    4. Eliminar a fatura 1
       → A volta a ficar disponível
       → B continua a pertencer à fatura 2 → não é considerado "continuação aberta de A"
       → Sem fusão de A com B; C continua a ser a continuação ativa após a fatura 2
    ```
  </Accordion>
</Accordions>

## Faturação [#facturering]

### Forma 1: pelo botão de faturação (nova fatura) [#manier-1-via-factuurknop-nieuwe-factuur]

1. Vá a **Clientes** > cliente > separador **Resumo** (cartão **Leituras**)
2. Clique em **Faturar consumo**
3. O sistema cria uma fatura com o consumo como linha, ou adiciona-o a um rascunho de fatura existente
4. Os lotes são marcados como faturados e ligados à fatura

### Forma 2: marcar manualmente como faturado [#manier-2-handmatig-als-gefactureerd-markeren]

Se faturou o consumo fora do Tillor:

1. Abra o lote no cartão **Leituras** (perfil do cliente) ou **Consumo** (**Parque** > **Contadores** > contador)
2. Clique no ícone de aviso junto ao período
3. Confirme com **Sim, marcar como faturado**
4. O lote é encerrado sem ligação a uma fatura

<Callout type="warn" title="Atenção">
Só os lotes marcados manualmente podem ser "revertidos". Os lotes ligados a uma fatura real não podem ser desfeitos - é preciso eliminar primeiro a fatura.
</Callout>

### Novo lote automático [#automatische-nieuwe-batch]

Quando marca um lote como faturado (e a ocupação ainda está em curso), o Tillor cria automaticamente um **novo lote aberto** que começa na leitura final do anterior. Assim o consumo continua sem lacunas.

```
Lote 1: 0 → 50 m³ (faturado)
         ↓
Lote 2: 50 → (aberto, pronto para novas leituras)
```

## Eliminar uma fatura [#factuur-verwijderen]

Se eliminar um **rascunho de fatura** ao qual estava ligado consumo, o Tillor ajusta automaticamente os lotes de consumo.

### O que acontece sempre? [#wat-gebeurt-er-altijd]

- A ligação a essa fatura desaparece.
- O lote volta a estar **não faturado** e pode voltar a ser incluído numa fatura.

### Quando é que dois lotes voltam a ser um só? [#wanneer-worden-twee-batches-weer-één]

Por vezes, depois da faturação, o Tillor iniciou automaticamente um **novo lote aberto** na **leitura final** do período faturado. Se eliminar essa fatura, o sistema procura essa continuação:

| Condição | Consequência |
|----------|--------------|
| Existe outro lote com a **mesma leitura inicial** que a **leitura final** do lote faturado (a mesma leitura como ponto de ligação) | Essa continuação é **fundida** no lote original. Volta a ter **um** único período contínuo. |
| A continuação **ainda não foi faturada** (sem fatura associada) | A fusão é **permitida**. |
| A continuação **começa noutra leitura** que não a leitura final do lote faturado | **Sem** fusão: são dois períodos separados. |
| A continuação **já foi faturada de novo** (outra fatura) | **Sem** fusão: esse período fica na outra fatura. |

### Leitura final após a fusão [#eindstand-na-samenvoegen]

Após a fusão, o lote deve voltar a estar **aberto** (se a continuação estava aberta) e a **leitura final** é a leitura final atual dessa continuação - ou seja, inclui as leituras recebidas **depois** da fatura. Se tecnicamente a continuação não tinha leitura final mas existem leituras mais recentes no contador, o Tillor preenche a leitura final com a **leitura mais recente após o ponto de ligação** (a mesma lógica da criação de um lote).

<Callout type="info" title="Marcado manualmente como faturado">
Só pode voltar a marcar manualmente como "não faturados", através do ícone de reversão, os lotes **sem** ligação a uma fatura (em **Parque** > **Contadores** > contador, nos períodos liquidados). Os lotes ligados a uma fatura real seguem as regras acima só **depois** de eliminar essa fatura.
</Callout>

## Situações específicas [#specifieke-situaties]

### Período sem consumo [#periode-zonder-verbruik]

Se chega uma leitura com o mesmo valor do início (consumo = 0), o Tillor ajusta automaticamente a data de início. O período apresentado mostra apenas o período em que houve efetivamente consumo.

### O cliente regressa [#klant-keert-terug]

Quando um cliente volta a ocupar uma parcela depois de ter saído:

- É criado um **lote completamente novo**
- O lote não começa onde o anterior terminou
- Escolhe de novo uma leitura inicial (ou a leitura do contador nesse momento)

### Contador associado a vários clientes [#meter-gekoppeld-aan-meerdere-klanten]

Cada combinação de cliente e contador tem os seus próprios lotes. A mesma parcela pode ter várias ocupações (por exemplo, períodos diferentes), cada uma com os seus períodos de consumo.

## Vista geral na aplicação [#overzicht-in-de-applicatie]

Onde vê os lotes:

- **Clientes** > cliente > separador **Resumo** > cartão **Leituras**: por contador apenas os períodos **em aberto** (destaque laranja) com o botão **Faturar consumo** no topo.
- **Parque** > **Contadores** > contador > cartão **Consumo**: por cliente primeiro os períodos em aberto (laranja) e depois os períodos liquidados (verde com ligação a fatura, cinzento se marcados manualmente).
- **Clientes** > **Consumo por faturar**: tabela com os clientes que ainda têm consumo para faturar.


<DocScreenshot src="/screenshots/meterbeheer/outstanding-consumption.png" alt="Clientes > Consumo por faturar" />

## Ver também [#zie-ook]

<Cards>
  <Card title="Gestão de contadores" href="/meterbeheer" description="Voltar à vista geral" />
  <Card title="Faturar consumo" href="/meterbeheer/verbruik-factureren" description="Faturar passo a passo" />
  <Card title="Faturas" href="/facturen" description="Rascunhos de fatura e faturação" />
  <Card title="Gestão de clientes" href="/klantenbeheer" />
</Cards>


# Resumo (/pt-PT/meterbeheer)

Com a gestão de contadores lê à distância os contadores do seu parque e vê quem consome o quê, sem que ninguém tenha de passar pelos quadros de contadores. Vê as leituras, o consumo por período e os alarmes, e liquida o consumo com o cliente que nesse momento está na parcela. Os seus contadores estão em <UIPath>Parque > Contadores</UIPath>.

<DocScreenshot src="/screenshots/park/meters-list.png" alt="Parque > Contadores com todos os contadores do parque" />

## Como está tudo ligado? [#hoe-hangt-dit-samen]

Um contador nunca pertence diretamente a um cliente. O contador está numa **parcela** e o cliente está nessa parcela através de uma **ocupação**. Quem tem agora uma ocupação na parcela recebe o consumo dos contadores dessa parcela.

```mermaid
flowchart LR
  M[Contador] -->|associa a| T[Parcela]
  K[Cliente] -->|recebe uma ocupação em| T
  T --> V[Consumo do cliente]
  V --> F[Fatura]
```

Isto tem três consequências que muitas vezes surpreendem:

- Não há nenhum botão para associar um contador a um cliente. Faz-se em dois passos: contador à parcela, cliente à parcela. Veja [Associar um contador a um cliente](/meterbeheer/meter-koppelen).
- Se um cliente muda de lugar, não muda o contador. A ocupação termina e o cliente seguinte recebe o consumo a partir da sua própria leitura inicial.
- Se a parcela não tem ocupação, o consumo não pertence a ninguém e também não o pode faturar.

<Callout type="info" title="Bom saber">
- Uma parcela tem no máximo uma ocupação ativa de cada vez. Uma parcela com ocupação não aparece na lista de **Criar ocupação**.
- Os contadores numa rede LoRa partilhada enviam uma medição cerca de duas vezes por dia. Veja a caixa abaixo.
- O Tillor comunica uma possível avaria ao recetor (o gateway) se todos os seus contadores LoRa recentemente ativos não enviarem nada durante mais de 24 horas, e só com pelo menos dois contadores ativos.
- Se quiser faturar o consumo de um cliente e o montante em aberto estiver abaixo do montante mínimo, o Tillor espera pelo próximo dia de faturação.
- Na faturação automática, o Tillor retém uma fatura se o consumo de eletricidade ou de água for pelo menos o dobro do que o cliente costuma consumir.
- Um contador eliminado não pode ser recuperado, nem as suas leituras e períodos de consumo.
</Callout>

<Callout type="info" title="Para o leitor técnico">
LoRa é uma ligação sem fios de longo alcance e baixo consumo de energia. O contador envia a sua leitura a um recetor no parque ou perto dele, o gateway, que a reencaminha para o Tillor. O Dev EUI é o número único de um contador LoRa, com 16 caracteres (algarismos 0-9 e letras a-f). Esse número é preenchido ao criar o contador. Os contadores ICY reconhecem-se pelo número de série.
</Callout>

## O que quer fazer? [#wat-wil-je-doen]

<Cards>
  <Card title="Associar um contador a um cliente" href="/meterbeheer/meter-koppelen" description="Contador à parcela, cliente à parcela" />
  <Card title="Ver leituras e tendências" href="/meterbeheer/meterstanden-en-trends" description="Leitura, consumo por dia ou hora, comparação com a semana passada" />
  <Card title="Faturar consumo" href="/meterbeheer/verbruik-factureren" description="Manualmente ou automaticamente, com um montante mínimo" />
  <Card title="Alarmes e estado do contador" href="/meterbeheer/alarmen-en-status" description="Sem leitura, bateria, sinal e avarias" />
  <Card title="Eliminar um contador" href="/meterbeheer/meter-verwijderen" description="Em três passos, não pode ser desfeito" />
  <Card title="Lotes de consumo" href="/meterbeheer/consumptie-batches" description="Como os períodos de consumo decorrem, fecham e se fundem" />
</Cards>

## Como chegam as leituras? [#hoe-komen-de-meterstanden-binnen]

Os contadores inteligentes enviam eles próprios a sua leitura, normalmente todos os dias ou todas as semanas. Não tem de fazer nada: as novas leituras aparecem automaticamente no contador e no cliente que está na parcela. Se um contador não estiver numa ligação inteligente, introduz a leitura manualmente.

## Termos [#begrippen]

- **Contador**: um contador de água, gás ou eletricidade. Veja [Termos](/begrippen#meter).
- **Parcela**: o local onde está o contador e onde está um cliente. Veja [Termos](/begrippen#terrein).
- **Ocupação**: um cliente numa parcela durante um período. Veja [Termos](/begrippen#bezetting).
- **Período de consumo** (lote de consumo): o consumo de um cliente num contador, de uma leitura inicial até uma leitura final.
- **Consumo por faturar**: consumo que ainda não foi faturado.
- **Leitura inicial**: a leitura do contador com que um cliente começa a sua ocupação.


# Associar um contador a um cliente (/pt-PT/meterbeheer/meter-koppelen)

Um contador não se associa ao próprio cliente. Coloca o contador numa parcela e dá ao cliente uma ocupação nessa parcela. Depois disso, o consumo passa automaticamente para o cliente. Veja [Como está tudo ligado?](/meterbeheer#hoe-hangt-dit-samen) para o esquema.

<Requires permission="Editar contadores" />

Antes de começar:

- O contador já está em <UIPath>Parque > Contadores</UIPath>. Um contador que já está numa parcela não aparece na lista de escolha.
- A parcela existe e ainda não tem ocupação ativa. Se a parcela estiver ocupada, não aparece na lista de **Criar ocupação**; se vir **Nenhuma parcela disponível encontrada.**, estão todas ocupadas.
- O cliente existe.

## Passo 1: colocar o contador na parcela [#stap-1-de-meter-aan-het-terrein-hangen]

<Steps>
<Step>
### Abra a parcela [#open-het-terrein]
Vá a <UIPath>Parque > Terrenos</UIPath> e clique na parcela.
</Step>
<Step>
### Clique em Adicionar contador [#klik-op-meter-toevoegen]
No fundo do cartão **Contadores** está **Adicionar contador**. Escolha o contador na lista.
</Step>
<Step>
### Confirme com Atribuir contador [#bevestig-met-meter-toekennen]
O contador aparece agora no cartão **Contadores** da parcela.
</Step>
</Steps>

<DocScreenshot src="/screenshots/park/terrain-detail.png" alt="Detalhe da parcela com o cartão Contadores" />

## Passo 2: colocar o cliente na parcela [#stap-2-de-klant-op-het-terrein-zetten]

<Steps>
<Step>
### Abra o cliente [#open-de-klant]
Vá a <UIPath>Clientes > Resumo</UIPath> e abra o cliente. No separador **Resumo** está o cartão **Ocupações**.
</Step>
<Step>
### Clique em Criar ocupação [#klik-op-bezetting-aanmaken]
Escolha a parcela. Se houver contadores na parcela, pode preencher uma **leitura inicial** por contador. Para isso escolhe uma leitura existente ou escreve um valor. Se não houver contadores, vê **Nenhum contador associado**.
</Step>
<Step>
### Confirme [#bevestig]
Clique novamente em **Criar ocupação**.
</Step>
</Steps>

## Desassociar um contador [#een-meter-loskoppelen]

Abra a parcela, vá ao cartão **Contadores** e, no menu (...) junto ao contador, escolha **Desassociar da parcela**. O contador continua a existir e pode colocá-lo noutra parcela. Esta opção só existe na página da parcela, não no menu do próprio contador.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- O Tillor inicia, para cada contador da parcela, um período de consumo para este cliente, a partir da leitura inicial. Veja [Lotes de consumo](/meterbeheer/consumptie-batches).
- As novas leituras entram nesse período. Vê-as no cliente, no cartão **Leituras**, e no contador, no cartão **Consumo**.
- Quando a ocupação termina, o Tillor fecha o período. Depois pode faturar o consumo, veja [Faturar consumo](/meterbeheer/verbruik-factureren).
- Se mais tarde colocar um contador adicional numa parcela com uma ocupação em curso, esse contador começa um período de consumo assim que introduzir uma leitura.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não vejo o contador na lista de Adicionar contador">
A lista só mostra contadores sem parcela. Se o contador já está noutra parcela, vá a essa parcela e escolha **Desassociar da parcela**.
</Accordion>
<Accordion title="Nenhuma parcela disponível encontrada">
Todas as parcelas já têm uma ocupação ativa. Termine primeiro a ocupação na parcela que quer usar ou crie uma nova parcela.
</Accordion>
<Accordion title="Desassociar da parcela não está no menu do contador">
Esta opção só está no menu (...) da página da parcela, no cartão **Contadores**. O Tillor indica **Não foi possível desassociar o contador** se não resultou; tente então outra vez.
</Accordion>
<Accordion title="O cliente não vê consumo do contador">
Verifique três coisas: o contador está na parcela, o cliente tem uma ocupação ativa nessa parcela e chegou uma leitura depois do início? Sem ocupação, o consumo não pertence a ninguém.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Faturar consumo" href="/meterbeheer/verbruik-factureren" />
  <Card title="Parcelas" href="/terreinen" />
  <Card title="Ocupações" href="/bezettingen" />
</Cards>


# Eliminar um contador (/pt-PT/meterbeheer/meter-verwijderen)

Um contador que já não existe elimina-se em três passos. Isto não pode ser desfeito. Se só quer retirar o contador de uma parcela, desassocie-o, veja [Associar um contador a um cliente](/meterbeheer/meter-koppelen#een-meter-loskoppelen).

<Requires permission="Editar contadores" />

<Steps>
<Step>
### Abra o menu de ações [#open-het-actiemenu]
Clique nos três pontos junto ao contador, na lista ou na página do contador, e escolha **Eliminar contador**.

<DocScreenshot src="/screenshots/meterbeheer/meter-actions-menu.png" alt="Menu de ações de um contador com Eliminar contador" />
</Step>
<Step>
### Passo 1 de 3: Continuar [#stap-1-van-3-doorgaan]
Lê que o contador desaparece para todos na sua organização. Clique em **Continuar** ou em **Cancelar** para parar.

<DocScreenshot src="/screenshots/meterbeheer/meter-delete-dialog.png" alt="Passo 1 da eliminação de um contador" />
</Step>
<Step>
### Passo 2 de 3: veja o que desaparece [#stap-2-van-3-bekijk-wat-verdwijnt]
Vê todas as leituras com fotos, as observações, os alarmes e os desvios, e o número de períodos de consumo. Os períodos de consumo ainda não faturados aparecem a vermelho. Se o contador ainda estiver numa parcela, isso também é indicado. Clique em **Continuar**.
</Step>
<Step>
### Passo 3 de 3: escreva o nome [#stap-3-van-3-typ-de-naam]
Escreva o nome do contador. Só então **Eliminar definitivamente** fica ativo.
</Step>
</Steps>

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- O contador, as suas leituras, fotos, observações e alarmes desaparecem, também para os seus colegas.
- Os períodos de consumo que ainda não estavam faturados já não podem ser faturados. Fature-os ou marque-os primeiro, veja [Faturar consumo](/meterbeheer/verbruik-factureren).
- Se eliminar o contador na sua própria página, regressa depois à lista de contadores.

## Problemas? [#problemen]

<Accordions>
<Accordion title="O botão Eliminar definitivamente está cinzento">
Tem de escrever o nome do contador exatamente como está. Verifique maiúsculas e espaços.
</Accordion>
<Accordion title="O Tillor indica Não foi possível eliminar o contador">
O contador não foi eliminado. Tente novamente; se continuar a falhar, contacte o suporte.
</Accordion>
<Accordion title="Não vejo Eliminar contador no menu">
Precisa da permissão **Editar contadores**. Peça-a ao seu administrador.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Associar um contador a um cliente" href="/meterbeheer/meter-koppelen" />
  <Card title="Faturar consumo" href="/meterbeheer/verbruik-factureren" />
</Cards>


# Ver leituras e tendências (/pt-PT/meterbeheer/meterstanden-en-trends)

Na página de um contador vê a última leitura, quem o utiliza agora e como o consumo evolui. Assim percebe rapidamente se um contador está a fazer o que deve e se algo estranho se passa. Se quiser liquidar o consumo, vá a [Faturar consumo](/meterbeheer/verbruik-factureren).

## Abrir um contador [#een-meter-openen]

<Steps>
<Step>
### Vá a Parque > Contadores [#ga-naar-park--meters]
Vê todos os contadores com **Nome**, **Tipo** (água, eletricidade ou gás), **Fornecedor**, **Módulo** (Campère ou PRM, só nos contadores ICY), **Parcela** e a **Última leitura** com data. Os contadores com um alarme ativo têm um triângulo.
</Step>
<Step>
### Clique no contador [#klik-op-de-meter]
Vê no topo os dados do contador e, entre outros, os cartões **Informações**, **Consumo**, **Consumo e tendências**, os alarmes e a atividade.
</Step>
</Steps>

<DocScreenshot src="/screenshots/park/meter-detail.png" alt="Detalhe do contador com o cartão Consumo" />

O que está onde:

- **Informações**: número de série, tipo, parcela, última medição e, se o contador o comunicar, o nível da bateria. Num contador ICY também vê que **Módulo** está no lugar (Campère ou PRM), através de que **Controlador** esse módulo comunica (com o nome do quadro de contadores desse controlador), o **Tempo de corte** definido na ICY e, se a ICY o conhecer, o **Número de série do módulo**.
- **Cliente** no cabeçalho: o cliente com uma ocupação ativa na parcela do contador. Se aparecer **Sem cliente**, a parcela não está ocupada ou o contador não está em lado nenhum.
- **Consumo**: por cliente, o consumo em aberto e o consumo liquidado.
- **Atividade**: por baixo do cartão **Consumo**, a cronologia com a criação do contador, alterações e leituras introduzidas, alteradas ou eliminadas manualmente. As alterações que o Tillor deteta na ICY, como outro número de série ou outro tempo de corte do módulo, também aparecem aí.

## Ler consumo e tendências [#verbruik-en-trends-lezen]

No topo do cartão **Consumo e tendências** está o consumo de **Esta semana** e **Semana passada**, a diferença **vs. semana passada** e a média por semana (**Média / semana**). Se o contador ainda tiver pouco histórico, aparece **Histórico insuficiente**.

<DocScreenshot src="/screenshots/meterbeheer/meter-consumption-trends.png" alt="Consumo e tendências de um contador" />

Por baixo do gráfico estão as **Conclusões**: a previsão para os próximos 30 dias, o total no período escolhido, um dia de pico, dias sem consumo e a evolução. Se o consumo dos últimos 7 dias estiver bem acima do normal, aparece **Utilização elevada**, com a meteorologia desses dias. Veja [Meteorologia](/weer).

<Tabs items={["Por dia ou por hora", "Escolher um período"]}>
<Tab value="Por dia ou por hora">
Com os botões no canto superior direito do cartão alterna o **Agrupamento** entre **Por dia** e **Por hora**, e o **Tipo de gráfico** entre área e barras. Por hora mostra os consumos horários como barras; uma hora que ainda decorre fica com a indicação **em curso**.

- Se escolher um período de dois dias ou menos, como **Hoje** ou **Ontem**, o gráfico mostra automaticamente barras por hora.
- Num período mais longo, **Por hora** mostra os últimos 31 dias.
</Tab>
<Tab value="Escolher um período">
Clique no botão do calendário, em cima à direita. À esquerda escolhe um período rápido: **Hoje**, **Ontem**, **Últimos 7 dias**, **Último mês**, **Últimos 3 meses** ou **Tudo**. À direita escolhe uma **Data de início** e uma **Data de fim** no calendário e confirma com **Aplicar**. Clicar num só dia mostra esse dia. Também pode ajustar a hora de início e de fim.

<DocScreenshot src="/screenshots/meterbeheer/meter-period-picker.png" alt="Seletor de período com períodos rápidos e calendário" />
</Tab>
</Tabs>

## Contadores comutáveis [#schakelbare-meters]

Nos contadores que pode ligar ou desligar à distância, como os ICY, o gráfico do histórico também mostra o estado ligado/desligado. Uma linha verde significa que o contador estava ligado. Uma linha vermelha com marcas tracejadas significa desligado. Se uma leitura não tiver informação de ligado/desligado, conta como ligado.

Num contador ICY, no menu de ações, escolhe em **Amperagem** quantos ampères o lugar recebe. Só vê os valores até ao máximo definido na ICY para o módulo desse lugar: se for 16 A, os 20 A e 25 A não aparecem na lista.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

Nada muda nos seus dados: são apenas vistas. As tendências e a meteorologia são atualizadas assim que chegam novas leituras.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Aparece Histórico insuficiente">
O contador ainda não tem dias suficientes com medições para uma comparação com a semana passada. Volte mais tarde.
</Accordion>
<Accordion title="O gráfico está vazio e aparece Nenhum consumo disponível">
Não há consumo no período escolhido. Escolha um período mais longo, por exemplo **Tudo**.
</Accordion>
<Accordion title="A última leitura é antiga">
Veja em [Alarmes e estado do contador](/meterbeheer/alarmen-en-status) se há um alarme ou uma avaria no recetor.
</Accordion>
<Accordion title="Em Amperagem não está o valor que quero na lista">
O Tillor não oferece valores acima do máximo definido na ICY para o módulo desse lugar. Se esse máximo não estiver correto, contacte a ICY.
</Accordion>
<Accordion title="Em Cliente aparece Sem cliente">
Não há ocupação ativa na parcela do contador ou o contador não está em nenhuma parcela (**Sem parcela**). Veja [Associar um contador a um cliente](/meterbeheer/meter-koppelen).
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Alarmes e estado do contador" href="/meterbeheer/alarmen-en-status" />
  <Card title="Meteorologia" href="/weer" />
  <Card title="Faturar consumo" href="/meterbeheer/verbruik-factureren" />
</Cards>


# Faturar consumo (/pt-PT/meterbeheer/verbruik-factureren)

O consumo de um cliente está pronto para ser faturado assim que existe um período de consumo com consumo. Coloca-o numa fatura com um só botão ou deixa o Tillor faturar automaticamente num dia fixo. Como um período surge e fecha, leia em [Lotes de consumo](/meterbeheer/consumptie-batches).

Antes de começar:

- O cliente tem ou teve uma ocupação numa parcela com contadores. Sem ocupação não há consumo para faturar, veja [Associar um contador a um cliente](/meterbeheer/meter-koppelen).
- Existe consumo em aberto. Se vir **Nenhum contador com consumo em aberto encontrado.**, não há nada a faturar.

## Faturar consumo [#verbruik-factureren]

<Tabs items={["A partir do cliente", "De todos os clientes", "Faturado fora do Tillor"]}>
<Tab value="A partir do cliente">
<Steps>
<Step>
### Abra o cliente [#open-de-klant]
Vá a <UIPath>Clientes > Resumo</UIPath>, abra o cliente e olhe para o cartão **Leituras**. Aí estão, por contador, os períodos em aberto.
</Step>
<Step>
### Clique em Faturar consumo [#klik-op-factureer-verbruik]
O Tillor coloca numa fatura, por período, uma linha principal com o montante, com uma linha de informação por baixo com as datas e leituras. Se já existir um rascunho de fatura adequado, o Tillor adiciona aí as linhas.
</Step>
<Step>
### Escolha você os contadores e a fatura [#kies-zelf-welke-meters-en-welke-factuur]
Abra a seta junto ao botão e escolha **Adicionar com seleção...**. Em **Faturação avançada** escolhe um rascunho de fatura existente em **Fatura (opcional)**, ou deixa vazio para uma nova fatura. Em **Selecionar contadores** assinala quais os contadores a incluir.
</Step>
</Steps>
</Tab>
<Tab value="De todos os clientes">
Vá a <UIPath>Clientes > Consumo por faturar</UIPath>. Vê os clientes com consumo ainda por faturar, com o montante total por cliente. Por predefinição, só aparecem aqui clientes sem faturação automática. Fature diretamente a partir da linha.

<DocScreenshot src="/screenshots/meterbeheer/outstanding-consumption.png" alt="Clientes > Consumo por faturar" />
</Tab>
<Tab value="Faturado fora do Tillor">
Se faturou o consumo noutro sítio, marque-o sem fatura:

1. Abra o período no cartão **Leituras** (perfil do cliente) ou **Consumo** (<UIPath>Parque > Contadores</UIPath> > contador).
2. Clique no ícone de aviso junto ao período.
3. Confirme com **Sim, marcar como faturado**.

<Callout type="warn" title="Atenção">
O Tillor não cria uma fatura neste caso. Só os períodos que marcou assim voltam atrás com o ícone de reversão nos períodos liquidados. Um período ligado a uma fatura real só fica livre quando eliminar essa fatura.
</Callout>
</Tab>
</Tabs>

## Faturar automaticamente [#automatisch-factureren]

Se num cliente a faturação automática de serviços estiver ativa, o Tillor cria e envia a fatura no dia escolhido. Define isto no perfil do cliente.

Duas regras determinam se essa fatura é mesmo criada:

- **Montante mínimo.** Se o montante em aberto estiver abaixo dele, o Tillor espera por um dia de faturação seguinte. O mínimo para todos os clientes está em **Definições > Faturação** como **Montante mínimo para faturas de utilidades automáticas**. No perfil do cliente pode definir, nas definições de faturação, um **Montante mínimo** próprio, que tem prioridade para esse cliente. Se deixar ambos vazios, qualquer montante é faturado.
- **Consumo bem acima do habitual.** Se o consumo de eletricidade ou de água em aberto for pelo menos o dobro do que o cliente costuma consumir, o Tillor não cria a fatura. Recebe um e-mail no endereço de suporte da sua organização e a fatura fica por emitir até alguém a verificar.

O Tillor compara cada tipo consigo próprio: eletricidade com eletricidade anterior, água com água anterior. O consumo habitual é o valor mediano das últimas faturas desse tipo. Não há um limite fixo em m³ ou kWh. Se o cliente ainda não tiver uma fatura anterior desse tipo, a fatura segue automaticamente.

Se a leitura estiver correta após a verificação, fature o consumo você próprio pelo perfil do cliente ou em **Clientes > Consumo por faturar**. Aí, ponha o filtro **Faturação automática** em **Com data** para ver os clientes retidos.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- Os períodos passam de em aberto a liquidados. Se a ocupação ainda estiver ativa, o Tillor abre logo um novo período a partir da leitura final, para não haver lacuna.
- As linhas ficam num rascunho de fatura. Lance-o e envie-o como qualquer outra fatura, veja [Faturas](/facturen).
- Se voltar a eliminar o rascunho de fatura, o consumo fica novamente disponível. Veja [Eliminar uma fatura](/meterbeheer/consumptie-batches#factuur-verwijderen).

## Problemas? [#problemen]

<Accordions>
<Accordion title="O Tillor indica Erro ao faturar">
Não foi possível colocar o consumo na fatura. Tente novamente. Se não resultar com um rascunho de fatura escolhido, escolha **Criar nova fatura**.
</Accordion>
<Accordion title="A fatura automática não foi criada e recebi um e-mail">
O consumo esteve pelo menos duas vezes acima do habitual. Verifique a leitura e fature você próprio se estiver tudo certo.
</Accordion>
<Accordion title="O cliente não está em Consumo por faturar">
Por predefinição, a lista só mostra clientes sem faturação automática. Ponha o filtro **Faturação automática** em **Com data** para os outros clientes. Se o cliente ainda não estiver lá, não há consumo em aberto.
</Accordion>
<Accordion title="Não há nada a faturar embora o cliente tenha consumido água">
Verifique se o cliente tem uma ocupação ativa na parcela onde está o contador e se chegou uma leitura depois da leitura inicial. Um período sem consumo não gera montante.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Lotes de consumo" href="/meterbeheer/consumptie-batches" />
  <Card title="Faturas" href="/facturen" />
  <Card title="Gestão de clientes" href="/klantenbeheer" />
</Cards>


# Resumo (/pt-PT/nfc)

Uma etiqueta NFC é um cartão, pulseira, porta-chaves ou autocolante que o cliente encosta a um leitor, como num pagamento sem contacto. Com ela toma um duche, abre uma porta ou carrega o carro. Nesta página vê como se relacionam uma etiqueta, um cliente e um saldo. Os passos para associar ou carregar uma etiqueta estão em [Gerir etiquetas](/nfc/nfc-tags).

Encontra todas as etiquetas da sua organização na página **Controladores**, no cartão **Etiquetas NFC**.

<DocScreenshot src="/screenshots/nfc/nfc-tags-list.png" alt="O cartão Etiquetas NFC na página Controladores" />

<Callout type="info" title="Bom saber">
- Uma etiqueta aparece automaticamente no Tillor assim que é encostada pela primeira vez a um leitor. Não a cria você.
- Uma etiqueta pertence no máximo a um cliente e tem o estado **Ativo**, **Inativo** ou **Bloqueado**.
- O saldo está em euros na etiqueta. Uma alteração de saldo fica sempre guardada como transação e não pode ser editada nem eliminada.
- Um pagamento que ainda tem de ser escrito na etiqueta fica pendente durante 2 minutos. Depois expira.
- Uma etiqueta bloqueada deixa de funcionar nos leitores.
</Callout>

## Como está tudo ligado? [#hoe-hangt-dit-samen]

A própria etiqueta não sabe nada. O Tillor memoriza quem a tem, qual é o saldo e onde pode entrar. O leitor pergunta isso ao Tillor no momento em que o cliente encosta a etiqueta.

```mermaid
flowchart TD
  K[Cliente] --> T[Etiqueta NFC]
  T --> G[Grupos de acesso<br/>onde pode a etiqueta entrar?]
  T --> S[Saldo<br/>quanto crédito tem?]
  L[Leitor no duche, porta ou posto de carregamento] -->|o cliente encosta a etiqueta| T
  L --> TR[Transação<br/>montante, motivo e leitor]
  S --> TR
```

- Sem cliente, o leitor recusa a etiqueta. No ecrã aparece então **Etiqueta não associada**.
- Sem o grupo de acesso certo, o leitor recusa a etiqueta com **Sem acesso**.
- Sem saldo suficiente aparece **Saldo insuficiente**. Todas as mensagens de ecrã estão em [Mensagens de ecrã](/controllers/troubleshooting/scherm).
- Cada débito ou carregamento surge como linha nas [transações](/nfc/nfc-transacties).
- Uma etiqueta também é um método de acesso. Adiciona-a a um cliente em [Controlo de acessos](/toegangscontrole#een-toegangsmethode-toevoegen).

## Componentes [#onderdelen]

<Cards>
  <Card title="Gerir etiquetas" href="/nfc/nfc-tags" description="Associar etiquetas a clientes e editar o saldo" />
  <Card title="Transações" href="/nfc/nfc-transacties" description="Toda a utilização e alterações de saldo" />
  <Card title="Controladores" href="/controllers" description="Os leitores onde os clientes encostam a etiqueta" />
</Cards>

## Termos [#begrippen]

- **Etiqueta**: o cartão, pulseira, autocolante ou porta-chaves.
- **UID**: o número único da etiqueta.
- **Saldo**: o crédito na etiqueta.
- **Grupo de acesso**: determina em que leitores uma etiqueta é válida.
- **Transação**: um débito ou carregamento do saldo.

Mais explicações na [lista de termos](/begrippen).


# Gerir etiquetas (/pt-PT/nfc/nfc-tags)

Uma etiqueta NFC só é utilizável quando está associada a um cliente. Então esse cliente pode tomar duche, abrir uma porta ou carregar, e você pode acompanhar o saldo. Todos os passos abaixo faz-os no perfil do cliente. O que acontece em cada leitura, leia em [Transações](/nfc/nfc-transacties).

Antes de começar:

- A etiqueta já tem de estar no Tillor. Isso acontece automaticamente assim que é encostada pela primeira vez a um leitor.
- A etiqueta não pode estar associada a outro cliente. Caso contrário, não aparece na lista.
- Se não houver nenhuma etiqueta livre, a lista indica **Nenhuma etiqueta disponível encontrada**.

## Associar uma etiqueta a um cliente [#een-tag-koppelen-aan-een-klant]

<Steps>
<Step>
### Abra o separador Etiquetas NFC [#open-het-tabblad-nfc-tags]
Vá a <UIPath>Clientes > cliente > Etiquetas NFC</UIPath>. Vê todas as etiquetas deste cliente. Por cima da tabela filtra por **UID** e **Tipo** (**Cartão**, **Pulseira**, **Autocolante** ou **Porta-chaves**).
</Step>
<Step>
### Escolha a etiqueta [#kies-de-tag]
Clique em **Selecione um cartão** e escolha a etiqueta. Pode pesquisar na lista.
</Step>
<Step>
### Clique em Atribuir [#klik-op-toewijzen]
O Tillor indica **Cartão atribuído ao cliente** e a etiqueta aparece na tabela.
</Step>
</Steps>

Na tabela vê, por etiqueta, o **UID** (o ícone indica o tipo), o **Estado**, o **Saldo**, quando foi **Última utilização** e os **Grupos de acesso**.

## O que pode fazer com uma etiqueta? [#wat-kun-je-met-een-tag-doen]

Abra o menu de ações (três pontos) junto à etiqueta.

<DocScreenshot src="/screenshots/nfc/nfc-tag-actions-menu.png" alt="Menu de ações de uma etiqueta NFC" />

| Ação | O que faz |
|---|---|
| **Editar saldo** | Adiciona um montante ou define o saldo, veja abaixo. |
| **Bloquear** / **Desbloquear** | Põe o estado em **Bloqueado** ou volta a pô-lo como estava. |
| **Grupos de acesso** | Determina para que grupos de acesso a etiqueta é válida. |
| **Enviar notificação de saldo baixo** | Envia ao cliente uma notificação de que o saldo está baixo. |
| **Copiar URL pessoal** | Copia a ligação para a página própria da etiqueta. |
| **Remover do cliente** | Desliga a etiqueta do cliente. |
| **Ver detalhes** | Abre a página de detalhe com transações e atividade. |

### Ajustar o saldo [#het-saldo-aanpassen]

<Steps>
<Step>
### Escolha Editar saldo [#kies-saldo-bewerken]
Abra o menu de ações e escolha **Editar saldo**.
</Step>
<Step>
### Escolha como alterar o saldo [#kies-hoe-je-het-saldo-wijzigt]
<DocScreenshot src="/screenshots/nfc/nfc-tag-topup-dialog.png" alt="Caixa de diálogo Editar saldo" />

Em **Opção** escolha **Adicionar saldo** (um montante a somar) ou **Definir saldo** (um montante exato). Em baixo vê o resultado, por exemplo **Atual: ... → Novo: ...**.
</Step>
<Step>
### Confirme [#bevestig]
Preencha o montante e clique em **Adicionar** ou **Definir**. O montante tem de ser positivo. O Tillor indica **Saldo atualizado** ou **Saldo definido**.
</Step>
</Steps>

### Bloquear uma etiqueta [#een-tag-blokkeren]

Uma etiqueta perdida ou roubada bloqueia-se com **Bloquear**. O estado passa a **Bloqueado** e a etiqueta deixa de funcionar nos leitores. Com **Desbloquear**, no mesmo menu, levanta o bloqueio. O cliente também pode bloquear a sua etiqueta na página pessoal.

### Escolher grupos de acesso [#toegangsgroepen-kiezen]

Escolha **Grupos de acesso** e assinale ou desassinale os grupos. A alteração é imediata. Se vir **Nenhum grupo de acesso disponível**, a sua organização ainda não tem grupos configurados.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- Uma etiqueta associada aparece na tabela e no cliente. Quando o cliente a encosta a um leitor, o leitor pergunta ao Tillor se pode.
- Cada alteração de saldo torna-se uma [transação](/nfc/nfc-transacties), mesmo quando ajusta o saldo manualmente. O motivo é então **Ajustado manualmente**.
- Em **Atividade**, na página de detalhe, vê o antes e o depois de cada alteração (saldo, bloqueio, associação ao cliente).
- Com **Remover do cliente** a etiqueta continua a existir. Fica livre para ser dada a outro cliente. As transações são conservadas.
- Com **Copiar URL pessoal** o cliente recebe uma página própria. Aí pode bloquear o seu cartão e, se tiver configurado pagamentos online, carregá-lo ele próprio. Isso gera uma fatura para o cliente.

## Problemas? [#problemen]

<Accordions>
<Accordion title="A lista de etiquetas está vazia">
O Tillor diz **Nenhuma etiqueta disponível encontrada**. Só aparecem etiquetas que ainda não pertencem a ninguém. Desassocie a etiqueta do outro cliente com **Remover do cliente** ou encoste uma etiqueta nova a um leitor para que apareça no Tillor.
</Accordion>
<Accordion title="O Tillor diz: A atualização falhou">
Não foi possível guardar o saldo ou os grupos de acesso. Tente novamente. Se não resultar, atualize a página e verifique se a etiqueta ainda está associada ao cliente.
</Accordion>
<Accordion title="O cliente é recusado no leitor">
Leia o motivo no ecrã do controlador, veja [Mensagens de ecrã](/controllers/troubleshooting/scherm). Normalmente a etiqueta está **Bloqueada**, não está associada a um cliente, o grupo de acesso certo não está ativo ou o saldo é demasiado baixo.
</Accordion>
<Accordion title="O Tillor diz: O montante deve ser positivo">
O montante tem de estar preenchido e ser superior a zero. Caso contrário, o Tillor indica **O montante é obrigatório**, **Montante inválido** ou **O montante deve ser positivo**.
</Accordion>
<Accordion title="O cliente não consegue carregar por si">
Carregar na página pessoal só funciona se a sua organização tiver configurado pagamentos online e se a etiqueta estiver associada a um cliente. Veja [Processamento de pagamentos](/betalingsverwerking).
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Transações" href="/nfc/nfc-transacties" description="Ver o histórico de transações" />
  <Card title="Controlo de acessos" href="/toegangscontrole" description="Cancelas e métodos de acesso" />
  <Card title="Gestão de clientes" href="/klantenbeheer" description="Gerir perfis de clientes" />
</Cards>


# Transações (/pt-PT/nfc/nfc-transacties)

Cada alteração de saldo numa etiqueta NFC fica registada como transação, mesmo um ajuste manual. Assim vê exatamente quando e porquê o saldo mudou. As transações não podem ser editadas nem eliminadas.

## Ver transações [#transacties-bekijken]

<Steps>
<Step>
### Abra a etiqueta [#open-de-tag]
Vá a <UIPath>Clientes > cliente > Etiquetas NFC</UIPath>, abra o menu de ações (três pontos) junto à etiqueta e escolha **Ver detalhes**.
</Step>
<Step>
### Veja em Transações [#kijk-bij-transacties]
O cartão **Transações** está na página de detalhe. A mais recente fica em cima. Com mais de cinco transações, pagina no fundo.

<DocScreenshot src="/screenshots/nfc/nfc-tag-detail.png" alt="Página de detalhe de uma etiqueta NFC com transações" />
</Step>
</Steps>

Por cima da tabela há filtros por **Data**, **Estado**, **Origem** e **Motivo do cancelamento**. Por predefinição estão ativos **Pendente** e **Confirmada**. Se quiser ver também as transações canceladas e expiradas, clique em **Limpar filtros**.

## Colunas [#kolommen]

| Coluna | Significado |
|---|---|
| **Montante** | A alteração de saldo. Positiva ao carregar, negativa ao utilizar. |
| **Motivo** | A causa, por exemplo **Utilização do duche em** um controlador, **Cobrança POS**, **Carregamento POS**, **Ajustado manualmente** ou **Adicionado porque a fatura ... foi paga**. |
| **Controlador** | O controlador que originou a transação. Se aparecer **Sistema**, não havia controlador: uma alteração manual, a aplicação de receção ou uma fatura paga. |
| **Data** | Data e hora. |
| **Estado** | Veja abaixo. |
| **Origem** | **Online** ou **Offline**. |
| **Descrição**, **Motivo do cancelamento** | Explicação adicional e, numa transação cancelada, o motivo. |

## Estados [#statussen]

| Estado | Significado |
|---|---|
| <Status tone="info">Pendente</Status> | O débito está reservado e ainda tem de ser escrito na etiqueta. |
| <Status tone="success">Confirmada</Status> | A transação está concluída e o saldo foi ajustado. |
| <Status tone="error">Cancelada</Status> | A transação não se realizou. O motivo está em **Motivo do cancelamento**. |
| <Status>Expirada</Status> | A etiqueta não foi encostada ao leitor a tempo. Uma reserva fica pendente durante 2 minutos. |

Os motivos de cancelamento possíveis são **Saldo insuficiente**, **Não autorizada**, **Falha ao escrever no cartão** e **Expirada**.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- Uma transação pendente passa a <Status tone="success">Confirmada</Status> assim que a etiqueta recebe o novo saldo. Se isso não acontecer em 2 minutos, passa a <Status>Expirada</Status> e o saldo não muda.
- Em **Origem** aparece **Offline** se a transação não decorreu em direto através do Tillor.
- Um rececionista pode fazer o mesmo débito ou carregamento na aplicação Tillor. O saldo só é então atualizado no Tillor. Aparece como **Cobrança POS** ou **Carregamento POS**, sem controlador.

## Problemas? [#problemen]

<Accordions>
<Accordion title="O saldo não corresponde ao que o cliente espera">
Abra as transações e veja o motivo e a data das últimas linhas. Uma linha com **Ajustado manualmente** foi introduzida por um colega. Se vir transações **Expirada** ou **Cancelada**, não foi debitado nada por elas.
</Accordion>
<Accordion title="Há uma transação Pendente que não desaparece">
Espere que passem os 2 minutos. A transação passa então a <Status>Expirada</Status>. Peça ao cliente que volte a encostar a etiqueta ao leitor.
</Accordion>
<Accordion title="O cartão Transações está vazio">
A etiqueta ainda não foi usada e o saldo não foi ajustado. Não há então nada a mostrar.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Gerir etiquetas" href="/nfc/nfc-tags" description="Associar cartões e editar o saldo" />
  <Card title="Gestão de clientes" href="/klantenbeheer" description="Ver perfis de clientes" />
</Cards>


# Notificações (/pt-PT/notificaties)

A vista geral das notificações mostra todas as mensagens que o Tillor enviou a clientes e colegas, por e-mail, SMS, correio, WhatsApp ou push. Num relance, vê quais chegaram ao destino, quais ainda vão a caminho e quais falharam. Enviar você mesmo uma mensagem de fatura está descrito em [Enviar uma fatura ou um lembrete](/communicatie/e-mails).

Abre a vista geral em <UIPath>Comunicação > Notificações</UIPath>.

<Callout type="info" title="Bom saber">
- Se uma mensagem ficar parada mais de 5 minutos sem ser entregue para envio, o Tillor tenta de novo automaticamente
- Se, passados 2 dias, ainda não tiver havido envio, o Tillor marca a mensagem como **Falhado**. Isto também se aplica a um SMS que fique tanto tempo em **Pendente**
- A lista **Comunicações recentes** mostra por defeito 50 mensagens por página
- Um clique numa ligação de um e-mail ou SMS só conta se ocorrer pelo menos cerca de um segundo e meio depois do envio. Assim, os programas de correio que obtêm as ligações previamente não contam como clique
- As mensagens de fatura não são enviadas automaticamente ao lançar uma fatura. É você quem inicia o envio
- Um cartão com uma nova notificação no Tillor desaparece após alguns segundos. A notificação permanece no sino até a ler
- As notificações que são sempre enviadas não podem ser desativadas
</Callout>

## Como tudo se liga? [#hoe-hangt-dit-samen]

Uma mensagem começa com um motivo. Depois, o Tillor escolhe o canal e guarda o resultado na vista geral.

```mermaid
flowchart LR
  A[Clica em Enviar notificação] --> D[Mensagem]
  B[Acontece algo, como um alarme de contador] --> D
  C[Uma automatização envia uma mensagem] --> D
  D --> E{Para quem?}
  E -- Cliente --> F[E-mail, SMS, correio ou WhatsApp]
  E -- Colega --> G[Push, e-mail ou telefone, segundo as suas preferências]
  F --> H[Notificações: estado por canal]
  G --> H
  G --> I[Sino no Tillor]
  H --> J[Também visível no cliente e na fatura]
```

- **Para um cliente**, normalmente escolhe o canal você mesmo, por exemplo na janela **Enviar notificação** de uma fatura. Uma [automatização](/begrippen#automatisering) também pode enviar uma mensagem a um cliente.
- **Para um colega**, é o próprio colega quem define como o Tillor o contacta, por tipo de notificação. Veja [Notificações na aplicação](#meldingen-in-de-app).
- **O resultado** vê-o aqui, e também no cliente e na fatura a que a mensagem pertence. A coluna **Origem** leva-o diretamente até lá.

## Ver notificações [#notificaties-bekijken]

<DocScreenshot src="/screenshots/notificaties/notifications-overview.png" alt="Vista geral das notificações com estatísticas e listas" />

No topo há quatro estatísticas:

- **Total de notificações**: todas as tentativas de envio
- **Notificações enviadas**: mensagens que foram entregues
- **Notificações falhadas**: mensagens que não puderam ser entregues
- **Notificações devolvidas**: mensagens que foram devolvidas, sobretudo e-mails

Por baixo há quatro listas: **Notificações devolvidas**, **Notificações pendentes** (ainda na fila ou a caminho), **Comunicações recentes** (todos os estados) e **Notificações falhadas**. Com os filtros **Tipo** e **Canal** acima de cada lista, limita o que vê. Os tipos existentes estão descritos em [Tipos de notificação](/communicatie/notificatietypes).

Cada linha mostra:

| Coluna | O que vê |
|---|---|
| **Tipo** | Que tipo de mensagem é, como Nova fatura ou Alarme de contador ou controlador |
| **Origem** | A fatura, o cliente ou o pagamento a que a mensagem pertence |
| **Canal** | E-mail, SMS, Correio, WhatsApp ou Push |
| **Estado** | O estado de entrega |
| **Destinatário** | O endereço de e-mail, número de telefone, morada postal ou o utilizador |
| **Data** | Quando a tentativa de envio foi criada |

### Ver os detalhes de entrega [#leveringsdetails-bekijken]

Clique no canal numa linha para ver exatamente o que foi enviado e o que aconteceu.

<DocScreenshot src="/screenshots/notificaties/notifications-delivery-detail.png" alt="Detalhes de entrega do e-mail Nova fatura" />

A janela mostra o estado de entrega, uma eventual mensagem de erro, o destinatário (**Para**), o endereço do remetente (**De**) e, no caso do e-mail, o **Assunto**. Vê ainda quando a mensagem ficou pronta (**Criada em**) e quando realmente saiu (**Enviado em**). **Enviado por** mostra o utilizador que iniciou o envio, ou **Sistema** se aconteceu automaticamente. Em baixo estão o **Conteúdo** e os eventuais **Anexos**.

No caso de e-mail e WhatsApp, vê também **Lido em**, e na lista um ícone de olho nas mensagens lidas. No caso de e-mail e SMS aparece **Clicado em** se o cliente clicou numa ligação.

No caso do correio há campos adicionais: **Referência do transportador**, **Estado de rastreio** e **Última atualização de rastreio** (o último evento do serviço postal), **Custo de porte** no momento do envio e, num envio registado, a etiqueta **Registada** com o custo adicional e uma explicação sobre a repercussão do custo.

<DocScreenshot src="/screenshots/notificaties/notifications-post-registered-detail.png" alt="Detalhes de entrega de um lembrete registado enviado por correio" />

### Estados [#statussen]

| Estado | Significado |
|---|---|
| <Status tone="info">Pendente</Status> | A mensagem está a ser processada ou está na fila |
| <Status tone="success">Enviado</Status> | A mensagem foi entregue |
| <Status tone="error">Falhou</Status> | A entrega falhou |
| <Status>Ignorado</Status> | A mensagem não foi (ou já não foi) enviada, por exemplo porque o push não estava disponível ou porque uma carta foi cancelada no serviço postal |
| <Status tone="info">Atrasado</Status> | A mensagem está agendada e sai mais tarde |
| <Status tone="warning">Devolvido</Status> | A mensagem não conseguiu chegar ao endereço de e-mail ou ao número |
| <Status tone="error">Reclamado</Status> | O destinatário marcou a mensagem como spam |

Uma carta por correio começa em **Pendente**. Assim que o serviço postal confirma que a carta está a caminho ou foi entregue, passa a **Enviado**. O correio não entregável passa a **Falhou**. Uma carta cancelada passa a **Ignorado**. Essa linha encontra-a sobretudo em **Comunicações recentes**.

## Notificações na aplicação [#meldingen-in-de-app]

Tudo o que o Tillor lhe envia como colega, como uma tarefa atribuída, uma menção num comentário ou um alarme de contador, também o encontra no próprio Tillor. Cada notificação aparece uma só vez, mesmo que tenha sido enviada por e-mail e por push. Não precisa de definir nada para isso.

- **Sino**: no canto superior direito da barra e em baixo à esquerda no menu (**Notificações**) há um sino com o número de notificações por ler. Clique nele para ver as notificações mais recentes. Com **Marcar tudo como lido** atualiza a lista de uma só vez
- **Ver o e-mail**: clique numa notificação para abrir o e-mail que recebeu por causa dela, com um botão no topo para a página correspondente (por exemplo **Abrir tarefa**). Uma notificação sem e-mail leva-o logo a essa página. A notificação fica então lida
- **Cartão em baixo à direita**: se chegar uma notificação enquanto tem o Tillor aberto, aparece como um cartão em baixo à direita, no mesmo sítio que uma conversa a chegar. Clique no cartão ou feche-o com a cruz. Um cartão fechado continua por ler no sino. Se já estiver na página a que a notificação diz respeito, não recebe cartão
- **Permanece**: as notificações para as quais também lhe é feita uma chamada, como um conector que deixou de estar acessível, permanecem até as fechar
- **Caixa de entrada**: as novas mensagens da caixa de entrada mantêm o seu próprio cartão e contador em **Caixa de entrada**. No sino ficam logo como lidas. Isto também se aplica ao resumo diário dos contadores que precisam de atenção
- **Por dia**: na lista, as suas notificações aparecem por dia, com a categoria. Com os botões no topo mostra uma única categoria

As notificações são pessoais: só vê as suas, por organização.

Numa [automatização](/begrippen#automatisering), no passo **Notificar colegas**, escolhe com **Mostrar no Tillor** se a notificação recebe um cartão e um contador de não lidas. Se estiver desativado, aparece como lida na lista.

### Desativar notificações [#meldingen-uitzetten]

<Steps>
<Step>
### Abra a sua conta [#open-je-account]
No menu, clique no seu nome e escolha **Conta**.
</Step>
<Step>
### Vá a Notificações [#ga-naar-meldingen]
Ative ou desative os canais por tipo de notificação. Na linha **Todas as notificações** desativa um canal de uma só vez para tudo.
</Step>
</Steps>

Um canal que desative em **Todas as notificações** permanece desativado para todas as notificações abaixo, exceto as que são sempre enviadas. Um tipo cujos canais tenha todos desativado também deixa de aparecer na aplicação. Para um colega, isto define-se em <UIPath>Definições > Utilizadores</UIPath>, veja [Definir as notificações de um colega](/gebruikers/gebruikers-en-rechten#meldingen-van-een-collega-instellen).

## Notificações externas [#externe-notificaties]

Um sistema externo ligado, por exemplo o seu software de newsletter ou de reservas, pode fazer com que os e-mails que enviou ele próprio a um cliente fiquem registados no Tillor. Encontra-os no cliente, na fatura e em **Comunicações recentes**, entre as mensagens do Tillor. Reconhece-os pela etiqueta **Externa** com o nome do sistema.

- O Tillor não enviou a mensagem e não pode verificar o estado. O estado vem do sistema externo
- As notificações externas não contam nas estatísticas no topo e não aparecem nas listas **Notificações devolvidas**, **Notificações pendentes** e **Notificações falhadas**
- Na janela de detalhes, as imagens estão bloqueadas por defeito. Assim, o remetente não sabe que abriu a mensagem. Clique em **Carregar imagens** para as mostrar mesmo assim
- O sistema externo pode mais tarde atualizar ou eliminar as suas próprias notificações. Isso fica visível no [registo de atividade](/activiteitenlog) do cliente ou da fatura

Quem pode registar notificações externas define-se com as permissões **Registar notificações externas** e **Gerir notificações externas de outros**. A explicação técnica para integradores está em [Programadores > Notificações externas](/ontwikkelaars/externe-notificaties).

## Problemas? [#problemen]

<Accordions>
<Accordion title="Uma mensagem está em Devolvido">
O endereço de e-mail ou o número do cliente não existe ou não pode receber mensagens. Abra a mensagem através da lista **Notificações devolvidas** e leia a mensagem de erro. Através da coluna **Origem**, vá ao perfil do cliente, corrija o endereço de e-mail e volte a enviar a mensagem com **Enviar notificação** na fatura.
</Accordion>
<Accordion title="Um SMS ou mensagem de WhatsApp falhou">
Abra a mensagem através de **Notificações falhadas** e leia a mensagem de erro. Na maioria das vezes, o número de telefone está errado ou falta o indicativo do país. Corrija o número no perfil do cliente e volte a enviar.
</Accordion>
<Accordion title="Um SMS fica em Pendente">
Por vezes, o operador de telecomunicações comunica a entrega com atraso. Passados 2 dias, o Tillor marca automaticamente o SMS como **Falhado**. Abra a janela de detalhes para ver a mensagem de erro e verifique o número.
</Accordion>
<Accordion title="Uma carta por correio falhou ou não é entregável">
Abra a mensagem através de **Notificações pendentes** ou **Notificações falhadas**. Verifique a morada postal no perfil do cliente (rua, código postal e localidade) e volte a enviar a carta com **Enviar notificação** ou **Enviar lembrete** na fatura.
</Accordion>
<Accordion title="Uma carta está em Ignorado">
A carta foi cancelada no serviço postal. Procure o envio em **Comunicações recentes** e veja em **Estado de rastreio** o que aconteceu. Só volte a enviar se o cliente ainda tiver de receber a carta.
</Accordion>
<Accordion title="Não vejo o botão Enviar notificação numa fatura">
O botão só existe numa fatura lançada, e apenas se o cliente tiver um endereço de e-mail, um número de telefone ou uma morada postal completa. Complete um desses dados no perfil do cliente.
</Accordion>
<Accordion title="Deixei de receber uma notificação no Tillor">
Verifique em **Conta**, em **Notificações**, se desativou todos os canais desse tipo. Um tipo sem canais também deixa de aparecer no sino.
</Accordion>
</Accordions>

## Conceitos [#begrippen]

- **[Notificação](/begrippen#notificatie)**: uma mensagem que o Tillor envia a um cliente ou colega, por e-mail, SMS, correio, WhatsApp ou push.
- **Canal**: o caminho por onde uma mensagem sai. Uma notificação pode passar por vários canais.
- **Entrega**: uma tentativa de envio através de um canal, com o seu próprio estado.
- **Devolvido**: a mensagem voltou porque o endereço ou o número não existe.
- **Alerta**: uma notificação para um [utilizador](/begrippen#gebruiker) do Tillor, visível no sino.
- **Externa**: uma mensagem que um sistema ligado enviou ele próprio e que apenas foi registada no Tillor.

Mais termos estão na [lista de conceitos](/begrippen).

## Ver também [#zie-ook]

<Cards>
  <Card title="Enviar uma fatura ou um lembrete" href="/communicatie/e-mails" description="Enviar você mesmo uma mensagem a partir de uma fatura" />
  <Card title="Tipos de notificação" href="/communicatie/notificatietypes" description="Todos os tipos de mensagens e quando são enviadas" />
  <Card title="Enviar uma fatura" href="/facturen/versturen" description="Faturas e cartas de lembrete por correio" />
  <Card title="Automatizações" href="/automatiseringen" description="Fazer com que uma automatização envie mensagens" />
</Cards>


# Comentários (/pt-PT/notities)

Com os comentários, os colegas colaboram em torno de clientes, faturas, reservas e outros registos, sem que o cliente veja nada. Escreve um comentário na página de detalhe do registo, menciona um colega com @ e fixa os comentários importantes. Comece em [Adicionar um comentário](#een-opmerking-toevoegen).

<Callout type="info" title="Bom saber">
- Os comentários são sempre internos. Nunca ficam visíveis para os clientes, nem em faturas nem em e-mails.
- Um colega que mencione com @ recebe uma notificação.
- Um comentário resolvido já não pode ser editado nem fixado.
- Resolver um comentário desafixa automaticamente um comentário fixado.
- Eliminar um comentário não pode ser desfeito.
- Um comentário fixado permanece visível no topo do registo, sem que tenha de deslocar a página até ao cartão **Comentários**.
</Callout>

## Como tudo se liga? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  R[Registo: cliente, fatura, reserva...] --> O[Comentário]
  O -->|Menção @| M[Notificação para o colega]
  O -->|Fixar| P[No topo do registo]
  O -->|Lembrete| T[Tarefa de seguimento]
  O -->|Resolver| X[Resolvido e recolhido]
```

Todos os comentários da sua organização também estão reunidos em <UIPath>Comunicação > Comentários</UIPath>, com uma referência ao registo a que pertencem.

## Onde encontra os comentários? [#waar-vind-je-opmerkingen]

Nas páginas de detalhe há um cartão **Comentários**. Consoante o registo:

- <UIPath>Clientes > Resumo</UIPath> ou <UIPath>Clientes > Comunicação</UIPath>: no perfil do cliente
- <UIPath>Administração > Faturas</UIPath>: na página de detalhe da fatura
- <UIPath>Clientes > Reservas</UIPath>: na página de detalhe da reserva
- <UIPath>Parque > Terrenos</UIPath>: na página de detalhe do terreno
- <UIPath>Parque > Contadores</UIPath>: na página de detalhe do contador
- <UIPath>Administração > Relatórios de pagamento</UIPath>: no relatório de pagamento

## Adicionar um comentário [#een-opmerking-toevoegen]

<Steps>
<Step>
### Abra o registo [#open-het-record]
Abra, por exemplo, um perfil de cliente ou uma fatura e vá ao cartão **Comentários**.

<DocScreenshot src="/screenshots/notities/invoice-comments.png" alt="Cartão de comentários no detalhe da fatura" />
</Step>
<Step>
### Clique em Adicionar comentário [#klik-op-reactie-toevoegen]
Escreva o seu comentário na caixa de texto **Escreva um comentário...**.

- Escreva **@** e escolha um colega da lista para o mencionar. Essa pessoa recebe uma notificação.
- Escreva **/** para ligar um cliente, fatura, contador, terreno ou outro registo.
- Adicione um anexo através de **Anexar ficheiro**, colando ou arrastando ficheiros.
</Step>
<Step>
### Clique em Enviar [#klik-op-verzenden]
O seu comentário fica agora no cartão. Com **Responder** num comentário existente, inicia uma discussão.
</Step>
</Steps>

### O que acontece a seguir? [#wat-gebeurt-er-daarna]

- O comentário fica no registo e na vista geral central.
- Um colega mencionado recebe uma notificação.
- Se quiser ter a certeza de que alguém responde, clique no relógio junto ao comentário (**Definir um lembrete de seguimento**). O Tillor cria então uma tarefa, para que possa verificar mais tarde se foi tratado.

## Gerir comentários [#opmerkingen-beheren]

Em cada comentário há botões de ação no canto superior direito, desde que tenha as permissões necessárias.

### Editar ou eliminar um comentário [#opmerking-bewerken-of-verwijderen]

- **Editar**: altere o texto. Isto é possível nos seus próprios comentários, e não nos comentários resolvidos.
- **Eliminar**: elimine o comentário, após confirmação. Isto não pode ser desfeito.

### Fixar um comentário [#opmerking-vastzetten]

Quer manter um comentário importante visível no topo?

1. Clique no ícone de alfinete (**Fixar**).
2. O comentário recebe a etiqueta **Fixado** e fica no topo da lista.
3. Clique de novo no ícone de alfinete para o soltar (**Desafixar**).

Os comentários resolvidos não podem ser fixados.

#### Onde fica um comentário fixado [#waar-staat-een-vastgezette-opmerking]

- No perfil de um cliente, fica logo abaixo dos dados do cliente, no topo, acima dos separadores.
- Numa fatura, reserva, terreno ou contador, fica no cartão **Num relance** no topo, junto com as tarefas em aberto. Esse cartão fecha-se quando não tem nada.

### Marcar um comentário como resolvido [#opmerking-als-opgelost-markeren]

Para discussões que ficaram concluídas:

1. Clique na marca de verificação (**Resolver**).
2. O comentário é marcado como **Resolvido** e desaparece da lista de abertos.
3. Numa página de detalhe, os comentários resolvidos ficam em baixo numa secção recolhível.
4. Clique de novo na marca de verificação para desfazer (**Reabrir**).

### Descarregar comentários em PDF [#opmerkingen-als-pdf-downloaden]

Com o ícone de impressão, descarrega todos os comentários de um registo em PDF (**Descarregar todos os comentários em PDF**), ou uma só discussão (**Descarregar este tópico de comentários em PDF**).

## Vista geral de todos os comentários [#overzicht-van-alle-opmerkingen]

Vá a <UIPath>Comunicação > Comentários</UIPath> para uma vista geral central. No topo vê estatísticas (total, abertos, resolvidos e fixados). Por baixo:

<DocScreenshot src="/screenshots/notities/comments-overview.png" alt="Vista geral central de comentários - Comentários abertos" />

- **Comentários abertos**: comentários que ainda estão abertos.
- **Comentários resolvidos**: comentários encerrados, para referência.

Cada comentário mostra a **Origem** (por exemplo, cliente ou fatura), para que possa ir diretamente ao registo.

### Filtrar [#filteren]

- **Última semana**, **Último mês** ou **Tudo**: filtra pela data de criação.
- **Mostrar apenas menções**: apenas comentários em que foi mencionado.
- Pesquise com **Pesquisar comentários...**, ou filtre por autor, mencionado, resolvido, fixado e comentário principal ou resposta.

## Problemas? [#problemen]

<Accordions>
<Accordion title="O Tillor diz: Comentário não criado">
O seu comentário não foi guardado. Verifique que a caixa de texto não está vazia e tente **Enviar** de novo.
</Accordion>
<Accordion title="Não vejo nenhum colega ao escrever @">
Se aparecer **Nenhum utilizador encontrado**, experimente outro nome ou um endereço de e-mail. Só os utilizadores da sua organização aparecem na lista.
</Accordion>
<Accordion title="Não consigo editar nem fixar um comentário">
Um comentário resolvido está bloqueado. Clique primeiro na marca de verificação para o reabrir (**Reabrir**). Só pode editar os seus próprios comentários.
</Accordion>
<Accordion title="O comentário fixado desapareceu">
Resolver um comentário desafixa-o. Reabra-o com a marca de verificação e fixe-o de novo.
</Accordion>
<Accordion title="O Tillor diz: Falha ao fixar/desafixar o comentário ou Falha ao resolver/reabrir o comentário">
A alteração não foi aplicada. Recarregue a página e tente de novo.
</Accordion>
<Accordion title="O Tillor diz: Não foi possível criar o PDF">
Tente de novo. Se o PDF não aparecer, o seu navegador está a bloquear uma janela pop-up. Permita pop-ups neste site.
</Accordion>
</Accordions>

## Conceitos [#begrippen]

- **Comentário**: um texto interno num registo, eventualmente com anexos. Veja [comentário](/begrippen#opmerking).
- **Menção**: um colega que nomeia com @. Esse colega recebe uma notificação.
- **Fixar**: manter um comentário no topo do registo.
- **Resolvido**: um comentário concluído que desaparece da lista de abertos.
- **Origem**: o registo a que um comentário pertence.
- **Tarefa**: uma tarefa a fazer que pode resultar de um lembrete num comentário. Veja [tarefa](/begrippen#taak).

## Ver também [#zie-ook]

<Cards>
  <Card title="Gestão de clientes" href="/klantenbeheer" description="Gerir perfis de clientes" />
  <Card title="Faturas" href="/facturen" description="Gerir faturas" />
</Cards>


# Parque (/pt-PT/park)

Em **Parque** encontra tudo o que pertence ao local físico: o mapa com a ocupação de hoje, a lista de terrenos, os contadores e armários de contadores, e a meteorologia. Comece pelos [Terrenos](/terreinen), porque uma ocupação, um contador e uma tarifa dependem todos deles.

## O que encontra onde? [#wat-vind-je-waar]

| Menu | Para quê | Explicação |
|---|---|---|
| <UIPath>Parque > Mapa</UIPath> | O mapa do seu parque, colorido por dia consoante a ocupação | [Mapa](/kaart) |
| <UIPath>Parque > Terrenos</UIPath> | Todos os terrenos, a sua tarifa e os contadores neles | [Terrenos](/terreinen) |
| <UIPath>Parque > Contadores</UIPath> | Todos os contadores de água, gás e eletricidade | [Gestão de contadores](/meterbeheer) |
| <UIPath>Parque > Armários de contadores</UIPath> | Os armários onde os contadores estão instalados e que contadores têm dentro | Gira os seus armários de contadores e os contadores que lhes estão atribuídos |
| <UIPath>Parque > Meteorologia</UIPath> | A meteorologia por dia na localização do seu parque | [Meteorologia](/weer) |

<DocScreenshot src="/screenshots/park/map-overview.png" alt="Mapa do parque com terrenos coloridos" />

## Armários de contadores [#meterkasten]

Em <UIPath>Parque > Armários de contadores</UIPath> gere os armários de contadores e os contadores que lhes estão atribuídos. Com **Novo quadro de contadores** adiciona um armário, com um nome e uma descrição.

## Como tudo se liga? [#hoe-hangt-dit-samen]

O **terreno** é o ponto de ancoragem. Ao terreno associa os contadores. Um cliente fica num terreno através de uma **ocupação**, e um hóspede para uma estadia curta através de uma **reserva**. O consumo dos contadores no terreno vai para o cliente com a ocupação ativa.

```mermaid
flowchart LR
  M[Contadores] --> T[Terreno]
  T --> K[Mapa]
  B[Ocupação<br/>cliente por mais tempo] --> T
  R[Reserva<br/>estadia com data de entrada e saída] --> T
  T --> V[Tarifa e consumo na fatura]
```

Um terreno só recebe uma cor no mapa depois de desenhar o seu limite. Veja [Desenhar os limites dos terrenos](/kaart#terreingrenzen-intekenen).

<Callout type="info" title="Bom saber">
- Um terreno tem no máximo uma ocupação ativa de cada vez.
- Um novo terreno não é reservável por defeito. Assinale **Reservável** se os clientes puderem reservá-lo online.
- A área não pode ser escrita à mão. O Tillor calcula-a assim que desenha o terreno no mapa, e usa-a para a tarifa.
- O mapa abre sempre em hoje. As suas outras definições do mapa (estilo, etiquetas, camadas) são guardadas.
- As etiquetas com noites e partida só aparecem a partir do nível de zoom 17,5.
- A meteorologia é obtida todas as noites para o centro do mapa da sua organização.
</Callout>

## Conceitos [#begrippen]

- **Terreno**: um local no seu parque com um nome, uma tarifa e eventualmente contadores. Veja [Conceitos](/begrippen#terrein).
- **Mapa**: o mapa interativo em Parque.
- **Armário de contadores**: um armário com contadores. Veja [Conceitos](/begrippen#meterkast).
- **Ocupação**: um cliente num terreno durante um período. Veja [Conceitos](/begrippen#bezetting).
- **Reservável**: um terreno que os clientes podem reservar online.

## Ver também [#zie-ook]

<Cards>
  <Card title="Terrenos" href="/terreinen" description="Criar terrenos, tarifa e contadores" />
  <Card title="Mapa" href="/kaart" description="Mapa, camadas e limites dos terrenos" />
  <Card title="Gestão de contadores" href="/meterbeheer" />
  <Card title="Meteorologia" href="/weer" />
</Cards>


# Definições de impressão (/pt-PT/printer/afdrukinstellingen)

Esta é a lista de todas as definições em <UIPath>Definições > Imprimir</UIPath>. As definições aplicam-se a toda a sua organização. A configuração passo a passo está em [Configurar impressoras](/printer/printers-instellen).

<DocScreenshot src="/screenshots/printer/settings-dialog-printers.png" alt="Definições > Imprimir" />

| Definição | Significado |
| ---------- | --------- |
| **Impressão de PDF** | Ativa a impressão de faturas e documentos em impressoras físicas. Sem isto, o Tillor não imprime nada. |
| **Imprimir fatura automaticamente ao pagar** | As faturas pagas vão automaticamente para a fila de impressão. Por tipo de pagamento, escolhe se isso acontece logo, na próxima hora de corte ou não. |
| **Imprimir documento de identidade automaticamente ao associar** | Se associar uma digitalização de identidade a um cliente ou contacto (também ao criar um cliente a partir de uma digitalização), o resumo vai em PDF para a impressora A4. Requer: **Impressão de PDF** ativada e um **IP da impressora PDF** preenchido. |
| **IP da impressora PDF** | Endereço de rede da impressora A4 para faturas e documentos, por exemplo `192.168.1.100`. |
| **IP da impressora térmica** | Endereço de rede da impressora de talões, por exemplo `192.168.1.101`. |
| **Largura do papel de talões** | Largura do rolo de talões: **80 mm** (por defeito) ou **58 mm**. O Tillor ajusta a isso o comprimento das linhas e o logótipo do talão. |
| **IP da impressora de etiquetas** | Endereço de rede da impressora de etiquetas, por exemplo `192.168.1.102`. |
| **Horário de corte de impressão** | Por dia da semana, uma ou mais horas ao minuto, por exemplo 09:00 e 13:30. Vazio significa que nesse dia não há momentos de corte. |
| **Momento de impressão automática por tipo de pagamento** | Por canal (terminal/balcão, manual, online, mandato, transferência): **Imprimir imediatamente**, **Próxima hora de corte** ou **Não imprimir automaticamente**. Por defeito, terminal e manual imprimem logo. Online, mandato e transferência esperam pela hora de corte. |
| **Pausar impressão até** | Mantém a fila de impressão parada até ao momento escolhido. **Limpar pausa** remove a pausa. Também pode pausar a partir da [fila de impressão](/printer/printwachtrij). |

Clique em baixo em **Guardar definições** para aplicar as suas alterações. Aplicam-se de imediato.

<Callout type="info">
As impressoras têm de estar na mesma rede que o conector e ter um endereço IP fixo. Atribua à impressora um endereço fixo no seu router, caso contrário o endereço pode mudar.
</Callout>

## Ver também [#zie-ook]

<Cards>
  <Card title="Configurar impressoras" href="/printer/printers-instellen" description="Os passos para começar" />
  <Card title="Imprimir documentos" href="/printer/documenten-afdrukken" description="Imprimir uma fatura ou talão" />
  <Card title="Conector" href="/connector" description="O programa que controla a impressora" />
</Cards>


# Imprimir uma fatura ou talão (/pt-PT/printer/documenten-afdrukken)

Imprime uma fatura a partir da página da fatura, na impressora A4 ou na impressora de talões. Nos pagamentos, o Tillor também pode imprimir talões automaticamente. Também pode mostrar uma fatura no tablet sem a imprimir.

<Requires permission="Editar definições" />

Antes de começar:

- As impressoras estão configuradas, veja [Configurar impressoras](/printer/printers-instellen).
- Há um conector ativo para a sua organização. Sem ele, as opções **Enviar para a impressora A4** e **Enviar para impressora de recibos** não aparecem no menu.

## Imprimir uma fatura [#een-factuur-afdrukken]

<Steps>
<Step>
### Abra a fatura [#open-de-factuur]
Vá a <UIPath>Administração > Faturas</UIPath> e abra a fatura.
</Step>
<Step>
### Escolha como imprimir [#kies-hoe-je-afdrukt]
<Tabs items={["Em papel através do navegador", "Para uma impressora na rede"]}>
<Tab value="Em papel através do navegador">
Clique em **Imprimir**. O seu navegador abre a sua própria janela de impressão.
</Tab>
<Tab value="Para uma impressora na rede">
Clique na seta junto a **Imprimir** e escolha **Enviar para a impressora A4** ou **Enviar para impressora de recibos**. O Tillor coloca uma tarefa na fila de impressão.
</Tab>
</Tabs>

<DocScreenshot src="/screenshots/facturen/invoice-booked-actions.png" alt="Detalhe da fatura - ações de impressão e pagamento" />
</Step>
</Steps>

## Talões após um pagamento [#bonnen-na-een-betaling]

Em <UIPath>Definições > Imprimir</UIPath>, ative **Imprimir fatura automaticamente ao pagar**. As faturas pagas vão então para a impressora A4 e, eventualmente, para a impressora de talões, logo ou na próxima hora de corte, consoante o canal de pagamento.

Por produto, pode ainda ativar **Impressão térmica** e **Impressão A4** e definir o número de cópias na página do produto. Essas cópias saem a mais assim que esse produto está numa fatura paga.

## Mostrar uma fatura no tablet [#een-factuur-op-de-tablet-tonen]

Quer mostrar uma fatura sem a imprimir? No menu com os três pontos da fatura, escolha **Pré-visualizar no iPad**, ou clique em **Pré-visualizar no iPad** na janela de pagamento de um pagamento em numerário. O PDF aparece no tablet associado e o Tillor indica **PDF enviado para o iPad**. Veja [Tablets e quiosques](/mobiele-app/tablets-en-kiosken).

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- Uma tarefa para uma impressora fica na [fila de impressão](/printer/printwachtrij) com um estado. No momento de impressão, segue para a impressora.
- Se a impressão falhar, o Tillor tenta de novo automaticamente na maioria dos casos. Depois, a tarefa fica em **Falhou** até a repetir ou cancelar.
- A própria fatura não muda: imprimir não lança nem envia nada.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não vejo Enviar para a impressora A4">
Não há conector ativo para a sua organização, ou **Impressão de PDF** está desativada. Veja [Configurar impressoras](/printer/printers-instellen).
</Accordion>
<Accordion title="O Tillor diz A impressão falhou">
A mensagem é **Falha ao enviar o documento para a impressora.** Abra a [fila de impressão](/printer/printwachtrij) para ver o motivo em **Último erro**, por exemplo uma impressora offline ou sem papel.
</Accordion>
<Accordion title="O Tillor diz Falha no descarregamento">
Não foi possível descarregar o PDF. Tente de novo.
</Accordion>
<Accordion title="O Tillor diz PDF não enviado">
O PDF não chegou ao tablet. Nesse caso, não há nenhum tablet acessível. Abra a aplicação Tillor no tablet e veja se está **Ligado** em <UIPath>Definições > Tablets e quiosques</UIPath>.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Gerir a fila de impressão" href="/printer/printwachtrij" description="Acompanhar tarefas e repeti-las" />
  <Card title="Faturas" href="/facturen" description="Gerir e enviar faturas" />
  <Card title="Produtos" href="/producten" description="Definir cópias por produto" />
</Cards>


# Visão geral (/pt-PT/printer)

Com a ligação de impressoras, imprime faturas, talões e etiquetas diretamente a partir do Tillor numa impressora do seu parque, sem ter de descarregar primeiro o documento. Configura as impressoras uma única vez em [Configurar impressoras](/printer/printers-instellen) e depois imprime com um clique ou deixa o Tillor fazê-lo num pagamento.

## Como tudo se liga? [#hoe-hangt-dit-samen]

O Tillor não envia uma tarefa de impressão diretamente para a sua impressora. A tarefa vai primeiro para a fila de impressão. No momento de impressão, o Tillor entrega-a ao conector, um pequeno programa num computador da sua rede, e este faz a impressora imprimir.

```mermaid
flowchart LR
  A[Imprime uma fatura ou<br/>chega um pagamento] --> B[Fila de impressão no Tillor]
  B -- logo ou no momento de impressão --> C[Conector na sua rede]
  C --> D[Impressora]
  B -- falha --> E[O Tillor tenta de novo]
```

Por isso, o conector tem de estar online e a impressora acessível na mesma rede. Sem conector ativo, não vê as opções para enviar para uma impressora. Veja [Conector](/connector).

<Callout type="info" title="Bom saber">
- Há três tipos de impressoras: uma impressora A4 para faturas e documentos, uma impressora térmica para talões de caixa e uma impressora de etiquetas.
- A largura do rolo de talões é 80 mm (por defeito) ou 58 mm.
- Uma tarefa falhada é repetida automaticamente pelo Tillor após 10 segundos, 5 minutos e 15 minutos. Depois fica em **Falhou**. Se o papel acabou ou a impressora está offline, fica logo em **Falhou**.
- Todas as segundas-feiras de manhã, o Tillor tenta mais uma vez todas as tarefas que estão em **Falhou**.
- Pode pausar a impressão por 15 minutos, 1 hora, 4 horas, 6 horas, 1 dia ou até a retomar você mesmo.
- Por defeito, os pagamentos por terminal e os pagamentos manuais imprimem logo. Os pagamentos online, mandatos e transferências esperam pelo próximo momento de impressão.
</Callout>

## O que quer fazer? [#wat-wil-je-doen]

<Cards>
  <Card title="Configurar impressoras" href="/printer/printers-instellen" description="Preencher endereços de rede e escolher momentos de impressão" />
  <Card title="Imprimir documentos" href="/printer/documenten-afdrukken" description="Imprimir uma fatura ou talões após o pagamento" />
  <Card title="Gerir a fila de impressão" href="/printer/printwachtrij" description="Pausar, repetir ou cancelar tarefas" />
  <Card title="Definições de impressão" href="/printer/afdrukinstellingen" description="Todas as definições numa lista" />
</Cards>

## Conceitos [#begrippen]

- **Fila de impressão**: a lista de tarefas de impressão que o Tillor ainda tem de enviar.
- **Momento de impressão**: uma hora fixa num dia da semana em que o Tillor envia tarefas agrupadas, também chamada hora de corte.
- **Impressora térmica**: a impressora de talões de caixa.
- **Conector**: o programa na sua rede que controla a impressora. Veja [Conector](/connector).
- **Endereço IP**: o endereço de rede de uma impressora, por exemplo `192.168.1.100`.

Mais explicações estão na [lista de conceitos](/begrippen).


# Configurar impressoras (/pt-PT/printer/printers-instellen)

Para que o Tillor possa imprimir, tem de saber que impressoras tem e onde estão na sua rede. Define isto uma única vez para toda a sua organização. Depois pode [imprimir documentos](/printer/documenten-afdrukken). Cada definição com explicação está em [Definições de impressão](/printer/afdrukinstellingen).

<Requires permission="Editar definições" />

Antes de começar:

- O conector corre num computador na mesma rede que as impressoras. Veja [Conector](/connector). Se não estiver ativo, mais tarde não verá as opções para enviar para uma impressora.
- Conhece o endereço IP de cada impressora, ou seja, o endereço de rede, por exemplo `192.168.1.100`. Atribua à impressora um endereço fixo no seu router, caso contrário o endereço pode mudar e a impressão deixa de funcionar.

## Adicionar uma impressora [#een-printer-toevoegen]

<Steps>
<Step>
### Abra Imprimir [#open-afdrukken]
Vá a <UIPath>Definições > Imprimir</UIPath>.

<DocScreenshot src="/screenshots/printer/settings-dialog-printers.png" alt="Definições > Imprimir" />
</Step>
<Step>
### Ative a impressão de PDF [#zet-pdf-afdrukken-aan]
Sem este interruptor, o Tillor não imprime nada.
</Step>
<Step>
### Preencha os endereços das impressoras [#vul-de-printeradressen-in]
Em **Endereços IP das impressoras**, preencha o endereço do **IP da impressora PDF** (A4), do **IP da impressora térmica** (talões) e do **IP da impressora de etiquetas**. Deixe vazio o que não tem. Em **Largura do papel de talões**, escolha 80 mm ou 58 mm, consoante o seu rolo de talões.
</Step>
<Step>
### Escolha quando se imprime [#kies-wanneer-er-afgedrukt-wordt]
Em **Horário de corte de impressão**, defina por dia da semana uma ou mais horas (por exemplo 09:00 e 13:30). Em **Momento de impressão automática por tipo de pagamento**, escolha para cada canal de pagamento: **Imprimir imediatamente**, **Próxima hora de corte** ou **Não imprimir automaticamente**.
</Step>
<Step>
### Clique em Guardar definições [#klik-op-instellingen-opslaan]
As definições aplicam-se de imediato a toda a sua organização.
</Step>
</Steps>

## Impressão automática num pagamento [#automatisch-afdrukken-bij-betaling]

Quer que uma fatura paga saia em papel sem intervenção? Ative **Imprimir fatura automaticamente ao pagar**. Por canal de pagamento, define com o momento de impressão acima se isso acontece logo ou na próxima hora de corte.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- A cada impressão, o Tillor coloca uma tarefa na [fila de impressão](/printer/printwachtrij), que o conector passa à impressora.
- As faturas pagas vão automaticamente para a impressora A4 e, eventualmente, para a impressora de talões, se o tiver ativado.
- Se num canal escolher uma hora de corte, o Tillor agrupa as tarefas até esse momento. Se nesse dia não houver momento de impressão, não há momento de corte.
- Experimente com uma fatura, veja [Imprimir documentos](/printer/documenten-afdrukken).

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não vejo Enviar para a impressora A4 numa fatura">
As opções só aparecem se **Impressão de PDF** estiver ativada e houver um conector ativo para a sua organização. Verifique ambos.
</Accordion>
<Accordion title="O Tillor diz A impressora está offline ou não responde">
A impressora está desligada, não tem ligação de rede ou o endereço IP já não está certo. Verifique o endereço em <UIPath>Definições > Imprimir</UIPath> e se o conector está online.
</Accordion>
<Accordion title="O Tillor diz O papel, o toner ou a tinta estão vazios">
Recarregue a impressora e repita a tarefa a partir da fila de impressão.
</Accordion>
<Accordion title="O Tillor diz A impressora não respondeu a tempo">
O conector não recebeu resposta da impressora. Verifique se o conector está a correr e se a impressora está acessível. Veja na fila de impressão se a tarefa foi repetida.
</Accordion>
<Accordion title="Os talões não saem logo">
Verifique em **Momento de impressão automática por tipo de pagamento** se esse canal está em **Próxima hora de corte**. Nesse caso, o talão espera pela hora que escolheu em **Horário de corte de impressão**. Se pausou a impressão, veja a [fila de impressão](/printer/printwachtrij).
</Accordion>
<Accordion title="O talão não cabe no papel">
Verifique a **Largura do papel de talões**: 80 mm ou 58 mm.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Definições de impressão" href="/printer/afdrukinstellingen" description="Todas as definições numa lista" />
  <Card title="Conector" href="/connector" description="O programa que controla a impressora" />
  <Card title="Gerir a fila de impressão" href="/printer/printwachtrij" description="Pausar ou repetir tarefas" />
</Cards>


# Gerir a fila de impressão (/pt-PT/printer/printwachtrij)

Na fila de impressão vê que tarefas de impressão estão à espera, em curso ou falhadas. Aqui pausa a impressão, processa tarefas e resolve as que não correram bem. A lista atualiza-se sozinha assim que uma tarefa muda de estado.

<Requires permission="Editar definições" />

Antes de começar: as impressoras estão configuradas, veja [Configurar impressoras](/printer/printers-instellen).

## Ver a fila [#de-wachtrij-bekijken]

Vá a <UIPath>Administração > Fila de impressão</UIPath>. As listas são:

- **Em fila, agendados e a processar**: tarefas que ainda estão a ser processadas. Uma tarefa com o estado **Agendado para mais tarde** espera pela sua hora **Agendado** e depois é impressa automaticamente, a menos que a impressão esteja em pausa.
- **Falhados**: tarefas que falharam definitivamente, com o motivo em **Último erro**.
- **Todos os trabalhos de impressão**.

## Pausar a impressão [#het-afdrukken-pauzeren]

<Steps>
<Step>
### Escolha Pausar impressão [#kies-afdrukken-pauzeren]
Clique em **Pausar impressão** e escolha uma duração: 15 minutos, 1 hora, 4 horas, 6 horas, 1 dia, ou **Até voltarmos a ativar**.

<DocScreenshot src="/screenshots/printer/print-pause-menu.png" alt="Menu com a duração da pausa" />
</Step>
<Step>
### Retome quando terminar [#hervat-wanneer-je-klaar-bent]
Clique em **Retomar impressão**. Caso contrário, retoma sozinha após a duração escolhida.
</Step>
</Steps>

Durante a pausa, esperam tanto as tarefas imediatas como as agendadas. As novas tarefas ficam na fila. No ícone da pausa aparece até quando dura. Também pode definir a pausa em **Pausar impressão até** em <UIPath>Definições > Imprimir</UIPath>.

## Processar ou recuperar tarefas [#opdrachten-doorzetten-of-herstellen]

<Tabs items={["As tarefas ficam paradas", "Uma tarefa falhou"]}>
<Tab value="As tarefas ficam paradas">
Clique na barra de ferramentas da lista em **Processar fila**. As tarefas agendadas são então processadas logo. O botão fica cinzento enquanto a impressão estiver em pausa, com a dica **Retome a impressão para processar a fila**.
</Tab>
<Tab value="Uma tarefa falhou">
Abra o menu com os três pontos na linha e escolha **Repetir** para o enviar outra vez, ou **Cancelar**. Uma tarefa cancelada recebe o estado **Cancelado** e já não é impressa.
</Tab>
</Tabs>

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- Uma tarefa falhada é repetida pelo próprio Tillor após 10 segundos, depois após 5 minutos e depois após 15 minutos. Se mesmo assim não resultar, fica em **Falhou**.
- Os erros que uma nova tentativa não resolve, o Tillor não repete: papel, toner ou tinta esgotados, uma impressora offline ou em pausa, ou uma fila da impressora desativada. Ficam logo em **Falhou**.
- Todas as segundas-feiras de manhã, o Tillor volta a preparar uma vez todas as tarefas que estão em **Falhou**.
- Uma tarefa que permanece em **Falhou** não faz nada até a repetir ou cancelar.

## Problemas? [#problemen]

<Accordions>
<Accordion title="A tarefa está em Falhou com A impressora está offline ou não responde">
Ligue a impressora, verifique a ligação de rede e se o conector está online. Depois escolha **Repetir**.
</Accordion>
<Accordion title="A tarefa diz O papel, o toner ou a tinta estão vazios">
Recarregue a impressora e escolha **Repetir**.
</Accordion>
<Accordion title="A tarefa diz A impressão está em pausa. Verifique o papel, o toner ou a tinta.">
A própria impressora está em pausa, por exemplo devido a um encravamento de papel. Resolva isso na impressora e tente de novo.
</Accordion>
<Accordion title="A tarefa diz O trabalho de impressão perdeu-se ou não terminou na impressora">
A tarefa foi enviada para a impressora mas não terminou. Verifique se já saiu alguma coisa antes de repetir, caso contrário sai em duplicado.
</Accordion>
<Accordion title="A tarefa diz A fila da impressora está desativada">
A fila na própria impressora está desligada. Ative-a na impressora e tente de novo.
</Accordion>
<Accordion title="Processar fila está cinzento">
A impressão está em pausa. Escolha **Retomar impressão**.
</Accordion>
<Accordion title="O Tillor diz Não foi possível iniciar o processamento da fila de impressão">
Não foi possível processar a fila. Tente mais uma vez. Se não resultar, verifique se o conector está online.
</Accordion>
<Accordion title="O Tillor diz Não foi possível repetir o trabalho de impressão">
Tente de novo, ou cancele a tarefa e imprima o documento outra vez a partir da fatura.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Configurar impressoras" href="/printer/printers-instellen" description="Endereços de rede e momentos de impressão" />
  <Card title="Imprimir uma fatura ou talão" href="/printer/documenten-afdrukken" description="Criar tarefas" />
</Cards>


# Associar ações a um produto (/pt-PT/producten/acties-instellen)

Com as ações automatiza o que acontece depois de lançar ou pagar uma fatura: carregar uma etiqueta NFC, prorrogar uma ocupação, imprimir um talão ou criar um método de acesso. Um produto pode ter várias ações em simultâneo.

<Requires permission="Editar produtos" />

Antes de começar: o produto já existe. Veja [Criar um produto](/producten/product-aanmaken). Um esquema do que o Tillor faz e quando está em [Como tudo se liga?](/producten#hoe-hangt-dit-samen).

<Steps>
<Step>
### Abra o produto [#open-het-product]

Vá a <UIPath>Administração > Produtos</UIPath> e abra o produto.
</Step>
<Step>
### Assinale as ações [#vink-de-acties-aan]

Procure à direita o cartão **Ações de linha de fatura**. Assinale as ações que pretende. Em algumas ações aparecem depois campos adicionais. O que cada ação faz e que campos lhe pertencem, leia em [Ações de produto](/producten/productacties).

Deixe todas as caixas desmarcadas para uma tarifa normal sem seguimento.
</Step>
<Step>
### Guarde [#sla-op]

Clique em **Guardar** no fundo do cartão **Linhas de fatura extra**. As ações ficam agora no produto e são copiadas para as novas linhas de fatura.
</Step>
</Steps>

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

Quando escolhe o produto numa linha de fatura, o Tillor copia as ações com os valores definidos para essa linha. Que ação faz o quê e quando depende do tipo. Algumas ações correm ao lançar a fatura, a maioria no pagamento.

| Momento | Ações |
|--------|--------|
| Ao lançar | **Prorrogar período de ocupação** (ajusta **Faturado até**), **Pedir dados de contacto** (só pode lançar quando os campos obrigatórios estão preenchidos), criar reserva em **Período** com **Pedir parcela** |
| Ao pagar | **Carregar etiqueta NFC**, **Período**, **Prorrogar período de ocupação** (ajusta **Pago até**), **Prorrogar método de acesso**, **Criar método de acesso**, **Impressão térmica** e **Impressão A4** |
| Sem efeito | **Consumo do contador** (determina a tarifa), **Mostrar alerta** (mostra um texto) |
| Bloqueia o lançamento | **Impedir lançamento** |

Na lista de produtos vê, na coluna **Ação**, que ações estão num produto.

<Callout type="info">
Uma alteração às ações de um produto aplica-se às linhas de fatura que adicionar depois.
</Callout>

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não vejo o campo que procuro">
Os campos adicionais só aparecem depois de assinalar a ação correspondente. **Registar entrada ao reservar** e **Registar a entrada no pagamento** só aparecem se **Pedir parcela** estiver ativado.
</Accordion>
<Accordion title="A ação não acontece no pagamento">
Verifique se a ação está preenchida na própria linha de fatura. Em **Criar método de acesso**, por exemplo, tem de estar escolhido um tipo. Sem tipo, o Tillor não cria nada e, numa linha que não é opcional, não pode lançar a fatura.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Ações de produto" href="/producten/productacties" description="Todas as ações e as suas definições" />
  <Card title="Configurar linhas de fatura extra" href="/producten/bundel-instellen" />
</Cards>


# Configurar linhas de fatura extra (/pt-PT/producten/bundel-instellen)

Alguns produtos são mais do que uma linha numa fatura: Staangeld com suplementos, uma explicação, aluguer de contador ou etiquetas NFC. Para isso, configura no produto principal um conjunto de linhas extra. Se alguém escolher esse produto como linha principal numa fatura em rascunho, o Tillor adiciona as linhas filhas por baixo dessa linha principal, pela ordem que definir.

```mermaid
flowchart TD
  hoofd[Linha principal: produto com conjunto] --> stap1[Passo 1 no conjunto]
  stap1 --> kind1[Linha filha na fatura]
  hoofd --> stap2[Passo 2 no conjunto]
  stap2 --> kind2[Linha filha na fatura]
```

<Requires permission="Editar produtos" />

## Criar ou editar um conjunto [#een-bundel-aanmaken-of-bewerken]

<Steps>
<Step>
### Abra o produto principal [#open-het-hoofdproduct]

Vá a <UIPath>Administração > Produtos</UIPath> e abra o produto, por exemplo Staangeld.
</Step>
<Step>
### Inicie o conjunto [#start-de-bundel]

Procure o cartão **Linhas de fatura extra** em **Geral**. Se o produto ainda não tem conjunto, clique em **Configurar conjunto**.
</Step>
<Step>
### Adicione passos [#voeg-stappen-toe]

Clique em **Passo de produto** para uma linha com um produto e um montante, ou em **Passo de informação** para uma linha só com texto. Preencha os campos de cada passo. O que cada campo faz está em [Passos do conjunto](/producten/bundel-velden).
</Step>
<Step>
### Coloque os passos na ordem certa [#zet-de-stappen-in-de-juiste-volgorde]

Com as setas **Mover passo para cima** e **Mover passo para baixo** define a ordem na fatura. **Remover passo** retira um passo.
</Step>
<Step>
### Guarde [#sla-op]

Clique em **Guardar** no fundo do cartão.
</Step>
</Steps>

<Callout type="info">
**Guardar** em **Linhas de fatura extra** guarda a página de produto inteira, também as alterações em **Geral** e em **Ações de linha de fatura**. Cada passo de produto tem de ter um produto e cada passo de informação um texto. Caso contrário, o Tillor não guarda o conjunto.
</Callout>

Com **Remover o conjunto inteiro** desativa o conjunto. Um conjunto pode ter no máximo 40 passos.

## Exemplo: um conjunto de Staangeld [#voorbeeld-een-staangeld-bundel]

Um conjunto típico para Staangeld tem cinco passos. Os passos com fórmula colam a fórmula de [Passos do conjunto](/producten/bundel-velden#voorbeelden) no campo **Fórmula**.

<Steps>
<Step>
### Explicação [#toelichting]

Um **Passo de informação** com o texto "Inclusief toeristen-, gemeente- en provincietaksen".
</Step>
<Step>
### Primeira NFC incluída [#eerste-nfc-inbegrepen]

Um **Passo de produto** com o produto de suplemento NFC e uma fórmula que devolve a primeira etiqueta NFC ativa do cliente com quantidade 0 e preço 0. Ative **Multiplicar pela quantidade da linha âncora** e **Uma vez por fatura**, escolha **Estilo da linha** **INFO** e em **Dias extra após o fim da linha principal (métodos de acesso)** preencha, por exemplo, `20`.
</Step>
<Step>
### Etiquetas NFC extra [#extra-nfc-tags]

O mesmo passo de produto com uma fórmula que devolve a segunda, terceira, etc., etiqueta NFC ativa à tarifa do produto, com as mesmas opções de escala e prorrogação. Ative também aqui **Uma vez por fatura**.
</Step>
<Step>
### Aluguer de contador [#meterhuur]

Um **Passo de produto** com o produto de aluguer de contador e uma fórmula que escolhe a partir de `{meters}` os contadores que contam, por exemplo apenas contadores de eletricidade ICY com supply ligado, e devolve por contador uma linha com o nome do contador na descrição.
</Step>
<Step>
### Cães [#honden]

Um **Passo de produto** com o produto para cães e uma fórmula que lê o número de cães de um campo próprio do cliente e devolve uma linha com esse número, ou nenhuma linha se não houver cães.
</Step>
</Steps>

## Prorrogar NFC através do conjunto [#nfc-verlengen-via-de-bundel]

Para Staangeld com etiquetas NFC, três coisas andam juntas:

1. No produto principal está a ação **Prorrogar período de ocupação**, e na linha de fatura está escolhida uma parcela.
2. No conjunto há pelo menos um passo com **Dias extra após o fim da linha principal (métodos de acesso)** preenchido, por exemplo os passos NFC do exemplo acima.
3. No produto principal está a ação **Prorrogar método de acesso** com os tipos e estados pretendidos e, eventualmente, um dia da semana e hora de fim.

No pagamento de uma linha de um passo desses, o Tillor define a validade dos métodos de acesso do cliente para a data de fim da linha principal de Staangeld mais os dias extra. Por defeito, vai até às 23:59 no fuso horário da organização, ou até ao dia da semana e hora que definiu em **Prorrogar método de acesso**. Se a linha principal não tiver data de fim, o Tillor não prorroga nada.

<Callout type="warn" title="Atenção">
**Dias extra após o fim da linha principal (métodos de acesso)** só funciona se o produto tiver **Prorrogar período de ocupação** como ação. Se por baixo do campo aparecer a indicação de que isto é necessário, assinale à direita, em **Ações de linha de fatura**, **Prorrogar período de ocupação**.
</Callout>

## O que acontece numa fatura em rascunho? [#wat-gebeurt-er-op-een-conceptfactuur]

- As linhas filhas só aparecem por baixo da linha principal depois de escolher uma parcela em **Prorrogar período de ocupação**.
- O Tillor reconstrói as linhas filhas se na linha principal alterar o produto, a quantidade ou a parcela. Nos outros casos, as linhas filhas ajustadas manualmente mantêm-se. Se, por exemplo, retirar uma linha de contador, ela não volta sozinha.
- No editor de faturas vê uma pré-visualização das linhas filhas, incluindo o efeito de **Uma vez por fatura**, para que corresponda ao que fica depois de guardar.
- Uma linha principal só se move com as setas como bloco inteiro. As linhas filhas só se deslocam dentro do seu conjunto. Se eliminar a linha principal, as linhas filhas desaparecem com ela.
- No PDF, as linhas filhas normais recebem muitas vezes um **↳** antes da descrição. As linhas de informação aparecem como linhas cinzentas sem montantes.
- Os passos sem produto escolhido, o Tillor ignora-os. Um produto entretanto eliminado ou em falta não gera, portanto, nenhuma linha.

## Problemas? [#problemen]

<Accordions>
<Accordion title="As linhas filhas não aparecem por baixo da linha principal">
Num produto principal com **Prorrogar período de ocupação**, tem primeiro de escolher uma parcela na linha principal. Para a prorrogação de NFC no pagamento, a linha principal precisa ainda de uma data de fim.
</Accordion>
<Accordion title="O mesmo suplemento aparece em duplicado na fatura">
Se houver duas ou mais linhas principais com um conjunto numa fatura, cada linha principal recebe as linhas do conjunto. Ative **Uma vez por fatura** nos passos que só podem aparecer uma vez. O passo passa então a pertencer apenas à primeira linha principal pela ordem da fatura.
</Accordion>
<Accordion title="O conjunto não é guardado">
Verifique se cada passo de produto tem um **Produto** e cada passo de informação um **Texto da linha de informação**.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Passos do conjunto" href="/producten/bundel-velden" description="Campos, chaves dinâmicas e marcadores" />
  <Card title="JSON do conjunto" href="/producten/bundel-json" />
  <Card title="Ações de produto" href="/producten/productacties" />
</Cards>


# JSON do pacote (/pt-PT/producten/bundel-json)

O cartão **Linhas de fatura extra** grava um pacote como JSON no produto, sob a chave `invoiceBundle`. Para importações, use a mesma estrutura. Para a utilização normal não precisa desta página: os campos e a respetiva explicação estão em [Passos do pacote](/producten/bundel-velden).

## Estrutura [#structuur]

| Campo | Significado |
|------|-----------|
| `invoiceBundle.version` | Sempre `1` |
| `invoiceBundle.steps` | Lista de passos, no máximo 40. A ordem é a ordem das linhas filhas na fatura |

Cada passo é um passo de produto ou um passo de informação.

### Passo de produto [#productstap]

| Campo | Significado |
|------|-----------|
| `productId` | Um produto existente na sua organização. Obrigatório |
| `quantity` | Número maior que 0, por omissão `1`. A quantidade da linha sem fórmula, ou quando a fórmula devolve `true` |
| `quantityScale` | Opcional. `"anchor_line_quantity"` multiplica cada quantidade calculada pela quantidade da linha principal |
| `description` | Opcional. Texto da linha de fatura em vez do nome do produto; uma fórmula pode indicar uma `description` própria por linha |
| `style` | Opcional. `DEFAULT` ou `INFO` |
| `billOncePerInvoice` | Opcional. `true` mantém o passo, quando há várias linhas principais numa fatura, na primeira linha principal |
| `extendAccessMethod` | Opcional. `{ "daysAfterPeriodEnd": <número inteiro, 0 a 3660> }`, ver [Prorrogação NFC](#nfc-verlenging) |
| `formula` | Opcional. TypeScript que determina que linhas o passo produz, ver [Fórmula](#formule) |

### Passo de informação [#inforestap]

```json
{
  "stepKind": "info",
  "description": "Inclusief toeristen-, gemeente- en provincietaksen"
}
```

`description` é obrigatório e um passo de informação não tem `productId`. Com `style` (`DEFAULT` ou `INFO`) escolhe o estilo da linha; por omissão é `INFO`. Uma `formula` que devolva `false` omite a linha de informação.

## Fórmula [#formule]

`formula` é TypeScript que, ao guardar uma fatura, devolve `true` (uma linha com `quantity`), `false` (nenhuma linha), um número (a quantidade) ou uma lista de linhas `{ "quantity", "description", "unitPrice", "accessMethodValue" }`. Os campos e listas que pode ler e o que cada forma faz estão em [Fórmula por passo](/producten/bundel-velden#formule-per-stap). Uma fórmula que não compila é recusada ao guardar o produto. Em JSON, a fórmula é uma única string com `\n` para as quebras de linha.

```json
"formula": "return {customer.customFields.exemptFromSurcharges} !== true;"
```

## Prorrogação NFC [#nfc-verlenging]

Só faz sentido quando o produto principal tem **Prorrogar período de ocupação** como ação.

```json
"extendAccessMethod": { "daysAfterPeriodEnd": 20 }
```

Quando é paga uma linha de um passo deste tipo, o Tillor define a validade dos métodos de acesso do cliente como a data de fim da linha principal mais `daysAfterPeriodEnd` dias de calendário. Por omissão, a validade vai até às 23:59 no fuso horário da organização, ou até ao dia da semana e hora de **Prorrogar método de acesso** no produto principal. Os tipos e estados que contam também são definidos aí. Sem data de fim na linha principal, nada acontece. Com **Não encurtar ao prorrogar** ativo, o Tillor ignora os métodos cuja validade já seja igual ou posterior à nova data. Um `accessMethodValue` na linha indica o método dessa linha; a prorrogação em si segue as definições do produto principal.

Após uma prorrogação bem-sucedida, a linha cronológica da fatura mostra uma entrada que remete para o pagamento.

## Exemplo: nota explicativa, suplemento NFC, aluguer de contador e cães [#voorbeeld-toelichting-nfc-toeslag-meterhuur-en-honden]

```json
{
  "invoiceBundle": {
    "version": 1,
    "steps": [
      {
        "stepKind": "info",
        "description": "Inclusief toeristen-, gemeente- en provincietaksen"
      },
      {
        "productId": "prd_nfc_toeslag",
        "quantity": 1,
        "quantityScale": "anchor_line_quantity",
        "extendAccessMethod": { "daysAfterPeriodEnd": 20 },
        "style": "INFO",
        "billOncePerInvoice": true,
        "formula": "const nfc = {accessMethods}.filter((a) => a.type === \"NFC\" && a.status === \"ACTIVE\");\nreturn nfc.slice(0, 1).map((a) => ({ quantity: 0, unitPrice: 0, accessMethodValue: a.value, description: `Toegangsmethode inclusief: ${a.label}` }));"
      },
      {
        "productId": "prd_nfc_toeslag",
        "quantity": 1,
        "quantityScale": "anchor_line_quantity",
        "extendAccessMethod": { "daysAfterPeriodEnd": 20 },
        "billOncePerInvoice": true,
        "formula": "const nfc = {accessMethods}.filter((a) => a.type === \"NFC\" && a.status === \"ACTIVE\");\nreturn nfc.slice(1).map((a) => ({ quantity: 1, accessMethodValue: a.value, description: `Toeslag extra toegangsmethode: ${a.label}` }));"
      },
      {
        "productId": "prd_meterhuur",
        "quantity": 1,
        "quantityScale": "anchor_line_quantity",
        "formula": "return {meters}.filter((m) => m.provider === \"ICY\" && m.type === \"ELECTRICITY\" && m.icyMetadata?.switchState === true).map((m) => ({ quantity: 1, description: `Huur digitale elektriciteitsmeter ${m.name}` }));"
      },
      {
        "productId": "prd_hond",
        "quantity": 1,
        "quantityScale": "anchor_line_quantity",
        "billOncePerInvoice": true,
        "formula": "const dogs = Math.max(0, Math.floor(Number({customer.customFields.animals.dogs}) || 0));\nreturn dogs === 0 ? false : [{ quantity: dogs, description: `Honden (${dogs})` }];"
      }
    ]
  }
}
```

<Callout type="warn" title="Atenção">
Verifique se todos os valores `productId` nos passos de produto existem no seu catálogo. O Tillor ignora os passos com um produto desconhecido.
</Callout>

## Ver também [#zie-ook]

<Cards>
  <Card title="Passos do pacote" href="/producten/bundel-velden" />
  <Card title="Configurar linhas de fatura extra" href="/producten/bundel-instellen" />
</Cards>


# Passos do pacote (/pt-PT/producten/bundel-velden)

Esta página descreve os campos do cartão **Linhas de fatura extra** na página do produto. Como construir um pacote está em [Configurar linhas de fatura extra](/producten/bundel-instellen).

## Passo de produto [#productstap]

O Tillor converte um passo de produto em zero, uma ou mais linhas de fatura com esse produto. Sem fórmula, é uma linha com a quantidade definida; com uma [fórmula](#formule-per-stap) é você quem determina se há linhas, quantas e quais.

| Campo | O que faz |
|------|--------------|
| **Produto** | O produto que fica na linha filha, por exemplo um suplemento NFC ou o aluguer de um contador. Obrigatório |
| **Quantidade** | A quantidade da linha quando o passo não tem fórmula, ou quando a fórmula devolve `true`. Maior que 0 |
| **Multiplicar pela quantidade da linha âncora** | Multiplica cada quantidade calculada pela quantidade da linha principal, por exemplo 0,5 num semestre de Estacionamento. O resultado é arredondado a duas casas decimais. O Tillor omite as linhas que, por isso, ficam a 0; uma linha que a própria fórmula devolve com quantidade 0 mantém-se |
| **Descrição (opcional)** | Substitui o nome do produto na linha de fatura. Uma fórmula que devolve linhas pode dar a cada linha uma descrição própria |
| **Estilo da linha** | **Predefinido (produto)**, **DEFAULT** ou **INFO**. Com **INFO**, a linha filha torna-se uma nota cinzenta no PDF e no editor |
| **Uma vez por fatura** | Só é relevante quando há duas ou mais linhas principais com um pacote na mesma fatura. O passo pertence então apenas à primeira linha principal pela ordem da fatura |
| **Dias extra após o fim da linha principal (métodos de acesso)** | Só faz sentido quando o produto principal tem **Prorrogar período de ocupação** como ação. Quando é paga uma linha deste passo, o Tillor prorroga os métodos de acesso do cliente até à data de fim da linha principal mais este número de dias; os tipos e estados vêm de **Prorrogar método de acesso** no produto principal, ver [Prorrogar NFC através do pacote](/producten/bundel-instellen#nfc-verlengen-via-de-bundel) |
| **Fórmula** | Opcional. TypeScript que determina se o passo entra na fatura, com que quantidade, ou que linhas exatamente, ver [Fórmula por passo](#formule-per-stap) |

## Passo de informação [#inforestap]

Um passo de informação é apenas texto, sem produto nem montante. O Tillor mostra-o como linha explicativa.

| Campo | O que faz |
|------|--------------|
| **Texto da linha de informação** | O texto visível, por exemplo "Inclusief toeristen-, gemeente- en provincietaksen". Obrigatório |
| **Estilo da linha** | Por omissão **INFO**. Pode escolher **DEFAULT** se quiser mostrar a linha como uma linha normal |
| **Fórmula** | Opcional. Se a fórmula devolver `false`, a linha de informação é omitida |

Se um passo de informação estiver sob uma linha principal, o PDF coloca automaticamente **↳** antes do texto.

## Fórmula por passo [#formule-per-stap]

Cada passo pode ter uma **Fórmula**: TypeScript, tal como a [fórmula de tarifa](/terreinen#tariefformule), que o Tillor executa ao guardar uma fatura com este pacote. Assim, um passo pode depender do cliente, da ocupação, do terreno, dos contadores ou dos métodos de acesso, por exemplo através de um [campo personalizado](/eigen-velden) em que mantém uma exceção.

### O que a fórmula devolve [#wat-de-formule-teruggeeft]

| Valor devolvido | Efeito |
|---------------------|--------|
| `true` | Uma linha com a **Quantidade** definida |
| `false` ou `null` | Nenhuma linha |
| Um número maior que 0 | Uma linha com esse número como quantidade |
| Uma lista de linhas | Exatamente essas linhas, por essa ordem. Uma lista vazia significa nenhuma linha |

Uma linha numa lista deste tipo é um objeto com estes campos:

| Campo | Significado |
|------|-----------|
| `quantity` | Obrigatório. A quantidade, 0 ou mais. Uma linha com 0 mantém-se, mesmo com **Multiplicar pela quantidade da linha âncora** |
| `description` | Opcional. A descrição desta linha; caso contrário, a **Descrição** do passo, caso contrário, o nome do produto |
| `unitPrice` | Opcional. Preço unitário com IVA incluído, como a tarifa do produto; caso contrário, a tarifa do produto. `0` cria uma linha gratuita |
| `accessMethodValue` | Opcional. O valor do método de acesso a que esta linha diz respeito (o UID da etiqueta NFC), para a prorrogação no pagamento |

### O que a fórmula pode ler [#wat-de-formule-kan-lezen]

Os campos são lidos com chavetas, como nas automatizações. O menu **Variável** junto ao campo mostra tudo o que está disponível, incluindo os seus campos personalizados.

| Variável | O que é |
|-----------|------------|
| `{customer.…}` | O cliente da fatura, por exemplo `{customer.createdAt}` ou `{customer.customFields.meterhuurVrijgesteld}` |
| `{occupation.…}` | A ocupação da linha principal. Se o produto principal não estiver em **Prorrogar período de ocupação**, a única ocupação do cliente; vazio (`null`) se o cliente ocupar vários terrenos |
| `{terrain.…}` | O terreno dessa ocupação |
| `{anchor.…}` | A linha principal: `{anchor.quantity}` (por exemplo 0,5 num semestre), `{anchor.terrainId}`, `{anchor.occupationId}` e `{anchor.endDate}` |
| `{meters}` | A lista de contadores no âmbito: no terreno da linha principal com **Prorrogar período de ocupação**, caso contrário em todos os terrenos que o cliente ocupa. Cada contador tem `name`, `provider` (por exemplo `ICY`), `type` (por exemplo `ELECTRICITY`, `GAS`), os metadados do seu fornecedor (por exemplo `icyMetadata.switchState` para fornecimento ligado), o seu `terrain` e `customFields` |
| `{accessMethods}` | A lista de métodos de acesso do cliente, os mais antigos primeiro, de todos os tipos e estados. Cada método tem `type` (por exemplo `NFC`), `status` (por exemplo `ACTIVE`), `value`, uma `label` legível (o nome conhecido da etiqueta NFC, caso contrário o valor) e `customFields` |

O Tillor só carrega as listas `{meters}` e `{accessMethods}` se a fórmula as utilizar.

### Exemplos [#voorbeelden]

Ignorar um passo para clientes isentos:

```ts
if ({customer.customFields.exemptFromSurcharges} === true) return false;
return true;
```

Uma linha por contador de eletricidade ICY com fornecimento ligado e, para clientes desde 2026, também com fornecimento desligado:

```ts
const newCustomer = new Date({customer.createdAt} ?? 0) >= new Date("2026-01-01T00:00:00+01:00");
return {meters}
  .filter((m) => m.provider === "ICY" && m.type === "ELECTRICITY")
  .filter((m) => m.icyMetadata?.switchState === true || newCustomer)
  .map((m) => ({ quantity: 1, description: `Huur digitale elektriciteitsmeter ${m.name}` }));
```

A primeira etiqueta NFC gratuita como nota explicativa, cada uma das seguintes pela tarifa do produto (dois passos com o mesmo produto, ou um passo que devolve os dois tipos de linhas):

```ts
const nfc = {accessMethods}.filter((a) => a.type === "NFC" && a.status === "ACTIVE");
return nfc.map((a, i) => ({
  quantity: i === 0 ? 0 : 1,
  unitPrice: i === 0 ? 0 : undefined,
  accessMethodValue: a.value,
  description: i === 0 ? `Toegangsmethode inclusief: ${a.label}` : `Toeslag extra toegangsmethode: ${a.label}`,
}));
```

Uma linha com o número de cães a partir de um campo personalizado do cliente, nenhuma linha sem cães:

```ts
const dogs = Math.max(0, Math.floor(Number({customer.customFields.animals.dogs}) || 0));
return dogs === 0 ? false : [{ quantity: dogs, description: `Honden (${dogs})` }];
```

Com **Inserir exemplo** por baixo do campo, obtém um ponto de partida com estas formas em comentário.

### Erros [#fouten]

Uma fórmula que não compila não pode ser guardada; a mensagem por baixo do campo indica o que está errado. Se uma fórmula bloquear ao guardar uma fatura, ou devolver algo diferente de `true`, `false`, um número ou linhas válidas, o guardar falha com o nome do passo na mensagem de erro, para que uma fórmula avariada nunca acrescente ou omita uma linha em silêncio.

## Ver também [#zie-ook]

<Cards>
  <Card title="Configurar linhas de fatura extra" href="/producten/bundel-instellen" />
  <Card title="JSON do pacote" href="/producten/bundel-json" />
  <Card title="Gestão de contadores" href="/meterbeheer" />
</Cards>


# Visão geral (/pt-PT/producten)

Um produto é uma tarifa ou serviço que coloca numa linha de fatura: uma noite num terreno, uma subscrição mensal, uma etiqueta NFC ou um kWh de eletricidade. Cada produto tem um preço com IVA incluído. Também pode associar-lhe ações que o Tillor executa automaticamente, como prorrogar uma ocupação ou imprimir um talão. Os utilizadores com a permissão **Editar produtos** podem criar e alterar produtos.

Encontra todos os produtos em <UIPath>Administração > Produtos</UIPath>.

<DocScreenshot src="/screenshots/producten/products-list.png" alt="Lista de produtos com um produto de demonstração para uma noite" />

<Callout type="info" title="Bom saber">
- O preço é sempre com IVA incluído. Escolhe 0%, 6%, 9%, 12% ou 21%.
- Uma alteração de preço, conta contabilística ou ações vale para as linhas que acrescentar depois. As faturas existentes não mudam.
- Pode agendar um novo preço a partir de hoje ou de um dia posterior, não para o passado.
- Um produto desativado já não pode ser escolhido em faturas, mas continua nas faturas existentes.
- Um produto eliminado não pode ser recuperado. Prefira desativá-lo.
- Por cada combinação de tipo de cliente e tipo de contador existe apenas um produto com a ação **Consumo do contador**.
- Um **Mostrar alerta** pode ter no máximo 4000 carateres.
- Por impressora, define no máximo 10 cópias na impressão automática.
- Em **Prorrogar método de acesso** conta no máximo 3660 dias após a data de fim.
</Callout>

## Como se liga tudo? [#hoe-hangt-dit-samen]

Um produto não faz nada enquanto não constar de uma fatura. Se o produto tiver ações, o Tillor passa-as para a linha de fatura. Lançar e pagar iniciam essas ações, e assim o resultado chega à ocupação, à etiqueta ou à impressora.

```mermaid
flowchart TD
  P[Produto com ações] --> R[Linha de fatura numa fatura em rascunho]
  R -- Lançar --> G[Fatura lançada]
  G --> G1[Ocupação: Faturado até avança]
  G --> G2[Reserva criada com Pedir parcela]
  G --> G3[Lançamento bloqueado ou dados de contacto pedidos]
  G -- Pagar --> B[Fatura paga]
  B --> B1[Ocupação: Pago até avança]
  B --> B2[Etiqueta NFC carregada]
  B --> B3[Método de acesso criado ou prorrogado]
  B --> B4[Talão ou A4 impresso]
```

Um exemplo com **Prorrogar período de ocupação**: fatura a renda mensal de um cliente. Ao lançar, a ocupação fica faturada até ao fim do mês. Assim que o cliente paga, **Pago até** avança. Assim vê na ocupação o que já foi faturado e o que já foi pago. Mais sobre isto em [Ocupações](/bezettingen#betaald-tot-type-huurfrequentie-en-prijs).

Uma nota de crédito inverte isto: lançar repõe **Faturado até** no início da linha, pagar repõe **Pago até**. Veja [Transferência interna](/betalingsverwerking/interne-overboeking) para o caso em que uma nota de crédito é compensada apenas com a fatura original.

## O que vê na lista [#wat-je-in-de-lijst-ziet]

| Coluna | Conteúdo |
|-------|--------|
| **Nome** e **Descrição** | Nome e explicação tal como os preencheu no produto |
| **Info** | Tipo de cliente e tipo de contador, apenas em produtos com a ação **Consumo do contador** |
| **Ação** | As ações que o produto tem. Com várias ações, a coluna mostra um resumo |
| **Preço (c/ IVA)** | Preço por unidade |
| **% IVA** | A taxa de IVA |
| **Conta contabilística** | O número da conta contabilística, se o tiver preenchido |

Na linha encontra um ícone de lápis para abrir o produto e um ícone de caixote do lixo para o eliminar. Ambos ficam desativados se não tiver a permissão **Editar produtos**.

### Pesquisar e filtrar [#zoeken-en-filteren]

Escreva na barra de pesquisa para filtrar a lista de imediato. Além disso, pode filtrar por **IVA**, **Tipo de cliente**, **Tipo de contador**, **Tipo de ação**, **Estado** (<Status tone="success">Ativo</Status> ou <Status>Desativado</Status>) e **Contas**. Com **Repor** limpa os filtros de uma só vez.

## Ver também [#zie-ook]

<Cards>
  <Card title="Criar um produto" href="/producten/product-aanmaken" description="Definir nome, preço, IVA e conta contabilística" />
  <Card title="Editar ou eliminar um produto" href="/producten/product-bewerken" description="Alterar dados, desativar ou eliminar" />
  <Card title="Agendar uma alteração de preço" href="/producten/prijzen-plannen" description="Um novo preço a partir de uma data e a calculadora de IVA" />
  <Card title="Associar ações a um produto" href="/producten/acties-instellen" description="Faça o Tillor agir ao lançar ou pagar" />
  <Card title="Ações de produto" href="/producten/productacties" description="Todas as ações e as respetivas definições" />
  <Card title="Configurar linhas de fatura extra" href="/producten/bundel-instellen" description="Colocar automaticamente suplementos e notas explicativas sob uma linha principal" />
  <Card title="Passos do pacote" href="/producten/bundel-velden" description="Campos, chaves dinâmicas e marcadores de posição" />
  <Card title="JSON do pacote" href="/producten/bundel-json" description="A estrutura do pacote para importações" />
  <Card title="Exemplos práticos" href="/praktijk" description="Exemplos detalhados da prática" />
</Cards>

## Conceitos [#begrippen]

- **Produto**: um preço e uma descrição que podem constar de uma linha de fatura.
- **Ação**: algo que o Tillor faz automaticamente quando uma linha de fatura com este produto é lançada ou paga.
- **Pacote**: uma série de linhas de fatura extra que o Tillor coloca sob uma linha principal, por exemplo suplementos no Estacionamento.
- **Linha principal e linha filha**: a linha principal é a linha com o produto do pacote, as linhas filhas são as que o Tillor acrescenta por baixo.
- **Faturado até** e **Pago até**: até quando uma ocupação está faturada, respetivamente paga. Veja [Ocupação](/begrippen#bezetting).
- **Conta contabilística**: o número de conta na sua contabilidade em que um produto lança.


# Agendar uma alteração de preço (/pt-PT/producten/prijzen-plannen)

Se o preço de um produto muda a partir de um determinado dia, agende-o com antecedência. Nesse dia, o Tillor altera o preço do produto por si. As faturas existentes mantêm os seus preços.

<Requires permission="Producten bewerken" />

## Agendar um preço [#een-prijs-plannen]

<Steps>
<Step>
### Abrir o produto [#open-het-product]
Aceda a <UIPath>Administração > Produtos</UIPath> e abra o produto. Na parte inferior da página encontra o cartão **Preços agendados**.

<DocScreenshot src="/screenshots/producten/product-price-changes.png" alt="Cartão Preços agendados com um preço agendado e um preço aplicado" />
</Step>
<Step>
### Escolher a data [#kies-de-datum]
Em **A partir de**, escolha o dia em que o novo preço entra em vigor. Hoje também é possível, um dia no passado não.
</Step>
<Step>
### Preencher o preço [#vul-de-prijs-in]
Escreva o **Novo preço (IVA incl.)**. Em **Taxa de IVA**, deixe **Taxa de IVA atual** ou escolha outra taxa que passa a valer nesse dia. Também pode escolher um [regime sem IVA](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw), como **Autoliquidação (serviços UE)**; o produto fica então a 0% nesse regime a partir desse dia.
</Step>
<Step>
### Agendar o preço [#plan-de-prijs]
Clique em **Agendar preço**. O preço aparece na lista com o estado <Status tone="info">Agendado</Status>.
</Step>
</Steps>

Se escolher hoje como data, o novo preço vale de imediato. Para uma data posterior, o preço vale desde o início desse dia. O Tillor usa o fuso horário da sua organização.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

O produto passa a ter o novo preço e, se for o caso, a nova taxa de IVA. A linha na lista fica com o estado <Status tone="success">Aplicado</Status>. O Tillor envia um e-mail para o endereço de suporte da sua organização ou, se não existir, para o endereço de e-mail geral. A notificação chama-se **Preço de produto agendado aplicado** e mostra o preço antigo e o novo. Veja também [Notificações](/notificaties).

As faturas que já existem não mudam. Só as linhas que acrescentar depois recebem o novo preço.

## Alterar ou remover um preço agendado [#een-geplande-prijs-wijzigen-of-verwijderen]

- Se agendar novamente um preço para o mesmo dia enquanto ainda existe um preço agendado, o novo substitui o antigo.
- Clique no ícone do caixote do lixo junto a um preço agendado e confirme com **Remover preço agendado**. O produto mantém nessa data o seu preço atual.
- Um preço com o estado <Status tone="success">Aplicado</Status> fica como histórico e não pode ser removido.

## A calculadora de IVA [#de-btw-calculator]

Ao lado do campo de preço, tanto em **Novo preço (IVA incl.)** como em **Preço (c/ IVA)** em **Geral**, há uma pequena calculadora. Com ela abre a **Calculadora de IVA**.

<DocScreenshot src="/screenshots/producten/product-vat-calculator.png" alt="Calculadora de IVA com taxa de IVA, montante sem e com IVA e alteração do preço em percentagem" />

Na calculadora pode:

- preencher o montante **Sem IVA** ou **Com IVA**. O outro montante e o IVA são calculados de imediato.
- escolher outra **Taxa de IVA**. O preço com IVA é então recalculado a partir do montante sem IVA.
- em **Alterar preço em %**, preencher uma percentagem, por exemplo 5 para mais cinco por cento ou -5 para menos cinco por cento, e clicar em **Aplicar**.

Clique em **Usar este preço** para colocar o preço e a taxa de IVA no formulário. Depois ainda tem de guardar ou agendar o preço.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não consigo escolher uma data no passado">
Um preço só pode valer a partir de hoje ou mais tarde. Se quiser alterar um preço com efeito retroativo, altere as próprias faturas.
</Accordion>
<Accordion title="Agendar preço está a cinzento">
Para isso precisa da permissão **Editar produtos**.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Editar ou eliminar um produto" href="/producten/product-bewerken" />
  <Card title="Notificações" href="/notificaties" />
</Cards>


# Criar um produto (/pt-PT/producten/product-aanmaken)

Um novo produto fica logo disponível nas faturas. As ações e as linhas de fatura extra configura-as depois na página do produto.

<Requires permission="Producten bewerken" />

<Steps>
<Step>
### Abrir a janela de diálogo [#open-het-dialoogvenster]

Aceda a <UIPath>Administração > Produtos</UIPath> e clique em **Novo produto**, no canto superior direito.
</Step>
<Step>
### Preencher os dados básicos [#vul-de-basisgegevens-in]

<DocScreenshot src="/screenshots/producten/product-create-dialog.png" alt="Diálogo de criação de produto com os campos básicos" />

| Campo | O que preenche |
|------|---------------|
| **Nome** (obrigatório) | O nome tal como aparece nas faturas |
| **Descrição** | Uma breve explicação (opcional) |
| **Preço (c/ IVA)** | O montante por unidade, com IVA incluído |
| **% IVA** | Escolha entre 0%, 6%, 9%, 12% ou 21%, ou um regime sem IVA como **Autoliquidação (serviços UE)**. Veja [IVA com autoliquidação e outros regimes](/boekhouden/belasting#btw-verlegd-en-andere-regimes-zonder-btw) |
| **Conta contabilística** | O número da conta contabilística para a sua contabilidade (opcional) |
| **Vigiar o saldo do cliente nesta conta** | Para cauções: recusa faturas que deixariam o saldo do cliente abaixo de zero. Veja [Vigiar o saldo do cliente](#het-saldo-van-de-klant-bewaken) |
</Step>
<Step>
### Criar o produto [#maak-het-product-aan]

Clique em **Criar**. O Tillor abre a página do produto, onde pode acrescentar ações e linhas de fatura extra.
</Step>
</Steps>

<Callout type="info">
O preço é sempre com IVA incluído. O Tillor calcula o montante de IVA com a percentagem escolhida e mostra-o em separado na fatura.
</Callout>

## Número da conta contabilística [#grootboeknummer]

Com o número da conta contabilística liga um produto a uma conta da sua contabilidade. O número é usado na exportação para o software de contabilidade. Deixe o campo vazio se não quiser ligar o produto a uma conta própria.

Uma alteração do número da conta contabilística vale para novas linhas de fatura. As faturas lançadas não mudam.

## Vigiar o saldo do cliente [#het-saldo-van-de-klant-bewaken]

Para cauções, marque **Vigiar o saldo do cliente nesta conta**. O Tillor soma então, por cliente, todas as linhas de fatura lançadas nessa conta contabilística e recusa qualquer fatura que deixasse esse saldo abaixo de zero. Assim, não pode reembolsar uma caução duas vezes por engano. Esta opção exige um número de conta contabilística.

Na fatura vê, por baixo da linha, o saldo do cliente nessa conta e o que ele passa a ser depois desta fatura. Os rascunhos não contam. Também não é possível voltar a pôr em rascunho uma fatura de caução lançada, nem movê-la para outro cliente, se o saldo ficasse por isso abaixo de zero.

No separador **Faturação** de um cliente, em **Faturas**, encontra a tabela **Contas**: cada conta contabilística em que algo foi lançado para esse cliente ou que tem um [saldo de abertura](#beginsaldi-van-voor-tillor), com o saldo. Uma conta que está a zero em termos líquidos também continua visível. Uma conta vigiada em que o cliente ainda não lançou nada não aparece.

Se pelo menos um produto vigiar uma conta, o filtro **Proteção** fica por omissão em **Ativo** e vê apenas as contas vigiadas. Limpe o filtro para ver também as outras contas, como as suas contas de receitas. Sem produtos vigiados, o filtro está desligado e vê logo todas as contas. Com o filtro **Saldo** fica apenas com as contas que não estão a zero. Um pequeno escudo junto ao número mostra quais as contas vigiadas.

Abra uma conta e vê as faturas lançadas com uma linha nessa conta, da mais antiga para a mais recente, com o montante e o **Saldo acumulado**: o saldo depois dessa fatura. Se houver mais de 100 faturas na conta, vê as últimas 100. O saldo acumulado conta as faturas mais antigas na mesma.

Com a permissão **Ignorar o saldo da conta** pode lançar mesmo assim. Indica então uma justificação, que fica na cronologia da fatura. Sem essa permissão, **Lançar fatura** fica a cinzento enquanto o saldo ficar abaixo de zero.

<Requires permission="Saldo op grootboek overschrijven" />

## Saldos de abertura de antes do Tillor [#beginsaldi-van-voor-tillor]

Uma caução que o cliente pagou antes de começar com o Tillor não consta de nenhuma fatura no Tillor. Registe esse montante como **saldo de abertura** na conta do cliente. Conta para o saldo e para a vigilância, pelo que mais tarde reembolsa essa caução sem problemas, sem justificação. Um saldo de abertura não é uma fatura: não recebe número nem IVA e não vai para a sua contabilidade, porque a sua contabilidade antiga já o tem.

**Um cliente:** abra o cliente, separador **Faturação**, cartão **Contas**, e clique em **Saldo de abertura**. Preencha a conta (por ex. 428002), o montante, a data do saldo antigo e uma referência, por exemplo o documento do seu sistema antigo. Um montante negativo é um montante que o cliente ainda deve. Abra a conta e vê o saldo de abertura no topo do saldo acumulado, com botões para o alterar ou remover. Por baixo do saldo, aparece quanto dele é saldo de abertura.

**Todos os clientes de uma vez:** aceda a <UIPath>Administração > Faturas</UIPath> e clique em **Importar saldos de abertura**. Cole as linhas de uma folha de cálculo ou escolha um ficheiro CSV, com uma linha de cabeçalho e as colunas cliente (o número de cliente do Tillor), conta, montante, data, referência e, se quiser, nota. Clique em **Verificar**: vê quais as linhas novas, quais o Tillor atualiza e quais os clientes não encontrados, além do total por conta. Compare esse total com o balancete da sua contabilidade antiga e clique depois em **Importar**. Uma linha com uma referência que o cliente já tem nessa conta atualiza esse saldo de abertura em vez de o acrescentar em duplicado, pelo que pode repetir uma importação sem receio.

Um saldo de abertura que já foi reembolsado normalmente já não pode ser removido nem reduzido: o saldo ficaria abaixo de zero. Se tiver a permissão **Ignorar o saldo da conta**, o Tillor pede nesse caso uma justificação e executa a alteração na mesma, por exemplo para retirar um saldo de abertura antigo e agregado de um cliente que já recebeu a caução de volta no Tillor. Isto vale também para uma importação que deixe um saldo abaixo de zero. Cada alteração fica na cronologia do cliente, com a sua justificação se ignorou a vigilância.

<Requires permission="Beginsaldi beheren" />

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- O produto fica logo na lista e pode escolhê-lo em faturas em rascunho.
- Na página do produto configura depois [ações](/producten/acties-instellen), [linhas de fatura extra](/producten/bundel-instellen) e [preços agendados](/producten/prijzen-plannen).

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não consigo criar nem alterar um produto">
Criar e alterar exige a permissão **Editar produtos**. Peça a um administrador da sua organização para a acrescentar à sua função.
</Accordion>
<Accordion title="Falta-me uma taxa de IVA">
Só pode escolher entre 0%, 6%, 9%, 12% e 21%. Não é possível definir outras taxas.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Editar ou eliminar um produto" href="/producten/product-bewerken" />
  <Card title="Associar ações a um produto" href="/producten/acties-instellen" />
  <Card title="IVA e impostos" href="/boekhouden/belasting" />
</Cards>


# Editar ou eliminar um produto (/pt-PT/producten/product-bewerken)

Na página do produto altera tudo sobre um produto. As alterações têm efeito nas novas linhas de fatura.

<Requires permission="Producten bewerken" />

## Editar um produto [#een-product-bewerken]

<Steps>
<Step>
### Abrir o produto [#open-het-product]

Aceda a <UIPath>Administração > Produtos</UIPath> e clique no nome do produto ou no ícone do lápis na linha.
</Step>
<Step>
### Alterar os dados [#pas-de-gegevens-aan]

<DocScreenshot src="/screenshots/producten/product-detail.png" alt="Página de detalhe do produto com Geral, Linhas de fatura extra, Ações de linha de fatura e Eventos" />

À esquerda encontra os cartões **Geral** e **Linhas de fatura extra**. À direita estão **Ações de linha de fatura** e **Eventos**. Em **Geral** estão os mesmos campos que na criação, mais a opção **Desativar produto**.
</Step>
<Step>
### Guardar [#sla-op]

Na parte inferior do cartão **Linhas de fatura extra**, clique em **Guardar**. Esse botão guarda todas as alterações da página, também as de **Geral** e de **Ações de linha de fatura**. O botão só fica ativo quando alterou alguma coisa.
</Step>
</Steps>

Se quiser que um novo preço só valha a partir de uma data posterior, use o cartão **Preços agendados**. Veja [Agendar uma alteração de preço](/producten/prijzen-plannen).

Em **Eventos** vê uma cronologia das alterações ao produto, como preço, conta contabilística e ações. Para cada alteração aparecem a hora, o utilizador e, sempre que possível, a diferença entre antes e depois.

## Desativar um produto [#een-product-uitschakelen]

Marque **Desativar produto** e guarde. Um produto desativado já não pode ser escolhido em faturas, mas continua na lista e nas faturas existentes. Na lista e na página do produto aparece como <Status>Desativado</Status>. Assim, mantém o histórico sem continuar a usar o produto.

## Eliminar um produto [#een-product-verwijderen]

<Steps>
<Step>
### Escolher eliminar [#kies-verwijderen]

Na lista, clique no ícone do caixote do lixo junto ao produto. Na página do produto, abra o menu dos três pontos no cabeçalho e escolha **Eliminar produto**.
</Step>
<Step>
### Confirmar [#bevestig]

<DocScreenshot src="/screenshots/producten/product-delete-dialog.png" alt="Diálogo de confirmação para eliminar produto" />

Na janela de diálogo, clique em **Eliminar**.
</Step>
</Steps>

<Callout type="warn" title="Atenção">
Eliminar não pode ser desfeito. As faturas em que o produto já consta ficam inalteradas. Se o produto for um passo no pacote de outro produto, o Tillor passa a ignorar esse passo. Se só quiser deixar de usar o produto, prefira desativá-lo.
</Callout>

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- Um novo preço, outra conta contabilística ou outra ação valem para as linhas que acrescentar depois. As faturas existentes ficam como estavam.
- Um produto desativado desaparece da lista de escolha nas faturas, mas continua visível na lista de produtos.
- Cada alteração fica na cronologia **Eventos** do produto, com o utilizador e a hora.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Guardar está a cinzento">
O botão só funciona depois de alterar alguma coisa, e apenas com a permissão **Editar produtos**.
</Accordion>
<Accordion title="O pacote não é guardado">
Cada passo de produto no pacote tem de ter um produto e cada passo de informação tem de ter um texto. Complete-os e guarde novamente. Veja [Configurar linhas de fatura extra](/producten/bundel-instellen).
</Accordion>
<Accordion title="Não consigo guardar um produto com Consumo do contador">
Por cada combinação de tipo de cliente e tipo de contador só pode existir um produto com a ação **Consumo do contador**. Se essa combinação já estiver noutro produto, guardar é recusado. Altere esse outro produto ou escolha outra combinação.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Associar ações a um produto" href="/producten/acties-instellen" />
  <Card title="Agendar uma alteração de preço" href="/producten/prijzen-plannen" />
  <Card title="Configurar linhas de fatura extra" href="/producten/bundel-instellen" />
</Cards>


# Ações de produto (/pt-PT/producten/productacties)

Ativa as ações na página do produto, no cartão **Ações de linha de fatura**. Como o fazer está em [Associar ações a um produto](/producten/acties-instellen). Esta página descreve cada ação. Como as ações se ligam, ao lançar e pagar, a ocupações, etiquetas e impressoras, vê em [Como se liga tudo?](/producten#hoe-hangt-dit-samen).

## Carregar etiqueta NFC [#nfc-tag-opladen]

Quando uma fatura com este produto é paga, o Tillor carrega automaticamente uma etiqueta NFC. Use-o em produtos com que os clientes recebem saldo ou acesso numa etiqueta. Não há campos adicionais no produto.

## Período [#periode]

O produto representa um serviço durante um período de tempo, como um preço diário, uma subscrição semanal ou uma tarifa mensal.

| Campo | Significado |
|------|-----------|
| **Por unidade** | Número de unidades por período, no mínimo 1 |
| **Unidade de período** | **Dia**, **Semana** ou **Mês** |
| **Prorrogar automaticamente os métodos de acesso** | No pagamento, o Tillor prorroga todos os métodos de acesso do cliente até à data de fim do período |
| **Pedir parcela** | Na linha de fatura escolhe uma parcela. Ao lançar, o Tillor cria uma reserva para essa estadia |
| **Registar entrada ao reservar** | Apenas com **Pedir parcela**. Assim que a fatura é lançada, o Tillor põe a reserva em <Status tone="success">Check-in feito</Status> |
| **Registar a entrada no pagamento** | Apenas com **Pedir parcela**. Assim que a fatura é paga, o Tillor põe a reserva em <Status tone="success">Check-in feito</Status> |
| **Adultos incluídos** | Apenas com **Pedir parcela**. Número de adultos na reserva, por omissão 2. Pode preencher de 0 a 99 |

### Reservas com Pedir parcela [#reserveringen-bij-terrein-vragen]

- A reserva recebe a mesma chegada e partida que a linha de fatura e a parcela escolhida como preferência. O grupo ajusta-o depois na própria reserva.
- Se repuser a fatura em rascunho e alterar as datas ou a parcela, o Tillor atualiza a mesma reserva ao lançar novamente.
- Se retirar a parcela ou desativar **Pedir parcela**, a reserva é cancelada. Uma reserva que já fez check-out mantém-se.
- Uma nota de crédito cancela a reserva da fatura original.
- Sem check-in, a reserva fica em <Status tone="info">Reservada</Status>. É assim que funciona um adiantamento de reserva: uma parcela e datas no futuro, sem chegada.
- Se ambas as opções de check-in estiverem ativas, conta o lançamento.
- Se a fatura já estiver paga quando lançar novamente, o Tillor volta a fazer check-in.

Na cronologia da fatura e da reserva vê a criação, a alteração, o cancelamento e o check-in, com uma referência à outra.

## Prorrogar período de ocupação [#bezetting-verlengen]

Com esta ação, uma fatura prorroga a ocupação de um cliente num terreno, por exemplo para Estacionamento.

- Ao **lançar**, o Tillor ajusta **Faturado até** da ocupação.
- No **pagamento**, o Tillor ajusta **Pago até**.

Na linha de fatura escolhe um terreno. Ao lançar e pagar, o Tillor liga a ocupação ativa do cliente nesse terreno. O Tillor guarda também uma cópia dessa ocupação na linha, para ver depois qual era a ocupação pretendida, mesmo que entretanto tenha sido eliminada. Com **Arredondar para o limite do período seguinte** na linha de fatura, alinha os clientes com pagamento a prazo pelo mesmo ciclo, de acordo com a **Frequência da renda** da ocupação.

Se escolher um terreno em que o cliente ainda não tem ocupação, cria uma proposta. Só pode lançar uma linha dessas quando o cliente tiver ocupação nesse terreno.

| Campo | Significado |
|------|-----------|
| **Data de vencimento a partir do início da ocupação** | Ao lançar, o Tillor define a data de vencimento como a data de início do período de ocupação na linha de Estacionamento, em vez do prazo de pagamento normal ou do prazo no diálogo de lançamento. Ao lançar de novo, mantém-se a data de vencimento original |

Se o produto tiver linhas de fatura extra, o Tillor acrescenta linhas filhas sob a linha principal. Veja [Configurar linhas de fatura extra](/producten/bundel-instellen).

## Prorrogar método de acesso [#toegangsmethode-verlengen]

Com esta ação, o pagamento de uma fatura prorroga a validade dos métodos de acesso do cliente. Funciona de duas formas:

- **Em conjunto com Período** na mesma linha, por exemplo uma renda mensal. O Tillor prorroga os métodos escolhidos até à data de fim do período.
- **Através de um pacote** com uma linha principal de Estacionamento e passos NFC. A data de fim da linha principal de Estacionamento é então a base. As definições abaixo vêm do produto principal, não do produto de suplemento do passo NFC. Veja [Prorrogar NFC através do pacote](/producten/bundel-instellen#nfc-verlengen-via-de-bundel).

| Campo | Significado |
|------|-----------|
| **Dias após a data de fim** | Dias de calendário a somar à data de fim. 0 significa a própria data de fim, no máximo 3660. Em pacotes, define isto por passo NFC |
| **Dia da semana** | Opcional. A validade termina na ocorrência mais próxima desse dia da semana em torno da data-alvo. Por omissão **Todos os dias** |
| **Hora** | Opcional. Hora do relógio no fuso horário da organização. Vazio significa 23:59 |
| **Tipos de método de acesso** | Escolha pelo menos um tipo entre NFC, Código QR, Reconhecimento de matrícula e Código PIN. Só vê os tipos ativados para a sua organização |
| **Estados** | Só são prorrogados os métodos com um destes estados: <Status tone="success">Ativo</Status> ou <Status tone="warning">Bloqueio suave</Status>. Por omissão apenas **Ativo** |
| **Não encurtar ao prorrogar** | Os métodos cujo **Válido até** já seja igual ou posterior à nova data são ignorados. Ao reverter através de uma nota de crédito, o Tillor define sempre a data calculada |

Por baixo do campo há uma linha **Resultado** que explica em que momento a validade termina, por exemplo "terça-feira mais próxima da data de fim + 10 dias, às 13:00".

Isto não é o mesmo que **Prorrogar automaticamente os métodos de acesso** em **Período**. Esse interruptor prorroga ao pagar um produto apenas com **Período**, sem a ação separada **Prorrogar método de acesso**.

## Criar método de acesso [#toegangsmethode-aanmaken]

Ao pagar a fatura, o Tillor cria um novo método de acesso para o cliente. O operador de caixa escolhe o tipo na linha de fatura. Se a linha também tiver a ação **Período**, o período passa a ser a validade do método de acesso.

| Campo | Significado |
|------|-----------|
| **Tipos de método de acesso** | Tipos entre os quais o operador de caixa escolhe: Código QR, Reconhecimento de matrícula ou Código PIN. Com um único tipo, o Tillor escolhe-o automaticamente |
| **O método de acesso é opcional** | O lançamento nunca é bloqueado por esta linha. Sem tipo escolhido, o Tillor não cria nada |
| **Método de acesso predefinido** | Apenas com vários tipos. Este tipo fica selecionado por omissão em novas linhas de fatura, ajustável por linha. **Sem predefinição (escolher por linha)** deixa a escolha em aberto |
| **Imprimir código QR automaticamente** | Apenas com Código QR. O Tillor imprime o bilhete de acesso com QR na impressora de talões assim que é criado |
| **Converter códigos automaticamente em matrícula** | Os novos códigos QR e PIN são substituídos pela matrícula detetada quando são usados numa cancela com câmara. Ajustável por linha |

Uma linha só pode ser lançada quando tiver sido escolhido um tipo, a menos que a ação seja opcional. No Reconhecimento de matrícula, a matrícula também tem de estar preenchida.

## Pedir dados de contacto [#contactgegevens-vragen]

Na linha de fatura aparecem campos para endereço de e-mail e número de telefone. O Tillor pede-os ao lançar.

| Campo | Significado |
|------|-----------|
| **Pedir endereço de e-mail** | Mostra um campo de e-mail na linha de fatura |
| **Endereço de e-mail obrigatório** | Apenas se pedir um endereço de e-mail. O lançamento fica bloqueado até o campo ser preenchido |
| **Pedir número de telefone** | Mostra um campo de telefone na linha de fatura |
| **Número de telefone obrigatório** | Apenas se pedir um número de telefone. O lançamento fica bloqueado até o campo ser preenchido |

## Impedir lançamento [#boeken-blokkeren]

Use isto para produtos que só devem estar em faturas em rascunho. Se uma linha destas estiver numa fatura em rascunho, não pode tornar a fatura definitiva. Não há campo adicional. O Tillor bloqueia o lançamento enquanto a linha lá estiver.

## Mostrar alerta [#melding-tonen]

Mostra um alerta por baixo da linha de fatura, por exemplo "Atenção: usar apenas para turistas de um dia". Nada acontece ao lançar ou pagar.

| Campo | Significado |
|------|-----------|
| **Estilo do alerta** | **Informação**, **Aviso**, **Erro**, **Concluído** ou **Neutro** |
| **Texto do alerta** | O texto, no máximo 4000 carateres. Markdown é suportado (negrito, listas, ligações) |

Por baixo do texto vê logo uma pré-visualização do alerta. O texto é copiado para a linha de fatura. Alterações posteriores no produto não mudam as faturas existentes.

## Consumo do contador [#meterverbruik]

Com esta ação, o produto passa a ser a tarifa do consumo de contadores. O Tillor usa-o para consumo em aberto e para a faturação automática de leituras de contadores. Escolhe dois campos.

| Campo | Opções |
|------|--------|
| **Tipo de cliente** | **Predefinido**, **Caravana de aluguer para trabalhadores**, **Caravana de reboque para trabalhadores** |
| **Tipo de contador** | **Eletricidade**, **Água**, **Gás** |

Por cada combinação de tipo de cliente e tipo de contador só pode existir um produto. Na lista, ambos os valores aparecem na coluna **Info**. Se um cliente não tiver um produto próprio para o seu tipo de cliente, o Tillor usa o produto para **Predefinido** com o mesmo tipo de contador.

## Impressão térmica e impressão A4 [#thermisch-printen-en-a4-printen]

Marque **Impressão térmica** e **Impressão A4** em separado. Assim que pelo menos uma das duas estiver ativa, aparece o bloco **Impressão automática**. Aí define, por impressora, o que é impresso ao pagar a fatura.

| Campo | Significado |
|------|-----------|
| **Cópias de impressão térmica** | Número de exemplares na impressora térmica (impressora de talões). 0 desliga essa impressora |
| **Cópias de impressão A4** | Número de exemplares na impressora A4. 0 desliga o A4 |
| **Momento da impressão** | **Usar definições (por tipo de pagamento)** (por omissão), **Imprimir imediatamente** ou **Próxima hora de corte** |

Pode definir no máximo 10 cópias por impressora. Com **Usar definições (por tipo de pagamento)** vale a definição da sua organização por tipo de pagamento.

## Ver também [#zie-ook]

<Cards>
  <Card title="Associar ações a um produto" href="/producten/acties-instellen" />
  <Card title="Configurar linhas de fatura extra" href="/producten/bundel-instellen" />
  <Card title="Gestão de contadores" href="/meterbeheer" />
  <Card title="NFC" href="/nfc" />
</Cards>


# Reservas (/pt-PT/reserveringen)

Com as reservas acompanha as estadias no seu parque: quem chega, quando, em que terreno e com quantos hóspedes. A partir de uma reserva também trata do check-in e do check-out. Vê todas as reservas numa cronologia em **Reservas** e, por cliente, no separador **Reservas**. Comece por [Criar uma reserva](#een-reservering-aanmaken).

<Callout type="info" title="Bom saber">
- Cada reserva pertence a um cliente e recebe automaticamente um **Número da reserva** único. Esse número não pode ser alterado.
- A data de check-out tem de ser posterior à data de check-in. O Tillor recusa o mesmo dia ou uma data anterior.
- Uma matrícula é composta por letras e números, no máximo 10 carateres, sem espaços nem hífenes.
- Fazer check-in e cancelar só é possível a partir do estado **Reservada**. Já não se pode cancelar depois do check-in.
- Uma reserva não é o mesmo que uma ocupação: uma reserva é um registo para uma estadia, uma ocupação liga um cliente a um terreno durante um período, veja [Ocupações](/bezettingen).
- As notas de uma reserva são internas e nunca são partilhadas com o cliente.
</Callout>

## Como se liga tudo? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  K[Cliente] --> R[Reserva]
  R -->|Fazer check-in| I[Hóspede no terreno]
  I -->|Fazer check-out| U[Estadia concluída]
  R -->|Cancelar reserva| A[Cancelada]
  R --> F[Faturas do cliente]
```

As faturas do cliente encontra-as no perfil do cliente, em **Faturação**.

## A cronologia [#de-tijdlijn]

Aceda a **Reservas** no menu principal. A cronologia mostra as reservas por terreno ao longo de um calendário. Com a vista escolhe dia, semana, mês, trimestre ou ano e salta para uma data com **Ir para a data**.

<DocScreenshot src="/screenshots/reserveringen/reservations-list.png" alt="Cronologia de reservas" />

- Clique ou arraste sobre uma zona livre para acrescentar uma reserva. No canto superior direito também existe **Nova reserva**.
- Se arrastar uma reserva para outras datas, o Tillor pergunta **Atualizar as datas da reserva?** Só depois de confirmar é que a reserva muda.
- O menu de contexto de uma reserva tem **Ver reserva**, **Copiar hiperligação** e **Cancelar reserva**.

## Criar uma reserva [#een-reservering-aanmaken]

Antes de começar:

- Precisa de um cliente. Se ainda não existir, crie-o durante o início, veja [Gestão de clientes](/klantenbeheer).
- Sabe que terreno o hóspede quer? Então escolha-o. Caso contrário, deixe o campo vazio.

<Steps>
<Step>
### Iniciar a reserva [#start-de-reservering]
<Tabs items={["Através de Reservas", "Através do perfil do cliente"]}>
<Tab value="Através de Reservas">
Clique em **Nova reserva** no canto superior direito. Escolha um cliente existente ou crie um novo cliente.
</Tab>
<Tab value="Através do perfil do cliente">
Abra o cliente em **Clientes**, aceda ao separador **Reservas** e clique em **Nova reserva**.
</Tab>
</Tabs>
</Step>
<Step>
### Preencher o formulário [#vul-het-formulier-in]
Veja [O formulário de reserva](#het-reserveringsformulier) abaixo para todos os campos.
</Step>
<Step>
### Criar a reserva [#maak-de-reservering-aan]
Clique em **Criar reserva**.
</Step>
</Steps>

### O que acontece a seguir? [#wat-gebeurt-er-daarna]

- A reserva fica com o estado <Status tone="info">Reservada</Status> e um número de reserva.
- Se **E-mail de confirmação automático** estiver ativo, o cliente recebe uma confirmação.
- Encontra a reserva na cronologia e no separador **Reservas** do cliente.
- Se quiser que uma automatização reaja a uma reserva nova ou alterada, use um gatilho, veja [Gatilhos](/automatiseringen/triggers).

## O formulário de reserva [#het-reserveringsformulier]

### Datas e duração da estadia [#datums-en-verblijfsduur]

- **Check-in**: escolha a data de chegada.
- **Check-out**: escolha a data de partida. Depois da data de check-in, o seletor de check-out abre sozinho. A data de partida tem de ser posterior à data de chegada.
- **Número de noites**: o Tillor calcula-o por si.

### Quantidades e animais [#aantallen-en-dieren]

Indique o número de **Adultos** (no mínimo 1), **Crianças**, **Bebés** e **Animais** com os botões de mais e menos.

### Terreno [#terrein]

- **Terreno**: escolha um terreno se o hóspede tiver uma preferência. A lista mostra apenas terrenos reserváveis sem ocupação ativa que estejam livres no período escolhido. O Tillor exclui reservas ativas sobrepostas no mesmo terreno. Se alterar as datas, a lista atualiza-se. Sem preferência? Deixe o campo vazio.
- **Incluir parcelas não reserváveis**: mostra também terrenos que não podem ser reservados online, por exemplo lugares anuais fixos. Se a reserva já estiver num desses terrenos, esta opção fica ativa automaticamente.
- **Incluir parcelas ocupadas**: mostra também terrenos que já têm uma ocupação.

### Matrículas [#nummerplaten]

Escreva uma matrícula, prima **Enter** e repita para cada matrícula. Uma cruz numa matrícula remove-a. As matrículas só podem conter letras e números, no máximo 10 carateres.

As matrículas de uma reserva podem ser encontradas através da pesquisa. O acesso à cancela regula-o à parte, no cliente, no separador **Controlo de acesso**, veja [Controlo de acesso](/toegangscontrole).

### Notas [#notities]

Use o campo de notas para observações internas, como pedidos especiais ou acordos.

### Preferências de comunicação [#communicatievoorkeuren]

- **E-mail de confirmação automático**: envia uma confirmação depois de criar a reserva.
- **Pagamento online**: permite que o cliente pague a reserva online.

## Ver e editar uma reserva [#een-reservering-bekijken-en-bewerken]

Clique numa reserva na cronologia ou no perfil do cliente para abrir a página de detalhe.

<DocScreenshot src="/screenshots/reserveringen/reservation-detail.png" alt="Página de detalhe de uma reserva" />

- **Detalhes da reserva** (à esquerda): o formulário completo. Altere o que quiser e clique em **Guardar**. Com **Cancelar** repõe os valores originais. Junto ao título está **Copiar hiperligação da reserva**, útil para colar uma ligação clicável num documento.
- **Ações da reserva** (à direita): os botões abaixo.
- **Comentários** (à direita): discussão interna sobre esta reserva.
- **Atividade** (à direita): uma cronologia com criação, check-in, check-out, cancelamento, anulações e dados alterados, com hora e utilizador. Numa alteração vê que campos foram modificados (antes / depois).

## Check-in, check-out e cancelamento [#inchecken-uitchecken-en-annuleren]

Na página de detalhe, as ações estão em **Ações da reserva**. Cada ação pede uma confirmação.

| Ação | Possível quando | Resultado |
|---|---|---|
| **Fazer check-in** | Estado <Status tone="info">Reservada</Status> | Estado <Status tone="success">Check-in feito</Status> |
| **Fazer check-out** | Estado <Status tone="success">Check-in feito</Status> | Estado <Status>Check-out feito</Status> |
| **Cancelar reserva** | Apenas antes do check-in | Estado <Status>Cancelada</Status> |
| **Anular cancelamento** | Apenas antes do check-in | De volta a <Status tone="info">Reservada</Status> |
| **Anular check-in** | Em caso de check-in errado. Se o hóspede já tiver feito check-out, anule primeiro o check-out | De volta a <Status tone="info">Reservada</Status> |
| **Anular check-out** | Em caso de check-out errado | De volta a <Status tone="success">Check-in feito</Status> |

Além disso, existem **Enviar formulário de confirmação ao cliente (SMS)** e **Criar tarefa**. Com a última cria uma tarefa a partir desta reserva.

Numa reserva cancelada não pode fazer check-in nem check-out. Anule primeiro o cancelamento.

## Problemas? [#problemen]

<Accordions>
<Accordion title="O Tillor diz: Reserva não criada">
A mensagem é **Não foi possível criar a reserva.** Verifique se escolheu um cliente e se a data de check-out é posterior à data de check-in. O mesmo dia ou uma data anterior é recusado.
</Accordion>
<Accordion title="O Tillor diz: Reserva não atualizada">
As suas alterações não foram guardadas. Verifique as datas (o check-out tem de ser depois do check-in), as matrículas e o número de adultos, e clique novamente em **Guardar**.
</Accordion>
<Accordion title="O Tillor diz: O check-in falhou">
A reserva tem de ter o estado Reservada. Se já tiver feito check-in, check-out ou estiver cancelada, não é possível fazer check-in. Recarregue a página e veja qual é agora o estado. Se estiver cancelada, use primeiro **Anular cancelamento**.
</Accordion>
<Accordion title="O Tillor diz: O check-out falhou">
O check-out só é possível numa reserva com check-in feito. Se o hóspede ainda não fez check-in ou já fez check-out, não funciona.
</Accordion>
<Accordion title="O Tillor diz: Não foi possível cancelar">
Só é possível cancelar antes do check-in. Se o hóspede já fez check-in, anule primeiro o check-in com **Anular check-in** e cancele depois.
</Accordion>
<Accordion title="O terreno não aparece na lista">
A lista mostra apenas terrenos reserváveis sem ocupação que estejam livres no período escolhido. Verifique as datas. Marque **Incluir parcelas não reserváveis** ou **Incluir parcelas ocupadas** se for um desses terrenos que procura.
</Accordion>
<Accordion title="Uma matrícula não é adicionada">
Uma matrícula só pode conter letras e números e ter no máximo 10 carateres. Retire espaços e hífenes.
</Accordion>
</Accordions>

## Conceitos [#begrippen]

- **Reserva**: um registo para uma estadia. Veja [reserva](/begrippen#reservering).
- **Reservada, Check-in feito, Check-out feito, Cancelada**: os quatro estados de uma reserva.
- **Número da reserva**: o número automático com que encontra uma reserva.
- **Ocupação**: um cliente num terreno durante um período, independentemente de uma reserva. Veja [ocupação](/begrippen#bezetting).
- **Cronologia**: a visão geral das reservas por terreno ao longo de um calendário.

## Ver também [#zie-ook]

<Cards>
  <Card title="Gestão de clientes" href="/klantenbeheer" />
  <Card title="Ocupações" href="/bezettingen" />
  <Card title="Controlo de acesso" href="/toegangscontrole" />
  <Card title="Processamento de pagamentos" href="/betalingsverwerking" />
  <Card title="Exemplos práticos" href="/praktijk" />
</Cards>


# Partilhar tarefas (/pt-PT/taken/delen)

Quer mostrar tarefas a alguém que não trabalha no Tillor, ou vê-las no seu próprio calendário? Então crie uma ligação de partilha. Existem dois tipos.

| Tipo | O que é |
|---|---|
| **Página partilhável** | Um quadro só de leitura com o que há para fazer. Acompanha as tarefas, por isso as alterações feitas no Tillor aparecem lá |
| **Calendário (ICS)** | Uma subscrição de calendário para, por exemplo, o Google Calendar, o Outlook ou o Calendário da Apple |

## Criar uma ligação [#een-link-maken]

1. Clique no ícone de partilha, no canto superior direito da página de tarefas (dica **Partilhar esta vista**). O mesmo ícone também se encontra no cartão **Tarefas para si** do painel
2. Em **Tipo de ligação**, escolha **Página partilhável** ou **Calendário (ICS)**
3. Em **Conteúdo**, escolha o que partilha: **As minhas tarefas atribuídas** ou uma das suas vistas. Se abrir a janela a partir de uma vista, esta já aparece selecionada
4. Se quiser, limite o conteúdo com **Filtros**: **Estado**, **Prioridade**, **Atribuído a**, **Etiqueta**, **Vista**, **Ligado a** e **Bloqueada**. Os filtros ficam guardados na ligação e apenas estreitam o que a origem já mostra
5. Clique em **Criar ligação**

<DocScreenshot src="/screenshots/taken/task-share-dialog.png" alt="Caixa de diálogo Partilhar tarefas com tipo de ligação, conteúdo e filtros" />

Em **Ligações anteriores** encontra todas as ligações que criou para esta origem. Para cada ligação pode:

- **Copiar ligação**
- Numa ligação de calendário, **Adicionar ao calendário**, que abre logo a subscrição na sua aplicação de calendário
- **Invalidar** (após confirmação). A ligação deixa de funcionar. As outras ligações continuam válidas. Uma ligação invalidada fica na lista com a marca **Invalidada**

<Callout type="warn">
Uma ligação de partilha é privada, mas qualquer pessoa que a tenha pode ver as tarefas, mesmo sem iniciar sessão. Partilhe-a apenas com quem o pode ver e invalide-a assim que deixar de ser necessária.
</Callout>

## A página partilhável [#de-deelbare-pagina]

A página mostra as tarefas por grupo, com o nome, o estado, a prioridade, o prazo, as etiquetas e os nomes dos colegas atribuídos em cada tarefa. Não há botões para alterar nada. Num grupo grande vê **[número] de [total]** tarefas.

Por predefinição só aparecem tarefas em aberto, a menos que defina um filtro de estado ou partilhe uma vista. Se não houver nada para fazer, vê **Neste momento não há nada para fazer.**

## O calendário [#de-agenda]

No calendário aparecem as tarefas com um **prazo** ou um **lembrete**. As tarefas sem data não aparecem.

- Os lembretes recorrentes aparecem como uma série, e recebe um alerta em cada lembrete
- Sem lembrete, recebe um alerta uma hora antes do prazo
- As tarefas concluídas continuam visíveis mais duas semanas, como concluídas, e depois desaparecem
- Numa vista, o calendário acompanha a vista, independentemente de a quem as tarefas estão atribuídas. Se quem criou a ligação já não puder ver a vista, a ligação deixa de funcionar

<Callout type="info">
No Google Calendar, para um calendário subscrito também tem de ativar os alertas predefinidos, caso contrário os alertas não chegam.
</Callout>

## O que acontece depois? [#wat-gebeurt-er-daarna]

- A ligação funciona de imediato e continua a funcionar até a invalidar. Qualquer pessoa com a ligação pode ver as tarefas, mesmo sem iniciar sessão.
- Uma página partilhável acompanha as tarefas: as alterações feitas no Tillor aparecem lá.
- Uma subscrição de calendário atualiza-se sozinha na sua aplicação de calendário e dá um alerta uma hora antes do prazo ou em cada lembrete.
- Se invalidar uma ligação, só essa ligação deixa de funcionar. As outras ligações continuam válidas, e a ligação invalidada fica na lista com a marca **Invalidada**.

## Problemas? [#problemen]

<Accordions>
<Accordion title="O Tillor diz Não foi possível criar a ligação">
A ligação não foi criada. Verifique se escolheu uma origem em **Conteúdo** e tente novamente. O aviso **Não foi possível carregar as ligações.** significa que a lista de ligações anteriores não abriu. Abra a janela novamente.
</Accordion>
<Accordion title="A página mostra Neste momento não há nada para fazer">
Não há tarefas que correspondam à origem e aos filtros. Uma página partilhável mostra por predefinição apenas as tarefas em aberto.
</Accordion>
<Accordion title="O calendário não mostra as minhas tarefas">
Só as tarefas com prazo ou lembrete aparecem no calendário. Se quem criou a ligação já não puder ver a vista, a ligação também deixa de funcionar.
</Accordion>
<Accordion title="Não recebo alertas no Google Calendar">
Ative também os alertas predefinidos do calendário subscrito no Google Calendar.
</Accordion>
<Accordion title="Quero que a ligação deixe de funcionar">
Na ligação, escolha **Invalidar** e confirme em **Invalidar esta ligação?**. Se falhar, aparece **Não foi possível invalidar a ligação**: tente novamente.
</Accordion>
</Accordions>


# Filtrar (/pt-PT/taken/filteren)

Por cima das tarefas há uma barra de pesquisa com os botões de filtro ao lado. Os filtros pertencem à vista: se os guardar, determinam que tarefas a vista mostra. Numa vista filtrada, são as tarefas que cumprem os filtros. Numa lista, são as tarefas adicionadas manualmente que também cumprem os filtros.

<DocScreenshot src="/screenshots/taken/task-filter-status.png" alt="O filtro de estado com as opções Incluir e Excluir e os quatro estados" />

## Filtros sempre visíveis [#altijd-zichtbare-filters]

| Filtro | O que escolhe |
|---|---|
| **Estado** | Um ou mais estados |
| **Prioridade** | Uma ou mais prioridades |
| **Atribuído a** | Um ou mais colegas, ou **Eu** para si próprio |
| **Etiqueta** | Uma ou mais etiquetas |
| **Vista** | Tarefas que estão noutra vista (manual) |
| **Bloqueada** | **Bloqueada** ou **Não bloqueada** |
| **Ligado a** | O tipo de registo a que a tarefa está associada, como um cliente, parcela, fatura ou reserva |
| **Texto** | Palavras que o nome ou a descrição contém ou, pelo contrário, não contém, ver abaixo |
| **Prazo** | Um período, ver abaixo |

Nos filtros com uma lista, escolhe no topo **Incluir** (tarefas com os valores escolhidos) ou **Excluir** (tarefas sem esses valores). Em **Ligado a** escolhe o tipo de item: **Cliente**, **Fatura**, **Reserva**, **Contador**, **Parcela**, **Nota**, **Conversa**, **Chamada telefónica**, **Transação bancária** ou **Produto**.

## Filtrar por texto [#filteren-op-tekst]

Com **Texto** mostra apenas as tarefas cujo nome ou descrição contém, ou precisamente não contém, um excerto de texto. Maiúsculas e minúsculas não importam.

1. Clique em **Texto**
2. Escolha **Contém** ou **Não contém**
3. Escreva o texto em **Texto no nome ou na descrição**, por exemplo `Verzekering vervallen:`
4. Clique em **Adicionar** ou prima Enter

Repita isto para cada texto que quiser adicionar. Cada texto é um filtro à parte, por isso pode combinar **Contém** e **Não contém**: por exemplo `caravan`, mas não `Verzekering vervallen:`. Com a cruz ao lado de um texto, remove-o. No botão aparece o próprio texto, ou o número de textos se houver mais do que um.

<Callout>
Se uma tarefa tem de corresponder a **todos** os textos ou a **um** deles depende da escolha em [Combinar vários filtros](#meerdere-filters-combineren). Se quiser excluir vários textos, deixe essa escolha em **Todos os filtros**.
</Callout>

## Filtrar por data [#filteren-op-datum]

**Prazo** funciona com opções fixas que acompanham o dia, ou com um período personalizado.

- **Em atraso**, **Hoje**, **Amanhã**, **Esta semana**, **Próxima semana**, **Este mês**
- **Sem data** (tarefas sem prazo) e **Com data**
- **Período personalizado**: escolha uma data de início e uma de fim no calendário e clique em **Aplicar período**. O último dia conta por inteiro

<DocScreenshot src="/screenshots/taken/task-filter-deadline.png" alt="O filtro de prazo com opções fixas e um calendário para um período personalizado" />

Se voltar a clicar numa opção escolhida, o filtro desaparece.

## Combinar vários filtros [#meerdere-filters-combineren]

Assim que tiver dois ou mais filtros, aparece um menu de seleção:

- **Todos os filtros** - uma tarefa tem de corresponder a todos os filtros
- **Qualquer filtro** - basta que uma tarefa corresponda a um dos filtros

Com **Limpar filtros** remove todos os filtros de uma só vez.

## Exemplos [#voorbeelden]

- *Tudo o que tem de estar concluído hoje e ainda está em aberto*: filtre **Prazo** por **Hoje** e **Estado** por tudo exceto **Concluída**
- *Tarefas em que estou à espera de alguém*: filtre **Estado** por **A aguardar resposta** e **Atribuído a** por **Eu**
- *Tudo exceto os avisos de seguros caducados*: filtre **Texto** por **Não contém** `Verzekering vervallen:`
- *Tudo o que diz respeito a um cliente*: abra o cliente. No separador **Tarefas** da página do cliente estão todas as tarefas associadas a esse cliente

## O que acontece depois? [#wat-gebeurt-er-daarna]

- Os filtros no seu ecrã estreitam o que vê. Só quando os guarda com **Guardar vista** passam a pertencer à vista e os colegas veem a mesma seleção.
- Também pode guardar filtros na vista integrada **Todas**. Nesse caso aplicam-se a todos na sua organização. Para isso precisa da permissão **Gerir etiquetas e vistas partilhadas**.
- Numa vista filtrada, as tarefas aparecem e desaparecem sozinhas, consoante cumprem os filtros.
- A barra de pesquisa nunca é guardada.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Já não vejo tarefas">
Verifique se há um filtro ativo, como um filtro de estado que exclui **Concluída**, ou **Todos os filtros** quando queria dizer um dos filtros. Com **Limpar filtros** recomeça do zero.
</Accordion>
<Accordion title="O filtro desapareceu depois de atualizar">
Não o tinha guardado. Escolha **Guardar vista** na barra **Alterações não guardadas**.
</Accordion>
<Accordion title="Não consigo guardar os filtros em Todas">
**Guardar vista** fica a cinzento se não tiver a permissão **Gerir etiquetas e vistas partilhadas**, porque **Todas** se aplica a toda a organização. Peça-a a um administrador, ou crie uma vista própria com os mesmos filtros.
</Accordion>
<Accordion title="Uma tarefa de um colega não aparece">
Só vê as tarefas que pode ver. Uma tarefa numa vista pessoal de um colega é invisível para si. Veja [Tarefas privadas](/taken/prive-taken).
</Accordion>
<Accordion title="O filtro Prazo não mostra nada com um período personalizado">
Depois de escolher uma data de início e uma de fim, clique em **Aplicar período**.
</Accordion>
</Accordions>


# Tabela, quadro e calendário (/pt-PT/taken/indelingen)

Pode ver as mesmas tarefas de três maneiras. No canto superior direito abre **Exibição** para escolher:

- **Esquema** - **Tabela**, **Quadro** ou **Calendário**. Esta escolha só existe nas vistas guardadas, não em **Todas**
- **Agrupar por** - como as tarefas se dividem em grupos ou colunas
- **Ordenar por** e **Ordem** - **Crescente** ou **Decrescente**
- **Tipo** - se a vista é uma **Lista** ou uma **Vista filtrada**, veja [Vistas](/taken/weergaven#twee-soorten-weergaven). Também isto só existe nas vistas guardadas
- **Concluídas** - durante quanto tempo as tarefas concluídas ficam visíveis

<DocScreenshot src="/screenshots/taken/task-view-display-options.png" alt="O menu Exibição com esquema, tipo, agrupar, ordenar e tarefas concluídas" />

As alterações ficam como uma proposta até as guardar, veja [Guardar ou rejeitar alterações](/taken/weergaven#wijzigingen-opslaan-of-verwerpen).

## Ocultar tarefas concluídas [#voltooide-taken-verbergen]

Em **Concluídas**, no menu **Exibição**, define durante quanto tempo uma tarefa concluída permanece na vista:

| Escolha | O que vê |
|---|---|
| **Mostrar todas** | Todas as tarefas concluídas (predefinição) |
| **Ocultar** | Nenhuma tarefa concluída |
| **Último dia** | Tarefas concluídas no último dia |
| **Última semana** | Tarefas concluídas na última semana |
| **Último mês** | Tarefas concluídas no último mês |

A contagem começa no momento em que a tarefa é colocada em **Concluída**. Um comentário ou um novo nome não altera isso. Se voltar a abrir uma tarefa, ela volta logo a aparecer na vista. Se a vista já tiver um filtro de estado que exclui as tarefas concluídas, esse filtro continua a aplicar-se.

## Agrupar [#groeperen]

| Agrupamento | Resultado |
|---|---|
| **Sem agrupamento** | Todas as tarefas numa lista |
| **Estado** | Um grupo por estado |
| **Prioridade** | Um grupo por prioridade |
| **Atribuído a** | Um grupo por colega |
| **Etiqueta** | Um grupo por etiqueta |
| **Cliente** | Um grupo por cliente |
| **Prazo** | Grupos como **Em atraso**, **Hoje**, **Esta semana**, **Mais tarde** e **Sem prazo** |
| **Colunas próprias** | Colunas que cria você mesmo, apenas nas vistas guardadas |

Uma tarefa com vários colegas ou etiquetas atribuídos aparece no grupo de cada um deles.

## Ordenar [#sorteren]

Pode ordenar por **Manual**, **Prazo**, **Prioridade**, **Estado**, **Nome**, **Criada** ou **Atualizado**. Em **Manual** define a ordem arrastando os cartões. Nas outras opções é o campo que determina a ordem e arrastar dentro de uma coluna não tem efeito, exceto nas colunas próprias.

## Tabela [#tabel]

A tabela mostra uma linha por tarefa. Com um agrupamento, obtém um bloco por grupo. Em **Colunas**, no menu da vista, ativa ou desativa colunas: **Tarefa**, **Estado**, **Prioridade**, **Prazo**, **Vistas**, **Atribuído a**, **Associados** e **Etiqueta**. A coluna **Associados** mostra todos os itens a que a tarefa está ligada. A coluna **Tarefa** está sempre visível.

Com muitas tarefas, o Tillor carrega primeiro uma parte. Desloque-se para baixo ou clique em **Carregar mais** para ver o resto.

## Quadro [#bord]

O quadro mostra cada grupo como uma coluna, ao estilo kanban. Clique no topo de uma coluna em **Nova tarefa** para criar aí uma tarefa. Ela recebe automaticamente o valor da coluna, como o estado ou o colega atribuído.

Arraste um cartão de tarefa para outra coluna e a tarefa assume o valor dessa coluna:

- num quadro por **Estado**, o estado muda
- em **Prioridade**, a prioridade muda
- em **Atribuído a**, o colega atribuído muda
- em **Etiqueta** e **Cliente**, muda a etiqueta ou o cliente
- em **Colunas próprias**, a tarefa passa para essa coluna

Num quadro por **Prazo** não pode arrastar cartões para outra coluna, porque teria de se inventar um prazo. Altere o prazo na própria tarefa.

Se houver mais tarefas numa coluna do que as mostradas, aparece em baixo **Mais [número]**. Um cartão que está bloqueado por outras tarefas ou que as bloqueia também o mostra, por exemplo **Bloqueada por 1 tarefa**.

### Colunas próprias [#eigen-kolommen]

Em **Colunas próprias** cria você mesmo as colunas, como *Por planear*, *Encomendado* e *Pronto*:

1. Em **Exibição**, em **Agrupar por**, escolha **Colunas próprias** (ou escolha-o logo ao criar)
2. Clique à direita do quadro em **Nova coluna** e dê um nome à coluna
3. No menu de uma coluna escolha **Editar** para alterar o nome ou **Remover**
4. Arraste as colunas pelo título para alterar a ordem

<DocScreenshot src="/screenshots/taken/task-view-own-columns.png" alt="Quadro com colunas próprias Por planear, Encomendado e Pronto, mais Nova coluna" />

As novas colunas próprias começam vazias. Todas as tarefas da vista ficam primeiro em **Sem coluna** até as distribuir. Numa lista pode ocultar essas tarefas com a caixa **Mostrar tarefas sem coluna**. Numa vista filtrada continuam visíveis, senão nunca as poderia distribuir.

<Callout type="warn">
Se passar de **Colunas próprias** para outro agrupamento e o guardar, as colunas próprias dessa vista são removidas, juntamente com o lugar de cada tarefa nelas. Isto não pode ser anulado. O Tillor mostra um aviso antes.
</Callout>

### Atribuir tarefas a uma lista [#taken-toewijzen-aan-een-lijst]

Num quadro de uma lista aparece, enquanto houver tarefas que ainda não estão nela, o botão **Atribuir tarefas**. Abre uma coluna extra **Fora desta vista** com as tarefas que cumprem os filtros da vista mas ainda não estão nela. Pesquise com **Filtrar tarefas...** e arraste uma tarefa para uma coluna para a adicionar à vista. Clique novamente no botão para fechar a coluna.

## Calendário [#kalender]

O calendário mostra uma grelha mensal com as tarefas no seu **prazo**. A semana começa à segunda-feira e os dias seguem o fuso horário da sua organização. As tarefas sem prazo não aparecem no calendário.

- Com as setas vai para o mês anterior ou seguinte, com **Hoje** volta ao mês atual
- Por dia vê no máximo três tarefas. Clique em **+[número] mais** para ver o resto do dia
- Clique numa tarefa para abrir os detalhes
- Arraste uma tarefa para outro dia para mudar o prazo. A hora mantém-se, só o dia muda
- As tarefas concluídas aparecem riscadas, ficam por baixo das tarefas em aberto desse dia e não se podem arrastar

O agrupamento não tem influência no calendário: todas as tarefas aparecem na mesma grelha.

## O que acontece depois? [#wat-gebeurt-er-daarna]

- As suas alterações em **Exibição** são primeiro uma proposta no seu ecrã. Só depois de **Guardar vista** é que valem para todos os que veem a vista.
- Se arrastar um cartão para outra coluna, a própria tarefa é alterada. Num quadro por **Estado**, o estado muda, e os colegas veem-no logo.
- Arrastar um cartão num calendário muda o prazo para esse dia. A hora mantém-se.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não consigo arrastar um cartão para outra coluna">
Num quadro por **Prazo** não é possível, porque o Tillor teria de inventar um prazo. Altere o prazo na tarefa. As tarefas num calendário arrastam-se para outro dia, exceto as tarefas concluídas.
</Accordion>
<Accordion title="O Tillor diz que a tarefa não pôde ser movida">
Vê **Falha ao mover a tarefa**. O cartão volta ao lugar anterior. Tente novamente.
</Accordion>
<Accordion title="Falta a opção Esquema ou Tipo">
Só existem nas vistas guardadas, não em **Todas**.
</Accordion>
<Accordion title="Uma tarefa não aparece no calendário">
O calendário mostra as tarefas no seu prazo. Uma tarefa sem prazo não aparece.
</Accordion>
<Accordion title="As minhas tarefas estão em Sem coluna">
Nas novas colunas próprias, todas as tarefas começam em **Sem coluna** até as distribuir. Arraste-as para a coluna certa.
</Accordion>
<Accordion title="As minhas colunas próprias desapareceram">
Passou para outro agrupamento e guardou. Ao fazê-lo, o Tillor remove as colunas próprias, e isso não pode ser anulado. O Tillor avisa antes.
</Accordion>
</Accordions>


# Visão geral (/pt-PT/taken)

Com o sistema de tarefas acompanha o que tem de ser feito no seu parque e por quem. Uma tarefa pode ter um prazo, um lembrete, um ou mais colegas ou grupos atribuídos, etiquetas, anexos, subtarefas, tempo gasto e clientes, parcelas, faturas, reservas, contadores, conversas ou transações bancárias associados.

Vê as tarefas através de **vistas**. Uma vista é uma forma guardada de olhar para as suas tarefas, por exemplo *Tarefas em aberto*, *As minhas tarefas* ou *Manutenção*. Cada vista aparece como um separador no topo da página.

## Onde encontrar tarefas [#waar-vind-je-taken]

- **Tarefas** no menu lateral: a página principal com todas as suas vistas
- **Painel**: o cartão **Tarefas para si** mostra as tarefas que lhe estão atribuídas, ou a sua vista favorita
- **Clientes > [cliente] > Tarefas**: todas as tarefas associadas a um cliente
- **Tarefas em aberto**: um bloco na página de um cliente, reserva, fatura, parcela e contador

<DocScreenshot src="/screenshots/taken/tasks-board.png" alt="Página de tarefas com separadores por vista e um quadro por estado" />

No topo estão as vistas como separadores. Por baixo estão a barra de pesquisa e os filtros, e à direita os botões **Exibição**, **Seguir** e partilhar. Por baixo vê as tarefas, aqui como um quadro por estado. Passe o rato sobre as marcas ℹ para obter explicações.

## Como se liga tudo? [#hoe-hangt-dit-samen]

Uma tarefa é uma coisa só, e as vistas são formas de ver tarefas. As tarefas surgem por colegas ou por automatizações. Uma automatização também pode ficar à espera de uma tarefa.

```mermaid
flowchart LR
  A["Um colega cria uma tarefa<br/>na página de tarefas ou a partir de um cliente, fatura ou contador"] --> T["Tarefa"]
  B["Uma automatização cria uma tarefa<br/>passo Criar tarefa, em nome de Workflow"] --> T
  T --> L["Lista<br/>mostra apenas as tarefas que você lhe adiciona"]
  T --> G["Vista filtrada<br/>mostra todas as tarefas que cumprem os filtros"]
  L --> Z["A visibilidade da vista<br/>determina quem vê a tarefa"]
  T -- "Um colega escolhe um botão na tarefa" --> W["A automatização deixa de esperar<br/>e continua"]
  T -- "O estado ou a atribuição muda" --> S["Uma automatização pode arrancar com isso"]
```

- Se colocar uma tarefa numa vista, nada muda na própria tarefa. Só a vista a recebe.
- Uma vista filtrada não retira tarefas: elas aparecem ou desaparecem sozinhas conforme cumprem ou não os filtros.
- Uma tarefa que uma automatização cria é uma tarefa normal. Se tiver botões de escolha (passo **Pedir uma decisão**), a automatização espera até alguém escolher um botão. Veja [Tarefas com botões de escolha](/taken/taakdetails#taken-met-keuzeknoppen) e [Tarefas em automatizações](/automatiseringen/acties/taken).

## Começar depressa [#snel-aan-de-slag]

1. Abra **Tarefas** no menu lateral
2. Clique em **Nova vista**. Preencha um **Nome** e escolha em **Visibilidade**, **Conteúdo**, **Colunas** e **Começar com** o que pretende. Depois clique em **Nova vista** no fundo da caixa de diálogo
3. Clique no topo de uma coluna em **Nova tarefa**, dê um nome à tarefa e clique em **Criar**
4. Clique numa tarefa para abrir os detalhes: estado, prioridade, prazo, colegas atribuídos e mais
5. Marque a caixa à esquerda de uma tarefa assim que estiver concluída

<DocScreenshot src="/screenshots/taken/task-view-create-dialog.png" alt="Caixa de diálogo Nova vista com nome, visibilidade, conteúdo, colunas e filtro inicial" />

Sem vistas próprias pode sempre recorrer à vista integrada **Todas**, que mostra todas as tarefas que pode ver. Os filtros guardados em **Todas** aplicam-se a toda a organização.

## Estados [#statussen]

| Estado | Significado |
|---|---|
| **Pendente** | A tarefa está planeada mas ainda não foi iniciada |
| **Em curso** | Está-se a trabalhar ativamente na tarefa |
| **A aguardar resposta** | Só pode continuar quando outra pessoa, como um cliente ou fornecedor, fizer algo ou responder |
| **Concluída** | A tarefa está terminada |

Assim se vê o mesmo tipo de tarefa antes e depois de a marcar. Em cima está uma tarefa em aberto, por baixo uma concluída: o título está riscado e o estado é **Concluída**.

<DocScreenshot src="/screenshots/taken/task-card-open.png" alt="Antes: uma tarefa em aberto com o estado Em curso" />

<DocScreenshot src="/screenshots/taken/task-card-done.png" alt="Depois: uma tarefa concluída com o título riscado e o estado Concluída" />

Uma tarefa concluída desce numa lista ou coluna ordenada manualmente. Se colocar uma tarefa principal em **Concluída**, as subtarefas em aberto também ficam concluídas. Se depois voltar a abrir a tarefa, as subtarefas continuam concluídas.

Uma vista pode ocultar as tarefas concluídas ao fim de algum tempo, veja [Ocultar tarefas concluídas](/taken/indelingen#voltooide-taken-verbergen).

## Prioridades [#prioriteiten]

Uma tarefa tem a prioridade **Baixa**, **Média**, **Alta** ou **Urgente**.

## Componentes [#onderdelen]

<Cards>
  <Card
    title="Vistas"
    href="/taken/weergaven"
    description="Criar, partilhar, duplicar e seguir listas e vistas filtradas"
  />
  <Card
    title="Tabela, quadro e calendário"
    href="/taken/indelingen"
    description="Escolha como as tarefas são mostradas, agrupe e ordene"
  />
  <Card
    title="Filtrar"
    href="/taken/filteren"
    description="Encontrar tarefas por estado, prazo, cliente, item associado e mais"
  />
  <Card
    title="Detalhes da tarefa"
    href="/taken/taakdetails"
    description="Tudo o que pode registar numa tarefa, de subtarefas e tempo gasto até à impressão"
  />
  <Card
    title="Tarefas privadas"
    href="/taken/prive-taken"
    description="Quem vê uma tarefa depende das vistas em que ela está"
  />
  <Card
    title="Etiquetas"
    href="/taken/labels"
    description="Gerir etiquetas e definir automaticamente um prazo"
  />
  <Card
    title="Notificações"
    href="/taken/meldingen"
    description="Lembretes, prazos e o resumo diário de uma vista"
  />
  <Card
    title="Partilhar tarefas"
    href="/taken/delen"
    description="Criar uma página só de leitura ou uma subscrição de calendário"
  />
  <Card
    title="Tarefas noutras páginas"
    href="/taken/taken-op-andere-paginas"
    description="Criar tarefas a partir de clientes, faturas, conversas e mais"
  />
</Cards>

<Callout type="info" title="Bom saber">
- Não existem permissões separadas para tarefas. Quem trabalha no Tillor pode criar e editar tarefas. Que tarefas vê depende das vistas em que elas estão. Veja [Tarefas privadas](/taken/prive-taken)
- Uma nova tarefa pode ter até 50 subtarefas. As subtarefas têm apenas um nível
- Se colocar uma tarefa em **Concluída**, as subtarefas em aberto também ficam concluídas
- Quem segue uma vista recebe todas as manhãs às 07:00 um resumo, com no máximo 15 tarefas por lista
- Um cronómetro em curso faz uma pausa após dez minutos sem rato nem teclado
- Uma etiqueta com um **Prazo-alvo (dias)** dá automaticamente um prazo às tarefas sem prazo
- Uma tarefa que elimina não pode ser reposta
</Callout>

## Conceitos [#begrippen]

- **Tarefa**: um trabalho que acompanha, com estado, prioridade, prazo e, eventualmente, colegas atribuídos
- **Vista**: um separador na página de tarefas com uma forma própria de mostrar tarefas, veja [Vistas](/taken/weergaven)
- **Lista**: uma vista que mostra apenas as tarefas que você lhe adiciona
- **Vista filtrada**: uma vista que mostra todas as tarefas que cumprem os filtros
- **Subtarefa**: uma parte de uma tarefa, como lista de verificação
- **Bloqueio**: uma tarefa que tem de estar concluída antes de outra poder começar
- **Workflow**: o utilizador em nome do qual uma [automatização](/begrippen#automatisering) cria tarefas

Encontra mais termos na [lista de conceitos](/begrippen).


# Etiquetas (/pt-PT/taken/labels)

Com etiquetas dá às tarefas uma categoria, por exemplo *Manutenção*, *Reclamações* ou *Época*. Pode filtrar e agrupar por etiquetas. Uma etiqueta tem um nome, uma cor e, se quiser, uma descrição.

## Gerir etiquetas [#labels-beheren]

Vá a <UIPath>Definições > Etiquetas de tarefas</UIPath>. Vê essa página se puder ver ou editar as definições gerais da sua organização. A lista tem as colunas **Etiqueta**, **Descrição** e **Tarefas** (o número de tarefas com essa etiqueta).

<DocScreenshot src="/screenshots/taken/task-labels-settings.png" alt="Definições, página Etiquetas de tarefas com as etiquetas Administração, Manutenção e Receção" />

- **Nova etiqueta** cria uma etiqueta com um **Nome**, **Descrição**, **Cor** e, se quiser, um **Prazo-alvo (dias)**
- **Editar etiqueta** altera depois esses dados
- **Eliminar etiqueta** remove a etiqueta e mostra antes em quantas tarefas ela está. A etiqueta desaparece de todas essas tarefas

Também pode criar uma etiqueta enquanto edita uma tarefa: escreva o nome no campo **Etiquetas** e escolha **Criar [nome]**.

## Definir um prazo automaticamente [#een-deadline-automatisch-instellen]

<DocScreenshot src="/screenshots/taken/task-label-dialog.png" alt="Caixa de diálogo Criar etiqueta com nome, descrição, cor e prazo-alvo" />

Numa etiqueta pode preencher o **Prazo-alvo (dias)**, por exemplo *7*. Uma tarefa sem prazo que receba essa etiqueta passa a ter um prazo: esse número de dias depois do momento em que a tarefa foi criada ou a etiqueta foi adicionada.

- Isto acontece ao criar uma tarefa com a etiqueta, ou se adicionar a etiqueta mais tarde
- Se a tarefa já tiver um prazo, este mantém-se como está
- Se uma tarefa tiver várias etiquetas com um objetivo, vale o menor número de dias
- Se deixar o campo vazio, a etiqueta não define nenhum prazo

Isto é útil para etiquetas como *Reclamação* (em 2 dias) ou *Seguimento de orçamento* (em 7 dias).

## O que acontece depois? [#wat-gebeurt-er-daarna]

- Pode dar logo uma nova etiqueta a tarefas, na própria tarefa e no menu rápido.
- Uma etiqueta com um **Prazo-alvo (dias)** passa a dar automaticamente um prazo às tarefas sem prazo.
- Se eliminar uma etiqueta, ela desaparece de todas as tarefas em que estava. As tarefas continuam a existir.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não vejo a página Etiquetas de tarefas">
Não lhe foi permitido ver as definições gerais da sua organização. Peça a um administrador que ajuste as suas permissões.
</Accordion>
<Accordion title="O Tillor diz Não foi possível criar a etiqueta">
Preencha um **Nome** (no máximo 50 caracteres) e tente novamente. Ao editar e eliminar, os avisos chamam-se **Não foi possível atualizar a etiqueta** e **Não foi possível eliminar a etiqueta**.
</Accordion>
<Accordion title="A minha tarefa não recebeu um prazo da etiqueta">
Um prazo da etiqueta só é aplicado a tarefas sem prazo. Se a tarefa já tiver um, este mantém-se. Com várias etiquetas com um objetivo, vale o menor número de dias.
</Accordion>
</Accordions>


# Notificações (/pt-PT/taken/meldingen)

O Tillor mantém-no a par das tarefas por e-mail e notificações push.

## Lembretes e prazos [#herinneringen-en-deadlines]

Se uma tarefa tiver um **Lembrete** ou uma **Data limite**, escolhe na janela de detalhes, em **Notificações**, se quer um **E-mail** e/ou um **Aviso push**. Ambos estão ativos por predefinição. Se desativar os dois, ninguém recebe uma notificação para essa tarefa.

- Um lembrete dispara no momento definido, com o título *Lembrete de tarefa*
- Um aviso de prazo dispara assim que o prazo é atingido e a tarefa ainda não está concluída
- As tarefas concluídas deixam de dar lembrete ou aviso de prazo
- Um lembrete recorrente dispara em cada repetição, até a tarefa ser concluída ou o calendário terminar

A notificação vai para os colegas atribuídos, também para os membros de um grupo atribuído. Se ninguém estiver atribuído, vai para quem criou a tarefa. O e-mail mostra uma pré-visualização da tarefa, com o estado e um botão para a abrir.

## Atribuir, desassociar e concluir [#toewijzen-ontkoppelen-en-voltooien]

- Se uma tarefa lhe for atribuída, também através de um grupo em que está, recebe uma notificação (**Nova tarefa atribuída**). Se atribuir uma tarefa a si próprio, não recebe notificação
- Se alguém o retirar de uma tarefa, recebe uma notificação de que a tarefa foi **desatribuída** (**Tarefa desatribuída**)
- Quando uma tarefa é concluída, os colegas atribuídos e quem a criou recebem uma notificação, exceto quem a concluiu. A notificação é enviada com cerca de um minuto de atraso. Se alguém voltar a abrir a tarefa nesse intervalo, ela já não é enviada

## Seguir uma vista [#een-weergave-volgen]

Com **Seguir** (no canto superior direito de uma vista guardada) recebe todas as manhãs às 07:00 um e-mail com um resumo dessa vista. O e-mail tem o assunto *Resumo diário* com o nome da vista e contém três listas:

- **Em atraso** - tarefas em aberto cujo prazo já passou
- **Vencem hoje** - tarefas em aberto que têm de estar concluídas hoje
- **Alteradas desde o último resumo** - tarefas em aberto que foram alteradas desde o seu último resumo

Cada lista mostra no máximo 15 tarefas com o prazo ao lado. No fim está o botão **Abrir vista**, que salta diretamente para a vista.

- Se não houver nada nas três listas, nesse dia não recebe e-mail
- O botão passa a **A seguir**. Clique nele para deixar de seguir. Pode seguir qualquer vista que consiga ver, também as vistas de colegas
- Se perder o acesso à vista, por exemplo porque o proprietário a torna só sua ou a elimina, deixa automaticamente de seguir
- Só vê as tarefas que você próprio pode ver

<Callout type="info">
A vista integrada **Todas** não se pode seguir, porque não é uma vista guardada.
</Callout>

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não recebo lembrete nem aviso de prazo">
Verifique na tarefa, em **Notificações**, se **E-mail** ou **Aviso push** está ativo. Uma notificação vai para os colegas atribuídos, ou para quem criou a tarefa se ninguém estiver atribuído. As tarefas concluídas deixam de dar notificação.
</Accordion>
<Accordion title="Não recebo notificação quando atribuo uma tarefa a mim próprio">
É assim mesmo. Só recebe uma notificação **Nova tarefa atribuída** quando outra pessoa lhe atribui a tarefa.
</Accordion>
<Accordion title="Não recebo o resumo diário">
Não segue a vista (o botão **Seguir** tem de mostrar **A seguir**), ou não há nada em **Em atraso**, **Vencem hoje** e **Alteradas desde o último resumo**. Nesse caso não enviamos e-mail nesse dia. Também deixa automaticamente de seguir se já não puder ver a vista.
</Accordion>
<Accordion title="O Tillor diz Não foi possível atualizar o seguimento">
A alteração não foi guardada. Clique novamente em **Seguir**.
</Accordion>
</Accordions>


# Tarefas privadas (/pt-PT/taken/prive-taken)

Uma tarefa é privada se estiver apenas em vistas pessoais. Não precisa de definir nada para isso: as vistas em que uma tarefa está determinam quem a vê.

## As regras [#de-regels]

| Onde está a tarefa | Quem a vê |
|---|---|
| Em nenhuma vista | Todos os utilizadores da organização |
| Em pelo menos uma vista **Pública** | Todos os utilizadores da organização |
| Apenas em vistas pessoais (**Só você** ou **Partilhada**) | Quem criou a tarefa, os colegas e grupos atribuídos, e o proprietário e as pessoas e grupos escolhidos dessas vistas |

As subtarefas seguem a sua tarefa principal. Uma tarefa que não pode ver não aparece em lado nenhum: nem em listas, resultados de pesquisa, filtros, no painel, num cliente, no calendário ou em notificações, e também não a pode abrir através de uma ligação.

## Exemplo [#voorbeeld]

O João cria a vista pessoal *As minhas ideias* com a visibilidade **Só você**. Adiciona a tarefa *Pedir orçamento para nova cancela* a essa lista.

- Só o João vê a tarefa. Os colegas não a veem em lado nenhum
- O João atribui a tarefa ao Pedro. Agora o Pedro também vê a tarefa, mesmo nunca tendo visto a vista do João
- O João partilha *As minhas ideias* com a Elsa (**Partilhada**). Agora a Elsa também vê a tarefa
- O João adiciona a tarefa à vista *Manutenção*, que é **Pública**. A partir daqui toda a equipa vê a tarefa
- Se o João voltar a retirar a tarefa de *Manutenção*, e ela não estiver em mais nenhuma vista pública, volta a ser privada

Se o João não tivesse colocado a tarefa em nenhuma vista, todos a teriam visto.

## Quem determina a visibilidade de uma vista [#wie-bepaalt-de-zichtbaarheid-van-een-weergave]

Só o proprietário de uma vista pessoal pode alterar com quem a vista é partilhada, ou torná-la **Pública**. Um colega com quem partilha a vista pode editar tarefas na vista, mas não pode alterar a visibilidade nem eliminar a vista. Veja [Vistas](/taken/weergaven#wie-ziet-een-weergave).

<Callout type="warn">
Adicionar uma tarefa privada a uma vista pública torna-a visível para todos. O Tillor pede primeiro para confirmar com **Tornar esta tarefa pública?**. Pode então escolher **Manter privada** ou **Tornar pública**. A mesma pergunta aparece se retirar a tarefa da sua última vista pública. Se tornar **Pública** uma vista pessoal que contém tarefas, essas tarefas ficam visíveis para todos sem pergunta separada.
</Callout>

## Dicas [#tips]

- Se quiser passar uma tarefa privada a outra pessoa, atribua-a a um colega ou partilhe a vista com esse colega
- Uma tarefa conta como "numa vista" assim que a adiciona a uma lista ou a coloca numa coluna própria da vista. Apenas mostrá-la através de um filtro não faz com que esteja na vista
- As notificações sobre uma tarefa privada, como um prazo, só vão para quem pode ver a tarefa

## Problemas? [#problemen]

<Accordions>
<Accordion title="Um colega não vê a minha tarefa">
A tarefa está apenas em vistas pessoais. Atribua-a ao colega, partilhe a vista com ele, ou coloque a tarefa numa vista pública.
</Accordion>
<Accordion title="O Tillor pergunta Tornar esta tarefa pública?">
Está a adicionar uma tarefa privada a uma vista pública, ou a retirá-la da sua última vista pública. Escolha **Manter privada** ou **Tornar pública**.
</Accordion>
<Accordion title="Já não vejo uma tarefa que ainda tinha ontem">
Talvez a tarefa tenha sido associada a outra vista, ou a vista em que estava já não esteja visível para si. Pergunte a quem a criou ou ao proprietário da vista.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Vistas" href="/taken/weergaven" />
  <Card title="Detalhes da tarefa" href="/taken/taakdetails" />
</Cards>


# Detalhes da tarefa (/pt-PT/taken/taakdetails)

Na janela de detalhes de uma tarefa registe tudo: quem a faz, quando tem de estar concluída, quanto tempo leva e a que está associada. Clique numa tarefa para abrir a janela. À esquerda ficam o nome, a descrição e partes como as subtarefas e os comentários. À direita ficam as propriedades, como o estado, a prioridade e o prazo. As alterações a uma tarefa existente são guardadas de imediato. Só a descrição é que guarda você mesmo com **Guardar**.

<DocScreenshot src="/screenshots/taken/task-detail-dialog.png" alt="Janela da tarefa com descrição, subtarefas, comentários e, à direita, as propriedades, campos personalizados, itens associados e anexos" />

Também pode abrir uma tarefa diretamente com uma ligação. Copie-a no menu com os três pontos, no canto superior direito da janela, veja [O menu da tarefa](#het-menu-van-de-taak).

## Criar uma tarefa [#een-taak-aanmaken]

Pode criar tarefas em vários locais: no topo de uma coluna de um quadro (**Nova tarefa**), no cartão **Tarefas para si** do painel, na página do cliente, ou a partir de uma conversa, fatura ou outro item, veja [Tarefas noutras páginas](/taken/taken-op-andere-paginas).

1. Clique em **Nova tarefa**
2. Preencha um **Nome**. O resto é opcional
3. Se quiser, adicione subtarefas em **Adicionar uma subtarefa**: escreva um nome e prima Enter. Pode indicar até 50
4. Clique em **Criar**, ou prima Cmd ou Ctrl juntamente com Enter

<DocScreenshot src="/screenshots/taken/task-create-dialog.png" alt="Caixa de diálogo Nova tarefa com um nome e duas subtarefas" />

No topo da janela aparece a vista em que a tarefa fica. Se criar a tarefa a partir de uma coluna de um quadro, ela recebe automaticamente essa vista e essa coluna. Pode escolher outra ou retirar a vista.

Você próprio aparece preenchido como pessoa atribuída. Se se retirar e não escolher ninguém, a tarefa fica sem pessoa atribuída. Os bloqueios e o tempo gasto adicionam-se depois de a tarefa ser criada.

## Propriedades [#eigenschappen]

- **Estado** e **Prioridade** - veja a [visão geral](/taken#statussen)
- **Atribuído a** - um ou mais colegas ou [grupos](/gebruikers/groepen). Procure com **Procurar pessoas ou grupos...**. Se atribuir um grupo, a tarefa aplica-se a todos os que estiverem nesse momento no grupo
- **Clientes** - associe um ou mais clientes com **Adicionar um cliente**
- **Etiquetas** - veja [Etiquetas](/taken/labels). Uma etiqueta em falta cria-se logo escrevendo o nome e escolhendo **Criar [nome]**
- **Prazo** - a data limite, com a hora. Se o prazo já passou, o tempo relativo fica vermelho
- **Lembrete** - uma data e hora em que quer receber um aviso, eventualmente repetido
- **Notificações** - assim que um lembrete ou prazo estiver definido, escolha se quer **E-mail** e/ou **Notificação push**. Ambos vêm ativados por predefinição
- **Criada por** - quem criou a tarefa
- **Campos personalizados** - campos que a sua organização adicionou às tarefas. As alterações são guardadas de imediato. Veja [Campos personalizados](/eigen-velden)
- **Vista** - clique no nome da vista, em cima à esquerda, para escolher em que listas a tarefa está e em que coluna. Numa vista filtrada só escolhe uma coluna
- **Privada** - se aparecer um cadeado com **Privada**, a tarefa só está em vistas pessoais, veja [Tarefas privadas](/taken/prive-taken)

Uma tarefa também pode ter uma **Descrição**. Esta suporta Markdown para formatação.

## Lembretes repetidos [#herhalende-herinneringen]

Um lembrete pode repetir-se até a tarefa estar concluída:

1. Defina primeiro um **Lembrete** (data e hora)
2. Clique no campo de repetição por baixo (por predefinição **Não se repete**)
3. Escolha **Diariamente**, **Todos os dias úteis (seg. – sex.)**, **Semanalmente**, **Mensalmente**, **Anualmente** ou **Personalizado…**

Com **Personalizado…** monta o seu próprio calendário:

- **Repetir a cada** - um número de dias, semanas, meses ou anos
- **Repetir em** - num calendário semanal, os dias da semana em que o lembrete pode chegar
- **Termina** - **Nunca**, **Na data** ou **Após** um número de vezes

Se um lembrete cair num dia que excluiu, passa sem aviso para o próximo dia permitido. A repetição termina quando a tarefa fica **Concluída** ou o calendário acaba.

## Itens associados [#gekoppelde-items]

Em **Itens associados** vê a que a tarefa está ligada. Pode associar vários de cada tipo: parcelas, faturas, reservas, contadores, chamadas telefónicas, transações bancárias, produtos e conversas da caixa de entrada. Uma tarefa também pode estar associada a um comentário. Uma tarefa sobre uma transação bancária cria-a no menu da transação em **Transações bancárias** com **Criar tarefa**. Uma tarefa sobre um produto, como a verificação da conta do razão, cria-a na página do produto através do menu **⋯** com **Criar tarefa**; as tarefas em aberto do produto ficam no topo dessa página.

Um item adicional associa-se com o sinal de mais em **Itens associados** (dica **Associar item**). Procure por cliente, parcela, contador, fatura, reserva ou produto. Se o item escolhido pertencer a um cliente, o Tillor pergunta **Associar também [cliente]?**:

- **Associar ambos** - a tarefa também aparece no cliente
- **Apenas este item** - o cliente não é associado à tarefa

Com **Desassociar** remove de novo uma associação. As tarefas associadas que ainda estão em aberto aparecem na página do item em **Tarefas em aberto**.

## Anexos [#bijlagen]

Em **Anexos** adiciona ficheiros à tarefa. Clique no sinal de mais, ou cole um ficheiro com Cmd ou Ctrl e V em qualquer ponto da janela.

## Subtarefas [#subtaken]

Uma tarefa pode ter subtarefas, uma lista de verificação na janela de detalhes. Só existe um nível: uma subtarefa não pode ter subtarefas.

1. Abra a tarefa principal, ou preencha-as já enquanto cria uma tarefa
2. Em **Adicionar uma subtarefa** escreva um nome e prima Enter
3. Assinale uma subtarefa para a passar a **Concluída**. Assinale-a de novo para a repor
4. Clique no nome para o alterar, ou no caixote do lixo para a eliminar
5. Arraste uma subtarefa pela pega para mudar a ordem. Com **Adicionar descrição** também lhe dá uma descrição

Numa tarefa nova, as subtarefas são criadas juntamente com a tarefa, pela ordem em que as preencheu. As subtarefas não aparecem como cartão próprio em quadros, tabelas ou no calendário. Na tarefa vê um contador como **2/5**. Se passar a tarefa principal a **Concluída**, todas as subtarefas em aberto são também concluídas. O inverso não acontece: pode concluir a tarefa principal com subtarefas ainda em aberto.

## Bloqueios e dependências [#blokkades-en-afhankelijkheden]

Por vezes uma tarefa só pode começar ou terminar quando outra está pronta. Na janela de detalhes regista isso:

- **Bloqueada por** - tarefas que têm de estar prontas primeiro. Adicione-as com **Adicionar tarefa bloqueadora**
- **Bloqueia outras tarefas** - tarefas que esperam por esta. Adicione-as com **Adicionar tarefa bloqueada**

Em cada grupo vê quantas tarefas ainda estão em aberto (por exemplo **2 ainda em aberto**). Procure tarefas com **Procurar tarefas...** e remova uma associação com **Remover ligação**. No cartão da tarefa aparece, por baixo do nome, uma linha como **Bloqueada por 1 tarefa**. Pode filtrar por tarefas bloqueadas, veja [Filtrar](/taken/filteren).

Um bloqueio não o impede. Se tentar assinalar uma tarefa bloqueada, o Tillor pergunta **Concluir uma tarefa bloqueada?** e só a conclui se escolher **Concluir mesmo assim**.

Também adiciona um bloqueio através do menu com os três pontos, no canto superior direito da janela, com **Adicionar tarefa bloqueadora** e **Adicionar tarefa bloqueada**.

## Tempo gasto [#bestede-tijd]

Ao lado de **Tempo gasto** na janela de detalhes está o total. Clique nele para registar tempo.

<DocScreenshot src="/screenshots/taken/task-time-popover.png" alt="Tempo gasto com o botão Iniciar, um campo para um registo manual e os registos dos colegas" />

Tem duas formas:

- Um **cronómetro**. Clique em **Iniciar**, trabalhe na tarefa e clique no botão de paragem quando terminar. O tempo é colocado na tarefa com os segundos
- **Preencher depois**. Indique a duração, por exemplo **1:30**, **90** (minutos), **1h 30m** ou **1.5h**. As quatro formas significam uma hora e meia. Se quiser, adicione uma nota em **O que fez? (opcional)** e clique em **Registar**

O tempo é registado no dia de hoje. Na lista vê, por registo, quem o fez, a data, a nota e a duração. Os colegas veem os registos uns dos outros, mas só pode eliminar os seus próprios registos, através do caixote do lixo que aparece quando passa o rato sobre a linha.

### O cronómetro [#de-timer]

- Um cronómetro em curso continua a contar quando vai para outra página. Fica então como um pequeno cartão em baixo à direita, com botões para pausar (**Pausar**), retomar (**Retomar**), **Fazer check-in** e parar (**Terminar**). Clique no nome da tarefa para voltar
- Com **Fazer check-in** guarda o período até agora, com uma nota curta sobre o que estava a fazer, e o cronómetro continua depois
- Só pode registar tempo numa tarefa de cada vez. Enquanto o seu cronómetro estiver a contar, **Iniciar** fica desativado nas outras tarefas
- Se durante dez minutos não usar o rato nem o teclado, o cronómetro pausa no último momento em que esteve ativo
- Os colegas veem na janela da tarefa que está a trabalhar (**Em curso**) ou em pausa (**Em pausa**). Esse tempo só conta para o total depois de guardado

## Comentários e atividade [#opmerkingen-en-activiteit]

Em baixo na janela fica a secção **Comentários**. Com **Adicionar comentário** escreve um comentário. Pode mencionar colegas num comentário, para que recebam uma notificação. Por baixo fica a **atividade**: uma linha cronológica da criação e das alterações, com o que havia antes e depois em cada alteração.

## O menu da tarefa [#het-menu-van-de-taak]

No canto superior direito da janela fica um menu com três pontos.

<DocScreenshot src="/screenshots/taken/task-dialog-menu.png" alt="Menu da tarefa com adicionar bloqueios, Imprimir, Copiar ligação e Remover" />

- **Adicionar tarefa bloqueadora** e **Adicionar tarefa bloqueada** registam uma dependência
- **Imprimir** tem três opções. **Imprimir (A4)** abre a caixa de impressão do seu navegador com um PDF da tarefa. **Enviar para a impressora A4** e **Enviar para a impressora térmica (POS)** enviam a tarefa para a sua impressora, por exemplo uma impressora de talões. Estas duas só pode escolhê-las se a sua organização tiver um [conector](/connector) com impressora, veja [Impressora](/printer)
- **Copiar ligação** copia uma ligação que abre a tarefa diretamente. Quem abrir a ligação tem de poder ver a tarefa
- **Remover** fica em baixo, veja [Eliminar uma tarefa](#een-taak-verwijderen)

A impressão mostra o nome, o estado, a prioridade, o prazo e a descrição e, em **Itens associados**, os clientes, faturas, reservas, parcelas e contadores a que a tarefa está ligada. Se a tarefa tiver bloqueios, também aparecem as tarefas que a bloqueiam e as tarefas que ela própria bloqueia. Um grupo sem itens é omitido.

## Tarefas com botões de escolha [#taken-met-keuzeknoppen]

Algumas tarefas, por exemplo de uma [automação com o passo Pedir uma decisão](/automatiseringen/logica#vraag-om-een-beslissing), pedem uma decisão. Em vez de uma caixa de seleção há botões na tarefa, com por cima **Escolha uma ação para concluir esta tarefa**. Clica num botão e a tarefa fica concluída.

- Se a escolha exigir um motivo, o Tillor abre primeiro uma janela com **Porquê esta escolha?** onde preenche uma nota
- Se a escolha exigir uma confirmação, o Tillor mostra primeiro uma janela. Uma escolha feita já não pode ser anulada a partir da tarefa
- Depois, na tarefa fica indicado qual foi a escolha e por quem
- Podem escolher quem está atribuído à tarefa e um administrador. Se ninguém estiver atribuído, qualquer pessoa que veja a tarefa pode escolher

Assim se relacionam a tarefa e a automação:

```mermaid
flowchart TD
  A["A automação chega ao passo<br/>Vraag om een beslissing"] --> B["O Tillor cria uma tarefa com os seus botões<br/>e a automação espera"]
  B --> C{"Um colega escolhe um botão"}
  C -- "Uma opção" --> D["A tarefa fica Concluída<br/>a automação continua por essa opção"]
  C -- "Ninguém escolhe dentro do tempo de espera" --> E["A automação continua por Expirado<br/>a tarefa continua a existir"]
  C -- "A tarefa é eliminada" --> E
```

Uma tarefa criada por uma automação e que só o fluxo pode concluir mostra, em vez de uma caixa de seleção, o texto **Concluída pela sua automação**. Não a pode concluir e no menu não tem **Remover**.

## Alterar o estado rapidamente e assinalar [#status-snel-wijzigen-en-afvinken]

Sem abrir a janela pode:

- Assinalar a caixa à esquerda do nome da tarefa para a passar a **Concluída**. Se a desmarcar, volta a **Pendente**
- Clicar nos três pontos do cartão da tarefa, ou com o botão direito do rato no cartão, para um menu rápido com **Editar**, **Estado**, **Prioridade**, **Lembrete**, **Prazo**, **Etiquetas**, **Vistas** e **Remover**. **Etiquetas** só aparece se existirem etiquetas e **Vistas** só se existirem listas a que você próprio adiciona tarefas

<DocScreenshot src="/screenshots/taken/task-actions-menu.png" alt="Menu rápido de um cartão de tarefa" />

## Eliminar uma tarefa [#een-taak-verwijderen]

Escolha **Remover** no menu rápido da tarefa, ou no menu com os três pontos na janela da tarefa, e confirme. Isto não pode ser anulado e as eventuais subtarefas desaparecem também. A eliminação fica registada no [registo de atividade](/activiteitenlog).

Numa tarefa que só uma automação pode concluir, **Remover** não aparece no menu. Se uma tarefa assim for mesmo eliminada de outra forma, a automação que esperava pela conclusão falha.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- As alterações a uma tarefa existente ficam guardadas de imediato. Só a descrição é que guarda você mesmo com **Guardar**.
- Se atribuir a tarefa, esse colega (ou os membros do grupo) recebe uma notificação. Veja [Notificações](/taken/meldingen).
- Se passar a tarefa a <Status tone="success">Concluída</Status>, as subtarefas em aberto também são concluídas e os colegas atribuídos e o criador recebem uma notificação, exceto você. A tarefa desce para o fim numa lista ordenada manualmente.
- Um lembrete ou prazo gera uma notificação até a tarefa estar concluída.
- Uma tarefa criada por uma [automação](/automatiseringen/acties/taken) também pode iniciar uma automação, por exemplo numa alteração de estado ou quando alguém escolhe um botão.
- A eliminação não pode ser anulada. A eliminação fica no [registo de atividade](/activiteitenlog).

## Problemas? [#problemen]

<Accordions>
<Accordion title="O Tillor pergunta Concluir uma tarefa bloqueada?">
A tarefa ainda espera por uma ou mais tarefas por concluir (veja **Bloqueada por**). Conclua primeiro essas tarefas, ou escolha **Concluir mesmo assim**.
</Accordion>
<Accordion title="Vejo um texto em vez de uma caixa de seleção">
Com **Concluída pela sua automação** não pode concluir a tarefa você mesmo. A automação conclui-a. Se a tarefa tiver botões em **Escolha uma ação para concluir esta tarefa**, clique num botão.
</Accordion>
<Accordion title="Não consigo usar os botões de uma tarefa">
Podem escolher quem está atribuído à tarefa e um administrador. Se ninguém estiver atribuído, qualquer pessoa que veja a tarefa pode escolher. Com a mensagem de erro **Não foi possível guardar a escolha**, tente de novo.
</Accordion>
<Accordion title="O botão Iniciar do cronómetro está cinzento">
O seu cronómetro já está a contar noutra tarefa. Só pode registar tempo numa tarefa de cada vez. Pare primeiro esse cronómetro.
</Accordion>
<Accordion title="O meu cronómetro parou enquanto eu trabalhava">
Após dez minutos sem rato nem teclado, o cronómetro pausa no último momento em que esteve ativo. Use **Retomar** para continuar.
</Accordion>
<Accordion title="Registar o tempo falha">
Indique uma duração que o Tillor perceba, como **1:30**, **90**, **1h 30m** ou **1.5h**. Se mesmo assim falhar, vê a mensagem **Não foi possível registar o tempo** e tente de novo. Só pode eliminar os seus próprios registos.
</Accordion>
<Accordion title="Não é possível imprimir para a impressora">
**Enviar para a impressora A4** e **Enviar para a impressora térmica (POS)** só pode escolhê-las se a sua organização tiver um conector com impressora. **Imprimir (A4)** funciona sempre. Se algo correr mal, vê a mensagem **Não foi possível gerar o PDF da tarefa**.
</Accordion>
<Accordion title="O Tillor diz Falha ao atualizar a tarefa">
A alteração não foi guardada. Tente de novo ou atualize a página.
</Accordion>
<Accordion title="Não consigo eliminar uma tarefa">
Numa tarefa que só uma automação pode concluir, **Remover** não aparece no menu. Fora isso, qualquer colega que veja a tarefa pode eliminá-la.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Vistas" href="/taken/weergaven" />
  <Card title="Etiquetas" href="/taken/labels" />
  <Card title="Tarefas nas automações" href="/automatiseringen/acties/taken" />
</Cards>


# Tarefas noutras páginas (/pt-PT/taken/taken-op-andere-paginas)

As tarefas não vivem isoladas. Cria-as a partir do item de que tratam e volta a vê-las aí.

## Criar uma tarefa a partir de outro item [#een-taak-maken-vanuit-een-ander-item]

A tarefa é associada automaticamente ao item. Se houver um cliente envolvido, também o pode associar. Por predefinição, a tarefa é atribuída a si.

| Onde | Botão |
|---|---|
| Página do cliente | **Criar tarefa** no menu de ações do cliente |
| Fatura | **Criar tarefa** no menu de ações |
| Contador | **Criar tarefa** no menu de ações |
| Reserva | **Criar tarefa** |
| Parcela | **Criar tarefa** |
| Conversa na caixa de entrada | **Criar tarefa** |
| Chamada telefónica | **Criar tarefa** |
| Comentário | O ícone de tarefa junto ao comentário (dica **Criar uma tarefa a partir deste comentário**) |
| Transação bancária | **Criar tarefa** no menu de ações da transação em <UIPath>Administração > Transações bancárias</UIPath> |

## Um lembrete de seguimento num comentário [#een-opvolgherinnering-bij-een-opmerking]

Junto a um comentário há também um pequeno relógio para lembrar a si (ou aos colegas mencionados) de dar seguimento ao comentário. Com ele cria uma tarefa como *Dar seguimento a este comentário* ou *Verificar se [nome] tratou disto*. Se mais tarde marcar o comentário como tratado, essa tarefa de seguimento é concluída automaticamente.

## Tarefas em aberto num item [#openstaande-taken-bij-een-item]

Na página de um cliente, reserva, fatura, parcela e contador há um bloco **Tarefas em aberto** com as tarefas ainda não concluídas associadas a esse item. Se não houver tarefas em aberto, o bloco não aparece.

Na página <UIPath>Clientes > [cliente] > Tarefas</UIPath> estão todas as tarefas do cliente. Abre-a através do separador **Tarefas** na página do cliente. As tarefas concluídas ficam recolhidas em **Tarefas concluídas**, com o número ao lado.

<DocScreenshot src="/screenshots/taken/customer-tasks.png" alt="Separador Tarefas numa página de cliente com Nova tarefa e as tarefas do cliente" />

## No painel [#op-het-dashboard]

O cartão **Tarefas para si** mostra as tarefas que lhe estão atribuídas. Com a estrela escolhe uma vista favorita que quer ver aí em vez delas, veja [Vistas](/taken/weergaven#een-favoriete-weergave-voor-het-dashboard). Também pode criar aí diretamente uma tarefa ou partilhar as tarefas.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- A tarefa fica ligada ao item a partir do qual a criou. Vê-a em **Itens associados** na tarefa.
- Enquanto a tarefa não estiver concluída, fica no bloco **Tarefas em aberto** na página desse item e do cliente associado.
- Uma tarefa de seguimento num comentário é concluída automaticamente quando marca o comentário como tratado.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não vejo Criar tarefa">
Em algumas páginas o botão está no menu de ações, como num cliente, fatura ou contador. Procure aí os três pontos.
</Accordion>
<Accordion title="O bloco Tarefas em aberto não aparece">
O bloco só aparece se ainda houver tarefas por concluir associadas ao item.
</Accordion>
<Accordion title="O Tillor diz Falha ao criar a tarefa">
A tarefa não foi guardada. Preencha um nome e tente de novo.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Detalhes da tarefa" href="/taken/taakdetails" />
  <Card title="Vistas" href="/taken/weergaven" />
</Cards>


# Vistas (/pt-PT/taken/weergaven)

No topo da página **Tarefas** há uma fila de separadores. Cada separador é uma vista. O primeiro separador, **Todas**, é integrado: mostra todas as tarefas e não pode ser editado, movido nem removido. Pode, no entanto, guardar nele filtros e definições da vista para toda a organização. Todas as outras vistas cria-as você.

<DocScreenshot src="/screenshots/taken/tasks-board.png" alt="Separadores com vistas no topo da página de tarefas" />

## Dois tipos de vistas [#twee-soorten-weergaven]

Ao criar, escolhe o tipo de vista em **Conteúdo**.

| Tipo | O que faz |
|---|---|
| **Vista filtrada** | Mostra todas as tarefas que cumprem os filtros, como uma pesquisa guardada. As tarefas novas que se enquadrem aparecem sozinhas |
| **Lista** | Mostra apenas as tarefas que você próprio lhe adiciona |

Uma lista é útil para um conjunto fixo, por exemplo *Preparação da época*. Uma vista filtrada é útil para tudo o que cumpre uma regra, por exemplo *Todas as tarefas urgentes que esperam pelo cliente*.

Pode alterar o tipo mais tarde em **Vista** (canto superior direito), em **Tipo**. Isso não se faz em **Todas**. Se converter uma lista numa vista filtrada, as tarefas que lhe adicionou à mão são desassociadas dela. O Tillor pede primeiro confirmação, porque não pode ser anulado.

## Criar uma vista [#een-weergave-aanmaken]

1. Clique em **Nova vista**, à direita dos separadores
2. Preencha um **Nome** e, se quiser, uma **Descrição**
3. Em **Visibilidade** escolha quem vê a vista: **Pública**, **Só você** ou **Partilhada**. Com **Partilhada** escolhe em **Partilhar com** os colegas e grupos
4. Em **Conteúdo** escolha uma **Vista filtrada** ou uma **Lista**
5. Em **Colunas** escolha como as tarefas são organizadas: **Colunas próprias**, **Estado**, **Atribuído a** ou **Sem agrupamento**
6. Em **Começar com** escolha um filtro inicial: **Todas as tarefas**, **Tarefas abertas** ou **As minhas tarefas**
7. Clique em **Nova vista** no fim da caixa de diálogo

<DocScreenshot src="/screenshots/taken/task-view-create-dialog.png" alt="Caixa de diálogo Nova vista" />

Por predefinição a vista vem em **Pública**, **Vista filtrada**, **Estado** e **Tarefas abertas**. Se escolher **Sem agrupamento**, obtém uma tabela. Com as outras escolhas começa com um quadro. Ajuste isso mais tarde, veja [Tabela, quadro e calendário](/taken/indelingen).

Uma vista filtrada definida como tabela tem este aspeto. Os filtros estão por cima da tabela e aqui já estão guardados.

<DocScreenshot src="/screenshots/taken/task-view-filtered.png" alt="Vista filtrada Tarefas urgentes como tabela, com filtros de prioridade e estado" />

## Quem vê uma vista [#wie-ziet-een-weergave]

| Escolha | Quem vê a vista |
|---|---|
| **Pública** | Todos os utilizadores da organização (uma vista da organização) |
| **Só você** | Só você (uma vista pessoal). No separador aparece um cadeado |
| **Partilhada** | Você e os colegas e grupos que escolher em **Partilhar com**. No separador aparece um ícone de várias pessoas |

Em **Partilhar com** escolhe pessoas e grupos da mesma lista. Um [grupo](/gebruikers/groepen) conta como está composto nesse momento: quem entrar mais tarde no grupo também vê a vista, e quem sair do grupo deixa de a ver.

Só o proprietário de uma vista pessoal pode alterar com quem ela está partilhada ou torná-la visível para todos. Os colegas com quem partilha a vista podem trabalhar nela, mas não decidem quem mais a vê nem a podem eliminar. Se tornar uma vista **Pública**, a lista de pessoas e grupos escolhidos deixa de existir.

<Callout type="warn">
A visibilidade de uma vista também determina quem vê as tarefas nessa vista. Leia [Tarefas privadas](/taken/prive-taken) antes de colocar tarefas numa vista pessoal.
</Callout>

## Editar, duplicar ou eliminar uma vista [#een-weergave-bewerken-dupliceren-of-verwijderen]

Clique com o botão direito do rato no separador da vista e escolha:

- **Editar** - ajuste o nome, a descrição, a visibilidade e as colunas. Os filtros, a ordenação e a disposição ficam como estavam guardados. **Conteúdo** e **Começar com** só escolhe ao criar; o tipo altera-o mais tarde em **Vista**
- **Duplicar** - cria uma cópia com o nome *[nome] (cópia)* e abre-a logo
- **Remover** - após confirmação a vista desaparece. As tarefas em si continuam a existir e só perdem esta vista

Arraste os separadores para ajustar a ordem. A nova ordem é guardada de imediato.

## Guardar ou descartar alterações [#wijzigingen-opslaan-of-verwerpen]

Se ajustar filtros ou definições da vista, estes ficam primeiro só no seu ecrã. Em cima à direita aparece uma barra com **Alterações não guardadas** e dois botões:

- **Guardar vista** guarda as alterações na vista
- **Descartar** repõe tudo na versão guardada

Na vista integrada **Todas** guarda as alterações para todos na sua organização, tal como numa vista pública. Para isso precisa da permissão **Gerir etiquetas e vistas partilhadas**. Sem essa permissão, em **Todas** só pode **Descartar** as alterações.

A barra de pesquisa (**Pesquisar tarefas...**) nunca é guardada com a vista: apenas restringe o que vê agora.

## Uma vista favorita para o painel [#een-favoriete-weergave-voor-het-dashboard]

<DocScreenshot src="/screenshots/taken/dashboard-tasks-card.png" alt="Cartão do painel Tarefas para si com os botões de vista favorita e partilhar" />

No painel, o cartão **Tarefas para si** mostra por predefinição as tarefas que lhe estão atribuídas. Em vez disso pode associar-lhe uma vista:

1. Clique na estrela em cima à direita no cartão
2. Escolha uma vista da lista. Escolha **Tarefas para si** para voltar às suas tarefas atribuídas

Só pode ter uma vista favorita de cada vez, e só vale para si. Se a vista for eliminada mais tarde ou deixar de estar visível para si, o painel volta a mostrar as suas próprias tarefas.

## Seguir uma vista [#een-weergave-volgen]

Com o botão **Seguir**, em cima à direita, recebe todas as manhãs um e-mail com o que pede atenção nessa vista. O funcionamento está em [Notificações](/taken/meldingen#een-weergave-volgen).

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- A nova vista aparece como separador no topo da página de tarefas. Uma vista filtrada mostra logo todas as tarefas que se enquadram, e as tarefas novas que se enquadrem juntam-se sozinhas.
- Com **Pública**, todos os utilizadores da sua organização veem a vista. Com **Só você**, só você a vê, e com **Partilhada**, você e os colegas e grupos escolhidos.
- Se eliminar uma vista, as tarefas continuam a existir. Só perdem essa vista.
- Se converter uma lista numa vista filtrada, as tarefas que lhe adicionou à mão são desassociadas.
- Uma vista que segue envia-lhe um resumo todas as manhãs. Veja [Notificações](/taken/meldingen#een-weergave-volgen).

## Problemas? [#problemen]

<Accordions>
<Accordion title="O Tillor diz que a vista não pôde ser criada">
Vê **Não foi possível criar a vista**. Verifique se preencheu um **Nome** e tente de novo. Se ainda não resultar, veja se a sua ligação à internet está boa. Ao duplicar, a mensagem é **Não foi possível duplicar a vista** e aplica-se o mesmo.
</Accordion>
<Accordion title="Não consigo editar nem eliminar o separador Todas">
**Todas** é integrada e mostra todas as tarefas que pode ver. O nome, a posição e a visibilidade são fixos. Pode, no entanto, guardar nela filtros e definições da vista, para toda a organização. Crie uma vista própria se quiser uma seleção só para si.
</Accordion>
<Accordion title="Um colega não consegue tornar a vista pública nem eliminá-la">
Só o proprietário de uma vista pessoal decide com quem ela está partilhada e pode torná-la pública ou eliminá-la. Os colegas com quem a partilha podem, ainda assim, editar tarefas nela.
</Accordion>
<Accordion title="Vejo a barra Alterações não guardadas">
Ajustou filtros ou definições da vista, e estes ainda estão só no seu ecrã. Escolha **Guardar vista** para os guardar ou **Descartar** para voltar atrás. Em **Todas** precisa para isso da permissão **Gerir etiquetas e vistas partilhadas**; sem essa permissão só pode descartar aí.
</Accordion>
<Accordion title="Uma tarefa não está na minha lista">
Uma lista só mostra tarefas que você próprio lhe adiciona. Se quiser que tudo o que cumpre uma regra entre sozinho, escolha em **Tipo** uma vista filtrada.
</Accordion>
<Accordion title="A ordem dos separadores não é guardada">
Nesse caso o Tillor mostra **Não foi possível reordenar as vistas**. Arraste os separadores de novo.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Tabela, quadro e calendário" href="/taken/indelingen" />
  <Card title="Filtrar" href="/taken/filteren" />
  <Card title="Tarefas privadas" href="/taken/prive-taken" />
</Cards>


# Parcelas (/pt-PT/terreinen)

Uma parcela é um local do seu parque: um lote, chalé, lugar de autocaravana ou lugar fixo. Aqui cria as suas parcelas, dá-lhes um tipo e uma tarifa e associa-lhes contadores. Depois coloca clientes nelas com uma [ocupação](/bezettingen) ou uma [reserva](/reserveringen). Encontra-as em <UIPath>Parque > Terrenos</UIPath>.

<DocScreenshot src="/screenshots/park/terrains-list.png" alt="Visão geral das parcelas com a parcela de demonstração 12" />

## Como se relaciona tudo? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  T[Parcela] --> M[Contadores]
  T --> Tar[Tarifa calculada]
  K[Cliente] -->|ocupação| T
  Tar --> F[Faturas]
  M --> V[Consumo do cliente]
  V --> F
```

A uma parcela fica associado tudo o que pertence a esse local. A tarifa resulta da área e dos campos personalizados da parcela. Os contadores da parcela fornecem o consumo, e esse consumo vai para o cliente com uma ocupação ativa. Veja também [Gestão de contadores](/meterbeheer#hoe-hangt-dit-samen).

<Callout type="info" title="Bom saber">
- O nome é obrigatório e pode ter no máximo 255 caracteres.
- **Reservável** vem desativado por predefinição numa parcela nova.
- A área é calculada pelo Tillor assim que desenha a parcela no mapa. Não a escreve você.
- **Parcelas recentes** conta as parcelas dos últimos 7 dias.
- Uma parcela tem no máximo uma ocupação ativa de cada vez.
- A tarifa calculada é recalculada quando guarda uma parcela, e para todas as parcelas quando guarda a fórmula da tarifa.
- Se eliminar um tipo de parcela, as parcelas continuam a existir, mas ficam sem tipo.
</Callout>

## Criar uma nova parcela [#een-nieuw-terrein-aanmaken]

Antes de começar: se precisar de tipos de parcela (como **Lugar** ou **Chalet**) ou de campos personalizados, crie-os primeiro. Veja [Tipos de parcela](#terreintypes) e [Campos personalizados](/eigen-velden).

<Steps>
<Step>
### Clique em Criar novo terreno [#klik-op-nieuw-terrein-aanmaken]
Encontra o botão em cima à direita em <UIPath>Parque > Terrenos</UIPath>.

<DocScreenshot src="/screenshots/park/terrain-create-dialog.png" alt="Caixa de diálogo Criar parcela" />
</Step>
<Step>
### Preencha os dados [#vul-de-gegevens-in]
Só o **Nome** é obrigatório. Além disso pode preencher:

- **Descrição**, uma explicação.
- **Tipo de parcela**, ou deixe **Sem tipo**.
- **Campos personalizados** que a sua organização adicionou, como um suplemento ou um número de contador de gás.
- **Reservável**, se os clientes puderem reservar a parcela online.
- **Localização**, para indicar logo a parcela no mapa.
</Step>
<Step>
### Clique em Criar parcela [#klik-op-terrein-aanmaken]
A parcela fica na lista. Se não desenhou a localização, faça-o mais tarde na planta, veja [Mapa](/kaart#terreingrenzen-intekenen).
</Step>
</Steps>

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- A parcela aparece na lista e nas estatísticas no topo: **Total de parcelas**, **Parcelas recentes**, **Parcelas reserváveis**, **Parcelas não reserváveis** e **Área total** (apenas de parcelas com localização desenhada).
- O Tillor calcula a **Tarifa calculada** a partir da fórmula de tarifa da sua organização.
- Na página de detalhes pode associar contadores, adicionar comentários e ver o histórico.

## Ver e editar uma parcela [#een-terrein-bekijken-en-bewerken]

Clique numa parcela na lista. No topo estão o nome, a descrição, a área, o número de contadores, se é reservável, o **Cliente** com uma ocupação ativa e as datas de criação e de alteração. No formulário **Atualizar parcela** ajusta:

- **Nome**, **Tipo de parcela**, **Descrição**, **Reservável** e os **Campos personalizados**.
- **Área** e **Tarifa calculada** são só de leitura.

Guarde com **Atualizar parcela**. Ao lado do formulário estão **Localização**, **Contadores** e **Histórico de ocupação**. Por baixo estão **Comentários** (visíveis apenas para os seus colegas), **Eventos** com uma visão antes/depois por campo alterado, e **Reservas**.

<DocScreenshot src="/screenshots/park/terrain-detail.png" alt="Detalhe da parcela com contadores associados" />

## Associar contadores a uma parcela [#meters-aan-een-terrein-hangen]

No cartão **Contadores** escolha **Adicionar contador** e depois **Atribuir contador**. Só os contadores sem parcela aparecem na lista. Por contador vê o tipo, um indicador de estado e a última leitura. Com o menu (...) escolhe **Desassociar da parcela**; essa opção só existe aqui. O percurso completo até ao cliente está em [Associar um contador a um cliente](/meterbeheer/meter-koppelen).

## Tipos de parcela [#terreintypes]

Com os tipos de parcela organiza as parcelas, por exemplo **Lugar**, **Chalet** ou **Lugar de autocaravana**. O tipo vê-o na lista de parcelas (coluna **Tipo**, com um filtro), pode colorir o mapa por ele e aparece na exportação. Gere-os em <UIPath>Apoio > Definições > Tipos de parcela</UIPath>.

<Requires permission="Editar definições" />

<DocScreenshot src="/screenshots/instellingen/settings-terrain-types.png" alt="Definições > Tipos de parcela" />

A tabela **Todos os tipos de parcela** mostra por tipo o **Nome**, a **Cor do mapa**, a **Descrição** e o número de **Parcelas**. Procure com **Pesquisar tipos de parcela...**. Com o lápis edita um tipo, com o caixote do lixo elimina-o.

<Steps>
<Step>
### Clique em Novo tipo de parcela [#klik-op-nieuw-terreintype]
</Step>
<Step>
### Preencha os dados [#vul-de-gegevens-in-1]
Indique um **Nome**, se quiser uma **Descrição**, e escolha uma **Cor do mapa**. O azul vem selecionado de início.
</Step>
<Step>
### Clique em Criar [#klik-op-aanmaken]
</Step>
</Steps>

<DocScreenshot src="/screenshots/instellingen/terrain-type-create-dialog.png" alt="Caixa de diálogo Criar tipo de parcela" />

Um tipo associa-se a uma parcela através do campo **Tipo de parcela**. A cor do mapa vê-a na planta quando, em **Camadas**, define as cores para **Tipo de parcela**, veja [Mapa](/kaart#lagen-en-kleuren).

## Exportar parcelas [#terreinen-exporteren]

Clique em **Exportar todas as parcelas** (em cima à direita) para descarregar um ficheiro Excel. Contém por parcela os dados de base, o tipo de parcela, os campos personalizados e o cálculo da tarifa (subtotal, suplementos e total). Use-o, por exemplo, para a verificação anual das tarifas.

## Como se chega à tarifa [#hoe-het-tarief-tot-stand-komt]

A **Tarifa calculada** resulta da fórmula de tarifa da sua organização. A fórmula calcula com a área e com os campos personalizados da parcela. Quais são esses campos, decide você. A fórmula predefinida usa os campos com as chaves `locationSurcharge`, `gasMeterNumber`, `electricityMeterSurcharge` e `staticPrice`. Se os criou em <UIPath>Apoio > Definições > Campos personalizados</UIPath>, funcionam assim:

1. **Área**: a área desenhada, em escalões por m².
2. **Suplemento de contador de gás**: acresce se o campo com o número do contador de gás estiver preenchido.
3. **Suplemento de localização**: o valor que indicar.
4. **Suplemento de eletricidade**: o valor que indicar.
5. **Preço fixo**: se este campo estiver preenchido, esse valor substitui a tarifa calculada e o Tillor ignora a fórmula.

Se quiser alterar a tarifa de um ano, ajuste os campos personalizados, veja em **Tarifa calculada** se está correta e guarde com **Atualizar parcela**.

### Fórmula da tarifa [#tariefformule]

<Requires permission="Editar a fórmula da tarifa do lote" />

Em <UIPath>Definições > Tarifa do lote</UIPath> define você como a tarifa é calculada. Quem já podia editar as definições recebeu a permissão **Editar a fórmula da tarifa do lote**. A fórmula é um pedaço de TypeScript (uma linguagem de programação) que devolve a tarifa anual em euros, ou partes com nome que juntas formam a tarifa, como `Subtotaal` e `Toeslag gasmeter`. Cada parte recebe uma coluna própria na exportação.

- Os campos da parcela lê-os com `{terrain.veld}`, como `{terrain.surfaceArea}` ou `{terrain.customFields.locationSurcharge}`. Com o botão **Variável** ou escrevendo `{` escolhe entre todos os campos, incluindo os seus.
- À direita da fórmula experimenta-a logo numa das suas parcelas. Um erro aparece aí com o número da linha. Uma fórmula que não funciona não se pode guardar.
- Com **Repor a predefinida** volta à fórmula com que todas as organizações começaram.
- Nas automações lê a tarifa como `{terrain.calculatedTariff.total}`.

<Callout type="warn" title="Atenção">
A fórmula corre isolada: só pode calcular com os campos da parcela, sem outros dados nem internet. Uma fórmula que demora demasiado é interrompida e não produz tarifa.
</Callout>

## Problemas? [#problemen]

<Accordions>
<Accordion title="O Tillor diz Parcela não criada">
A parcela não foi guardada. Verifique se o **Nome** está preenchido e não tem mais de 255 caracteres, e tente de novo.
</Accordion>
<Accordion title="A área está vazia ou a 0">
A área vem apenas da localização no mapa. Desenhe a parcela em <UIPath>Parque > Mapa</UIPath>, veja [Mapa](/kaart#terreingrenzen-intekenen). As parcelas sem localização não contam para a **Área total**.
</Accordion>
<Accordion title="A Tarifa calculada não está certa">
Verifique os campos personalizados da parcela (suplementos e número do contador de gás). Se houver um **Preço fixo** preenchido, este substitui a tarifa calculada. Se a fórmula foi alterada, veja em Tarifa do lote se o teste nesta parcela está certo.
</Accordion>
<Accordion title="Não vejo Tarifa do lote nas definições">
Precisa da permissão **Editar a fórmula da tarifa do lote**. Peça-a ao seu administrador.
</Accordion>
<Accordion title="O contador não está na lista em Adicionar contador">
Esse contador já está associado a outra parcela. Desassocie-o primeiro de lá.
</Accordion>
<Accordion title="Não consigo criar uma ocupação nesta parcela">
Uma parcela com uma ocupação ativa não está na lista de escolha. Termine primeiro a ocupação em curso.
</Accordion>
</Accordions>

## Conceitos [#begrippen]

- **Parcela**: um local do seu parque. Veja [Conceitos](/begrippen#terrein).
- **Tipo de parcela**: uma classificação como **Lugar** ou **Chalet**, com uma cor do mapa.
- **Reservável**: os clientes podem reservar a parcela online.
- **Tarifa calculada**: a tarifa que o Tillor calcula a partir da fórmula.
- **Campo personalizado**: um campo que a sua organização adiciona. Veja [Conceitos](/begrippen#eigen-veld).
- **Ocupação**: um cliente numa parcela durante um período. Veja [Conceitos](/begrippen#bezetting).

## Ver também [#zie-ook]

<Cards>
  <Card title="Gestão de contadores" href="/meterbeheer" description="Associar contadores a parcelas e faturar o consumo" />
  <Card title="Ocupações" href="/bezettingen" description="Colocar clientes numa parcela" />
  <Card title="Mapa" href="/kaart" description="Desenhar os limites das parcelas" />
</Cards>


# Controlo de acesso (/pt-PT/toegangscontrole)

Com o Controlo de acesso define quem pode entrar no seu parque e acompanha quem está lá dentro. Atribui a um cliente um método de acesso (matrícula, tag NFC, código QR ou PIN), comanda cancelas a partir do seu ecrã e consulta quem passou, quando e por que ponto de acesso. Um método de acesso cria-se no perfil do cliente, veja [adicionar um método de acesso](#een-toegangsmethode-toevoegen).

<DocScreenshot src="/screenshots/toegangscontrole/stats-overview.png" alt="Controlo de acesso com estatísticas no topo" />

Os números no topo contam todos os acessos, as últimas 24 horas, as tentativas permitidas e bloqueadas e os seus pontos de acesso ativos. Por baixo estão as ações rápidas, os veículos no parque, o registo de acessos e as operações do controlador.

<Callout type="info" title="Bom saber">
- Um veículo passa a **Fantasma** se não for visto num ponto de acesso durante 7 dias enquanto constava como **Dentro**.
- Um método de acesso QR cria-se de uma só vez até 100 unidades, cada uma com o seu próprio código.
- Um PIN tem de 4 a 8 dígitos e tem de ser único na sua organização.
- Cada matrícula, cada tag NFC e cada código QR só pode existir uma vez na sua organização.
- Um método de acesso que não esteja dentro do período **Data de início** e **Data de fim** não dá acesso.
- Uma matrícula com o estado **Bloqueio suave** só está bloqueada durante o horário de funcionamento da receção.
- Por predefinição, uma matrícula expirada ainda pode sair durante 2 dias fora do horário de funcionamento (no máximo 30). Veja [Definições de controlo de acesso](/gebruikers/instellingen-toegangscontrole).
- Um veículo aparece no perfil do cliente através de uma matrícula registada, ou através da tag NFC ou do código QR com que o cliente entrou.
</Callout>

## Como é que isto se relaciona? [#hoe-hangt-dit-samen]

Um método de acesso é a chave de um cliente. O ponto de acesso (a cancela ou o portão) é a porta. Entre os dois há equipamento no seu parque: uma câmara que lê matrículas ou uma caixa que lê tags e códigos QR (um controlador de acesso), e o [conector](/connector). O conector é a caixa que liga o Tillor aos dispositivos do seu parque.

```mermaid
flowchart TD
  K[Cliente] --> M[Método de acesso<br/>matrícula, tag NFC, código QR ou PIN]
  M -->|O Tillor envia a lista| C[Conector no seu parque]
  C --> L[Câmara ou leitor de cartões<br/>na entrada]
  L -->|permitido| P[O ponto de acesso abre]
  L -->|recusado| W[O ponto de acesso fica fechado]
  L -->|cada tentativa é comunicada| LOG[Registo de acessos no Tillor]
```

O que isto significa para si:

- Se alterar ou eliminar um método de acesso no Tillor, o Tillor envia isso ao equipamento através do conector. O resultado vê-o em **Operações do controlador**.
- Se o conector estiver offline, os métodos de acesso novos ou alterados ficam em **Pendente** até voltar a estar ligado.
- Também uma cancela que abre a partir do Tillor recebe, normalmente, a ordem através do conector. Se estiver offline, a cancela não abre.

A secção Controladores no menu principal trata de outra coisa: os pequenos ecrãs com leitor de tags junto a duches, portas e pontos de carregamento. Veja [Controladores](/controllers). O equipamento das cancelas é instalado pelo suporte do Tillor durante o arranque.

## Comandar pontos de acesso [#toegangspunten-bedienen]

Em **Ações rápidas** há um botão para cada ponto de acesso ativo. Só vê este bloco se estiver configurado pelo menos um ponto de acesso ou controlador de acesso.

<DocScreenshot src="/screenshots/toegangscontrole/quick-actions.png" alt="Ações rápidas com pontos de acesso e botões de gestão" />

<Steps>
<Step>
### Clique no botão do ponto de acesso [#klik-op-de-knop-van-het-toegangspunt]
O texto é **Abrir [nome]**.
</Step>
<Step>
### Confirme [#bevestig]
Abre-se uma caixa de diálogo a perguntar se tem a certeza de que quer abrir o ponto de acesso. Clique em **Sim, abrir [nome]**.

<DocScreenshot src="/screenshots/toegangscontrole/barrier-confirm-dialog.png" alt="Confirmação para abrir um ponto de acesso" />
</Step>
</Steps>

O Tillor indica **Ponto de acesso aberto**. Só é possível fechar se o ponto de acesso o suportar. Nesse caso há uma seta para baixo ao lado do botão de abrir: escolha aí **Fechar [nome]** e confirme com **Sim, fechar [nome]**.

### Botões de gestão em Ações rápidas [#beheerknoppen-in-snelle-acties]

Ao lado dos pontos de acesso há, consoante o seu equipamento, botões de manutenção. Use-os apenas quando algo não estiver certo.

| Botão | O que faz | Quando |
|---|---|---|
| **Repor a APB** | Apaga a memória de quem entrou ou saiu por último, por tipo: **Para passes NFC…** ou **Para códigos QR…**. | As pessoas já não passam porque o portão pensa que já estão dentro (ou fora). APB significa anti-passback. |
| **Sincronizar registos do dispositivo** | Faz com que o conector obtenha todas as linhas novas dos controladores de acesso. | Faltam passagens recentes no registo de acessos. |
| **Repor a cache do conector** | O conector apaga os seus dados locais e volta a obter tudo do Tillor. | O equipamento comporta-se de forma diferente dos métodos de acesso no Tillor. |
| **Limpar leituras LPR lixo** | Remove apenas linhas fantasma seguras da lista de matrículas. As matrículas registadas e associadas mantêm-se. | Há matrículas na lista que não pertencem a nada. |

## Gerir métodos de acesso através do perfil do cliente [#toegangsmethoden-beheren-via-het-klantprofiel]

Os métodos de acesso adicionam-se, alteram-se e eliminam-se no perfil do cliente.

### Adicionar um método de acesso [#een-toegangsmethode-toevoegen]

Um método de acesso pertence a um cliente e dá a esse cliente acesso ao parque. Gere-os no perfil do cliente.

Antes de começar:

- O cliente existe no Tillor.
- Para NFC precisa de uma tag que ainda não pertença a ninguém. Se não houver nenhuma tag livre, a lista indica **Nenhum cartão NFC disponível encontrado; todos os cartões já estão atribuídos.**
- O tipo **Código PIN** só aparece na lista se estiver ativado para a sua organização.

<Steps>
<Step>
### Abra o separador Controlo de acesso [#open-het-tabblad-toegangscontrole]
Aceda a <UIPath>Clientes > cliente > Controlo de acesso</UIPath>. No topo está a tabela **Métodos de acesso** (marca **1** na captura de ecrã abaixo).

<DocScreenshot src="/screenshots/klanten/customer-access-control.png" alt="Perfil do cliente Controlo de acesso com a tabela Métodos de acesso e a matrícula 1-DOC-2026" />
</Step>
<Step>
### Clique em Adicionar e escolha o tipo [#klik-op-toevoegen-en-kies-het-type]
<DocScreenshot src="/screenshots/toegangscontrole/access-method-create-dialog.png" alt="Caixa de diálogo para um novo método de acesso" />

Depois não pode alterar o tipo. Se precisar de outro tipo, adicione um novo método de acesso.
</Step>
<Step>
### Preencha os dados [#vul-de-gegevens-in]
O que preenche depende do tipo:
</Step>
</Steps>

<Tabs items={["Matrícula", "NFC", "Código QR", "Código PIN"]}>
<Tab value="Matrícula">
Preencha a matrícula em **Matrícula**. O Tillor converte-a para maiúsculas. A marca, o modelo e a cor são opcionais.
</Tab>
<Tab value="NFC">
Em **Cartões NFC**, escolha uma tag livre da lista. Pode pesquisar pelo número da tag.
</Tab>
<Tab value="Código QR">
O código é criado pelo próprio Tillor. Com **Quantidade** cria até 100 métodos de acesso QR separados de uma só vez, cada um com o seu próprio código. Marque **Imprimir talão térmico imediatamente** para enviar cada novo QR logo como bilhete de entrada para a impressora térmica. O endereço da impressora define-o nas definições da organização. No bilhete constam **Válido de** e **Válido até** no fuso horário da sua organização.
</Tab>
<Tab value="Código PIN">
Preencha de 4 a 8 dígitos, ou clique em **Gerar**. O PIN tem de ser único na sua organização. Num PIN não existe a ação **Sincronizar com o sistema de pontos de acesso**.
</Tab>
</Tabs>

Para qualquer tipo pode ainda preencher:

| Campo | Significado |
|---|---|
| **Data de início**, **Data de fim** | O período em que o método de acesso funciona. Vazio significa sem limite. |
| **Estado** | **Ativo**, **Inativo**, **Bloqueado** ou **Bloqueio suave** (veja [estados](#statussen-van-toegangsmethoden)). |
| **Converter automaticamente em matrícula** | Apenas em código QR e PIN. Se alguém usar o código num portão com câmara, o Tillor substitui o código pela matrícula lida. Está desativado por predefinição. |
| **Não prolongar automaticamente** | A data de fim mantém-se inalterada quando é paga uma fatura com renovação automática. |
| **Notas** | Notas internas. |

Clique depois em **Adicionar** para guardar.

#### O que acontece depois? [#wat-gebeurt-er-daarna]

- O método de acesso fica na tabela e o Tillor envia-o ao equipamento através do conector. Acompanha isso em **Operações do controlador**, com o estado <Status tone="info">Pendente</Status>, <Status tone="warning">A processar</Status>, <Status tone="success">Concluído</Status> ou <Status tone="error">Falhou</Status>.
- Um método de acesso alterado ou eliminado é comunicado da mesma forma.
- Cada tentativa de entrada aparece no registo de acessos, incluindo as recusadas.
- Um veículo é associado ao cliente através de uma matrícula registada, ou porque o cliente entrou com uma tag NFC ou um código QR enquanto a câmara lia também a matrícula. Isto último funciona mesmo que a matrícula não esteja registada.

#### Editar, enviar ou eliminar um método de acesso [#een-toegangsmethode-bewerken-versturen-of-verwijderen]

Clique nos três pontos à direita do método de acesso.

<DocScreenshot src="/screenshots/toegangscontrole/access-method-actions-menu.png" alt="Menu de ações de um método de acesso" />

| Ação | Para quê |
|---|---|
| **Editar** | Ajustar o período, o estado ou os dados do veículo. |
| **Sincronizar com o sistema de pontos de acesso** | Voltar a enviar ao equipamento. O Tillor indica **Sincronização pedida**. Não num PIN. |
| **Enviar notificação** | Envia ao cliente a ligação pessoal do QR por e-mail, SMS ou WhatsApp (caixa de diálogo **Enviar código QR**). |
| **Copiar URL pessoal** | Copia a ligação para o passe do cliente, veja [Carteira digital](#digitale-wallet-qr-code). |
| **Descarregar código QR**, **Imprimir talão térmico** | Apenas num código QR. |
| **Eliminar** | Remove o método de acesso. Não pode ser anulado. Com as caixas de seleção na tabela elimina vários de uma só vez. |

#### Estados dos métodos de acesso [#statussen-van-toegangsmethoden]

| Estado | Significado |
|---|---|
| <Status tone="success">Ativo</Status> | Dá acesso, desde que o período esteja certo. |
| <Status>Inativo</Status> | Não dá acesso. Funciona como Bloqueado, com um nome mais claro. |
| <Status tone="error">Bloqueado</Status> | Não dá acesso. |
| <Status tone="warning">Bloqueio suave</Status> | Numa matrícula, só está bloqueada durante o horário de funcionamento da receção. Fora desse horário, o veículo ainda pode entrar e sair. |

## Carteira digital (código QR) [#digitale-wallet-qr-code]

Num método de acesso QR, copia uma ligação pessoal para o hóspede. Abre a página **Passe de acesso** com o código QR. Se a Apple Wallet ou a Google Wallet estiverem configuradas para o seu ambiente, aparecem também botões para guardar o passe.

<Steps>
<Step>
### Copie a ligação [#kopieer-de-link]
Abra os três pontos no método de acesso QR e clique em **Copiar URL pessoal**. O Tillor indica **Ligação copiada**.

<DocScreenshot src="/screenshots/toegangscontrole/access-method-personal-url-menu.png" alt="Menu de ações de um método de acesso QR com Copiar URL pessoal" />
</Step>
<Step>
### Envie a ligação ao hóspede [#stuur-de-link-naar-de-gast]
O hóspede vê o código QR, a validade e, se disponíveis, **Adicionar à Apple Wallet** e **Adicionar à Google Wallet**.

<DocScreenshot src="/screenshots/toegangscontrole/access-method-public-view-wallet.png" alt="Página do hóspede Passe de acesso com código QR e botões da carteira" />
</Step>
</Steps>

O passe da carteira usa o mesmo código QR, validade e estado que no Tillor. Num iPhone com iOS 27, o passe aparece como Poster Generic, opcionalmente com um fundo próprio e um código QR quadrado. Os iPhones mais antigos mostram o formato clássico. No iOS 27 há também atalhos no passe: **Itinerário** abre o Apple Maps para a localização do ponto de acesso (ou o centro do mapa do parque) e, se tiver indicado um site nos dados da sua empresa, surge um botão para esse site. O fundo e a localização definem-se em **Definições**, veja [Organização](/gebruikers/organisaties). Num iPhone, o passe pode aparecer no ecrã de bloqueio quando o hóspede está por perto. No Android, o hóspede guarda o passe na Google Wallet.

### Ver onde o passe está guardado [#zien-waar-de-pas-is-opgeslagen]

Se um hóspede tiver adicionado o passe, aparece ao lado do valor QR um pequeno ícone de carteira, com um número se houver mais do que um dispositivo. Passe o rato por cima para ver:

- se o passe está na **Apple Wallet no iPhone** ou na **Google Wallet no Android**, e em quantos dispositivos
- quando o passe foi **Último adicionado** e **Passe atualizado**, na Apple também **Última sincronização**
- se o passe foi **Emitido via** um **Colaborador** ou uma **Link pessoal**

A Google não comunica quando um hóspede remove o passe. Na Google Wallet, o passe continua, portanto, como guardado.

### Reenviar um passe da carteira [#een-wallet-pas-opnieuw-versturen]

Se um passe QR for alterado, por exemplo a validade, o Tillor envia a atualização às carteiras automaticamente. Se mesmo assim aparecer uma versão antiga, escolha **Sincronizar passe Wallet** no menu. O Tillor indica quantos dispositivos receberam a atualização. Se o passe ainda não estiver registado em lado nenhum, vê **Ainda nenhum dispositivo registado para atualizações.** O item de menu só aparece depois de o passe ter sido adicionado a uma carteira.

## Veículos no parque [#voertuigen-in-het-park]

A tabela **Veículos no parque** regista, por matrícula, se um veículo está dentro. Uma leitura numa entrada coloca o veículo em **Dentro**, uma leitura numa saída em **Saiu**.

Cada linha mostra a matrícula, o estado, o cliente, o momento de entrada, o último momento em que o veículo foi visto num ponto de acesso e esse ponto de acesso. Por predefinição, a tabela mostra os veículos que estão **Dentro** ou são **Fantasma**. Com os filtros mostra também veículos que saíram, filtra por ponto de acesso ou pesquisa por matrícula ou nome do cliente.

| Estado | Significado |
|---|---|
| <Status tone="success">Dentro</Status> | Entrou por uma entrada e ainda não saiu. |
| <Status tone="warning">Fantasma</Status> | Estava em Dentro, mas há 7 dias que não é visto num ponto de acesso. |
| <Status>Saiu</Status> | Saiu por uma saída. |

Um veículo fantasma surge normalmente porque a câmara não leu a matrícula à saída, ou leu-a mal à entrada. Se a matrícula voltar a ser vista numa entrada, passa de novo a **Dentro**.

### Ocupação do parque [#parkbezetting]

O cartão **Ocupação do parque** mostra quantos veículos estão dentro: **Atualmente dentro**, o **Pico** no período escolhido e o número de **Entradas** e **Saídas**. O primeiro gráfico mostra a evolução, por hora até uma semana e por dia num período mais longo. **Horas populares** mostra, por hora do dia, a média de veículos e de chegadas. Assim vê, por exemplo, quando há movimento suficiente para abrir a restauração. Com o seletor de período no canto superior direito escolhe hoje, 7 dias, 30 dias, 90 dias, tudo ou um intervalo próprio.

## Registo de acessos [#toegangslogboek]

O registo de acessos mostra cada tentativa de entrada, com data, método de acesso, cliente (se conhecido), ponto de acesso e estado.

<DocScreenshot src="/screenshots/toegangscontrole/access-log.png" alt="Registo de acessos com matrículas, cliente e estado" />

Filtre e pesquise por matrícula ou valor (em NFC também por etiqueta do cartão), intervalo de datas, estado, tipo de método de acesso, ponto de acesso ou cliente. Com **Exportar**, à direita na barra de ferramentas, descarrega o registo como ficheiro Excel.

| Estado | Significado |
|---|---|
| Permitido | O acesso foi concedido. |
| Bloqueado | O acesso foi recusado. |
| Inativo | O método de acesso está inativo. |
| Expirado | O método de acesso expirou. |
| Inválido | O método de acesso é inválido. |
| Recusado | O acesso foi ativamente recusado. |
| Bloqueio suave | O acesso está em bloqueio suave. |
| Erro do dispositivo | Houve um problema com o dispositivo. |
| Sem carro | Não foi detetado nenhum carro. |
| APB - Direção incorreta | O portão bloqueia a passagem porque a direção não está certa (anti-passback). |
| Desconhecido | Não foi possível determinar o estado. |
| Mensagem do sistema | Uma mensagem do próprio sistema. |

## Histórico de estado do ponto de acesso [#hekstatusgeschiedenis]

Por baixo do registo de acessos está também o **Histórico de estado do ponto de acesso**: quando um ponto de acesso esteve **Aberto**, **Fechado** ou **Em movimento**, com a **Origem** da comunicação. Se a posição não for conhecida, aparece **Desconhecido**. Filtre por estado ou ponto de acesso. Se a lista estiver vazia, ainda não foram recebidas comunicações de posição.

## Operações do controlador [#controller-operaties]

Por baixo estão as **Operações do controlador**. São as ordens que o Tillor envia aos controladores de acesso, como **Criar**, **Atualizar**, **Eliminar** e **Sincronizar**. Assim vê quando um passe ou código QR chegou ao ponto de acesso.

<DocScreenshot src="/screenshots/toegangscontrole/controller-operations.png" alt="Operações do controlador com ordens e o seu estado" />

Uma ordem está em <Status tone="info">Pendente</Status>, <Status tone="warning">A processar</Status>, <Status tone="success">Concluído</Status> ou <Status tone="error">Falhou</Status>. Com o ícone do olho, à direita na linha, abre os detalhes.

## Problemas? [#problemen]

<Accordions>
<Accordion title="O bloco Ações rápidas não aparece">
O bloco só aparece se estiver configurado um ponto de acesso ou controlador de acesso. Se não houver nada, o suporte do Tillor ainda não associou o equipamento.
</Accordion>
<Accordion title="O Tillor diz: Falha ao abrir o ponto de acesso">
O ponto de acesso não respondeu. Normalmente o conector está offline ou o aparelho está inacessível. Verifique o conector, veja [Conector não ligado](/connector#problemen), e tente novamente.
</Accordion>
<Accordion title="O Tillor diz: Este valor de credencial já está em utilização">
Cada matrícula, cada tag NFC e cada código QR só pode existir uma vez na sua organização. No caso de uma matrícula, o Tillor indica a que cliente já pertence. Elimine ou altere primeiro esse método de acesso.
</Accordion>
<Accordion title="Um cliente não entra com uma matrícula válida">
Veja no registo de acessos que estado teve a tentativa. **Expirado** ou **Inativo**: verifique a **Data de início**, a **Data de fim** e o **Estado** do método de acesso. **Bloqueio suave**: a matrícula está bloqueada durante o horário de funcionamento da receção. **Erro do dispositivo** ou **Sem carro**: a câmara não leu nada, verifique o equipamento. Se o método de acesso estiver certo mas o portão continuar a recusar, veja em **Operações do controlador** se a última alteração está **Concluído**.
</Accordion>
<Accordion title="Um novo método de acesso ainda não funciona no portão">
Veja em **Operações do controlador** se a ordem está <Status tone="success">Concluído</Status>. Se estiver em **Pendente**, o conector provavelmente está offline. Se estiver em **Falhou**, escolha **Sincronizar com o sistema de pontos de acesso** no método de acesso.
</Accordion>
<Accordion title="As pessoas são recusadas com APB - Direção incorreta">
O portão pensa que já estão dentro (ou fora). Clique em **Repor a APB** em Ações rápidas e escolha **Para passes NFC…** ou **Para códigos QR…**. Confirme com **Repor**.
</Accordion>
<Accordion title="A lista de tags NFC está vazia">
Só aparecem na lista as tags que ainda não pertencem a ninguém. Remova primeiro uma tag do outro cliente, veja [Gerir tags](/nfc/nfc-tags#wat-kun-je-met-een-tag-doen).
</Accordion>
<Accordion title="Um veículo aparece como Fantasma">
O veículo não é visto há 7 dias. Normalmente já saiu sem que a câmara o visse. Volta a ficar **Dentro** assim que a matrícula for lida de novo numa entrada.
</Accordion>
</Accordions>

## Conceitos [#begrippen]

- **Método de acesso**: a chave de um cliente, uma matrícula, tag NFC, código QR ou PIN.
- **Ponto de acesso**: a cancela, portão ou porta que abre.
- **Controlador de acesso**: a caixa junto ao ponto de acesso que lê tags e códigos QR.
- **Conector**: a caixa no seu parque que liga o Tillor ao equipamento. Veja [Conector](/connector).
- **APB (anti-passback)**: a regra de que não se pode passar duas vezes no mesmo sentido por um portão.
- **Fantasma**: um veículo que consta como dentro mas não é visto há 7 dias.

Mais explicações na [lista de conceitos](/begrippen).

## Ver também [#zie-ook]

<Cards>
  <Card title="Conector" href="/connector" description="A caixa que liga o Tillor ao seu equipamento" />
  <Card title="NFC" href="/nfc" description="Associar tags e gerir saldo" />
  <Card title="Definições de controlo de acesso" href="/gebruikers/instellingen-toegangscontrole" description="Tolerância para matrículas expiradas" />
  <Card title="Gestão de clientes" href="/klantenbeheer" />
</Cards>


# Meteorologia (/pt-PT/weer)

Na página **Meteorologia** vê, por dia, o estado do tempo no local do seu parque, para poder comparar um pico de consumo ou de movimento com a meteorologia. O Tillor também usa estes dados nos contadores e nas reservas.

<Callout type="info" title="Bom saber">
- A meteorologia depende do centro do mapa da sua organização. Se esse centro estiver errado, a meteorologia também estará.
- O Tillor obtém a meteorologia todas as noites e preenche os dias em falta no passado.
- Por predefinição vê os últimos 14 dias.
- Um dia com **Arquivado** é definitivo. Um dia com **Previsão** ainda pode mudar.
</Callout>

## Abrir a página [#de-pagina-openen]

Aceda a <UIPath>Parque > Meteorologia</UIPath>.

<DocScreenshot src="/screenshots/weer/weather-overview.png" alt="Parque > Meteorologia com a previsão diária" />

Em **Previsão diária** aparece o local, por exemplo **Centro do mapa: 50.8503, 4.3517**. É o centro do mapa do seu parque. Define-o em <UIPath>Definições > Mapa</UIPath>. Se o mudar, a meteorologia passa a seguir esse novo local. Veja [Mapa](/kaart).

Vê:

- um cartão grande para o dia mais recente, com a temperatura, a condição, as temperaturas máxima e mínima e a quantidade de chuva. Ao lado do dia aparece **Arquivado** para um dia que já é definitivo, ou **Previsão** para um dia que ainda pode ser atualizado
- por baixo, um cartão por dia, com a condição, como **Limpo**, **Parcialmente nublado**, **Encoberto**, **Nevoeiro**, **Chuvisco**, **Chuva**, **Aguaceiros**, **Neve** ou **Trovoada**, as temperaturas máxima e mínima e a chuva em mm. O dia de hoje tem uma margem colorida
- **Sem dados para este dia** num dia para o qual o Tillor não tem nada

## Escolher outro período [#een-andere-periode-kiezen]

Por predefinição vê os últimos 14 dias. Clique no canto superior direito em **Selecionar um período** para escolher outro período: **Hoje**, **Ontem**, **Últimos 7 dias**, **Último mês**, **Últimos 3 meses**, **Tudo** ou um **Intervalo personalizado** no calendário. Confirme um intervalo próprio com **Aplicar**.

## Ainda sem dados meteorológicos [#nog-geen-weergegevens]

Se aparecer **Ainda sem dados meteorológicos**, a meteorologia ainda não foi obtida. O Tillor obtém-na todas as noites para o centro do mapa da sua organização e também preenche os dias em falta no passado. Experimente outro período ou volte no dia seguinte. Verifique também se o centro do mapa está certo.

## Onde mais vê a meteorologia [#waar-zie-je-het-weer-nog-meer]

- Na página do contador, em **Consumo e tendências**: num dia de pico aparece a temperatura e, num consumo elevado, um resumo dos últimos 7 dias. Veja [Gestão de contadores](/meterbeheer/meterstanden-en-trends#verbruik-en-trends-lezen).
- Na linha cronológica das reservas e nos gráficos dos veículos no parque, junto à meteorologia desse dia.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Aparece Ainda sem dados meteorológicos">
A meteorologia ainda não foi obtida. Experimente outro período ou volte no dia seguinte, e verifique se o centro do mapa está certo.
</Accordion>
<Accordion title="A meteorologia não corresponde ao meu parque">
O centro do mapa está noutro local. Mova-o em <UIPath>Definições > Mapa</UIPath>, veja [Mapa](/kaart#kaartstandaard-instellen). A meteorologia passa a seguir o novo local.
</Accordion>
<Accordion title="Num dia aparece Sem dados para este dia">
O Tillor não tem nada para esse dia. É preenchido automaticamente quando os dados estiverem disponíveis.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Mapa" href="/kaart" description="Definir o centro do mapa do seu parque" />
  <Card title="Gestão de contadores" href="/meterbeheer" description="Consumo e tendências por contador" />
</Cards>


# Resumo (/pt-PT/api-referentie)

Esta referência é gerada diretamente a partir da API do Tillor. Cada endpoint tem a sua própria página com parâmetros, corpo do pedido, respostas possíveis e exemplos de código. Na barra lateral, os endpoints estão agrupados por tema.

## Enviar um pedido [#een-request-versturen]

Todos os pedidos precisam da sua chave de API no cabeçalho `x-api-key`. Os endpoints em `/orgs/{organizationId}` funcionam dentro de uma só organização.

```http
GET https://api.tillor.eu/orgs/org_abc123/customers
x-api-key: tkn_xxx
```

Cria uma chave de API na aplicação, na sua conta. Como funciona, que limites de pedidos se aplicam e como guardar as chaves em segurança, leia em [API HTTP](/ontwikkelaars/http).

## Quem pode chamar um endpoint [#wie-mag-een-endpoint-aanroepen]

Cada página de endpoint mostra no topo, em **Acesso**, quem o pode chamar. Na maioria dos endpoints é um membro da organização com uma permissão específica, como `customers:read`. Uma chave de API funciona com as permissões da pessoa que a criou; se a chave tiver scopes, a permissão também tem de estar neles. Caso contrário, a API responde `403`.

A especificação tem a mesma informação por endpoint em `x-tillor-access`, com `access` (quem) e `permissions` (basta uma).

## Experimentar no playground [#uitproberen-in-de-playground]

Em cada página de endpoint pode enviar logo o pedido. Se tiver sessão iniciada no Tillor no mesmo navegador, o playground usa a sua sessão e não precisa de chave de API. Caso contrário, preencha a sua chave de API em **Authorization**. Ajuste os parâmetros e clique em **Send**.

O playground comunica com a API real da sua organização: um `POST`, `PUT` ou `DELETE` altera, portanto, dados reais.

<Callout type="warn" title="Use uma organização de teste">
Experimente os endpoints de escrita numa organização de teste, não no seu parque em funcionamento.
</Callout>

## Descarregar a especificação [#specificatie-downloaden]

A especificação completa está disponível em OpenAPI 3.1 em [tillor.eu/api/openapi.json](https://tillor.eu/api/openapi.json). Importe-a no Postman ou no Insomnia, ou gere um cliente com ela.

## Ver também [#zie-ook]

<Cards>
  <Card title="API HTTP" description="Autenticação, limites de pedidos e convenções" href="/ontwikkelaars/http" />
  <Card title="Webhooks" description="Receber eventos no seu próprio URL" href="/ontwikkelaars/webhooks" />
</Cards>


# Gerir um controlador (/pt-PT/controllers/controller-beheren)

Na página de um controlador ajusta os seus dados e faz a manutenção. Definições como ACL, rede e atualizações estão à parte em [Definições do controlador](/controllers/settings).

Antes de começar:

- O controlador está aprovado, veja [Associar um controlador](/controllers/controller-koppelen).

## Alterar o nome, o tipo e o grupo [#naam-type-en-groep-wijzigen]

<Steps>
<Step>
### Abra o controlador [#open-de-controller]
Aceda a <UIPath>Controladores > Visão geral</UIPath> e clique no controlador.
</Step>
<Step>
### Ajuste o formulário [#pas-het-formulier-aan]
Em **Definições do controlador** escolhe o **Nome**, o **Tipo** (**Duche**, **Acesso** ou **Posto de carregamento**) e o **Grupo**.
</Step>
<Step>
### Clique em Guardar [#klik-op-opslaan]
O Tillor indica **Controlador atualizado** e envia as definições para o controlador.
</Step>
</Steps>

## Reiniciar um controlador [#een-controller-herstarten]

Se um controlador não responder bem, reinicie-o a partir do Tillor.

<Tabs items={["Na página de detalhe", "Na visão geral"]}>
<Tab value="Na página de detalhe">
Abra o menu de ações (os três pontos) e escolha **Reiniciar controlador**.

<DocScreenshot src="/screenshots/controllers/controller-actions-menu.png" alt="Menu de ações de um controlador com Reiniciar controlador" />
</Tab>
<Tab value="Na visão geral">
Clique no ícone de reinício na linha do controlador.
</Tab>
</Tabs>

O ecrã mostra **A reiniciar** e o controlador volta a ligar-se de seguida.

O menu de ações também tem **Ver registos no Grafana**. Abre os registos do controlador noutro programa, destinado ao suporte. Na própria página do controlador, os registos recentes estão no cartão **Consola**.

## Atualizar para uma nova versão [#bijwerken-naar-een-nieuwe-versie]

Se ao lado do número da versão aparecer uma seta para cima, está disponível um <Term term="firmware">firmware</Term> (software) mais recente. Passe o rato por cima para ver a versão (**Atualização disponível**) e clique para iniciar a atualização. O Tillor indica **Atualização OTA iniciada**. Quando os controladores se atualizam sozinhos, leia em [Atualizações de firmware](/controllers/updates).

## Eliminar um controlador [#een-controller-verwijderen]

No menu de ações, escolha **Eliminar controlador** e confirme em **Eliminar controlador**. O controlador desaparece da sua lista. Depois pode voltar a pedir adoção.

## O que acontece depois? [#wat-gebeurt-er-daarna]

- Após um reinício, o controlador volta a ligar-se ao Tillor. Demora um pouco.
- Após a atualização, o controlador reinicia sozinho. Mantenha a corrente ligada enquanto o ecrã mostra **Atualizar** com uma percentagem.
- Um controlador eliminado deixa de dar acesso.

## Problemas? [#problemen]

<Accordions>
<Accordion title="O Tillor diz: O reinício falhou">
Não foi possível reiniciar o controlador, normalmente porque está offline. Verifique a corrente e a rede, veja [Problemas de ligação](/controllers/troubleshooting/verbinding).
</Accordion>
<Accordion title="O Tillor diz: A atualização OTA falhou">
Não foi possível iniciar a atualização. Verifique se o controlador está online e se **Ignorar atualizações OTA** está em **Não**, veja [Atualizações de firmware](/controllers/updates).
</Accordion>
<Accordion title="O Tillor diz: A atualização falhou">
Não foi possível guardar o formulário. Tente novamente e verifique se o nome está preenchido.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Definições do controlador" href="/controllers/settings" description="ACL, rede, atualizações e relé" />
  <Card title="Atualizações de firmware" href="/controllers/updates" description="Janela e frequência de atualização" />
</Cards>


# Associar um controlador (/pt-PT/controllers/controller-koppelen)

Um novo controlador só funciona para a sua organização depois de o aprovar. Chama-se adoção: indica no Tillor que esta caixa pertence ao seu parque. Depois pode atribuir-lhe um tipo e um grupo, veja [Gerir um controlador](/controllers/controller-beheren).

Antes de começar:

- Tem corrente e uma rede (cabo ou Wi-Fi) no local onde o controlador vai ficar.
- Se usar Wi-Fi, tenha à mão o nome da rede e a palavra-passe.
- Abra o Tillor, de preferência, na mesma rede do controlador. Caso contrário, por vezes não vê o pedido dele.

## Ligar e aprovar o controlador [#de-controller-aansluiten-en-goedkeuren]

<Steps>
<Step>
### Ligue o controlador [#sluit-de-controller-aan]
Ligue a corrente. O ecrã mostra **A ligar...** e, de seguida, o que ainda falta.
</Step>
<Step>
### Dê-lhe uma rede [#geef-hem-een-netwerk]
<Tabs items={["Cabo de rede", "Wi-Fi"]}>
<Tab value="Cabo de rede">
Ligue o cabo de rede. O controlador liga-se sozinho, não precisa de definir nada.
</Tab>
<Tab value="Wi-Fi">
No ecrã, toque em **Configurar Wi-Fi**, escolha a sua rede, escreva a palavra-passe e confirme. O ecrã mostra **Ligado**. Veja [Configurar o Wi-Fi no ecrã](/controllers/troubleshooting/verbinding#wifi-instellen-op-het-scherm).
</Tab>
</Tabs>
</Step>
<Step>
### Abra Controladores no Tillor [#open-controllers-in-tillor]
Aceda a <UIPath>Controladores > Visão geral</UIPath>. Assim que o controlador tiver ligação, aparece na lista com a indicação **Aguardando aprovação**. O ecrã do controlador mostra **Ativar controlador** com o número do dispositivo. Esse número é o <Term term="eFuse ID">eFuse ID</Term>, o número de série da caixa. Verifique se é o mesmo que consta na lista.
</Step>
<Step>
### Clique em Aprovar [#klik-op-goedkeuren]
Clique na marca de verificação (**Aprovar**) na linha. O Tillor indica **Aprovado** e o controlador fica adicionado à sua organização.
</Step>
</Steps>

## O que acontece depois? [#wat-gebeurt-er-daarna]

- O ecrã do controlador mostra **Digitalize o QR** e **Leia a sua tag**. Está pronto a usar.
- O Tillor envia automaticamente os dados de ligação e as definições para o controlador. Não precisa de preencher nada.
- A sua primeira leitura cria a tag no Tillor, se ainda não existir.
- Com a cruz (**Rejeitar**) recusa um pedido. Nesse caso, o controlador não tem acesso à sua organização.
- Se mais tarde guardar ou substituir um controlador, elimine-o, veja [Gerir um controlador](/controllers/controller-beheren#een-controller-verwijderen). Depois pode voltar a fazer um pedido.

## Problemas? [#problemen]

<Accordions>
<Accordion title="O controlador não está na lista">
O ecrã tem de mostrar **Ativar controlador** antes de ele aparecer. Se ainda mostrar **Configurar Wi-Fi** ou **A ligar...**, ainda não está online. Experimente também abrir o Tillor a partir da mesma rede do controlador e atualize a página. Mais passos em [O controlador não aparece no Tillor](/controllers/troubleshooting/verbinding#controller-verschijnt-niet-in-tillor).
</Accordion>
<Accordion title="O Tillor diz: A aprovação falhou">
Não foi possível aprovar a adoção. Tente novamente. Se continuar a falhar, verifique se o relógio do controlador está certo e contacte o suporte. Veja [Adoção falhada](/controllers/troubleshooting/verbinding#adoptie-mislukt-of-credentials-worden-geweigerd).
</Accordion>
<Accordion title="O ecrã fica em A ligar...">
Aguarde 1 a 2 minutos. Se continuar assim, verifique o cabo ou o sinal Wi-Fi. Veja [O ecrã fica em A ligar...](/controllers/troubleshooting/verbinding#scherm-blijft-op-verbinden).
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Gerir um controlador" href="/controllers/controller-beheren" description="Nome, grupo, reiniciar e eliminar" />
  <Card title="Mensagens do ecrã" href="/controllers/troubleshooting/scherm" description="O que o controlador mostra" />
</Cards>


# Resumo (/pt-PT/controllers)

Um controlador é uma pequena caixa com um ecrã tátil redondo no seu parque, junto a um duche, porta ou ponto de carregamento. Um hóspede encosta-lhe uma tag <Term term="NFC">NFC</Term>, ou lê o código QR no ecrã, e o Tillor decide se é permitido. Aqui lê o que um controlador faz e como se relaciona com clientes e saldo. Um novo controlador é posto em funcionamento através de [Associar um controlador](/controllers/controller-koppelen).

Os controladores estão no menu principal, em **Controladores**. As cancelas e os controladores de acesso junto à sua entrada não fazem parte deles, veja [Controlo de acesso](/toegangscontrole).

<Callout type="info" title="Bom saber">
- Um controlador comunica com o Tillor de 15 em 15 segundos. Passados cerca de 35 segundos sem contacto, o Tillor mostra-o como offline.
- Após 5 minutos sem contacto, a equipa do Tillor recebe um aviso.
- Um controlador memoriza no máximo 8 redes Wi-Fi.
- O controlo de acesso através do controlador (ACL) está desativado por predefinição. Ative **ACL ativada** nas [definições](/controllers/settings) para que as tags sejam verificadas.
- Por predefinição, verifica diariamente se há uma nova versão de software. Uma atualização só começa dentro da janela de atualização, se a tiver definido.
- Por predefinição, espera 1000 milissegundos (1 segundo) pelo Tillor antes de mudar, na definição **Timeout da ACL da API**.
- Numa breve interrupção, o pagamento com tag continua a funcionar. O pagamento através do código QR deixa de funcionar por um momento.
</Callout>

## Como é que isto se relaciona? [#hoe-hangt-dit-samen]

O controlador não decide sozinho quem pode passar. Lê a tag e pergunta ao Tillor. Aí consta a que cliente a tag pertence, para que grupos de acesso é válida e quanto saldo tem.

```mermaid
flowchart TD
  G[Hóspede encosta a tag ao ecrã] --> C[Controlador]
  C -->|pergunta se é permitido| T[Tillor]
  T --> K[Cliente da tag]
  T --> A[Grupos de acesso e saldo]
  T -->|permitir ou recusar| C
  C -->|mostra o resultado| G
  T --> TR[Transação no histórico da tag]
```

- Cada controlador tem um **Tipo** (**Duche**, **Acesso** ou **Posto de carregamento**) e, opcionalmente, um **Grupo**. Que tags podem passar aqui, define-o com os grupos de acesso da tag, veja [Gerir tags](/nfc/nfc-tags).
- Se o controlador não conseguir contactar o Tillor por momentos, usa, com **Local primeiro**, os dados que ele próprio memorizou, veja [Definições](/controllers/settings).
- Uma tag que ainda não está no Tillor é criada assim que for encostada a um controlador pela primeira vez.

## O que vê no Tillor? [#wat-zie-je-in-tillor]

- **Visão geral dos controladores**: todos os controladores com a sua versão, tipo, grupo, utilização e quando foram **Visto pela última vez**. Os controladores que querem ser associados estão em **Aguardando aprovação**.
- **Detalhe do controlador**: estado, rede, carga do controlador, redes Wi-Fi, eventos e o cartão **Consola** com os registos.
- **Gestão**: reiniciar, atualizar e eliminar, veja [Gerir um controlador](/controllers/controller-beheren).

## Secções [#onderdelen]

<Cards>
  <Card title="Associar um controlador" href="/controllers/controller-koppelen" description="Ligar e aprovar" />
  <Card title="Gerir um controlador" href="/controllers/controller-beheren" description="Nome, grupo, reiniciar e eliminar" />
  <Card title="Configurar redes Wi-Fi" href="/controllers/wifi-netwerken" description="Até 8 redes por ordem de prioridade" />
  <Card title="Definições do controlador" href="/controllers/settings" description="ACL, rede, atualizações e relé" />
  <Card title="Atualizações de firmware" href="/controllers/updates" description="Janela e frequência de atualização" />
  <Card title="Mensagens do ecrã" href="/controllers/troubleshooting/scherm" description="O que significa a mensagem no ecrã?" />
  <Card title="Problemas de ligação" href="/controllers/troubleshooting/verbinding" description="Wi-Fi, ligação ao Tillor e adoção" />
  <Card title="Glossário" href="/controllers/lexicon" description="Conceitos como OTA, adoção e ACL" />
</Cards>

## Conceitos [#begrippen]

- **Controlador**: a caixa com ecrã e leitor de tags.
- **Tag**: o cartão, pulseira ou porta-chaves de um hóspede. Veja [NFC](/nfc).
- **Adoção**: associa um novo controlador à sua organização.
- **ACL**: a lista que determina se uma tag é permitida. Veja [o glossário](/controllers/lexicon).
- **Firmware**: o software dentro da caixa.

Mais explicações na [lista de conceitos](/begrippen).


# Glossário (/pt-PT/controllers/lexicon)

Um resumo dos termos que encontra ao trabalhar com controladores. Cada termo tem uma explicação e, numa citação, o que queremos dizer com ele em linguagem simples.

## A [#a]

<LexiconList>
<LexiconEntry
  term="ACL"
  termAlt="(Access Control List)"
  definition="Controlo de acesso através do controlador. Com a ACL ativada, verifica se um cartão NFC é permitido; com a ACL desativada, os cartões são lidos mas não validados. A prioridade da ACL determina se olha primeiro localmente ou se consulta o Tillor online."
  simple="O controlador consulta uma lista para ver se o seu cartão é permitido. Essa lista chama-se ACL."
/>
<LexiconEntry
  term="Adoção"
  definition="Associar um controlador à sua organização no Tillor. Após a adoção, o controlador recebe as definições certas e pode ligar-se ao Tillor."
  simple="Diz ao Tillor 'este controlador é nosso'. A partir daí, o controlador conhece a sua organização e colabora."
/>
<LexiconEntry
  term="API"
  definition="Consultar o Tillor online no controlo de acesso. Com API primeiro, o controlador pergunta sempre ao Tillor; com Local primeiro, só o faz se o cartão não estiver registado localmente."
  simple="O controlador pergunta ao Tillor online se um cartão é permitido. A esse pedido online chamamos API."
/>
</LexiconList>

## C [#c]

<LexiconList>
<LexiconEntry
  term="Controlador"
  definition="A caixa física que está no seu parque. O controlador lê cartões NFC, verifica o acesso e comunica com o Tillor."
  simple="A caixa junto ao duche ou à porta onde encosta a sua tag."
/>
<LexiconEntry
  term="Credenciais"
  definition="Dados de início de sessão ou de ligação. Após a adoção, o controlador recebe automaticamente as credenciais certas para se ligar ao Tillor."
  simple="Os dados de acesso com que o controlador se liga em segurança ao Tillor após a adoção. Recebe-os automaticamente: não precisa de preencher nada."
/>
</LexiconList>

## E [#e]

<LexiconList>
<LexiconEntry
  term="eFuse ID"
  termAlt="(Electronic Fuse ID)"
  definition="Um número de identificação único gravado no hardware do controlador. Cada controlador tem um eFuse ID diferente: é assim que o Tillor reconhece de que caixa se trata."
  simple="O número de impressão digital da caixa. Como um número de série, mas gravado no chip."
/>
</LexiconList>

## F [#f]

<LexiconList>
<LexiconEntry
  term="Firmware"
  definition="O software que corre no controlador. Com as atualizações de firmware, o controlador recebe novas funções e melhorias."
  simple="O programa dentro da caixa. Como o telemóvel quando recebe uma atualização."
/>
</LexiconList>

## N [#n]

<LexiconList>
<LexiconEntry
  term="NFC"
  definition="Near Field Communication: a tecnologia com que o controlador lê cartões, pulseiras e porta-chaves. Encosta a tag ao ecrã para a ler."
  simple="A forma como o controlador lê a sua tag. Encosta a tag, sem código de barras nem PIN."
/>
</LexiconList>

## O [#o]

<LexiconList>
<LexiconEntry
  term="OTA"
  termAlt="(Over-The-Air)"
  definition="Atualizações através da internet, sem ter de ligar nada. O controlador descarrega e instala automaticamente o novo firmware."
  simple="A caixa vai buscar sozinha o novo software pela internet. Não tem de fazer nada: acontece sozinho."
/>
</LexiconList>

## R [#r]

<LexiconList>
<LexiconEntry
  term="Relé"
  definition="Um interruptor no controlador com que pode comandar um ponto de acesso ou outro dispositivo."
  simple="Um botão na caixa que pode abrir ou fechar o seu ponto de acesso."
/>
</LexiconList>

## S [#s]

<LexiconList>
<LexiconEntry
  term="Ecrã"
  definition="O ecrã tátil redondo do controlador. Mostra o estado em linguagem simples (pronto, pago, recusado, sem ligação), o código QR para pagar online e é nele que configura o Wi-Fi. O leitor de tags fica atrás do ecrã."
  simple="O pequeno ecrã redondo onde encosta a sua tag. Diz o que está a acontecer."
/>
</LexiconList>

## T [#t]

<LexiconList>
<LexiconEntry
  term="Tag"
  definition="O suporte NFC que um hóspede recebe: um cartão, pulseira, porta-chaves ou autocolante. A tag está associada a um cliente no Tillor e pode ter saldo."
  simple="O cartãozinho, a pulseira ou o porta-chaves com que toma duche ou entra."
/>
<LexiconEntry
  term="Tillor"
  definition="A plataforma de gestão do parque. O controlador liga-se ao Tillor para verificar o acesso e trocar dados."
  simple="O programa onde trabalha, no computador ou no tablet. O controlador comunica com ele."
/>
</LexiconList>

## U [#u]

<LexiconList>
<LexiconEntry
  term="Janela de atualização"
  definition="O intervalo de tempo em que o controlador pode atualizar (por ex., entre as 02:00 e as 04:00). Fora desta janela não se fazem atualizações."
  simple="Escolhe quando a caixa pode atualizar. Por exemplo, só de noite, para que ninguém seja incomodado de dia."
/>
</LexiconList>


# Definições do controlador (/pt-PT/controllers/settings)

Esta é uma página de consulta sobre as definições de um controlador. Encontra-as em <UIPath>Controladores > Visão geral > [nome do controlador]</UIPath>, no formulário por baixo do cabeçalho. Clique em **Guardar** para aplicar as alterações. O Tillor envia depois as definições para o controlador. O nome, o tipo e o grupo altera-os em [Gerir um controlador](/controllers/controller-beheren).

## Configuração da ACL [#acl-configuratie]

A <Term term="ACL">ACL</Term> (Access Control List) determina como o controlador verifica o acesso. *Ou seja: como a caixa verifica se um cartão é permitido.*

| Definição | Significado |
| ---------- | --------- |
| **ACL ativada** | Defina como **Sim** para usar o controlo de acesso através do controlador. Em **Não**, os cartões são lidos mas não validados. Por predefinição está em **Não**. |
| **Prioridade ACL** | **Local primeiro**: o controlador verifica primeiro a sua própria memória e depois o Tillor. *Útil quando a internet falha por momentos.* **API primeiro**: pergunta sempre diretamente ao Tillor. Por predefinição **Local primeiro**. |
| **Timeout da ACL da <Term term="API">API</Term>** | Quanto tempo (em milissegundos) o controlador espera pelo Tillor antes de mudar. Por predefinição 1000 ms (1 segundo). |

<Callout type="info" title="Quando usar Local primeiro?">
Escolha **Local primeiro** se quiser que o controlador funcione também durante falhas temporárias de internet. O controlador guarda localmente os direitos de acesso.
</Callout>

## Configuração da internet [#internetconfiguratie]

| Definição | Significado |
| ---------- | --------- |
| **Ligação de rede principal** | **Wi-Fi** ou **Ethernet** (cabo de rede). É a ligação que o controlador tenta primeiro. Por predefinição **Wi-Fi**. |
| **Redes Wi-Fi** | A lista de redes Wi-Fi que o controlador conhece, com um máximo de 8. Veja [Configurar redes Wi-Fi](/controllers/wifi-netwerken). |

## Configuração de atualizações [#updateconfiguratie]

Veja [Atualizações de <Term term="firmware">firmware</Term>](/controllers/updates) para uma explicação detalhada sobre a frequência de atualização, a janela de atualização e ignorar atualizações OTA.

| Definição | Significado |
| ---------- | --------- |
| **Frequência de atualização** | Com que frequência a caixa verifica se há uma nova versão: **Hora**, **Diariamente** ou **Semanalmente**. |
| **Período de atualização de/até** | *Quando pode a caixa atualizar?* Por ex., 02:00-04:00 = só de noite. |
| **Ignorar atualizações <Term term="OTA">OTA</Term>** | Defina como **Sim** se a caixa não deve obter mais atualizações. *Útil temporariamente, mas normalmente deixa-se em Não.* |

## Comando do relé [#relais-aansturing]

O <Term term="relais">relé</Term> é um interruptor na caixa. *Pode usá-lo, por exemplo, para abrir ou fechar um ponto de acesso.*

| Definição | Significado |
| ---------- | --------- |
| **Tipo de relé** | De momento só é suportado **Interno**. |
| **Porta do relé** | Número da porta do relé. Por predefinição 1. |

## Ver também [#zie-ook]

<Cards>
  <Card title="Configurar redes Wi-Fi" href="/controllers/wifi-netwerken" description="Redes e prioridade" />
  <Card title="Atualizações de firmware" href="/controllers/updates" description="Janela de atualização e definições OTA" />
  <Card title="Mensagens do ecrã" href="/controllers/troubleshooting/scherm" description="O que o ecrã do controlador mostra" />
</Cards>


# Mensagens do ecrã (/pt-PT/controllers/troubleshooting/scherm)

O controlador tem um <Term term="scherm">ecrã tátil</Term> redondo. Mostra em linguagem simples o que o controlador está a fazer: um título, uma linha de explicação por baixo e uma margem colorida. *Já não precisa de decorar cores: está lá escrito.* Abaixo encontra cada mensagem e o que fazer.

## Pronto a usar [#klaar-voor-gebruik]

| No ecrã | Significado |
| ------------- | --------- |
| **Digitalize o QR** e **Leia a sua tag**, com **A pagar** e um montante | O controlador está pronto. O hóspede encosta uma tag ao ecrã ou lê o código QR com um telemóvel. |
| Código QR cinzento e riscado | O controlador está temporariamente sem ligação ao Tillor. O pagamento com tag continua a funcionar, o pagamento online através do código QR deixa de funcionar por momentos. |

## Ler uma tag [#een-tag-scannen]

Lê uma tag <Term term="NFC">NFC</Term> encostando-a brevemente ao ecrã, como num pagamento sem contacto.

| No ecrã | Significado |
| ------------- | --------- |
| **Um momento** - A processar o pagamento | A tag foi lida, o controlador pergunta ao Tillor se é permitido. Mantenha a tag encostada ao ecrã mais um pouco. |
| **Pagamento efetuado!** com o montante debitado e o saldo | Pago. O duche ou o aparelho arranca. |
| **Bem-vindo** com o nome do hóspede | Acesso concedido, numa porta ou instalação sem pagamento. |

Se uma tag for recusada, o motivo aparece no ecrã:

| No ecrã | O que se passa | O que fazer |
| ------------- | --------------------- | ---------- |
| **Tag não reconhecida** - Esta tag não pertence aqui | A tag não é do seu parque. | Dê ao hóspede uma tag do parque. |
| **Tag não reconhecida** - Esta não é uma tag válida | O controlador não consegue ler este tipo de tag. | Use uma tag que tenha recebido através do Tillor. |
| **Leitura falhada** - Tag mal lida | A tag foi retirada depressa demais. | Encoste novamente a tag ao ecrã, um pouco mais de tempo. |
| **Pagamento recusado** - Sem acesso | A tag não pode usar este controlador. | Verifique no Tillor o grupo de acesso da tag. |
| **Pagamento recusado** - Tag não associada | A tag ainda não está associada a um cliente. | Associe a tag ao cliente no Tillor. |
| **Pagamento recusado** - Saldo insuficiente | Há pouco saldo na tag. O saldo é indicado. | Carregue a tag na receção. |
| **Servidor inacessível** | Não foi possível processar o pagamento. | Tente mais tarde; veja [Problemas de ligação](/controllers/troubleshooting/verbinding). |
| **Falha ao atualizar a etiqueta** | Não foi possível guardar o saldo na tag. | Encoste novamente a tag ao ecrã e deixe-a lá até a mensagem desaparecer. |

<Callout type="info" title="Uma leitura por apresentação">
Deixar a tag encostada ao ecrã não tem efeito: cada apresentação conta como uma leitura. Se quiser ler de novo, retire a tag e volte a encostá-la ao ecrã.
</Callout>

## Arranque e ligação [#opstarten-en-verbinden]

| No ecrã | Margem | Significado | O que fazer |
| ------------- | ---- | --------- | ---------- |
| **A ligar...** | Azul | O controlador está a arrancar e a procurar ligação à internet e ao Tillor. | Aguarde 1-2 minutos. |
| **Configurar Wi-Fi** - Escolha uma rede Wi-Fi no ecrã | Roxo | O controlador ainda não tem rede. | Toque em **Configurar Wi-Fi** e escolha a sua rede; veja [Configurar o Wi-Fi no ecrã](/controllers/troubleshooting/verbinding#wifi-instellen-op-het-scherm). |
| **Configurar Wi-Fi** - Dados do Wi-Fi recusados | Roxo | A palavra-passe não está (ou já não está) certa. | Introduza novamente a palavra-passe no ecrã. |
| **Ativar controlador** - Ative o dispositivo … no Tillor | Roxo | O controlador aguarda a <Term term="adoptie">adoção</Term>. | No Tillor, aceda a **Controladores** e clique em **Aprovar** (✓). |
| **Ligação perdida** - a tentar novamente | Vermelho | A ligação à internet perdeu-se. O controlador volta a tentar sozinho. | Veja [Problemas de ligação](/controllers/troubleshooting/verbinding#verbinding-verbroken). |
| **Ligação perdida** - Offline há demasiado tempo | Vermelho | O controlador está sem ligação há demasiado tempo. Os pagamentos ficam desativados até a ligação voltar. | Restabeleça a ligação de rede. |

## Atualizações e reinícios [#updates-en-herstarten]

| No ecrã | Margem | Significado |
| ------------- | ---- | --------- |
| **Atualizar** com uma percentagem | Âmbar | Uma atualização de <Term term="firmware">firmware</Term> está a ser descarregada e instalada. Mantenha a corrente ligada. |
| **A reiniciar** | Amarelo | O controlador reinicia, após uma atualização ou porque clicou em **Reiniciar controlador** no Tillor. |

## Avarias [#storingen]

| No ecrã | Significado | O que fazer |
| ------------- | --------- | ---------- |
| **Leitor de tags indisponível** | O leitor de tags não arranca. O controlador tenta repará-lo sozinho. | Aguarde um minuto. Se a mensagem persistir, [reinicie o controlador](/controllers/controller-beheren#een-controller-herstarten). |
| **Sem ligação** - A ligar ao controlador | O ecrã não recebe sinal do resto do controlador. | Reinicie o controlador. Se continuar assim, contacte o suporte do Tillor. |
| O ecrã fica preto | O controlador não tem corrente. | Verifique a alimentação e a cablagem. |

## Ver também [#zie-ook]

<Cards>
  <Card title="Problemas de ligação" href="/controllers/troubleshooting/verbinding" description="Wi-Fi, ligação ao Tillor e adoção" />
  <Card title="Definições do controlador" href="/controllers/settings" description="ACL, rede, atualizações e relé" />
</Cards>


# Problemas de ligação (/pt-PT/controllers/troubleshooting/verbinding)

Se o controlador não se ligar bem, o seu <Term term="scherm">ecrã</Term> indica onde falha. Abaixo encontra, para cada mensagem, o que se passa e o que deve fazer. Todas as mensagens estão em [Mensagens do ecrã](/controllers/troubleshooting/scherm).

## Configurar o Wi-Fi no ecrã [#wifi-instellen-op-het-scherm]

Se o ecrã mostrar **Configurar Wi-Fi**, o controlador ainda não tem rede. Com um cabo de rede (Ethernet) não precisa de fazer nada; para Wi-Fi, configure a rede no próprio controlador:

1. Toque em **Configurar Wi-Fi**
2. Escolha a sua rede na lista. Cada rede mostra a intensidade do sinal: verde é bom, laranja é razoável, vermelho é fraco
3. Escreva a palavra-passe no teclado do ecrã e confirme
4. O ecrã mostra **Ligado** - o Wi-Fi está configurado

Se a sua rede não aparecer, toque em procurar novamente. Se quiser alterar a rede mais tarde, mantenha o dedo premido no ecrã enquanto o controlador está pronto, ou altere-a nas [definições](/controllers/settings#internetconfiguratie) no Tillor.

| Mensagem | Solução |
| -------- | ------- |
| **Falha na ligação** - Verifique a palavra-passe | Escreva a palavra-passe novamente; atenção às maiúsculas. |
| **Falha na ligação** - Rede não encontrada | Aproxime o controlador do ponto de acesso ou escolha outra rede. |
| **Falha na ligação** - Falha ao procurar redes | Toque em procurar novamente. Se continuar assim, reinicie o controlador. |
| **Configurar Wi-Fi** - Dados do Wi-Fi recusados | A palavra-passe guardada já não está certa. Introduza-a novamente no ecrã. |

## Ativar controlador [#controller-activeren]

**Significado:** O controlador aguarda a <Term term="adoptie">adoção</Term> - ainda não está associado ao Tillor. *A caixa está pronta, mas ainda não sabe a que organização pertence.* No ecrã aparece **Ativar controlador** com o número do dispositivo.

**Solução:**
1. No Tillor, aceda a **Controladores**
2. Procure a linha **Aguardando aprovação** com o mesmo número (o <Term term="eFuse ID">eFuse ID</Term>)
3. Clique em **Aprovar** (✓) para associar o controlador à sua organização

## Ligação perdida [#verbinding-verbroken]

**Significado:** A ligação à internet perdeu-se. O controlador tenta voltar a ligar-se automaticamente. *A caixa perdeu o contacto com o Tillor e tenta recuperá-lo.*

Enquanto a interrupção for curta, os hóspedes podem continuar a pagar com a sua tag; o código QR fica então a cinzento e riscado. Se aparecer **Offline há demasiado tempo**, os pagamentos ficam desativados até a ligação voltar.

No Tillor, o controlador aparece como offline após cerca de 35 segundos sem contacto. Passados 5 minutos, a equipa do Tillor recebe um aviso.

**Causas possíveis:**
- **O Wi-Fi caiu** - verifique se a rede Wi-Fi está acessível
- **Avaria da internet** - o controlador não consegue chegar ao Tillor
- **O Tillor está temporariamente inacessível**

**Solução:**
- Aguarde alguns minutos - o controlador tenta voltar a ligar-se sozinho
- Verifique se outros dispositivos na mesma rede têm internet
- Verifique as [definições de Wi-Fi](/controllers/settings) do controlador (nome da rede, palavra-passe)
- Coloque o controlador ao alcance do ponto de acesso Wi-Fi, ou utilize um cabo de rede

## O ecrã fica em A ligar... [#scherm-blijft-op-verbinden]

**Significado:** O controlador ainda está a arrancar ou a ligar-se. Por baixo do título aparece o passo em que está, por exemplo *A estabelecer ligação à internet* ou *A procurar atualizações*.

**Solução:**
- Aguarde 1-2 minutos - o arranque demora um pouco
- Se ficar em *A estabelecer ligação à internet*: verifique o cabo de rede ou [configure o Wi-Fi novamente](#wifi-instellen-op-het-scherm)
- Verifique se o sinal Wi-Fi é suficientemente forte

## O controlador não aparece no Tillor [#controller-verschijnt-niet-in-tillor]

**Significado:** O controlador ainda não está visível para adoção.

**Causas possíveis:**
- O controlador não tem ligação à internet (não consegue chegar ao Tillor)
- O controlador ainda está a arrancar
- Está a abrir o Tillor a partir de outra rede que não aquela a que o controlador está ligado - os pedidos de adoção podem, nesse caso, não ficar visíveis

**Solução:**
1. Verifique se o controlador tem corrente e se o ecrã está ligado
2. Veja o que o ecrã mostra: com **Configurar Wi-Fi** ou **A ligar...** ainda não está online
3. Aguarde até o ecrã mostrar **Ativar controlador** e a linha **Aguardando aprovação** aparecer na lista - pode demorar um pouco
4. Abra o Tillor a partir da mesma rede que o controlador, ou contacte o suporte
5. Atualize a página Controladores no Tillor (os novos pedidos também aparecem automaticamente)

## A adoção falha ou as credenciais são recusadas [#adoptie-mislukt-of-credentials-worden-geweigerd]

A <Term term="adoptie">adoção</Term> é a associação do controlador à sua organização; as <Term term="credentials">credenciais</Term> são os dados de ligação que lhe correspondem.

**Significado:** A associação ao Tillor não foi bem-sucedida. *Não foi possível associar a caixa à sua organização.*

**Solução:**
- Verifique se o relógio do controlador está certo (um grande desvio de hora pode bloquear a associação)
- Depois de um flash de firmware ou de uma nova chave, o controlador tem de ser aprovado novamente
- Tente a adoção novamente com **Aprovar** (✓)
- Contacte o suporte se o problema persistir - têm acesso aos registos

## A atualização OTA fica bloqueada ou falha [#ota-update-blijft-hangen-of-faalt]

Uma atualização <Term term="OTA">OTA</Term> é uma atualização de <Term term="firmware">firmware</Term> através da internet. Durante uma atualização, o ecrã mostra **Atualizar** com uma percentagem.

**Significado:** A atualização de firmware não foi concluída. *A caixa tentou instalar software novo, mas não correu bem.*

**Solução:**
- Aguarde até a [<Term term="updatevenster">janela de atualização</Term>](/controllers/updates) estar ativa - as atualizações só se realizam dentro dessa janela
- Verifique se o controlador tem uma ligação à internet estável
- Ative temporariamente [Ignorar atualizações OTA](/controllers/updates#ota-updates-overslaan) se quiser primeiro estabilizar o controlador

## Ver também [#zie-ook]

<Cards>
  <Card title="Mensagens do ecrã" href="/controllers/troubleshooting/scherm" description="O que significa a mensagem no ecrã?" />
  <Card title="Definições do controlador" href="/controllers/settings" description="Configurar Wi-Fi e rede" />
</Cards>


# Atualizações de firmware (/pt-PT/controllers/updates)

Um controlador obtém sozinho software novo através da internet, tal como o seu telemóvel. Esse software chama-se <Term term="firmware">firmware</Term>. Você define **quando** e **com que frequência** o pode fazer. Por predefinição, verifica diariamente se há novidades. Se quiser iniciar uma atualização de imediato, faça-o a partir da página do controlador, veja [Gerir um controlador](/controllers/controller-beheren#bijwerken-naar-een-nieuwe-versie).

## Frequência de atualização [#updatefrequentie]

O controlador verifica periodicamente se existe uma nova versão de firmware:

| Opção | Significado |
| ----- | ----------- |
| **De hora a hora** | Verifica atualizações a cada hora. |
| **Diariamente** | Verifica uma vez por dia (predefinição). |
| **Semanalmente** | Verifica uma vez por semana. |

Após a verificação, a atualização só é executada se existir uma versão mais recente. Se definiu uma janela de atualização, a hora atual também tem de estar dentro dessa janela. *Ou seja: a caixa verifica se há novidades, mas só as instala nas horas que definiu.*

## Janela de atualização [#updatevenster]

A janela de atualização é o intervalo de tempo em que o controlador pode atualizar-se. Se preencheu **Período de atualização de** e **Período de atualização até**, as atualizações só são executadas dentro desses horários. *Em palavras simples: é você quem escolhe quando a caixa pode atualizar-se - por exemplo, apenas de noite.*

**Exemplo:** Se definir **Período de atualização de** como 02:00 e **Período de atualização até** como 04:00, a atualização só se realiza entre as 02:00 e as 04:00. Assim evita que o controlador reinicie a meio do dia, nas horas de maior movimento.

### Configurar [#instellen]

1. Aceda a <UIPath>Controladores > Visão geral > [nome do controlador]</UIPath>
2. Desça até **Configuração de atualizações**
3. Escolha a **Frequência de atualização** (De hora a hora, Diariamente ou Semanalmente)
4. Preencha **Período de atualização de** (p. ex. 02:00)
5. Preencha **Período de atualização até** (p. ex. 04:00)
6. Clique em **Guardar**

## Ignorar atualizações OTA [#ota-updates-overslaan]

<Term term="OTA">OTA</Term> significa Over-The-Air: atualizações através da internet. Se definir **Ignorar atualizações OTA** como **Sim**, o controlador deixa de instalar firmware novo. O controlador mantém-se na versão atual. *Ou seja: a caixa já não se atualiza sozinha por OTA.*

**Quando usar?**

- Temporariamente, se não quiser alterações durante um período de grande movimento
- Em controladores de teste ou de demonstração que têm de ficar numa versão fixa

<Callout type="info" title="Recomendação">
Deixe **Ignorar atualizações OTA** por predefinição em **Não**. As atualizações trazem muitas vezes melhorias e correções de segurança.
</Callout>

## O que acontece durante uma atualização? [#wat-gebeurt-er-tijdens-een-update]

1. O controlador deteta uma nova versão de <Term term="firmware">firmware</Term>
2. O firmware é descarregado
3. O ecrã mostra **Atualizar** com uma percentagem - o controlador está a ser atualizado
4. O controlador reinicia automaticamente; o ecrã mostra **A reiniciar**
5. Após o reinício, a nova versão fica ativa

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- Uma atualização só começa se existir uma versão mais recente e a hora estiver dentro da sua janela de atualização.
- Durante a atualização e o reinício, o ecrã mostra **Atualizar** e **A reiniciar**. Por isso, programe a janela para a noite.
- Se definir **Ignorar atualizações OTA** como **Sim**, o controlador fica na versão atual até voltar a alterá-lo.

## Problemas? [#problemen]

<Accordions>
<Accordion title="O controlador não se atualiza">
Verifique se **Ignorar atualizações OTA** está em **Não** e se a hora está dentro da sua janela de atualização. Verifique também a ligação à internet do controlador. Mais informação em [A atualização OTA fica bloqueada ou falha](/controllers/troubleshooting/verbinding#ota-update-blijft-hangen-of-faalt).
</Accordion>
<Accordion title="O ecrã fica em Atualizar">
Mantenha a corrente ligada e aguarde alguns minutos. Se continuar assim, reinicie o controlador e contacte o suporte.
</Accordion>
<Accordion title="O Tillor diz: A atualização OTA falhou">
Não foi possível iniciar a atualização. Verifique se o controlador está online e tente novamente.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Definições do controlador" href="/controllers/settings" description="Resumo de todas as definições" />
  <Card title="Mensagens do ecrã" href="/controllers/troubleshooting/scherm" description="Atualizar e A reiniciar" />
</Cards>


# Configurar redes Wi-Fi (/pt-PT/controllers/wifi-netwerken)

Um controlador pode conhecer várias redes Wi-Fi e muda sozinho para a melhor. Isto é útil se o seu parque tiver pontos de acesso próprios em locais diferentes. Configura-as na página do controlador. Se o controlador ainda estiver sem rede, é preferível configurar o Wi-Fi no próprio ecrã, veja [Configurar o Wi-Fi no ecrã](/controllers/troubleshooting/verbinding#wifi-instellen-op-het-scherm).

Antes de começar:

- O controlador está aprovado, veja [Associar um controlador](/controllers/controller-koppelen).
- Conhece, para cada rede, o nome (SSID) e a palavra-passe. Uma rede aberta não tem palavra-passe.

## Adicionar redes [#netwerken-toevoegen]

<Steps>
<Step>
### Abra o controlador [#open-de-controller]
Aceda a <UIPath>Controladores > Visão geral</UIPath> e clique no controlador. Desça até **Redes Wi-Fi**.
</Step>
<Step>
### Adicione uma rede [#voeg-een-netwerk-toe]
Clique em **Adicionar rede** e preencha o **Nome da rede (SSID)** e a **Palavra-passe**. Deixe a palavra-passe vazia para uma rede aberta. Repita para cada rede.
</Step>
<Step>
### Coloque-as por ordem [#zet-ze-in-volgorde]
Arraste uma linha pela pega à esquerda. A ordem é a prioridade: o controlador tenta as redes que tem ao alcance de cima para baixo.

<DocScreenshot src="/screenshots/controllers/controller-wifi-networks.png" alt="Redes Wi-Fi com duas redes por ordem de prioridade" />
</Step>
<Step>
### Clique em Guardar [#klik-op-opslaan]
O botão **Guardar** está na parte inferior do formulário. O Tillor envia depois a lista para o controlador.
</Step>
</Steps>

Para remover uma rede, use o botão menos (**Remover rede**).

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- O controlador verifica cada rede em separado. Se a primeira rede cair ou a palavra-passe não estiver certa, usa a seguinte.
- Na página de detalhe, em **Redes Wi-Fi conhecidas, por prioridade**, vê como está cada rede:

| Estado | Significado |
|---|---|
| <Status tone="success">Ligado</Status> | O controlador está a usar esta rede neste momento. |
| <Status>Verificada</Status> | A rede funciona, mas o controlador está a usar outra rede neste momento. |
| <Status tone="info">Ainda não verificada</Status> | O controlador ainda não conseguiu testar esta rede. |
| <Status tone="warning">Falhou</Status> | A rede não funciona. O motivo é indicado, por exemplo palavra-passe errada, rede não encontrada ou sem acesso à internet. |

- Para cada rede é indicado se está **ao alcance** ou **fora de alcance**, por vezes com a intensidade do sinal em dBm. As redes introduzidas no ecrã têm a indicação **adicionada no ecrã**.
- Se a lista estiver vazia, não há redes configuradas no Tillor. As redes que alguém adicionou no ecrã continuam guardadas no controlador.
- Os controladores mais antigos, que só conhecem uma rede, mostram em vez disso uma única mensagem sobre a última alteração, como **Alteração de Wi-Fi ainda não confirmada** ou **Credenciais Wi-Fi rejeitadas**. O controlador mantém-se então ligado à rede anterior.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Adicionar rede está a cinzento">
Um controlador memoriza no máximo 8 redes. O Tillor indica-o com **Um controlador memoriza até 8 redes.** Remova primeiro uma rede de que já não precise.
</Accordion>
<Accordion title="O Tillor diz: Introduza um nome de rede">
Uma linha não tem nome de rede. Preencha o nome ou remova a linha.
</Accordion>
<Accordion title="O Tillor diz: Esta rede já está na lista">
Cada nome de rede só pode aparecer uma vez. Remova a linha duplicada.
</Accordion>
<Accordion title="Uma rede está em Falhou">
Leia o motivo junto à rede. Verifique o nome e a palavra-passe. O controlador tenta novamente sozinho e as outras redes continuam a funcionar.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Problemas de ligação" href="/controllers/troubleshooting/verbinding" description="Wi-Fi e ligação ao Tillor" />
  <Card title="Definições do controlador" href="/controllers/settings" description="Preferência de rede e outras definições" />
</Cards>


# Manual do Tillor (/pt-PT)

<HomeHero title="Como se faz no Tillor?">
  Explicações por tarefa para a receção, a administração e o serviço técnico. Procure o que quer fazer, ou comece pela sua função.
</HomeHero>

<HomeSection title="Em que trabalha?" description="Por função, as tarefas que surgem com mais frequência.">

<RoleCard title="Receção" description="Receber hóspedes, fazer check-in e responder a perguntas." href="/reserveringen" icon={<ConciergeBellIcon />}>

- [Procurar ou criar um cliente](/klantenbeheer)
- [Fazer uma reserva](/reserveringen)
- [Fazer o check-in de um hóspede com uma ocupação](/bezettingen#een-bezetting-aanmaken)
- [Responder a mensagens na caixa de entrada](/inbox)

</RoleCard>

<RoleCard title="Administração" description="Faturas, pagamentos e a ligação à sua contabilidade." href="/facturen" icon={<LandmarkIcon />}>

- [Criar e registar uma fatura](/facturen/aanmaken-en-bewerken#een-factuur-aanmaken)
- [Registar um pagamento](/facturen/betalingen-registreren)
- [Prolongar uma ocupação por fatura](/bezettingen#facturatie-bezetting-verlengen)
- [Relatórios de pagamentos para a sua contabilidade](/boekhouden/betalingsrapporten)

</RoleCard>

<RoleCard title="Serviço técnico" description="Cancelas, contadores, controladores e tablets no terreno." href="/controllers" icon={<CpuIcon />}>

- [Abrir ou fechar um ponto de acesso](/toegangscontrole#toegangspunten-bedienen)
- [Associar um contador a um terreno](/meterbeheer/meter-koppelen)
- [O que significa a mensagem no ecrã?](/controllers/troubleshooting/scherm)
- [Configurar um quiosque](/mobiele-app/kiosk-inrichten)

</RoleCard>

<RoleCard title="Programadores" description="Ligar o Tillor aos seus próprios sistemas ou ao seu site." href="/ontwikkelaars" icon={<BracesIcon />}>

- [Criar uma chave de API](/ontwikkelaars/http)
- [Receber webhooks](/ontwikkelaars/webhooks)
- [Eventos em tempo real via SSE](/ontwikkelaars/sse)
- [Ligar ferramentas de IA com MCP](/ontwikkelaars/mcp)

</RoleCard>

</HomeSection>

<HomeSection title="Mais">

<HomeLink title="Novo no Tillor?" description="Iniciar sessão, orientar-se e configurar o seu parque." href="/aan-de-slag" icon={<RocketIcon />} />

<HomeLink title="Na prática" description="Quatro exemplos completos que combinam vários módulos." href="/praktijk" icon={<RouteIcon />} />

<HomeLink title="Conceitos" description="As palavras que encontra no Tillor, explicadas brevemente." href="/begrippen" icon={<RocketIcon />} />

<HomeLink title="Novidades" description="Alterações recentes no Tillor, por mês." href="/wat-is-nieuw" icon={<SparklesIcon />} />

<HomeLink title="Tablets e quiosques" description="A aplicação Tillor em tablets na receção ou no exterior." href="/mobiele-app" icon={<TabletSmartphoneIcon />} />

<HomeLink title="Estado do sistema" description="Está tudo a funcionar? Veja avarias e manutenção." href="https://status.tillor.eu" icon={<ActivityIcon />} />

</HomeSection>


# Enviar um comando para um tablet (/pt-PT/mobiele-app/acties-op-afstand)

À direita, na página do dispositivo, está o painel **Ações remotas**, qualquer que seja o separador que tenha aberto. Aí envia um comando para o dispositivo e pede uma captura de ecrã. O que o próprio dispositivo comunica, lê-o em [Diagnóstico e histórico](/mobiele-app/diagnose-en-geschiedenis).

<Requires permission="Editar definições" />

Antes de começar:

- O dispositivo tem de estar ligado. Um comando segue pela ligação em direto com a aplicação. Se o dispositivo estiver offline, o painel indica **O dispositivo está offline: os comandos só chegam quando voltar a estar ligado.** O Tillor indica então que o comando foi enviado, mas o tablet não o vê.
- **Reiniciar o dispositivo** só funciona se o Tillor for o proprietário do tablet. Veja [Configurar um quiosque](/mobiele-app/kiosk-inrichten).

## Enviar um comando [#een-opdracht-versturen]

<Steps>
<Step>
### Abra o dispositivo [#open-het-toestel]
Aceda a <UIPath>Definições > Tablets e quiosques</UIPath> e clique na linha do dispositivo.
</Step>
<Step>
### Escolha o comando [#kies-de-opdracht]
No painel **Ações remotas**, clique no comando. Recebe a mensagem **Enviado para o dispositivo**, ou **Não foi possível contactar o dispositivo** se não conseguiu seguir.

<DocScreenshot src="/screenshots/tablets/remote-actions.png" alt="Ações remotas e o bloco Captura de ecrã" />
</Step>
</Steps>

Os comandos:

- **Mostrar o nome no ecrã** mostra o nome do dispositivo em grande durante instantes. Útil quando há dois tablets lado a lado e quer saber qual tem aberto.
- **Reproduzir som de teste** reproduz o som de aviso, ao volume do separador **Talões e som**.
- **Ativar ecrã** tira o dispositivo do descanso noturno ou de **Suspender ecrã**.
- **Suspender ecrã** deixa o ecrã preto, mesmo fora do descanso noturno.
- **Dormir 30 segundos** faz o mesmo e depois acorda sozinho. Assim verifica se o ecrã volta a ligar-se, sem esperar até de manhã.
- **Reiniciar o dispositivo** reinicia o tablet. Num tablet de que o Tillor não é proprietário, o botão fica a cinzento.
- **Instalar atualização** instala uma atualização da aplicação que já esteja disponível.
- **Reiniciar a aplicação** reinicia apenas a aplicação Tillor, não o tablet.

## Pedir uma captura de ecrã [#een-schermafbeelding-opvragen]

<Steps>
<Step>
### Clique em Pedir captura de ecrã [#klik-op-schermafbeelding-opvragen]
No bloco **Captura de ecrã**, isto envia o pedido para o tablet.
</Step>
<Step>
### Aguarde pela imagem [#wacht-op-het-beeld]
O Tillor espera um pouco e atualiza a imagem assim que o tablet a carrega. Por baixo da foto aparece quando foi tirada.
</Step>
</Steps>

A imagem é o que a aplicação mostra nesse momento: ecrã inicial, apresentação de fotos, talão ou o ecrã de suspensão. Não é vídeo em direto.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- O tablet executa o comando de imediato. Todos os comandos, exceto os de suspensão, acordam também o ecrã.
- Cada comando fica no [histórico do dispositivo](/mobiele-app/diagnose-en-geschiedenis#geschiedenis).
- Uma captura de ecrã permanece no painel até pedir uma nova.

## Problemas? [#problemen]

<Accordions>
<Accordion title="O Tillor diz Não foi possível contactar o dispositivo">
O comando não chegou ao dispositivo. Normalmente está offline. Aguarde até o estado voltar a ser **Ligado** e envie-o novamente.
</Accordion>
<Accordion title="O botão Reiniciar o dispositivo está a cinzento">
O Tillor não é proprietário do tablet. Configure-o primeiro como descrito em [Configurar um quiosque](/mobiele-app/kiosk-inrichten). Até lá, só pode usar **Reiniciar a aplicação**.
</Accordion>
<Accordion title="Não aparece nenhuma captura de ecrã">
O dispositivo está offline ou a aplicação é demasiado antiga. Neste último caso, o Tillor di-lo previamente: **A aplicação neste dispositivo é demasiado antiga para capturas de ecrã.** Instale uma versão mais recente. Enquanto nunca tiver pedido uma imagem, aparece **Ainda não foi pedida nenhuma captura de ecrã.**
</Accordion>
<Accordion title="O ecrã continua preto depois de Ativar ecrã">
Acordar à distância só funciona se a aplicação também estiver na exceção de bateria. Veja [Bateria](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen).
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Diagnóstico e histórico" href="/mobiele-app/diagnose-en-geschiedenis" description="O que o próprio dispositivo comunica" />
  <Card title="Gerir um tablet ou quiosque" href="/mobiele-app/tablets-en-kiosken" description="Enviar definições" />
</Cards>


# Diagnóstico e histórico (/pt-PT/mobiele-app/diagnose-en-geschiedenis)

Por baixo do painel **Ações remotas** estão dois blocos que o ajudam a verificar um tablet: **Diagnóstico** (o que o dispositivo comunicou da última vez) e **Histórico** (o registo). Pode enviar um comando no mesmo painel, veja [Enviar um comando para um tablet](/mobiele-app/acties-op-afstand).

<DocScreenshot src="/screenshots/tablets/diagnostics.png" alt="Diagnóstico e histórico na página do dispositivo" />

## Diagnóstico [#diagnose]

**Diagnóstico** é a última comunicação do dispositivo, não uma medição em direto. Um traço significa que a aplicação não enviou esse dado.

| Dado | Significado |
|---|---|
| **Visto pela última vez** | Quando o dispositivo teve contacto pela última vez |
| **Ligação** | Wi-Fi ou rede móvel |
| **Ecrã** | **Ligado** ou **Suspenso** |
| **Armazenamento livre** | Espaço livre no tablet, em GB |
| **Idioma do dispositivo** e **Fuso horário** | O idioma e o fuso horário do Android ou do iOS. Não é o idioma que escolheu para a aplicação no separador **Dispositivo** |
| **Compilação**, **Versão do runtime** | Que versão da aplicação está no tablet |
| **Última atualização da aplicação** e **Última verificação de atualizações** | Quando a aplicação foi atualizada ou verificada pela última vez |
| **Erro de atualização** | Aparece se a última verificação ou instalação falhou |
| **Registado** | Quando este dispositivo apareceu pela primeira vez na lista |

## Histórico [#geschiedenis]

**Histórico** mostra, por dispositivo:

- quando o dispositivo se registou
- quando enviou definições ou um comando
- quando a aplicação foi atualizada
- quando o dispositivo ficou offline e quando voltou a ficar online

O registo atualiza-se sozinho. **Ainda sem eventos.** significa que ainda nada foi registado.

## Notificações [#meldingen]

Um aviso de offline ou de bateria só chega se **Alertas** estiver ativado no separador **Dispositivo**, e não durante o descanso noturno.

- Aviso de offline: o dispositivo não comunicou nada durante 10 minutos.
- Aviso de bateria: abaixo de 15% sem carregador. O Tillor não os volta a enviar até o dispositivo voltar a ser ligado ao carregador ou ter carregado de forma clara.

O aviso vai para as pessoas que gerem as definições. Veja [Notificações](/notificaties).

## Ver também [#zie-ook]

<Cards>
  <Card title="Enviar um comando para um tablet" href="/mobiele-app/acties-op-afstand" description="Acordar, reiniciar e uma captura de ecrã" />
  <Card title="Definições do dispositivo" href="/mobiele-app/toestelinstellingen" description="O separador Dispositivo com Alertas" />
</Cards>


# Visão geral (/pt-PT/mobiele-app)

A aplicação Tillor funciona num tablet, quiosque ou telemóvel no seu parque, para **iOS** e **Android**. Os hóspedes e os colegas veem nela o ecrã inicial, os talões e os pedidos de assinatura. A partir do Tillor no seu navegador, envia definições e comandos para esses dispositivos. Um tablet que tem de ficar como quiosque configura-se em [Configurar um quiosque](/mobiele-app/kiosk-inrichten).

<Callout type="warn" title="Não é uma aplicação web completa">
A aplicação não substitui o Tillor no seu navegador. Gerir reservas, criar faturas ou registar pagamentos faz-se no navegador.
</Callout>

## Como tudo se liga [#hoe-hangt-dit-samen]

Um dispositivo aparece sozinho no Tillor assim que alguém abre a aplicação e inicia sessão. O que depois definir no Tillor segue pela ligação em direto para o dispositivo. Em sentido inverso, o dispositivo comunica regularmente com o Tillor, para que veja se ainda está ligado.

```mermaid
flowchart LR
  A[Alguém abre a aplicação<br/>e inicia sessão] --> B[O dispositivo está em<br/>Definições > Tablets e quiosques]
  C[Escolhe definições<br/>e clica em Guardar e enviar] --> D[O tablet aplica-as]
  E[Envia um talão,<br/>PDF ou pedido de assinatura] --> D
  D --> F[O dispositivo comunica bateria,<br/>ligação e versão]
  F --> B
```

Se um dispositivo estiver offline, as definições e os comandos só chegam quando voltar a estar ligado. Veja [Tablets e quiosques](/mobiele-app/tablets-en-kiosken).

<Callout type="info" title="Bom saber">
- Um dispositivo novo aparece na lista no prazo de um minuto depois de alguém iniciar sessão.
- O Tillor indica um dispositivo como offline após 10 minutos sem mensagem. Isto só acontece se **Alertas** estiver ativado e não durante o descanso noturno.
- O aviso de bateria surge abaixo de 15% sem carregador.
- Uma apresentação de fotos tem no máximo 20 fotos. Pode colocar seis botões adicionais no ecrã inicial.
- Não há uma palavra-passe própria da aplicação. Inicia sessão como no navegador, com Microsoft, Google ou Apple.
</Callout>

## Instalar a aplicação e iniciar sessão [#de-app-installeren-en-inloggen]

A sua organização partilha o ficheiro de instalação ou a ligação (versão interna, TestFlight ou loja de aplicações, conforme a vossa distribuição). Se ainda não tem acesso, peça ao seu administrador ou ao suporte do Tillor.

1. Abra a aplicação após a instalação.
2. Inicie sessão com **Microsoft**, **Google** ou **Apple**. É a mesma conta que no navegador, veja [Iniciar sessão](/inloggen).
3. Escolha a sua organização se tiver mais do que uma.

## O que a aplicação faz [#wat-de-app-kan]

- **Mostrar PDF e imagens**: diretamente no ecrã inicial assim que o Tillor envia um documento para o dispositivo.
- **Ler cartões pré-pagos**: ler um cartão NFC e ver os dados do cartão e do cliente.
- **Fazer ouvir pagamentos**: um sinal sonoro quando uma fatura é paga.
- **Quiosque**: manter o ecrã ligado, regular o brilho e mostrar o logótipo da sua organização.

## O que o Tillor vê do dispositivo [#wat-tillor-van-het-toestel-ziet]

A aplicação envia regularmente para o Tillor o nome, o modelo, o sistema operativo, a versão da aplicação, a bateria e a ligação de rede (Wi-Fi ou móvel). Vê isto na lista de dispositivos e na página do dispositivo. Em **Conta** > **Sessões ativas** encontra os mesmos dispositivos como sessões da aplicação, com **Metadados da aplicação**. Aí também termina uma sessão.

## Problemas? [#problemen]

<Accordions>
<Accordion title="A aplicação não se liga">
Verifique o Wi-Fi ou a rede móvel e se iniciou sessão na organização certa. Atualize a aplicação para a versão mais recente. Se não ajudar, termine a sessão e inicie-a novamente. Se continuar a falhar, contacte o seu administrador.
</Accordion>
<Accordion title="O dispositivo não está na lista">
Abra a aplicação, inicie sessão e escolha a organização certa. O dispositivo aparece no prazo de um minuto em **Definições** > **Tablets e quiosques**. Se aí vir **Ainda sem dispositivos**, nenhum dispositivo se registou ainda.
</Accordion>
</Accordions>

## Conceitos [#begrippen]

- **Tablet**: um tablet com a aplicação Tillor, por exemplo na receção.
- **Quiosque**: um tablet fixado na aplicação Tillor, para que os hóspedes não possam sair dela.
- **Dispositivo**: cada instalação da aplicação que consta no Tillor, seja de que tipo for.
- **Descanso noturno**: as horas em que o ecrã se desliga ou fica preto.
- **Bloqueio de ecrã**: um padrão ou PIN no próprio tablet, algo diferente do bloqueio de quiosque.

Mais explicações na [lista de conceitos](/begrippen).

## Ver também [#zie-ook]

<Cards>
  <Card title="Tablets e quiosques" href="/mobiele-app/tablets-en-kiosken" description="Dispositivos na lista, guardar e enviar definições" />
  <Card title="Configurar um quiosque" href="/mobiele-app/kiosk-inrichten" description="Fixar um tablet Android" />
  <Card title="Definições do dispositivo" href="/mobiele-app/toestelinstellingen" description="Todas as definições por separador" />
  <Card title="Ações remotas" href="/mobiele-app/acties-op-afstand" description="Acordar, reiniciar e uma captura de ecrã" />
  <Card title="Iniciar sessão" href="/inloggen" description="Acesso à conta via Microsoft, Google ou Apple" />
  <Card title="Controladores" href="/controllers" description="Hardware no seu parque" />
</Cards>


# Configurar um quiosque (/pt-PT/mobiele-app/kiosk-inrichten)

Com um quiosque fixa um tablet Android na aplicação Tillor. Os hóspedes veem o ecrã inicial, uma apresentação de fotos ou um talão, e não chegam às definições do Android. Depois de uma falha de energia, o tablet volta a arrancar no Tillor. Esta página percorre a configuração única. Os interruptores que ativa a seguir estão em [Definições do dispositivo](/mobiele-app/toestelinstellingen#kiosk).

Sem os passos abaixo, pode ativar **Bloquear a aplicação**, mas o Android usa apenas a fixação de ecrã. Isso pede uma confirmação no tablet e um hóspede pode sair dela. O estado no separador **Quiosque** indica então **Fixação de ecrã. Este tablet não é um quiosque configurado.**

O bloqueio completo só se aplica quando o Tillor é o proprietário do dispositivo. No separador **Quiosque** lê-se isso como **Quiosque configurado: o bloqueio é completo.**

<Callout type="warn">
Isto funciona em Android. No iOS pode usar a aplicação como quiosque para talões e o ecrã inicial, mas não defini-la como proprietária do dispositivo. Os botões em **Gestão Android** ficam então fechados, com a mensagem **Disponível quando este tablet estiver configurado como quiosque.**
</Callout>

## Antes de começar [#voor-je-begint]

Precisa de um computador com `adb`. É um programa gratuito da Google com que se controla um tablet Android através de um cabo USB. É uma tarefa única por tablet, pensada para quem tem alguma vertente técnica. Se não conseguir, peça ajuda ao suporte do Tillor.

Antes de começar:

- Reponha o tablet para as definições de fábrica, ou use um tablet em que ainda não haja uma conta Google adicional. O Android recusa uma aplicação como proprietária assim que o dispositivo já tem uma conta.
- A aplicação Tillor tem de estar instalada e com sessão iniciada na sua organização.
- Nas definições do Android, ative a **Depuração USB** (Opções de programador).
- Ligue o tablet ao computador com um cabo. `adb devices` tem de mostrar o tablet como `device`, não como `unauthorized`.

## O Tillor como proprietário do tablet [#tillor-als-eigenaar-van-de-tablet]

O proprietário de um dispositivo Android pode fazer coisas que uma aplicação normal não pode, como fixar realmente o tablet. Dê essa função ao Tillor com este comando no computador:

```bash
adb shell dpm set-device-owner eu.tillor.app/expo.modules.tillorkiosk.KioskAdminReceiver
```

Se o comando funcionar, o Android responde que o proprietário foi definido. Se falhar com uma mensagem sobre contas, apague as contas ou recomece a partir de uma reposição de fábrica. Este comando só pode ser definido uma vez. Outro proprietário exige nova reposição.

Depois, no Tillor, abra **Definições** > **Tablets e quiosques**, defina o tipo como **Quiosque** e guarde. No separador **Quiosque**, o mosaico **Dispositivo de quiosque** deve ficar verde. Os outros dois mosaicos seguem-se assim que enviar **Aplicação como ecrã inicial** e **Remover o bloqueio de ecrã**. A explicação desses mosaicos está em [Quiosque](/mobiele-app/toestelinstellingen#kiosk).

## Bateria: não deixar a aplicação adormecer [#batterij-de-app-niet-laten-inslapen]

O Android, e sobretudo a Xiaomi com HyperOS, corta a ligação de uma aplicação que, segundo o sistema, "dorme". O quiosque fica então offline a meio da noite, mesmo que o ecrã devesse estar desligado pelo descanso noturno.

Se o Tillor for o proprietário, a aplicação pede por si própria para desativar a otimização da bateria. Na maioria dos tablets é uma janela em que toca em **Permitir**. Na Xiaomi, o HyperOS abre em vez disso a página da bateria do Tillor: escolha aí **Sem restrições**. Se a saltar, a aplicação volta a pedir após o próximo reinício, e a ligação durante a noite continua pouco fiável.

Nenhuma aplicação consegue definir sozinha esta exceção, nem como proprietária do dispositivo. Fica, por isso, um toque por tablet, ou o comando abaixo.

Se essa janela não aparecer, defina a exceção durante a configuração a partir do computador:

```bash
adb shell dumpsys deviceidle whitelist +eu.tillor.app
```

Depois, a aplicação deve continuar a comunicar com o Tillor em segundo plano, mesmo com o ecrã desligado.

## Remover o bloqueio de ecrã [#schermvergrendeling-weghalen]

Um padrão ou PIN no tablet significa que o Android espera no ecrã de bloqueio após cada reinício. O quiosque fica então preto até alguém passar. O mosaico **Bloqueio de ecrã** avisa disso: **Há um padrão ou PIN definido.**

1. Abra o separador **Quiosque**.
2. Em **Gestão Android**, defina **Remover o bloqueio de ecrã** como **Ativado**.
3. Escolha **Guardar e enviar**.

O tablet não o pede por si. O bloqueio desaparece da próxima vez que alguém introduzir o padrão ou o PIN, por exemplo após um reinício. Depois, um reinício termina no Tillor.

Se não quiser esperar, remova o padrão você mesmo nas definições do Android do tablet. O mosaico passa a **Sem padrão nem PIN: um reinício termina no Tillor.**

<Callout type="info" title="Xiaomi: botões de navegação">
Enquanto o Tillor for o ecrã inicial, o HyperOS muda a navegação de gestos para botões. O Tillor oculta essa barra até alguém tocar três vezes no ecrã inicial. Se escolher **Desbloquear temporariamente** na aplicação, volta ao ecrã inicial da Xiaomi. Se quiser lá novamente gestos, defina-os nas definições do Android.
</Callout>

## O que ativar a seguir [#wat-je-daarna-aanzet]

Para um tablet numa caixa na receção ou na entrada, este é um conjunto útil. Tudo está no separador **Quiosque**, salvo indicação em contrário.

| Definição | Valor | Porquê |
| --- | --- | --- |
| **Aplicação como ecrã inicial** | Ativado | O botão de início abre o Tillor. O relógio e a bateria continuam visíveis. |
| **Bloquear a aplicação** | Ativado | Os hóspedes não conseguem sair da aplicação. |
| **Ocultar a interface do sistema** | Ativado | Sem notificações, sem aplicações recentes, sem menu de ligar/desligar. |
| **Proteger o dispositivo** | Ativado | Sem reposição de fábrica, sem modo de segurança, sem transferência por USB, sem desinstalação. |
| **Manter ligado a carregar** | Ativado | O ecrã fica ligado durante o horário de abertura enquanto o carregador estiver ligado. O descanso noturno sobrepõe-se a isto. |
| **Hora automática** | Ativado | O descanso noturno segue o relógio da organização, não um relógio de tablet desajustado. |
| **Orientação do ecrã** | Vertical ou horizontal | Em **Ecrã e repouso**, de acordo com a caixa. **Predefinição** é a rotação automática. |

**Bloquear o volume** fixa o volume do separador **Talões e som**, para que um hóspede não possa usar os botões laterais.

Guarde e verifique os três mosaicos no topo de **Quiosque**. Verde significa que o tablet o comunica assim. Um aviso significa que esse passo ainda não foi bem-sucedido.

## Uma nova versão da aplicação por USB [#een-nieuwe-app-versie-over-usb]

**Proteger o dispositivo** desativa a depuração USB e a transferência de ficheiros. **Bloquear a aplicação** mantém o tablet na aplicação, pelo que uma janela de instalação não pode ser confirmada.

Antes de instalar uma compilação pelo cabo:

1. Defina **Bloquear a aplicação** como **Desativado**.
2. Defina **Proteger o dispositivo** como **Desativado**.
3. Escolha **Guardar e enviar** e aguarde até o tablet largar o bloqueio.
4. Instale a nova versão. Na Xiaomi, o HyperOS pede no tablet para confirmar a instalação por USB: toque em **Instalar**.
5. Volte a definir ambas as definições como **Ativado** e guarde novamente.

Se deixar **Proteger o dispositivo** ativado, o `adb` deixa de ver o tablet. A exceção da bateria e a propriedade mantêm-se numa atualização normal. Numa reposição de fábrica não: aí recomeça no comando `dpm`.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- O tablet arranca novamente no Tillor, no ecrã inicial, após um reinício ou falha de energia.
- Os hóspedes não conseguem sair da aplicação e não veem notificações nem aplicações recentes.
- Os três mosaicos no topo do separador **Quiosque** mostram o que o próprio tablet comunica. Após uma alteração, pode demorar até os mosaicos ficarem verdes, porque o tablet comunica a cada 30 a 60 segundos.
- Uma atualização normal da aplicação mantém a propriedade e a exceção da bateria. Uma reposição de fábrica não.

## Problemas? [#problemen]

<Accordions>
<Accordion title="O comando diz que já há contas no dispositivo">
O Android recusa um proprietário assim que há uma conta no tablet. Remova as contas ou recomece a partir de uma reposição de fábrica.
</Accordion>
<Accordion title="adb devices mostra unauthorized, ou nada">
Confirme no tablet a janela que pede autorização para o computador e verifique se a **Depuração USB** está ativada. Se **Proteger o dispositivo** estiver ativado, o `adb` deixa de ver o tablet: desative-o como na atualização por USB acima.
</Accordion>
<Accordion title="O separador Quiosque diz Fixação de ecrã. Este tablet não é um quiosque configurado.">
O Tillor ainda não é proprietário do tablet, por isso o Android usa apenas a fixação de ecrã. Execute o comando de proprietário e depois escolha **Guardar e enviar**.
</Accordion>
<Accordion title="Os botões em Gestão Android estão fechados">
Junto deles aparece a mensagem **Disponível quando este tablet estiver configurado como quiosque.** Configure o tablet como acima, ou use um tablet Android: no iOS não é possível.
</Accordion>
<Accordion title="O quiosque fica preto após um reinício">
Há um padrão ou PIN no tablet. Ative **Remover o bloqueio de ecrã** e introduza o padrão ou o PIN uma vez, ou remova o bloqueio nas definições do Android.
</Accordion>
<Accordion title="O quiosque fica offline à noite">
O Android deixou a aplicação adormecer. Desative a otimização da bateria para o Tillor, como no título Bateria acima.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Definições do dispositivo" href="/mobiele-app/toestelinstellingen#kiosk" description="Os interruptores do separador Quiosque" />
  <Card title="Configurar um descanso noturno para o ecrã" href="/mobiele-app/nachtrust-instellen" description="O ecrã desligado à noite" />
  <Card title="Gerir um tablet ou quiosque" href="/mobiele-app/tablets-en-kiosken" description="Enviar definições" />
</Cards>


# Configurar um descanso noturno para o ecrã (/pt-PT/mobiele-app/nachtrust-instellen)

Um tablet que fica ligado a noite toda consome energia e pode queimar o ecrã. Com um descanso noturno, o ecrã desliga-se ou fica preto nas horas em que o parque está fechado. As restantes opções de ecrã, como reduzir o brilho, estão em [Definições do dispositivo](/mobiele-app/toestelinstellingen#scherm-en-slaap).

<Requires permission="Editar definições" />

Antes de começar:

- Se quiser que o ecrã se desligue realmente e possa voltar a acordar à distância, configure primeiro o tablet como quiosque e coloque a aplicação na exceção da bateria. Veja [Configurar um quiosque](/mobiele-app/kiosk-inrichten).
- Se escolher o horário de abertura da sua organização, preencha-o primeiro. Veja [Organização](/gebruikers/organisaties#openingsuren).

## Configurar o descanso noturno [#de-nachtrust-instellen]

<Steps>
<Step>
### Abra o separador Ecrã e repouso [#open-het-tabblad-scherm-en-slaap]
Abra o dispositivo em <UIPath>Definições > Tablets e quiosques</UIPath> e clique no mosaico **Ecrã e repouso**. Procure o grupo **Descanso noturno**.
</Step>
<Step>
### Escolha o Modo noturno [#kies-de-nachtstand]
<Tabs items={["Horário fixo", "Quando a organização está fechada"]}>
<Tab value="Horário fixo">
Escolha **Horário fixo** e preencha **Das** e **Até às**. Um horário que passa da meia-noite, como das 22:00 às 07:00, é permitido.
</Tab>
<Tab value="Quando a organização está fechada">
O ecrã segue o horário de abertura da sua organização. Altera-o num só sítio, e todos os dispositivos o seguem.
</Tab>
</Tabs>
Com **Desativado**, o Tillor não programa repouso.
</Step>
<Step>
### Escolha o Estilo de sono [#kies-de-slaapstijl]
**Véu preto** coloca um véu preto sobre a imagem, e um toque acorda-o de imediato. **Ecrã desligado** desliga realmente o painel.
</Step>
<Step>
### Clique em Guardar e enviar [#klik-op-opslaan-en-versturen]
No canto superior direito do grupo aparece quando cai o próximo repouso.
</Step>
</Steps>

<DocScreenshot src="/screenshots/tablets/tab-screen.png" alt="Separador Ecrã e repouso, descanso noturno das 22:00 às 07:00" />

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- No descanso noturno, o ecrã desliga-se ou fica preto, mesmo que **Manter o ecrã ligado** esteja ativado. O descanso noturno sobrepõe-se a isso.
- Tocar no ecrã acorda-o por instantes.
- No fim do horário, o ecrã volta ao normal.
- Durante o descanso noturno, o Tillor não envia aviso de que o dispositivo está offline.
- Se quiser acordar ou suspender o ecrã fora do horário, use [Ações remotas](/mobiele-app/acties-op-afstand).

## Problemas? [#problemen]

<Accordions>
<Accordion title="O ecrã não acorda à noite com Ativar ecrã">
**Ecrã desligado** funciona por completo num tablet configurado como quiosque. Acordar à distância só funciona se a aplicação também estiver na exceção da bateria. Veja [Bateria](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen).
</Accordion>
<Accordion title="O tablet desliga-se demasiado cedo ou demasiado tarde">
Um relógio desajustado no tablet desloca o horário. No separador **Quiosque**, ative **Hora automática**, para que o tablet siga o relógio da organização.
</Accordion>
<Accordion title="O tablet fica offline à noite">
O Android deixa a aplicação adormecer. Desative a otimização da bateria para o Tillor, veja [Configurar um quiosque](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen).
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Configurar um quiosque" href="/mobiele-app/kiosk-inrichten" description="Proprietário do dispositivo e bateria" />
  <Card title="Ações remotas" href="/mobiele-app/acties-op-afstand" description="Acordar ou suspender o ecrã" />
</Cards>


# Configurar o ecrã inicial e uma apresentação de fotos (/pt-PT/mobiele-app/startscherm-en-diavoorstelling)

O ecrã inicial é o que os hóspedes veem quando não há nenhum talão no ecrã: um texto de boas-vindas, o seu logótipo, botões e, se quiser, uma apresentação de fotos com cartazes ou imagens do parque. Aqui configura isso. Cada definição individual, com os seus limites, está em [Definições do dispositivo](/mobiele-app/toestelinstellingen#startscherm).

<Requires permission="Editar definições" />

Antes de começar:

- O dispositivo está em <UIPath>Definições > Tablets e quiosques</UIPath>, veja [Gerir um tablet ou quiosque](/mobiele-app/tablets-en-kiosken).
- As fotos são ficheiros JPEG, PNG ou WebP, ou uma ligação `https` para uma imagem.

## Alterar o texto de boas-vindas [#de-welkomsttekst-aanpassen]

<Steps>
<Step>
### Abra o separador Ecrã inicial [#open-het-tabblad-startscherm]
Abra o dispositivo e clique no mosaico **Ecrã inicial**. O campo **Título de boas-vindas** (máximo 60 carateres) e **Subtítulo de boas-vindas** (máximo 120) estão no topo.
</Step>
<Step>
### Preencha o texto e envie [#vul-de-tekst-in-en-verstuur]
Deixe um campo vazio se a aplicação puder manter o seu próprio texto. Clique em **Guardar e enviar**.
</Step>
</Steps>

<DocScreenshot src="/screenshots/tablets/tab-home.png" alt="Separador Ecrã inicial, com Aspeto e Botões assinalados" />

## Adicionar uma apresentação de fotos [#een-diavoorstelling-toevoegen]

<Steps>
<Step>
### Abra o separador Apresentação e botões [#open-het-tabblad-diavoorstelling-en-knoppen]
Clique nesse mosaico. Em **Visualização** escolhe como as fotos aparecem.
</Step>
<Step>
### Escolha a visualização [#kies-de-weergave]
<Tabs items={["Como fundo", "Ecrã inteiro em inatividade"]}>
<Tab value="Como fundo">
As fotos alternam atrás do logótipo e dos botões, em vez do fundo da sua organização. Os hóspedes podem tocar nos botões ao mesmo tempo.
</Tab>
<Tab value="Ecrã inteiro em inatividade">
As fotos ocupam o ecrã inteiro assim que ninguém toca no ecrã. Um toque traz o ecrã inicial de volta. Quanto tempo demora a espera, define-o em **Iniciar após**.
</Tab>
</Tabs>
</Step>
<Step>
### Adicione fotos [#voeg-fotos-toe]
Clique em **Carregar foto**, ou cole um endereço `https` através de **Adicionar ligação**. Pode adicionar até 20 fotos. Se quiser, coloque numa foto uma legenda de no máximo 80 carateres.
</Step>
<Step>
### Defina o tempo [#stel-de-timing-in]
**Tempo por foto** vai de 3 a 600 segundos. **Iniciar após** de 10 a 3600 segundos. Em **Ajuste** escolhe **Preencher o ecrã** (as margens são cortadas) ou **Mostrar a foto inteira** (com margens pretas).
</Step>
<Step>
### Clique em Guardar e enviar [#klik-op-opslaan-en-versturen]
O tablet mostra a apresentação de fotos assim que tiver as definições.
</Step>
</Steps>

<DocScreenshot src="/screenshots/tablets/tab-content.png" alt="Separador Apresentação e botões, com a visualização e dois botões adicionais" />

## Adicionar botões adicionais [#extra-knoppen-toevoegen]

Os botões adicionais são atalhos no ecrã inicial, por exemplo para uma planta ou para a rede de hóspedes. Pode ter seis.

<Steps>
<Step>
### Clique em Adicionar botão [#klik-op-knop-toevoegen]
Aparece uma linha vazia.
</Step>
<Step>
### Preencha o botão [#vul-de-knop-in]
Indique um texto, uma breve descrição e um endereço web (apenas `https`). Escolha um ícone na fila e, em **Quando mostrar**, se o botão fica sempre visível ou só após um toque.
</Step>
<Step>
### Clique em Guardar e enviar [#klik-op-opslaan-en-versturen-1]
</Step>
</Steps>

O ícone do caixote do lixo remove um botão. **Deixar o dispositivo decidir** descarta a lista do Tillor, para que o tablet use os seus próprios botões.

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- O tablet ajusta o ecrã inicial assim que recebe as definições. Um tablet que esteja offline fá-lo assim que voltar a estar ligado.
- Se definiu **Botão pré-pago** ou **Botão de definições** como **Após um toque**, o botão desaparece após o número de segundos que indicou em **Ocultar após**.
- Um talão, documento ou pedido de assinatura que o Tillor envia para o tablet surge sobre o ecrã inicial e volta a desaparecer.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Carregar foto não funciona e o Tillor diz Falha ao carregar">
O ficheiro não é JPEG, PNG nem WebP, ou o carregamento foi interrompido. Experimente outra foto, ou use **Adicionar ligação** com o endereço da imagem.
</Accordion>
<Accordion title="Não consigo adicionar fotos">
Os botões só aparecem se **Visualização** não estiver em **Desativado**. Se a lista estiver nas 20 fotos, remova primeiro uma com **Remover foto**.
</Accordion>
<Accordion title="A apresentação de fotos não arranca">
Com **Ecrã inteiro em inatividade**, só arranca após o número de segundos em **Iniciar após** sem toque. A predefinição para uma nova apresentação é 60 segundos. Verifique também se o tablet já tem as novas definições.
</Accordion>
<Accordion title="O meu botão não abre nada">
O endereço tem de começar por `https`. Verifique se a ligação funciona num navegador.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Definições do dispositivo" href="/mobiele-app/toestelinstellingen" description="Todas as definições e limites" />
  <Card title="Gerir um tablet ou quiosque" href="/mobiele-app/tablets-en-kiosken" description="Enviar definições" />
</Cards>


# Gerir um tablet ou quiosque (/pt-PT/mobiele-app/tablets-en-kiosken)

Todos os tablets, quiosques ou telemóveis em que alguém abre a aplicação Tillor e escolhe uma organização aparecem no Tillor. A partir daí vê se o dispositivo ainda está ligado e envia-lhe o ecrã inicial, o som e o bloqueio de quiosque. O que pode definir, separador a separador, está em [Definições do dispositivo](/mobiele-app/toestelinstellingen).

<Requires permission="Instellingen bewerken" />

Antes de começar:

- O dispositivo tem de ter a aplicação Tillor e alguém tem de ter sessão iniciada na sua organização. Caso contrário, vê **Ainda sem dispositivos**.
- Só pode enviar definições com a permissão **Editar definições**.

## Enviar definições para um dispositivo [#instellingen-naar-een-toestel-sturen]

<Steps>
<Step>
### Abra a lista [#open-de-lijst]
Aceda a <UIPath>Definições > Tablets e quiosques</UIPath>. Cada linha é uma instalação da aplicação. Vê o nome, o tipo (**Tablet**, **Quiosque** ou **Telemóvel**), o modelo, a versão da aplicação, a percentagem da bateria e se o dispositivo está ligado. **Visto pela última vez** significa que a aplicação não comunica nada há algum tempo.

<DocScreenshot src="/screenshots/tablets/devices-list.png" alt="Definições > Tablets e quiosques com o quiosque Zelfbedieningskiosk" />
</Step>
<Step>
### Abra o dispositivo [#open-het-toestel]
Clique na linha do dispositivo. No topo estão o nome e o estado. Por baixo há uma caixa de pesquisa e uma fila de mosaicos, um por separador.

<DocScreenshot src="/screenshots/tablets/device-page.png" alt="Página do dispositivo Zelfbedieningskiosk com os mosaicos dos separadores e a barra de guardar" />

Num mosaico aparece quantas definições vêm do Tillor. **Tudo fica no dispositivo** significa que ainda não fixou nada nesse separador. À direita permanece o painel **Ações remotas**, veja [Ações remotas](/mobiele-app/acties-op-afstand).
</Step>
<Step>
### Ajuste as definições [#pas-de-instellingen-aan]
Escolha um separador e altere o que pretende. Quase todos os interruptores têm três posições: **Dispositivo**, **Ativado** e **Desativado**. **Dispositivo** mantém a escolha feita no próprio tablet. **Ativado** e **Desativado** substituem essa escolha assim que guardar. Por baixo da descrição aparece o que a aplicação faz quando ninguém escolheu nada, por exemplo **Predefinição: Ativado**.
</Step>
<Step>
### Clique em Guardar e enviar [#klik-op-opslaan-en-versturen]
Nada é enviado para o dispositivo enquanto não clicar aqui. Enquanto houver algo alterado, a barra mostra **Alterações não enviadas** e o separador tem um ponto verde. **Descartar alterações** repõe o formulário com o que está agora no dispositivo.

Antes e depois de uma alteração que ainda não enviou:

<DocScreenshot src="/screenshots/tablets/device-page.png" alt="Antes: página do dispositivo sem alterações" />

<DocScreenshot src="/screenshots/tablets/device-page-unsaved.png" alt="Depois: uma definição alterada com Alterações não enviadas e um ponto verde no separador" />
</Step>
</Steps>

## O mesmo para todos os dispositivos [#hetzelfde-voor-alle-toestellen]

Se tem vários dispositivos do mesmo tipo, não precisa de configurar cada um em separado.

<Tabs items={["Um dispositivo", "Todos os dispositivos deste tipo"]}>
<Tab value="Um dispositivo">
Clique em **Guardar e enviar**. Só este dispositivo recebe as definições.
</Tab>
<Tab value="Todos os dispositivos deste tipo">
Clique em **Aplicar a todos os quiosques** (ou **tablets**, ou **telemóveis**, consoante o tipo). O Tillor copia as definições deste dispositivo para os outros dispositivos do mesmo tipo e envia-as de imediato, com a mensagem **Definições copiadas para os outros dispositivos**. O nome, o tipo e os alertas continuam a ser de cada dispositivo. O idioma é copiado.
</Tab>
</Tabs>

## Pesquisar em todos os separadores [#zoeken-over-alle-tabbladen]

Não sabe em que separador está uma definição? A caixa **Pesquisar definições** pesquisa todos os separadores ao mesmo tempo. Os mosaicos mantêm-se, mas por baixo aparece uma lista de resultados, agrupados por separador.

<DocScreenshot src="/screenshots/tablets/device-search.png" alt="Pesquisa por brilho, com os resultados de Ecrã e repouso" />

Uma pesquisa como `brilho` mostra as linhas de brilho de **Ecrã e repouso** e, por baixo, outros separadores que também contêm a palavra. **Abrir separador** fecha a pesquisa e abre esse separador, para ver também o resto do grupo. Se não encontrar nada, aparece **Nenhuma definição corresponde a** o seu termo de pesquisa.

## Esquecer um dispositivo [#een-toestel-vergeten]

O menu com os três pontos, no canto superior direito da página do dispositivo, contém **Esquecer dispositivo**. Use-o para um tablet que já não está em uso.

<DocScreenshot src="/screenshots/tablets/device-menu.png" alt="Menu com Esquecer dispositivo" />

## O que acontece depois? [#wat-gebeurt-er-daarna]

- O Tillor indica **Definições enviadas**. O tablet aplica-as de imediato se estiver ligado. Se estiver offline, recebe-as assim que voltar a contactar o Tillor. A aplicação comunica de 30 em 30 a 60 segundos.
- Na página do dispositivo e na lista aparece se o dispositivo está ligado. O dispositivo também comunica a bateria, a versão da aplicação e a ligação, veja [Diagnóstico e histórico](/mobiele-app/diagnose-en-geschiedenis).
- Cada alteração fica no histórico do dispositivo e no [registo de atividade](/activiteitenlog) da sua organização.
- Um dispositivo esquecido desaparece da lista e as definições enviadas vão com ele. Se a aplicação ainda estiver a correr e alguém tiver sessão iniciada, volta a aparecer em menos de um minuto, sem essas definições. Terá de as definir de novo.
- Se ativar os **Alertas** no separador **Dispositivo**, as pessoas que gerem as definições recebem uma mensagem quando o dispositivo estiver offline há 10 minutos ou a bateria descer abaixo de 15% sem carregador.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Vejo Ainda sem dispositivos">
Ainda nenhum tablet se registou. Abra a aplicação Tillor no tablet, inicie sessão e escolha a organização certa. O dispositivo aparece em menos de um minuto.
</Accordion>
<Accordion title="O Tillor diz Não foi possível guardar as definições">
Não foi possível guardar, muitas vezes por uma ligação instável ou porque lhe falta a permissão **Editar definições**. Tente novamente. Se ainda assim não resultar, peça a permissão ao seu administrador.
</Accordion>
<Accordion title="O Tillor diz Não foi possível copiar as definições">
**Aplicar a todos os quiosques** não resultou. Clique de novo. Se não funcionar, guarde o dispositivo com **Guardar e enviar** e abra os outros dispositivos um a um.
</Accordion>
<Accordion title="O tablet não faz nada com a minha alteração">
Verifique se o dispositivo está **Ligado**. Se estiver offline, aplica as definições assim que voltar a contactar o Tillor. Se o interruptor estiver em **Dispositivo**, é o próprio tablet que decide. Escolha **Ativado** ou **Desativado** para o contrariar.
</Accordion>
<Accordion title="O dispositivo voltou depois de Esquecer dispositivo">
A aplicação ainda está a correr e alguém tem sessão iniciada, por isso volta a registar-se. Termine a sessão no tablet se quiser mesmo deixar de ter o dispositivo. Em **Conta** > **Sessões ativas** pode terminar a sessão da aplicação.
</Accordion>
<Accordion title="O Tillor diz Use 4 a 6 dígitos">
O **Código das definições** no separador **Ecrã inicial** tem de ter 4 a 6 dígitos, ou ficar vazio. Só então pode guardar.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Definições do dispositivo" href="/mobiele-app/toestelinstellingen" description="O que há em cada separador" />
  <Card title="Configurar um quiosque" href="/mobiele-app/kiosk-inrichten" description="Fixar um tablet Android para que os hóspedes não possam sair da aplicação" />
  <Card title="Ações remotas" href="/mobiele-app/acties-op-afstand" description="Ativar o ecrã, reiniciar e pedir uma captura de ecrã" />
</Cards>


# Definições do dispositivo (/pt-PT/mobiele-app/toestelinstellingen)

Aqui encontra todas as definições de um dispositivo, por separador, com os respetivos valores predefinidos e limites. São seis, cada um num mosaico por cima dos formulários. Como lá chegar, como funciona a pesquisa e quando algo é enviado para o dispositivo está em [Gerir um tablet ou quiosque](/mobiele-app/tablets-en-kiosken). Passo a passo, o ecrã inicial está em [Configurar o ecrã inicial e uma apresentação de fotos](/mobiele-app/startscherm-en-diavoorstelling) e o descanso noturno em [Configurar um descanso noturno para o ecrã](/mobiele-app/nachtrust-instellen).

Cada linha tem um ícone, uma breve explicação e, quando faz sentido, o valor predefinido da aplicação. Escolha **Dispositivo** (ou deixe um número vazio em **Predefinição**) para que o tablet mantenha a sua própria escolha. **Ativado** e **Desativado** substituem essa escolha.

As linhas que só funcionam num quiosque configurado mostram um aviso enquanto o tablet ainda não o estiver: **Disponível quando este tablet estiver configurado como quiosque.** Esses passos estão em [Configurar um quiosque](/mobiele-app/kiosk-inrichten).

## Ecrã inicial [#startscherm]

Texto de boas-vindas, fundo e os botões que os hóspedes veem quando não há nenhum recibo no ecrã.

### Texto de boas-vindas [#welkomsttekst]

O **Título de boas-vindas** (máximo 60 carateres) e o **Subtítulo de boas-vindas** (máximo 120) ficam no topo do ecrã inicial. Deixe um campo vazio se a aplicação puder manter o seu próprio texto.

### Aspeto [#uiterlijk]

<DocScreenshot src="/screenshots/tablets/tab-home.png" alt="Separador Ecrã inicial, com Aspeto e Botões assinalados" />

**Aspeto** (marca **1**):

- **Fotografia de fundo** mostra o fundo da organização atrás do logótipo. Predefinição: ativado.
- **Escurecimento do fundo** é uma percentagem de 0 a 90. Predefinição 45, para que o logótipo e os botões continuem legíveis sobre uma fotografia clara.
- **Estilo do logótipo** é **Silhueta branca** (a predefinição) ou **A cores num cartão**.

### Botões [#knoppen]

**Botões** (marca **2**):

- **Botão pré-pago** abre o saldo, o carregamento e o pagamento com um cartão NFC. Predefinição: ativado.
- **Botão de definições** mostra um botão para as definições no próprio dispositivo. Se estiver desativado, chega lá tocando três vezes no ecrã inicial.
- **Quando mostrar** é **Sempre** ou **Após um toque**. Com **Após um toque** preenche **Ocultar após**, em segundos. Depois disso o botão volta a esconder-se até alguém tocar no ecrã.
- **Código das definições** tem 4 a 6 dígitos. O dispositivo pede esse código antes de abrir as suas próprias definições. Vazio significa sem código. Não pode guardar algo que não tenha 4 a 6 dígitos.

## Apresentação e botões [#diavoorstelling-en-knoppen]

Fotos que o ecrã inicial vai alternando e botões adicionais para uma página web.

<DocScreenshot src="/screenshots/tablets/tab-content.png" alt="Separador Apresentação e botões, com a apresentação e dois botões adicionais" />

### Apresentação de fotos [#diavoorstelling]

**Apresentação** (marca **1**) tem três posições:

- **Desligada** não mostra fotos.
- **Como fundo** alterna as fotos atrás do logótipo e dos botões, em vez do fundo da organização.
- **Ecrã inteiro em inatividade** ocupa o ecrã todo assim que ninguém lhe toca.

Quando a apresentação não está em **Desligada**, pode adicionar até 20 fotos. **Carregar foto** aceita JPEG, PNG ou WebP. **Adicionar ligação** cola um endereço `https` de uma imagem. Por foto pode definir uma legenda de, no máximo, 80 carateres.

- **Tempo por foto** é quanto tempo cada foto fica, de 3 a 600 segundos. Uma nova apresentação começa em 10.
- **Iniciar após** só se aplica ao ecrã inteiro: segundos sem toque antes de a apresentação começar, de 10 a 3600. Uma nova apresentação começa em 60.
- **Ajuste**: **Preencher o ecrã** corta as margens, **Mostrar a foto inteira** mantém a foto toda com barras pretas. Uma nova apresentação começa em **Mostrar a foto inteira**.

Um toque numa apresentação em ecrã inteiro devolve o ecrã inicial.

### Botões adicionais [#extra-knoppen]

Os **Botões adicionais** (marca **2**) são atalhos no ecrã inicial, por exemplo um mapa ou a rede para hóspedes. Pode ter seis.

Por botão preenche o texto do botão, uma descrição curta, o endereço web e um ícone. O ícone escolhe-o na fila: mapa, sítio web, informações, calendário, comida e bebida, Wi-Fi, telefone ou bilhetes. **Quando mostrar** funciona como no botão pré-pago: sempre, ou só depois de um toque e depois voltar a ocultar.

**Adicionar botão** cria uma linha vazia. O ícone do caixote do lixo remove esse botão. **Deixar o dispositivo decidir** descarta a lista do Tillor, para que o tablet use os seus próprios botões. Enquanto ainda não guardou botões, essa frase também aparece: não há botões definidos a partir do Tillor.

## Ecrã e repouso [#scherm-en-slaap]

Brilho, orientação, cores e quando o ecrã se desliga durante a noite.

### Brilho [#helderheid]

Se procura uma definição, experimente `brilho` na caixa de pesquisa, veja [Pesquisar em todos os separadores](/mobiele-app/tablets-en-kiosken#zoeken-over-alle-tabbladen).

- **Modo quiosque** mantém o ecrã ligado, com recibos, assinatura e controlo de brilho. Predefinição: ativado num tablet ou quiosque, desativado num telemóvel.
- **Manter o ecrã ligado** impede que o ecrã entre em suspensão. Predefinição: ativado, num telemóvel desativado.
- **Escurecer quando inativo** passa a brilho total com um toque e depois escurece. Predefinição: ativado, num telemóvel desativado.
- **Escurecer após** é o número de segundos sem toque, de 5 a 3600. Predefinição 15.
- **Brilho reduzido** é a percentagem nesse estado escurecido, de 0 a 100. Predefinição 0,5%.

O descanso noturno abaixo tem prioridade sobre **Manter o ecrã ligado**: durante as horas de repouso o ecrã desliga-se ou fica preto na mesma.

### Visualização [#weergave]

- **Orientação do ecrã** é **Rodar automaticamente** (a predefinição), **Vertical** ou **Horizontal**. Fixe um quiosque numa caixa, caso contrário a imagem roda quando alguém inclina o tablet.
- **Aparência** é **Seguir o dispositivo**, **Claro** ou **Escuro**.

### Descanso noturno [#nachtrust]

<DocScreenshot src="/screenshots/tablets/tab-screen.png" alt="Separador Ecrã e repouso, descanso noturno das 22:00 às 07:00" />

O **Modo noturno** (marca **1**) tem três posições:

- **Desativado** não agenda repouso.
- **Horário fixo** usa **Das** e **Até às**. Um horário que atravessa a meia-noite, como das 22:00 às 07:00, é permitido. O ecrã desliga-se nesse bloco, mesmo que o resto do dia deva ficar ligado. Tocar acorda-o por instantes.
- **Quando a organização está fechada** segue o horário de abertura da organização.

No canto superior direito do grupo aparece quando é o próximo repouso.

**Estilo de sono**:

- **Véu preto** coloca um véu preto sobre a imagem. O ecrã continua tocável, por isso um toque acorda-o de imediato.
- **Ecrã desligado** desliga mesmo o painel. Volta a acordar no fim do horário ou a partir de **Ativar ecrã** em [Ações remotas](/mobiele-app/acties-op-afstand). Isto funciona por completo num tablet configurado como quiosque. Acordar à distância só resulta se a aplicação também estiver na exceção da bateria, veja [Bateria](/mobiele-app/kiosk-inrichten#batterij-de-app-niet-laten-inslapen).

## Talões e som [#kassabonnen-en-geluid]

O que o tablet faz quando o Tillor envia um documento e que sons reproduz.

<DocScreenshot src="/screenshots/tablets/tab-sound.png" alt="Separador Talões e som" />

### Recibos e documentos [#kassabonnen-en-documenten]

Marca **1**:

- **Mostrar recibos e documentos** mostra PDF, imagens e pedidos de assinatura neste dispositivo. Predefinição: ativado, num telemóvel desativado. Desative-o num tablet que deve ser apenas um ecrã inicial e não pode mostrar recibos.
- **Limpar após** é o número de segundos que um recibo fica no ecrã antes de o dispositivo o remover sozinho, de 5 a 900. Deixe-o vazio para esperar que o Tillor limpe o ecrã.

### Som [#geluid]

Marca **2**. Tudo o que está abaixo vem ativado por predefinição, com o volume a 100%.

- **Som ao arranque** toca quando a aplicação arranca ou reinicia.
- **Som para recibos e documentos** toca quando chega um recibo, uma imagem ou um pedido de assinatura.
- **Som para pagamentos online** toca quando uma fatura é paga online, ou por transferência automática.
- **Som de bateria fraca** reproduz um aviso quando a bateria está quase vazia e o carregador não está ligado.
- **Volume de som** é de 0 a 100. Num quiosque pode fixá-lo com **Bloquear o volume** no separador **Quiosque**.

**Reproduzir som de teste** está em [Ações remotas](/mobiele-app/acties-op-afstand), não neste separador.

## Quiosque [#kiosk]

Só faz sentido em Android. A configuração (proprietário do dispositivo, bateria, USB) está em [Configurar um quiosque](/mobiele-app/kiosk-inrichten). Neste separador define depois os interruptores.

<DocScreenshot src="/screenshots/tablets/tab-kiosk.png" alt="Separador Quiosque com mosaicos de estado e bloqueio" />

### Estado [#status]

Três mosaicos (marca **1**) mostram o que o tablet comunicou na última mensagem. Não são definições.

- **Dispositivo quiosque** é verde em **Quiosque configurado: o bloqueio é completo.** Um aviso significa fixação de ecrã (a aplicação não é a proprietária) ou que a aplicação não está nada bloqueada. Um traço significa que esta versão da aplicação ainda não comunica o estado.
- **Ecrã inicial** é verde se o Tillor for o ecrã inicial. Caso contrário aparece que o Tillor ainda não o é, ou que a aplicação ainda não o comunicou.
- **Bloqueio de ecrã** avisa se houver um padrão ou PIN no tablet. Após um reinício, o dispositivo fica à espera no ecrã de bloqueio. Verde significa que um reinício termina no Tillor.

### Bloqueio [#vergrendeling]

Marca **2**. Por predefinição estes três estão desativados, até os ativar.

- **Aplicação como ecrã inicial** torna o Tillor o ecrã inicial. O relógio e a bateria permanecem visíveis. Apenas Android, e só com uma compilação da aplicação que o permita.
- **Bloquear a aplicação** mantém o tablet na aplicação Tillor. Num quiosque configurado, um hóspede não consegue sair. Sem essa configuração, o Android recorre à fixação de ecrã: alguém no tablet tem de a confirmar, e é possível sair.
- **Ocultar a interface do sistema** remove notificações, aplicações recentes e o menu de energia. O relógio e a bateria permanecem. Só funciona quando o tablet está configurado como quiosque.

### Gestão Android [#android-beheer]

<DocScreenshot src="/screenshots/tablets/tab-kiosk-android.png" alt="Gestão Android no separador Quiosque" />

Tudo neste grupo (marca **1**) só se aplica a um quiosque configurado. Noutro dispositivo vê o aviso em cada linha e os botões estão desativados. Por predefinição os interruptores estão desativados. Os dois números estão vazios: o tablet mantém então o seu próprio brilho e tempo limite.

- **Proteger o dispositivo** bloqueia a reposição de fábrica, o modo de segurança, novos utilizadores, a transferência USB, a desinstalação e a paragem forçada. Desative-o antes de instalar uma atualização por USB.
- **Remover o bloqueio de ecrã** retira o padrão ou o PIN. Entra em vigor assim que esse padrão ou PIN for introduzido mais uma vez.
- **Manter ligado a carregar** mantém o ecrã ligado durante o horário de abertura enquanto o carregador estiver ligado. O descanso noturno desliga-o na mesma.
- **Bloquear o volume** fixa o volume definido em **Som**.
- **Atualizações durante o sono** instala atualizações do sistema enquanto o ecrã está em repouso e adia-as enquanto o tablet está em uso.
- **Hora automática** exige data, hora e fuso horário automáticos, para que o sono siga o horário de abertura.
- **Brilho do ecrã** é um brilho fixo do próprio tablet, de 1 a 100, com o brilho automático desligado. Deixar vazio mantém a definição do tablet.
- **Tempo limite do ecrã** é o número de segundos (15 a 3600) após o qual o Android desliga o ecrã se a aplicação não o mantiver ligado. Deixar vazio mantém a definição do tablet.

## Dispositivo [#toestel]

Nome, tipo, idioma e alertas. **Aplicar a todos os quiosques** copia o idioma para os outros dispositivos do mesmo tipo e deixa o nome, o tipo e os alertas como estão.

<DocScreenshot src="/screenshots/tablets/tab-general.png" alt="Separador Dispositivo com nome, tipo, idioma e alertas" />

Marca **1**:

- **Nome** é o que vê na lista e no dispositivo, por exemplo `Zelfbedieningskiosk`. Máximo 80 carateres.
- **Tipo** é **Tablet**, **Quiosque** ou **Telemóvel**. O tipo determina o texto de **Aplicar a todos os …** e alguns valores predefinidos: num telemóvel, o modo quiosque, os recibos, manter o ecrã ligado e escurecer começam desativados.
- **Idioma** é a única lista que se fecha, porque há mais opções do que cabem numa fila de botões. **Predefinição** segue o idioma do tablet. Caso contrário, escolhe um idioma da aplicação Tillor. Os nomes aparecem no próprio idioma.
- **Alertas** avisa as pessoas que gerem as definições quando este dispositivo estiver offline há 10 minutos ou a bateria descer abaixo de 15% sem carregador. Durante o descanso noturno não é enviado nenhum alerta de offline. Predefinição: desativado.

<Callout type="info">
O idioma aqui é o idioma da aplicação no tablet. O idioma do sistema Android vê-o em **Diagnóstico**, como **Idioma do dispositivo**.
</Callout>


# Automatizações (/pt-PT/ontwikkelaars/automatiseringen)

As automatizações permitem ao Tillor executar ações por si próprio, como criar tarefas ou chamar o seu sistema. A explicação para utilizadores está em [Automatizações](/automatiseringen). Esta página descreve o que um integrador vê: a mensagem do passo **Enviar webhook**, o **Pedido à API** para um URL próprio ou para a API do Tillor, e como um fluxo é construído se o gerir através da API.

## Enviar webhook [#webhook-versturen]

O passo **Enviar webhook** entrega uma mensagem própria a um dos [webhooks](/ontwikkelaars/webhooks) da organização. É a mesma entrega que nos eventos de webhook normais, com a mesma assinatura.

### A mensagem [#het-bericht]

O passo faz um `POST` com `Content-Type: application/json` e estes cabeçalhos:

| Cabeçalho | Conteúdo |
|---|---|
| `X-Webhook-Event-ID` | Um ID único para esta entrega. Em novas tentativas o valor mantém-se, por isso pode usá-lo para eliminar duplicados |
| `X-Webhook-Signature` | `sha256=<hex>`, o HMAC-SHA256 do corpo com o segredo de assinatura do webhook |

O corpo tem o mesmo envelope que o payload do webhook:

```json
{
  "event": "automation.invoice_unpaid",
  "data": {
    "invoice": "2026-0042",
    "amountOutstanding": 125.5
  },
  "timestamp": 1735689600000,
  "traceId": "0b0f7c0e-5d3c-4c1e-9b8a-7f1e2a3b4c5d",
  "triggeredBy": null
}
```

| Campo | Descrição |
|---|---|
| `event` | O **Nome do evento** que preencheu no passo. Qualquer texto é permitido, o nome não tem de constar da lista de chaves de evento |
| `data` | O **Payload** do passo, depois de as variáveis serem preenchidas, como JSON |
| `timestamp` | Hora Unix em milissegundos da entrega |
| `traceId` | Um UUID aleatório por entrega. Ao contrário dos eventos do sistema, não é o id de rastreio de uma ação do Tillor |
| `triggeredBy` | Sempre `null` |

Não há `spanId`. O webhook não precisa de estar subscrito a uma chave de evento: uma mensagem de uma automatização é sempre entregue ao endpoint escolhido, enquanto este existir e estiver ativo.

Como verificar a assinatura está em [Verificar a assinatura](/ontwikkelaars/webhooks#handtekening-verifiëren).

### Tentativas e resultado [#pogingen-en-uitkomst]

O Tillor faz até 5 tentativas dentro do passo, com 1, 2, 4 e 8 segundos de espera entre elas. Uma tentativa conta como bem-sucedida com um estado 2xx. Também um destino bloqueado, por exemplo um endereço interno, conta como tentativa falhada.

- Se uma das tentativas resultar, o fluxo continua pela saída **Sucesso**
- Se as cinco falharem, o fluxo continua por **Falhou**. A mensagem é depois ainda repetida em segundo plano segundo o calendário em [Comportamento de entrega e repetições](/ontwikkelaars/webhooks#leveringsgedrag-en-retries). Se uma dessas tentativas posteriores resultar, isso já não volta à execução, porque esta já seguiu em frente

Se o webhook já não existir ou estiver desativado, o passo não segue por **Falhou**. A execução pára então com o estado **Falhou**.

## Pedido à API para um URL próprio [#api-verzoek-naar-een-eigen-url]

Com **Pedido à API** e **Enviar para** em **URL personalizado**, uma automatização envia um pedido HTTP para o seu servidor.

| Elemento | Comportamento |
|---|---|
| Método | `GET`, `POST`, `PUT`, `PATCH` ou `DELETE` |
| URL | Tem de começar por `https://`. As variáveis são preenchidas codificadas |
| Corpo | JSON. Não é enviado em `GET` e `DELETE`. Com corpo, o Tillor define `Content-Type: application/json` |
| Cabeçalhos | Livres. Os valores podem conter variáveis. `Host`, `Content-Length`, `Transfer-Encoding` e `Connection` são ignorados |
| Destino | Endereços privados e internos são rejeitados, mesmo que um nome de domínio normal aponte para eles |
| Redirecionamentos | Não são seguidos. Uma resposta 3xx conta como falhada |
| Tempo limite | 15 segundos |

<Callout type="warn" title="Sem assinatura">
Ao contrário de **Enviar webhook**, o Tillor não assina este pedido. Se quiser verificar que um pedido vem da sua automatização, coloque um segredo num cabeçalho e verifique-o do seu lado. Os cabeçalhos são guardados cifrados, por isso uma chave ou um token aí é seguro.
</Callout>

Uma resposta com estado 2xx continua por **Sucesso**, qualquer outro estado por **Falhou**. Se o servidor não for alcançável ou exceder o tempo limite, a execução pára com o estado **Falhou**.

## Pedido à API do Tillor [#api-verzoek-naar-de-tillor-api]

Com **Enviar para** em **Tillor API**, a automatização chama a API da própria organização. Indica apenas um caminho, por exemplo `/tasks`, e o Tillor coloca-o a seguir a `/api/orgs/{orgId}`. A sua referência da API está em [OpenAPI](https://tillor.eu/api/openapi.json).

- **Identidade**: o pedido é executado como o utilizador Fluxo de trabalho da organização. Esse tem todas as permissões dentro dessa organização e em mais nenhuma. As alterações ficam, por isso, em nome de **Fluxo de trabalho**
- **Sem chave necessária**: o Tillor faz a chamada por si próprio, sem chave de API e sem passar pela internet
- **Caminho**: tem de começar com uma única `/`. `//`, `..` e `\` não são permitidos. Uma query string é permitida, por exemplo `/tasks?terrainId=…&limit=1`. As variáveis no caminho são preenchidas codificadas
- **Bloqueado**: os caminhos `/automations` e `/automation-runs` são rejeitados, mesmo com query string, maiúsculas, uma `/` final ou codificação percentual. Uma automatização não pode gerir automatizações
- **Corpo**: JSON, para `POST`, `PUT` e `PATCH`. Em `GET` e `DELETE` não é enviado
- **Menu de escolha**: no editor há **Escolha um endpoint da API** com as operações da especificação OpenAPI. As operações internas não aparecem. Se escolher uma, o Tillor preenche o método, o caminho e um corpo de exemplo
- **Falhas**: uma resposta 2xx continua por **Sucesso**. Um estado de erro, também um 404 para um caminho que não existe, segue por **Falhou**

### A resposta nos passos seguintes [#het-antwoord-in-latere-stappen]

Depois do pedido, estas variáveis estão disponíveis:

| Variável | Conteúdo |
|---|---|
| `{response.status}` | O código de estado HTTP |
| `{response.body}` | Os primeiros 4000 carateres da resposta como texto |
| `{response.data}` | A resposta como JSON. `null` se não for JSON, ou se tiver mais de 100.000 carateres. As listas endereça-as com um índice, por exemplo `{response.data.items.0.id}` |

Um segundo pedido à API no mesmo fluxo substitui `response`. As variáveis funcionam como em [Variáveis e modelos](/automatiseringen/variabelen).

## A estrutura de um fluxo [#de-opbouw-van-een-flow]

Pode também criar e alterar automatizações através da API. As operações estão no [OpenAPI](https://tillor.eu/api/openapi.json), na etiqueta `automations`. Ler exige a permissão `automations:read`, criar e alterar `automations:write` (ou todas as permissões). O próprio utilizador Fluxo de trabalho nunca as pode chamar. Pode ser mais prático construir um fluxo no editor e lê-lo como exemplo.

Uma nova automatização está sempre desativada. Ativá-la através de `enabled` não resulta enquanto o fluxo tiver problemas em aberto, e um fluxo ativado não pode ser guardado com problemas.

A `definition` é composta por passos (`nodes`), linhas (`edges`) e, opcionalmente, notas (`notes`). No máximo 100 passos, 200 linhas e 50 notas.

```json
{
  "nodes": [
    {
      "id": "trigger",
      "type": "trigger",
      "label": "",
      "position": { "x": 0, "y": 0 },
      "config": { "source": "event", "eventKey": "occupation:ended" }
    },
    {
      "id": "task",
      "type": "taskCreate",
      "label": "",
      "position": { "x": 0, "y": 190 },
      "config": { "title": "Controleer {occupation.terrain.name}", "priority": "HIGH" }
    }
  ],
  "edges": [
    { "id": "trigger:out:task", "source": "trigger", "target": "task", "sourceHandle": "out" }
  ],
  "notes": [
    {
      "id": "note_1",
      "text": "Maakt na elk vertrek een controletaak.",
      "position": { "x": 340, "y": 0 },
      "width": 240,
      "height": 140
    }
  ]
}
```

Uma nota (`notes`) é uma explicação no ecrã de desenho. Nunca é executada e não tem linhas. `text` tem no máximo 2000 carateres, `width` e `height` são em píxeis.

Uma linha tem um `sourceHandle`: a saída do passo de onde parte.

| Passo (`type`) | Saídas (`sourceHandle`) |
|---|---|
| `trigger`, `delay`, `waitUntilOpen`, `waitUntilClosed`, `taskCreate`, `taskSetStatus`, `taskSetPriority`, `taskUpdate`, `invoiceReminderSend`, `invoiceSend`, `invoicePrint`, `occupationExtendInvoice`, `staffNotify`, `commentCreate`, `inboxReply`, `inboxTag`, `customerUpdate`, `accessMethodCreate`, `accessMethodUpdate`, `accessMethodSendQr`, `accessPointControl`, `meterSwitch`, `nfcTagUpdate`, `deviceCommand`, `deviceDisplay`, `deviceSlideshow`, `controllerRelay`, `controllerCommand` | `out` |
| `customerMessageSend`, `reservationSetStatus`, `invoiceBook`, `paymentLinkCreate`, `mandateRequest`, `mandateCollect`, `consumptionInvoice` | `out`, `skipped` |
| `condition` | `yes`, `no` |
| `switch` | O `id` de cada ramo, mais `default` |
| `openingHours` | `open`, `closed` |
| `throttle` | `pass`, `blocked` |
| `taskFind`, `documentFind`, `recordLookup` | `found`, `notFound` |
| `forEach` | `each`, `done` |
| `waitUntil` | `met`, `timeout` |
| `waitForEvent` | `received`, `timeout` |
| `approval` | `approved`, `rejected`, `timeout` |
| `webhookSend`, `httpRequest` | `success`, `failed` |

Cada ação, exceto `webhookSend` e `httpRequest`, ganha uma saída extra `error` assim que `continueOnError` no `config` estiver em `true`. Sem essa definição, uma ação falhada pára a execução. Com ela, o fluxo continua por `error`, com `{error.message}` e `{error.step}` como variáveis para os passos seguintes. A saída `skipped` é usada quando um passo não tinha nada a fazer, e `out` é então a saída normal.

Em `forEach`, a saída `each` inicia, por item, uma execução própria para os passos seguintes, e a saída `done` é o caminho normal de continuação do próprio fluxo.

Uma saída pode levar a vários passos. A execução continua por si própria com a primeira linha e inicia, para cada outra linha, uma execução própria com os mesmos dados, que corre em paralelo (como a saída `each` de `forEach`). As linhas que formam um ciclo são rejeitadas no editor. Um fluxo tem exatamente um `trigger`.

### Definições por passo [#instellingen-per-stap]

Os campos em `config` são os campos do editor. Os campos de texto aceitam variáveis entre chavetas.

| Passo | Campos em `config` |
|---|---|
| `trigger` | `source` (`event`, `webhook`, `invoiceOverdue`, `dateReached`, `daily` ou `cron`), `webhookVersion` (em `webhook`: texto, aumente-o para substituir o endereço), `eventKey`, `date` (em `dateReached`: um caminho `record.veld` para uma coluna `DateTime` de um modelo que um evento envia por completo, como `reservation.checkIn` ou `contact.birthday`, ou para uma chave de data declarada numa coluna JSON, como `document.userMetadata.insuranceExpiryDate`; nomes antigos como `reservationCheckIn` continuam a funcionar), `dateOffset` (`{ "amount", "unit" }`), `dateDirection` (`before` ou `after`), `dateTime` (`exact`: a hora na data, ou `fixed`: o dia do calendário da data no fuso horário da organização, com `dateHour` e `dateMinute`, texto como `"9"` e `"0"`; o desvio conta no relógio, ou seja, também através da mudança de hora de verão e inverno), `repeatYearly` (booleano: só contam o dia e o mês, todos os anos), `hour` e `minute` (texto, por exemplo `"8"` e `"0"`, minuto de 0 a 59), `cron` (cinco campos; o dia da semana pode ser `1#2` ou `1L`, um sexto campo `W2:2026-10-05` repete de duas em duas semanas), `conditions`, `oncePerRecord` (booleano) |
| `condition` | `conditions` |
| `switch` | `field` (um caminho de variável sem chavetas), `cases`: uma lista de `{ "id", "key", "value" }` com `key` como nome do ramo e `value` como valor a que o campo tem de ser igual. No máximo 8 ramos |
| `delay` | `mode` (`duration` ou `untilDate`), `duration` e `offset` como `{ "amount", "unit" }` com `unit` igual a `seconds`, `minutes`, `hours`, `days` ou `weeks`, `dateField` (caminho de variável), `direction` (`before` ou `after`) |
| `taskCreate` | `title`, `description`, `assigneeIds`, `labelIds`, `assignActor`, `priority` (`LOW`, `MEDIUM`, `HIGH` ou `URGENT`), `viewId`, `laneId`, `subtasks` (uma por linha), `dueIn` (`{ "amount", "unit" }`), `linkRecords` |
| `taskSetStatus` | `taskId`, `status` (`PENDING`, `IN_PROGRESS`, `WAITING` ou `COMPLETED`) |
| `taskFind` | `title` (título exato), `linkedToRecords`, `onlyOpen`, `onlyTopLevel` (booleanos) |
| `documentFind` | `customerId` (modelo), `documentType` (`INSURANCE_POLICY`, `INSURANCE_PAYMENT_PROOF`, `IDENTITY_CARD`, `SEPA_MANDATE`, `OTHER` ou vazio), `onlyActive`, `onlyValid` (booleanos). Resultado em `foundDocument` |
| `documentUpdate` | `documentId` (modelo), `documentType` (vazio mantém o tipo), `status` (`ACTIVE`, `ARCHIVED` ou vazio) |
| `taskSetPriority` | `taskId`, `mode` (`raise`, `lower` ou `set`), `priority` (em `set`), `maxPriority` (em `raise`) |
| `taskUpdate` | `taskId`, `title`, `assigneeIds`, `assignActor`, `assigneeMode` (`add` ou `replace`), `labelIds`, `dueIn` (`{ "amount", "unit" }` com `unit` igual a `minutes`, `hours`, `days` ou `weeks`) |
| `invoiceReminderSend`, `invoiceSend`, `invoiceBook` | `invoiceId` |
| `invoicePrint` | `invoiceId`, `printer` (`a4`, `pos` ou `tablet`) |
| `paymentLinkCreate` | `invoiceId`, `method` (`any`, `BANCONTACT`, `IDEAL`, `CREDITCARD` ou `PAYCONIQ`) |
| `mandateRequest` | `customerId`, `mode` (`request` ou `reminder`) |
| `mandateCollect` | `invoiceId`, `delayDays` (texto, predefinição `"0"`, no máximo 7) |
| `consumptionInvoice` | `customerId`, `sendEmail`, `sendSms` |
| `occupationExtendInvoice` | `occupationId`, `includeConsumption` |
| `customerMessageSend` | `customerId`, `subject`, `body`, `sendEmail`, `sendSms`, `sendWhatsApp` |
| `staffNotify` | `userIds`, `notifyActor`, `title`, `body`, `sendPush`, `sendEmail` |
| `commentCreate` | `content`, `target` (`event` ou `task`), `taskId` (em `task`) |
| `inboxReply` | `threadId`, `body`, `keepAssistant` |
| `inboxTag` | `threadId`, `tagIds`, `archive` |
| `customerUpdate` | `customerId`, `status` (`keep`, `DEFAULT`, `PREFERRED`, `VIP`, `WARNING` ou `BLACKLISTED`), `notes` |
| `reservationSetStatus` | `reservationId`, `action` (`checkIn`, `checkOut` ou `cancel`) |
| `accessMethodCreate` | `customerId`, `type` (`QR_CODE`, `LPR`, `PIN_CODE` ou `NFC`), `value`, `periodFrom`, `periodTo` (variáveis com uma data, vazio é sem limite) |
| `accessMethodUpdate` | `scope` (`one` ou `customer`), `accessMethodId` (em `one`), `customerId` (em `customer`), `status` (`keep`, `ACTIVE`, `SOFT_BLOCKED`, `BLOCKED` ou `INACTIVE`), `periodTo` |
| `accessMethodSendQr` | `accessMethodId`, `sendEmail`, `sendSms`, `sendWhatsApp`, `print` (`none`, `label` ou `thermal`) |
| `accessPointControl` | `accessPointId`, `action` (`open` ou `close`) |
| `meterSwitch` | `target` (`terrain` ou `meter`), `terrainId` (em `terrain`), `meterId` (em `meter`), `state` (`on` ou `off`) |
| `nfcTagUpdate` | `customerId`, `action` (`block`, `unblock`, `topUp` ou `lowBalance`), `amount` (em `topUp`, em euros por etiqueta) |
| `deviceCommand` | `deviceId`, `command` (`wake`, `sleep`, `reload`, `identify`, `testSound` ou `playSound`), `url` (em `playSound`: o caminho de um som carregado, tal como o editor o preenche, ou uma ligação https para um ficheiro mp3, wav ou m4a) |
| `deviceDisplay` | `kind` (`pdf` ou `image`), `url` (ligação https). Aparece em cada tablet definido como ecrã de apresentação, como um PDF de fatura |
| `controllerRelay` | `target` (`controller` ou `event`: o controlador do evento `controller:input:changed` que iniciou o fluxo), `controllerId` (em `controller`), `relay` (texto `"1"` a `"6"`), `action` (`pulse`, `on` ou `off`), `durationSeconds` (em `pulse`, texto, 0.001 a 3600 com decimais como `"0.5"`; o relé volta a desligar-se sozinho) |
| `controllerCommand` | `target` e `controllerId` como em `controllerRelay`, `command` (`reboot`, `rebootExtension`, `otaUpdate`, `forceOtaUpdate`, `extensionOtaUpdate` ou `refreshSettings`) |
| `deviceSlideshow` | `scope` (`displays` ou `device`), `mode` (`screensaver` ou `background`), `source` (`feed` ou `urls`). Em `feed`: `itemsPath`, `imageField`, campos opcionais de filtro e ordenação |
| `openingHours`, `waitUntilOpen`, `waitUntilClosed` | Sem campos |
| `throttle` | `window` (`{ "amount", "unit" }` com `unit` igual a `minutes`, `hours`, `days` ou `weeks`), `key` (vazio é por registo que iniciou o fluxo) |
| `recordLookup` | `model` (`Customer`, `Reservation`, `Occupation`, `Invoice`, `Payment`, `Terrain`, `Task`, `Document`, `AccessMethod`, `NfcTag`, `Meter`, `InboxThread` ou `InboxMessage`), `recordId`. O resultado fica em `found` mais o modelo, como `foundCustomer` |
| `forEach` | `source` (`customerAccessMethods`, `customerNfcTags`, `customerOpenInvoices`, `customerUpcomingReservations`, `customerOccupations`, `customerDocuments` (apenas `ACTIVE`) ou `terrainMeters`), `parentId` (id do cliente ou do terreno). No máximo 100 itens, o item fica em `item` |
| `waitUntil` | `conditions`, `interval` e `timeout` (`{ "amount", "unit" }` com `unit` igual a `minutes`, `hours`, `days` ou `weeks`; o intervalo é de pelo menos 5 minutos) |
| `waitForEvent` | `eventKey`, `sameRecord` (booleano), `timeout` (`{ "amount", "unit" }`) |
| `approval` | `title`, `description`, `assigneeIds`, `timeout` (`{ "amount", "unit" }`). A tarefa fica em `approvalTask.id` |
| Cada ação, exceto `webhookSend` e `httpRequest` | `continueOnError` (booleano) |
| `webhookSend` | `webhookId`, `event`, `payload` (JSON como texto) |
| `httpRequest` | `target` (`tillor` ou `custom`), `method`, `path` (em `tillor`), `url` (em `custom`), `headers` (lista de `{ "id", "key", "value" }`), `body` (JSON como texto) |

`conditions` tem a forma `{ "match": "all" ou "any", "rules": [...] }`. Cada regra é `{ "id", "field", "operator", "value", "values" }`. `operator` é `is`, `isNot`, `contains`, `greaterThan`, `lessThan`, `isOneOf`, `isEmpty` ou `isNotEmpty`. `values` só se usa em `isOneOf`. Uma lista vazia de regras deixa passar tudo.

## Iniciar uma automatização com um webhook [#een-automatisering-starten-met-een-webhook]

Uma automatização com o trigger `webhook` arranca com um `POST` para o seu próprio endereço:

```bash
curl -X POST "https://tillor.eu/api/orgs/org_abc123/automation-hooks/aut_xxx/<token>?bron=website" \
  -H "Content-Type: application/json" \
  -d '{"email":"jan@voorbeeld.nl","aankomst":"2026-07-14"}'
```

- O endereço completo está no editor, no trigger, ou através de `GET /automations/{id}/webhook-url` (com `automations:read`). O token é o segredo; não é necessário um cabeçalho para autenticação
- O corpo JSON passa a ser a variável `body`, a query string `query` e o momento `receivedAt`
- Responde `200` com `{ "accepted": true }` assim que a execução foi iniciada. Um endereço errado, substituído ou desativado devolve `404`, um corpo acima de 100 KB devolve `400`
- Muitas chamadas seguidas não são rejeitadas: cada chamada válida inicia uma execução. Use **Ignorar repetições** no trigger se a mesma chamada puder chegar duas vezes, veja [Ignorar repetições](/automatiseringen/triggers#herhalingen-negeren)

Uma automatização não pode chamar o seu próprio webhook através de um **Pedido à API** à API do Tillor.

## Escolher uma decisão através da API [#een-beslissing-kiezen-via-de-api]

A tarefa de um passo **Pedir uma decisão** tem uma ação por opção que definiu no passo. Obtenha a tarefa para ver as `actions` com o seu `id` e escolha uma com `POST /tasks/{id}/actions/{actionId}/choose`. Se a opção pedir uma nota, envie-a como `{ "note": "..." }`. A escolha é definitiva: conclui a tarefa e a automatização continua pela saída dessa opção. Os colegas atribuídos (também através de um grupo) e os administradores podem escolher. Veja o [OpenAPI](https://tillor.eu/api/openapi.json) para os detalhes.

## Ler mais [#meer-lezen]

- [Webhooks](/ontwikkelaars/webhooks) para a assinatura, as repetições e a lista de eventos
- [HTTP API](/ontwikkelaars/http) para a autenticação e o contexto da organização
- [Variáveis e modelos](/automatiseringen/variabelen) para a explicação para utilizadores


# Event-index (/pt-PT/ontwikkelaars/events)

{/* Gegenereerd door bun run --cwd apps/next generate:registry uit de realtime.ts-bestanden. Niet met de hand aanpassen. */}

Deze pagina wordt automatisch opgebouwd uit de code: elk event dat Tillor via [SSE](/ontwikkelaars/sse) of [webhooks](/ontwikkelaars/webhooks) verstuurt, staat hier. In de payload hieronder zie je alleen `event` en `data`; `timestamp`, `traceId` en de andere velden van de [envelop](/ontwikkelaars/webhooks#webhook-payload) komen er altijd bij.

De voorbeeldwaarden zijn verzonnen. De velden en hun types komen rechtstreeks uit het datamodel; een event kan extra relaties meesturen die hier niet staan.

Je ontvangt een event alleen als je organisatielid één van de genoemde permissies heeft. Events met "geen webhook" komen te vaak voor om als webhook te versturen; je kunt ze alleen via SSE volgen.

## Overzicht [#overzicht]

| Event | Beschrijving | Permissie | Levering |
|-------|--------------|-----------|----------|
| `*` | Alle events | volledige toegang (`*`) | SSE + webhook |
| [`accessLogEntry:coupled`](#accesslogentry-coupled) | Toegangslogregel gekoppeld | `access-control:read` | SSE + webhook |
| [`accessLogEntry:processed`](#accesslogentry-processed) | Toegangslogregel verwerkt | `access-control:read` | SSE + webhook |
| [`accessMethod:created`](#accessmethod-created) | Toegangsmethode aangemaakt | `access-control:read` | SSE + webhook |
| [`accessMethod:deleted`](#accessmethod-deleted) | Toegangsmethode verwijderd | `access-control:read` | SSE + webhook |
| [`accessMethod:updated`](#accessmethod-updated) | Toegangsmethode gewijzigd | `access-control:read` | SSE + webhook |
| [`accessMethodOperation:created`](#accessmethodoperation-created) | Bewerking op toegangsmethode gestart | `access-control:read` | SSE + webhook |
| [`accessMethodOperation:updated`](#accessmethodoperation-updated) | Bewerking op toegangsmethode gewijzigd | `access-control:read` | SSE + webhook |
| [`accessPoint:created`](#accesspoint-created) | Toegangspunt aangemaakt | `access-control:read` | SSE + webhook |
| [`accessPoint:deleted`](#accesspoint-deleted) | Toegangspunt verwijderd | `access-control:read` | SSE + webhook |
| [`accessPoint:openTooLong`](#accesspoint-opentoolong) | Toegangspunt te lang open | `access-control:access-point-open:alert` | SSE + webhook |
| [`accessPoint:physicalStateChanged`](#accesspoint-physicalstatechanged) |  | `access-control:read` | SSE, geen webhook |
| [`accessPoint:updated`](#accesspoint-updated) | Toegangspunt gewijzigd | `access-control:read` | SSE + webhook |
| [`bankAccountTransaction:imported`](#bankaccounttransaction-imported) | Banktransactie geïmporteerd | `bank-transactions:read` of `bank-transactions:sync` | SSE + webhook |
| [`call:created`](#call-created) | Telefoongesprek gestart | `calls:read` | SSE + webhook |
| [`call:updated`](#call-updated) | Telefoongesprek gewijzigd | `calls:read` | SSE + webhook |
| [`comment:created`](#comment-created) | Opmerking toegevoegd | `comments:read` | SSE + webhook |
| [`comment:deleted`](#comment-deleted) | Opmerking verwijderd | `comments:read` | SSE + webhook |
| [`comment:mentioned`](#comment-mentioned) | Iemand genoemd in een opmerking | `comments:read` | SSE + webhook |
| [`comment:pinned`](#comment-pinned) | Opmerking vastgezet | `comments:read` | SSE + webhook |
| [`comment:resolved`](#comment-resolved) | Opmerking opgelost | `comments:read` | SSE + webhook |
| [`comment:unresolved`](#comment-unresolved) | Opmerking heropend | `comments:read` | SSE + webhook |
| [`comment:updated`](#comment-updated) | Opmerking bewerkt | `comments:read` | SSE + webhook |
| [`controller:adoption:approved`](#controller-adoption-approved) | Adoptie van besturingseenheid goedgekeurd | `controllers:read` | SSE + webhook |
| [`controller:adoption:rejected`](#controller-adoption-rejected) | Adoptie van besturingseenheid afgewezen | `controllers:read` | SSE + webhook |
| [`controller:adoption:requested`](#controller-adoption-requested) | Besturingseenheid vraagt om adoptie | `controllers:read` | SSE + webhook |
| [`controller:created`](#controller-created) | Besturingseenheid aangemaakt | `controllers:read` | SSE + webhook |
| [`controller:deleted`](#controller-deleted) | Besturingseenheid verwijderd | `controllers:read` | SSE + webhook |
| [`controller:input:changed`](#controller-input-changed) | Ingang van controller veranderd | `controllers:read` | SSE + webhook |
| [`controller:io:changed`](#controller-io-changed) |  | `controllers:read` | SSE (`?channel=controller-io`), geen webhook |
| [`controller:logs:submitted`](#controller-logs-submitted) |  | `controllers:logs` | SSE (`?channel=controller-logs`), geen webhook |
| [`controller:updated`](#controller-updated) | Besturingseenheid gewijzigd | `controllers:read` | SSE + webhook |
| [`customEnum:created`](#customenum-created) |  | elk lid | SSE, geen webhook |
| [`customEnum:deleted`](#customenum-deleted) |  | elk lid | SSE, geen webhook |
| [`customEnum:updated`](#customenum-updated) |  | elk lid | SSE, geen webhook |
| [`customer:contact:created`](#customer-contact-created) | Contactpersoon toegevoegd aan een klant | `customers:read` | SSE + webhook |
| [`customer:contact:deleted`](#customer-contact-deleted) | Contactpersoon verwijderd bij een klant | `customers:read` | SSE + webhook |
| [`customer:contact:updated`](#customer-contact-updated) | Contactpersoon van klant gewijzigd | `customers:read` | SSE + webhook |
| [`customer:created`](#customer-created) | Klant aangemaakt | `customers:read` | SSE + webhook |
| [`customer:deleted`](#customer-deleted) | Klant verwijderd | `customers:read` | SSE + webhook |
| [`customer:updated`](#customer-updated) | Klant gewijzigd | `customers:read` | SSE + webhook |
| [`customFieldDefinition:created`](#customfielddefinition-created) |  | elk lid | SSE, geen webhook |
| [`customFieldDefinition:deleted`](#customfielddefinition-deleted) |  | elk lid | SSE, geen webhook |
| [`customFieldDefinition:updated`](#customfielddefinition-updated) |  | elk lid | SSE, geen webhook |
| [`document:created`](#document-created) | Document ontvangen | `documents:read` | SSE + webhook |
| [`document:deleted`](#document-deleted) | Document verwijderd | `documents:read` | SSE + webhook |
| [`document:updated`](#document-updated) | Document gewijzigd | `documents:read` | SSE + webhook |
| [`event-log:created`](#event-log-created) | Gebeurtenis gelogd | `audit-logs:read` | SSE + webhook |
| [`identityDocumentScan:completed`](#identitydocumentscan-completed) | ID-scan voltooid | `identity-document-scans:read` | SSE + webhook |
| [`identityDocumentScan:deleted`](#identitydocumentscan-deleted) | ID-scan verwijderd | `identity-document-scans:read` | SSE + webhook |
| [`identityDocumentScan:linked`](#identitydocumentscan-linked) | ID-scan gekoppeld aan een klant | `identity-document-scans:read` | SSE + webhook |
| [`identityDocumentScan:pendingQueueChanged`](#identitydocumentscan-pendingqueuechanged) | Wachtrij voor ID-scans gewijzigd | `identity-document-scans:read` | SSE + webhook |
| [`identityDocumentScan:unlinked`](#identitydocumentscan-unlinked) | ID-scan ontkoppeld | `identity-document-scans:read` | SSE + webhook |
| [`img:clear-tablet`](#img-clear-tablet) | Afbeelding gewist van een tablet | `native-devices:read` | SSE + webhook |
| [`img:to-tablet`](#img-to-tablet) | Afbeelding naar een tablet gestuurd | `native-devices:read` | SSE + webhook |
| [`inbox:message-created`](#inbox-message-created) | Bericht ontvangen in de inbox | `inbox:read` | SSE + webhook |
| [`inbox:participant-reaction`](#inbox-participant-reaction) | Reactie op een inboxbericht | `inbox:read` | SSE + webhook |
| [`inbox:thread-updated`](#inbox-thread-updated) | Inboxgesprek gewijzigd | `inbox:read` | SSE + webhook |
| [`inbox:typing-changed`](#inbox-typing-changed) |  | `inbox:read` | SSE, geen webhook |
| [`inbox:urgent-handoff`](#inbox-urgent-handoff) | Dringende overdracht door de assistent | `inbox:read` | SSE + webhook |
| [`integration-alarm:created`](#integration-alarm-created) | Meteralarm afgegaan | `meters:read` | SSE + webhook |
| [`integration-alarm:resolved`](#integration-alarm-resolved) | Meteralarm opgelost | `meters:read` | SSE + webhook |
| [`invoice:created`](#invoice-created) | Factuur aangemaakt | `invoices:read` | SSE + webhook |
| [`invoice:deleted`](#invoice-deleted) | Factuur verwijderd | `invoices:read` | SSE + webhook |
| [`invoice:moved-to-customer`](#invoice-moved-to-customer) | Factuur naar een andere klant verplaatst | `invoices:read` | SSE + webhook |
| [`invoice:paid`](#invoice-paid) | Factuur betaald | `invoices:read` | SSE + webhook |
| [`invoice:updated`](#invoice-updated) | Factuur gewijzigd | `invoices:read` | SSE + webhook |
| [`ledgerOpeningBalance:created`](#ledgeropeningbalance-created) | Beginsaldo toegevoegd | `invoices:read` | SSE + webhook |
| [`ledgerOpeningBalance:deleted`](#ledgeropeningbalance-deleted) | Beginsaldo verwijderd | `invoices:read` | SSE + webhook |
| [`ledgerOpeningBalance:updated`](#ledgeropeningbalance-updated) | Beginsaldo gewijzigd | `invoices:read` | SSE + webhook |
| [`mandate-agreement:activated`](#mandate-agreement-activated) | Mandaat actief | `payments:read` | SSE + webhook |
| [`mandate-agreement:expired`](#mandate-agreement-expired) | Mandaataanvraag verlopen | `payments:read` | SSE + webhook |
| [`mandate-agreement:failed`](#mandate-agreement-failed) | Mandaat geweigerd | `payments:read` | SSE + webhook |
| [`mandate-agreement:signed`](#mandate-agreement-signed) | Mandaat ondertekend | `payments:read` | SSE + webhook |
| [`mandate-agreement:updated`](#mandate-agreement-updated) | Mandaataanvraag gewijzigd | `payments:read` | SSE + webhook |
| [`mandate:created`](#mandate-created) | Mandaat aangemaakt | `payments:read` | SSE + webhook |
| [`mandate:deleted`](#mandate-deleted) | Mandaat verwijderd | `payments:read` | SSE + webhook |
| [`mandate:updated`](#mandate-updated) | Mandaat gewijzigd | `payments:read` | SSE + webhook |
| [`meter:created`](#meter-created) | Meter aangemaakt | `meters:read` | SSE + webhook |
| [`meter:updated`](#meter-updated) | Meter gewijzigd | `meters:read` | SSE + webhook |
| [`meterAnomaly:detected`](#meteranomaly-detected) | Meterafwijking vastgesteld | `meters:read` | SSE + webhook |
| [`meterAnomaly:resolved`](#meteranomaly-resolved) | Meterafwijking opgelost | `meters:read` | SSE + webhook |
| [`meterConsumptionBatch:created`](#meterconsumptionbatch-created) | Verbruiksperiode gestart | `meters:read` | SSE + webhook |
| [`meterConsumptionBatch:updated`](#meterconsumptionbatch-updated) | Verbruiksperiode gewijzigd | `meters:read` | SSE + webhook |
| [`meterReading:created`](#meterreading-created) | Meterstand ingevoerd | `meters:read` | SSE + webhook |
| [`meterReading:deleted`](#meterreading-deleted) | Meterstand verwijderd | `meters:read` | SSE + webhook |
| [`meterReading:synced`](#meterreading-synced) | Meterstand gesynchroniseerd | `meters:read` | SSE + webhook |
| [`meterReading:updated`](#meterreading-updated) | Meterstand gewijzigd | `meters:read` | SSE + webhook |
| [`nativeDevice:command`](#nativedevice-command) |  | `native-devices:read` | SSE, geen webhook |
| [`nativeDevice:config`](#nativedevice-config) |  | `native-devices:read` | SSE, geen webhook |
| [`nativeDevice:deleted`](#nativedevice-deleted) | Tablet of kiosk verwijderd | `native-devices:read` | SSE + webhook |
| [`nfc-tag-transaction:changed`](#nfc-tag-transaction-changed) | NFC-tagtransactie gewijzigd | `nfc-tag-transactions:read` | SSE + webhook |
| [`nfc-tag:blocked`](#nfc-tag-blocked) | NFC-tag geblokkeerd | `nfc-tags:read` | SSE + webhook |
| [`nfc-tag:presented`](#nfc-tag-presented) | NFC-tag aangeboden | `nfc-tags:read` | SSE + webhook |
| [`nfc-tag:unblocked`](#nfc-tag-unblocked) | NFC-tag gedeblokkeerd | `nfc-tags:read` | SSE + webhook |
| [`nfc-tag:updated`](#nfc-tag-updated) | NFC-tag gewijzigd | `nfc-tags:read` | SSE + webhook |
| [`notification-delivery:deleted`](#notification-delivery-deleted) | Melding verwijderd | `notifications:deliveries:read` | SSE + webhook |
| [`notification-delivery:updated`](#notification-delivery-updated) | Status van melding gewijzigd | `notifications:deliveries:read` | SSE + webhook |
| [`notificationInbox:created`](#notificationinbox-created) |  | elk lid | SSE, geen webhook |
| [`notificationInbox:read`](#notificationinbox-read) |  | elk lid | SSE, geen webhook |
| [`occupation:ended`](#occupation-ended) | Bezetting beëindigd | `terrains:read` | SSE + webhook |
| [`organizationSettings:updated`](#organizationsettings-updated) | Instellingen gewijzigd | `organization:settings:read` of `organization:settings:write` | SSE + webhook |
| [`payment-group:assigned-to-invoice`](#payment-group-assigned-to-invoice) | Betalingsgroep gekoppeld aan een factuur | `payments:read` | SSE + webhook |
| [`payment-group:created`](#payment-group-created) | Betalingsgroep aangemaakt | `payments:read` | SSE + webhook |
| [`payment-group:deleted`](#payment-group-deleted) | Betalingsgroep verwijderd | `payments:read` | SSE + webhook |
| [`payment-group:payments-added`](#payment-group-payments-added) | Betalingen toegevoegd aan een groep | `payments:read` | SSE + webhook |
| [`payment-group:payments-removed`](#payment-group-payments-removed) | Betalingen verwijderd uit een groep | `payments:read` | SSE + webhook |
| [`payment-group:unassigned-from-invoice`](#payment-group-unassigned-from-invoice) | Betalingsgroep ontkoppeld van een factuur | `payments:read` | SSE + webhook |
| [`payment-group:updated`](#payment-group-updated) | Betalingsgroep gewijzigd | `payments:read` | SSE + webhook |
| [`payment-report:created`](#payment-report-created) | Betalingsrapport aangemaakt | `payment-reports:read` | SSE + webhook |
| [`payment-report:updated`](#payment-report-updated) | Betalingsrapport gewijzigd | `payment-reports:read` | SSE + webhook |
| [`payment:created`](#payment-created) | Betaling aangemaakt | `payments:read` | SSE + webhook |
| [`payment:deleted`](#payment-deleted) | Betaling verwijderd | `payments:read` | SSE + webhook |
| [`payment:updated`](#payment-updated) | Betaling gewijzigd | `payments:read` | SSE + webhook |
| [`pdf:clear-tablet`](#pdf-clear-tablet) | Pdf gewist van een tablet | `native-devices:read` | SSE + webhook |
| [`pdf:to-tablet`](#pdf-to-tablet) | Pdf naar een tablet gestuurd | `native-devices:read` | SSE + webhook |
| [`print-queue-job:updated`](#print-queue-job-updated) | Printopdracht gewijzigd | `printing:read` | SSE + webhook |
| [`product:created`](#product-created) | Product aangemaakt | `products:read` | SSE + webhook |
| [`product:deleted`](#product-deleted) | Product verwijderd | `products:read` | SSE + webhook |
| [`product:updated`](#product-updated) | Product gewijzigd | `products:read` | SSE + webhook |
| [`productPriceChange:applied`](#productpricechange-applied) | Geplande productprijs toegepast | `products:read` | SSE + webhook |
| [`productPriceChange:created`](#productpricechange-created) | Productprijs gepland | `products:read` | SSE + webhook |
| [`productPriceChange:deleted`](#productpricechange-deleted) | Geplande productprijs verwijderd | `products:read` | SSE + webhook |
| [`reservation:created`](#reservation-created) | Reservering aangemaakt | `reservations:read` | SSE + webhook |
| [`reservation:updated`](#reservation-updated) | Reservering gewijzigd | `reservations:read` | SSE + webhook |
| [`sign:clear-tablet`](#sign-clear-tablet) | Ondertekening gewist van een tablet | `native-devices:read` | SSE + webhook |
| [`sign:to-tablet`](#sign-to-tablet) | Ondertekening naar een tablet gestuurd | `native-devices:read` | SSE + webhook |
| [`signatureRequest:completed`](#signaturerequest-completed) | Ondertekenverzoek afgerond | `signature-requests:read` | SSE + webhook |
| [`signatureRequest:deleted`](#signaturerequest-deleted) | Ondertekenverzoek verwijderd | `signature-requests:read` | SSE + webhook |
| [`signatureRequest:updated`](#signaturerequest-updated) | Ondertekenverzoek gewijzigd | `signature-requests:read` | SSE + webhook |
| [`task-time-tracker:changed`](#task-time-tracker-changed) |  | `tasks:read` | SSE, geen webhook |
| [`task-view:created`](#task-view-created) | Takenweergave aangemaakt | `tasks:read` | SSE + webhook |
| [`task-view:deleted`](#task-view-deleted) | Takenweergave verwijderd | `tasks:read` | SSE + webhook |
| [`task-view:membership-changed`](#task-view-membership-changed) | Taken in een weergave gewijzigd | `tasks:read` | SSE + webhook |
| [`task-view:updated`](#task-view-updated) | Takenweergave gewijzigd | `tasks:read` | SSE + webhook |
| [`task:action-chosen`](#task-action-chosen) | Taakactie gekozen | `tasks:read` | SSE + webhook |
| [`task:assigned`](#task-assigned) | Taak toegewezen | `tasks:read` | SSE + webhook |
| [`task:created`](#task-created) | Taak aangemaakt | `tasks:read` | SSE + webhook |
| [`task:deleted`](#task-deleted) | Taak verwijderd | `tasks:read` | SSE + webhook |
| [`task:status-changed`](#task-status-changed) | Taakstatus gewijzigd | `tasks:read` | SSE + webhook |
| [`task:unassigned`](#task-unassigned) | Taaktoewijzing opgeheven | `tasks:read` | SSE + webhook |
| [`task:updated`](#task-updated) | Taak gewijzigd | `tasks:read` | SSE + webhook |
| [`terrain:updated`](#terrain-updated) | Terrein gewijzigd | `terrains:read` | SSE + webhook |
| [`vehiclePresence:updated`](#vehiclepresence-updated) |  | `access-control:read` | SSE, geen webhook |

## accessLogEntry [#accesslogentry]

### `accessLogEntry:coupled` [#accesslogentry-coupled]

Toegangslogregel gekoppeld.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessLogEntry:coupled",
  "data": {
    "nfcQrEntryId": "cm4k7x2pq0001abcd1234efgh",
    "lprEntryId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `accessLogEntry:processed` [#accesslogentry-processed]

Toegangslogregel verwerkt.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessLogEntry:processed",
  "data": {
    "organizationId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## accessMethod [#accessmethod]

### `accessMethod:created` [#accessmethod-created]

Toegangsmethode aangemaakt.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessMethod:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "type": "NFC",
    "value": "Voorbeeld",
    "status": "BLOCKED",
    "brand": "Voorbeeld",
    "color": "Voorbeeld",
    "model": "Voorbeeld",
    "periodFrom": "2026-01-15T09:30:00.000Z",
    "periodTo": "2026-01-15T09:30:00.000Z",
    "comments": "Voorbeeld",
    "doNotAutoExtend": false,
    "autoConvertToLpr": false,
    "metadata": {},
    "customFields": {},
    "lastSyncedAt": "2026-01-15T09:30:00.000Z",
    "lastAccessLogEntryId": "cm4k7x2pq0001abcd1234efgh",
    "lastAccessLogAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `accessMethod:deleted` [#accessmethod-deleted]

Toegangsmethode verwijderd.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessMethod:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "type": "NFC",
    "value": "Voorbeeld",
    "status": "BLOCKED",
    "brand": "Voorbeeld",
    "color": "Voorbeeld",
    "model": "Voorbeeld",
    "periodFrom": "2026-01-15T09:30:00.000Z",
    "periodTo": "2026-01-15T09:30:00.000Z",
    "comments": "Voorbeeld",
    "doNotAutoExtend": false,
    "autoConvertToLpr": false,
    "metadata": {},
    "customFields": {},
    "lastSyncedAt": "2026-01-15T09:30:00.000Z",
    "lastAccessLogEntryId": "cm4k7x2pq0001abcd1234efgh",
    "lastAccessLogAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `accessMethod:updated` [#accessmethod-updated]

Toegangsmethode gewijzigd.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessMethod:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "type": "NFC",
    "value": "Voorbeeld",
    "status": "BLOCKED",
    "brand": "Voorbeeld",
    "color": "Voorbeeld",
    "model": "Voorbeeld",
    "periodFrom": "2026-01-15T09:30:00.000Z",
    "periodTo": "2026-01-15T09:30:00.000Z",
    "comments": "Voorbeeld",
    "doNotAutoExtend": false,
    "autoConvertToLpr": false,
    "metadata": {},
    "customFields": {},
    "lastSyncedAt": "2026-01-15T09:30:00.000Z",
    "lastAccessLogEntryId": "cm4k7x2pq0001abcd1234efgh",
    "lastAccessLogAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## accessMethodOperation [#accessmethodoperation]

### `accessMethodOperation:created` [#accessmethodoperation-created]

Bewerking op toegangsmethode gestart.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `accessMethodOperation:updated` [#accessmethodoperation-updated]

Bewerking op toegangsmethode gewijzigd.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessMethodOperation:updated",
  "data": {
    "operationId": "cm4k7x2pq0001abcd1234efgh",
    "status": "Voorbeeld"
  }
}
```

</Accordion>
</Accordions>

## accessPoint [#accesspoint]

### `accessPoint:created` [#accesspoint-created]

Toegangspunt aangemaakt.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessPoint:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "type": "ENTRANCE",
    "actuatorType": "CONNECTOR",
    "openConfig": {},
    "closeConfig": {},
    "dialPinCodes": {},
    "isActive": false,
    "description": "Voorbeeld",
    "physicalState": "OPEN",
    "physicalStateChangedAt": "2026-01-15T09:30:00.000Z",
    "lastLprHeartbeatAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `accessPoint:deleted` [#accesspoint-deleted]

Toegangspunt verwijderd.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessPoint:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "type": "ENTRANCE",
    "actuatorType": "CONNECTOR",
    "openConfig": {},
    "closeConfig": {},
    "dialPinCodes": {},
    "isActive": false,
    "description": "Voorbeeld",
    "physicalState": "OPEN",
    "physicalStateChangedAt": "2026-01-15T09:30:00.000Z",
    "lastLprHeartbeatAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `accessPoint:openTooLong` [#accesspoint-opentoolong]

Toegangspunt te lang open.

- **Permissie:** `access-control:access-point-open:alert`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessPoint:openTooLong",
  "data": {
    "accessPointId": "cm4k7x2pq0001abcd1234efgh",
    "accessPointName": "Voorbeeld",
    "openSince": "2026-01-15T09:30:00.000Z",
    "afterMinutes": 12.5
  }
}
```

</Accordion>
</Accordions>

### `accessPoint:physicalStateChanged` [#accesspoint-physicalstatechanged]

- **Permissie:** `access-control:read`
- **Levering:** SSE, geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessPoint:physicalStateChanged",
  "data": {
    "accessPointId": "cm4k7x2pq0001abcd1234efgh",
    "state": "OPEN",
    "previousState": "OPEN",
    "changedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `accessPoint:updated` [#accesspoint-updated]

Toegangspunt gewijzigd.

- **Permissie:** `access-control:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "accessPoint:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "type": "ENTRANCE",
    "actuatorType": "CONNECTOR",
    "openConfig": {},
    "closeConfig": {},
    "dialPinCodes": {},
    "isActive": false,
    "description": "Voorbeeld",
    "physicalState": "OPEN",
    "physicalStateChangedAt": "2026-01-15T09:30:00.000Z",
    "lastLprHeartbeatAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## bankAccountTransaction [#bankaccounttransaction]

### `bankAccountTransaction:imported` [#bankaccounttransaction-imported]

Banktransactie geïmporteerd.

- **Permissie:** `bank-transactions:read` of `bank-transactions:sync`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "bankAccountTransaction:imported",
  "data": {
    "transactionsProcessed": 12.5,
    "accountsProcessed": 12.5
  }
}
```

</Accordion>
</Accordions>

## call [#call]

### `call:created` [#call-created]

Telefoongesprek gestart.

- **Permissie:** `calls:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "call:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "externalId": "cm4k7x2pq0001abcd1234efgh",
    "to": "Voorbeeld",
    "from": "Voorbeeld",
    "state": "CREATED",
    "direction": "INBOUND",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "contactId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "duration": 1,
    "recordingS3Path": "Voorbeeld",
    "recordingStatus": "PENDING",
    "maybeCallerName": "Voorbeeld",
    "currentTranscriptionId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `call:updated` [#call-updated]

Telefoongesprek gewijzigd.

- **Permissie:** `calls:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "call:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "externalId": "cm4k7x2pq0001abcd1234efgh",
    "to": "Voorbeeld",
    "from": "Voorbeeld",
    "state": "CREATED",
    "direction": "INBOUND",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "contactId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "duration": 1,
    "recordingS3Path": "Voorbeeld",
    "recordingStatus": "PENDING",
    "maybeCallerName": "Voorbeeld",
    "currentTranscriptionId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## comment [#comment]

### `comment:created` [#comment-created]

Opmerking toegevoegd.

- **Permissie:** `comments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "comment:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "content": "Voorbeeld",
    "sanitizedContent": "Voorbeeld",
    "pinned": false,
    "inboundEmailId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "resolvedAt": "2026-01-15T09:30:00.000Z",
    "resolvedById": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `comment:deleted` [#comment-deleted]

Opmerking verwijderd.

- **Permissie:** `comments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "comment:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "content": "Voorbeeld",
    "sanitizedContent": "Voorbeeld",
    "pinned": false,
    "inboundEmailId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "resolvedAt": "2026-01-15T09:30:00.000Z",
    "resolvedById": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `comment:mentioned` [#comment-mentioned]

Iemand genoemd in een opmerking.

- **Permissie:** `comments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "comment:mentioned",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "content": "Voorbeeld",
    "sanitizedContent": "Voorbeeld",
    "pinned": false,
    "inboundEmailId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "resolvedAt": "2026-01-15T09:30:00.000Z",
    "resolvedById": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `comment:pinned` [#comment-pinned]

Opmerking vastgezet.

- **Permissie:** `comments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "comment:pinned",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "content": "Voorbeeld",
    "sanitizedContent": "Voorbeeld",
    "pinned": false,
    "inboundEmailId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "resolvedAt": "2026-01-15T09:30:00.000Z",
    "resolvedById": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `comment:resolved` [#comment-resolved]

Opmerking opgelost.

- **Permissie:** `comments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "comment:resolved",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "content": "Voorbeeld",
    "sanitizedContent": "Voorbeeld",
    "pinned": false,
    "inboundEmailId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "resolvedAt": "2026-01-15T09:30:00.000Z",
    "resolvedById": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `comment:unresolved` [#comment-unresolved]

Opmerking heropend.

- **Permissie:** `comments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "comment:unresolved",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "content": "Voorbeeld",
    "sanitizedContent": "Voorbeeld",
    "pinned": false,
    "inboundEmailId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "resolvedAt": "2026-01-15T09:30:00.000Z",
    "resolvedById": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `comment:updated` [#comment-updated]

Opmerking bewerkt.

- **Permissie:** `comments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "comment:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "content": "Voorbeeld",
    "sanitizedContent": "Voorbeeld",
    "pinned": false,
    "inboundEmailId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "resolvedAt": "2026-01-15T09:30:00.000Z",
    "resolvedById": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## controller [#controller]

### `controller:adoption:approved` [#controller-adoption-approved]

Adoptie van besturingseenheid goedgekeurd.

- **Permissie:** `controllers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:adoption:approved",
  "data": {
    "adoptionId": "cm4k7x2pq0001abcd1234efgh",
    "controllerId": "cm4k7x2pq0001abcd1234efgh",
    "efuseId": "cm4k7x2pq0001abcd1234efgh",
    "organizationId": "cm4k7x2pq0001abcd1234efgh",
    "takeover": false
  }
}
```

</Accordion>
</Accordions>

### `controller:adoption:rejected` [#controller-adoption-rejected]

Adoptie van besturingseenheid afgewezen.

- **Permissie:** `controllers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:adoption:rejected",
  "data": {
    "adoptionId": "cm4k7x2pq0001abcd1234efgh",
    "efuseId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `controller:adoption:requested` [#controller-adoption-requested]

Besturingseenheid vraagt om adoptie.

- **Permissie:** `controllers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:adoption:requested",
  "data": {
    "adoptionId": "cm4k7x2pq0001abcd1234efgh",
    "efuseId": "cm4k7x2pq0001abcd1234efgh",
    "requestedFromIp": "Voorbeeld",
    "isNew": false
  }
}
```

</Accordion>
</Accordions>

### `controller:created` [#controller-created]

Besturingseenheid aangemaakt.

- **Permissie:** `controllers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "efuseId": "cm4k7x2pq0001abcd1234efgh",
    "publicKeyPem": "Voorbeeld",
    "model": "Voorbeeld",
    "type": "ACCESS",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "lastSeenAt": "2026-01-15T09:30:00.000Z",
    "lastSyncAt": "2026-01-15T09:30:00.000Z",
    "version": "Voorbeeld",
    "metadata": {},
    "commandManifest": {},
    "controllerGroupId": "cm4k7x2pq0001abcd1234efgh",
    "controllerSettingsId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `controller:deleted` [#controller-deleted]

Besturingseenheid verwijderd.

- **Permissie:** `controllers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "efuseId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `controller:input:changed` [#controller-input-changed]

Ingang van controller veranderd.

- **Permissie:** `controllers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:input:changed",
  "data": {
    "controller": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "efuseId": "cm4k7x2pq0001abcd1234efgh",
      "publicKeyPem": "Voorbeeld",
      "model": "Voorbeeld",
      "type": "ACCESS",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "lastSeenAt": "2026-01-15T09:30:00.000Z",
      "lastSyncAt": "2026-01-15T09:30:00.000Z",
      "version": "Voorbeeld",
      "metadata": {},
      "commandManifest": {},
      "controllerGroupId": "cm4k7x2pq0001abcd1234efgh",
      "controllerSettingsId": "cm4k7x2pq0001abcd1234efgh"
    },
    "input": 12.5,
    "active": false
  }
}
```

</Accordion>
</Accordions>

### `controller:io:changed` [#controller-io-changed]

- **Permissie:** `controllers:read`
- **Levering:** SSE (`?channel=controller-io`), geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:io:changed",
  "data": {
    "controllerId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `controller:logs:submitted` [#controller-logs-submitted]

- **Permissie:** `controllers:logs`
- **Levering:** SSE (`?channel=controller-logs`), geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:logs:submitted",
  "data": {
    "controllerId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `controller:updated` [#controller-updated]

Besturingseenheid gewijzigd.

- **Permissie:** `controllers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "controller:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "efuseId": "cm4k7x2pq0001abcd1234efgh",
    "publicKeyPem": "Voorbeeld",
    "model": "Voorbeeld",
    "type": "ACCESS",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "lastSeenAt": "2026-01-15T09:30:00.000Z",
    "lastSyncAt": "2026-01-15T09:30:00.000Z",
    "version": "Voorbeeld",
    "metadata": {},
    "commandManifest": {},
    "controllerGroupId": "cm4k7x2pq0001abcd1234efgh",
    "controllerSettingsId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## customEnum [#customenum]

### `customEnum:created` [#customenum-created]

- **Permissie:** elk lid
- **Levering:** SSE, geen webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `customEnum:deleted` [#customenum-deleted]

- **Permissie:** elk lid
- **Levering:** SSE, geen webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `customEnum:updated` [#customenum-updated]

- **Permissie:** elk lid
- **Levering:** SSE, geen webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

## customer [#customer]

### `customer:contact:created` [#customer-contact-created]

Contactpersoon toegevoegd aan een klant.

- **Permissie:** `customers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "customer:contact:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "firstName": "Voorbeeld",
    "lastName": "Voorbeeld",
    "email": "gast@example.com",
    "phone": "+32470123456",
    "relation": "SPOUSE",
    "relationOther": "Voorbeeld",
    "birthday": "2026-01-15T09:30:00.000Z",
    "address": "Voorbeeld",
    "birthplace": "Voorbeeld",
    "profession": "Voorbeeld",
    "personalNumber": "Voorbeeld",
    "comments": "Voorbeeld",
    "isEmergencyContact": false,
    "mentionOnInvoice": false,
    "locale": "nl",
    "country": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `customer:contact:deleted` [#customer-contact-deleted]

Contactpersoon verwijderd bij een klant.

- **Permissie:** `customers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "customer:contact:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "firstName": "Voorbeeld",
    "lastName": "Voorbeeld",
    "email": "gast@example.com",
    "phone": "+32470123456",
    "relation": "SPOUSE",
    "relationOther": "Voorbeeld",
    "birthday": "2026-01-15T09:30:00.000Z",
    "address": "Voorbeeld",
    "birthplace": "Voorbeeld",
    "profession": "Voorbeeld",
    "personalNumber": "Voorbeeld",
    "comments": "Voorbeeld",
    "isEmergencyContact": false,
    "mentionOnInvoice": false,
    "locale": "nl",
    "country": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `customer:contact:updated` [#customer-contact-updated]

Contactpersoon van klant gewijzigd.

- **Permissie:** `customers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "customer:contact:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "firstName": "Voorbeeld",
    "lastName": "Voorbeeld",
    "email": "gast@example.com",
    "phone": "+32470123456",
    "relation": "SPOUSE",
    "relationOther": "Voorbeeld",
    "birthday": "2026-01-15T09:30:00.000Z",
    "address": "Voorbeeld",
    "birthplace": "Voorbeeld",
    "profession": "Voorbeeld",
    "personalNumber": "Voorbeeld",
    "comments": "Voorbeeld",
    "isEmergencyContact": false,
    "mentionOnInvoice": false,
    "locale": "nl",
    "country": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `customer:created` [#customer-created]

Klant aangemaakt.

- **Permissie:** `customers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "customer:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": 1,
    "firstName": "Voorbeeld",
    "lastName": "Voorbeeld",
    "email": "gast@example.com",
    "phone": "+32470123456",
    "address": "Voorbeeld",
    "city": "Voorbeeld",
    "state": "Voorbeeld",
    "zipCode": "Voorbeeld",
    "country": "Voorbeeld",
    "vatNumber": "Voorbeeld",
    "notes": "Voorbeeld",
    "birthday": "2026-01-15T09:30:00.000Z",
    "birthplace": "Voorbeeld",
    "profession": "Voorbeeld",
    "personalNumber": "Voorbeeld",
    "customerType": "STANDARD",
    "status": "DEFAULT",
    "metadata": {},
    "customFields": {},
    "locale": "nl",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "consentToCommunications": false,
    "consentToMarketing": false
  }
}
```

</Accordion>
</Accordions>

### `customer:deleted` [#customer-deleted]

Klant verwijderd.

- **Permissie:** `customers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "customer:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": 1,
    "firstName": "Voorbeeld",
    "lastName": "Voorbeeld",
    "email": "gast@example.com",
    "phone": "+32470123456",
    "address": "Voorbeeld",
    "city": "Voorbeeld",
    "state": "Voorbeeld",
    "zipCode": "Voorbeeld",
    "country": "Voorbeeld",
    "vatNumber": "Voorbeeld",
    "notes": "Voorbeeld",
    "birthday": "2026-01-15T09:30:00.000Z",
    "birthplace": "Voorbeeld",
    "profession": "Voorbeeld",
    "personalNumber": "Voorbeeld",
    "customerType": "STANDARD",
    "status": "DEFAULT",
    "metadata": {},
    "customFields": {},
    "locale": "nl",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "consentToCommunications": false,
    "consentToMarketing": false
  }
}
```

</Accordion>
</Accordions>

### `customer:updated` [#customer-updated]

Klant gewijzigd.

- **Permissie:** `customers:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "customer:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": 1,
    "firstName": "Voorbeeld",
    "lastName": "Voorbeeld",
    "email": "gast@example.com",
    "phone": "+32470123456",
    "address": "Voorbeeld",
    "city": "Voorbeeld",
    "state": "Voorbeeld",
    "zipCode": "Voorbeeld",
    "country": "Voorbeeld",
    "vatNumber": "Voorbeeld",
    "notes": "Voorbeeld",
    "birthday": "2026-01-15T09:30:00.000Z",
    "birthplace": "Voorbeeld",
    "profession": "Voorbeeld",
    "personalNumber": "Voorbeeld",
    "customerType": "STANDARD",
    "status": "DEFAULT",
    "metadata": {},
    "customFields": {},
    "locale": "nl",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "consentToCommunications": false,
    "consentToMarketing": false
  }
}
```

</Accordion>
</Accordions>

## customFieldDefinition [#customfielddefinition]

### `customFieldDefinition:created` [#customfielddefinition-created]

- **Permissie:** elk lid
- **Levering:** SSE, geen webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `customFieldDefinition:deleted` [#customfielddefinition-deleted]

- **Permissie:** elk lid
- **Levering:** SSE, geen webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `customFieldDefinition:updated` [#customfielddefinition-updated]

- **Permissie:** elk lid
- **Levering:** SSE, geen webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

## document [#document]

### `document:created` [#document-created]

Document ontvangen.

- **Permissie:** `documents:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "document:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "status": "ACTIVE",
    "userMetadata": {},
    "customFields": {},
    "externalId": "cm4k7x2pq0001abcd1234efgh",
    "source": "Voorbeeld",
    "key": "Voorbeeld",
    "previewKey": "Voorbeeld",
    "storageClass": "Voorbeeld",
    "versionId": "cm4k7x2pq0001abcd1234efgh",
    "contentType": "Voorbeeld",
    "size": "Voorbeeld",
    "etag": "Voorbeeld",
    "sha256": "Voorbeeld",
    "filename": "Voorbeeld",
    "extension": "Voorbeeld",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "metadata": {}
  }
}
```

</Accordion>
</Accordions>

### `document:deleted` [#document-deleted]

Document verwijderd.

- **Permissie:** `documents:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "document:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "status": "ACTIVE",
    "userMetadata": {},
    "customFields": {},
    "externalId": "cm4k7x2pq0001abcd1234efgh",
    "source": "Voorbeeld",
    "key": "Voorbeeld",
    "previewKey": "Voorbeeld",
    "storageClass": "Voorbeeld",
    "versionId": "cm4k7x2pq0001abcd1234efgh",
    "contentType": "Voorbeeld",
    "size": "Voorbeeld",
    "etag": "Voorbeeld",
    "sha256": "Voorbeeld",
    "filename": "Voorbeeld",
    "extension": "Voorbeeld",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "metadata": {}
  }
}
```

</Accordion>
</Accordions>

### `document:updated` [#document-updated]

Document gewijzigd.

- **Permissie:** `documents:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "document:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "status": "ACTIVE",
    "userMetadata": {},
    "customFields": {},
    "externalId": "cm4k7x2pq0001abcd1234efgh",
    "source": "Voorbeeld",
    "key": "Voorbeeld",
    "previewKey": "Voorbeeld",
    "storageClass": "Voorbeeld",
    "versionId": "cm4k7x2pq0001abcd1234efgh",
    "contentType": "Voorbeeld",
    "size": "Voorbeeld",
    "etag": "Voorbeeld",
    "sha256": "Voorbeeld",
    "filename": "Voorbeeld",
    "extension": "Voorbeeld",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "metadata": {}
  }
}
```

</Accordion>
</Accordions>

## event-log [#event-log]

### `event-log:created` [#event-log-created]

Gebeurtenis gelogd.

- **Permissie:** `audit-logs:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "event-log:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "type": "INVOICE_CREATED",
    "metadata": {},
    "translationKey": "Voorbeeld",
    "translationData": {},
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "triggeredById": "cm4k7x2pq0001abcd1234efgh",
    "userId": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "occupationId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "meterReadingId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "productId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "commentId": "cm4k7x2pq0001abcd1234efgh",
    "organizationSettingsId": "cm4k7x2pq0001abcd1234efgh",
    "organizationMembershipId": "cm4k7x2pq0001abcd1234efgh",
    "nativeDeviceId": "cm4k7x2pq0001abcd1234efgh",
    "oauthClientId": "cm4k7x2pq0001abcd1234efgh",
    "oauthConsentId": "cm4k7x2pq0001abcd1234efgh",
    "accessMethodId": "cm4k7x2pq0001abcd1234efgh",
    "contactId": "cm4k7x2pq0001abcd1234efgh",
    "customerInvoicingSettingsId": "cm4k7x2pq0001abcd1234efgh",
    "nfcTagId": "cm4k7x2pq0001abcd1234efgh",
    "identityDocumentScanId": "cm4k7x2pq0001abcd1234efgh",
    "documentId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "signatureRequestId": "cm4k7x2pq0001abcd1234efgh",
    "paymentGroupId": "cm4k7x2pq0001abcd1234efgh",
    "controllerId": "cm4k7x2pq0001abcd1234efgh",
    "accessPointId": "cm4k7x2pq0001abcd1234efgh",
    "accessControllerId": "cm4k7x2pq0001abcd1234efgh",
    "organizationId": "cm4k7x2pq0001abcd1234efgh",
    "organizationInvitationId": "cm4k7x2pq0001abcd1234efgh",
    "apiKeyId": "cm4k7x2pq0001abcd1234efgh",
    "integrationInstallationId": "cm4k7x2pq0001abcd1234efgh",
    "dpaAcceptanceId": "cm4k7x2pq0001abcd1234efgh",
    "webhookId": "cm4k7x2pq0001abcd1234efgh",
    "automationId": "cm4k7x2pq0001abcd1234efgh",
    "staffGroupId": "cm4k7x2pq0001abcd1234efgh",
    "terrainTypeId": "cm4k7x2pq0001abcd1234efgh",
    "meterCabinetId": "cm4k7x2pq0001abcd1234efgh",
    "controllerGroupId": "cm4k7x2pq0001abcd1234efgh",
    "customFieldDefinitionId": "cm4k7x2pq0001abcd1234efgh",
    "customEnumId": "cm4k7x2pq0001abcd1234efgh",
    "customerCommunicationSettingsId": "cm4k7x2pq0001abcd1234efgh",
    "taskLabelId": "cm4k7x2pq0001abcd1234efgh",
    "inboxTagId": "cm4k7x2pq0001abcd1234efgh",
    "taskViewId": "cm4k7x2pq0001abcd1234efgh",
    "customerLedgerOpeningBalanceId": "cm4k7x2pq0001abcd1234efgh",
    "auditLogId": "cm4k7x2pq0001abcd1234efgh",
    "actorKind": "USER",
    "actorApiKeyId": "cm4k7x2pq0001abcd1234efgh",
    "actorOauthClientId": "cm4k7x2pq0001abcd1234efgh",
    "actorImpersonatedById": "cm4k7x2pq0001abcd1234efgh",
    "originKind": "Voorbeeld",
    "originId": "cm4k7x2pq0001abcd1234efgh",
    "ipAddress": "Voorbeeld",
    "userAgent": "Voorbeeld",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## identityDocumentScan [#identitydocumentscan]

### `identityDocumentScan:completed` [#identitydocumentscan-completed]

ID-scan voltooid.

- **Permissie:** `identity-document-scans:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `identityDocumentScan:deleted` [#identitydocumentscan-deleted]

ID-scan verwijderd.

- **Permissie:** `identity-document-scans:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "identityDocumentScan:deleted",
  "data": {
    "scanId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `identityDocumentScan:linked` [#identitydocumentscan-linked]

ID-scan gekoppeld aan een klant.

- **Permissie:** `identity-document-scans:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "identityDocumentScan:linked",
  "data": {
    "scanId": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "contactId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `identityDocumentScan:pendingQueueChanged` [#identitydocumentscan-pendingqueuechanged]

Wachtrij voor ID-scans gewijzigd.

- **Permissie:** `identity-document-scans:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `identityDocumentScan:unlinked` [#identitydocumentscan-unlinked]

ID-scan ontkoppeld.

- **Permissie:** `identity-document-scans:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "identityDocumentScan:unlinked",
  "data": {
    "scanId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## img [#img]

### `img:clear-tablet` [#img-clear-tablet]

Afbeelding gewist van een tablet.

- **Permissie:** `native-devices:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `img:to-tablet` [#img-to-tablet]

Afbeelding naar een tablet gestuurd.

- **Permissie:** `native-devices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "img:to-tablet",
  "data": {
    "imageUrl": "https://example.com"
  }
}
```

</Accordion>
</Accordions>

## inbox [#inbox]

### `inbox:message-created` [#inbox-message-created]

Bericht ontvangen in de inbox.

- **Permissie:** `inbox:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "inbox:message-created",
  "data": {
    "threadId": "cm4k7x2pq0001abcd1234efgh",
    "messageId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `inbox:participant-reaction` [#inbox-participant-reaction]

Reactie op een inboxbericht.

- **Permissie:** `inbox:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "inbox:participant-reaction",
  "data": {
    "threadId": "cm4k7x2pq0001abcd1234efgh",
    "emoji": "Voorbeeld"
  }
}
```

</Accordion>
</Accordions>

### `inbox:thread-updated` [#inbox-thread-updated]

Inboxgesprek gewijzigd.

- **Permissie:** `inbox:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "inbox:thread-updated",
  "data": {
    "threadId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `inbox:typing-changed` [#inbox-typing-changed]

- **Permissie:** `inbox:read`
- **Levering:** SSE, geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "inbox:typing-changed",
  "data": {
    "threadId": "cm4k7x2pq0001abcd1234efgh",
    "participantTyping": false,
    "staffTyping": false
  }
}
```

</Accordion>
</Accordions>

### `inbox:urgent-handoff` [#inbox-urgent-handoff]

Dringende overdracht door de assistent.

- **Permissie:** `inbox:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "inbox:urgent-handoff",
  "data": {
    "threadId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## integration-alarm [#integration-alarm]

### `integration-alarm:created` [#integration-alarm-created]

Meteralarm afgegaan.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "integration-alarm:created",
  "data": {
    "meter": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "serial": "Voorbeeld",
      "type": "ELECTRICITY",
      "provider": "MANUAL",
      "customFields": {},
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "terrainId": "cm4k7x2pq0001abcd1234efgh",
      "lastReadingId": "cm4k7x2pq0001abcd1234efgh",
      "manualMetadata": {},
      "meterCabinetId": "cm4k7x2pq0001abcd1234efgh"
    },
    "alarm": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "externalId": "cm4k7x2pq0001abcd1234efgh",
      "message": "Voorbeeld",
      "startedAt": "2026-01-15T09:30:00.000Z",
      "resolvedAt": "2026-01-15T09:30:00.000Z",
      "metadata": {},
      "meterId": "cm4k7x2pq0001abcd1234efgh",
      "icyControllerId": "cm4k7x2pq0001abcd1234efgh",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z"
    }
  }
}
```

</Accordion>
</Accordions>

### `integration-alarm:resolved` [#integration-alarm-resolved]

Meteralarm opgelost.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "integration-alarm:resolved",
  "data": {
    "meter": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "serial": "Voorbeeld",
      "type": "ELECTRICITY",
      "provider": "MANUAL",
      "customFields": {},
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "terrainId": "cm4k7x2pq0001abcd1234efgh",
      "lastReadingId": "cm4k7x2pq0001abcd1234efgh",
      "manualMetadata": {},
      "meterCabinetId": "cm4k7x2pq0001abcd1234efgh"
    },
    "alarm": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "externalId": "cm4k7x2pq0001abcd1234efgh",
      "message": "Voorbeeld",
      "startedAt": "2026-01-15T09:30:00.000Z",
      "resolvedAt": "2026-01-15T09:30:00.000Z",
      "metadata": {},
      "meterId": "cm4k7x2pq0001abcd1234efgh",
      "icyControllerId": "cm4k7x2pq0001abcd1234efgh",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z"
    }
  }
}
```

</Accordion>
</Accordions>

## invoice [#invoice]

### `invoice:created` [#invoice-created]

Factuur aangemaakt.

- **Permissie:** `invoices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "invoice:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": "2026-00123",
    "status": "DRAFT",
    "type": "INVOICE",
    "paymentStatus": "UNPAID",
    "invoiceDate": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "paidDate": "2026-01-15T09:30:00.000Z",
    "amountSubtotal": 12.5,
    "amountTax": 12.5,
    "amountPaid": 12.5,
    "amountTotal": 12.5,
    "amountOutstanding": 12.5,
    "note": "Voorbeeld",
    "internalNote": "Voorbeeld",
    "currency": "EUR",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "structuredCommunication": "Voorbeeld",
    "originalDisplayId": "2026-00123",
    "reversedFromInvoiceId": "cm4k7x2pq0001abcd1234efgh",
    "bookedById": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "mandateCollectionScheduledAt": "2026-01-15T09:30:00.000Z",
    "excludeFromAutomatedReminders": false,
    "excludeFromAutomatedRemindersUntil": "2026-01-15T09:30:00.000Z",
    "peppolProvider": "SCRADA",
    "peppolDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "peppolUblFolder": "Voorbeeld",
    "peppolUblKey": "Voorbeeld"
  }
}
```

</Accordion>
</Accordions>

### `invoice:deleted` [#invoice-deleted]

Factuur verwijderd.

- **Permissie:** `invoices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "invoice:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": "2026-00123",
    "status": "DRAFT",
    "type": "INVOICE",
    "paymentStatus": "UNPAID",
    "invoiceDate": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "paidDate": "2026-01-15T09:30:00.000Z",
    "amountSubtotal": 12.5,
    "amountTax": 12.5,
    "amountPaid": 12.5,
    "amountTotal": 12.5,
    "amountOutstanding": 12.5,
    "note": "Voorbeeld",
    "internalNote": "Voorbeeld",
    "currency": "EUR",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "structuredCommunication": "Voorbeeld",
    "originalDisplayId": "2026-00123",
    "reversedFromInvoiceId": "cm4k7x2pq0001abcd1234efgh",
    "bookedById": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "mandateCollectionScheduledAt": "2026-01-15T09:30:00.000Z",
    "excludeFromAutomatedReminders": false,
    "excludeFromAutomatedRemindersUntil": "2026-01-15T09:30:00.000Z",
    "peppolProvider": "SCRADA",
    "peppolDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "peppolUblFolder": "Voorbeeld",
    "peppolUblKey": "Voorbeeld"
  }
}
```

</Accordion>
</Accordions>

### `invoice:moved-to-customer` [#invoice-moved-to-customer]

Factuur naar een andere klant verplaatst.

- **Permissie:** `invoices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "invoice:moved-to-customer",
  "data": {
    "invoice": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "displayId": "2026-00123",
      "status": "DRAFT",
      "type": "INVOICE",
      "paymentStatus": "UNPAID",
      "invoiceDate": "2026-01-15T09:30:00.000Z",
      "dueDate": "2026-01-15T09:30:00.000Z",
      "paidDate": "2026-01-15T09:30:00.000Z",
      "amountSubtotal": 12.5,
      "amountTax": 12.5,
      "amountPaid": 12.5,
      "amountTotal": 12.5,
      "amountOutstanding": 12.5,
      "note": "Voorbeeld",
      "internalNote": "Voorbeeld",
      "currency": "EUR",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "customerId": "cm4k7x2pq0001abcd1234efgh",
      "structuredCommunication": "Voorbeeld",
      "originalDisplayId": "2026-00123",
      "reversedFromInvoiceId": "cm4k7x2pq0001abcd1234efgh",
      "bookedById": "cm4k7x2pq0001abcd1234efgh",
      "mandateId": "cm4k7x2pq0001abcd1234efgh",
      "mandateCollectionScheduledAt": "2026-01-15T09:30:00.000Z",
      "excludeFromAutomatedReminders": false,
      "excludeFromAutomatedRemindersUntil": "2026-01-15T09:30:00.000Z",
      "peppolProvider": "SCRADA",
      "peppolDocumentId": "cm4k7x2pq0001abcd1234efgh",
      "peppolUblFolder": "Voorbeeld",
      "peppolUblKey": "Voorbeeld"
    },
    "priorCustomerId": "cm4k7x2pq0001abcd1234efgh",
    "targetCustomerId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `invoice:paid` [#invoice-paid]

Factuur betaald.

- **Permissie:** `invoices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "invoice:paid",
  "data": {
    "invoice": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "displayId": "2026-00123",
      "status": "DRAFT",
      "type": "INVOICE",
      "paymentStatus": "UNPAID",
      "invoiceDate": "2026-01-15T09:30:00.000Z",
      "dueDate": "2026-01-15T09:30:00.000Z",
      "paidDate": "2026-01-15T09:30:00.000Z",
      "amountSubtotal": 12.5,
      "amountTax": 12.5,
      "amountPaid": 12.5,
      "amountTotal": 12.5,
      "amountOutstanding": 12.5,
      "note": "Voorbeeld",
      "internalNote": "Voorbeeld",
      "currency": "EUR",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "customerId": "cm4k7x2pq0001abcd1234efgh",
      "structuredCommunication": "Voorbeeld",
      "originalDisplayId": "2026-00123",
      "reversedFromInvoiceId": "cm4k7x2pq0001abcd1234efgh",
      "bookedById": "cm4k7x2pq0001abcd1234efgh",
      "mandateId": "cm4k7x2pq0001abcd1234efgh",
      "mandateCollectionScheduledAt": "2026-01-15T09:30:00.000Z",
      "excludeFromAutomatedReminders": false,
      "excludeFromAutomatedRemindersUntil": "2026-01-15T09:30:00.000Z",
      "peppolProvider": "SCRADA",
      "peppolDocumentId": "cm4k7x2pq0001abcd1234efgh",
      "peppolUblFolder": "Voorbeeld",
      "peppolUblKey": "Voorbeeld"
    },
    "payment": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "amount": 12.5,
      "amountRefunded": 12.5,
      "amountRemaining": 12.5,
      "currency": "EUR",
      "description": "Voorbeeld",
      "reference": "Voorbeeld",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "expiresAt": "2026-01-15T09:30:00.000Z",
      "paidAt": "2026-01-15T09:30:00.000Z",
      "delayUntil": "2026-01-15T09:30:00.000Z",
      "errorMessage": "Voorbeeld",
      "errorMessageTranslationKey": "Voorbeeld",
      "status": "PENDING",
      "method": "UNKNOWN",
      "channel": "MANUAL",
      "provider": "MOLLIE",
      "channelInfo": {},
      "accountingSoftwareProvider": "ADMISOL",
      "accountingSoftwareMetadata": {},
      "createdById": "cm4k7x2pq0001abcd1234efgh",
      "invoiceId": "cm4k7x2pq0001abcd1234efgh",
      "customerId": "cm4k7x2pq0001abcd1234efgh",
      "mandateId": "cm4k7x2pq0001abcd1234efgh",
      "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
      "paymentGroupId": "cm4k7x2pq0001abcd1234efgh"
    }
  }
}
```

</Accordion>
</Accordions>

### `invoice:updated` [#invoice-updated]

Factuur gewijzigd.

- **Permissie:** `invoices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "invoice:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": "2026-00123",
    "status": "DRAFT",
    "type": "INVOICE",
    "paymentStatus": "UNPAID",
    "invoiceDate": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "paidDate": "2026-01-15T09:30:00.000Z",
    "amountSubtotal": 12.5,
    "amountTax": 12.5,
    "amountPaid": 12.5,
    "amountTotal": 12.5,
    "amountOutstanding": 12.5,
    "note": "Voorbeeld",
    "internalNote": "Voorbeeld",
    "currency": "EUR",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "structuredCommunication": "Voorbeeld",
    "originalDisplayId": "2026-00123",
    "reversedFromInvoiceId": "cm4k7x2pq0001abcd1234efgh",
    "bookedById": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "mandateCollectionScheduledAt": "2026-01-15T09:30:00.000Z",
    "excludeFromAutomatedReminders": false,
    "excludeFromAutomatedRemindersUntil": "2026-01-15T09:30:00.000Z",
    "peppolProvider": "SCRADA",
    "peppolDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "peppolUblFolder": "Voorbeeld",
    "peppolUblKey": "Voorbeeld"
  }
}
```

</Accordion>
</Accordions>

## ledgerOpeningBalance [#ledgeropeningbalance]

### `ledgerOpeningBalance:created` [#ledgeropeningbalance-created]

Beginsaldo toegevoegd.

- **Permissie:** `invoices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "ledgerOpeningBalance:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "ledger": 12.5
  }
}
```

</Accordion>
</Accordions>

### `ledgerOpeningBalance:deleted` [#ledgeropeningbalance-deleted]

Beginsaldo verwijderd.

- **Permissie:** `invoices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "ledgerOpeningBalance:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "ledger": 12.5
  }
}
```

</Accordion>
</Accordions>

### `ledgerOpeningBalance:updated` [#ledgeropeningbalance-updated]

Beginsaldo gewijzigd.

- **Permissie:** `invoices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "ledgerOpeningBalance:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "ledger": 12.5
  }
}
```

</Accordion>
</Accordions>

## mandate-agreement [#mandate-agreement]

### `mandate-agreement:activated` [#mandate-agreement-activated]

Mandaat actief.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "mandate-agreement:activated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "reference": "Voorbeeld",
    "status": "SENT",
    "locale": "nl",
    "templateVersion": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "debtorName": "Voorbeeld",
    "debtorAddress": {},
    "debtorEmail": "gast@example.com",
    "debtorPhone": "+32470123456",
    "iban": "Voorbeeld",
    "bic": "Voorbeeld",
    "creditorSnapshot": {},
    "viewTokenHash": "Voorbeeld",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "signedAt": "2026-01-15T09:30:00.000Z",
    "signerIp": "Voorbeeld",
    "signerUserAgent": "Voorbeeld",
    "verificationCodeHash": "Voorbeeld",
    "codeSentAt": "2026-01-15T09:30:00.000Z",
    "verificationTarget": "Voorbeeld",
    "signatureMethod": "Voorbeeld",
    "documentSha256": "Voorbeeld",
    "signedDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "selectedMethod": "UNKNOWN",
    "setupPaymentId": "cm4k7x2pq0001abcd1234efgh",
    "useForUtilityBills": false,
    "failureReason": "Voorbeeld",
    "halfwayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "twoDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "expiryDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "signedOnDeviceById": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `mandate-agreement:expired` [#mandate-agreement-expired]

Mandaataanvraag verlopen.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "mandate-agreement:expired",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "reference": "Voorbeeld",
    "status": "SENT",
    "locale": "nl",
    "templateVersion": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "debtorName": "Voorbeeld",
    "debtorAddress": {},
    "debtorEmail": "gast@example.com",
    "debtorPhone": "+32470123456",
    "iban": "Voorbeeld",
    "bic": "Voorbeeld",
    "creditorSnapshot": {},
    "viewTokenHash": "Voorbeeld",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "signedAt": "2026-01-15T09:30:00.000Z",
    "signerIp": "Voorbeeld",
    "signerUserAgent": "Voorbeeld",
    "verificationCodeHash": "Voorbeeld",
    "codeSentAt": "2026-01-15T09:30:00.000Z",
    "verificationTarget": "Voorbeeld",
    "signatureMethod": "Voorbeeld",
    "documentSha256": "Voorbeeld",
    "signedDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "selectedMethod": "UNKNOWN",
    "setupPaymentId": "cm4k7x2pq0001abcd1234efgh",
    "useForUtilityBills": false,
    "failureReason": "Voorbeeld",
    "halfwayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "twoDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "expiryDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "signedOnDeviceById": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `mandate-agreement:failed` [#mandate-agreement-failed]

Mandaat geweigerd.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "mandate-agreement:failed",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "reference": "Voorbeeld",
    "status": "SENT",
    "locale": "nl",
    "templateVersion": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "debtorName": "Voorbeeld",
    "debtorAddress": {},
    "debtorEmail": "gast@example.com",
    "debtorPhone": "+32470123456",
    "iban": "Voorbeeld",
    "bic": "Voorbeeld",
    "creditorSnapshot": {},
    "viewTokenHash": "Voorbeeld",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "signedAt": "2026-01-15T09:30:00.000Z",
    "signerIp": "Voorbeeld",
    "signerUserAgent": "Voorbeeld",
    "verificationCodeHash": "Voorbeeld",
    "codeSentAt": "2026-01-15T09:30:00.000Z",
    "verificationTarget": "Voorbeeld",
    "signatureMethod": "Voorbeeld",
    "documentSha256": "Voorbeeld",
    "signedDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "selectedMethod": "UNKNOWN",
    "setupPaymentId": "cm4k7x2pq0001abcd1234efgh",
    "useForUtilityBills": false,
    "failureReason": "Voorbeeld",
    "halfwayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "twoDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "expiryDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "signedOnDeviceById": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `mandate-agreement:signed` [#mandate-agreement-signed]

Mandaat ondertekend.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "mandate-agreement:signed",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "reference": "Voorbeeld",
    "status": "SENT",
    "locale": "nl",
    "templateVersion": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "debtorName": "Voorbeeld",
    "debtorAddress": {},
    "debtorEmail": "gast@example.com",
    "debtorPhone": "+32470123456",
    "iban": "Voorbeeld",
    "bic": "Voorbeeld",
    "creditorSnapshot": {},
    "viewTokenHash": "Voorbeeld",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "signedAt": "2026-01-15T09:30:00.000Z",
    "signerIp": "Voorbeeld",
    "signerUserAgent": "Voorbeeld",
    "verificationCodeHash": "Voorbeeld",
    "codeSentAt": "2026-01-15T09:30:00.000Z",
    "verificationTarget": "Voorbeeld",
    "signatureMethod": "Voorbeeld",
    "documentSha256": "Voorbeeld",
    "signedDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "selectedMethod": "UNKNOWN",
    "setupPaymentId": "cm4k7x2pq0001abcd1234efgh",
    "useForUtilityBills": false,
    "failureReason": "Voorbeeld",
    "halfwayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "twoDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "expiryDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "signedOnDeviceById": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `mandate-agreement:updated` [#mandate-agreement-updated]

Mandaataanvraag gewijzigd.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "mandate-agreement:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "reference": "Voorbeeld",
    "status": "SENT",
    "locale": "nl",
    "templateVersion": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "debtorName": "Voorbeeld",
    "debtorAddress": {},
    "debtorEmail": "gast@example.com",
    "debtorPhone": "+32470123456",
    "iban": "Voorbeeld",
    "bic": "Voorbeeld",
    "creditorSnapshot": {},
    "viewTokenHash": "Voorbeeld",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "signedAt": "2026-01-15T09:30:00.000Z",
    "signerIp": "Voorbeeld",
    "signerUserAgent": "Voorbeeld",
    "verificationCodeHash": "Voorbeeld",
    "codeSentAt": "2026-01-15T09:30:00.000Z",
    "verificationTarget": "Voorbeeld",
    "signatureMethod": "Voorbeeld",
    "documentSha256": "Voorbeeld",
    "signedDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "selectedMethod": "UNKNOWN",
    "setupPaymentId": "cm4k7x2pq0001abcd1234efgh",
    "useForUtilityBills": false,
    "failureReason": "Voorbeeld",
    "halfwayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "twoDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "expiryDayReminderSentAt": "2026-01-15T09:30:00.000Z",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "signedOnDeviceById": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## mandate [#mandate]

### `mandate:created` [#mandate-created]

Mandaat aangemaakt.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "mandate:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "status": "PENDING",
    "provider": "MOLLIE",
    "paymentMethod": "UNKNOWN",
    "providerInfo": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "maximumAmount": 12.5,
    "currency": "EUR",
    "lastUsedAt": "2026-01-15T09:30:00.000Z",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "setupPaymentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `mandate:deleted` [#mandate-deleted]

Mandaat verwijderd.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "mandate:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "status": "PENDING",
    "provider": "MOLLIE",
    "paymentMethod": "UNKNOWN",
    "providerInfo": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "maximumAmount": 12.5,
    "currency": "EUR",
    "lastUsedAt": "2026-01-15T09:30:00.000Z",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "setupPaymentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `mandate:updated` [#mandate-updated]

Mandaat gewijzigd.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "mandate:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "status": "PENDING",
    "provider": "MOLLIE",
    "paymentMethod": "UNKNOWN",
    "providerInfo": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "maximumAmount": 12.5,
    "currency": "EUR",
    "lastUsedAt": "2026-01-15T09:30:00.000Z",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "setupPaymentId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## meter [#meter]

### `meter:created` [#meter-created]

Meter aangemaakt.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `meter:updated` [#meter-updated]

Meter gewijzigd.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

## meterAnomaly [#meteranomaly]

### `meterAnomaly:detected` [#meteranomaly-detected]

Meterafwijking vastgesteld.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "meterAnomaly:detected",
  "data": {
    "meter": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "serial": "Voorbeeld",
      "type": "ELECTRICITY",
      "provider": "MANUAL",
      "customFields": {},
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "terrainId": "cm4k7x2pq0001abcd1234efgh",
      "lastReadingId": "cm4k7x2pq0001abcd1234efgh",
      "manualMetadata": {},
      "meterCabinetId": "cm4k7x2pq0001abcd1234efgh"
    },
    "anomaly": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "kind": "FLAT_WHILE_PRESENT",
      "detectedAt": "2026-01-15T09:30:00.000Z",
      "resolvedAt": "2026-01-15T09:30:00.000Z",
      "flatSince": "2026-01-15T09:30:00.000Z",
      "lastReadingAt": "2026-01-15T09:30:00.000Z",
      "lastReadingValue": 12.5,
      "presenceDays": 1,
      "expectedConsumption": 12.5,
      "observedConsumption": 12.5,
      "meterId": "cm4k7x2pq0001abcd1234efgh",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z"
    }
  }
}
```

</Accordion>
</Accordions>

### `meterAnomaly:resolved` [#meteranomaly-resolved]

Meterafwijking opgelost.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "meterAnomaly:resolved",
  "data": {
    "meter": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "serial": "Voorbeeld",
      "type": "ELECTRICITY",
      "provider": "MANUAL",
      "customFields": {},
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "terrainId": "cm4k7x2pq0001abcd1234efgh",
      "lastReadingId": "cm4k7x2pq0001abcd1234efgh",
      "manualMetadata": {},
      "meterCabinetId": "cm4k7x2pq0001abcd1234efgh"
    },
    "anomaly": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "kind": "FLAT_WHILE_PRESENT",
      "detectedAt": "2026-01-15T09:30:00.000Z",
      "resolvedAt": "2026-01-15T09:30:00.000Z",
      "flatSince": "2026-01-15T09:30:00.000Z",
      "lastReadingAt": "2026-01-15T09:30:00.000Z",
      "lastReadingValue": 12.5,
      "presenceDays": 1,
      "expectedConsumption": 12.5,
      "observedConsumption": 12.5,
      "meterId": "cm4k7x2pq0001abcd1234efgh",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z"
    }
  }
}
```

</Accordion>
</Accordions>

## meterConsumptionBatch [#meterconsumptionbatch]

### `meterConsumptionBatch:created` [#meterconsumptionbatch-created]

Verbruiksperiode gestart.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "meterConsumptionBatch:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "startReadingId": "cm4k7x2pq0001abcd1234efgh",
    "endReadingId": "cm4k7x2pq0001abcd1234efgh",
    "consumption": 12.5,
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "closed": false,
    "invoiced": false,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `meterConsumptionBatch:updated` [#meterconsumptionbatch-updated]

Verbruiksperiode gewijzigd.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "meterConsumptionBatch:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "startReadingId": "cm4k7x2pq0001abcd1234efgh",
    "endReadingId": "cm4k7x2pq0001abcd1234efgh",
    "consumption": 12.5,
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "closed": false,
    "invoiced": false,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## meterReading [#meterreading]

### `meterReading:created` [#meterreading-created]

Meterstand ingevoerd.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "meterReading:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "value": 12.5,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "readingAt": "2026-01-15T09:30:00.000Z",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `meterReading:deleted` [#meterreading-deleted]

Meterstand verwijderd.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "meterReading:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "value": 12.5,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "readingAt": "2026-01-15T09:30:00.000Z",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `meterReading:synced` [#meterreading-synced]

Meterstand gesynchroniseerd.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "meterReading:synced",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "value": 12.5,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "readingAt": "2026-01-15T09:30:00.000Z",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `meterReading:updated` [#meterreading-updated]

Meterstand gewijzigd.

- **Permissie:** `meters:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "meterReading:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "value": 12.5,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "readingAt": "2026-01-15T09:30:00.000Z",
    "meterId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## nativeDevice [#nativedevice]

### `nativeDevice:command` [#nativedevice-command]

- **Permissie:** `native-devices:read`
- **Levering:** SSE, geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "nativeDevice:command",
  "data": {
    "installationId": "cm4k7x2pq0001abcd1234efgh",
    "url": "https://example.com"
  }
}
```

</Accordion>
</Accordions>

### `nativeDevice:config` [#nativedevice-config]

- **Permissie:** `native-devices:read`
- **Levering:** SSE, geen webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `nativeDevice:deleted` [#nativedevice-deleted]

Tablet of kiosk verwijderd.

- **Permissie:** `native-devices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "nativeDevice:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## nfc-tag-transaction [#nfc-tag-transaction]

### `nfc-tag-transaction:changed` [#nfc-tag-transaction-changed]

NFC-tagtransactie gewijzigd.

- **Permissie:** `nfc-tag-transactions:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "nfc-tag-transaction:changed",
  "data": {
    "transactionId": "cm4k7x2pq0001abcd1234efgh",
    "nfcTagId": "cm4k7x2pq0001abcd1234efgh",
    "status": "PENDING"
  }
}
```

</Accordion>
</Accordions>

## nfc-tag [#nfc-tag]

### `nfc-tag:blocked` [#nfc-tag-blocked]

NFC-tag geblokkeerd.

- **Permissie:** `nfc-tags:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "nfc-tag:blocked",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "uid": "Voorbeeld",
    "type": "CARD",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "balance": 12.5,
    "metadata": {},
    "blockedAt": "2026-01-15T09:30:00.000Z",
    "activatedFrom": "2026-01-15T09:30:00.000Z",
    "activatedUntil": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `nfc-tag:presented` [#nfc-tag-presented]

NFC-tag aangeboden.

- **Permissie:** `nfc-tags:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "nfc-tag:presented",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "uid": "Voorbeeld",
    "type": "CARD",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "balance": 12.5,
    "metadata": {},
    "blockedAt": "2026-01-15T09:30:00.000Z",
    "activatedFrom": "2026-01-15T09:30:00.000Z",
    "activatedUntil": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `nfc-tag:unblocked` [#nfc-tag-unblocked]

NFC-tag gedeblokkeerd.

- **Permissie:** `nfc-tags:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "nfc-tag:unblocked",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "uid": "Voorbeeld",
    "type": "CARD",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "balance": 12.5,
    "metadata": {},
    "blockedAt": "2026-01-15T09:30:00.000Z",
    "activatedFrom": "2026-01-15T09:30:00.000Z",
    "activatedUntil": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `nfc-tag:updated` [#nfc-tag-updated]

NFC-tag gewijzigd.

- **Permissie:** `nfc-tags:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "nfc-tag:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "uid": "Voorbeeld",
    "type": "CARD",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "balance": 12.5,
    "metadata": {},
    "blockedAt": "2026-01-15T09:30:00.000Z",
    "activatedFrom": "2026-01-15T09:30:00.000Z",
    "activatedUntil": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## notification-delivery [#notification-delivery]

### `notification-delivery:deleted` [#notification-delivery-deleted]

Melding verwijderd.

- **Permissie:** `notifications:deliveries:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "notification-delivery:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "notificationType": "NEW_INVOICE_NOTIFICATION",
    "notificationName": "Voorbeeld",
    "metadata": {},
    "source": "INTERNAL",
    "externalSource": "Voorbeeld",
    "externalReference": "Voorbeeld",
    "createdByApiKeyId": "cm4k7x2pq0001abcd1234efgh",
    "createdByApiKeyName": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "triggeredByUserId": "cm4k7x2pq0001abcd1234efgh",
    "recipientUserId": "cm4k7x2pq0001abcd1234efgh",
    "recipientReadAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `notification-delivery:updated` [#notification-delivery-updated]

Status van melding gewijzigd.

- **Permissie:** `notifications:deliveries:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "notification-delivery:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "notificationType": "NEW_INVOICE_NOTIFICATION",
    "notificationName": "Voorbeeld",
    "metadata": {},
    "source": "INTERNAL",
    "externalSource": "Voorbeeld",
    "externalReference": "Voorbeeld",
    "createdByApiKeyId": "cm4k7x2pq0001abcd1234efgh",
    "createdByApiKeyName": "Voorbeeld",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "paymentId": "cm4k7x2pq0001abcd1234efgh",
    "triggeredByUserId": "cm4k7x2pq0001abcd1234efgh",
    "recipientUserId": "cm4k7x2pq0001abcd1234efgh",
    "recipientReadAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## notificationInbox [#notificationinbox]

### `notificationInbox:created` [#notificationinbox-created]

- **Permissie:** elk lid
- **Levering:** SSE, geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "notificationInbox:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "notificationType": "NEW_INVOICE_NOTIFICATION",
    "title": "Voorbeeld",
    "body": "Voorbeeld",
    "url": "https://example.com",
    "urgent": false,
    "hasEmail": false,
    "readAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `notificationInbox:read` [#notificationinbox-read]

- **Permissie:** elk lid
- **Levering:** SSE, geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "notificationInbox:read",
  "data": {
    "readAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## occupation [#occupation]

### `occupation:ended` [#occupation-ended]

Bezetting beëindigd.

- **Permissie:** `terrains:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "occupation:ended",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "occupationType": "OWN_ACCOMMODATION",
    "rentPeriod": {},
    "price": 12.5,
    "description": "Voorbeeld",
    "paidUntil": "2026-01-15T09:30:00.000Z",
    "invoicedUntil": "2026-01-15T09:30:00.000Z",
    "customFields": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "reservationId": "cm4k7x2pq0001abcd1234efgh",
    "terrainId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## organizationSettings [#organizationsettings]

### `organizationSettings:updated` [#organizationsettings-updated]

Instellingen gewijzigd.

- **Permissie:** `organization:settings:read` of `organization:settings:write`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "organizationSettings:updated",
  "data": {
    "openingHoursChanged": false
  }
}
```

</Accordion>
</Accordions>

## payment-group [#payment-group]

### `payment-group:assigned-to-invoice` [#payment-group-assigned-to-invoice]

Betalingsgroep gekoppeld aan een factuur.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-group:assigned-to-invoice",
  "data": {
    "paymentGroup": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "description": "Voorbeeld",
      "status": "OPEN",
      "metadata": {},
      "invoiceId": "cm4k7x2pq0001abcd1234efgh",
      "assignedAt": "2026-01-15T09:30:00.000Z",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z"
    },
    "invoiceId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `payment-group:created` [#payment-group-created]

Betalingsgroep aangemaakt.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-group:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "status": "OPEN",
    "metadata": {},
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "assignedAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `payment-group:deleted` [#payment-group-deleted]

Betalingsgroep verwijderd.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-group:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `payment-group:payments-added` [#payment-group-payments-added]

Betalingen toegevoegd aan een groep.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-group:payments-added",
  "data": {
    "paymentGroup": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "description": "Voorbeeld",
      "status": "OPEN",
      "metadata": {},
      "invoiceId": "cm4k7x2pq0001abcd1234efgh",
      "assignedAt": "2026-01-15T09:30:00.000Z",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z"
    }
  }
}
```

</Accordion>
</Accordions>

### `payment-group:payments-removed` [#payment-group-payments-removed]

Betalingen verwijderd uit een groep.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-group:payments-removed",
  "data": {
    "paymentGroup": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "description": "Voorbeeld",
      "status": "OPEN",
      "metadata": {},
      "invoiceId": "cm4k7x2pq0001abcd1234efgh",
      "assignedAt": "2026-01-15T09:30:00.000Z",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z"
    }
  }
}
```

</Accordion>
</Accordions>

### `payment-group:unassigned-from-invoice` [#payment-group-unassigned-from-invoice]

Betalingsgroep ontkoppeld van een factuur.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-group:unassigned-from-invoice",
  "data": {
    "paymentGroup": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "description": "Voorbeeld",
      "status": "OPEN",
      "metadata": {},
      "invoiceId": "cm4k7x2pq0001abcd1234efgh",
      "assignedAt": "2026-01-15T09:30:00.000Z",
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z"
    },
    "previousInvoiceId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `payment-group:updated` [#payment-group-updated]

Betalingsgroep gewijzigd.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-group:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "status": "OPEN",
    "metadata": {},
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "assignedAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## payment-report [#payment-report]

### `payment-report:created` [#payment-report-created]

Betalingsrapport aangemaakt.

- **Permissie:** `payment-reports:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-report:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": "2026-00123",
    "reportDate": "2026-01-15T09:30:00.000Z",
    "status": "CONCEPT",
    "totalAmount": 12.5,
    "paymentCount": 1,
    "mollieSettlementId": "cm4k7x2pq0001abcd1234efgh",
    "mollieSettlement": {},
    "metadata": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `payment-report:updated` [#payment-report-updated]

Betalingsrapport gewijzigd.

- **Permissie:** `payment-reports:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment-report:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": "2026-00123",
    "reportDate": "2026-01-15T09:30:00.000Z",
    "status": "CONCEPT",
    "totalAmount": 12.5,
    "paymentCount": 1,
    "mollieSettlementId": "cm4k7x2pq0001abcd1234efgh",
    "mollieSettlement": {},
    "metadata": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## payment [#payment]

### `payment:created` [#payment-created]

Betaling aangemaakt.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "amount": 12.5,
    "amountRefunded": 12.5,
    "amountRemaining": 12.5,
    "currency": "EUR",
    "description": "Voorbeeld",
    "reference": "Voorbeeld",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "paidAt": "2026-01-15T09:30:00.000Z",
    "delayUntil": "2026-01-15T09:30:00.000Z",
    "errorMessage": "Voorbeeld",
    "errorMessageTranslationKey": "Voorbeeld",
    "status": "PENDING",
    "method": "UNKNOWN",
    "channel": "MANUAL",
    "provider": "MOLLIE",
    "channelInfo": {},
    "accountingSoftwareProvider": "ADMISOL",
    "accountingSoftwareMetadata": {},
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "paymentGroupId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `payment:deleted` [#payment-deleted]

Betaling verwijderd.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "amount": 12.5,
    "amountRefunded": 12.5,
    "amountRemaining": 12.5,
    "currency": "EUR",
    "description": "Voorbeeld",
    "reference": "Voorbeeld",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "paidAt": "2026-01-15T09:30:00.000Z",
    "delayUntil": "2026-01-15T09:30:00.000Z",
    "errorMessage": "Voorbeeld",
    "errorMessageTranslationKey": "Voorbeeld",
    "status": "PENDING",
    "method": "UNKNOWN",
    "channel": "MANUAL",
    "provider": "MOLLIE",
    "channelInfo": {},
    "accountingSoftwareProvider": "ADMISOL",
    "accountingSoftwareMetadata": {},
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "paymentGroupId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `payment:updated` [#payment-updated]

Betaling gewijzigd.

- **Permissie:** `payments:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "payment:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "amount": 12.5,
    "amountRefunded": 12.5,
    "amountRemaining": 12.5,
    "currency": "EUR",
    "description": "Voorbeeld",
    "reference": "Voorbeeld",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "paidAt": "2026-01-15T09:30:00.000Z",
    "delayUntil": "2026-01-15T09:30:00.000Z",
    "errorMessage": "Voorbeeld",
    "errorMessageTranslationKey": "Voorbeeld",
    "status": "PENDING",
    "method": "UNKNOWN",
    "channel": "MANUAL",
    "provider": "MOLLIE",
    "channelInfo": {},
    "accountingSoftwareProvider": "ADMISOL",
    "accountingSoftwareMetadata": {},
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "mandateId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "paymentGroupId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## pdf [#pdf]

### `pdf:clear-tablet` [#pdf-clear-tablet]

Pdf gewist van een tablet.

- **Permissie:** `native-devices:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `pdf:to-tablet` [#pdf-to-tablet]

Pdf naar een tablet gestuurd.

- **Permissie:** `native-devices:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "pdf:to-tablet",
  "data": {
    "pdfUrl": "https://example.com"
  }
}
```

</Accordion>
</Accordions>

## print-queue-job [#print-queue-job]

### `print-queue-job:updated` [#print-queue-job-updated]

Printopdracht gewijzigd.

- **Permissie:** `printing:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "print-queue-job:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "type": "INVOICE_A4",
    "referenceId": "cm4k7x2pq0001abcd1234efgh",
    "status": "PENDING",
    "invoiceId": "cm4k7x2pq0001abcd1234efgh",
    "paymentReportId": "cm4k7x2pq0001abcd1234efgh",
    "accessMethodId": "cm4k7x2pq0001abcd1234efgh",
    "identityDocumentScanId": "cm4k7x2pq0001abcd1234efgh",
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "documentId": "cm4k7x2pq0001abcd1234efgh",
    "pdfUrl": "https://example.com",
    "scheduledAt": "2026-01-15T09:30:00.000Z",
    "attemptCount": 1,
    "lastError": "Voorbeeld",
    "claimedAt": "2026-01-15T09:30:00.000Z",
    "finishedAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## product [#product]

### `product:created` [#product-created]

Product aangemaakt.

- **Permissie:** `products:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `product:deleted` [#product-deleted]

Product verwijderd.

- **Permissie:** `products:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `product:updated` [#product-updated]

Product gewijzigd.

- **Permissie:** `products:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

## productPriceChange [#productpricechange]

### `productPriceChange:applied` [#productpricechange-applied]

Geplande productprijs toegepast.

- **Permissie:** `products:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "productPriceChange:applied",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "productId": "cm4k7x2pq0001abcd1234efgh",
    "effectiveFrom": "2026-01-15T09:30:00.000Z",
    "amountPerUnit": 12.5,
    "taxPercentage": 12.5,
    "taxRegime": "STANDARD",
    "appliedAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `productPriceChange:created` [#productpricechange-created]

Productprijs gepland.

- **Permissie:** `products:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "productPriceChange:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "productId": "cm4k7x2pq0001abcd1234efgh",
    "effectiveFrom": "2026-01-15T09:30:00.000Z",
    "amountPerUnit": 12.5,
    "taxPercentage": 12.5,
    "taxRegime": "STANDARD",
    "appliedAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `productPriceChange:deleted` [#productpricechange-deleted]

Geplande productprijs verwijderd.

- **Permissie:** `products:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "productPriceChange:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "productId": "cm4k7x2pq0001abcd1234efgh",
    "effectiveFrom": "2026-01-15T09:30:00.000Z",
    "amountPerUnit": 12.5,
    "taxPercentage": 12.5,
    "taxRegime": "STANDARD",
    "appliedAt": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## reservation [#reservation]

### `reservation:created` [#reservation-created]

Reservering aangemaakt.

- **Permissie:** `reservations:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "reservation:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": "2026-00123",
    "status": "BOOKED",
    "note": "Voorbeeld",
    "checkIn": "2026-01-15T09:30:00.000Z",
    "checkOut": "2026-01-15T09:30:00.000Z",
    "checkedInAt": "2026-01-15T09:30:00.000Z",
    "checkedOutAt": "2026-01-15T09:30:00.000Z",
    "canceledAt": "2026-01-15T09:30:00.000Z",
    "numberOfToddlers": 1,
    "numberOfChildren": 1,
    "numberOfAdults": 1,
    "numberOfAnimals": 1,
    "paidUntil": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "preferredTerrainId": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "customFields": {},
    "allowOnlinePayments": false,
    "sendConfirmationEmails": false
  }
}
```

</Accordion>
</Accordions>

### `reservation:updated` [#reservation-updated]

Reservering gewijzigd.

- **Permissie:** `reservations:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "reservation:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "displayId": "2026-00123",
    "status": "BOOKED",
    "note": "Voorbeeld",
    "checkIn": "2026-01-15T09:30:00.000Z",
    "checkOut": "2026-01-15T09:30:00.000Z",
    "checkedInAt": "2026-01-15T09:30:00.000Z",
    "checkedOutAt": "2026-01-15T09:30:00.000Z",
    "canceledAt": "2026-01-15T09:30:00.000Z",
    "numberOfToddlers": 1,
    "numberOfChildren": 1,
    "numberOfAdults": 1,
    "numberOfAnimals": 1,
    "paidUntil": "2026-01-15T09:30:00.000Z",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "preferredTerrainId": "cm4k7x2pq0001abcd1234efgh",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "customFields": {},
    "allowOnlinePayments": false,
    "sendConfirmationEmails": false
  }
}
```

</Accordion>
</Accordions>

## sign [#sign]

### `sign:clear-tablet` [#sign-clear-tablet]

Ondertekening gewist van een tablet.

- **Permissie:** `native-devices:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

### `sign:to-tablet` [#sign-to-tablet]

Ondertekening naar een tablet gestuurd.

- **Permissie:** `native-devices:read`
- **Levering:** SSE + webhook

De vorm van `data` is geen databaserecord en wordt niet automatisch beschreven.

## signatureRequest [#signaturerequest]

### `signatureRequest:completed` [#signaturerequest-completed]

Ondertekenverzoek afgerond.

- **Permissie:** `signature-requests:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "signatureRequest:completed",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "title": "Voorbeeld",
    "message": "Voorbeeld",
    "status": "DRAFT",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "sourceDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "sourceKey": "Voorbeeld",
    "sourceSha256": "Voorbeeld",
    "pageCount": 1,
    "signedDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "signedSha256": "Voorbeeld",
    "stampedSha256": "Voorbeeld",
    "sealFingerprint": "Voorbeeld",
    "timestampedAt": "2026-01-15T09:30:00.000Z",
    "timestampAuthority": "Voorbeeld",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "reminderAfterDays": 1,
    "sentAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `signatureRequest:deleted` [#signaturerequest-deleted]

Ondertekenverzoek verwijderd.

- **Permissie:** `signature-requests:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "signatureRequest:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "title": "Voorbeeld",
    "message": "Voorbeeld",
    "status": "DRAFT",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "sourceDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "sourceKey": "Voorbeeld",
    "sourceSha256": "Voorbeeld",
    "pageCount": 1,
    "signedDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "signedSha256": "Voorbeeld",
    "stampedSha256": "Voorbeeld",
    "sealFingerprint": "Voorbeeld",
    "timestampedAt": "2026-01-15T09:30:00.000Z",
    "timestampAuthority": "Voorbeeld",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "reminderAfterDays": 1,
    "sentAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `signatureRequest:updated` [#signaturerequest-updated]

Ondertekenverzoek gewijzigd.

- **Permissie:** `signature-requests:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "signatureRequest:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "title": "Voorbeeld",
    "message": "Voorbeeld",
    "status": "DRAFT",
    "customerId": "cm4k7x2pq0001abcd1234efgh",
    "sourceDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "sourceKey": "Voorbeeld",
    "sourceSha256": "Voorbeeld",
    "pageCount": 1,
    "signedDocumentId": "cm4k7x2pq0001abcd1234efgh",
    "signedSha256": "Voorbeeld",
    "stampedSha256": "Voorbeeld",
    "sealFingerprint": "Voorbeeld",
    "timestampedAt": "2026-01-15T09:30:00.000Z",
    "timestampAuthority": "Voorbeeld",
    "expiresAt": "2026-01-15T09:30:00.000Z",
    "reminderAfterDays": 1,
    "sentAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "createdById": "cm4k7x2pq0001abcd1234efgh",
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## task-time-tracker [#task-time-tracker]

### `task-time-tracker:changed` [#task-time-tracker-changed]

- **Permissie:** `tasks:read`
- **Levering:** SSE, geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task-time-tracker:changed",
  "data": {
    "taskId": "cm4k7x2pq0001abcd1234efgh",
    "previousTaskId": "cm4k7x2pq0001abcd1234efgh",
    "cleared": false,
    "id": "cm4k7x2pq0001abcd1234efgh",
    "userId": "cm4k7x2pq0001abcd1234efgh",
    "note": "Voorbeeld",
    "accumulatedMs": 12.5,
    "runningSince": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## task-view [#task-view]

### `task-view:created` [#task-view-created]

Takenweergave aangemaakt.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task-view:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "icon": "Voorbeeld",
    "color": "Voorbeeld",
    "kind": "MANUAL",
    "scope": "PERSONAL",
    "ownerId": "cm4k7x2pq0001abcd1234efgh",
    "sortOrder": 1,
    "definition": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `task-view:deleted` [#task-view-deleted]

Takenweergave verwijderd.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task-view:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "icon": "Voorbeeld",
    "color": "Voorbeeld",
    "kind": "MANUAL",
    "scope": "PERSONAL",
    "ownerId": "cm4k7x2pq0001abcd1234efgh",
    "sortOrder": 1,
    "definition": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

### `task-view:membership-changed` [#task-view-membership-changed]

Taken in een weergave gewijzigd.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task-view:membership-changed",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `task-view:updated` [#task-view-updated]

Takenweergave gewijzigd.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task-view:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "icon": "Voorbeeld",
    "color": "Voorbeeld",
    "kind": "MANUAL",
    "scope": "PERSONAL",
    "ownerId": "cm4k7x2pq0001abcd1234efgh",
    "sortOrder": 1,
    "definition": {},
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>

## task [#task]

### `task:action-chosen` [#task-action-chosen]

Taakactie gekozen.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task:action-chosen",
  "data": {
    "task": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "name": "Voorbeeld",
      "description": "Voorbeeld",
      "status": "PENDING",
      "priority": "LOW",
      "sortOrder": 1,
      "createdAt": "2026-01-15T09:30:00.000Z",
      "updatedAt": "2026-01-15T09:30:00.000Z",
      "completedAt": "2026-01-15T09:30:00.000Z",
      "dueDate": "2026-01-15T09:30:00.000Z",
      "remindAt": "2026-01-15T09:30:00.000Z",
      "reminderSentAt": "2026-01-15T09:30:00.000Z",
      "remindByEmail": false,
      "remindByPush": false,
      "remindRrule": "Voorbeeld",
      "deadlineNotifiedAt": "2026-01-15T09:30:00.000Z",
      "commentId": "cm4k7x2pq0001abcd1234efgh",
      "parentId": "cm4k7x2pq0001abcd1234efgh",
      "metadata": {},
      "customFields": {},
      "chosenActionId": "cm4k7x2pq0001abcd1234efgh",
      "actionChosenAt": "2026-01-15T09:30:00.000Z",
      "actionChosenById": "cm4k7x2pq0001abcd1234efgh",
      "actionNote": "Voorbeeld",
      "completionLocked": false,
      "createdById": "cm4k7x2pq0001abcd1234efgh"
    },
    "action": {
      "id": "cm4k7x2pq0001abcd1234efgh",
      "taskId": "cm4k7x2pq0001abcd1234efgh",
      "label": "Voorbeeld",
      "color": "Voorbeeld",
      "icon": "Voorbeeld",
      "position": 1,
      "key": "Voorbeeld",
      "requiresNote": false,
      "requiresConfirmation": false,
      "confirmTitle": "Voorbeeld",
      "confirmDescription": "Voorbeeld",
      "confirmLevel": "Voorbeeld",
      "automationId": "cm4k7x2pq0001abcd1234efgh"
    },
    "note": "Voorbeeld"
  }
}
```

</Accordion>
</Accordions>

### `task:assigned` [#task-assigned]

Taak toegewezen.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task:assigned",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "status": "PENDING",
    "priority": "LOW",
    "sortOrder": 1,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "remindAt": "2026-01-15T09:30:00.000Z",
    "reminderSentAt": "2026-01-15T09:30:00.000Z",
    "remindByEmail": false,
    "remindByPush": false,
    "remindRrule": "Voorbeeld",
    "deadlineNotifiedAt": "2026-01-15T09:30:00.000Z",
    "commentId": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "customFields": {},
    "chosenActionId": "cm4k7x2pq0001abcd1234efgh",
    "actionChosenAt": "2026-01-15T09:30:00.000Z",
    "actionChosenById": "cm4k7x2pq0001abcd1234efgh",
    "actionNote": "Voorbeeld",
    "completionLocked": false,
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `task:created` [#task-created]

Taak aangemaakt.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task:created",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "status": "PENDING",
    "priority": "LOW",
    "sortOrder": 1,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "remindAt": "2026-01-15T09:30:00.000Z",
    "reminderSentAt": "2026-01-15T09:30:00.000Z",
    "remindByEmail": false,
    "remindByPush": false,
    "remindRrule": "Voorbeeld",
    "deadlineNotifiedAt": "2026-01-15T09:30:00.000Z",
    "commentId": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "customFields": {},
    "chosenActionId": "cm4k7x2pq0001abcd1234efgh",
    "actionChosenAt": "2026-01-15T09:30:00.000Z",
    "actionChosenById": "cm4k7x2pq0001abcd1234efgh",
    "actionNote": "Voorbeeld",
    "completionLocked": false,
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `task:deleted` [#task-deleted]

Taak verwijderd.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task:deleted",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "status": "PENDING",
    "priority": "LOW",
    "sortOrder": 1,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "remindAt": "2026-01-15T09:30:00.000Z",
    "reminderSentAt": "2026-01-15T09:30:00.000Z",
    "remindByEmail": false,
    "remindByPush": false,
    "remindRrule": "Voorbeeld",
    "deadlineNotifiedAt": "2026-01-15T09:30:00.000Z",
    "commentId": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "customFields": {},
    "chosenActionId": "cm4k7x2pq0001abcd1234efgh",
    "actionChosenAt": "2026-01-15T09:30:00.000Z",
    "actionChosenById": "cm4k7x2pq0001abcd1234efgh",
    "actionNote": "Voorbeeld",
    "completionLocked": false,
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `task:status-changed` [#task-status-changed]

Taakstatus gewijzigd.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task:status-changed",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "status": "PENDING",
    "priority": "LOW",
    "sortOrder": 1,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "remindAt": "2026-01-15T09:30:00.000Z",
    "reminderSentAt": "2026-01-15T09:30:00.000Z",
    "remindByEmail": false,
    "remindByPush": false,
    "remindRrule": "Voorbeeld",
    "deadlineNotifiedAt": "2026-01-15T09:30:00.000Z",
    "commentId": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "customFields": {},
    "chosenActionId": "cm4k7x2pq0001abcd1234efgh",
    "actionChosenAt": "2026-01-15T09:30:00.000Z",
    "actionChosenById": "cm4k7x2pq0001abcd1234efgh",
    "actionNote": "Voorbeeld",
    "completionLocked": false,
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `task:unassigned` [#task-unassigned]

Taaktoewijzing opgeheven.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task:unassigned",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "status": "PENDING",
    "priority": "LOW",
    "sortOrder": 1,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "remindAt": "2026-01-15T09:30:00.000Z",
    "reminderSentAt": "2026-01-15T09:30:00.000Z",
    "remindByEmail": false,
    "remindByPush": false,
    "remindRrule": "Voorbeeld",
    "deadlineNotifiedAt": "2026-01-15T09:30:00.000Z",
    "commentId": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "customFields": {},
    "chosenActionId": "cm4k7x2pq0001abcd1234efgh",
    "actionChosenAt": "2026-01-15T09:30:00.000Z",
    "actionChosenById": "cm4k7x2pq0001abcd1234efgh",
    "actionNote": "Voorbeeld",
    "completionLocked": false,
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

### `task:updated` [#task-updated]

Taak gewijzigd.

- **Permissie:** `tasks:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "task:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "status": "PENDING",
    "priority": "LOW",
    "sortOrder": 1,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "completedAt": "2026-01-15T09:30:00.000Z",
    "dueDate": "2026-01-15T09:30:00.000Z",
    "remindAt": "2026-01-15T09:30:00.000Z",
    "reminderSentAt": "2026-01-15T09:30:00.000Z",
    "remindByEmail": false,
    "remindByPush": false,
    "remindRrule": "Voorbeeld",
    "deadlineNotifiedAt": "2026-01-15T09:30:00.000Z",
    "commentId": "cm4k7x2pq0001abcd1234efgh",
    "parentId": "cm4k7x2pq0001abcd1234efgh",
    "metadata": {},
    "customFields": {},
    "chosenActionId": "cm4k7x2pq0001abcd1234efgh",
    "actionChosenAt": "2026-01-15T09:30:00.000Z",
    "actionChosenById": "cm4k7x2pq0001abcd1234efgh",
    "actionNote": "Voorbeeld",
    "completionLocked": false,
    "createdById": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## terrain [#terrain]

### `terrain:updated` [#terrain-updated]

Terrein gewijzigd.

- **Permissie:** `terrains:read`
- **Levering:** SSE + webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "terrain:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "name": "Voorbeeld",
    "description": "Voorbeeld",
    "bookable": false,
    "createdAt": "2026-01-15T09:30:00.000Z",
    "updatedAt": "2026-01-15T09:30:00.000Z",
    "geoJson": {},
    "surfaceArea": 12.5,
    "metadata": {},
    "customFields": {},
    "calculatedTariff": {},
    "terrainTypeId": "cm4k7x2pq0001abcd1234efgh"
  }
}
```

</Accordion>
</Accordions>

## vehiclePresence [#vehiclepresence]

### `vehiclePresence:updated` [#vehiclepresence-updated]

- **Permissie:** `access-control:read`
- **Levering:** SSE, geen webhook

<Accordions>
<Accordion title="Voorbeeld-payload">

```json
{
  "event": "vehiclePresence:updated",
  "data": {
    "id": "cm4k7x2pq0001abcd1234efgh",
    "plate": "Voorbeeld",
    "status": "INSIDE",
    "lastSeenAt": "2026-01-15T09:30:00.000Z"
  }
}
```

</Accordion>
</Accordions>


# Notificações externas (/pt-PT/ontwikkelaars/externe-notificaties)

O seu sistema envia e-mails aos clientes por conta própria (newsletter, confirmação de reserva, lembrete)? Registe-os então no Tillor. A equipa vê-os no cliente, na fatura e na vista geral **Notificações**, ao lado das notificações que o próprio Tillor envia.

O Tillor **não envia nada**: você regista uma mensagem que já foi enviada. As notificações externas têm sempre na aplicação a etiqueta **Externa** com o nome da sua origem, para que nunca passem por uma notificação do Tillor.

## Acesso [#toegang]

O utilizador por trás da [chave de API](/ontwikkelaars/http) precisa, na organização, de uma destas permissões. Um administrador atribui-as nas permissões de utilizador da organização, no grupo **Notificações** (**Registar notificações externas** e **Gerir notificações externas de outros**).

| Permissão | O que pode fazer |
|-----------|------------|
| `notifications:external:write` | Registar notificações e atualizar ou eliminar os seus **próprios** registos |
| `notifications:external:manage-others` | Também atualizar ou eliminar registos de outros utilizadores ou integrações |

<Callout type="info" title="Um utilizador por integração">
A propriedade está associada ao utilizador da chave de API. Use um utilizador (de serviço) próprio por integração; assim, uma integração nunca pode alterar as notificações de outra.
</Callout>

## Endpoints [#endpoints]

Todos os caminhos estão em `/api/orgs/:orgId`. Esquemas exatos: [OpenAPI](https://tillor.eu/api/openapi.json), etiqueta `notifications`.

| Método | Caminho | Descrição |
|--------|-----|--------------|
| POST | `/notifications/external` | Registar uma notificação |
| PATCH | `/notifications/external/{id}` | Atualizar o estado, as datas e horas ou o conteúdo |
| DELETE | `/notifications/external/{id}` | Eliminar definitivamente |
| GET | `/notifications?source=EXTERNAL` | Listar notificações registadas (filtre também por `externalSource`, `externalReference`, `customerId`, `invoiceId`) |
| GET | `/notifications/{id}` | Obter uma notificação |

Não pode alterar nem eliminar através destes endpoints notificações que o próprio Tillor enviou; devolvem `404`.

## Registar [#registreren]

```bash
curl -X POST "https://tillor.eu/api/orgs/org_abc123/notifications/external" \
  -H "x-api-key: tkn_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "externalSource": "mailchimp",
    "externalReference": "campaign-42:member-9f3a",
    "name": "Boekingsbevestiging",
    "customerId": "clx789...",
    "channel": "EMAIL",
    "status": "SENT",
    "sentAt": "2026-09-19T08:15:00Z",
    "email": {
      "to": "jan@voorbeeld.nl",
      "from": "Recreatiepark Het Meer <info@recreatiepark-het-meer.be>",
      "subject": "Je boeking is bevestigd",
      "htmlBody": "<p>Dag Jan, ...</p>",
      "attachments": [{ "filename": "bevestiging.pdf", "contentType": "application/pdf", "size": 48211 }]
    }
  }'
```

Todos os campos e limites estão no [OpenAPI](https://tillor.eu/api/openapi.json). Estes campos têm regras que deve conhecer de antemão:

| Campo | Regra |
|------|-------|
| `externalSource` | Nome do seu sistema em minúsculas, algarismos, `.`, `_` ou `-` (p. ex. `mailchimp`). A equipa vê este nome na notificação |
| `externalReference` | O seu próprio ID para esta mensagem, único dentro de `externalSource` |
| `name` | Etiqueta curta para a equipa (p. ex. "Confirmação de reserva"). Pode ser pesquisada |
| `customerId` / `invoiceId` | Pelo menos um dos dois. Determina onde a notificação aparece. Se enviar apenas `invoiceId`, o Tillor associa também o cliente dessa fatura. Um ID desconhecido, ou uma fatura de outro cliente, devolve `400` |
| `status` | `SENT`, `FAILED`, `BOUNCED` ou `COMPLAINED`. Sem `sentAt` em `SENT`, o Tillor usa o momento do registo |
| `sentAt`, `readAt`, `clickedAt` | ISO 8601 com fuso horário, p. ex. `2026-09-19T08:15:00Z`. Outros valores são rejeitados |
| `email.attachments` | Apenas metadados (`filename`, `contentType`, `size`). Os ficheiros em si não são guardados |

### Repetir em segurança [#veilig-opnieuw-proberen]

`POST` é idempotente em `externalSource` + `externalReference`. Se enviar de novo a mesma combinação (por exemplo, após um tempo limite), recebe a notificação **existente** de volta e nada é alterado. Se quiser ajustar algo, use `PATCH`.

<Callout type="warn" title="Sem dados pessoais em externalReference ou name">
`externalSource`, `externalReference` e `name` são guardados sem cifragem, porque são pesquisáveis. Use um ID técnico, não um endereço de e-mail nem um nome. Um `externalReference` com `@` é rejeitado. O destinatário, o assunto, o conteúdo e os anexos são, esses sim, guardados cifrados.
</Callout>

## Atualizar e eliminar [#bijwerken-en-verwijderen]

Em `PATCH` envie apenas os campos que mudam, por exemplo quando um e-mail é devolvido mais tarde:

```bash
curl -X PATCH "https://tillor.eu/api/orgs/org_abc123/notifications/external/NOTIFICATION_ID" \
  -H "x-api-key: tkn_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "status": "BOUNCED", "errorMessage": "Mailbox bestaat niet" }'
```

`DELETE` elimina a notificação definitivamente, incluindo o conteúdo. Use-o também para satisfazer um pedido de eliminação (RGPD).

Um `PATCH` que não altera nada não faz nada: sem alteração, sem evento. Se alterar o conteúdo (etiqueta, destinatário, remetente, assunto, texto, HTML ou anexos) ou eliminar uma notificação, isso fica no registo de atividade do cliente ou da fatura, com o utilizador que o fez. As atualizações de estado, `readAt` ou `clickedAt` não aparecem aí, para que possa continuar a sincronizar aberturas e cliques.

## HTML e privacidade [#html-en-privacy]

O Tillor mostra o HTML à equipa tal como o cliente o recebeu, mas trata-o como conteúdo não fidedigno:

- Ao guardar, são removidos scripts, formulários, iframes, embeds e atributos de evento (`onclick`, ...). As ligações abrem num novo separador
- A pré-visualização corre numa moldura isolada, sem scripts e sem acesso à sessão do Tillor
- As imagens e os tipos de letra externos **não são carregados automaticamente**, para que abrir uma notificação não ative um pixel de rastreio. O membro da equipa pode carregar as imagens por notificação

Por isso, não conte com que o rastreio de "aberto" no seu sistema dispare quando um membro da equipa vê a notificação.

## O que o Tillor não faz com notificações externas [#wat-tillor-niet-doet-met-externe-notificaties]

- Não (re)envia nem volta a tentar automaticamente
- Não vai buscar atualizações de estado ao seu fornecedor de e-mail: é você que mantém o estado atual com `PATCH`
- Não conta nas listas **Notificações falhadas**, **Notificações devolvidas** e **Notificações pendentes** nem nos contadores no topo da vista geral de notificações, porque o Tillor não pode verificar o seu estado. Aparecem, sim, em **Comunicações recentes**

## Webhooks e SSE [#webhooks-en-sse]

| Evento | Quando |
|-------|---------|
| `notification-delivery:updated` | Ao registar e em cada `PATCH` que altere algo. Contém a notificação completa |
| `notification-delivery:deleted` | Em `DELETE`. Contém apenas `id`, `source`, `externalSource`, `externalReference`, `customerId` e `invoiceId` |

O campo `source` é `EXTERNAL` para os seus registos e `INTERNAL` para notificações do Tillor. Filtre por ele se quiser ignorar os seus próprios eventos. Veja [Webhooks](/ontwikkelaars/webhooks) e [SSE](/ontwikkelaars/sse).

## Relacionado [#gerelateerd]

- [HTTP API](/ontwikkelaars/http) - Chaves de API, cabeçalhos e limites de pedidos
- [Webhooks](/ontwikkelaars/webhooks) - Receber eventos através de HTTP POST
- [OpenAPI](https://tillor.eu/api/openapi.json) - Esquemas completos


# HTTP API (/pt-PT/ontwikkelaars/http)

A API do Tillor é uma API REST. Autentique-se com uma chave de API e envie os cabeçalhos certos em cada pedido. As chaves de API são **por conta** - uma só chave funciona para todas as organizações a que tem acesso.

## Referência da API e OpenAPI [#api-referentie-en-openapi]

- **[Referência da API](/api-referentie)** - Cada endpoint com parâmetros e exemplos; experimente pedidos diretamente no navegador
- **[Especificação OpenAPI](https://tillor.eu/api/openapi.json)** - Documentação completa da API em formato JSON para geração de código ou importação no Postman/Insomnia

---

## Chaves de API [#api-sleutels]

### Criar [#aanmaken]

As chaves de API são criadas na aplicação Tillor, no menu do utilizador, em **Conta > Chaves de API** (marca **1** = menu, marca **2** = Chaves de API na captura de ecrã). Também pode criá-las através da API com uma sessão iniciada (sem chave de API). Veja a [especificação OpenAPI](https://tillor.eu/api/openapi.json), na etiqueta `api-keys`, para caminhos e esquemas de pedido e resposta.

<DocScreenshot src="/screenshots/http/api-keys-nav.png" alt="Chaves de API nas definições da conta" />

A chave em bruto é devolvida **uma única vez** ao criar ou regenerar. Guarde-a em segurança; depois já não a pode voltar a obter.

### Limitar permissões [#rechten-beperken]

Por predefinição, uma chave pode fazer tudo o que você próprio pode, em qualquer organização de que seja membro. Na janela da chave, ative **Limitar às permissões selecionadas** e escolha as permissões de que a ligação precisa, por exemplo apenas ler faturas. Uma chave limitada recebe, em cada organização, a interseção das suas permissões com a sua participação aí: uma chave nunca pode mais do que você. Uma chamada fora das permissões escolhidas recebe `403 Forbidden`, tal como um utilizador sem essa permissão. Uma alteração das permissões entra em vigor em menos de um minuto. Através da API: `scopes` (lista de ids de permissões como `invoices:read`, ou `null` para tudo) ao criar e atualizar uma chave.

### Utilização [#gebruik]

Envie a chave de API no cabeçalho `x-api-key`:

```http
x-api-key: tkn_xxx
```

As chaves usam o prefixo `tkn_`. Nos endpoints de organização, o ID da organização está no caminho (`/orgs/org_abc123/...`); não é necessário um cabeçalho à parte.

### Limites de pedidos [#rate-limits]

- **Predefinição:** 5000 pedidos por 60 segundos por chave
- Em caso de excesso: `429 Too Many Requests` com `Retry-After`
- Cada resposta com chave de API contém cabeçalhos IETF `RateLimit-*`:

```http
RateLimit-Limit: 5000
RateLimit-Remaining: 4999
RateLimit-Reset: 58
RateLimit-Policy: 5000;w=60
```

`RateLimit-Reset` é o número de segundos até a janela atual recomeçar. Os clientes de navegador podem ler estes cabeçalhos através de CORS (`Access-Control-Expose-Headers`).

### Segurança [#beveiliging]

<Callout type="warn" title="Atenção">
- **Nunca** exponha chaves de API em código do lado do cliente ou em repositórios públicos
- Regenere as chaves periodicamente através de **Regenerar** na aplicação (OpenAPI: `POST /api/api-keys/:id/renew`)
- Elimine chaves não utilizadas com `DELETE /api/api-keys/:id`
</Callout>

---

## URL base e contexto da organização [#base-url-en-organisatie-context]

**URL base:** `https://tillor.eu` (ou o URL da sua instalação; o OpenAPI indica `{APP_URL}/api`)

**Caminhos de organização:** acrescente o ID da organização ao caminho:

```
/api/orgs/:orgId/...
```

**Exemplo:**

```
GET https://tillor.eu/api/orgs/org_abc123/customers
```

**Cabeçalho obrigatório para endpoints de organização:** `x-api-key: tkn_xxx`. O ID da organização está no caminho.

---

## Exemplo: cURL [#voorbeeld-curl]

```bash
curl -X GET "https://tillor.eu/api/orgs/org_abc123/customers" \
  -H "x-api-key: tkn_xxx" \
  -H "Content-Type: application/json"
```

---

## Integrações (marketplace) [#integraties-marketplace]

As integrações da organização (antes "apps" na API) usam um recurso por tipo em `/api/orgs/:orgId/integrations/{integrationType}`. As permissões necessárias são `organization:integrations:read` e `organization:integrations:write` (substitui `organization:apps:*`).

| Método | Caminho | Descrição |
|--------|------|-------------|
| GET | `/integrations/{integrationType}` | Estado (`installed`, `available`) e `settings` ocultadas |
| POST | `/integrations/{integrationType}` | Instalar (`settings` opcional no corpo; o OAuth pode devolver `redirectUrl`) |
| PUT | `/integrations/{integrationType}` | Atualizar definições (`settings` no corpo) |
| DELETE | `/integrations/{integrationType}` | Desinstalar |

Em `GET` e depois de `PUT`, `settings` contém apenas campos **públicos** mais, por campo secreto, `{ configured: true }`. Palavras-passe, chaves de API e tokens OAuth não são devolvidos. Deixe os campos secretos vazios em `PUT` para manter o valor existente.

Veja a [especificação OpenAPI](https://tillor.eu/api/openapi.json) (etiqueta `integrations`) para os esquemas exatos.

---

## Relacionado [#gerelateerd]

- [Referência da API](/api-referentie) - Cada endpoint, para experimentar no navegador
- [OpenAPI](https://tillor.eu/api/openapi.json) - Especificação da API (JSON)
- [MCP](/ontwikkelaars/mcp) - Ligar o Cursor, o Claude, o ChatGPT ou o Gemini através de OAuth
- [Notificações externas](/ontwikkelaars/externe-notificaties) - Registar e-mails que o seu próprio sistema enviou
- [Webhooks](/ontwikkelaars/webhooks) - Receber eventos através de HTTP POST
- [Webhook de entrada de uma automatização](/ontwikkelaars/automatiseringen#een-automatisering-starten-met-een-webhook) - Iniciar uma automatização com um POST, sem chave de API
- [SSE](/ontwikkelaars/sse) - Transmitir eventos através de Server-Sent Events
- [Exemplos](/ontwikkelaars/voorbeelden) - Exemplos de código e de payload


# Visão geral (/pt-PT/ontwikkelaars)

A API do Tillor oferece acesso programático aos dados da sua organização. Use chaves de API para autenticação, webhooks para eventos de saída, SSE ou MQTT para streaming em tempo real, ou MCP para ligar ferramentas de IA como Cursor, Claude, ChatGPT e Gemini ao Tillor.

## O que pode construir? [#wat-kun-je-bouwen]

- **Integrações** - Ligue o Tillor aos seus próprios sistemas através da API REST
- **Webhooks** - Receba mensagens HTTP POST quando ocorrem eventos (fatura paga, cliente criado, etc.)
- **Iniciar automatizações** - Inicie uma automatização a partir do seu próprio sistema com um POST para o seu [webhook de entrada](/ontwikkelaars/automatiseringen#een-automatisering-starten-met-een-webhook)
- **Painéis em tempo real** - Transmita eventos por SSE ou MQTT para atualizações em direto na sua aplicação
- **Ferramentas de IA** - Deixe o Cursor, o Claude, o ChatGPT ou o Gemini chamar a API através de [MCP](/ontwikkelaars/mcp) (`https://mcp.tillor.dev`)

## Começar depressa [#snel-aan-de-slag]

1. **Crie uma chave de API** no Tillor em *Conta > Chaves de API*
2. **Envie a chave** no cabeçalho `x-api-key` em cada pedido
3. **Coloque o ID da sua organização no caminho** dos endpoints de organização: `/orgs/org_abc123/...`

<Callout type="info" title="Os mesmos eventos">
Os webhooks e o SSE entregam exatamente os mesmos eventos. A diferença: os webhooks enviam um HTTP POST para o seu URL; o SSE é uma ligação longa na qual recebe eventos.
</Callout>

**Ligações úteis:** [Referência da API](/api-referentie) - [OpenAPI](https://tillor.eu/api/openapi.json)

**Âmbito:** as chaves de API são por conta (todas as organizações); os webhooks são por organização.

<Callout type="idea" title="Documentação para ferramentas de IA">
Pode também usar este site como texto para ferramentas de IA: [`/llms.txt`](/llms.txt) (índice), [`/llms-full.txt`](/llms-full.txt) (todas as páginas juntas) e, por página, acrescentando `.mdx` ao caminho (por exemplo [`/ontwikkelaars/http.mdx`](/ontwikkelaars/http.mdx)). **Perguntar à IA (local)** no layout da documentação carrega essa exportação completa (`/llms-full.txt`) na IA integrada do Chrome, para não precisar de estar numa página específica.
</Callout>

## Ver também [#zie-ook]

<Cards>
  <Card
    title="HTTP API"
    href="/ontwikkelaars/http"
    description="Chaves de API, autenticação, URL base e contexto da organização"
  />
  <Card
    title="MCP"
    href="/ontwikkelaars/mcp"
    description="Ligue o Cursor, o Claude, o ChatGPT ou o Gemini ao Tillor através de OAuth"
  />
  <Card
    title="Notificações externas"
    href="/ontwikkelaars/externe-notificaties"
    description="Registe e-mails que o seu próprio sistema enviou a clientes"
  />
  <Card
    title="Webhooks"
    href="/ontwikkelaars/webhooks"
    description="Receba eventos através de HTTP POST para o seu endpoint"
  />
  <Card
    title="Automatizações"
    href="/ontwikkelaars/automatiseringen"
    description="A mensagem do webhook, o pedido à API, os webhooks de entrada e a estrutura de um fluxo"
  />
  <Card
    title="SSE"
    href="/ontwikkelaars/sse"
    description="Transmita eventos em tempo real através de Server-Sent Events"
  />
  <Card
    title="MQTT"
    href="/ontwikkelaars/mqtt"
    description="Pub/sub através de MQTT com acesso estrito a tópicos e JWT ou credenciais estáticas"
  />
  <Card
    title="Metadados do Mollie"
    href="/ontwikkelaars/mollie-metadata"
    description="Espaço de nomes tillor nos pagamentos do Mollie"
  />
  <Card
    title="API de chat do website"
    href="/ontwikkelaars/website-chat"
    description="Interface de chat própria através de REST e SSE"
  />
  <Card
    title="Exemplos"
    href="/ontwikkelaars/voorbeelden"
    description="Exemplos de código e de payload para HTTP, webhooks e SSE"
  />
</Cards>


# MCP (/pt-PT/ontwikkelaars/mcp)

Com o MCP (Model Context Protocol), ferramentas como o Cursor, o Claude, o ChatGPT e o Gemini chamam a API do Tillor por si. Inicia sessão uma vez através de OAuth; na sua configuração não precisa de constar nenhuma chave de API.

**URL:** `https://mcp.tillor.dev`

## O que pode fazer com isto [#wat-je-ermee-kunt]

Depois de ligado, na ferramenta de IA pode:

1. Consultar categorias de API e endpoints (a partir da especificação OpenAPI)
2. Chamar endpoints com os seus direitos na organização escolhida

Tudo passa pela mesma API REST que a [API HTTP](/ontwikkelaars/http). O que pode fazer depende da sua conta Tillor e das suas permissões nessa organização. Para ligar através de OAuth é necessária a permissão **Autorizar aplicações OAuth** (`oauth:consent`) em pelo menos uma organização. Sem essa permissão, o consentimento falha e os tokens OAuth existentes deixam de funcionar.

## Autenticação [#authenticatie]

1. A ferramenta liga-se a `https://mcp.tillor.dev` sem token
2. A descoberta e o registo OAuth decorrem no anfitrião MCP; o início de sessão e o consentimento no Tillor
3. Aprova o acesso no navegador
4. Depois disso, a ferramenta envia um token Bearer nas chamadas MCP

Envie a sua organização como cabeçalho quando a ferramenta o suportar (Cursor, Gemini CLI):

```http
X-Tillor-Org-Id: org_abc123
```

Sem esse cabeçalho (ChatGPT, aplicação Gemini, Claude), indique `organizationId` em `call_api_endpoint`. As rotas da organização ficam em `/orgs/{organizationId}`; a API preenche então o cabeçalho por si.

<Callout type="info" title="Não é necessária chave de API">
Para o servidor MCP alojado, utilize OAuth (Connect / Authorize na ferramenta). Para scripts e integrações próprias, continue a utilizar [chaves de API](/ontwikkelaars/http).
</Callout>

## Ligar [#koppelen]

Escolha a sua ferramenta:

<McpProviderGuide />

Ou abra o [seletor de instalação](https://install.apicommons.org/?config=eyJuYW1lIjoiVGlsbG9yIiwiZGVzY3JpcHRpb24iOiJUaWxsb3IgUkVTVCBBUEkgdmlhIE9BdXRoIiwicmVtb3RlIjp7InR5cGUiOiJodHRwIiwidXJsIjoiaHR0cHM6Ly9tY3AudGlsbG9yLmRldi9tY3AiLCJoZWFkZXJzIjp7IlgtVGlsbG9yLU9yZy1JZCI6Ijxvcmdhbml6YXRpb25JZD4ifX19) para Cline, Zed, Warp, Codex e as restantes.

## Ferramentas [#tools]

| Ferramenta | Finalidade |
|------|------|
| `list_api_categories` | Lista as categorias de API |
| `list_api_endpoints` | Endpoints de uma categoria, com esquema de entrada |
| `get_api_endpoint_schema` | Esquema de um endpoint pelo nome |
| `call_api_endpoint` | Chama um endpoint |

Os nomes dos endpoints não são ferramentas separadas: utilize `call_api_endpoint`.

A referência REST completa continua a ser o [OpenAPI](https://tillor.eu/api/openapi.json). O MCP é uma camada por cima dela, não uma API de produto separada.

## Relacionado [#gerelateerd]

- [API HTTP](/ontwikkelaars/http) - Chaves de API, cabeçalhos e URL base
- [OpenAPI](https://tillor.eu/api/openapi.json) - Especificação completa da API
- [Referência da API](/api-referentie) - Todos os endpoints, para experimentar no navegador


# Metadados do Mollie (/pt-PT/ontwikkelaars/mollie-metadata)

O Mollie guarda metadados em cada pagamento. O Tillor lê e escreve campos no espaço de nomes `tillor`. Ligação na aplicação: [Mollie](/boekhouden/betalingsrapporten/betaalmethodes/mollie).

Três tipos:

1. **Metadados de ligação** - o Tillor escreve de volta no Mollie para que o pagamento seja reconhecível
2. **Sugestões de ingestão** - define-as ao criar o pagamento Mollie
3. **Metadados contabilísticos diretos** - contornam o Tillor e vão diretamente para a contabilidade

## Metadados de ligação [#koppelingsmetadata]

```json
{
  "tillor": {
    "paymentId": "clx123...",
    "invoiceId": "clx456...",
    "customerId": "clx789...",
    "paymentGroupId": "clxgrp..."
  }
}
```

O Tillor escreve `paymentId`, `invoiceId`, `customerId` e `paymentGroupId` no Mollie assim que um pagamento fica associado a uma fatura, a um cliente ou a um [grupo de pagamentos](/betalingsverwerking/groepen). Os metadados existentes que não sejam do Tillor mantêm-se.

| Campo | Descrição |
|------|---------------|
| `paymentId` | Pagamento do Tillor |
| `invoiceId` | Fatura do Tillor |
| `customerId` | Cliente do Tillor |
| `paymentGroupId` | Grupo de pagamentos, mesmo que esse grupo ainda não esteja associado a uma fatura |

## Sugestão de ingestão: `descriptionSuffix` [#ingestie-hint-descriptionsuffix]

Define-a você ao criar o pagamento Mollie. O Tillor usa-a na descrição do pagamento assim que existir uma ligação a uma fatura.

```json
{
  "tillor": {
    "descriptionSuffix": "Parkeerplaats P1"
  }
}
```

Formato no Tillor: `INV/XXXX/XXXX - {suffix}`.

## Sugestões de ingestão para grupos de pagamentos [#ingestie-hints-voor-betalingsgroepen]

Útil para turnos de POS ou atividades: agrupar vários pagamentos antes de lançar uma fatura.

```json
{
  "tillor": {
    "paymentGroupName": "Yoga sunrise - Lake Como",
    "paymentGroupExternalId": "act_42"
  }
}
```

Basta um dos dois campos. Ambos em conjunto é melhor quando a etiqueta pode mudar mas o ID se mantém estável.

| Campo | Descrição |
|------|---------------|
| `paymentGroupName` | Etiqueta visível no Tillor. Corresponde a grupos abertos existentes pelo nome ou torna-se a etiqueta de um novo grupo |
| `paymentGroupExternalId` | Chave estável do seu sistema. A correspondência faz-se por ela em vez do nome; a etiqueta segue `paymentGroupName` |

1. O Tillor procura um grupo **aberto** com este ID externo (ou, sem ID, com este nome).
2. Sem correspondência? Novo grupo aberto. O nome é `paymentGroupName`, caso contrário `paymentGroupExternalId`.
3. O pagamento entra no grupo assim que estiver **pago** no Tillor.
4. Os grupos que já estão associados a uma fatura não são reutilizados.

As sugestões ainda não estavam no pagamento Mollie quando o Tillor o viu pela primeira vez? O grupo é preenchido mesmo assim, assim que o pagamento estiver **pago**, **não** esteja associado a uma fatura e **ainda não** esteja num grupo. Isto acontece na sincronização seguinte ou numa notificação recebida do Mollie.

<Callout type="info" title="Quando usar?">
Marque previamente cada pagamento Mollie a partir do seu POS. O grupo aparece em *Administração > Pagamentos*, secção *Grupos de pagamentos*.
</Callout>

<Callout type="warn" title="Não combinar com invoiceId">
Um pagamento agrupado não pode ficar associado a uma fatura isoladamente. Se enviar tanto sugestões de grupo como `invoiceId`, o grupo prevalece.
</Callout>

## Metadados contabilísticos diretos (`tillor.bookkeeping`) [#directe-boekhoudmetadata-tillorbookkeeping]

Por defeito, os pagamentos Mollie desconhecidos vão para a conta de espera **499000**. Com `tillor.bookkeeping`, o Tillor lança-os no cliente indicado:

```json
{
  "tillor": {
    "bookkeeping": {
      "customerCode": "100001",
      "documentType": "INV",
      "department": "a",
      "fiscalYear": "2026",
      "documentNumber": "00042"
    }
  }
}
```

| Campo | Descrição |
|------|---------------|
| `customerCode` | Código do cliente na contabilidade - obrigatório |
| `documentType` | Por ex. INV, UF |
| `department` | Departamento |
| `fiscalYear` | Ano fiscal |
| `documentNumber` | Número do documento |

Quando `bookkeeping` está presente, o pagamento **não** entra como um pagamento Tillor normal. Os metadados são usados ao construir o relatório contabilístico.

## Ver também [#zie-ook]

<Cards>
  <Card title="Mollie (aplicação)" href="/boekhouden/betalingsrapporten/betaalmethodes/mollie" />
  <Card title="Grupos de pagamentos" href="/betalingsverwerking/groepen" />
  <Card title="Admisol" href="/boekhouden/betalingsrapporten/boekhoudsystemen/admisol" />
</Cards>


# MQTT (/pt-PT/ontwikkelaars/mqtt)

As credenciais MQTT dão às integrações acesso pub/sub dentro do espaço de nomes de tópicos da sua organização. Cria as credenciais no Tillor em **Conta > Programadores** (por organização). O acesso aos tópicos limita-se a `tillor/{env}/{orgId}/integration` e subtópicos (`{env}` = `prod`, `staging` ou `local`), a menos que uma credencial estática tenha `topicPrefix: null`.

Para os mesmos eventos em tempo real que os [webhooks](/ontwikkelaars/webhooks) e o [SSE](/ontwikkelaars/sse), utilize esses canais, não o MQTT.

## Gestão [#beheer]

| Método | Caminho | Descrição |
|--------|------|---------------|
| POST | `/api/orgs/:orgId/mqtt/credentials` | Gerar credenciais JWT (temporárias) |
| GET | `/api/orgs/:orgId/mqtt/static-credentials` | Obter credenciais estáticas |
| POST | `/api/orgs/:orgId/mqtt/static-credentials` | Criar uma credencial estática |
| DELETE | `/api/orgs/:orgId/mqtt/static-credentials/:id` | Eliminar uma credencial estática |

Autenticação: `x-api-key`, com o ID da organização no caminho (como na [API HTTP](/ontwikkelaars/http)). Consulte a [especificação OpenAPI](https://tillor.eu/api/openapi.json) para os esquemas completos de pedido e resposta.

## Credenciais [#credentials]

Existem duas variantes:

### JWT (temporário) [#jwt-tijdelijk]

- **Utilização:** Sessões curtas, acesso temporário
- **Validade:** Por defeito 1 hora; configurável de 1 minuto a 24 horas através de `expiresInSeconds`
- **Ideal para:** Testes, ligações temporárias, ou quando obtém tokens dinamicamente
- **Criação:** No Tillor em **Conta > Programadores**, ou através de `POST /api/orgs/:orgId/mqtt/credentials` com, opcionalmente, `{ "clientId": "...", "expiresInSeconds": 3600 }`
- **Resposta:** `token` (use-o como palavra-passe MQTT), `clientId`, `brokerUrl`, `topicPrefix`, `expiresAt`
- **Nome de utilizador:** Deixe vazio ao ligar; a autenticação JWT usa apenas o token como palavra-passe.
- **ID do cliente:** Use exatamente o `clientId` da resposta ao ligar (incluindo o prefixo do ambiente, por ex. `prod-`).

Uma ligação ao broker através de **mqtts** verifica o certificado do servidor. Se usar um certificado de CA **privada** (não a cadeia pública habitual), coloque o PEM dessa CA no ambiente do seu cliente.

### Credenciais estáticas [#statische-credentials]

- **Utilização:** Integrações de longa duração, ligações sempre ativas
- **Forma:** userName, clientId e password fixos
- **Ideal para:** Integrações de produção que permanecem continuamente ligadas
- **Criação:** No Tillor em **Conta > Programadores**, ou através de `POST /api/orgs/:orgId/mqtt/static-credentials` com, opcionalmente, `{ "name": "mijn-integratie", "topicPrefix": null }`
- **Resposta:** `userName`, `clientId`, `password` (uma única vez), `topicPrefix` (`null` = sem prefixo, ACL `#`), opcionalmente `brokerUrl`
- **Atenção:** A palavra-passe é mostrada uma única vez na resposta e não pode ser obtida novamente depois

---

## Acesso a tópicos [#topic-toegang]

As subscrições de tópicos são **estritamente limitadas**, a menos que `topicPrefix` seja `null` (ACL `#`). Por defeito, só pode publicar e subscrever `tillor/{env}/{orgId}/integration` e `tillor/{env}/{orgId}/integration/#`.

- **Tópicos permitidos** - Apenas `tillor/{env}/{orgId}/integration` e subtópicos (por ex. `tillor/{env}/{orgId}/integration/connector/access-point-operation`)
- **Sem contornar com wildcards** - Mesmo com `#` ou `+`, só tem acesso ao espaço de nomes da sua organização
- **Por organização** - As credenciais são por organização; não tem acesso aos tópicos de outras organizações

---

## Relacionado [#gerelateerd]

- [OpenAPI](https://tillor.eu/api/openapi.json) - Especificação completa da API
- [API HTTP](/ontwikkelaars/http) - API REST e chaves de API
- [Webhooks](/ontwikkelaars/webhooks) - Os mesmos eventos através de HTTP POST
- [SSE](/ontwikkelaars/sse) - Transmitir eventos através de Server-Sent Events


# OAuth-clients (/pt-PT/ontwikkelaars/oauth-clients)

Met een OAuth-client meldt een andere applicatie mensen aan met hun Tillor-account. Tillor is daarbij de OpenID Connect-provider: de applicatie stuurt de gebruiker naar Tillor, de gebruiker meldt zich aan en geeft toestemming, en de applicatie krijgt te horen wie het is. Je gebruikt dat voor een eigen applicatie, of voor single sign-on bij een externe dienst die aanmelden via een eigen identiteitsprovider ondersteunt.

Standaard kan elk Tillor-account zich via een client aanmelden. Voor single sign-on bij een externe dienst wil je dat bijna nooit: beperk de client dan tot mensen van je organisatie.

## Wat je nodig hebt [#wat-je-nodig-hebt]

- De **redirect-URI** die de applicatie of dienst opgeeft.
- Wie zich aanmeldt, heeft het recht **OAuth-apps autoriseren** nodig. Zie [OAuth-apps](/gebruikers/organisaties#oauth-apps).
- Om een client tot je organisatie te beperken: het recht **Integraties beheren** in die organisatie.

## Een client aanmaken [#een-client-aanmaken]

<Steps>
<Step>

Klik in de sidebar op je naam en kies <UIPath>Account > OAuth-clients</UIPath>. Klik op **OAuth-client aanmaken**.

</Step>
<Step>

Vul de **Applicatienaam** in en zet elke **Redirect-URI** op een eigen regel. Vink **Publieke client** alleen aan voor een applicatie die geen geheim kan bewaren, zoals een mobiele app.

</Step>
<Step>

Kies wie zich mag aanmelden. Zie [Beperken wie zich mag aanmelden](#beperken-wie-zich-mag-aanmelden).

</Step>
<Step>

Sla op. Tillor toont de **Client-ID** en het **Clientgeheim**. Het geheim zie je alleen nu: kopieer het en bewaar het veilig.

</Step>
</Steps>

In de applicatie of dienst vul je de client-ID, het clientgeheim en het adres van Tillor als provider in: `https://tillor.eu/api/auth`. De meeste diensten lezen de rest zelf uit `https://tillor.eu/api/auth/.well-known/openid-configuration`.

## Beperken wie zich mag aanmelden [#beperken-wie-zich-mag-aanmelden]

Vink **Alleen mensen van (je organisatie) kunnen aanmelden** aan in het venster van de client. De beperking geldt voor de organisatie waarin je op dat moment werkt. Daarna kan je ze verder vernauwen:

| Voorwaarde | Wie voldoet |
|---|---|
| Organisatie (altijd) | Wie lid is van de organisatie |
| **Groepen** (nul of meer) | Wie in **minstens één** van de gekozen [groepen](/gebruikers/groepen) zit |
| **Permissies** (nul of meer) | Wie **alle** gekozen rechten heeft in de organisatie, met de rechten uit groepen meegerekend |

De voorwaarden gelden samen: iemand moet lid zijn, **en** in een van de groepen zitten, **en** alle rechten hebben. Een lege lijst groepen of permissies telt niet mee. Kies je dus geen groepen en geen permissies, dan mag elk lid van de organisatie zich aanmelden.

Een voorbeeld: je kiest de groep "Boekhouding" en het recht om betalingen te bekijken. Alleen wie lid is van je organisatie, in "Boekhouding" zit en betalingen mag bekijken, komt binnen.

De kolom **Wie kan aanmelden** in de lijst van clients toont de beperking van elke client.

<Callout type="info" title="Goed om te weten">
- Kies bij voorkeur **groepen**. Een groep is van jou: je bepaalt zelf wie erin zit. De betekenis van een recht kan in een latere versie van Tillor veranderen, en dan verandert mee wie zich bij de externe dienst kan aanmelden.
- Tillor controleert de voorwaarden bij elke aanmelding en telkens wanneer de applicatie de sessie vernieuwt. Wie de organisatie of de groep verlaat of een recht verliest, krijgt geen nieuwe toegang meer. Toegang die al was uitgereikt, vervalt binnen het uur.
- Voor een beheerder van Tillor zelf gelden dezelfde voorwaarden. Zo iemand is lid van elke organisatie: kies een groep als alleen je eigen mensen binnen mogen.
- Je wijzigt of verwijdert de beperking vanuit de organisatie waarvoor ze geldt. Werk je in een andere organisatie, dan toont het venster alleen voor welke organisatie de client beperkt is.
- Elke wijziging van de beperking en elke geweigerde aanmelding staat in de [activiteitenlog](/activiteitenlog) van de organisatie.
</Callout>

## Problemen? [#problemen]

**Iemand krijgt bij de externe dienst de fout `access_denied`.**
Die persoon voldoet niet aan de voorwaarden van de client. Kijk in de activiteitenlog naar de regel **Toegang geweigerd**: de reden zegt of het om het lidmaatschap, de groep of een recht gaat.

**Iemand ziet op het toestemmingsscherm "Niet beschikbaar voor uw account".**
Zelfde oorzaak: de client is beperkt en dit account voldoet niet. Voeg de persoon toe aan de juiste groep of geef het ontbrekende recht.

**Bij een groep staat "Verwijderde groep".**
De groep bestaat niet meer, en niemand kan er nog in zitten. Was het de enige gekozen groep, dan kan niemand zich aanmelden. Vink ze uit of kies een andere groep.

**Het vakje om te beperken is grijs.**
Je mist het recht **Integraties beheren** in deze organisatie. Vraag het aan een beheerder.

**Na het verlies van een recht blijft iemand nog even aangemeld bij de externe dienst.**
De externe dienst houdt zijn eigen sessie bij. Tillor weigert de volgende vernieuwing; hoe snel de dienst de persoon afmeldt, hangt van die dienst af.


# Server-Sent Events (SSE) (/pt-PT/ontwikkelaars/sse)

O SSE oferece uma transmissão de longa duração dos mesmos eventos que os [webhooks](/ontwikkelaars/webhooks) recebem. Utilize o SSE quando preferir uma ligação persistente em vez de chamadas de retorno HTTP.

## Endpoint [#endpoint]

```
GET /api/orgs/:orgId/realtime/subscribe
```

## Autenticação [#authenticatie]

O SSE usa a mesma autenticação que os outros endpoints da API:

- **x-api-key** - A sua chave de API

O ID da organização está no caminho do URL.

## Filtragem de eventos [#event-filtering]

Utilize o parâmetro de consulta `events` para filtrar por tipo de evento:

```
GET /api/orgs/:orgId/realtime/subscribe?events=invoice:created&events=invoice:paid
```

Utilize `events=*` para receber todos os eventos (o mesmo que omitir o parâmetro).

Consulte o [Índice de eventos](/ontwikkelaars/events) para todos os eventos, a permissão de cada evento e um exemplo de payload.

Alguns eventos estão num canal próprio (registos de controladores e E/S de controladores). Esses só os recebe com `?channel=controller-logs` ou `?channel=controller-io`; o Índice de eventos indica o canal.

O Tillor só entrega eventos para os quais o membro da organização com sessão iniciada tem permissão. Sem `bank-transactions:read` (ou sync), por exemplo, não recebe eventos `bankAccountTransaction:*`, nem mesmo que não envie qualquer filtro `events`.

Os dados associados de outro domínio seguem as mesmas regras que a API: sem `customers:read`, um `reservation:updated` chega com `customer: null`, e sem `payments:read` um `invoice:paid` chega com `payment: null`. Uma lista passa então a `[]`.

---

## Formato do evento [#event-formaat]

O payload tem a mesma estrutura que as [entregas de webhook](/ontwikkelaars/webhooks#webhook-payload):

| Campo | Tipo | Descrição |
|-------|------|--------------|
| `event` | string | Chave do evento (por ex. `invoice:created`) |
| `data` | object | Payload específico do evento |
| `timestamp` | number | Unix timestamp (ms) em que o evento foi emitido |
| `traceId` | string | ID de trace OpenTelemetry da ação do Tillor que causou este evento (o mesmo que nos [webhooks](/ontwikkelaars/webhooks#webhook-payload)) |
| `spanId` | string (opcional) | Span dentro desse trace |

Na transmissão SSE, este objeto JSON está na linha `data:`; a chave do evento também está na linha `event:`. Consulte os [exemplos de SSE](/ontwikkelaars/voorbeelden/sse) para um exemplo em formato de transmissão.

---

## Exemplo: Node.js [#voorbeeld-nodejs]

```javascript
const orgId = "org_abc123";
const apiKey = "tkn_xxx";

const url = `https://app.tillor.eu/api/orgs/${orgId}/realtime/subscribe?events=invoice:created&events=customer:updated`;

const response = await fetch(url, {
  headers: {
    "x-api-key": apiKey,
    "Accept": "text/event-stream",
  },
});

const reader = response.body.getReader();
const decoder = new TextDecoder();

while (true) {
  const { done, value } = await reader.read();
  if (done) break;

  const chunk = decoder.decode(value, { stream: true });
  for (const line of chunk.split("\n")) {
    if (line.startsWith("data: ")) {
      const payload = JSON.parse(line.slice(6));
      console.log(payload.event, payload.data);
    }
  }
}
```

---

## Exemplo: cURL [#voorbeeld-curl]

```bash
curl -N -H "x-api-key: tkn_xxx" \
     -H "Accept: text/event-stream" \
     "https://app.tillor.eu/api/orgs/org_abc123/realtime/subscribe"
```

---

## Religação [#herverbinding]

Se a ligação cair, volte a ligar com o mesmo URL e cabeçalhos. A transmissão não suporta retoma; depois de religar, só recebe novos eventos.

---

## Relacionado [#gerelateerd]

- [OpenAPI](https://tillor.eu/api/openapi.json) - Especificação completa da API
- [API HTTP](/ontwikkelaars/http) - Chaves de API e autenticação
- [Webhooks](/ontwikkelaars/webhooks) - Os mesmos eventos através de HTTP POST
- [Exemplos](/ontwikkelaars/voorbeelden) - Exemplos de código e de payload


# Exemplos HTTP (/pt-PT/ontwikkelaars/voorbeelden/http)

Horário de funcionamento e feriados para um site público: [API de horário de funcionamento](/ontwikkelaars/voorbeelden/opening-hours).

## Pedido à API com cURL [#api-request-met-curl]

```bash
curl -X GET "https://tillor.eu/api/orgs/org_abc123/customers" \
  -H "x-api-key: tkn_xxx" \
  -H "Content-Type: application/json"
```

## Criar uma chave de API [#api-sleutel-aanmaken]

```bash
curl -X POST "https://tillor.eu/api/api-keys" \
  -H "Cookie: session=..." \
  -H "Content-Type: application/json" \
  -d '{"name": "Mijn integratie", "description": "Optionele beschrijving"}'
```

## Criar um webhook [#webhook-aanmaken]

```bash
curl -X POST "https://tillor.eu/api/orgs/org_abc123/webhooks" \
  -H "x-api-key: tkn_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://jouw-server.com/webhooks/tillor",
    "subscribedEventKeys": ["invoice:created", "invoice:paid", "customer:updated"],
    "enabled": true
  }'
```


# Visão geral (/pt-PT/ontwikkelaars/voorbeelden)

Exemplos prontos a usar para começar. Cada exemplo usa os marcadores `org_abc123` e `tkn_xxx`; substitua-os pelo ID da sua organização e pela sua chave de API.

<Cards>
  <Card
    title="Exemplos HTTP"
    href="/ontwikkelaars/voorbeelden/http"
    description="Exemplos de cURL e de pedidos para a API do Tillor"
  />
  <Card
    title="API de horário de funcionamento"
    href="/ontwikkelaars/voorbeelden/opening-hours"
    description="Obter o horário de funcionamento resolvido e os próximos feriados para um site"
  />
  <Card
    title="Exemplos de webhooks"
    href="/ontwikkelaars/voorbeelden/webhooks"
    description="Payloads de eventos e exemplos de POST de webhook"
  />
  <Card
    title="Exemplos de SSE"
    href="/ontwikkelaars/voorbeelden/sse"
    description="Node.js e cURL para Server-Sent Events"
  />
</Cards>


# API de horário de funcionamento (/pt-PT/ontwikkelaars/voorbeelden/opening-hours)

Utilize a API de horário de funcionamento **resolvido** quando mostrar num site público horários sazonais (por exemplo **Zomer** / **Winter**) ou os próximos **feriados**. O Tillor já aplica exceções, períodos sazonais e o horário semanal normal, e acrescenta os feriados legais no intervalo pedido. Não precisa de voltar a implementar isso.

**Permissão:** `organization:settings:read` ou `organization:settings:write`

<Callout type="warn" title="A chave de API fica do lado do servidor">
Chame o Tillor apenas a partir de um servidor (Next.js Route Handler, Server Component ou backend). Guarde a chave em variáveis de ambiente. Nunca a envie para o navegador.
</Callout>

Autenticação: consulte a [API HTTP](/ontwikkelaars/http). Experimente o endpoint na [referência da API](/api-referentie) ou através do [OpenAPI](https://tillor.eu/api/openapi.json) (etiqueta `organization-settings`).

## Endpoint [#endpoint]

```
GET https://tillor.eu/api/orgs/org_abc123/organization-settings/opening-hours
```

Cabeçalhos:

```http
x-api-key: tkn_xxx
```

Substitua `org_abc123` pelo ID da sua organização.

### Parâmetros de consulta [#queryparameters]

Utilize **ou** `date`, **ou** `from`/`to`. Não os combine.

| Parâmetro | Significado |
|-----------|-----------|
| *(nenhum)* | Hoje, no fuso horário da organização |
| `date` | Um único dia de calendário (`YYYY-MM-DD`) |
| `from` | Dia inicial (inclusive). Sem `to`: apenas esse dia |
| `to` | Dia final (inclusive). Requer `from`. No máximo **366** dias |
| `languageIsoCode` | Idioma dos nomes dos feriados (`NL`, `FR`, …). Por defeito: o idioma da organização |

## Resposta [#response]

Cada item é um dia de calendário, já resolvido:

| Campo | Significado |
|------|-----------|
| `timeZone` | Fuso horário IANA da organização |
| `from` / `to` | Intervalo pedido |
| `holidays` | Feriados legais que se sobrepõem a `from`–`to` |
| `items[].date` | Dia de calendário `YYYY-MM-DD` |
| `items[].weekday` | `monday` … `sunday` |
| `items[].source` | `exception`, `period` ou `regular` |
| `items[].periodLabel` | Apenas com `source: "period"`: a etiqueta do Tillor, por exemplo `"Zomer"` ou `"Winter"` |
| `items[].holiday` | Apenas se esse dia for um feriado legal: `{ id, name, startDate, endDate }` |
| `items[].blocks` | Intervalos de tempo em minutos desde a meia-noite |
| `items[].closed` | `true` se `blocks` estiver vazio |

Prioridade: **exceção** (feriado ou intervalo personalizado) → último **período sazonal** correspondente → horário semanal **normal**.

As etiquetas sazonais vêm de *Definições > Horário de funcionamento*. Os períodos podem atravessar a viragem do ano (por exemplo de 1 de novembro a 31 de março). Os dias fora de qualquer período recorrem ao horário semanal normal (`source: "regular"`, sem `periodLabel`).

### Minutos para hora do relógio [#minuten-naar-kloktijd]

`startMinutes` / `endMinutes` são minutos desde as 00:00.

| Minutos | Hora |
|--------:|------|
| 540 | 09:00 |
| 600 | 10:00 |
| 720 | 12:00 |
| 780 | 13:00 |
| 1020 | 17:00 |
| 1140 | 19:00 |

```ts
function formatMinutes(minutes: number): string {
  const hour = Math.floor(minutes / 60);
  const minute = minutes % 60;
  return `${String(hour).padStart(2, "0")}:${String(minute).padStart(2, "0")}`;
}
```

## Exemplos [#voorbeelden]

### Dia num período sazonal [#dag-in-een-seizoensperiode]

```bash
curl -X GET "https://tillor.eu/api/orgs/org_abc123/organization-settings/opening-hours?date=2026-07-15" \
  -H "x-api-key: tkn_xxx"
```

```json
{
  "timeZone": "Europe/Brussels",
  "from": "2026-07-15",
  "to": "2026-07-15",
  "holidays": [],
  "items": [
    {
      "date": "2026-07-15",
      "weekday": "wednesday",
      "source": "period",
      "periodLabel": "Zomer",
      "blocks": [{ "startMinutes": 540, "endMinutes": 720 }],
      "closed": false
    }
  ]
}
```

09:00–12:00, horário de verão.

### Dia fora dos períodos sazonais [#dag-buiten-seizoensperiodes]

```bash
curl -X GET "https://tillor.eu/api/orgs/org_abc123/organization-settings/opening-hours?date=2026-01-15" \
  -H "x-api-key: tkn_xxx"
```

```json
{
  "timeZone": "Europe/Brussels",
  "from": "2026-01-15",
  "to": "2026-01-15",
  "holidays": [],
  "items": [
    {
      "date": "2026-01-15",
      "weekday": "thursday",
      "source": "regular",
      "blocks": [
        { "startMinutes": 540, "endMinutes": 720 },
        { "startMinutes": 780, "endMinutes": 1020 }
      ],
      "closed": false
    }
  ]
}
```

09:00–12:00 e 13:00–17:00.

### Intervalo que atravessa o limite de um período [#range-over-een-periodegrens]

```bash
curl -X GET "https://tillor.eu/api/orgs/org_abc123/organization-settings/opening-hours?from=2026-03-30&to=2026-04-02" \
  -H "x-api-key: tkn_xxx"
```

| Data | `source` | `periodLabel` |
|-------|----------|---------------|
| 2026-03-30 | `regular` | - |
| 2026-03-31 | `regular` | - |
| 2026-04-01 | `period` | `Zomer` |
| 2026-04-02 | `period` | `Zomer` |

## Próximos feriados [#komende-feestdagen]

Os feriados legais vêm na mesma resposta: `holidays` para uma lista (nome + datas), `items[].holiday` se esse dia de calendário for um feriado. As horas continuam a ser o horário resolvido; um feriado sem exceção preenchida no Tillor segue o horário sazonal ou semanal (`source` não é então `"exception"`).

```bash
curl -X GET "https://tillor.eu/api/orgs/org_abc123/organization-settings/opening-hours?from=2026-08-27&to=2026-12-31&languageIsoCode=NL" \
  -H "x-api-key: tkn_xxx"
```

```json
{
  "timeZone": "Europe/Brussels",
  "from": "2026-08-27",
  "to": "2026-12-31",
  "holidays": [
    {
      "id": "0fad0035-6b77-404a-953d-c66dac014483",
      "name": "Allerheiligen",
      "startDate": "2026-11-01",
      "endDate": "2026-11-01"
    },
    {
      "id": "d90e5f53-bc92-4860-bdae-f7e75935848d",
      "name": "Kerstmis",
      "startDate": "2026-12-25",
      "endDate": "2026-12-25"
    }
  ],
  "items": [
    {
      "date": "2026-11-01",
      "weekday": "sunday",
      "source": "regular",
      "holiday": {
        "id": "0fad0035-6b77-404a-953d-c66dac014483",
        "name": "Allerheiligen",
        "startDate": "2026-11-01",
        "endDate": "2026-11-01"
      },
      "blocks": [],
      "closed": true
    }
  ]
}
```

O exemplo de `items` acima está encurtado; a resposta real contém todos os dias do intervalo. As férias escolares não estão neste endpoint; essas continuam em `GET /holidays?kind=school`.

## Next.js (servidor) [#nextjs-server]

Para um widget semanal ou “aberto agora” num site público:

```ts
const TILLOR_API_URL = "https://tillor.eu";
const ORGANIZATION_ID = process.env.TILLOR_ORG_ID ?? "";

type OpeningHoursBlock = {
  startMinutes: number;
  endMinutes: number;
};

type OpeningHoursHoliday = {
  id: string;
  name: string;
  startDate: string;
  endDate: string;
};

type OpeningHoursItem = {
  date: string;
  weekday: string;
  source: "exception" | "period" | "regular";
  periodLabel?: string;
  holiday?: OpeningHoursHoliday;
  blocks: OpeningHoursBlock[];
  closed: boolean;
};

type OpeningHoursResponse = {
  timeZone: string;
  from: string;
  to: string;
  holidays: OpeningHoursHoliday[];
  items: OpeningHoursItem[];
};

export async function getOpeningHours(
  from: string,
  to: string,
): Promise<OpeningHoursResponse> {
  const url = new URL(
    `${TILLOR_API_URL}/api/orgs/${ORGANIZATION_ID}/organization-settings/opening-hours`,
  );
  url.searchParams.set("from", from);
  url.searchParams.set("to", to);
  url.searchParams.set("languageIsoCode", "NL");

  const response = await fetch(url, {
    headers: {
      "x-api-key": process.env.TILLOR_API_KEY ?? "",
    },
    next: { tags: ["opening-hours"], revalidate: 3600 },
  });

  if (!response.ok) {
    throw new Error(`Tillor opening hours ${response.status}`);
  }

  return response.json() as Promise<OpeningHoursResponse>;
}
```

`holidays` é a lista para um bloco de “próximos feriados”. `items[].holiday` é útil num calendário semanal. `items[].periodLabel` é o texto sazonal (por exemplo `"Zomer"` ou `"Winter"`). Uma cache de 1 hora costuma bastar.

## Invalidar a cache (webhook) [#cache-ongeldig-maken-webhook]

A cada alteração das definições da organização, o Tillor envia `organizationSettings:updated` (webhook e SSE). Subscreva esse evento e volte a obter o horário de funcionamento. O payload é propositadamente pequeno (sem IPs de impressoras nem o horário completo):

```json
{
  "event": "organizationSettings:updated",
  "data": {
    "openingHoursChanged": true
  },
  "timestamp": 1787829600000
}
```

`openingHoursChanged` é `true` se o horário de funcionamento, o fuso horário ou o país predefinido mudarem - é isso que afeta `GET .../opening-hours`. Com `false`, pode manter a cache do horário de funcionamento.

Exemplo de Route Handler do Next.js:

```ts
import { revalidateTag } from "next/cache";

export async function POST(request: Request) {
  const body = (await request.json()) as {
    event?: string;
    data?: { openingHoursChanged?: boolean };
  };
  if (body.event === "organizationSettings:updated" && body.data?.openingHoursChanged) {
    await revalidateTag("opening-hours");
  }
  return new Response(null, { status: 204 });
}
```

Criar um webhook: consulte [Webhooks](/ontwikkelaars/webhooks). Chave do evento: `organizationSettings:updated` (permissão `organization:settings:read` ou `organization:settings:write`).

## Horário completo (opcional) [#volledig-rooster-optioneel]

Só é necessário se quiser mostrar o próprio calendário sazonal (etiquetas + `fromMonth`/`untilDay`), sem resolver dia a dia:

```
GET https://tillor.eu/api/orgs/org_abc123/organization-settings
```

Leia `openingHoursSchedule.periods` (etiquetas como `"Zomer"`) e `openingHoursSchedule.weekdays` (horário normal). Para o próprio site, `GET .../opening-hours` continua a ser a fonte mais simples.

## MCP [#mcp]

No Cursor ou no Claude: endpoint `organizationSettings_listOpeningHours` (categoria `organizationSettings`), argumentos `organizationId`, opcionalmente `date` ou `from`/`to`, opcionalmente `languageIsoCode`.

## Relacionado [#gerelateerd]

- [API HTTP](/ontwikkelaars/http) - autenticação e cabeçalhos
- [Exemplos HTTP](/ontwikkelaars/voorbeelden/http) - exemplos gerais de cURL
- [Webhooks](/ontwikkelaars/webhooks) - `organizationSettings:updated` para revalidação da cache
- [Definições da organização](/gebruikers/organisaties) - definir o horário de funcionamento no Tillor


# Exemplos de SSE (/pt-PT/ontwikkelaars/voorbeelden/sse)

## cURL [#curl]

```bash
curl -N -H "x-api-key: tkn_xxx" \
     "https://app.tillor.eu/api/orgs/org_abc123/realtime/subscribe"
```

## Node.js [#nodejs]

```javascript
const orgId = "org_abc123";
const apiKey = "tkn_xxx";

const url = `https://app.tillor.eu/api/orgs/${orgId}/realtime/subscribe?events=invoice:created&events=customer:updated`;

const response = await fetch(url, {
  headers: {
    "x-api-key": apiKey,
    "Accept": "text/event-stream",
  },
});

const reader = response.body.getReader();
const decoder = new TextDecoder();

while (true) {
  const { done, value } = await reader.read();
  if (done) break;

  const chunk = decoder.decode(value, { stream: true });
  for (const line of chunk.split("\n")) {
    if (line.startsWith("data: ")) {
      const payload = JSON.parse(line.slice(6));
      console.log(payload.event, payload.data);
    }
  }
}
```

## Mensagem SSE [#sse-bericht]

Uma mensagem SSE (`text/event-stream`) tem este aspeto:

```
event: message
data: {"event":"invoice:paid","data":{"invoice":{"id":"inv_def456uvw","displayId":"2025-00123","status":"BOOKED","paymentStatus":"PAID","amountTotal":200,"paidDate":"2025-03-09T12:15:00.000Z","customerId":"cust_abc123xyz"},"payment":{"id":"pay_ghi789rst","amount":200,"status":"PAID","method":"BANCONTACT","provider":"MOLLIE","paidAt":"2025-03-09T12:15:00.000Z"}},"timestamp":1735811700000}

```

A linha `event` do SSE é `message`. Faça o parse da linha `data` como JSON: contém o evento do Tillor (`event`), o payload (`data`) e `timestamp` (ms). Recebe o mesmo objeto JSON através de [webhooks](/ontwikkelaars/webhooks).


# Exemplos de webhooks (/pt-PT/ontwikkelaars/voorbeelden/webhooks)

Os mesmos eventos que no [SSE](/ontwikkelaars/voorbeelden/sse). A estrutura do payload é idêntica.

## Estrutura do invólucro [#wrapper-structuur]

```json
{
  "event": "entity:action",
  "data": {},
  "timestamp": 1735689600000,
  "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",
  "spanId": "00f067aa0ba902b7"
}
```

O `traceId` pertence à ação do Tillor que causou o evento (por ex. uma chamada à API ou um processamento interno), não a uma nova tentativa posterior do webhook.

## Exemplo de POST de webhook [#webhook-post-voorbeeld]

Um pedido POST de webhook completo tem este aspeto:

```http
POST /webhooks/tillor HTTP/1.1
Host: your-server.com
Content-Type: application/json

{
  "event": "invoice:paid",
  "data": {
    "invoice": {
      "id": "inv_def456uvw",
      "displayId": "2025-00123",
      "status": "BOOKED",
      "paymentStatus": "PAID",
      "amountTotal": 200.0,
      "paidDate": "2025-03-09T12:15:00.000Z",
      "customerId": "cust_abc123xyz"
    },
    "payment": {
      "id": "pay_ghi789rst",
      "amount": 200.0,
      "status": "PAID",
      "method": "BANCONTACT",
      "channel": "ONLINE",
      "provider": "MOLLIE",
      "paidAt": "2025-03-09T12:15:00.000Z"
    }
  },
  "timestamp": 1735811700000,
  "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",
  "spanId": "00f067aa0ba902b7"
}
```

## Payloads de eventos [#event-payloads]

### customer:created [#customercreated]

```json
{
  "event": "customer:created",
  "data": {
    "id": "cust_abc123xyz",
    "displayId": 1042,
    "firstName": "Jan",
    "lastName": "Jansen",
    "email": "jan.jansen@voorbeeld.nl",
    "phone": "+31612345678",
    "address": "Hoofdstraat 42",
    "city": "Amsterdam",
    "zipCode": "1012 AB",
    "country": "NL",
    "customerType": "STANDARD",
    "status": "DEFAULT",
    "createdAt": "2025-03-09T10:30:00.000Z",
    "updatedAt": "2025-03-09T10:30:00.000Z"
  },
  "timestamp": 1735806600000
}
```

### invoice:paid [#invoicepaid]

```json
{
  "event": "invoice:paid",
  "data": {
    "invoice": {
      "id": "inv_def456uvw",
      "displayId": "2025-00123",
      "status": "BOOKED",
      "paymentStatus": "PAID",
      "amountTotal": 200.0,
      "paidDate": "2025-03-09T12:15:00.000Z",
      "customerId": "cust_abc123xyz"
    },
    "payment": {
      "id": "pay_ghi789rst",
      "amount": 200.0,
      "status": "PAID",
      "method": "BANCONTACT",
      "channel": "ONLINE",
      "provider": "MOLLIE",
      "paidAt": "2025-03-09T12:15:00.000Z"
    }
  },
  "timestamp": 1735811700000
}
```

### controller:adoption:requested [#controlleradoptionrequested]

```json
{
  "event": "controller:adoption:requested",
  "data": {
    "adoptionId": "adopt_jkl012mno",
    "efuseId": "a1b2c3d4e5f6",
    "requestedFromIp": "192.168.1.42",
    "isNew": true
  },
  "timestamp": 1735809000000
}
```

### nfc-tag:presented [#nfc-tagpresented]

```json
{
  "event": "nfc-tag:presented",
  "data": {
    "id": "nfc_123abc456",
    "uid": "04A1B2C3D4E5F6",
    "type": "CARD",
    "balance": 25.5,
    "blockedAt": null,
    "customerId": "cust_abc123xyz"
  },
  "timestamp": 1735807500000
}
```

### organizationSettings:updated [#organizationsettingsupdated]

```json
{
  "event": "organizationSettings:updated",
  "data": {
    "openingHoursChanged": true
  },
  "timestamp": 1787829600000
}
```

Consulte a [API de horário de funcionamento](/ontwikkelaars/voorbeelden/opening-hours) para a revalidação da cache num site público.

## Enums [#enums]

| Entidade | Enum | Valores |
|--------|------|---------|
| Customer | `customerType` | `STANDARD`, `WORKER_RENTAL_CARAVAN`, `WORKER_TOWING_CARAVAN` |
| Invoice | `status` | `DRAFT`, `BOOKED` |
| Invoice | `paymentStatus` | `UNPAID`, `PARTIALLY_PAID`, `PENDING`, `PAID` |
| Payment | `status` | `PENDING`, `AUTHORIZED`, `PAID`, `CANCELED`, `FAILED`, `EXPIRED`, `REFUNDED`, `PARTIALLY_REFUNDED`, `CHARGED_BACK` |
| Payment | `method` | `UNKNOWN`, `BANCONTACT`, `IDEAL`, `CREDITCARD`, `CASH`, … (lista completa no OpenAPI) |
| Payment | `channel` | `MANUAL`, `BANK_TRANSFER`, `TERMINAL`, `ONLINE`, `MANDATE` |
| Payment | `provider` | `MOLLIE`, `MANUAL`, `PONTO` |
| Controller | `type` | `ACCESS`, `SHOWER`, `CHARGE_POINT` |
| NfcTag | `type` | `CARD`, `BRACELET`, `STICKER`, `KEY_FOB` |


# Webhooks (/pt-PT/ontwikkelaars/webhooks)

Os webhooks recebem eventos em tempo real através de HTTP POST para um URL configurado por si. Os mesmos eventos estão também disponíveis através de [SSE](/ontwikkelaars/sse). Os webhooks são configurados **por organização** - cada organização tem os seus próprios webhooks.

## Gestão [#beheer]

Consulte a [especificação OpenAPI](https://tillor.eu/api/openapi.json) para os esquemas completos de pedido e resposta.

| Método | Caminho | Descrição |
|--------|------|-------------|
| GET | `/api/orgs/:orgId/webhooks` | Obter webhooks |
| GET | `/api/orgs/:orgId/webhooks/delivery-stats` | Obter estatísticas de entrega |
| POST | `/api/orgs/:orgId/webhooks/retry-deliveries` | Repetir entregas. Corpo: `mode` (`failed` ou `force`) e, opcionalmente, `id` para um único webhook. `failed`: apenas entregas definitivamente falhadas, de imediato. `force`: entregas em espera e definitivamente falhadas, em segundo plano, ignorando os tempos de espera. |
| GET | `/api/orgs/:orgId/webhooks/:id` | Obter um webhook por ID |
| POST | `/api/orgs/:orgId/webhooks` | Criar um webhook |
| PATCH | `/api/orgs/:orgId/webhooks/:id` | Atualizar um webhook |
| DELETE | `/api/orgs/:orgId/webhooks/:id` | Eliminar um webhook |

## Criar um webhook [#webhook-aanmaken]

```http
POST /api/orgs/org_abc123/webhooks
Content-Type: application/json
x-api-key: tkn_xxx
```

```json
{
  "url": "https://jouw-server.com/webhooks/tillor",
  "subscribedEventKeys": ["invoice:created", "invoice:paid", "customer:updated"],
  "enabled": true
}
```

- **url** - Endpoint HTTPS que aceita pedidos POST
- **subscribedEventKeys** - Array de chaves de eventos ou `["*"]` para todos os eventos. A lista completa está no Tillor em **Conta → Programadores**, em **Adicionar webhook** → **Eventos subscritos**.

Alguns eventos ocorrem com tanta frequência que não os pode escolher e que também não chegam através de `*`, como o estado físico das cancelas, a escrita na caixa de entrada, os registos de controladores e a presença de veículos. Esses não constam da lista abaixo. Os eventos que pode escolher dependem também das suas permissões.
- **enabled** - `true` para ativar a entrega

Só pode escolher eventos para os quais o seu membro da organização tenha a permissão adequada (por ex. transações bancárias para `bankAccountTransaction:*`). O wildcard `*` só está disponível para membros com acesso total (`*`). Perante uma combinação inválida, a API devolve um erro. Um webhook reencaminha o payload completo, com os dados associados (como o cliente numa reserva). Por isso, tem de poder ler também esses domínios para criar um webhook, alterar o URL ou os eventos, ou voltar a ativá-lo.

---

## Payload do webhook [#webhook-payload]

Cada entrega de webhook é um POST com:

**Cabeçalhos:**
- `Content-Type: application/json`
- `X-Webhook-Event-ID` - ID único estável desta entrega lógica (o mesmo valor nas novas tentativas)
- `X-Webhook-Signature` - assinatura HMAC-SHA256 do corpo, formato `sha256=<hex>` (consulte [Verificar a assinatura](#handtekening-verifiëren))

**Corpo:**

```json
{
  "event": "invoice:created",
  "data": {},
  "timestamp": 1735689600000,
  "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",
  "spanId": "00f067aa0ba902b7",
  "triggeredBy": {
    "id": "usr_63x8jp68is",
    "name": "Niels"
  }
}
```

| Campo | Tipo | Descrição |
|------|------|--------------|
| `event` | string | Chave do evento (por ex. `invoice:created`) |
| `data` | object | Payload específico do evento |
| `timestamp` | number | Unix timestamp (ms) em que o evento foi emitido |
| `traceId` | string | ID de trace OpenTelemetry da ação do Tillor que causou este evento. Indique-o ao suporte; não é um segredo. |
| `spanId` | string (opcional) | Span dentro desse trace |
| `triggeredBy` | object \| null | Utilizador que executou a ação (`id`, `name`). `null` em ações do sistema (cron, sincronização bancária, …) |

Consulte [Exemplos](/ontwikkelaars/voorbeelden) para exemplos completos de payload.

---

## Verificar a assinatura [#handtekening-verifiëren]

Cada webhook tem o seu próprio **segredo de assinatura** (64 carateres hexadecimais, visível na tabela de webhooks em **Mostrar segredo de assinatura** em *Conta → Programadores*). O Tillor assina cada POST com esse segredo para que possa verificar que o pedido vem mesmo do Tillor e que o corpo não foi alterado.

**Como o Tillor assina:**

1. Calcula `HMAC-SHA256(signingSecret, raw_request_body)` (hexadecimal em minúsculas).
2. Envia-o como `X-Webhook-Signature: sha256=<hex>`.

**Como verifica:**

1. Leia o corpo **bruto** do pedido (antes do parse de JSON - caso contrário o hash não coincide).
2. Calcule você mesmo `HMAC-SHA256(signingSecret, raw_body)` em hexadecimal.
3. Compare com o valor a seguir a `sha256=` no cabeçalho `X-Webhook-Signature` com uma comparação de **tempo constante**.

```js
import crypto from "node:crypto";

function verifyTillorWebhook(rawBody, headerSignature, signingSecret) {
  const expected = crypto.createHmac("sha256", signingSecret).update(rawBody).digest("hex");
  const received = headerSignature.replace(/^sha256=/, "");
  const a = Buffer.from(expected, "hex");
  const b = Buffer.from(received, "hex");
  return a.length === b.length && crypto.timingSafeEqual(a, b);
}
```

<Callout type="warn" title="Trate o segredo como uma palavra-passe">
Pode mostrar o segredo de assinatura no Tillor através de **Mostrar segredo de assinatura** na tabela de webhooks. Guarde-o como segredo (variável de ambiente, cofre) e nunca o registe em logs. Suspeita de uma fuga? Elimine o webhook e crie um novo; assim obtém um novo segredo.
</Callout>

---

## Comportamento de entrega e novas tentativas [#leveringsgedrag-en-retries]

- Responda com um **estado 2xx** para confirmar o sucesso.
- Numa entrega falhada (não 2xx, erro de rede ou destino bloqueado), o Tillor volta a tentar a entrega automaticamente com intervalos cada vez maiores. Cada tentativa reutiliza o mesmo payload, a mesma assinatura e o mesmo ID de evento (idempotente).

| Tentativa | Tempo de espera desde a tentativa anterior |
|---|---|
| 1 | de imediato |
| 2 | 1 segundo |
| 3 | 2 segundos |
| 4 | 4 segundos |
| 5 | 8 segundos |
| 6 | 5 minutos |
| 7 | 30 minutos |
| 8 | 2 horas |
| 9 | 6 horas |
| 10 | 24 horas |

- Se uma das tentativas tiver sucesso (2xx) → a entrega está concluída.
- Se também a tentativa 10 (após 24 h) falhar → a entrega é **marcada definitivamente como falhada** e não volta a ser tentada.
- Se entretanto o webhook for **desativado**, o Tillor deixa de tentar de novo.

```mermaid
flowchart TD
  A[Evento emitido] --> B[Entrega ao seu endpoint]
  B -- 2xx --> Z[Concluída]
  B -- falhou --> C[Nova tentativa<br/>1s, 2s, 4s, 8s,<br/>5m, 30m, 2h, 6h, 24h]
  C -- 2xx --> Z
  C -- todas as tentativas falharam --> F[Definitivamente falhada]
```

<Callout type="info" title="Idempotência">
Cada nova tentativa reutiliza o mesmo `X-Webhook-Event-ID` e o mesmo `X-Webhook-Signature`. Elimine duplicados do seu lado com base nesse cabeçalho, para que uma nova tentativa bem-sucedida após um 200 lento não cause processamento duplicado.
</Callout>

### Notificações em caso de falhas persistentes [#meldingen-bij-aanhoudende-fouten]

Se as entregas de um endpoint de webhook continuarem a falhar, o Tillor envia **no máximo duas notificações por incidente** (por endpoint):

1. **Após 5 minutos de falhas persistentes** - e-mail para o endereço de e-mail da organização (`supportEmail`, caso contrário `email`) e para os membros da organização com direitos para alterar as definições da organização, mais push (se estiver ativado) para esses membros. O e-mail indica desde quando as entregas falham. As datas no e-mail usam o **fuso horário** de *Definições > Geral* (por defeito `Europe/Brussels`).
2. **Em caso de falha definitiva** - os mesmos destinatários recebem uma notificação quando o primeiro evento desse incidente é marcado como definitivamente falhado após todas as tentativas.

**Não** recebe uma notificação por cada evento falhado. Assim que todas as entregas falhadas de um endpoint forem resolvidas (entregues com sucesso), um incidente seguinte recomeça com as mesmas regras.

Em **Conta → Programadores**, a tabela de webhooks mostra por endpoint um estado de entrega compacto (números de entregas à espera de nova tentativa e definitivamente falhadas). Clique no ícone **ℹ** para detalhes, incluindo a mensagem de erro completa e o payload da tentativa mais recente.

- **Repetir entregas falhadas** (↻): apenas as entregas definitivamente falhadas desse webhook.
- **Forçar repetição** (⚡): todas as entregas em espera e definitivamente falhadas desse webhook, independentemente dos tempos de espera planeados. O Tillor inicia isto em segundo plano para que filas grandes (por ex. milhares de eventos) sejam processadas em segurança.
- **Forçar repetição de todos**, em cima à direita ao lado de **Adicionar webhook**: o mesmo para todos os webhooks ativados na organização.

---

## Tipos de eventos [#event-types]

As chaves de eventos usam o formato `entity:action` ou `entity:subresource:action`. A lista completa, com a permissão de cada evento e um exemplo de payload, está no [Índice de eventos](/ontwikkelaars/events). Essa página é gerada a partir do código e por isso está sempre completa. As mesmas chaves estão no Tillor em [Conta → Programadores](https://tillor.eu/orgs/org_abc123/developers), em **Adicionar webhook** → **Eventos subscritos**.


---

## Webhooks vs SSE [#webhooks-vs-sse]

| Caso de uso | Recomendação |
|----------|-------------|
| Integração do lado do servidor | **Webhooks** - O seu servidor recebe POSTs |
| Registo simples | **Webhooks** - Configuração mínima |
| Painel em tempo real, atualizações em direto na aplicação | [SSE](/ontwikkelaars/sse) - Uma ligação, baixa latência. |
| Muitos tipos de eventos, filtragem do lado do cliente | [SSE](/ontwikkelaars/sse) - Utilize o parâmetro de consulta `events` para limitar o tráfego. |

---

## Relacionado [#gerelateerd]

- [OpenAPI](https://tillor.eu/api/openapi.json) - Especificação completa da API
- [API HTTP](/ontwikkelaars/http) - API REST e chaves de API
- [SSE](/ontwikkelaars/sse) - Os mesmos eventos através de Server-Sent Events
- [Automatizações](/ontwikkelaars/automatiseringen) - Enviar mensagens próprias a partir de uma automatização


# API do chat do website (/pt-PT/ontwikkelaars/website-chat)

O widget oficial instala-se na aplicação: consulte [Colocar o chat no seu website](/inbox/website-chat). As opções do snippet estão em [Definições do chat do website](/inbox/website-chat-instellingen). Esta página é para programadores: o SDK do widget para um formulário próprio e a camada REST para uma **interface de chat própria**. Consulte o [OpenAPI](https://tillor.eu/api/openapi.json), etiqueta `inbox`.

## SDK do widget [#widget-sdk]

Depois de carregar o script do widget, `window.TillorInbox` fica disponível. Com ele passa dados de contacto a partir do seu próprio formulário (página de contacto, detalhe de venda, pedido de orçamento). Todos os métodos esperam até a configuração do widget estar carregada.

| Método | Descrição |
|---------|--------------|
| `ready()` | Promise que fica pronta assim que o widget estiver carregado |
| `getVisitor()` | Lê os dados de contacto guardados em `localStorage` e os campos do widget preenchidos; síncrono, sem rede |
| `setVisitor({ name?, firstName?, lastName?, email?, phone?, message?, customFields? }, options?)` | Preenche os campos do chat sem enviar |
| `open()` | Abre a janela de chat |
| `close()` | Fecha a janela de chat |
| `toggle()` | Abre ou fecha a janela de chat |
| `send({ body, name?, firstName?, lastName?, email?, phone?, message?, customFields?, open?, silent?, markSubmitted?, metadata? })` | Envia uma mensagem com dados de contacto |

`getVisitor()` devolve este objeto:

| Campo | Descrição |
|-------|--------------|
| `visitorId` | ID deste visitante neste navegador (`localStorage`) |
| `name` | Nome completo (um único campo no widget) |
| `firstName` / `lastName` | Derivados de `name` (primeira palavra / resto) |
| `email`, `phone` | Dados de contacto |
| `customFields` | Campos adicionais das definições do widget |
| `message` | Rascunho no campo da mensagem |
| `detailsSubmitted` | Se o formulário do visitante conta como preenchido |

Utilize `getVisitor()` para preencher previamente um formulário próprio a partir de `localStorage` (mesmo navegador, também após atualizar a página).

Opções para `setVisitor` (segundo argumento):

| Opção | Por defeito | Explicação |
|-------|-----------|--------|
| `open` | `false` | Abrir logo a janela de chat |
| `markSubmitted` | `false` | Ocultar o formulário do visitante se todos os campos obrigatórios estiverem preenchidos |
| `onlyEmpty` | `false` | Substituir apenas campos vazios |
| `persist` | `false` | Guardar os dados em `localStorage` (mesmo navegador, também num novo separador) |

Opções para `send`:

| Opção | Por defeito | Explicação |
|-------|-----------|--------|
| `open` | `false` | Abrir a janela de chat antes de enviar |
| `silent` | `true` se `open` for false | Sem som, sem mensagem de erro no widget; use a Promise para sucesso ou erro |
| `markSubmitted` | `true` | Os dados de contacto já não têm de ser indicados de novo no widget |
| `metadata` | - | Sugestões opcionais para a Tillie (não visíveis na janela de chat); consulte [metadata](#metadata-boekingsformulier) |

Com `open: false` (por defeito), o botão do chat permanece fechado. A mensagem chega mesmo assim ao Tillor; o seu formulário pode agradecer ou mostrar um erro. Com `open: true`, a janela de chat abre e o visitante vê o comportamento normal de envio (som, vistos, eventuais erros do widget).

Quer usar um botão seu em vez do botão de chat flutuante? Defina `data-launcher="false"` no snippet e chame `TillorInbox.open()`.

### `metadata` (formulário de reserva) [#metadata-boekingsformulier]

Utilize `metadata` quando tiver um formulário próprio no website e a Tillie deva enviar **apenas uma confirmação**, sem perguntas de seguimento (por exemplo, porque o separador se fecha depois).

| Chave | Tipo | Explicação |
|---------|------|--------|
| `forceHandover` | `boolean` | Mensagem de confirmação e passagem a um colega, sem perguntas de admissão. Ignora também a pausa da IA após uma mensagem da equipa (consulte `ignoreAiPause`) |
| `ignoreAiPause` | `boolean` | A Tillie responde também quando está em pausa no modo **Automático** após uma mensagem da equipa (30 minutos). Útil para envio silencioso de formulários; combine com `forceHandover` ou deixe a Tillie fazer a admissão normalmente |
| `handoverIntent` | `"reservation"` \| `"caravan_rental"` \| `"sale"` \| `"other"` | Opcional: fluxo da passagem (por defeito: deduzido automaticamente da mensagem) |
| `source` | `string` | Etiqueta de integração opcional para a sua equipa (letras minúsculas, números, `-`, `_`; máx. 64 carateres) |

```javascript
await TillorInbox.send({
  name: "Jan Janssens",
  email: "jan@voorbeeld.be",
  phone: "+32 3 779 81 64",
  body: structuredBookingMessage,
  silent: true,
  metadata: {
    forceHandover: true,
    handoverIntent: "reservation",
    source: "website_booking_form",
  },
});
```

### Substituir o formulário de contacto (envio silencioso) [#contactformulier-vervangen-stille-verzending]

Utilize isto quando quiser manter o formulário de contacto existente, mas fazer as mensagens passar pelo Tillor sem abrir a janela de chat.

```html
<form id="site-contact-form">
  <input name="name" type="text" required />
  <input name="email" type="email" required />
  <input name="phone" type="tel" />
  <textarea name="message" required></textarea>
  <button type="submit">Enviar</button>
  <p id="contact-status" hidden></p>
</form>

<script>
  document.getElementById("site-contact-form").addEventListener("submit", async (event) => {
    event.preventDefault();
    const form = event.currentTarget;
    const status = document.getElementById("contact-status");
    const data = new FormData(form);

    try {
      await TillorInbox.send({
        name: String(data.get("name") ?? ""),
        email: String(data.get("email") ?? ""),
        phone: String(data.get("phone") ?? ""),
        body: String(data.get("message") ?? ""),
      });
      status.textContent = "Obrigado, entraremos em contacto em breve.";
      status.hidden = false;
      form.reset();
    } catch (error) {
      status.textContent = error instanceof Error ? error.message : "Falha ao enviar.";
      status.hidden = false;
    }
  });
</script>
```

Não precisa de definir `open` e `silent`: sem `open: true`, a janela permanece fechada e o Tillor trata a chamada como envio silencioso.

### Ligar o formulário de contacto (abrir o chat) [#contactformulier-koppelen-chat-openen]

Passar os campos e abrir a janela de chat, para que o visitante veja a conversa:

```html
<form id="site-contact-form">
  <input name="name" type="text" required />
  <input name="email" type="email" required />
  <input name="phone" type="tel" />
  <textarea name="message" required></textarea>
  <button type="submit">Enviar</button>
</form>

<script>
  document.getElementById("site-contact-form").addEventListener("submit", (event) => {
    event.preventDefault();
    const form = event.currentTarget;
    const data = new FormData(form);
    void TillorInbox.send({
      name: String(data.get("name") ?? ""),
      email: String(data.get("email") ?? ""),
      phone: String(data.get("phone") ?? ""),
      body: String(data.get("message") ?? ""),
      open: true,
    });
  });
</script>
```

Ou apenas preencher os campos e abrir a janela, sem enviar logo:

```javascript
void TillorInbox.setVisitor(
  {
    name: "Jan Janssens",
    email: "jan@voorbeeld.be",
    phone: "+32 3 779 81 64",
    message: "Ik heb een vraag over de stacaravan te koop.",
  },
  { markSubmitted: true, open: true },
);
```

Uma página de vendas com envio direto e abertura do chat:

```javascript
void TillorInbox.send({
  name: "Jan Janssens",
  email: "jan@voorbeeld.be",
  phone: "+32 3 779 81 64",
  body: "Ik heb interesse in deze stacaravan.",
  open: true,
});
```

Sincronizar em direto enquanto alguém escreve:

```javascript
const form = document.getElementById("site-contact-form");
form.addEventListener("input", () => {
  void TillorInbox.setVisitor({
    name: form.name.value,
    email: form.email.value,
    phone: form.phone.value,
    message: form.message.value,
  });
});
```

### Chamar cedo (antes do script do widget) [#vroeg-aanroepen-vóór-het-widget-script]

Se chamar um método antes de o script estar carregado, coloque a chamada na fila:

```html
<script>
  window.TillorInbox = window.TillorInbox || { q: [] };
  window.TillorInbox.q.push([
    "setVisitor",
    { name: "Jan", email: "jan@voorbeeld.be" },
    { open: true },
  ]);
</script>
<script src="https://tillor.eu/inbox-widget.js" data-org-id="org_abc123" data-widget-key="iwk_xxx" async defer></script>
```

## Interface de chat própria [#eigen-chat-ui]

Se criar uma interface de chat própria em vez do widget, utilize a camada REST abaixo.

Autenticação: cabeçalho `X-Tillor-Inbox-Widget-Key` (valor em *Definições > Integrações > Chat do website*).

### Escrita [#typen]

```http
POST /api/orgs/{orgId}/inbox/website/typing
X-Tillor-Inbox-Widget-Key: iwk_xxx
Content-Type: application/json

{
  "visitorId": "vis_…",
  "active": true,
  "visitorName": "Jan",
  "visitorEmail": "jan@voorbeeld.nl",
  "visitorPhone": "+32470123456"
}
```

- `active: true` quando o visitante escreve; `false` quando o campo fica vazio ou o visitante pára (o widget envia `false` após cerca de 4 segundos sem entrada)
- `visitorName` / `visitorEmail` / `visitorPhone` são opcionais
- Utilize o mesmo `visitorId` que em `POST …/inbox/website/messages` e `GET …/inbox/website/messages`

### Tempo real (SSE) [#realtime-sse]

```http
GET /api/orgs/{orgId}/inbox/website/subscribe?visitorId=vis_…
X-Tillor-Inbox-Widget-Key: iwk_xxx
Accept: text/event-stream
```

| Evento | Quando |
|-------|---------|
| `inbox:website:message-created` | Nova mensagem da equipa ou da IA |
| `inbox:website:message-updated` | Mensagem da equipa ou da IA alterada ou eliminada |
| `inbox:website:typing-changed` | `data.staffTyping` ou `data.staffOutboundSenderType` muda |

O formato do payload é o mesmo do [SSE da organização](/ontwikkelaars/sse#event-formaat) (`event`, `data`, `timestamp`). Volte a ligar após uma interrupção; não há retoma.

O widget oficial usa o SSE como camada principal e volta a obter `GET …/messages` a cada **5 segundos** como alternativa (a cada **1 segundo** com o painel aberto quando o SSE cai por momentos). Assim, as respostas são marcadas como **entregues** enquanto o visitante estiver na página.

### Atividade do visitante [#bezoekersactiviteit]

```http
POST /api/orgs/{orgId}/inbox/website/events
X-Tillor-Inbox-Widget-Key: iwk_xxx
Content-Type: application/json
```

`event`: `chat_closed`, `tab_hidden` ou `navigation` (na navegação também `url`). A sua equipa vê estes eventos como texto informativo cinzento na conversa, consulte [Conversas através do chat do website](/inbox/website-chat-gesprekken).

### Limites [#limieten]

`POST …/inbox/website/messages` e `POST …/inbox/website/attachments/upload` respondem `429` quando um visitante ou uma rede envia demasiado. O corpo traz `data.reason` = `INBOX_WIDGET_RATE_LIMITED` e `data.retryAfterSeconds`. Limites por organização:

| Rota | Por visitante (`visitorId`) | Por rede (endereço IP) |
|------|-----------------------------|------------------------|
| `messages` | 10 por minuto, 200 por dia | 30 por minuto, 600 por dia |
| `attachments/upload` | 10 por hora | 50 por hora |

Espera `retryAfterSeconds` antes de tentar de novo e mostra um aviso ao visitante em vez de repetir automaticamente.

## Ver também [#zie-ook]

<Cards>
  <Card title="Chat do website (aplicação)" href="/inbox/website-chat" />
  <Card title="Definições do chat do website" href="/inbox/website-chat-instellingen" />
  <Card title="SSE" href="/ontwikkelaars/sse" />
  <Card title="OpenAPI" href="https://tillor.eu/api/openapi.json" />
</Cards>


# Um hóspede à cancela (/pt-PT/praktijk/gast-aan-de-slagboom)

Um hóspede chega à cancela do Recreatiepark Het Meer e tem de conseguir passar sem ajuda da receção. Este exemplo acompanha Jonas Maes, desde a configuração do seu método de acesso até ao que acontece quando este não (ou já não) funciona. Vê como um método de acesso, um controlador e um ponto de acesso trabalham em conjunto.

```mermaid
flowchart LR
  A[Método de acesso no cliente] --> B[Hóspede no ponto de acesso]
  B --> C{O controlador e o Tillor verificam}
  C -->|válido| D[Permitido, cancela abre]
  C -->|expirado ou bloqueado| E[Recusado, visível no registo]
```

Antes de começar:

- O seu parque tem pelo menos um ponto de acesso ligado ao Tillor. Encontra-o em **Ações rápidas** na página **Controlo de acesso**, com um botão **Abrir [nome do ponto de acesso]**.
- O controlador da cancela está ligado à sua organização. Um novo controlador aparece em **Controladores** com **Aguardando aprovação** até clicar em **Aprovar**. Consulte [Controladores](/controllers).
- Para uma etiqueta NFC: a etiqueta tem de já estar no Tillor. Isso acontece automaticamente assim que for aproximada de um leitor pela primeira vez.

## A rota passo a passo [#de-route-stap-voor-stap]

<Steps>
<Step>
### Adicione um método de acesso [#voeg-een-toegangsmethode-toe]
Vá a <UIPath>Clientes > Jonas Maes > Controlo de acesso</UIPath> e clique em **Adicionar**. Escolha o **Tipo** e, se quiser, preencha uma **Data de início** e uma **Data de fim**. Esse período determina quando o método funciona.

<DocScreenshot src="/screenshots/klanten/customer-access-control.png" alt="Separador Controlo de acesso com a tabela Métodos de acesso" />

<Tabs items={["Kenteken", "QR-code", "NFC-tag"]}>
<Tab value="Kenteken">
Escolha **Reconhecimento de matrícula** e preencha a **Matrícula**. A câmara no ponto de acesso lê a matrícula e o Tillor associa-lhe o cliente.
</Tab>
<Tab value="QR-code">
Escolha **Código QR**. O Tillor cria o código por si. No menu do método, copie o **URL pessoal** e envie-o ao Jonas. Ele abre a página **Passe de acesso** e pode adicionar o passe à Apple Wallet ou à Google Wallet, se isso estiver configurado no seu ambiente.
</Tab>
<Tab value="NFC-tag">
Escolha **NFC** e selecione um cartão NFC disponível na lista. Se a lista estiver vazia, aproxime primeiro a etiqueta de um leitor. Consulte [Gerir etiquetas](/nfc/nfc-tags).
</Tab>
</Tabs>

Consulte [Controlo de acesso](/toegangscontrole).
</Step>
<Step>
### Verifique o controlador e o ponto de acesso [#controleer-controller-en-toegangspunt]
O controlador ou a câmara no ponto de acesso recebe do Tillor a lista de métodos válidos. Em **Operações do controlador**, na página **Controlo de acesso**, vê quando um passe ou código QR foi reencaminhado para o ponto de acesso. Se a operação ainda não aparecer, a sincronização ainda está em curso.

<DocScreenshot src="/screenshots/toegangscontrole/controller-operations.png" alt="Operações do controlador com sincronização e ações de lista de permissões" />
</Step>
<Step>
### Acompanhe o que acontece à cancela [#volg-wat-er-aan-de-slagboom-gebeurt]
O bloco **Registo de acesso** mostra cada tentativa com data, método, cliente, ponto de acesso e estado. Um hóspede que entra aparece na tabela **Veículos no parque** com o estado **Dentro**. Se sair, passa a **Saiu**.

<DocScreenshot src="/screenshots/toegangscontrole/access-log.png" alt="Registo de acesso com matrículas, cliente e estado" />
</Step>
<Step>
### Abra você mesmo a cancela, se for necessário [#open-de-slagboom-zelf-als-het-nodig-is]
Em **Ações rápidas**, clique em **Abrir [nome do ponto de acesso]** e confirme com **Sim, abrir [nome do ponto de acesso]**. Só é possível fechar se o ponto de acesso o suportar.
</Step>
</Steps>

## O que acontece com um método expirado? [#wat-gebeurt-er-bij-een-verlopen-methode]

Se a **Data de fim** passar, o método deixa de dar acesso e a tentativa fica no registo com o estado **Expirado**. Outros estados que encontra são **Bloqueado**, **Inativo** e **Recusado**.

Para as matrículas existe um período de tolerância, para que os hóspedes não fiquem à noite diante de uma saída fechada. Se **Permitir a saída de matrículas expiradas** estiver ativo (por defeito), a cancela de saída ainda abre durante o período de tolerância. Este dura por defeito 2 dias e no máximo 30. Só funciona fora do horário de funcionamento. Se a receção estiver aberta, o pessoal trata do veículo ao balcão. Uma matrícula bloqueada ou inativa nunca tem tolerância, e as etiquetas NFC e os códigos QR não têm tolerância. Define isto em <UIPath>Apoio > Definições > Controlo de acesso</UIPath>, consulte [Definições de controlo de acesso](/gebruikers/instellingen-toegangscontrole).

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- Cada tentativa fica no registo de acesso. Pode filtrar por cliente, estado e ponto de acesso e exportar para Excel.
- Um veículo que não é visto num ponto de acesso há 7 dias recebe o estado **Fantasma**. Se a matrícula voltar a ser vista numa entrada, o estado volta a **Dentro**.
- Se prolongar a **Data de fim** do método, este volta a funcionar após a próxima sincronização com o ponto de acesso.

## Problemas? [#problemen]

<Accordions>
<Accordion title="O hóspede está diante de uma cancela fechada">
Procure a tentativa no registo de acesso e leia o estado. **Expirado** significa que a **Data de fim** já passou, **Bloqueado** ou **Inativo** que o método está desligado. Se o método estiver correto, verifique **Operações do controlador**. Se não conseguir resolver rapidamente, abra a cancela através de **Ações rápidas**.
</Accordion>
<Accordion title="Não há nenhuma tentativa no registo">
Nesse caso, o Tillor não recebeu nada. Verifique se o controlador está online e se o ecrã mostra uma mensagem. Consulte [Mensagens no ecrã](/controllers/troubleshooting/scherm) e [Problemas de ligação](/controllers/troubleshooting/verbinding).
</Accordion>
<Accordion title="A matrícula não é reconhecida">
Verifique se a matrícula foi preenchida sem espaços nem erros de escrita. Uma matrícula mal lida também pode fazer com que um veículo fique como **Fantasma**.
</Accordion>
<Accordion title="Não vejo nenhum cartão NFC na lista">
A etiqueta ainda não é conhecida no Tillor ou já está associada a outro cliente. Aproxime-a primeiro de um leitor, ou desassocie-a do outro cliente.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Controlo de acesso" href="/toegangscontrole" />
  <Card title="Controladores" href="/controllers" />
  <Card title="NFC" href="/nfc" />
  <Card title="Definições de controlo de acesso" href="/gebruikers/instellingen-toegangscontrole" />
</Cards>


# Visão geral (/pt-PT/praktijk)

Na maioria das tarefas toca em mais do que um módulo: um novo cliente torna-se uma ocupação, um contrato, uma fatura e um pagamento. Estes exemplos percorrem uma dessas rotas do princípio ao fim. Usam a organização de demonstração Recreatiepark Het Meer, com o cliente Jonas Maes e o terreno 12. Cada passo remete para a página com a explicação completa.

<Cards>
  <Card title="Conquistar um cliente sazonal" href="/praktijk/seizoensklant-binnenhalen" description="Cliente, ocupação, contrato de arrendamento, fatura, pagamento e relatório de pagamentos" />
  <Card title="Faturar consumos" href="/praktijk/verbruik-aanrekenen" description="Do contador no terreno à fatura automática de serviços" />
  <Card title="Uma caravana estática fica livre" href="/praktijk/stacaravan-komt-vrij" description="Terminar a ocupação, tarefa de seguimento e devolução da caução" />
  <Card title="Um hóspede à cancela" href="/praktijk/gast-aan-de-slagboom" description="Método de acesso, controlador, ponto de acesso e o que acontece quando expira" />
</Cards>

## Como se relaciona tudo isto? [#hoe-hangt-dit-samen]

```mermaid
flowchart LR
  K[Cliente] --> B[Ocupação]
  T[Terreno] --> B
  M[Contador] --> T
  B --> V[Consumo]
  K --> O[Pedido de assinatura]
  B --> F[Fatura]
  V --> F
  F --> P[Pagamento]
  P --> R[Relatório de pagamentos]
  K --> TM[Método de acesso]
  TM --> TP[Ponto de acesso]
  B -->|termina| A[Automatização]
  A --> TK[Tarefa]
```

Leia os exemplos como uma rota: pode entrar em qualquer ponto. Se quiser reler os termos, consulte os [Conceitos](/begrippen).

## Conceitos [#begrippen]

- **Ocupação**: um cliente num terreno durante um período mais longo. Consulte [Ocupação](/begrippen#bezetting).
- **Terreno**: um lugar no seu parque. Consulte [Terreno](/begrippen#terrein).
- **Pedido de assinatura**: um PDF que é assinado online. Consulte [Pedido de assinatura](/begrippen#ondertekenverzoek).
- **Automatização**: uma regra que o Tillor executa por si. Consulte [Automatização](/begrippen#automatisering).


# Angariar um cliente sazonal (/pt-PT/praktijk/seizoensklant-binnenhalen)

Angariar um cliente sazonal significa, no Tillor: criar o cliente, atribuir-lhe uma parcela, fazer assinar o contrato de arrendamento, faturar a taxa de estacionamento e garantir que o pagamento chega à sua contabilidade. Este exemplo percorre esse caminho para o Jonas Maes, que arrenda a parcela 12 no Recreatiepark Het Meer para a época. Cada passo remete para a página com a explicação completa.

```mermaid
flowchart LR
  A[Klant aanmaken] --> B[Bezetting op terrein 12]
  B --> C[Huurcontract tekenen]
  C --> D[Staangeld factureren]
  D --> E[Betaling]
  E --> F[Betalingsrapport]
```

Antes de começar:

- A parcela 12 existe e não tem nenhuma ocupação ativa. Se já tiver uma, não aparece na lista de escolha em **Criar ocupação**.
- Existe um produto com a ação **Prorrogar período de ocupação**, muitas vezes Staangeld. Veja [Associar ações a um produto](/producten/acties-instellen).
- Tem o contrato de arrendamento pronto em PDF.
- Tem a permissão **Gerir pedidos de assinatura** para fazer assinar o contrato.
- Para assinar à distância, o cliente precisa de um endereço de e-mail ou de um número de telemóvel. Para um mandato SEPA, é preciso um endereço de e-mail.

## O caminho passo a passo [#de-route-stap-voor-stap]

<Steps>
<Step>
### Crie o cliente [#maak-de-klant-aan]
Vá a <UIPath>Clientes > Visão geral</UIPath> e clique em **Criar novo cliente**. Se houver uma leitura de documento de identidade na fila, escolha-a no menu de seleção: o Tillor preenche os dados a partir do documento. Caso contrário, escolha **Manual** e preencha **Nome próprio**, **Apelido**, **Endereço de e-mail** e **Número de telemóvel**.

<DocScreenshot src="/screenshots/klanten/customer-create-dialog.png" alt="Caixa de diálogo Criar novo cliente" />

Depois de criado, chega ao perfil do Jonas. Complete aí a morada. Encontra mais informação em [Gestão de clientes](/klantenbeheer) e [Leitura de documentos de identidade](/identiteitsscans).
</Step>
<Step>
### Atribua a parcela 12 ao Jonas [#geef-jonas-terrein-12]
No perfil dele, abra o separador **Visão geral**, vá ao cartão **Ocupações** e clique em **Criar ocupação**. Em **Parcela**, escolha a parcela 12. Se necessário, preencha **Pago até**, o **Tipo** e a **Frequência da renda**. O preço vem, por predefinição, da parcela.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations.png" alt="Cartão Ocupações no perfil do cliente" />

Se a parcela 12 tiver contadores, pode agora preencher também as **Leituras iniciais dos contadores**. Veja [Ocupações](/bezettingen#een-bezetting-aanmaken).
</Step>
<Step>
### Faça assinar o contrato de arrendamento [#laat-het-huurcontract-tekenen]
Vá a <UIPath>Administração > Assinaturas</UIPath> e clique em **Pedir assinaturas**. Escolha o Jonas Maes como **Cliente**, carregue o contrato, adicione o Jonas como signatário com **Cliente: Jonas Maes** e coloque um campo de assinatura. Se quiser, adicione um colaborador como segundo signatário.

<Tabs items={["À distância", "Na receção"]}>
<Tab value="Op afstand">
Clique em **Enviar**. O Jonas recebe um e-mail com uma ligação pessoal, ou um SMS se só houver um número de telefone. Assina no seu próprio dispositivo e confirma com um código de 6 dígitos.
</Tab>
<Tab value="Aan de receptie">
Clique em **Enviar**, abra o pedido e clique, junto ao Jonas, em **Assinar no tablet**. Escolha **Com código**, ou **Sem código** se verificou a identidade dele ao balcão. O contrato abre no tablet, com o nome dele em letras grandes.
</Tab>
</Tabs>

Todos os detalhes estão em [Pedir assinaturas](/handtekeningen/handtekening-vragen) e [Como alguém assina](/handtekeningen/ondertekenen).
</Step>
<Step>
### Lance a taxa de estacionamento [#boek-het-staangeld]
Volte ao cartão **Ocupações** no perfil do Jonas, abra o menu junto à ocupação e escolha **Prorrogar ocupação (fatura)**. Clique em **Criar fatura em rascunho**. O Tillor cria uma fatura em rascunho com o produto que tem a ação **Prorrogar período de ocupação**. Verifique o período na fatura e clique em **Lançar fatura**.

<DocScreenshot src="/screenshots/facturen/invoice-draft-detail.png" alt="Fatura em rascunho com o botão Lançar fatura" />

A fatura recebe um número de fatura e o estado <Status tone="success">Lançada</Status>. Veja [Lançar uma fatura](/facturen/boeken) e [Prorrogar ocupação](/bezettingen#facturatie-bezetting-verlengen).
</Step>
<Step>
### Escolha como o Jonas paga [#kies-hoe-jonas-betaalt]
Lançar não envia nada ao cliente. Agora escolhe como o dinheiro entra.

<Tabs items={["Ligação de pagamento", "Débito direto com mandato", "Na receção"]}>
<Tab value="Betaallink">
Clique em **Enviar notificação** e escolha um canal, como **E-mail**. O Jonas recebe o botão **Consultar e pagar fatura** e conclui o pagamento com, por exemplo, iDEAL ou Bancontact. Se ele quiser pagar primeiro apenas uma parte, crie uma [ligação para um pagamento parcial](/facturen/betalingen-registreren#een-link-voor-een-deelbetaling-maken). Veja [Pagar online](/betalingsverwerking/online).
</Tab>
<Tab value="Incasso met mandaat">
Peça primeiro um mandato em <UIPath>Clientes > Jonas Maes > Faturação</UIPath> e **Criar mandato**. Assim que o estado for <Status tone="success">Ativo</Status>, escolha esse mandato na fatura, em **Mandato de débito direto**. O Tillor cobra então dois dias depois de lançar o valor, ou dois dias depois de o associar se a fatura já estava lançada. Veja [Fazer assinar um mandato SEPA](/betalingsverwerking/mandaat) e [Cobrar uma fatura](/betalingsverwerking/incasso).
</Tab>
<Tab value="Aan de receptie">
Clique em **Efetuar pagamento** e escolha **Terminal**, **Numerário** ou **Transferência bancária**. Veja [Registar um pagamento](/betalingsverwerking/betaling-registreren).
</Tab>
</Tabs>
</Step>
<Step>
### Veja o pagamento a entrar [#zie-de-betaling-binnenkomen]
Em <UIPath>Administração > Pagamentos</UIPath> encontra o pagamento. Um pagamento online aparece assim que o Mollie o confirma. Um débito direto tem primeiro o estado <Status tone="warning">Pendente</Status> e passa, passados alguns dias, a <Status tone="success">Pago</Status>. Quando tudo estiver recebido, a fatura fica em <Status tone="success">Paga</Status>.

<DocScreenshot src="/screenshots/betalingen/payments-list.png" alt="Lista de todos os pagamentos" />

Encontra mais informação em [Encontrar pagamentos](/betalingsverwerking/betalingen-bekijken).
</Step>
<Step>
### Veja o pagamento no relatório de pagamento [#zie-de-betaling-in-het-betalingsrapport]
Vá a <UIPath>Administração > Relatórios de pagamento</UIPath>. Os pagamentos de hoje estão no relatório com o estado **Rascunho**. O Tillor torna o relatório definitivo na verificação diária seguinte, nos dias úteis às 09:00. Se a sua ligação à contabilidade estiver ativa, o Tillor reencaminha o relatório automaticamente.

<DocScreenshot src="/screenshots/boekhouden/betalingsrapporten/payment-reports-list.png" alt="Lista de relatórios de pagamento" />

Veja [Relatórios de pagamento](/boekhouden/betalingsrapporten).
</Step>
</Steps>

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- A ocupação do Jonas está em curso. A parcela 12 deixa de estar disponível para outros clientes e o consumo dos contadores da parcela passa para o Jonas.
- Assim que todos tiverem assinado, o pedido fica em <Status tone="success">Concluído</Status>. O PDF assinado com as páginas de prova encontra-se nos **Documentos** dele. Se quiser que uma automação faça então algo, por exemplo criar uma tarefa, use o acionador **Pedido de assinatura concluído**.
- Ao lançar a fatura, o Tillor define **Faturado até** no fim da linha da fatura. Depois do pagamento, **Pago até** avança. Veja [Pago até, tipo, frequência da renda e preço](/bezettingen#betaald-tot-type-huurfrequentie-en-prijs).
- Na época seguinte, prorroga a mesma ocupação de novo com **Prorrogar ocupação (fatura)**, ou todas as ocupações de um cliente de uma só vez com **Prorrogar todas**.
- Os pagamentos Mollie aparecem no relatório em rascunho como adiantamento do Mollie, até se conhecer o pagamento.

## Problemas? [#problemen]

<Accordions>
<Accordion title="A parcela 12 não está na lista em Criar ocupação">
Uma parcela só pode estar associada a um cliente de cada vez. Se já existir uma ocupação ativa, a parcela não aparece na lista. Termine primeiro essa ocupação, veja [Terminar uma ocupação](/bezettingen#een-bezetting-beëindigen).
</Accordion>
<Accordion title="Não consigo enviar o pedido de assinatura">
O Tillor verifica o pedido e diz o que falta: um signatário sem campo de assinatura, um signatário sem endereço de e-mail nem número de telefone, ou um título vazio. Corrija e tente de novo. Veja [Pedir assinaturas](/handtekeningen/handtekening-vragen#problemen).
</Accordion>
<Accordion title="O botão Lançar fatura está cinzento">
Passe o rato sobre o botão, o Tillor mostra o motivo. Muitas vezes falta uma data de início ou de fim numa linha com uma ocupação, ou o valor é superior ao máximo do mandato associado. Veja [Quando não é possível lançar](/facturen/boeken#problemen).
</Accordion>
<Accordion title="Prorrogar ocupação (fatura) não dá uma fatura utilizável">
Tem de existir pelo menos um produto com a ação **Prorrogar período de ocupação**. Sem esse produto, o Tillor não consegue construir a linha. Crie o produto ou adicione a ação, veja [Associar ações a um produto](/producten/acties-instellen).
</Accordion>
<Accordion title="Mandato SEPA está cinzento em Efetuar pagamento">
O Jonas não tem nenhum mandato com o estado <Status tone="success">Ativo</Status> cujo valor máximo seja suficientemente alto. Verifique o cartão **Mandatos** no separador **Faturação** dele.
</Accordion>
<Accordion title="A fatura está em Pendente">
O pagamento foi iniciado, mas o dinheiro ainda não entrou definitivamente. É normal num débito direto. Assim que o pagamento for processado, o estado passa a **Paga**. Veja [Estados](/facturen/statussen).
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Cobrar o consumo" href="/praktijk/verbruik-aanrekenen" description="A continuação: o que o Jonas consome em água e eletricidade" />
  <Card title="Ocupações" href="/bezettingen" />
  <Card title="Assinaturas" href="/handtekeningen" />
  <Card title="Faturas" href="/facturen" />
  <Card title="Processamento de pagamentos" href="/betalingsverwerking" />
</Cards>


# Uma casa móvel fica livre (/pt-PT/praktijk/stacaravan-komt-vrij)

Quando um cliente sai de uma casa móvel, há trabalho a fazer: a caravana tem de ser verificada e a caução tem de voltar para o cliente. Este exemplo mostra como o Tillor junta tudo isto. Termina a ocupação, uma automação cria uma tarefa de verificação, um colega conclui a tarefa e depois trata da caução. Usamos o Jonas Maes e a parcela 12 do Recreatiepark Het Meer como exemplo, agora como arrendatário de uma casa móvel.

```mermaid
flowchart LR
  A[Bezetting stoppen] --> B[Automatisering]
  B --> C[Nalooptaak met subtaken]
  C --> D[Collega rondt af]
  D --> E[Waarborg terug via creditnota]
```

Antes de começar:

- A parcela 12 tem o tipo de parcela **Stacaravan** e o Jonas tem nela uma ocupação ativa. Veja [Tipos de parcela](/terreinen#terreintypes).
- Existe uma automação pronta que cria uma tarefa no fim de uma ocupação. Como a construir está em [Exemplo: verificar caravana de aluguer](/automatiseringen/voorbeeld-nalopen). Nos ambientes de demonstração já está pronta com o nome **Nalopen huurcaravan**, em pausa, até ligar o interruptor **Ativa**.
- Para a caução: o produto de caução tem a opção **Vigiar o saldo do cliente nesta conta** ligada. Veja [Vigiar o saldo do cliente](/producten/product-aanmaken#het-saldo-van-de-klant-bewaken).

## O caminho passo a passo [#de-route-stap-voor-stap]

<Steps>
<Step>
### Termine a ocupação [#stop-de-bezetting]
Abra o perfil do Jonas, vá, no separador **Visão geral**, ao cartão **Ocupações**, abra o menu junto à ocupação e escolha **Eliminar**. Em **Data**, escolha o dia em que ele sai. Se a parcela tiver contadores, preencha as **Leituras finais dos contadores**. Clique em **Eliminar**.

<DocScreenshot src="/screenshots/bezettingen/customer-occupations-actions-menu.png" alt="Menu de ações de uma ocupação" />

A parcela 12 fica depois livre para uma nova ocupação. Veja [Terminar uma ocupação](/bezettingen#een-bezetting-beëindigen).
</Step>
<Step>
### Deixe a automação criar a tarefa de verificação [#laat-de-automatisering-de-nalooptaak-maken]
Não tem de fazer nada. A automação arranca assim que a ocupação termina e verifica primeiro se a parcela tem o tipo de parcela **Stacaravan**. Depois procura se já existe uma tarefa **Nalopen** aberta para esta parcela.

- Se ainda não houver uma tarefa aberta, cria uma tarefa **Nalopen terrein 12** com cinco subtarefas (**Limpeza**, **Recheio**, **Internet + TV**, **Quadro com código QR** e **Verificar pequenas reparações**) e um prazo de 7 dias. A tarefa vai também para o colega que terminou a ocupação.
- Se já houver uma tarefa aberta, por exemplo porque a caravana ficou livre duas vezes em pouco tempo, não cria uma segunda. A prioridade da tarefa existente sobe um nível, até **Alta**.

<DocScreenshot src="/screenshots/automatiseringen/task-step.png" alt="Passo Criar tarefa de verificação na automação" />

Acompanha o que a automação fez em [Testes e execuções](/automatiseringen/testen-en-uitvoeringen).
</Step>
<Step>
### Conclua a tarefa [#werk-de-taak-af]
O colega encontra a tarefa no cartão **Tarefas para si** no painel, no separador **Tarefas** do Jonas, ou numa vista em **Tarefas**. A tarefa está associada à parcela 12 e ao Jonas.

<DocScreenshot src="/screenshots/taken/task-detail-dialog.png" alt="Janela da tarefa com descrição, subtarefas e propriedades" />

<Tabs items={["Com subtarefas", "Com botões de escolha"]}>
<Tab value="Met subtaken">
Abra a tarefa e marque cada subtarefa assim que estiver feita. Ao lado da tarefa há um contador como **2/5**. Quando todas as subtarefas estiverem prontas, defina o estado como **Concluída**. Se definir a tarefa principal como **Concluída**, as subtarefas abertas são concluídas também.
</Tab>
<Tab value="Met keuzeknoppen">
Se alargou a automação com o passo **Pedir uma decisão**, por exemplo para decidir se a caução é totalmente devolvida, a tarefa tem botões em **Escolha uma ação para concluir esta tarefa**. Um clique conclui a tarefa. Se a escolha pedir um motivo, abre-se **Porquê esta escolha?**. Uma escolha feita já não pode ser anulada. Veja [Tarefas com botões de escolha](/taken/taakdetails#taken-met-keuzeknoppen) e [Pedir uma decisão](/automatiseringen/logica#vraag-om-een-beslissing).
</Tab>
</Tabs>
</Step>
<Step>
### Verifique o saldo da caução [#controleer-het-saldo-van-de-waarborg]
Abra o perfil do Jonas e vá ao separador **Faturação**. Na tabela **Contas** vê o saldo por conta contabilística. A conta da caução mostra o que o Jonas ainda tem a haver.
</Step>
<Step>
### Crie a nota de crédito da caução [#maak-de-creditnota-voor-de-waarborg]
Abra a fatura da caução do Jonas, clique nos três pontos no canto superior direito e escolha **Estornar fatura**. O Tillor cria uma fatura em rascunho com as mesmas linhas em valores negativos. Se retiver uma parte, por exemplo por danos, ajuste o valor. Clique em **Lançar fatura**. A fatura passa a ser uma **Nota de crédito**.

O Tillor recusa uma fatura que leve o saldo da conta da caução abaixo de zero. Assim não pode devolver uma caução duas vezes. Veja [Estornar uma fatura](/facturen/corrigeren#een-factuur-omkeren).
</Step>
<Step>
### Compense o valor [#verreken-het-bedrag]
Se o Jonas ainda tiver uma fatura em aberto, por exemplo pelo último consumo, pode compensar o valor com o método de pagamento **Transferência interna**. Veja [Fazer uma transferência interna](/betalingsverwerking/interne-overboeking).
</Step>
</Steps>

<Callout type="info" title="Devolver o dinheiro">
O Tillor regista a nota de crédito e a compensação. Transferir o valor de volta para a conta bancária do cliente é algo que faz através do seu banco.
</Callout>

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- A parcela volta a estar livre. Um novo cliente pode ocupá-la ou receber uma reserva nela.
- Os períodos de consumo em aberto do Jonas ficam encerrados, com as leituras finais que preencheu. O consumo até à data de fim fica guardado e ainda o pode faturar. Veja [Cobrar o consumo](/praktijk/verbruik-aanrekenen).
- A tarefa e as ações nela ficam na cronologia da tarefa e no perfil do Jonas. As alterações à ocupação aparecem no separador **Eventos** dele.
- A nota de crédito segue para a contabilidade como qualquer outra fatura.

## Problemas? [#problemen]

<Accordions>
<Accordion title="Não foi criada nenhuma tarefa de verificação">
Verifique três coisas. O interruptor **Ativa** da automação está ligado? O tipo de parcela da parcela 12 é **Stacaravan**? Veja em [Testes e execuções](/automatiseringen/testen-en-uitvoeringen) se a automação arrancou e onde parou.
</Accordion>
<Accordion title="Há duas tarefas de verificação, ou só uma">
A automação procura uma tarefa aberta com exatamente o mesmo título, **Nalopen** seguido do nome da parcela, para a mesma parcela, o mesmo cliente ou a mesma reserva. Se o título não coincidir, não encontra a tarefa existente e cria uma nova. Uma tarefa aberta só recebe uma prioridade mais alta, nunca uma segunda tarefa.
</Accordion>
<Accordion title="Não consigo concluir a tarefa">
Se aparecer **Concluída pela sua automação**, só a automação pode concluir a tarefa e a tarefa não tem **Eliminar**. Veja [Detalhes da tarefa](/taken/taakdetails#taken-met-keuzeknoppen).
</Accordion>
<Accordion title="Não vejo os botões de escolha">
Pode escolher quem está atribuído à tarefa e um administrador. Se ninguém estiver atribuído, qualquer pessoa que veja a tarefa pode escolher. Se aparecer uma marca de verificação em vez de botões, a tarefa não vem de um passo **Pedir uma decisão**.
</Accordion>
<Accordion title="Lançar fatura está cinzento na nota de crédito da caução">
O saldo da conta da caução ficaria abaixo de zero. Verifique a tabela **Contas** e o valor na fatura. Com a permissão **Ignorar o saldo da conta** pode lançar mesmo assim, com uma justificação que fica na cronologia da fatura.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Exemplo: verificar caravana de aluguer" href="/automatiseringen/voorbeeld-nalopen" description="Assim constrói a automação você mesmo" />
  <Card title="Tarefas" href="/taken" />
  <Card title="Corrigir uma fatura" href="/facturen/corrigeren" />
  <Card title="Ocupações" href="/bezettingen" />
</Cards>


# Cobrar o consumo (/pt-PT/praktijk/verbruik-aanrekenen)

Cobrar o consumo funciona no Tillor através da parcela: um contador pertence a uma parcela, um cliente chega à parcela através de uma ocupação, e o consumo do contador vai para esse cliente. Este exemplo acompanha o contador de eletricidade da parcela 12 do Recreatiepark Het Meer, da associação até à fatura do Jonas Maes. No fim, explica como o Tillor pode também criar e enviar essa fatura por si.

```mermaid
flowchart LR
  A[Meter] -->|koppelen| B[Terrein 12]
  B --- C[Bezetting van Jonas]
  A -->|meterstanden| D[Verbruik van Jonas]
  D --> E[Openstaand verbruik]
  E --> F[Factuur]
  F -.->|automatisch| G[Nutsfactuur op vaste dag]
```

Antes de começar:

- O contador já existe em <UIPath>Parque > Contadores</UIPath> e ainda não está associado a uma parcela. Um contador que já está associado a uma parcela não aparece na lista de escolha.
- O Jonas tem uma ocupação ativa na parcela 12. Veja [Angariar um cliente sazonal](/praktijk/seizoensklant-binnenhalen). Sem ocupação, o Tillor não sabe a quem pertence o consumo.
- Para a fatura automática, o Jonas precisa de um endereço de e-mail ou número de telefone, e para a cobrança automática de um mandato ativo.

## O caminho passo a passo [#de-route-stap-voor-stap]

<Steps>
<Step>
### Associe o contador à parcela 12 [#koppel-de-meter-aan-terrein-12]
Vá a <UIPath>Parque > Terrenos</UIPath>, abra a parcela 12 e desça até ao cartão **Contadores**. Clique em **Adicionar contador**, escolha o contador e clique em **Atribuir contador**.

<DocScreenshot src="/screenshots/park/terrain-detail.png" alt="Página de detalhe da parcela 12 com o cartão Contadores" />

Veja [Gestão de contadores](/meterbeheer/meter-koppelen) e [Parcelas](/terreinen).
</Step>
<Step>
### Registe a leitura inicial [#leg-de-beginstand-vast]
Se o Jonas já estiver inscrito na parcela 12, preencha a leitura inicial na ocupação. Se só agora criar a ocupação, preencha as **Leituras iniciais dos contadores**. Se o deixar vazio, o Tillor usa a última leitura conhecida. Assim o primeiro lote de consumo começa logo na leitura certa. Veja [Ocupações](/bezettingen#een-bezetting-aanmaken).
</Step>
<Step>
### Acompanhe as leituras [#volg-de-meterstanden]
Os contadores inteligentes enviam eles próprios a leitura, normalmente todos os dias ou todas as semanas. Um contador manual lê e introduz você mesmo. Veja [Gestão de contadores](/meterbeheer).

O consumo vê-o em dois sítios. Na página do contador, em <UIPath>Parque > Contadores</UIPath>, está o cartão **Consumo** com, por cliente, o consumo em aberto e o consumo liquidado. No perfil do Jonas está o cartão **Leituras**, com todos os contadores das suas parcelas.

<DocScreenshot src="/screenshots/park/meter-detail.png" alt="Página do contador com o cartão Consumo" />

Se alguém introduzir uma leitura inferior à anterior, o Tillor avisa. Se a leitura estiver mesmo certa (o contador foi substituído), o Tillor encerra o período em curso e começa um novo. Veja [Lotes de consumo](/meterbeheer/consumptie-batches).
</Step>
<Step>
### Veja o que está em aberto [#bekijk-wat-openstaat]
Vá a <UIPath>Clientes > Consumo em dívida</UIPath>. Vê, por cliente, o valor total, a **Última fatura de consumos** e o número de contadores. O Jonas aparece assim que houver consumo que ainda não consta de uma fatura.

<DocScreenshot src="/screenshots/meterbeheer/outstanding-consumption.png" alt="Lista de clientes com consumo por faturar" />
</Step>
<Step>
### Crie a fatura [#maak-de-factuur]
Tem duas maneiras.

<Tabs items={["A partir da lista", "A partir do perfil do cliente"]}>
<Tab value="Vanuit de lijst">
Clique, no fim da linha do Jonas, no ícone de envio. A janela **Criar fatura** mostra o valor total, a repartição por tipo e o número de contadores. Marque os canais com que o Tillor envia logo a fatura e clique em **Criar fatura**. O Tillor cria a fatura, lança-a e envia-a. Se o Jonas tiver um mandato para faturas de consumos, esse mandato aparece já escolhido em **Cobrar por mandato**.
</Tab>
<Tab value="Vanuit het klantprofiel">
Abra o perfil do Jonas e clique, no cartão **Leituras**, em **Faturar consumo**. O Tillor coloca, por período de consumo, uma linha principal com, por baixo, uma linha de informação com a data e as leituras. Se já existir uma fatura em rascunho adequada, as linhas vão para ela. Verifique a fatura, lance-a e envie-a você mesmo. Veja [Lançar uma fatura](/facturen/boeken) e [Enviar uma fatura](/facturen/versturen).
</Tab>
</Tabs>
</Step>
<Step>
### Deixe o Tillor fazê-lo sozinho [#laat-tillor-het-zelf-doen]
Abra o perfil do Jonas, vá a <UIPath>Clientes > Jonas Maes > Faturação</UIPath> e abra o cartão **Definições de faturação**. Aí define:

- **Faturação automática de consumos**: um dia do mês. Se escolher 31 e o mês não tiver 31 dias, a fatura sai no último dia do mês.
- **Mandato**: o mandato com que o Tillor cobra a fatura de consumos. Veja [Cobrar uma fatura](/betalingsverwerking/incasso#nutsfacturen-automatisch-innen).
- **Montante mínimo**: um limite mínimo próprio para o Jonas. Se o deixar vazio, vale o mínimo da organização em <UIPath>Apoio > Definições > Faturação</UIPath>.

No dia escolhido, o Tillor cria a fatura sozinho e envia-a. Se o valor em aberto estiver abaixo do mínimo, o Tillor espera por um dia de faturação seguinte.
</Step>
</Steps>

## O que acontece a seguir? [#wat-gebeurt-er-daarna]

- Os períodos de consumo faturados ficam concluídos. Se a ocupação continuar, o Tillor inicia um novo período na leitura final do anterior, para não haver lacuna.
- Se a fatura estiver lançada, segue como qualquer outra fatura: pagamento, aviso de cobrança e relatório de pagamento. Veja [Angariar um cliente sazonal](/praktijk/seizoensklant-binnenhalen).
- No fim da ocupação, o Tillor encerra os períodos em aberto. O consumo até à data de fim fica guardado e ainda o pode faturar.
- Se eliminar uma fatura em rascunho com consumo, o consumo volta a **Consumo em dívida**.

<Callout type="info" title="Consumo muito acima do habitual">
Se o consumo de eletricidade ou de água em aberto for pelo menos o dobro do que o Jonas costuma consumir, o Tillor não cria a fatura automática. Recebe um e-mail no endereço de apoio da organização. Verifique a leitura do contador e fature o consumo você mesmo se estiver tudo certo.
</Callout>

## Problemas? [#problemen]

<Accordions>
<Accordion title="O contador não está na lista em Adicionar contador">
A lista só mostra contadores sem parcela. Se o contador já estiver associado a outra parcela, desassocie-o primeiro através do menu junto ao contador nessa parcela, com **Desassociar da parcela**.
</Accordion>
<Accordion title="O Jonas não tem consumo no contador da parcela 12">
O consumo vai para o cliente com uma ocupação ativa na parcela. Verifique se o Jonas tem uma ocupação na parcela 12 e se o contador está associado à parcela.
</Accordion>
<Accordion title="O Jonas não está em Consumo em dívida">
Por predefinição, a lista mostra apenas clientes sem faturação automática. Defina o filtro **Faturação automática** como **Com data** para ver os clientes com um dia de faturação automática.
</Accordion>
<Accordion title="A fatura automática não foi criada">
Há dois motivos frequentes. O valor em aberto está abaixo do mínimo, e então o Tillor espera por um dia de faturação seguinte. Ou o consumo está muito acima do habitual, e então recebe um e-mail no endereço de apoio e a fatura não sai até alguém a verificar. Veja [Gestão de contadores](/meterbeheer/verbruik-factureren#automatisch-factureren).
</Accordion>
<Accordion title="Já faturei o consumo fora do Tillor">
Abra o período no cartão **Leituras** ou **Consumo**, clique no ícone de aviso junto ao período e confirme com **Sim, marcar como faturado**. O período fecha então sem fatura. Só pode anular isto para períodos sem ligação a uma fatura.
</Accordion>
</Accordions>

## Ver também [#zie-ook]

<Cards>
  <Card title="Gestão de contadores" href="/meterbeheer" />
  <Card title="Lotes de consumo" href="/meterbeheer/consumptie-batches" description="Como os períodos de consumo são acompanhados e faturados" />
  <Card title="Cobrar uma fatura" href="/betalingsverwerking/incasso" />
  <Card title="Definições de faturação" href="/gebruikers/instellingen-facturatie" />
</Cards>